From 0f9860356d6fb03e8ea45bf3d6a4e38b3e478a99 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20H=C3=A4fliger?= <dh@belevo.ch>
Date: Thu, 10 Sep 2026 08:00:35 +0000
Subject: [PATCH] Entwurf: docs/module/Manager/README.md

---
 docs/module/Manager/README.md | 72 +++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 docs/module/Manager/README.md

diff --git a/docs/module/Manager/README.md b/docs/module/Manager/README.md
new file mode 100644
index 0000000..e008fea
--- /dev/null
+++ b/docs/module/Manager/README.md
@@ -0,0 +1,72 @@
+# Manager
+
+> Status: Diskussionsentwurf. Führt Hauptmanager und Peakshaving zusammen.
+
+Der Manager liest die Netzleistung, verwaltet ausschliesslich die ausgewählten
+Verbraucher und verteilt Leistung im PV- oder Peak-Betrieb. Die Prioritäten
+kommen aus den Verbrauchermeldungen.
+
+## Variablen
+
+Ohne Logging sind nur `Aktiv`, `Betriebsart` und `Netzleistung` sichtbar.
+
+| Ident | Typ / Zugriff | Beschreibung |
+| --- | --- | --- |
+| `Aktiv` | Boolean / bedienbar | Regelung ein/aus; Start `false`. |
+| `Betriebsart` | String / Anzeige | `Inaktiv`, `PV` oder `Peak`. |
+| `Netzleistung` | Float / Anzeige | Aktuelle Netzleistung in W; positiv Bezug, negativ Einspeisung. |
+| `NetzleistungGueltig` | Boolean / Logging | Messquelle vorhanden und aktuell. |
+| `WirksameLastspitzengrenze` | Float / Logging | Aktuelle feste oder monatliche Grenze in W. |
+| `Verteilbudget` | Float / Logging | Aktuell verfügbares Budget in W. |
+| `VerbraucherAnzahl` | Integer / Logging | Anzahl zugeordneter Verbraucher. |
+| `VerbraucherVerfuegbar` | Integer / Logging | Anzahl aktuell verfügbarer Verbraucher. |
+| `Verbraucherstatus` | String/JSON / Logging | Letzte vollständige Meldungen. |
+| `Prognosestatus` | String / Logging | `NichtVerwendet`, `Verbunden` oder `Fehler`. |
+| `SDLStatus` | String / Logging | Status des SDL/VGT-Anschlusses. |
+| `Lizenzstatus` | String / Logging | Status der Lizenzprüfung. |
+| `Stoerueberwachungsstatus` | String / Logging | Status der externen Störüberwachung. |
+| `Sammelstoerung` | Boolean / Logging | Eigene und weitergeleitete Störungen. |
+| `Stoertext` | String / Logging | Lesbare Sammelmeldung. |
+
+## Properties
+
+| Ident | Typ | Standard / Beschreibung |
+| --- | --- | --- |
+| `Rolle` | Auswahl | `Alleine`; alternativ `Hauptmanager` oder `Untermanager`. |
+| `NetzleistungVariableID` | Integer | `0*`; gültige Messquelle vor Regelstart. |
+| `Netzleistungsfaktor` | Float | `1`; auf W und die vereinbarte Vorzeichenrichtung normieren. |
+| `MesswertMaxAlter` | Integer | `30` s; auf echte Messaktualisierung bezogen. |
+| `VerbraucherZuordnung` | String/JSON | `[]`; Instanz-ID und Aktiv je Verbraucher. Einzige gespeicherte Zuordnung. |
+| `AutomatischeSuche` | Boolean | `true`; findet Kandidaten, aktiviert sie aber nicht automatisch. |
+| `SuchbereichID` | Integer | `0`; optionaler Suchbereich. |
+| `Regelintervall` | Integer | `2` s; zusätzlich auf relevante Änderungen reagieren. |
+| `Vorgabeintervall` | Integer | `10` s; laufende Vorgaben erneuern. |
+| `VerbraucherTimeout` | Integer | `30` s; ausgebliebene Meldung erkennen. |
+| `Lastspitzenmodus` | Auswahl | `Aus`; alternativ `Konstant` oder `Monatlich`. |
+| `Lastspitzengrenze` | Float | Feste Grenze in W für Modus `Konstant`. |
+| `Monatsgrenzen` | String/JSON | Zwölf Monatswerte in W. |
+| `MonatsgrenzenVisuBedienbar` | Boolean | `false`; Monatstabelle in der Visualisierung bedienen. |
+| `SollwertSolarladen` | Float | `0` W; gewünschte Netzleistung im Solarladebetrieb. |
+| `UmschaltschwelleUeberschuss` | Float | Feste W-Schwelle für PV-Betrieb. |
+| `UmschaltschwelleLastspitze` | Float | Feste W-Schwelle für Peak-Betrieb. |
+| `Umschaltdifferenz` | Float | `0` %; Mindestdifferenz der berechneten Sollleistungen vor Umschaltung. |
+| `PrognoseAnschluss` | String/JSON | Optionaler Forecast-Anschluss. |
+| `SDLAnschluss` | String/JSON | Optionaler SDL/VGT-Anschluss. |
+| `LizenzAnschluss` | String/JSON | Optionaler Lizenzanschluss. |
+| `StoermeldeAnschluss` | String/JSON | Optionaler Anschluss zur Störüberwachung. |
+| `LoggingEin` | Boolean | `false`; Protokollierung und zusätzliche Variablen anzeigen. |
+
+Es gibt keine Sollwertquellenauswahl und keine zweite Prioritätseinstellung im
+Manager. Im Modus `Aus` bleibt Solarladen aktiv, nur die Peak-Begrenzung entfällt.
+
+## Schnittstellen
+
+- Empfängt genau `VerbraucherdatenEmpfangen(array $daten)`.
+- Sendet an jeden Verbraucher nur Kopf und `Sollleistung_W`.
+- Obere Anschlüsse: siehe [Obere Anschlüsse](../../Obere-Anschluesse.md).
+
+## Offene Punkte
+
+- Monatliche Batteriereserve aus dem alten Peakshaving-Modul übernehmen?
+- Anbieterformate für Prognose, Lizenzierung und Störüberwachung festlegen.
+- Verhalten und Messabgrenzung bei Untermanagern im Anlagentest bestätigen.