WaterQualityDex

Per què existeix: l'aigua que beus, explicada

Gairebé qualsevol nord-americà rep l'aigua d'un sistema públic registrat a l'EPA, però molt poca gent sap quin és el seu, d'on treu l'aigua o a quanta gent serveix. Les dades existeixen — l'EPA les publica al seu Safe Drinking Water Information System (SDWIS) — però consultar-les a la font oficial és una experiència hostil: interfícies federals pensades per a tècnics, no per al veí que vol saber qui li omple l'aixeta.

WaterQualityDex és un producte propi que respon a això: agafa la base oficial SDWIS i la publica com un directori on qualsevol localitza la seva utility en segons. Serveix per igual a un veí curiós, a qui es muda i vol conèixer el sistema de la seva nova ciutat, a periodistes locals que cobreixen temes d'aigua i a professionals del sector que necessiten consultar registres sense barallar-se amb la web de l'EPA.

No hi ha cap client al darrere: el vaig dissenyar, el vaig construir i l'opero jo. És una de les peces de la meva xarxa de webs pròpies sobre dades públiques de salut ambiental, i un dels millors exemples del que sé fer amb un dataset de centenars de milers de registres.

Què permet fer

• Cercador d'utilities. Localitza qualsevol sistema pel nom o pel seu PWSID, l'identificador oficial de l'EPA.
• Fitxa completa per sistema. Tipus de sistema, font de l'aigua, titular, població servida i dades de registre federal.
• Navegació per estats. Els 50 estats, el Districte de Columbia i els territoris, amb llistats que van de la gran utility urbana fins al pou rural.
• Comparador costat a costat. Enfronta dos sistemes d'aigua i mira en què es diferencien.
• Rànquing de qualitat per estat. Classificació segons la puntuació mitjana de violacions (una nota de 0 a 100) dels sistemes actius de cada estat.
• Secció de contaminants i blog. Contingut divulgatiu sobre els contaminants de l'aigua potable i com interpretar les dades.

Com està construït

1. Arquitectura Laravel

• Backend Laravel + PHP sobre MySQL, amb índexs pensats per a les dues cerques que importen: per nom de sistema i per PWSID.
• Plantilles Blade que generen cada fitxa, llistat estatal, comparació i rànquing a partir de la dada — una plantilla, centenars de milers de pàgines.
• Desenvolupament 100 % a mida: sense CMS, sense plantilles comprades, sense plugins. Cada URL respon a una ruta i una consulta dissenyades per a aquest cas.

2. Pipeline de dades

• Importació des de SDWIS, el registre federal de l'EPA, amb normalització de tipus de sistema, fonts d'aigua i titularitat abans de tocar la base de dades.
• Refrescos periòdics: la portada mostra sempre la data de la darrera actualització, perquè el visitant sàpiga què està mirant.
• Puntuació de violacions 0-100 calculada per sistema a partir del nombre d'infraccions, la seva gravetat, com de recents són i si el sistema va tornar a complir — és la mètrica que alimenta el rànquing d'estats.

3. SEO programàtic

• Centenars de milers d'URLs indexables organitzades en sitges per estat, de manera que els cercadors entenen la jerarquia: país → estat → sistema.
• Sitemaps XML i marcatge estructurat (Organization, WebSite amb SearchAction, FAQPage) a tot el lloc.
• Una fitxa útil per a cada sistema: l'escala no està renyida amb el fet que cada pàgina respongui una cerca real ("qui em dona l'aigua al meu poble?").

4. Rendiment

• HTML renderitzat al servidor: cada pàgina arriba completa al navegador, sense esperar que un framework de frontend pinti el contingut.
• Assets compilats amb Vite, amb preload del CSS i el JS crítics.
• Cloudflare al davant per a cache, protecció i entrega global — el públic del lloc és a l'altra banda de l'Atlàntic.

Cobertura i origen de les dades

La cobertura abasta els 50 estats, el Districte de Columbia i els territoris dels EUA: 56 jurisdiccions en total, de Califòrnia a Guam. Totes les dades procedeixen del Safe Drinking Water Information System (SDWIS) de l'EPA, la mateixa base federal que rastreja el compliment normatiu de cada sistema públic d'aigua del país. WaterQualityDex no s'inventa dades: les ordena, les creua i les fa llegibles, i declara a la portada quan es van refrescar per última vegada.

El resultat

Un directori en producció que indexa 433.692 sistemes públics d'aigua que serveixen 352 milions de persones, navegable per estat, amb cercador, comparador i rànquing — i que un servidor aguanta sense suar perquè l'arquitectura es va dissenyar per a aquesta escala des del primer dia.

Per a mi és també un banc de proves honest: aquí no hi ha cap client a qui ensenyar una demo, hi ha usuaris reals arribant des de Google. Tot el que aprenc operant-lo — pipeline de dades, SEO programàtic a gran escala, rendiment amb centenars de milers de pàgines — és exactament el que aplico quan construeixo plataformes de dades per a clients.

Algunes captures

Stack

En producció: Visitar waterqualitydex.com — producte propi de la meva xarxa de webs.

Preguntes freqüents sobre el directori