Kartenmodule ergaenzen

Phase 6: alles, was einen Ort hat — Loeschwasser, Objekte mit Feuerwehrplan,
die Lagekarte eines Einsatzes und die geplante Foerderstrecke.

Keine Kacheln aus dem Netz. Wo eine Wehr ausrueckt und wo ihre Hydranten
liegen, ist niemandes Geschaeft; der Kartenserver laeuft selbst
(tileserver-gl im Compose-Profil "karte"). Ohne ihn zeigt die Karte einen
leeren Grund und sagt das auch — Punkte, Entfernungen und Umkreissuche
funktionieren trotzdem. Dasselbe gilt fuer einen eingetragenen, aber nicht
erreichbaren Server.

Die Umkreissuche laeuft ueber PostGIS: ST_DWithin auf der Geografie mit
GiST-Index rechnet in Metern und nutzt den Index. Gefragt wird waehrend der
Fahrt, und bei tausend Hydranten waere alles andere ein vollstaendiger
Tabellendurchlauf.

Der Import aus GeoJSON und Stadtwerke-CSV ist nachsichtig, aber ehrlich: er
erkennt "DN 100", deutsche Kommazahlen, Datumsangaben und vertauschte Achsen
— raet aber nichts. Fehlt die Position, wird die Zeile uebersprungen; ohne
Statusangabe steht "ungeprueft", nicht "einsatzbereit".

22 taktische Zeichen nach FwDV 102 selbst gezeichnet, die Lagekarte gleicht
ueber denselben Ereignisstrom ab wie die Atemschutzueberwachung.

Die Wasserfoerderung rechnet Reibung, Hoehe und Pumpenzahl; das Ergebnis wird
nie gespeichert, sondern bei jeder Anzeige neu gerechnet. Geht eine Strecke
nicht auf, sagt die Ausgabe das.

Behoben: die Reibungsbeiwerte lagen im ersten Wurf um den Faktor zehn daneben.
Aufgefallen ist es nur, weil die Tests gegen die Tabellenwerte der Ausbildung
pruefen und nicht gegen die eigene Implementierung.

Dazu ein Abruf fuer abgelegte Dateien (/api/dateien/[id]) — bis hierher gab es
nur den Upload.

59 neue Tests (48 Unit, 11 E2E je Browser).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-09-04 01:41:24 +02:00
co-authored by Claude Opus 5
parent e1480c0c3e
commit 1c1e141666
53 changed files with 7804 additions and 40 deletions
+81 -1
View File
@@ -17,7 +17,87 @@ Die aufgewendete Zeit wandert nach jedem Abschnitt in die Spalte
| Phase 3 — Einsätze und Übungen | 2:10 h | 1 | 03.09.2026 |
| Phase 4 — Kiosk-PWA im Gerätehaus | 3:00 h | 1 | 03.09.2026 |
| Phase 5 — Atemschutz nach FwDV 7 | 2:40 h | 1 | 03.09.2026 |
| **Summe** | **13:20 h** | **7** | |
| Phase 6 — Kartenmodule | 2:50 h | 1 | 04.09.2026 |
| **Summe** | **16:10 h** | **8** | |
---
## 2026-09-04 · Phase 6 — Kartenmodule
**22:10 – 01:00 · 2:50 h · Version 0.7.0**
### Was entstanden ist
Alles, was einen Ort hat: Löschwasser, Objekte mit Feuerwehrplan, die Lagekarte
eines Einsatzes und die geplante Förderstrecke.
| Bereich | Dateien |
|---|---|
| Rechnen | `lib/karte/wasserfoerderung.ts`, `hydrant-import.ts`, `taktische-zeichen.ts` |
| Server | `server/routers/karte/hydrant.ts`, `objekt.ts`, `lagekarte.ts` |
| Karte | `components/karte/karte.tsx` (MapLibre), `api/lagekarte/strom` |
| Oberfläche | `app/(app)/karte/` mit Karte, Hydranten, Objekten, Wasserförderung; Lagekarte im Einsatz |
| Betrieb | tileserver-gl im Compose-Profil `karte`, `docker/karten/LIESMICH.md` |
| Tests | 48 Unit, 11 E2E je Browser |
### Entscheidungen
**Kein öffentlicher Kartendienst — auch nicht als Rückfall.** Wo eine Wehr
ausrückt und wo ihre Hydranten liegen, ist niemandes Geschäft. Die Kacheln
kommen aus dem eigenen tileserver-gl. Ohne ihn zeigt die Karte einen leeren
Grund **und sagt das**; Punkte, Entfernungen und Umkreissuche funktionieren
weiter. Ein stiller leerer Kasten wäre die schlechtere Lösung gewesen: er sieht
aus wie ein Fehler, ohne einer zu sein.
**Die Umkreissuche gehört in die Datenbank.** `ST_DWithin` auf der Geografie
mit GiST-Index rechnet in Metern und nutzt den Index. In der Anwendung wäre es
ein vollständiger Tabellendurchlauf mit Grad-Arithmetik — und gefragt wird
während der Fahrt.
**Der Import rät nicht.** Er erkennt viel („DN 100", „48,5031", „24.05.2026",
vertauschte Achsen), aber wo die Position fehlt, wird die Zeile übersprungen
statt geschätzt. Und ohne Statusangabe steht „ungeprüft" — nicht
„einsatzbereit". Eine Liste, die tausend Hydranten als geprüft ausweist, weil
die Spalte fehlte, wäre schlimmer als keine Liste.
**Ein Ereignisstrom für beides.** Die Lagekarte benutzt denselben Hook wie die
Atemschutzüberwachung aus Phase 5, nur mit anderer Adresse. Zwei Ströme mit
unterschiedlichem Verhalten wären ein Ort mehr, an dem sich ein Fehler
verstecken kann.
**Das Ergebnis der Wasserförderung wird nicht gespeichert.** Nur die Eingaben.
Eine gespeicherte Zahl neben geänderten Eingaben wäre falsch, ohne falsch
auszusehen.
### Wo es gehakt hat
| Problem | Ursache | Lösung |
|---|---|---|
| Der Druckverlust lag um den Faktor zehn daneben | Die Beiwerte waren aus dem Kopf gegriffen statt aus der Formel abgeleitet: gebraucht wird `verlust = beiwert × (menge/100)²`, also 0,0234 für den B-Schlauch, nicht 0,23 | Beiwerte aus den Tabellenwerten zurückgerechnet. Aufgefallen ist es nur, weil die Tests gegen die Ausbildungstabelle prüfen und nicht gegen die eigene Implementierung |
| Ein nicht erreichbarer Kartenserver ließ die Karte kaputt aussehen | Der Hinweis „kein Hintergrund" hing an `stilUrl === null`, nicht daran, ob der Stil geladen wurde | MapLibre meldet den Fehlschlag; die Karte fällt jetzt in denselben ehrlichen Zustand wie ohne Server |
| Die Klicks in die Karte gingen im E2E-Test ins Leere | Die Lagekarte liegt unten auf der Einsatzseite, außerhalb des Fensters. `page.mouse` klickt in Fensterkoordinaten | Karte vor dem Klick ins Bild holen |
| Prisma wollte wieder die Volltextindizes abräumen | Bekannt seit Phase 1 | DropIndex-Block aus der Migration entfernt, im Kopf vermerkt |
### Abweichung von der Vorgabe
**Keine Cluster-Darstellung.** Phase-6.md nennt sie. Bei 24 Löschwasserstellen
im Beispiel und einigen hundert in einer echten Wehr sind Cluster eine Lösung
für ein Problem, das erst bei Zehntausenden entsteht — und sie verstecken genau
das, was man sehen will: die Lücke im Netz. Nachrüstbar, wenn eine Wehr mit
großem Ausrückegebiet es vermisst.
**Kein Höhenprofil aus einem Geländemodell.** Die Höhe je Punkt wird von Hand
eingetragen. Ein Höhenmodell (SRTM, DGM) wäre ein weiterer Datensatz von
hunderten Megabyte, den jede Wehr selbst beschaffen müsste. Die Rechnung ist
ohne Höhe zu günstig — und das steht auch so an der Eingabe.
### Nachweise
- `npx tsc --noEmit` — ohne Ausgabe
- `npm run test` — 354 Tests grün
- `npx playwright test tests/e2e/karte.spec.ts` — 22 grün (Desktop und Tablet)
- `npm run build` — 44 Routen
- `npm run db:seed` — 24 Löschwasserstellen, 3 Objekte, Standorte verortet
---