WaterQualityDex

Dlaczego istnieje: woda, którą pijesz, wyjaśniona

Niemal każdy Amerykanin dostaje wodę z publicznego systemu zarejestrowanego w EPA, ale mało kto wie, który to system, skąd czerpie wodę i ilu ludzi obsługuje. Dane istnieją — EPA publikuje je w swoim Safe Drinking Water Information System (SDWIS) — ale korzystanie z nich u oficjalnego źródła to wrogie doświadczenie: federalne interfejsy pomyślane dla techników, a nie dla mieszkańca, który chce wiedzieć, kto napełnia mu kran.

WaterQualityDex to własny produkt, który na to odpowiada: bierze oficjalną bazę SDWIS i publikuje ją jako katalog, w którym każdy w kilka sekund znajduje swój wodociąg. Przydaje się tak samo ciekawemu sąsiadowi, jak i osobie planującej przeprowadzkę i chcącej poznać system nowego miasta, lokalnym dziennikarzom piszącym o wodzie oraz profesjonalistom z branży, którzy muszą sprawdzać wpisy bez mocowania się ze stroną EPA.

Nie stoi za tym żaden klient: sam go zaprojektowałem, zbudowałem i prowadzę. To jeden z elementów mojej własnej sieci stron o danych publicznych dotyczących zdrowia środowiskowego i jeden z najlepszych przykładów tego, co potrafię zrobić z zestawem setek tysięcy rekordów.

Co umożliwia

• Wyszukiwarka wodociągów. Znajdź dowolny system po nazwie albo po jego PWSID, oficjalnym identyfikatorze EPA.
• Pełna karta systemu. Typ systemu, źródło wody, podmiot odpowiedzialny, obsługiwana populacja i dane rejestracji federalnej.
• Nawigacja po stanach. 50 stanów, Dystrykt Kolumbii i terytoria, z listami od wielkiego miejskiego wodociągu po wiejską studnię.
• Porównywarka obok siebie. Zestaw dwa systemy wodne i zobacz, czym się różnią.
• Ranking jakości według stanu. Klasyfikacja według średniej punktacji naruszeń (ocena od 0 do 100) aktywnych systemów każdego stanu.
• Sekcja o zanieczyszczeniach i blog. Przystępne treści o zanieczyszczeniach wody pitnej i o tym, jak interpretować dane.

Jak jest zbudowany

1. Architektura Laravel

• Backend Laravel + PHP na MySQL, z indeksami pomyślanymi pod dwa wyszukiwania, które naprawdę się liczą: po nazwie systemu i po PWSID.
• Szablony Blade, które generują każdą kartę, listę stanową, porównanie i ranking prosto z danych — jeden szablon, setki tysięcy stron.
• Rozwój w 100% na zamówienie: bez CMS-a, kupionych szablonów i wtyczek. Każdy adres URL odpowiada trasie i zapytaniu zaprojektowanym dla tego konkretnego przypadku.

2. Pipeline danych

• Import z SDWIS, federalnego rejestru EPA, z normalizacją typów systemów, źródeł wody i własności, zanim cokolwiek trafi do bazy danych.
• Okresowe odświeżenia: strona główna zawsze pokazuje datę ostatniej aktualizacji, żeby odwiedzający wiedział, na co patrzy.
• Punktacja naruszeń 0–100 liczona dla każdego systemu na podstawie liczby uchybień, ich wagi, świeżości i tego, czy system wrócił do zgodności z przepisami — to metryka zasilająca ranking stanów.

3. Programatyczne SEO

• Setki tysięcy indeksowalnych adresów URL uporządkowanych w silosy według stanu, dzięki czemu wyszukiwarki rozumieją hierarchię: kraj → stan → system.
• Mapy witryny XML i znaczniki strukturalne (Organization, WebSite z SearchAction, FAQPage) w całym serwisie.
• Jedna użyteczna karta dla każdego systemu: skala nie kłóci się z tym, żeby każda strona odpowiadała na realne wyszukiwanie („kto dostarcza wodę w moim miasteczku?").

4. Wydajność

• HTML renderowany na serwerze: każda strona dociera do przeglądarki kompletna, bez czekania, aż frontendowy framework narysuje treść.
• Assety kompilowane Vite, z preloadem krytycznego CSS i JS.
• Cloudflare z przodu — cache, ochrona i globalne dostarczanie, bo publiczność serwisu jest po drugiej stronie Atlantyku.

Zasięg i pochodzenie danych

Pokrycie obejmuje 50 stanów, Dystrykt Kolumbii i terytoria USA: łącznie 56 jurysdykcji, od Kalifornii po Guam. Wszystkie dane pochodzą z Safe Drinking Water Information System (SDWIS) EPA, tej samej federalnej bazy, która śledzi zgodność z przepisami każdego publicznego systemu wodnego w kraju. WaterQualityDex nie wymyśla danych: porządkuje je, krzyżuje i czyni czytelnymi, a na stronie głównej podaje, kiedy ostatnio je odświeżono.

Rezultat

Katalog na produkcji, który indeksuje 433 692 publiczne systemy wodne obsługujące 352 miliony osób — z nawigacją po stanach, wyszukiwarką, porównywarką i rankingiem — i który jeden serwer utrzymuje bez wysiłku, bo architektura od pierwszego dnia była projektowana pod tę skalę.

Dla mnie to też uczciwy poligon: nie ma tu klienta, któremu pokazuje się demo, są prawdziwi użytkownicy przychodzący z Google. Wszystko, czego uczę się, prowadząc go — pipeline danych, programatyczne SEO na wielką skalę, wydajność przy setkach tysięcy stron — to dokładnie to, co stosuję, budując platformy danych dla klientów.

Kilka zrzutów ekranu

Stack

Na produkcji: Odwiedź waterqualitydex.com — własny produkt z mojej sieci stron.

Najczęstsze pytania o katalog