docs: Projektstatus und Einrichtungsentscheidung aktualisieren

README.md

@@ -6,26 +6,64 @@ Energiemanagement, Manager und steuerbare Verbraucher fuer IP-Symcon.
 
 Das Repository befindet sich im Aufbau. Der gemeinsame Nachrichtenvertrag, die
 Verbraucherbasis, der Manager, der mehrstufige Warmwassererwaermer, der
-1-stufige Verbraucher und die Ladestation Stand-Alone sind implementiert. Die
-weiteren Module sind als Diskussionsentwürfe dokumentiert.
+Pufferspeicher, die Batterie, der 1-stufige Verbraucher, die Ladestation
+Stand-Alone sowie das Easee Gateway mit Ladestation Gateway sind implementiert. Die weiteren
+Module sind als Diskussionsentwuerfe dokumentiert.
 
-## Geplante Module
+## Module
 
 - Manager (implementiert)
 - Batterie (implementiert)
 - Wassererwaermer (implementiert)
-- Pufferspeicher
+- Pufferspeicher (implementiert)
 - Verbraucher 1-Stufig (implementiert)
 - Waermepumpe (implementiert)
 - Ladestation Stand-Alone (implementiert)
-- Ladestation Gateway
-- Easee Gateway
+- Ladestation Gateway (implementiert)
+- Easee Gateway (implementiert)
 
 Die Properties, Variablen, Zustandsdaten und offenen Punkte stehen in der
 [Modulübersicht](docs/module/README.md). Gemeinsame Felder werden dort nicht
 abweichend neu definiert, sondern verweisen auf den zentralen Vertrag.
 
-Die Verbraucher kommunizieren mit dem Manager ueber den gemeinsamen Vertrag in `libs/`. Der Manager waehlt die Verbraucher aus; in einem Verbraucher gibt es keine Manager-ID-Property.
+Die Verbraucher kommunizieren mit dem Manager ueber den gemeinsamen Vertrag
+in `libs/`. Der Manager waehlt die Verbraucher aus; in einem Verbraucher gibt
+es keine Manager-ID-Property.
+
+## Betriebsartabhaengige Leistungsangebote
+
+Der Nachrichtenvertrag `4.0` uebermittelt in beiden Richtungen verpflichtend
+die aktuelle `Betriebsart`. Zulaessige Werte sind `PV` fuer Solarbetrieb und
+`Peak` fuer die Lastspitzenbegrenzung. Dadurch kann jeder Verbraucher fuer
+beide Betriebsarten unterschiedliche PowerSteps melden.
+
+Ein Betriebsartwechsel wird synchronisiert:
+
+1. Der Manager bestimmt die neue Betriebsart.
+2. Er sendet sie mit `Sollleistung_W: null` an alle aktiven Verbraucher.
+3. `null` ist nur eine Ankuendigung und kein Schaltbefehl.
+4. Jeder Verbraucher berechnet sein zustandsabhaengiges Leistungsangebot neu
+   und meldet es mit derselben Betriebsart zurueck.
+5. Erst wenn alle aktiven Verbraucher synchronisiert sind, verteilt der
+   Manager konkrete Sollleistungen.
+
+Der Manager verwendet damit nie ein PV-Angebot fuer Peak oder umgekehrt. Eine
+technische Schaltsperre, eine ausstehende Rueckmeldung oder eine Mindestzeit
+kann das Angebot weiterhin auf die aktuell gehaltene Leistung begrenzen.
+
+| Verbraucher | PV-Angebot | Peak-Angebot |
+| --- | --- | --- |
+| Verbraucher 1-Stufig | Normal `[0, Nennleistung]`; bei faelliger Tagesmindestlaufzeit `[Nennleistung]` | Normal `[0]`; bei faelliger Tagesmindestlaufzeit konfigurierbar `[0, Nennleistung]` oder `[Nennleistung]` |
+| Ladestation Stand-Alone | Mit Solarladen `[0, ...Ladestufen]`, sonst maximale Ladeleistung | Mit Solarladen `[0]`, sonst `[0, ...Ladestufen]` |
+| Ladestation Gateway | Mit Solarladen `[0, ...Ladestufen]`, sonst maximale Ladeleistung | Mit Solarladen `[0]`, sonst `[0, ...Ladestufen]` |
+| Warmwassererwaermer | Unter Mindesttemperatur maximale Stufe, sonst zustandsabhaengig | Unter wirksamer Mindesttemperatur `[0, ...Leistungsstufen]`, sonst `[0]` |
+| Pufferspeicher | Unter Einschaltschwelle `[0, ...Leistungsstufen]`, sonst `[0]` | Unabhaengig vom Zustand `[0]` |
+| Batterie | SoC-abhaengiges Lade-/Entladeraster | SoC-, Reserve- und netzabhaengiges Angebot |
+
+Die vollstaendigen Nachrichtenfelder und JSON-Beispiele stehen in der
+[Manager-Verbraucher-Schnittstelle](docs/Schnittstelle.md). Hintergrund,
+Alternativen und Folgen beschreibt
+[ADR 0004](docs/adr/0004-betriebsartabhaengige-leistungsangebote.md).
 
 ## Voraussetzungen
 
@@ -63,11 +101,16 @@ der Uebernahme in einen Freigabebranch erfolgreich sein.
 - [Zentrale Liste offener Teamentscheidungen](docs/Offene-Punkte.md)
 - [Manager-Verbraucher-Schnittstelle](docs/Schnittstelle.md)
 - [Batterieschnittstelle](docs/Schnittstelle-Batterie.md)
+- [ADR 0004: Betriebsartabhaengige Leistungsangebote](docs/adr/0004-betriebsartabhaengige-leistungsangebote.md)
 - [Manager-Modul inklusive Lizenzierung](docs/module/Manager/README.md)
 - [Warmwassererwaermer-Modul](docs/module/Wassererwaermer/README.md)
+- [Pufferspeicher-Modul](docs/module/Pufferspeicher/README.md)
 - [Batteriemodul](docs/module/Batterie/README.md)
 - [Verbraucher-1-Stufig-Modul](docs/module/Verbraucher-1-Stufig/README.md)
 - [Ladestation-Stand-Alone-Modul](docs/module/Ladestation-Stand-Alone/README.md)
+- [Ladestation-Gateway-Modul](docs/module/Ladestation-Gateway/README.md)
+- [Easee-Gateway-Modul](docs/module/Easee-Gateway/README.md)
+- [Easee-Gateway-Schnittstelle](docs/Schnittstelle-Easee-Gateway.md)
 - [Migration Boiler x-Stufig](docs/migration/Boiler-x-Stufig.md)
 - [Migration Verbraucher 1-Stufig](docs/migration/Verbraucher-1-Stufig.md)
 - [Migration Batterie](docs/migration/Batterie.md)