# 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