feat: add alarm_thresholds to pegel detail endpoint

Scrape the official alarm level thresholds (Richtwasserstände) from the
station detail page and include them in GET /api/pegel/{pegel_id} as
alarm_thresholds, cached for 24 hours with a stale-cache fallback on
errors. null for stations without a flood alert function.

Also clarify in the flood_alert_level docs that 'Kein Hochwassermeldepegel'
means the station is not used for official flood alerts/control, not
that measurement data is missing.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

README.md

@@ -101,6 +101,12 @@ Beispielantwort:
       "flood_alert_level": "Kein Hochwasser"
     }
   ],
+  "alarm_thresholds": [
+    { "level": 1, "water_level_cm": 360 },
+    { "level": 2, "water_level_cm": 400 },
+    { "level": 3, "water_level_cm": 480 },
+    { "level": 4, "water_level_cm": 600 }
+  ],
   "source": "https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/portal/web/feed/wasserstand-pegel-560021",
   "fetched_at": "2026-05-05T00:16:00+00:00"
 }
@@ -118,6 +124,7 @@ Beispielantwort:
 | `water_level_cm` | number oder `null` | Wasserstand in Zentimetern |
 | `flow_m3s` | number oder `null` | Durchfluss in Kubikmetern pro Sekunde |
 | `flood_alert_level` | string oder `null` | Meldestufe als Text, siehe unten |
+| `alarm_thresholds` | array oder `null` | Richtwasserstände der Alarmstufen 1–4, siehe unten |
 | `source` | string | URL des verwendeten RSS-Feeds |
 | `fetched_at` | string | Zeitpunkt des Abrufs durch die API als UTC-Zeitstempel |
 
@@ -131,11 +138,20 @@ Einträge ohne Wasserstand und ohne Durchfluss (Platzhalter der Quelle für noch
 | --- | --- |
 | `Niedrigwasser` | Niedrigwasser |
 | `Kein Hochwasser` | Hochwassermeldepegel, Richtwerte nicht erreicht |
-| `Kein Hochwassermeldepegel` | Pegel ohne Hochwassermeldefunktion |
+| `Kein Hochwassermeldepegel` | Der Pegel wird nicht für amtliche Hochwassermeldungen bzw. -steuerung genutzt. Das bedeutet nicht, dass Messwerte fehlen; solche Pegel haben lediglich keine Alarmstufen und `alarm_thresholds` ist `null` |
 | `Alarmstufe 1` bis `Alarmstufe 4` | Richtwert der jeweiligen Alarmstufe überschritten (1 Meldedienst, 2 Kontrolldienst, 3 Wachdienst, 4 Hochwasserabwehr) |
 
 Die ersten drei Werte wurden in den Feeds aller Pegel beobachtet. Die Alarmstufen stammen aus der Legende der HWIMS-Übersichtsseite; ihre genaue Schreibweise im RSS-Feed ist nicht verifiziert, da sie bei der Prüfung nicht aufgetreten sind. Clients sollten unbekannte Werte tolerieren.
 
+### `alarm_thresholds`
+
+Richtwasserstände (in cm), ab denen die jeweilige Alarmstufe laut HWIMS gilt. Die Werte werden von der Pegel-Detailseite (nicht dem RSS-Feed) ermittelt und 24 Stunden zwischengespeichert, da sie sich praktisch nie ändern. Ist die Detailseite nicht erreichbar, liefert die API einen vorhandenen (ggf. abgelaufenen) Cache-Wert oder `null`, ohne dass die übrige Antwort davon betroffen ist. Pegel ohne Hochwassermeldefunktion (`flood_alert_level` = `Kein Hochwassermeldepegel`) haben keine Richtwasserstände; hier ist das Feld `null`.
+
+| Feld | Typ | Bedeutung |
+| --- | --- | --- |
+| `level` | integer | Alarmstufe, 1 bis 4 |
+| `water_level_cm` | integer | Richtwasserstand dieser Alarmstufe in Zentimetern |
+
 ## Fehlerantworten
 
 Fehler der API enthalten ein JSON-Objekt mit dem Feld `detail`.
@@ -207,6 +223,7 @@ Die Messwerte werden von der offiziellen Website des Freistaats Sachsen bereitge
 
 - Übersicht: <https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/portal/web/wasserstand-uebersicht>
 - Beispiel-Feed: <https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/portal/web/feed/wasserstand-pegel-560021>
+- Beispiel-Detailseite (Quelle für `alarm_thresholds`): <https://www.umwelt.sachsen.de/umwelt/infosysteme/hwims/portal/web/wasserstand-pegel-560021>
 
 Verfügbarkeit und Richtigkeit der Quelldaten werden nicht garantiert. Änderungen am Aufbau der HWIMS-Seiten oder RSS-Feeds können die Verarbeitung beeinträchtigen. Dieses Projekt ist nicht mit dem Freistaat Sachsen verbunden.