iobroker.smartloadmanager 0.1.2 → 0.2.0

package/admin/jsonConfig.json

@@ -98,7 +98,6 @@
                     "xl": 3,
                     "label": "enableForecast"
                 },
-
                 "forecastJsonDatapoint": {
                     "type": "objectId",
                     "newLine": true,
@@ -114,6 +113,97 @@
                     "type": "number",
                     "label": "forecastDefaultMinMinutes",
                     "tooltip": "tooltip_forecastDefaultMinMinutes",
+                    "default": 30,
+                    "min": 15,
+                    "max": 360,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "forecastPowerUnit": {
+                    "type": "select",
+                    "label": "forecastPowerUnit",
+                    "default": "auto",
+                    "options": [
+                        { "label": "forecastUnitAuto", "value": "auto" },
+                        { "label": "W", "value": "W" },
+                        { "label": "kW", "value": "kW" }
+                    ],
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "forecastSafetyPercent": {
+                    "type": "number",
+                    "label": "forecastSafetyPercent",
+                    "tooltip": "tooltip_forecastSafetyPercent",
+                    "default": 80,
+                    "min": 50,
+                    "max": 100,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "forecastMaxStartMinutes": {
+                    "type": "number",
+                    "label": "forecastMaxStartMinutes",
+                    "default": 30,
+                    "min": 0,
+                    "max": 180,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "forecastMinCurrentPercent": {
+                    "type": "number",
+                    "label": "forecastMinCurrentPercent",
+                    "tooltip": "tooltip_forecastMinCurrentPercent",
+                    "default": 50,
+                    "min": 0,
+                    "max": 100,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "forecastBridgeMinutes": {
+                    "type": "number",
+                    "label": "forecastBridgeMinutes",
+                    "default": 5,
+                    "min": 0,
+                    "max": 30,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "forecastMaxGridImport": {
+                    "type": "number",
+                    "label": "forecastMaxGridImport",
+                    "tooltip": "tooltip_forecastMaxGridImport",
+                    "default": 100,
+                    "min": 0,
+                    "max": 5000,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
+                "notifyForecast": {
+                    "type": "checkbox",
+                    "label": "notifyForecast",
+                    "default": false,
                     "xs": 12,
                     "sm": 12,
                     "md": 3,
@@ -135,7 +225,13 @@
                     "lg": 8,
                     "xl": 8,
                     "showSecondAddAt": 10,
-                    "useCardFor": ["xs", "sm", "md", "lg", "xl"],
+                    "useCardFor": [
+                        "xs",
+                        "sm",
+                        "md",
+                        "lg",
+                        "xl"
+                    ],
                     "compact": true,
                     "items": [
                         {
@@ -205,6 +301,19 @@
                                 "pl": "Ustawienia zarządzania akumulatorem:",
                                 "uk": "Параметри керування акумуляторами:",
                                 "zh-cn": "电池管理设置 :"
+                            },
+                            "text": {
+                                "en": "Battery management settings:",
+                                "de": "Einstellung Batteriemanagment:",
+                                "ru": "Настройки управления батареями:",
+                                "pt": "Configurações de gerenciamento de baterias:",
+                                "nl": "Instellingen voor batterijbeheer:",
+                                "fr": "Paramètres de gestion de la batterie :",
+                                "it": "Impostazioni di gestione della batteria:",
+                                "es": "Ajustes de gestión de baterías:",
+                                "pl": "Ustawienia zarządzania akumulatorem:",
+                                "uk": "Параметри керування акумуляторами:",
+                                "zh-cn": "电池管理设置 :"
                             }
                         },
                         {
@@ -293,6 +402,19 @@
                                 "pl": "Ustawienia prognozy PV",
                                 "uk": "Параметри прогнозу PV",
                                 "zh-cn": "PV 预测设置"
+                            },
+                            "text": {
+                                "en": "PV Forecast Settings",
+                                "de": "Einstellung PV-Forecast:",
+                                "ru": "Настройки PV прогноза",
+                                "pt": "Configuração da Previsão do PV",
+                                "nl": "PV-voorspellingsinstellingen",
+                                "fr": "Paramètres des prévisions PV",
+                                "it": "Impostazioni di previsione PV",
+                                "es": "Ajustes de predicción PV",
+                                "pl": "Ustawienia prognozy PV",
+                                "uk": "Параметри прогнозу PV",
+                                "zh-cn": "PV 预测设置"
                             }
                         },
                         {
@@ -329,10 +451,54 @@
                                 "uk": "Мінімальна тривалість прогнозу (хвилини)",
                                 "zh-cn": "预测最低时间(分钟)"
                             },
-                            "tooltip": "tooltip_forecastMinMinutes"
+                            "tooltip": "tooltip_forecastMinMinutes",
+                            "default": 30,
+                            "min": 15,
+                            "max": 360
+                        },
+                        {
+                            "type": "number",
+                            "attr": "minimumOnMinutes",
+                            "title": {
+                                "en": "Minimum run time (minutes)",
+                                "de": "Mindestlaufzeit (Minuten)",
+                                "ru": "Минимальное время работы (минуты)",
+                                "pt": "Tempo mínimo de funcionamento (minutos)",
+                                "nl": "Minimale looptijd (minuten)",
+                                "fr": "Durée minimale de fonctionnement (minutes)",
+                                "it": "Tempo minimo di funzionamento (minuti)",
+                                "es": "Tiempo mínimo de funcionamiento (minutos)",
+                                "pl": "Minimalny czas pracy (minuty)",
+                                "uk": "Мінімальний час роботи (хвилини)",
+                                "zh-cn": "最短运行时间（分钟）"
+                            },
+                            "default": 10,
+                            "min": 0,
+                            "max": 1440
+                        },
+                        {
+                            "type": "number",
+                            "attr": "minimumOffMinutes",
+                            "title": {
+                                "en": "Minimum off time (minutes)",
+                                "de": "Mindeststillstandszeit (Minuten)",
+                                "ru": "Минимальное время простоя (минуты)",
+                                "pt": "Tempo mínimo desligado (minutos)",
+                                "nl": "Minimale uitschakeltijd (minuten)",
+                                "fr": "Durée minimale d’arrêt (minutes)",
+                                "it": "Tempo minimo di spegnimento (minuti)",
+                                "es": "Tiempo mínimo de apagado (minutos)",
+                                "pl": "Minimalny czas wyłączenia (minuty)",
+                                "uk": "Мінімальний час вимкнення (хвилини)",
+                                "zh-cn": "最短停机时间（分钟）"
+                            },
+                            "default": 5,
+                            "min": 0,
+                            "max": 1440
                         },
                         {
                             "type": "staticText",
+                            "newLine": true,
                             "title": {
                                 "en": "Heating element setting:",
                                 "de": "Einstellung Heizelement:",
@@ -346,7 +512,19 @@
                                 "uk": "Налаштування нагрівальних елементів:",
                                 "zh-cn": "加热元素设置 :"
                             },
-                            "newLine": true
+                            "text": {
+                                "en": "Heating element setting:",
+                                "de": "Einstellung Heizelement:",
+                                "ru": "Настройка нагревательного элемента:",
+                                "pt": "Configuração do elemento de aquecimento:",
+                                "nl": "Verwarmingselementinstelling:",
+                                "fr": "Réglage des éléments de chauffage:",
+                                "it": "Regolazione degli elementi riscaldanti:",
+                                "es": "Ajuste del elemento de calefacción:",
+                                "pl": "Ustawienia elementów grzewczych:",
+                                "uk": "Налаштування нагрівальних елементів:",
+                                "zh-cn": "加热元素设置 :"
+                            }
                         },
                         {
                             "type": "objectId",
@@ -447,6 +625,7 @@
                         },
                         {
                             "type": "staticText",
+                            "newLine": true,
                             "title": {
                                 "en": "Consumer settings:",
                                 "de": "Verbrauchereinstellungen:",
@@ -460,7 +639,19 @@
                                 "uk": "Параметри споживача:",
                                 "zh-cn": "消费者环境:"
                             },
-                            "newLine": true
+                            "text": {
+                                "en": "Consumer settings:",
+                                "de": "Verbrauchereinstellungen:",
+                                "ru": "Потребительские настройки:",
+                                "pt": "Configurações do consumidor:",
+                                "nl": "Instellingen voor consumenten:",
+                                "fr": "Paramètres des consommateurs:",
+                                "it": "Impostazioni dei consumatori:",
+                                "es": "Ajustes del consumidor:",
+                                "pl": "Ustawienia konsumentów:",
+                                "uk": "Параметри споживача:",
+                                "zh-cn": "消费者环境:"
+                            }
                         },
                         {
                             "type": "number",

package/docs/de/README.md

@@ -0,0 +1,283 @@
+![Logo](../../admin/smartloadmanager.png)
+
+# ioBroker.smartloadmanager
+
+## Beispiele für Version 0.2.0
+
+Voraussetzung: Node.js ab 22.19.0. Der Adapter sendet Gerätebefehle mit
+`ack: false`; die Bestätigung (`ack: true`) übernimmt der zuständige Geräteadapter.
+Der Einspeisewert muss die Leistung am Netzanschlusspunkt in Watt darstellen.
+Bei negativem Vorzeichen für Einspeisung muss `feedinNegativ` aktiviert werden.
+Die Grundlast wird zusätzlich als Reserve abgezogen; bereits im Netzanschlusswert
+enthaltenen Hausverbrauch nicht nochmals als Grundlast eintragen.
+
+### Binärer Verbraucher und Heizung
+
+Beispiel: Steckdose mit `performance: 1000`, `switchOnPoint: 1200`,
+`switchOffPoint: 0`, `switchOnDelay: 20`, `switchOffDelay: 10`.
+Ab 1200 W Überschuss nach Grundlast startet die Einschaltverzögerung.
+Bei Netzbezug oder Unterschreiten der Abschaltgrenze startet die Abschaltung.
+`minimumOnMinutes: 10` und `minimumOffMinutes: 5` begrenzen häufiges Schalten;
+stärkerer Netzbezug als `forecastMaxGridImport` übergeht die Mindestlaufzeit.
+Mit `0` können Mindestzeiten explizit deaktiviert werden.
+
+`datapoint` schaltet boolean, `numericDatapoint` numerisch mit 0/1.
+Für Heizungen `ruletype: heating` wählen und Temperatur-, Freigabe- und
+Heartbeat-Datenpunkte konfigurieren. Das Erreichen von `maxTemperature` sowie
+fehlende Freigabe oder ein falscher Heartbeat verhindern das Einschalten.
+Ein gesetzter Heartbeat-Datenpunkt wird auf seinen Wahrheitswert geprüft;
+das ist keine Überwachung seines Alters.
+Fehlt ein konfigurierter Temperatursensor oder liefert er keinen endlichen
+Zahlenwert, wird eine Heizung nicht eingeschaltet bzw. automatisch abgeschaltet.
+„Ausschalten nur zu Ausschaltzeit“ unterdrückt absichtlich die normale
+Überschussabschaltung bis zum Zeitfensterende; Heizschutz bleibt wirksam.
+
+### Prozentregelung und Batterie
+
+Ein Prozentverbraucher mit 2000 W Maximalleistung und aktuell 50 % benötigt
+1000 W. Zeigt der Netzzähler zusätzlich 400 W Einspeisung, wird auf 70 % geregelt.
+Bei 200 W Netzbezug wird auf 40 % reduziert. Liegt die tragbare Leistung unter
+`minPercentStart`, wird auf 0 % geregelt. Deaktivierte Verbraucher werden nicht geregelt.
+Die Leistungsrechnung setzt voraus, dass der Verbraucher im Netzzähler enthalten ist.
+
+Für eine Batterie `batterySetpoint`, `performance`, optional `batterySOC` und
+`batteryTargetSOC` wählen. Bei 800 W verfügbarem Überschuss und maximal 1500 W
+Ladeleistung wird 800 W vorgegeben. Bei erreichtem Ziel-SOC wird die Ladeleistung 0.
+Der optionale globale Batterie-Modusdatenpunkt verwendet 0 (aus), 1 (Ziel erreicht)
+und 2 (laden); diese Werte müssen zum Geräteadapter passen.
+
+`controlMode` im Objektbaum: 0 = aus, 1 = manuell ein, 2 = automatisch.
+Manuell ein setzt Prozentverbraucher auf 100 % bzw. die Batterie auf ihre konfigurierte
+Leistung. Automatische Prozent- und Batterieregler überschreiben manuelle Modi nicht.
+Die Batterie berücksichtigt bereits angeforderte Ladeleistung und korrigiert sie
+um den gemessenen Netzüberschuss. `batteryDelaySeconds` und `delaySecondsProzent`
+gelten auch bei häufigen Zähleraktualisierungen; 0 bedeutet sofortige Regelung.
+Fehlt ein konfigurierter SOC-/Ziel-SOC-Wert, wird die Ladeleistung auf 0 gesetzt.
+Zeitfenster werden zusätzlich alle 15 Sekunden geprüft. Das Deaktivieren eines
+Verbrauchers beendet seine ausstehenden Schaltbefehle; es schaltet das Gerät nicht
+automatisch aus. Dafür `controlMode: 0` verwenden.
+
+### PV-Prognose mit ioBroker.pvforecast
+
+`enableForecast` aktivieren, `forecastJsonDatapoint` etwa auf
+`pvforecast.0.summary.JSONData` setzen und beim Verbraucher `useForecast` aktivieren.
+Beispiel für das erwartete Format (Zeitstempel sind Unix-Millisekunden):
+
+```js
+const now = Date.now();
+const forecast = [0, 15, 30, 45].map(minutes => ({
+    t: now + minutes * 60000,
+    y: 3.5,
+}));
+// JSON.stringify(forecast), mit forecastPowerUnit = "kW"
+```
+
+Bei 500 W Grundlast bleiben 3000 W prognostizierter Überschuss.
+Mit `forecastSafetyPercent: 80` stehen konservativ 2400 W zur Verfügung.
+Ein 2000-W-Verbraucher kann freigegeben werden, wenn das Zeitfenster mindestens
+`forecastMinMinutes: 30` lang ist, höchstens `forecastMaxStartMinutes: 30`
+Minuten entfernt liegt und bei `forecastMinCurrentPercent: 50` bereits mindestens
+1000 W realer Überschuss vorhanden sind. Prognosen ersetzen keinen gemessenen Überschuss.
+
+`forecastBridgeMinutes: 5` begrenzt das Überbrücken kurzer Einbrüche;
+`forecastMaxGridImport: 100` verhindert Überbrücken bei mehr als 100 W Netzbezug.
+Vergangene Datenpunkte werden verworfen. Bei kleinen W-Werten die Einheit explizit
+auf `W` setzen, da die automatische Erkennung Werte bis 100 als kW interpretiert.
+`forecast.*` und die Prognosestatuswerte des Verbrauchers zeigen die Entscheidung an.
+
+Zeitfenster können über Mitternacht gehen, z. B. 22:00–06:00.
+Gleiche Start- und Endzeit gelten als ganztägiges Fenster.
+
+Prüfumfang und externe Release-Abhängigkeiten: [Release-Prüfbericht](release-0.2.0-pruefung.md).
+
+## 🔧 Beschreibung
+
+Der Adapter **smartloadmanager** dient der dynamischen Steuerung von Verbrauchern anhand eines PV-Einspeisewertes. Ziel ist es, Überschuss-Strom lokal zu verbrauchen und so die Einspeisung ins öffentliche Netz zu minimieren oder vollständig zu vermeiden. Er unterstützt sowohl Ein/Aus-Verbraucher als auch prozentual regelbare Geräte und Batteriespeicher.
+
+---
+
+## 🚀 Funktionen
+
+- ✅ Überwachung eines konfigurierbaren Einspeisungs-Datenpunkts
+- ✅ Dynamische Zuschaltung von Verbrauchern bei Überschuss
+- ✅ Dynamische Abschaltung bei Defizit oder Netzbezug
+- ✅ Unterstützt **binary**, **percent**, **Heating** und **battery**-Verbraucher
+- ✅ Prozentregelung mit Verzögerung (sanftes Rückregeln), optional pro Verbraucher konfigurierbar
+- ✅ Dynamische Ladeleistung für Batteriespeicher mit Ziel-SOC
+- ✅ Zeitfenster für Ein-/Ausschaltlogik je Verbraucher (inkl. "nur zu Abschaltzeit")
+- ✅ Automatische Objekt-Erstellung mit erweiterten Informationen je Verbraucher
+- ✅ Steuerungsmodus: Off / Manual On / Auto für jeden Verbraucher separat
+- ✅ Hysterese-Steuerung durch separate Ein-/Abschaltgrenzen
+- ✅ Verbraucherspezifische Schaltverzögerung (Override der globalen)
+- ✅ Reihenfolgenlogik bei Zuschaltung (nach Leistung) und Abschaltung (umgekehrt)
+- ✅ Globale Batterie-Schaltverzögerung (`batteryDelaySeconds`)
+- ✅ Schreibprüfung für Batterie-Kontrollmodus (Debug-Ausgabe im Log)
+- ✅ **Verzögerte Schaltung über Timer** für Ein- und Ausschaltung
+- ✅ **Anzeige laufender Timer im Debug-Log** mit verbleibender Zeit
+- ✅ Optionale **Benachrichtigungen** für Ein/Aus, Prozentregelung und Batterie (Telegram / Gotify)
+- ✅ Optimierung für 0/1-Datenpunkte für Geräte mit boolean oder numerischer 0/1-Steuerung
+- ✅ Detailliertes Logging aller Timer, Überschüsse und Schaltvorgänge
+- ✅ Benachrichtigungen pro Verbrauchertyp (Binary, Percent, Battery, Heating), optional aktivierbar
+- ✅ Heizungs-/Heizstab-Steuerung mit Temperatur-, Freigabe- und Heartbeat-Prüfung
+
+---
+
+## ⚙️ Konfiguration
+
+### 🔹 Haupteinstellungen
+
+| Einstellung                     | Beschreibung                                                                           |
+| ------------------------------- | -------------------------------------------------------------------------------------- |
+| **Einspeisungs-Datenpunkt**     | Objekt-ID des Einspeisewerts (z. B. PV-Überschuss)                                     |
+| **Grundlast**                   | Wird immer vom Einspeisewert abgezogen (z. B. Standby-Verbrauch)                       |
+| **Einschaltgrenze**             | Schwelle in Watt, ab der Verbraucher zugeschaltet werden                               |
+| **Abschaltgrenze**              | Schwelle in Watt, ab der Verbraucher abgeschaltet werden                               |
+| **Verzögerung (Sekunden)**      | Verzögerung für binäre Abschaltungen (Hysterese-Glättung)                              |
+| **Verzögerung Prozent (Sek.)**  | Globale Verzögerung bei Rückregelung von Prozentverbrauchern (z. B. Wallbox)           |
+| **Verzögerung Batterie (Sek.)** | Globale Verzögerung für Batterie-Steuerung                                             |
+| **Einspeisewert negativ**       | Wenn aktiv: negativer Wert = Einspeisung / positiver Wert = Netzbezug                  |
+| **Batterie Kontrollmodus-DP**   | Optionaler Steuerdatenpunkt für Batterie-Modusumschaltung (Auto/Manual/Aus)            |
+| **Benachrichtigungen**          | Aktivierung für Binary / Prozent / Batterie / Heating, inkl. Telegram/Gotify-Instanzen |
+
+---
+
+### 🔹 Verbraucher
+
+| Feld                                   | Beschreibung                                                                    |
+| -------------------------------------- | ------------------------------------------------------------------------------- |
+| **Name**                               | Anzeigename                                                                     |
+| **Aktiv**                              | Aktiviert die Steuerung für diesen Verbraucher                                  |
+| **Regeltyp**                           | `"binary"`, `"percent"` oder `"battery"`                                        |
+| **Steuer-Datenpunkt**                  | ID zum Schalten oder Regeln, auch 0/1-DP unterstützt                            |
+| **Leistung [W]**                       | Realistische elektrische Leistung des Verbrauchers                              |
+| **Einschaltgrenze [W]**                | Benötigter Überschuss für Aktivierung                                           |
+| **Abschaltgrenze [W]**                 | Untergrenze für Deaktivierung                                                   |
+| **Maximalleistung [W]**                | Referenzwert zur Prozentregelung                                                |
+| **Verzögerung Prozent [s]**            | Optionale Verzögerung für Rückregelung nur dieses Verbrauchers                  |
+| **Verzögerung Override [s]**           | Verbraucherindividuelle Schaltverzögerung (z. B. sofortige Zuschaltung möglich) |
+| **Einschaltzeit (HH:MM)**              | Uhrzeit, ab wann Steuerung aktiv sein darf                                      |
+| **Ausschaltzeit (HH:MM)**              | Uhrzeit, ab wann Steuerung beendet wird                                         |
+| **Nur zu Ausschaltzeit ausschalten**   | Checkbox: Abschaltung nur zu konfigurierter Uhrzeit                             |
+| **batterySetpoint (nur battery)**      | Datenpunkt, in den die gewünschte Ladeleistung geschrieben wird                 |
+| **batterySOC / targetSOC**             | Optional: SOC & Ziel-SOC zur Ladeverhinderung bei vollem Akku                   |
+| **Timer / TimerEnd**                   | Interner Timer für verzögerte Schaltungen, Restzeit im Log sichtbar             |
+| **minTemperature / maxTemperature**    | Unter- und Obergrenze für Heating-Betrieb                                       |
+| **temperatureDatapoint (nur heating)** | Temperatur-Datenpunkt zur Prüfung min/max Grenzwerte                            |
+| **enableDatapoint (nur heating)**      | Optionaler Datenpunkt: nur bei true darf Heizstab laufen                        |
+| **heartbeatDatapoint (nur heating)**   | Optional: muss zyklisch true liefern, sonst wird abgeschaltet                   |
+
+---
+
+## 🔋 Batteriespeicher-Unterstützung
+
+- Verbraucher mit `"ruletype": "battery"` regeln den Lade-Setpoint abhängig vom aktuellen Überschuss.
+- Falls `batterySOC` und `batteryTargetSOC` gesetzt sind, wird ab Zielwert nicht mehr geladen.
+- Optional kann ein `batteryControlModeDatapoint` gesetzt werden:
+    - `0 = Aus`, `1 = Manuell`, `2 = Automatik`
+- Die Steuerung erfolgt **nur innerhalb der konfigurierten Zeitfenster**.
+- Die Steuerung wird bei jedem FeedIn-Update nach konfigurierter Verzögerung (`batteryDelaySeconds`) erneut ausgeführt.
+- Verzögerungen für alle Schaltungen (binary, percent, battery) können pro Verbraucher oder global angepasst werden.
+- Detailliertes Logging und optionale Benachrichtigungen für Batterie-Schaltungen.
+
+---
+
+## 🌡️ Heating-Unterstützung
+
+- Verbraucher mit "ruletype": "heating" sind für Heizstäbe oder vergleichbare Verbraucher vorgesehen.
+- Steuerung erfolgt nur, wenn: - Aktuelle Temperatur unter maxTemperature liegt - Optional: über minTemperature abgesichert - Optional: enableDatapoint aktiv ist - Optional: heartbeatDatapoint gültig ist
+- Bei Nichterfüllung wird Schaltung sofort abgebrochen und Timer gestoppt.
+- Unterstützt Ein-/Ausschalt-Timer (onTimerRemaining / offTimerRemaining) mit Restzeitanzeige.
+- Detailliertes Logging und optionale Benachrichtigungen für Heating-Verbraucher.
+
+---
+
+## 🧠 Steuerlogik
+
+1. **Datenpunkt-Messwert wird basierend auf Konfiguration interpretiert** (positiv = Netzbezug oder Einspeisung)
+2. **Überschuss > Grundlast + Einschaltgrenze**:  
+   → Verbraucher werden (binär) nach steigender Leistung zugeschaltet
+3. **Unterschuss < Grundlast - Abschaltgrenze**:  
+   → Verbraucher werden in umgekehrter Reihenfolge abgeschaltet
+4. **Regelung für Prozent-Verbraucher**:  
+   → % = Überschuss / Maximalleistung  
+   → Geregelt nach Verzögerung (global oder pro Verbraucher)  
+   → Optionale pro-Verbraucher Overrides möglich
+5. **Regelung für Batterie-Verbraucher**:  
+   → Ladeleistung = min(Überschuss, Maximalleistung), sofern Ziel-SOC nicht erreicht  
+   → Verzögerung über `batteryDelaySeconds` oder pro Verbraucher
+6. **Zeitfensterprüfung für alle Verbraucher**  
+   → Nur aktiv, wenn aktuelle Uhrzeit innerhalb `switchOnTime` bis `switchOffTime`
+7. **Steuerung erfolgt nur bei Steuerungsmodus „Auto (2)“**  
+   → Manuelle Eingriffe (Modus 1 oder 0) bleiben unangetastet
+8. **Verzögerte Schaltung über Timer**  
+   → Timer wird vor erneuter Schaltung abgebrochen, Restzeit kann im Log angezeigt werden
+9. **Benachrichtigungen optional für Ein/Aus, Prozent und Batterie**
+10. **Optimierung für 0/1-Datenpunkte**  
+    → Unterstützt boolean oder numerische 0/1-Steuerung automatisch
+11. **Detailliertes Logging aller Schaltvorgänge, Überschüsse und Timer**
+12. **Regelung für Heating-Verbraucher:**
+    → Schaltung nur innerhalb min/max Temperatur und bei gültigen enable-/heartbeat-States
+    → Timer werden abgebrochen, sobald Bedingungen nicht mehr erfüllt sind
+
+---
+
+## 💡 Beispiel: Wallbox
+
+| Parameter       | Wert    |
+| --------------- | ------- |
+| Einspeisung     | 1000 W  |
+| Grundlast       | 100 W   |
+| Maximalleistung | 11000 W |
+
+**Berechnung:**
+
+- Überschuss: 1000 - 100 = 900 W
+- Prozent: 900 / 11000 ≈ 8,2 % → Wallbox wird auf 8 % geregelt
+
+---
+
+## 📋 Objektstruktur
+
+Für jeden Verbraucher wird ein eigener Channel mit folgenden States erzeugt:
+
+- `.controlMode` → 0 = Aus, 1 = Manuell, 2 = Automatik
+- `.switchOnTime` / `.switchOffTime`
+- `.alwaysOffAtTime` → true/false
+- `.performance`, `.switchOnPoint`, `.switchOffPoint`
+- `.batterySetpoint` (nur für "battery")
+- `.temperatureDatapoint` (nur für "heating")
+- `.onTimerRemaining / .offTimerRemaining` → Restlaufzeit für Ein-/Ausschalt-Timer
+- `.timer` → interner Timer für verzögerte Schaltungen
+- `.timerEnd` → Zeitstempel, wann Timer abläuft (für Log)
+
+---
+
+## 🚫 Einschränkungen
+
+- Keine SOC-Historie, keine Langzeitlogik
+- Keine Mehrfachverwendung identischer Datenpunkte
+- Batterie-Steuerung basiert rein auf FeedIn, keine Rücksicht auf Entladeleistung
+- Heating ohne direkte Leistungsmessung – nur Grenzwerte und Freigabe-Checks
+
+---
+
+## 🛣️ Zukünftige Features
+
+- ~~PV-Prognosebasierte Steuerung (Beta)~~
+- Unterstützung kombinierter Verbraucher
+- ~~Priorisierungs-Profile~~
+- Überhitzungs- oder Fehler-Handling je Gerät
+- ~~Minimal- und Maximal-Prozentlimits für Regelung~~
+- Konfigurierbare Gruppen- oder Raumlogik
+
+---
+
+## PV-Prognosesteuerung
+
+SmartLoadManager kann `pvforecast.<Instanz>.summary.JSONData` verwenden. Dazu wird die Prognosesteuerung aktiviert, der JSON-Datenpunkt ausgewählt und die Funktion bei den gewünschten Verbrauchern eingeschaltet.
+
+Der Adapter bewertet ein zusammenhängendes Prognosefenster statt eines einzelnen Werts. Ein konfigurierbarer Sicherheitsfaktor reduziert optimistische Prognosen. Für prognosegestütztes Einschalten muss außerdem bereits ein Teil der benötigten Leistung als realer Überschuss vorhanden sein. Kurze Einbrüche dürfen zeitlich begrenzt überbrückt werden, jedoch nur bis zum eingestellten maximalen Netzbezug.
+
+Mindestlauf- und Mindeststillstandszeiten verhindern häufiges Schalten. Prognoseentscheidungen übersteuern niemals Zeitfenster, Temperaturgrenzen, Hardwarefreigabe, Heartbeat oder Batterie-SOC-Grenzen.
+
+Empfohlene Startwerte: 80 % Sicherheitsfaktor, 30 Minuten Prognosefenster, 30 Minuten maximale Vorlaufzeit, 50 % erforderlicher realer Überschuss, 5 Minuten Überbrückung, 100 W maximaler Netzbezug und 10/5 Minuten Mindestlauf-/Mindeststillstandszeit.

package/docs/de/release-0.2.0-pruefung.md

@@ -0,0 +1,74 @@
+# Arbeits- und Prüfplan für 0.2.0
+
+Alle vorgefundenen lokalen Änderungen werden gemäß Auftrag übernommen und geprüft.
+Die vorhandene Adapterarchitektur bleibt erhalten. Fehler werden mit reproduzierbaren
+Regressionstests korrigiert; eine reale Geräteprüfung ist mangels Testanlage nicht möglich.
+
+1. GitHub-Issues #90, #93, #86 und zugehörige Wartungs-PRs prüfen; aktuelle
+   npm-Versionen von Controller, Admin und Testwerkzeugen feststellen.
+2. Steuerungsfehler in `main.js` mit simulierten ioBroker-Zuständen reproduzieren:
+   Schaltbefehle, Prozentregelung, Batterie, Betriebsmodi, Heizschutz und Timer.
+3. Fehler korrigieren und Regressionstests ausführen; Prognoseeingaben und
+   Mindestlaufzeiten prüfen.
+4. Abhängigkeiten, Node-Testmatrix, Übersetzungen und Paketinhalt prüfen.
+5. README-Changelog und deutsche/englische Nutzerdokumentation mit Beispielen ergänzen.
+6. Versionen in Paketdateien synchron auf 0.2.0 setzen. Unit-, Paket-, Typ-,
+   Lint- und Integrationstests gegen aktuellen js-controller ausführen.
+7. Änderungen prüfen, committen und nach erfolgreichen Prüfungen pushen.
+
+Issue #84 betrifft das separate ioBroker-Stable-Repository. Ein Adapter-Push
+allein aktualisiert dessen Version nicht. Es wird nicht fälschlich als lokal
+behobener Programmfehler behandelt.
+
+## Ausgangslage
+
+- Node.js lokal: 22.19.0.
+- Ausgangstests: 6 Unit-Tests (davon ein Platzhalter), 40 Paketprüfungen bestanden.
+- Typprüfung und ESLint bestanden.
+- npm latest bei Prüfung: js-controller 7.2.5, Admin 8.3.3,
+  adapter-core 3.4.3, testing 6.3.1.
+- Keine reale ioBroker-Testinstanz und keine angeschlossenen Geräte vorhanden.
+
+## Behobene Fehler und Prüfung
+
+- Echte Regressionstests ersetzen den bisherigen Platzhalter. Geprüft werden
+  boolesche/numerische Befehle, Betriebsmodi, Prozentregelung, Vorzeichen,
+  Batterie-SOC, Ladeleistungsrückführung, Heizschutz und Timerabbrüche.
+- Verzögerte Einschaltungen prüfen den aktuellen Überschuss und das Zeitfenster
+  nochmals. Deaktivierung beendet laufende Schalt- und Anzeigetimer.
+- Gleichzeitige Zählerereignisse verschieben Regelungstimer nicht dauerhaft;
+  Batterie-Verzögerungen werden nicht durch einen sofortigen Regelpfad umgangen.
+- Prognosen verwerfen vergangene Werte und respektieren 0 Minuten Vorlaufzeit.
+- Eine periodische Prüfung berücksichtigt Zeitfenster auch ohne neue Zählerwerte.
+- Alle elf Übersetzungskataloge enthalten dieselben Schlüssel. Benachrichtigungen
+  und Release-Metadaten sind in allen unterstützten Sprachen vorhanden.
+- Offizielle aktuelle JSON-Schemas: 61 Paketprüfungen erfolgreich.
+- 29 Funktionstests erfolgreich unter Node 22.19.0, 24.22.1 und 26.12.1.
+- Konfigurierter Integrationstest gegen js-controller 7.2.5 erfolgreich:
+  Verbraucherobjekte erstellt, Schaltbefehl als `ack: false` empfangen.
+- Dieser Integrationstest besteht auch unter Node.js 26.12.1 (2 Tests).
+- Abschließende Typprüfung, ESLint und Kontrolle des npm-Paketinhalts erfolgreich;
+  Laufzeitmodul, Übersetzungen und Dokumentation enthalten, Testdateien ausgeschlossen.
+- Saubere Installation mit `npm ci` erfolgreich.
+- Repository-Checker 5.23.2 im lokalen Modus: keine Fehler. Verbleibende Hinweise
+  betreffen noch nicht veröffentlichtes 0.2.0, fehlendes Release-Tag, alte nicht
+  mehr abrufbare CI-Logs sowie noch offene GitHub-Vorgänge.
+
+## Bewusste Entscheidungen und externe Abhängigkeiten
+
+- TypeScript bleibt auf 6.0.3: Version 7 kollidiert mit den Peer-Anforderungen
+  des offiziellen ioBroker-ESLint-Setups. PR #79 wird daher nicht blind übernommen.
+- `alwaysOffAtTime` behält seine dokumentierte Bedeutung: normale Abschaltung
+  erst zum Zeitfensterende. Die Heizschutzprüfung bleibt davon unabhängig.
+- `npm audit` meldet nach kompatiblen Updates sechs transitive Meldungen:
+  drei moderate über `@iobroker/testing` → `@alcalzone/esbuild-register` → `esbuild`
+  und drei hohe über `@iobroker/adapter-core` → `@iobroker/js-controller-common-db`
+  → `node-forge`. Die Zählung umfasst die jeweils betroffenen Elternpakete.
+  Es gibt im verwendeten aktuellen Abhängigkeitsbaum kein kompatibles Update.
+  Der Adapter startet keinen esbuild-Entwicklungsserver und verarbeitet selbst
+  keine RSA-Signaturen. Es wird keine Sicherheitsfreiheit behauptet und kein
+  erzwungenes Downgrade der vom Repository-Checker geforderten Werkzeuge vorgenommen.
+- Issue #84 benötigt eine gesonderte Änderung im ioBroker-Stable-Repository
+  nach einer erfolgreichen Veröffentlichung und wird durch einen Git-Push allein
+  nicht erledigt.
+- Automatisierte Prüfungen ersetzen keine Inbetriebnahme mit realen Geräten.