From 693beb22632d42e17c1f4cd88cbe7b58d48026d1 Mon Sep 17 00:00:00 2001 From: dh_Agent Date: Tue, 22 Sep 2026 14:43:36 +0000 Subject: [PATCH] docs: Projektstatus und Einrichtungsentscheidung aktualisieren --- README.md | 57 +++++++++++++++++++++++++++++++++++++------ docs/Offene-Punkte.md | 27 ++++++++++---------- docs/module/README.md | 7 +++--- 3 files changed, 68 insertions(+), 23 deletions(-) diff --git a/README.md b/README.md index 5b2fe14..e1f6fe3 100644 --- a/README.md +++ b/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) diff --git a/docs/Offene-Punkte.md b/docs/Offene-Punkte.md index dadcddd..b85968b 100644 --- a/docs/Offene-Punkte.md +++ b/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 diff --git a/docs/module/README.md b/docs/module/README.md index c85d55a..d576177 100644 --- a/docs/module/README.md +++ b/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