Manager-Lizenzierung integrieren

docs/Obere-Anschluesse.md

@@ -1,16 +1,17 @@
 # Obere Anschlüsse des Managers
 
-> Status: Diskussionsentwurf. Anbieterformate und konkrete Gegenstellen sind
-> noch nicht festgelegt.
+> Status: Lizenzierung implementiert; die übrigen Anbieterformate sind noch
+> nicht festgelegt.
 
-Diese Anschlüsse sind optional. Sie werden im Manager konfiguriert und erzeugen
+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.
 
 | 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 |
-| Lizenzierung | Prüfung freigeschalteter Funktionen | Externer Lizenzdienst; kein Repo-Modul |
+| 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 |
 
 ## Gemeinsame Grundsätze
@@ -21,10 +22,13 @@ keine Abhängigkeit zwischen Enelix EMS und Enelix Utils.
 - Jeder Anschluss meldet im Manager `NichtVerwendet`, `Verbunden` oder `Fehler`.
 - Fehlende optionale Anschlüsse dürfen die lokale EMS-Grundfunktion nicht
   blockieren.
+- Eine fehlende oder abgelaufene Lizenz blockiert die Managerregelung. Eine
+  bestaetigte Entwicklungs-Lease bleibt bei Verbindungsunterbruch bis
+  `offlineUntil` gueltig.
 
 ## Noch festzulegen
 
-- Anbieter und Datenformat für Prognose, Lizenzierung und Störüberwachung
+- Anbieter und Datenformat für Prognose und Störüberwachung
 - Aufbau, Gültigkeitszeitraum und Rückmeldung eines SDL-Auftrags
-- Authentisierung und Verhalten bei Verbindungsunterbruch
-- Welche Lizenzfehler nur Funktionen sperren und welche den Manager stoppen
+- Authentisierung der noch optionalen Anschlüsse
+- Ablösung der Entwicklungs-Lease durch den signierten produktiven Lizenzvertrag

docs/Offene-Punkte.md

@@ -46,16 +46,17 @@ Prioritaeten, Fehlerverhalten und ein pruefbares Ergebnis.
 
 | ID | Status | Bereich | Kurzthema |
 | --- | --- | --- | --- |
-| OP-001 | Offen | Lizenzierung | Betriebsort des Lizenzservers |
+| OP-001 | Entschieden | Lizenzierung | Betriebsort des Lizenzservers |
 
-## Offene Entscheidungen
+## Entschiedene Punkte
 
 ### OP-001: Betriebsort des Lizenzservers
 
-- **Entscheidungsfrage:** Wo soll der Enelix-Lizenzserver betrieben werden?
-- **Verantwortlich:** Offen
-- **Ziel-Sprint:** Offen
-- **Ergebnis/Verweis:** Offen
+- **Entscheidung:** Der Entwicklungs-Lizenzdienst wird unter
+  `https://license.enelix.ch` betrieben.
+- **Manager-Endpunkt:** `POST /api/v1/licenses/activate`
+- **Ergebnis/Verweis:** [Obere Anschluesse](Obere-Anschluesse.md) und
+  [Manager](module/Manager/README.md)
 
 ## Vorlage fuer neue Punkte
 

docs/module/Manager/README.md

@@ -49,7 +49,7 @@ Ohne angelegte Diagnosevariablen existieren nur `Aktiv`, `Betriebsart` und `Netz
 | `Umschaltdifferenz` | Float | `5` %; Mindestdifferenz der berechneten Sollleistungen vor Umschaltung. |
 | `PrognoseAnschluss` | String/JSON | Optionaler Forecast-Anschluss. |
 | `SDLAnschluss` | String/JSON | Optionaler SDL/VGT-Anschluss. |
-| `LizenzAnschluss` | String/JSON | Optionaler Lizenzanschluss. |
+| `Lizenzcode` | String | Im Enelix-Lizenzportal erworbener Aktivierungscode. |
 | `StoermeldeAnschluss` | String/JSON | Optionaler Anschluss zur Störüberwachung. |
 | `DiagnosevariablenAnzeigen` | Boolean | `false`; zusätzliche Diagnosevariablen anlegen oder entfernen. |
 | `LoggingEin` | Boolean | `false`; laufende Meldungen im Debug-Fenster ausgeben. |
@@ -59,8 +59,12 @@ Manager. Im Modus `Aus` bleibt Solarladen aktiv, nur die Peak-Begrenzung entfäl
 Die Monatsgrenzen werden in den Grundeinstellungen über eine Schaltfläche
 ein- und ausgeblendet. Die automatische Verbrauchersuche kann dort erneut
 ausgeführt werden, ohne andere ungespeicherte Formulareingaben zu verlieren.
-Die vier optionalen oberen Anschlüsse besitzen jeweils einen eigenen Bereich;
-die Lizenzierung steht an erster Stelle des Formulars.
+Die Lizenzierung steht an erster Stelle des Formulars. Der Manager erzeugt dabei
+einmalig eine UUIDv4 als stabile Installations-ID. Mit "Lizenz pruefen und binden"
+wird der eingegebene Code ueber
+`POST https://license.enelix.ch/api/v1/licenses/activate` an diese Installation
+gebunden. Es werden weder Portal-Cookies noch ein CSRF-Token oder ein noch nicht
+implementierter Lizenzendpunkt verwendet.
 
 ## Verteilalgorithmus
 
@@ -94,6 +98,14 @@ wenn sich die beiden berechneten Korrekturen nicht ausreichend unterscheiden.
   als Sammelstörung ausgewiesen.
 - Bei fehlender oder veralteter Netzleistung bleibt die Regelung `Inaktiv` und
   sendet keine neuen Vorgaben.
+- Ohne gueltige Manager-Berechtigung bleibt der Manager mit Status `203` gesperrt.
+- Die Serverantwort wird lokal gespeichert und ab `refreshAfter` erneuert. Bei
+  einem Verbindungsfehler gilt eine zuvor bestaetigte Entwicklungsfreigabe bis
+  `offlineUntil`; danach wird die Regelung wieder gesperrt.
+- `manager_standard` erlaubt die Grundregelung. Ein aktiver Lastspitzenmodus
+  benoetigt `manager_peak`.
+- Der Lizenzcode wird nie geloggt. Lokal wird fuer den Lease-Abgleich nur sein
+  SHA-256-Wert gespeichert.
 - Die oberen Anschlüsse bleiben optional. Solange kein konkreter Adapter
   implementiert ist, meldet ein aktivierter Anschluss den Status `Fehler`, ohne
   die lokale EMS-Regelung zu blockieren.
@@ -107,5 +119,6 @@ wenn sich die beiden berechneten Korrekturen nicht ausreichend unterscheiden.
 ## Offene Punkte
 
 - Monatliche Batteriereserve aus dem alten Peakshaving-Modul übernehmen?
-- Anbieterformate für Prognose, Lizenzierung und Störüberwachung festlegen.
+- Anbieterformate für Prognose und Störüberwachung festlegen.
+- Produktive signierte Lizenz-Leases nach Abschluss des Entwicklungsvertrags integrieren.
 - Verhalten und Messabgrenzung bei Untermanagern im Anlagentest bestätigen.