Enelix-EMS/docs/Obere-Anschluesse.md

Obere Anschlüsse des Managers

Status: Lizenzierung, Prognose und Stoerueberwachung sind an license.enelix.ch angebunden. SDL/VGT bleibt als optionaler Anschluss vorbereitet.

Die Anschluesse werden ausschliesslich im Manager konfiguriert. Sie erzeugen keine Abhaengigkeit zwischen Enelix EMS und Enelix Utils.

Anschluss	Aufgabe	Gegenstelle
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
Stoerueberwachung	Vollsnapshot aktiver Manager- und Geraetestoerungen	PUT https://license.enelix.ch/api/v1/installations/{id}/faults

Stoerungsdatenfluss

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 NichtVerwendet, Wartet, Verbunden oder Fehler.
• Fehlende optionale Anschluesse duerfen die lokale EMS-Grundfunktion nicht blockieren.
• Zugangstoken werden weder als Property noch in Diagnosevariablen oder Logs ausgegeben.

Noch festzulegen

• Aufbau, Gueltigkeitszeitraum und Rueckmeldung eines SDL-Auftrags
• Produkt- und Zahlungsmodell der jaehrlichen Stoerueberwachungslizenz
• Verhalten nach Ablauf einer spaeter aktivierten Stoerueberwachungslizenz