feat(manager): Störungsüberwachung ans Portal anbinden

docs/Obere-Anschluesse.md

@@ -1,34 +1,60 @@
 # Obere Anschlüsse des Managers
 
-> Status: Lizenzierung implementiert; die übrigen Anbieterformate sind noch
-> nicht festgelegt.
+> Status: Lizenzierung, Prognose und Stoerueberwachung sind an
+> `license.enelix.ch` angebunden. SDL/VGT bleibt als optionaler Anschluss
+> vorbereitet.
 
-Prognose, SDL/VGT und Stoerueberwachung sind optional. Die Lizenzierung ist fuer
-den Betrieb des Managers erforderlich. Sie werden im Manager konfiguriert und erzeugen
-keine Abhängigkeit zwischen Enelix EMS und Enelix Utils.
+Die Anschluesse werden ausschliesslich im Manager konfiguriert. Sie erzeugen
+keine Abhaengigkeit zwischen Enelix EMS und Enelix Utils.
 
 | Anschluss | Aufgabe | Gegenstelle |
 | --- | --- | --- |
-| SDL/VGT | Zeitlich gültige Leistungsaufträge und Rückmeldungen | Optional das unabhängige Utils-Modul VGT-Schnittstelle |
-| Prognose / Forecast | Vorhersage für Produktion und bei Bedarf Verbrauch | Externer Anbieter; kein Repo-Modul |
+| SDL/VGT | Zeitlich gueltige Leistungsauftraege und Rueckmeldungen | Optional das unabhaengige Utils-Modul VGT-Schnittstelle |
+| Prognose / Forecast | Topologie, Telemetrie und Netzfahrplan | `license.enelix.ch/api/v1/installations/{id}/prognosis/*` |
 | Lizenzierung | Pruefung freigeschalteter Manager-Funktionen | `POST https://license.enelix.ch/api/v1/licenses/activate` |
-| Störüberwachung | Weitergabe von Zuständen und Störungen | Externer Empfänger; kein Repo-Modul |
+| Stoerueberwachung | Vollsnapshot aktiver Manager- und Geraetestoerungen | `PUT https://license.enelix.ch/api/v1/installations/{id}/faults` |
 
-## Gemeinsame Grundsätze
+## Stoerungsdatenfluss
 
-- Die Auswahl der Gegenstelle erfolgt ausschliesslich im Manager.
-- Anbieterformate werden an diesem Anschluss übersetzt und gelangen nicht in
+1. Jedes Geraetemodul meldet seinen Zustand ueber den bestehenden
+   Verbraucher-Nachrichtenvertrag an den Manager.
+2. Der Manager sammelt aktive Eintraege mit `Art = Stoerung`, fuegt eigene
+   Regelungsstoerungen hinzu und normalisiert sie.
+3. Der Manager speichert lokal einen deterministisch sortierten Vollsnapshot.
+4. Bei Zustandsaenderung oder spaetestens im konfigurierten Heartbeat-Intervall
+   sendet er den Snapshot mit dem vorhandenen Geraete-Bearer-Token.
+5. Ein leerer Snapshot loest zuvor aktive Stoerungen im Portal auf.
+
+Jede Meldung besteht aus `sourceType`, `sourceId`, `sourceName`, `code`,
+`severity` und `message`. Die stabile Kombination aus `sourceId` und
+`code` identifiziert ein Ereignis ueber mehrere Snapshots hinweg.
+
+Fehler der externen Uebertragung blockieren die lokale EMS-Regelung nicht. Der
+Manager wiederholt mit exponentiellem Abstand zwischen 30 und 900 Sekunden.
+Nach HTTP 401 oder 403 verwirft er den Geraetezugang und fordert ihn bei der
+naechsten Lizenzaktivierung neu an.
+
+## Lizenzvorbereitung
+
+Die Stoerueberwachung ist technisch als separat schaltbare Manager-Funktion
+gekapselt. Das Portal kann spaeter eine Berechtigung mit dem Katalogschluessel
+`fault_monitoring`, einer Laufzeit von einem Jahr und einem erneuerten
+`validUntil` ausliefern. In der ersten Ausbaustufe wird diese zusaetzliche
+Jahresberechtigung noch nicht erzwungen; Voraussetzung bleibt eine gueltige
+Managerlizenz samt Geraetezugang.
+
+## Gemeinsame Grundsaetze
+
+- Anbieterformate werden am Manageranschluss uebersetzt und gelangen nicht in
   die Verbraucher-Schnittstelle.
-- Jeder Anschluss meldet im Manager `NichtVerwendet`, `Verbunden` oder `Fehler`.
-- Fehlende optionale Anschlüsse dürfen die lokale EMS-Grundfunktion nicht
+- Jeder Anschluss meldet `NichtVerwendet`, `Wartet`, `Verbunden` oder
+  `Fehler`.
+- Fehlende optionale Anschluesse duerfen die lokale EMS-Grundfunktion nicht
   blockieren.
-- Eine fehlende oder abgelaufene Lizenz blockiert die Managerregelung. Eine
-  bestaetigte Entwicklungs-Lease bleibt bei Verbindungsunterbruch bis
-  `offlineUntil` gueltig.
-
+- Zugangstoken werden weder als Property noch in Diagnosevariablen oder Logs
+  ausgegeben.
 ## Noch festzulegen
 
-- Anbieter und Datenformat für Prognose und Störüberwachung
-- Aufbau, Gültigkeitszeitraum und Rückmeldung eines SDL-Auftrags
-- Authentisierung der noch optionalen Anschlüsse
-- Ablösung der Entwicklungs-Lease durch den signierten produktiven Lizenzvertrag
+- Aufbau, Gueltigkeitszeitraum und Rueckmeldung eines SDL-Auftrags
+- Produkt- und Zahlungsmodell der jaehrlichen Stoerueberwachungslizenz
+- Verhalten nach Ablauf einer spaeter aktivierten Stoerueberwachungslizenz