61 lines
2.9 KiB
Markdown
61 lines
2.9 KiB
Markdown
# 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
|