Technologia

Jak to działa?

Portal zbudowany jest w architekturze headless - treść i prezentacja są od siebie oddzielone. Strony informacyjne generowane są z wyprzedzeniem do statycznego HTML (SSG), a elementy dynamiczne (wyszukiwarka, formularze) działają w trybie SSR on-demand.

Redaktor

panel CMS

Headless CMS

API + baza

Astro Build

SSG → .html

Serwer

statyczny HTML

Przeglądarka

użytkownik

Wyszukiwarka, formularze → SSR on-demand (renderowanie na żądanie) Nowa treść w CMS → webhook rebuild (automatyczne przebudowanie strony)

Warstwa frontendowa

Technologie widoczne po stronie przeglądarki - jawne, audytowalne, open-source.

Astro

SSG + SSR on-demand

Framework statycznych stron

Każda strona generowana jest z wyprzedzeniem do czystego HTML - zero JavaScript w domyślnym widoku. Dynamika (formularze, wyszukiwarka) uruchamiana jest tylko tam, gdzie potrzebna.

TypeScript

Strict mode

JavaScript z typami statycznymi

Cały kod frontendowy jest pisany w TypeScript ze ścisłym typowaniem. Błędy wykrywane są na etapie kompilacji, zanim dotrą do użytkownika.

Tailwind CSS v4

Zero runtime CSS

CSS utility-first

Style generowane są w czasie budowania - do przeglądarki trafia tylko CSS faktycznie użyty na stronie. Czcionki i arkusze stylów serwowane są z serwera portalu.

DaisyUI v5

CSS-only, zero JS

System komponentów UI

Biblioteka 50+ gotowych komponentów (karty, menu, modale, alerty…) zbudowanych wyłącznie z CSS. Brak zależności JavaScript, brak runtime overhead.

Leaflet.js

OpenStreetMap, bez Google

Interaktywne mapy

Mapy sołectw i szlaków turystycznych oparte na danych OpenStreetMap - bez uzależnienia od komercyjnych dostawców, bez śledzenia użytkowników.

Font Awesome

Hostowane lokalnie

Ikonografia

Ikony serwowane z serwera portalu, bez zewnętrznego CDN. Wszystkie ikony dekoracyjne są ukryte przed czytnikami ekranu.

Warstwa backendowa

Szczegóły konfiguracji backendu nie są upubliczniane ze względów bezpieczeństwa - poniżej opis funkcjonalny poszczególnych warstw.

Headless CMS

Treść całkowicie oddzielona od warstwy prezentacji. Redaktorzy pracują w panelu administracyjnym, a portal pobiera dane przez API - można podmienić frontend bez dotykania bazy.

Pełnotekstowa wyszukiwarka

Dedykowany silnik wyszukiwania z obsługą języka polskiego - stemizacja, synonimy, tolerancja literówek. Wyniki zwracane są w milisekundach, indeks aktualizowany automatycznie.

Relacyjna baza danych

Dane przechowywane w silniku SQL z pełnym wsparciem transakcji ACID. Automatyczne kopie zapasowe, replikacja i wersjonowanie historii zmian treści.

Prywatna chmura obiektowa

Zdjęcia i dokumenty trzymane na własnym serwerze w formacie kompatybilnym z protokołem S3. Żaden plik nie trafia do zewnętrznych dostawców chmury.

Analityka self-hosted

Statystyki odwiedzin gromadzone na własnych serwerach urzędu - bez cookies śledzących, bez udostępniania danych firmom trzecim. Pełna zgodność z RODO.

Monitoring dostępności

Automatyczne sprawdzanie dostępności serwisu co kilkadziesiąt sekund. Zespół techniczny otrzymuje powiadomienie w przypadku jakiejkolwiek niedostępności portalu.

Standardy

WCAG 2.2 AA HTML5 semantyczny ARIA Landmarks RODO / GDPR Kontrast min. 4,5:1 Nawigacja klawiaturą Mobile-first Dark mode RSS / Atom JSON-LD / Schema.org

Filozofia techniczna

Decyzje architektoniczne portalu wynikają z pięciu zasad przyjętych na etapie projektu.

Open Source

Kluczowe technologie portalu to projekty open-source z otwartym kodem źródłowym. Brak uzależnienia od jednego dostawcy (vendor lock-in), możliwość audytu kodu przez każdego.

W pełni self-hosted

Serwery, baza danych, pliki, analityka - wszystko działa na infrastrukturze kontrolowanej przez urząd. Dane mieszkańców nie opuszczają serwerów administracji publicznej.

Privacy by design

Brak plików cookies śledzących, brak Google Analytics, brak zewnętrznych CDN. Portal działa w pełni bez wysyłania danych użytkowników do podmiotów trzecich.

Dostępność WCAG 2.2 AA

Zbudowany zgodnie z wytycznymi Web Content Accessibility Guidelines na poziomie AA. Semantyczny HTML5, ARIA landmarks, obsługa czytników ekranu, nawigacja klawiaturą.

Performance-first

Strony generowane statycznie przed opublikowaniem - użytkownik dostaje gotowy HTML, nie czeka na renderowanie. Minimalna ilość JavaScript, brak bloków ładowania.

Szczegółowa dokumentacja techniczna oraz kod źródłowy dostępne są w wewnętrznym repozytorium projektu. Portal rozwijany jest jako projekt open-source na potrzeby administracji publicznej.