feat(manager): Lizenzierung und Energietopologie verfeinern

docs/module/Manager/README.md

@@ -62,12 +62,15 @@ Die drei Regelungsvariablen `Aktiv`, `Betriebsart` und `Netzleistung` sind immer
 | `Umschaltdifferenz` | Float | `5` %; Mindestdifferenz der berechneten Sollleistungen vor Umschaltung. |
 | `EinspeisebegrenzungAktiv` | Boolean | `false`; gemeinsame Exportgrenze am Netzanschlusspunkt aktivieren. |
 | `Einspeisegrenze` | Float | Maximale Einspeisung der Gesamtanlage in W; `0` bedeutet Nulleinspeisung. |
-| `Einspeisetoleranz` | Float | `100` W; Totband gegen pendelnde Wechselrichtervorgaben. |
+| `PrognoseAktiv` | Boolean | `false`; Prognosetelemetrie und Topologiesynchronisation mit `forecast_pv` plus `forecast_load` oder `grid_schedule` aktivieren. |
 | `NetzfahrplanAktiv` | Boolean | `false`; lizenzierten, tarif- und prognosebasierten Netzzielwert verwenden. |
-| `AnlagenWechselrichter` | String/JSON | `[]`; Wechselrichter mit Typ, AC-Grenzen, Istleistungsmessung und optionalem Begrenzungsregister. |
+| `NetzbezugEnergieVariableID` | Integer | Optionaler kumulativer Netzbezugszaehler. |
+| `NetzeinspeisungEnergieVariableID` | Integer | Optionaler kumulativer Einspeisezaehler. |
+| `NetzbezugEnergiefaktor`, `NetzeinspeisungEnergiefaktor` | Float | Umrechnung der Netzenergiezaehler nach kWh. |
+| `AnlagenWechselrichter` | String/JSON | `[]`; Wechselrichter mit Typ, AC-Nennleistung, Leistungs- und Erzeugungsenergiemessung sowie optionalem Begrenzungsregister. |
 | `AnlagenPVFlaechen` | String/JSON | `[]`; PV-Flaechen mit DC-Leistung, Ausrichtung und Wechselrichter-ID. |
-| `AnlagenBatterien` | String/JSON | `[]`; Batteriespeicher mit Kapazitaeten, Kopplung, Leistungs- und SOC-Messung. |
-| `PrognoseSendeintervall` | Integer | `60` s; zulaessig sind 60 bis 3600 Sekunden. |
+| `AnlagenBatterien` | String/JSON | `[]`; Batteriespeicher mit Kapazitaeten, Kopplung, Leistung, SOC sowie Lade- und Entladeenergiezaehlern. |
+| `PrognoseSendeintervall` | Integer | `60` s; Intervall fuer den Upload aktueller Messwerte, zulaessig sind 60 bis 3600 Sekunden. |
 | `PrognoseAnschluss` | String/JSON | Verdeckte Altproperty fuer bestehende Konfigurationen. |
 | `SDLAnschluss` | String/JSON | Optionaler SDL/VGT-Anschluss. |
 | `Lizenzcode` | String | Im Enelix-Lizenzportal erworbener Aktivierungscode. |
@@ -99,9 +102,14 @@ konfiguriert sind, tastet der Manager die Quellen minuetlich ab. PV-Leistung ist
 die Summe der den PV-Flaechen zugeordneten Wechselrichter. Batterieleistung und
 der kapazitaetsgewichtete SOC stammen aus den Batteriespeichern. Positive
 Batterieleistung bedeutet Laden, negative Entladen. Der Hausverbrauch wird als
-`PV + Netz - Batterie` bilanziert. Dieselben Werte versorgen ohne zweite
-Eingabe auch die Prognosetelemetrie. Ausfallluecken ueber fuenf Minuten werden
-nicht nachberechnet.
+`PV + Netz - Batterie` bilanziert. Sind Netzbezugs-, Einspeise-, PV-Erzeugungs-
+sowie gegebenenfalls Batterie-Lade- und Entladezaehler vollstaendig hinterlegt,
+verwendet der Manager deren Deltas fuer die Energieaufzeichnung. Die Hausenergie
+wird dann als `PV + Netzbezug + Batterieentladung - Einspeisung - Batterieladung`
+berechnet. Ohne vollstaendigen Zaehlerdatensatz integriert der Manager weiterhin
+die Leistungswerte. Dieselben Quellen versorgen ohne zweite Eingabe auch die
+Prognosetelemetrie. Ausfallluecken ueber fuenf Minuten werden bei der
+Leistungsintegration nicht nachberechnet.
 
 Batteriespeicher bleiben als physische Komponenten samt Messquellen in der
 Anlagentopologie. Ein zusaetzliches Batterieverbrauchermodul beschreibt dagegen
@@ -136,9 +144,10 @@ absolute Leistung in Watt ausgegeben werden.
 
 Der Manager berechnet eine einzige Grenze fuer die Gesamtanlage. Beim Abregeln
 verteilt er sie nach der tatsaechlichen Erzeugung, beim Freigeben nach der
-AC-Nennleistung auf alle angebotenen Wechselrichter. Das Totband verhindert
-Pendeln am Grenzwert. Beim Abschalten des Managers oder der
-Funktion werden zuvor gesetzte Grenzen kontrolliert auf die jeweilige
+AC-Nennleistung auf alle angebotenen Wechselrichter. Jede gemessene Abweichung
+wird stufenlos nachgefuehrt; ein zusaetzliches Toleranzfenster wird nicht
+verwendet. Beim Abschalten des Managers oder der Funktion werden zuvor gesetzte
+Grenzen kontrolliert auf die jeweilige
 Nennleistung zurueckgesetzt. Wechselrichter ohne beide Register werden nicht
 geregelt; sobald eines der beiden Register gesetzt ist, muessen beide gueltig
 sein und das Begrenzungsregister eine IP-Symcon-Aktion besitzen.
@@ -157,8 +166,10 @@ davon aktiv.
 
 Der Manager ist die fuehrende Quelle fuer die technischen Stammdaten. Die
 Konfiguration trennt Wechselrichter, PV-Flaechen und Batteriespeicher. AC-Leistung
-wird am Wechselrichter, DC-Leistung an der PV-Flaeche gepflegt. Modulanzahl und
-Modulleistung sind optional und muessen gemeinsam gesetzt werden.
+wird am Wechselrichter, DC-Leistung an der PV-Flaeche gepflegt. Individuelle
+AC-Einspeise- und Bezugsgrenzen werden nicht erfasst, weil die Begrenzung
+anlagenweit am Netzanschlusspunkt erfolgt. Modulanzahl und Modulleistung sind
+optional und muessen gemeinsam gesetzt werden.
 
 PV-Flaechen und Batterien referenzieren ihren Wechselrichter ueber dessen stabile
 ID. Bei `hybrid` koennen beide denselben Wechselrichter verwenden. Der Export
@@ -167,9 +178,10 @@ AC-Grenze aus, damit PV und Batterie die Nennleistung nicht unabhaengig doppelt
 beanspruchen.
 
 Der JSON-Export enthaelt die Vertragsversion `1.0`, die Lizenz-Installations-ID,
-die drei Komponentenlisten, gemeinsame AC-Grenzen und aggregierte Summen fuer
-die schrittweise Prognoseanbindung. Tarif- und Variantenparameter bleiben im
-Prognoseportal. Eine nichtleere Topologie wird beim Speichern automatisch ueber
+die drei Komponentenlisten, gemeinsame AC-Nennleistungen und aggregierte Summen
+fuer die schrittweise Prognoseanbindung. Interne Symcon-Variablen-IDs werden
+nicht exportiert. Tarif- und Variantenparameter bleiben im Prognoseportal. Bei
+aktivierter Prognose wird eine nichtleere Topologie beim Speichern automatisch ueber
 einen separaten, widerrufbaren Installationszugang synchronisiert. Der
 Lizenzserver liefert diesen Zugang nur auf ausdrueckliche Geraeteanforderung;
 der Manager entfernt ihn vor dem Speichern aus der Lease und haelt ihn in einem
@@ -177,9 +189,12 @@ internen Attribut. Der Lizenzcode wird nicht als API-Token verwendet. Ein
 Synchronisationsfehler erscheint im `Prognosestatus`, blockiert die lokale
 EMS-Regelung aber nicht.
 
-Sind PV-Leistung, Hausverbrauch und Batterie-SOC gemeinsam konfiguriert, sendet
-der Manager diese Werte zusammen mit der faktorbereinigten Netzleistung und
-einem UTC-Zeitstempel im eingestellten Intervall. Das Minimum von 60 Sekunden
+Der Forecast-Schalter zeigt direkt an, ob fuer die Manager-ID eine passende
+Kombination `forecast_pv` plus `forecast_load` oder `grid_schedule` vorhanden ist. Nach der Aktivierung sendet der
+Manager PV-Leistung, berechneten Hausverbrauch, Netzleistung und Batterie-SOC
+mit UTC-Zeitstempel im eingestellten Sendeintervall. Dieses Intervall bestimmt
+also, wie oft aktuelle Messwerte zum Prognosedienst hochgeladen werden; es ist
+kein Regelintervall. Das Minimum von 60 Sekunden
 passt zum Rate-Limit des Lizenzportals. Die Uebertragung nutzt denselben
 widerrufbaren Installationszugang wie die Topologie; Lizenzcode und Geraet Token
 werden weder als Telemetriefelder noch im Debug-Log ausgegeben. Bei HTTP 401