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)

docs/Offene-Punkte.md

@@ -47,25 +47,13 @@ Prioritaeten, Fehlerverhalten und ein pruefbares Ergebnis.
 | ID | Status | Bereich | Kurzthema |
 | --- | --- | --- | --- |
 | OP-001 | Entschieden | Lizenzierung | Betriebsort des Lizenzservers |
-| OP-002 | Offen | Grundeinrichtung | Generator und kostenpflichtige Ersteinrichtung |
+| OP-002 | Erledigt | Grundeinrichtung | Generator und kostenpflichtige Ersteinrichtung |
 | OP-003 | Offen | Lizenzportal | VGT-Integration in license.enelix.ch |
 | OP-004 | Offen | Lizenzierung | Lizenzmodell des Verbrauchskostenreports |
 | OP-005 | Offen | Teststrategie | Standort fuer Feldtests |
 
 ## Offene Punkte
 
-### OP-002: Generator und kostenpflichtige Ersteinrichtung
-
-- **Entscheidungsfrage:** Soll der automatische Generator fuer die
-  Grundeinrichtung zugleich die kostenpflichtige Ersteinrichtung abbilden?
-- **Kontext:** Der vorgesehene automatische Generator fuer die Grundeinrichtung
-  muss gegenueber der kostenpflichtigen Ersteinrichtung abgegrenzt werden.
-- **Auswirkung:** Die Entscheidung legt fest, ob beide als derselbe Vorgang oder
-  als getrennte Leistungen behandelt werden.
-- **Verantwortlich:** Offen
-- **Ziel-Sprint:** Offen
-- **Ergebnis/Verweis:** Offen
-
 ### OP-003: VGT-Integration in license.enelix.ch
 
 - **Entscheidungsfrage:** Soll die VGT-Anwendung als Bestandteil in die
@@ -113,6 +101,19 @@ Prioritaeten, Fehlerverhalten und ein pruefbares Ergebnis.
 - **Ergebnis/Verweis:** [Obere Anschluesse](Obere-Anschluesse.md) und
   [Manager](module/Manager/README.md)
 
+### OP-002: Generator und kostenpflichtige Ersteinrichtung
+
+- **Entscheidung:** Der automatische Systemgenerator und die kostenpflichtige
+  Ersteinrichtung sind derselbe Vorgang.
+- **Abrechnung:** Eine Bestellung aus dem Systemkonfigurator enthaelt
+  automatisch die noch nicht bezahlten Einrichtungskosten fuer den Manager und
+  die konfigurierten Verbrauchermodule. Bereits bezahlte Einrichtungsmengen
+  werden je Anlage angerechnet. Direkte Lizenzbestellungen enthalten keine
+  Einrichtungskosten.
+- **Status:** Erledigt
+- **Ergebnis/Verweis:** Umsetzung im Lizenzportal unter
+  `https://license.enelix.ch`.
+
 ## Vorlage fuer neue Punkte
 
 ```markdown

docs/module/README.md

@@ -1,8 +1,9 @@
 # EMS-Module und Modulentwürfe
 
-> Manager, Warmwassererwaermer, Batterie, Verbraucher 1-Stufig, Waermepumpe,
-> Ladestation Stand-Alone, Easee Gateway und Ladestation Gateway sind als
-> installierbare IP-Symcon-Module umgesetzt. Die weiteren Ordner enthalten Besprechungsgrundlagen.
+> Manager, Warmwassererwaermer, Pufferspeicher, Batterie, Verbraucher 1-Stufig,
+> Waermepumpe, Ladestation Stand-Alone, Easee Gateway und Ladestation Gateway
+> sind als installierbare IP-Symcon-Module umgesetzt. Die weiteren Ordner
+> enthalten Besprechungsgrundlagen.
 
 Alle steuerbaren Verbraucher verwenden die gemeinsamen Datenpunkte aus der
 [EMS-Schnittstelle](../Schnittstelle.md). In den Modul-READMEs stehen deshalb