Verbraucher 1-Stufig eventbasiert implementieren

docs/migration/Verbraucher-1-Stufig.md

@@ -0,0 +1,60 @@
+# Migration von Verbraucher_1_Stufig
+
+Das Enelix-1-Modul wird nicht in-place aktualisiert. Das neue Modul verwendet
+eine neue Modul-ID, den Vertrag `3.0` und eine ereignisbasierte Regelung.
+
+## Eigenschaften
+
+| Enelix 1 | Enelix 2 | Migration |
+| --- | --- | --- |
+| `BoilerLeistung` | `Nennleistung` | Wert in ganzen Watt uebernehmen. |
+| `Schaltkontakt1` | `SchaltkontaktVariableID` | Boolean-Aktor uebernehmen und Aktion pruefen. |
+| nicht vorhanden | `SchaltkontaktInvertiert` | Nur bei umgekehrter Aktorlogik aktivieren. |
+| nicht vorhanden | `RueckmeldungVariableID` | Optional eine echte Boolean-Rueckmeldung zuordnen. |
+| `Mindesttlaufzeit` | `Mindestlaufzeit` | Alter Wert war in Minuten gedacht; fuer gleiches Verhalten mit 60 multiplizieren und als Sekunden eintragen. |
+| `Zeit_Zwischen_Zustandswechseln` | `Umschaltabstand` | Alte Minuten nicht uebernehmen. Neuen Sekundenwert bewusst festlegen; Standard ist 5 s. |
+| `Interval` | entfaellt | Keine zyklische Regelberechnung mehr. |
+| `IdleCounterMax` | entfaellt | Keine zyklusbasierte Idle-Erkennung mehr. |
+
+## Variablen und Verhalten
+
+| Enelix 1 | Enelix 2 |
+| --- | --- |
+| `DailyOnTime` | `Tageslaufzeit` in echten Sekunden |
+| `IstNacht` | entfaellt; Mindestlaufzeit wird am spaetestmoeglichen Start des lokalen Kalendertags erzwungen |
+| `IsTimerActive` | entfaellt; interne einmalige Timer |
+| `Aktuelle_Leistung` | gemeinsames `Istleistung` |
+| `Power` | gemeinsames `Sollleistung` |
+| `PowerSteps` | Vertragsfeld `Leistungswerte_W` |
+| `PV_Prio` | Property `PrioritaetPV` |
+| `Sperre_Prio` | Property `PrioritaetPeak` |
+| `Is_Peak_Shaving` | entfaellt; Betriebsart liegt im Manager |
+| `Leistung_Delta` | entfaellt; Leistungsverteilung liegt im Manager |
+| `Idle`, `IdleCounter` | entfallen |
+
+Die feste Enelix-1-Nachtzeit von 22:00 bis 07:00 wird nicht uebernommen.
+Enelix 2 plant nur den Zeitpunkt, ab dem die verbleibende Mindestlaufzeit vor
+dem lokalen Tagesende zwingend eingeschaltet werden muss.
+
+## Inbetriebnahme
+
+1. Bestehende Instanzkonfiguration und aktuelle Aktorlogik dokumentieren.
+2. Neue Instanz **Verbraucher 1-Stufig** anlegen.
+3. Leistung, Aktor, Invertierung und optional Rueckmeldung konfigurieren.
+4. Mindestlaufzeit von Minuten in Sekunden umrechnen.
+5. `Umschaltabstand` neu in Sekunden festlegen; nicht den alten Minutenwert
+   kopieren.
+6. Neue Instanz im Enelix-2-Manager aktiv zuordnen.
+7. Bei ausgeschalteter lokaler EMS-Freigabe Ein/Aus und Rueckmeldung
+   beaufsichtigt pruefen.
+8. Alte Instanz erst deaktivieren, danach `Aktiv` an der neuen Instanz
+   einschalten.
+9. Mindestens einen Timeout, einen verhinderten Lastwechsel und einen
+   Tageswechsel kontrollieren.
+
+## Rueckkehr
+
+Solange die alte Instanz nicht geloescht wurde, kann zurueckgekehrt werden,
+indem die neue Instanz im Manager deaktiviert und ausgeschaltet wird. Danach
+darf die alte Instanz wieder aktiviert werden. Beide Module duerfen nie
+gleichzeitig denselben Aktor steuern.