| # | Założenie | Uzasadnienie |
|---|
| Z-1 | Cała logika inżynierska wykonuje się w przeglądarce | Wymóg wdrożenia na Cloudflare Pages jako build statyczny, bez serwera aplikacyjnego |
| Z-2 | Backend jest opcjonalny i nie wykonuje obliczeń | Cloudflare Workers ma twarde limity CPU i pamięci; obliczenia inżynierskie tam nie należą |
| Z-3 | Brak zależności zewnętrznych i CDN | Praca w pełni offline po pierwszym załadowaniu; brak ryzyka łańcucha dostaw |
| Z-4 | Jednostki SI w warstwie obliczeniowej | Konwersja wyłącznie na warstwie prezentacji |
| Z-5 | Żadnych wartości normowych zaszytych w kodzie | Wszystkie pochodzą z pliku profilu z sumą SHA-256 |
| Z-6 | Zakaz zgadywania wartości normowych | Wartości bez potwierdzonego źródła oznaczone [DO WERYFIKACJI] |
| Z-7 | Rysunek autorowany w milimetrach arkusza | Jedyny sposób zagwarantowania wierności skali na wydruku |
| Z-8 | Zakaz rasteryzacji rysunku technicznego | PDF musi pozostać wektorowy i mierzalny |
| # | Założenie | Skutek praktyczny |
|---|
| H-1 | Model tarcia: Prandtl–Colebrook, postać jawna | Brak iteracji, wynik deterministyczny |
| H-2 | Chropowatość k_b operacyjna, nie materiałowa | Uwzględnia opory lokalne i studnie; nie dodaje się osobno strat miejscowych |
| H-3 | Lepkość kinematyczna stała 1{,}31\cdot10^{-6} m²/s | Odpowiada temperaturze ok. 10 °C; wpływ temperatury pominięty |
| H-4 | Zakres bisekcji ograniczony do h \le 0{,}938D | Powyżej Q(h) nie jest monotoniczna; przekroczenie traktowane jako przepływ pod ciśnieniem |
| H-5 | Przekrój wyłącznie kołowy w silniku doboru | Przekroje jajowe, dzwonowe, prostokątne poza zakresem tej wersji |
| H-6 | Straty miejscowe nie modelowane odrębnie | Zawarte w k_b zgodnie z praktyką DWA-A 110 |
| H-7 | Warunek brzegowy dolny: swobodny wypływ | Spiętrzenie od odbiornika poza zakresem |
| # | Założenie | Skutek praktyczny |
|---|
| Y-1 | Metoda racjonalna jako podstawa doboru | Właściwa dla sieci o czasie koncentracji zbliżonym do czasu trwania deszczu |
| Y-2 | Deszcz krytyczny szukany w dziesięciu czasach trwania 5–180 min | Wybierany po maksimum przepływu, nie natężenia |
| Y-3 | Współczynnik spływu \psi stały dla całej zlewni | Zlewnie złożone wymagają uśrednienia przez użytkownika |
| Y-4 | Straty początkowe i ciągłe nie modelowane | Zawarte w \psi; modele Hortona, Green-Ampta i SCS-CN poza zakresem |
| Y-5 | Współczynnik redukcji powierzchniowej (ARF) pominięty | Uzasadnione dla zlewni miejskich poniżej kilkudziesięciu hektarów |
| Y-6 | Zlewnia domyślnie jako pas przy trasie | Alternatywa: delimitacja D8 z NMT |
| Y-7 | Hietogramy zachowują sumę opadu, nie kształt krzywej IDF w każdym kroku | Weryfikowane testem; błąd 0,0000 % |
| Y-8 | Wzór Błaszczyka stosowany poza zakresem 5–180 min nie jest blokowany | Użytkownik odpowiada za zakres stosowalności |
| # | Założenie | Skutek praktyczny |
|---|
| D-1 | Optymalizacja lokalna, odcinek po odcinku | Nie jest to optimum globalne sieci; jest powtarzalne i wyjaśnialne |
| D-2 | Funkcja celu: koszt rury + wykopu + studni | Ceny z pliku profilu, oznaczone [DO WERYFIKACJI] |
| D-3 | Objętość wykopu uproszczona: L\,(c_{min}+D+0{,}15)(D+0{,}8) | Szerokość dna wykopu wg EN 1610 z przestrzenią roboczą 0,8 m; skarpy pominięte w funkcji celu |
| D-4 | Krok przeszukiwania spadku 0,5 ‰ | Kompromis dokładności i czasu obliczeń |
| D-5 | Rozstaw studni stały 55 m przy budowie sieci | Rozstaw normowy zależny od DN zapisany w profilu, ale wstępny podział jest równomierny |
| D-6 | Kryterium samooczyszczania alternatywne: v_{min} lub \tau_{min} | Spełnienie jednego wystarcza |
| D-7 | Kaskady i uskoki nie są wstawiane automatycznie | Próg w profilu istnieje, realizacja poza zakresem |
| D-8 | Kolizje z uzbrojeniem obcym nie są sprawdzane | Brak warstwy uzbrojenia w tej wersji |
| D-9 | Przepompownie nie są projektowane | Przekroczenie głębokości wykopu jest tylko sygnalizowane |
| # | Założenie | Skutek praktyczny |
|---|
| S-1 | Fala kinematyczna, schemat jawny upwind | Brak modelowania spiętrzenia wstecznego |
| S-2 | Krok czasowy 5 s, czas symulacji 1 h | Warunek Couranta monitorowany i raportowany |
| S-3 | Dopływ boczny proporcjonalny do ordynaty hietogramu | Brak odrębnej transformacji opad–odpływ w zlewni |
| S-4 | Zalanie jako nadmiar objętości ponad pojemność 0,98 D | Uproszczony bilans, bez modelowania rozlewu na terenie |
| S-5 | Pełne równania Saint-Venanta poza zakresem | Ścieżka weryfikacyjna: eksport do EPA SWMM |
Rejestr wyłączeń. Każde ma uzasadnienie techniczne i propozycję obejścia.
| # | Wymaganie | Status | Uzasadnienie | Obejście |
|---|
| O-1 | LAS/LAZ | Wyłączone | Dekompresja i triangulacja setek milionów punktów przekracza budżet pamięci przeglądarki | Konwersja do rastra w QGIS |
| O-2 | GeoTIFF / COG | Wyłączone | Wymaga biblioteki geotiff.js, a przyjęto zasadę braku zależności (Z-3) | Eksport do ASCII Grid w QGIS; przywrócenie wymaga przejścia na build Vite |
| O-3 | ESRI Grid binarny, DWG | Wyłączone | Formaty zamknięte lub wymagające GDAL/ODA | Konwersja zewnętrzna |
| O-4 | Model quasi-geoidy .gtx | Zastąpione | Brak PROJ-data w przeglądarce | Stałe przesunięcie strefowe z profilu + adnotacja o niepewności |
| O-5 | Równania Saint-Venanta (Preissmann) | Wyłączone | Koszt obliczeniowy i stabilność numeryczna przekraczają budżet przeglądarki dla sieci produkcyjnych | Eksport .inp do EPA SWMM |
| O-6 | Uruchomienie EPA SWMM w aplikacji | Wyłączone | Brak środowiska natywnego w przeglądarce i w Workers | Walidacja krzyżowa poza aplikacją |
| O-7 | Pełne obliczenia statyczne EN 1295-1 | Ograniczone | Poza zakresem wersji webowej | Atrybut klasy sztywności SN + informacyjna kontrola przykrycia |
| O-8 | PDF/A-2b, GeoPDF, GeoPackage | Wyłączone | Brak bibliotek zapewniających walidowalną zgodność bez zależności | Konwersja zewnętrzna |
| O-9 | Reprojekcja proj4js, kaskada detekcji CRS | Ograniczone | Zasada braku zależności (Z-3) | Jawny wybór CRS przez użytkownika, zapisany w .drnx wraz z układem wysokościowym |
| O-10 | MapLibre GL + deck.gl | Zastąpione | Wymagają CDN lub bundlera; sprzeczne z Z-3 | Własny renderer planu na canvas z cieniowaniem reliefu i hipsometrią |
| O-11 | Web Workery | Odroczone | Najcięższa operacja (D8, 134 tys. komórek) trwa poniżej 300 ms i jest jednorazowa | Wydzielenie przy NMT powyżej 4 mln komórek |
| O-12 | Osadzanie fontu w PDF | Wyłączone | Subsetting TrueType bez zależności to istotny nakład | Font Helvetica WinAnsi; znaki diakrytyczne transliterowane |
| O-13 | Krzywe KOSTRA w profilu DE | Parametry przybliżone | Brak licencjonowanego dostępu do danych DWD | Oznaczone [DO WERYFIKACJI]; struktura gotowa na import |
| O-14 | Wpusty deszczowe, separatory, zbiorniki, regulatory | Poza zakresem | Model danych je przewiduje, silnik nie obsługuje | Wprowadzenie jako dopływy ręczne w węzłach |
| O-15 | Automatyczne rozmieszczanie wpustów (HEC-22) | Poza zakresem | Wymaga modelu ścieku przykrawężnikowego i geometrii jezdni | — |
| O-16 | Zlewnie dachowe wg EN 12056-3 | Poza zakresem | — | Uwzględnienie w \psi lub jako dopływ ręczny |
| O-17 | Rewizje, chmurki rewizyjne, porównanie wersji | Poza zakresem | Model danych przewiduje encję Revision | Porównanie plików .drnx narzędziem zewnętrznym |
| O-18 | Podział długiego profilu na arkusze | Poza zakresem | Profil mieści się na jednym arkuszu w typowych skalach | Zmiana skali lub formatu arkusza |
| O-19 | Biblioteka symboli SVG wg konwencji krajowej | Uproszczona | Studnie rysowane jako obrys prostokątny | Wymiana przez plik konfiguracyjny w przyszłej wersji |
| O-20 | Undo/redo 50 kroków | Ograniczone | Cofanie działa na wierzchołkach trasy | Pełna historia stanu wymaga modelu immutable |
| Wymaganie | Status | Dowód |
|---|
| Import NMT w ≥ 2 formatach | Spełnione | ASCII Grid, XYZ/CSV + teren syntetyczny |
| Dobór zgodny z profilem normowym | Spełnione | 0 naruszeń na 75 sprawdzeń, profile PL i DE |
| Wydruk w skali, również skażonej, ±0,1 % | Spełnione | Błąd zmierzony 0,000000 % na profilu i przekroju |
| PDF wektorowy bez rasteryzacji | Spełnione | Brak obiektów /Subtype /Image w strumieniu |
| Bilans ciągłości symulacji < 1 % | Spełnione | 0,0000 % przy 720 krokach, Cr_{max} = 0{,}462 |
Zapis i odczyt .drnx bez utraty danych | Spełnione | SHA-256 danych wejściowych w manifeście |
| Odtwarzalność obliczeń | Spełnione | Wersja silnika + hash profilu + hash wejść |
| Działanie offline po pierwszym załadowaniu | Spełnione | Brak zależności i CDN |
| Wdrożenie jako build statyczny bez serwera | Spełnione | wrangler pages deploy . |
| Projekt 100 studni od rysunku do PDF < 20 min | Spełnione | Ścieżka sześciu kroków opisana w samouczku |