iobroker.poolcontrol 0.5.5 → 0.6.1

package/README.md

@@ -19,7 +19,8 @@ Er ermöglicht die Automatisierung von Pumpen-, Temperatur- und Solarsteuerung s
 ## Funktionen
 
 - **Pumpensteuerung**
-  - Betriebsmodi: Automatik, Manuell, Zeitsteuerung, Aus
+  - Betriebsmodi: Automatik, Automatik (PV), Manuell, Zeitsteuerung, Aus
+  - Automatik (PV) steuert die Pumpe abhängig vom Photovoltaik-Überschuss
   - Fehlererkennung (kein Stromverbrauch, Leistung trotz „AUS“, Überlast)
   - Sicherheitsfunktionen (Frostschutz, Überhitzungsschutz)
 
@@ -34,12 +35,24 @@ Er ermöglicht die Automatisierung von Pumpen-, Temperatur- und Solarsteuerung s
   - Kollektor-Warnung (mit automatischer Rücksetzung bei 10 % unter der Schwelle)
   - Optionale Sprachausgabe bei Warnung
 
+- **Photovoltaiksteuerung (ab v0.6.0)
+  - Automatische Pumpensteuerung auf Basis von PV-Erzeugung und Hausverbrauchs
+  - Einschaltlogik: Überschuss ≥ (Pumpen-Nennleistung + Sicherheitsaufschlag)
+  - Optionaler Nachlauf bei Wolkenphasen
+  - Ignorieren bei erreichter Tagesumwälzung
+  - Konfiguration über zwei Fremd-Objekt-IDs (power_generated_id, power_house_id)
+  - Neuer Pumpenmodus „Automatik (PV)
+
 - **Zeitsteuerung**
   - Bis zu 3 frei konfigurierbare Zeitfenster pro Woche
 
 - **Laufzeit & Umwälzung**
   - Zählt Laufzeiten (heute, gesamt)
   - Berechnet tägliche Umwälzung und Restmenge
+  - Rückspülerinnerung mit konfigurierbarem Intervall (z. B. alle 7 Tage)
+  - Anzeige der letzten Rückspülung inkl. Datum
+  - Automatische Rücksetzung nach erfolgter Rückspülung
+  - PV-Modus berücksichtigt Umwälzstatus (z. B. „Ignoriere bei Umwälzung erreicht“)
 
 - **Verbrauch & Kosten**
   - Auswertung eines externen kWh-Zählers
@@ -49,16 +62,19 @@ Er ermöglicht die Automatisierung von Pumpen-, Temperatur- und Solarsteuerung s
   **Hinweis:**  
   Details zum Verhalten der Verbrauchs- und Kostenwerte (z. B. bei Neustarts oder beim Wechsel des Stromzählers) finden Sie in der Datei [help.md](./help.md).
 
+- **Statistiksystem**
+  - Bereich `analytics.statistics.*` mit Tages-, Wochen- und Monatswerten
+  - Automatische Berechnung von Min-, Max-, Durchschnitts- und Laufzeitwerten
+  - Vollständig persistente Datenpunkte (Überinstallationsschutz)
+  - HTML- und JSON-Zusammenfassungen pro Sensor und Gesamtübersicht
+
 - **Sprachausgaben**
   - Ausgabe über Alexa oder Telegram
   - Ansagen bei Pumpenstart/-stopp, Fehlern oder Temperaturschwellen
 
 - **SystemCheck (Diagnosebereich)**
-  Ab Version **0.2.0** enthält der Adapter einen neuen Diagnosebereich **SystemCheck**.  
-  Er bietet interne Debug-Logs, mit denen bestimmte Teilbereiche (z. B. Pumpen-, Solar- oder Temperatursteuerung) gezielt überwacht werden können.
-
-  *Funktionen:*
-  - Auswahl des zu überwachenden Bereichs
+  - Interner Diagnosebereich für Debug- und Überwachungsfunktionen
+  - Auswahl des zu überwachenden Bereichs (z. B. Pumpe, Solar, Temperatur)
   - Fortlaufendes Log der letzten Änderungen
   - Manuelles Löschen des Logs möglich
 
@@ -90,26 +106,24 @@ Die Konfiguration erfolgt über Tabs im Admin-Interface:
 
 ## Geplante Erweiterungen
 
-- Rückspülerinnerung (Intervall in Tagen, Erinnerung über State)  
-- Wartung Kesseldruck (maximaler Druck, Warnung bei Überschreitung)  
-- Weitere Komfortfunktionen nach Praxistests  
-- Kesseldruck-Wartung / Drucksensor-Warnung
-- PV-Überschuss-Steuerung (für z.B. Pumpe oder Wärmepumpe)
-- Zweite Pumpe (z.B. Wärmetauscher)
-- Statistikbereich 
-- Eigene Widgets für VIS/VIS2
-- Erweiterung Wärmepumpen-/Heizlogik
-- Steuerung von Poolbeleuchtung
-- Steuerung von Poolrobotern
-- Steuerung von elektrischen Ventilen 
-- Steuerung von Gegenstromanlagen
+- Erweiterte PV- und Solar-Effizienzanalyse (COP-Berechnung, Tagesnutzen, Wetterintegration)
+- Statistik-Exportfunktion (CSV/Excel)
+- Diagnostic-Helper zur automatischen Systemprüfung
+- Erweiterung der Heizungs-/Wärmepumpenlogik (`heatHelper`)
+- Drucksensor-Integration zur Kesseldruck-Überwachung
+- Zweite Pumpe (z. B. Wärmetauscher oder Wärmepumpe)
+- Eigene Widgets für VIS/VIS2 (grafische Pool- und Solarvisualisierung)
+- Steuerung von Poolbeleuchtung, Ventilen und Gegenstromanlagen
+- Integration zusätzlicher Sensorboxen (z. B. TempBox, PressureBox, LevelBox)
+- KI- und Sprach-Assistenten-Erweiterung (Pool-Tagesbericht, Tipps, Sprachbefehle)
+
 
 ---
 
 ## Hinweis
 
-Der Adapter befindet sich aktuell in der Entwicklung.  
-Funktionen können sich ändern – bitte regelmäßig den Changelog beachten.
+Der Adapter befindet sich in aktiver Weiterentwicklung.
+Neue Funktionen werden regelmäßig ergänzt – bitte den Changelog beachten.
 
 ---
 
@@ -121,6 +135,15 @@ Funktionen können sich ändern – bitte regelmäßig den Changelog beachten.
 ## Changelog
 ### **WORK IN PROGRESS**
 
+## v0.6.0 (2025-11-03)
+- Einführung der vollständigen Photovoltaik-Steuerung mit automatischer Pumpenlogik  
+  (neuer Pumpenmodus `Automatik (PV)` unter `pump.mode`)
+- Adapter reagiert auf PV-Überschuss basierend auf konfigurierbarer Hausverbrauchs- und Erzeugungsleistung
+- Einschaltlogik: Pumpe EIN bei Überschuss ≥ (Nennleistung + Schwellwert)
+- Berücksichtigung von Saisonstatus, Nachlaufzeit und optionalem „Umwälzung erreicht“-Schutz
+- Automatische Migration ergänzt neuen Modus `auto_pv` in bestehenden Installationen
+- Verbesserte interne Logik, Persistenz und Debug-Protokollierung
+
 ## v0.5.5 (2025-11-01)
 - Endlosschleife in Statistik Woche und Monat behoben
 

package/admin/jsonConfig.json

@@ -862,7 +862,6 @@
         "speech_telegram_users": {
           "type": "text",
           "label": "Telegram-Empfänger (Benutzernamen, Komma-getrennt / leer = an alle Benutzer)",
-          "attr": "speech_telegram_users",
           "tooltip": "Beispiel: Dirk,Dennis (leer = an alle Benutzer senden)",
           "default": "",
           "xs": 12,
@@ -947,7 +946,7 @@
 	},
 	"consumption": {
 	  "type": "panel",
-	  "label": "Verbrauch & Kosten",
+	  "label": "PV, Verbrauch & Kosten",
 	  "items": {
 		"divider_cons1": {
 		  "type": "divider",
@@ -1003,7 +1002,59 @@
           "md": 12,
           "lg": 12,
           "xl": 12
-		}
+		},
+
+        "divider_pv1": {
+          "type": "divider",
+          "newLine": true
+        },
+        "pv_header": {
+          "type": "header",
+          "text": "Photovoltaik (Überschusserkennung)",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
+        "power_generated_id": {
+          "type": "objectId",
+          "label": "Objekt-ID PV-Erzeugungsleistung (W)",
+          "default": "",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6,
+          "tooltip": "Datenpunkt mit aktueller PV-Leistung (Watt)"
+        },
+        "power_house_id": {
+          "type": "objectId",
+          "label": "Objekt-ID Hausverbrauch (W)",
+          "default": "",
+          "xs": 12,
+          "sm": 6,
+          "md": 6,
+          "lg": 6,
+          "xl": 6,
+          "tooltip": "Datenpunkt mit aktuellem Hausverbrauch (Watt)"
+        },
+        "threshold_w": {
+          "type": "number",
+          "label": "Schwellwert für PV-Überschuss (W)",
+          "default": 200,
+          "min": 0,
+          "max": 2000,
+          "step": 50,
+          "xs": 12,
+          "sm": 3,
+          "md": 3,
+          "lg": 3,
+          "xl": 3,
+          "tooltip": "Ab welcher Differenz zwischen PV und Hausverbrauch ein Überschuss gilt"
+        }
 	  }
     },	
 	"help": {

package/io-package.json

@@ -1,8 +1,33 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.5.5",
+    "version": "0.6.1",
     "news": {
+       "0.6.1": {
+         "en": "Fixed false monthly reset when no last_reset date existed. Corrected real last_update timestamp in monthly statistics.",
+         "de": "Fehlerhaften Monatsreset ohne gültiges last_reset-Datum behoben. Korrigierter echter Zeitstempel last_update in der Monatsstatistik.",
+         "ru": "Исправлен неверный ежемесячный сброс без действительной даты last_reset. Исправлено обновление времени last_update в ежемесячной статистике.",
+         "pt": "Corrigido o reset mensal incorreto quando não havia data last_reset. Corrigido o timestamp real de last_update na estatística mensal.",
+         "nl": "Onjuiste maandelijkse reset opgelost wanneer er geen last_reset-datum was. Gecorrigeerde echte last_update-tijd in maandelijkse statistieken.",
+         "fr": "Correction du réinitialisation mensuelle erronée lorsqu'aucune date last_reset n'existait. Horodatage last_update réel corrigé dans les statistiques mensuelles.",
+         "it": "Corretto il reset mensile errato quando non esisteva una data last_reset. Corretto il timestamp reale last_update nelle statistiche mensili.",
+         "es": "Corregido el restablecimiento mensual erróneo cuando no existía una fecha last_reset. Corregida la marca de tiempo real last_update en las estadísticas mensuales.",
+         "pl": "Naprawiono błędny miesięczny reset, gdy nie istniała data last_reset. Poprawiono rzeczywisty znacznik czasu last_update w miesięcznych statystykach.",
+         "zh-cn": "修复了在不存在 last_reset 日期时错误的月度重置。修正了月度统计中的真实 last_update 时间戳。"
+       },
+       "0.6.0": {
+         "en": "Added complete photovoltaic control with automatic pump management (mode 'Automatik (PV)'). The adapter can now react to PV surplus based on configurable house consumption and generation values. Includes migration for existing installations. Improved system consistency and internal logging.",
+         "de": "Vollständige Photovoltaik-Steuerung mit automatischer Pumpenlogik (Modus 'Automatik (PV)') hinzugefügt. Der Adapter reagiert nun auf PV-Überschuss anhand konfigurierbarer Hausverbrauchs- und Erzeugungswerte. Migration für bestehende Installationen integriert. Systemkonsistenz und interne Protokollierung verbessert.",
+         "ru": "Добавлено полное управление фотоэлектрической системой с автоматическим управлением насосом (режим 'Automatik (PV)'). Адаптер теперь реагирует на избыток PV на основе настраиваемых значений потребления и генерации. Включена миграция для существующих установок. Улучшена системная согласованность и внутреннее ведение журнала.",
+         "pt": "Adicionado controle fotovoltaico completo com gerenciamento automático da bomba (modo 'Automatik (PV)'). O adaptador agora reage ao excedente de PV com base nos valores configuráveis de consumo e geração da casa. Inclui migração para instalações existentes. Consistência do sistema e registro interno aprimorados.",
+         "nl": "Volledige fotovoltaïsche besturing toegevoegd met automatische pompbesturing (modus 'Automatik (PV)'). De adapter reageert nu op PV-overschot op basis van configureerbare huisverbruik- en opwekkingswaarden. Migratie voor bestaande installaties inbegrepen. Verbeterde systeemconsistentie en interne logboekregistratie.",
+         "fr": "Ajout du contrôle photovoltaïque complet avec gestion automatique de la pompe (mode 'Automatik (PV)'). L'adaptateur réagit désormais au surplus photovoltaïque en fonction des valeurs configurables de consommation et de production domestiques. Migration incluse pour les installations existantes. Cohérence du système et journalisation interne améliorées.",
+         "it": "Aggiunto controllo fotovoltaico completo con gestione automatica della pompa (modalità 'Automatik (PV)'). L'adattatore ora reagisce al surplus fotovoltaico in base ai valori configurabili di consumo e generazione domestici. Migrazione inclusa per le installazioni esistenti. Migliorata la coerenza del sistema e la registrazione interna.",
+         "es": "Se añadió control fotovoltaico completo con gestión automática de la bomba (modo 'Automatik (PV)'). El adaptador ahora reacciona al excedente fotovoltaico según los valores configurables de consumo y generación de la casa. Incluye migración para instalaciones existentes. Mejorada la coherencia del sistema y el registro interno.",
+         "pl": "Dodano pełną kontrolę fotowoltaiczną z automatycznym zarządzaniem pompą (tryb 'Automatik (PV)'). Adapter reaguje teraz na nadwyżkę PV w oparciu o konfigurowalne wartości zużycia i produkcji energii. Zawiera migrację dla istniejących instalacji. Poprawiono spójność systemu i wewnętrzne logowanie.",
+         "uk": "Додано повний фотогальванічний контроль з автоматичним керуванням насосом (режим 'Automatik (PV)'). Адаптер тепер реагує на надлишок PV на основі налаштовуваних значень споживання та генерації. Включено міграцію для існуючих установок. Покращено системну узгодженість і внутрішнє журналювання.",
+         "zh-cn": "新增完整的光伏控制与自动泵管理（模式“Automatik (PV)”）。适配器现在可根据可配置的家庭耗电与发电数值响应光伏盈余。包含对现有安装的迁移。改进了系统一致性和内部日志记录。"
+       },
        "0.5.5": {
          "en": "Fixed remaining timer recursion issue in weekly and monthly statistics to fully prevent infinite reset loops. Cleaned up jsonConfig structure and improved timer handling.",
          "de": "Verbleibende Timer-Rekursion in Wochen- und Monatsstatistik behoben, um Endlosschleifen beim Reset endgültig zu verhindern. jsonConfig-Struktur bereinigt und Timer-Handling verbessert.",
@@ -66,32 +91,7 @@
          "pl": "Rozszerzone statystyki tygodniowe i miesięczne z trwałymi danymi, ujednoliconym formatem JSON i ochroną przed ponowną instalacją.",
          "uk": "Розширена тижнева та місячна статистика з постійними даними, уніфікованим форматом JSON і захистом під час перевстановлення.",
          "zh-cn": "扩展的周和月统计，具有持久数据、统一的 JSON 格式和重新安装保护。"
-       },
-      "0.5.0": {
-        "en": "Added weekly and monthly temperature statistics under analytics.statistics.temperature.week and analytics.statistics.temperature.month with automatic summaries, independent helpers and persistent data points.",
-        "de": "Wöchentliche und monatliche Temperaturstatistiken unter analytics.statistics.temperature.week und analytics.statistics.temperature.month hinzugefügt – mit automatischen Zusammenfassungen, unabhängigen Helpern und persistenten Datenpunkten.",
-        "ru": "Добавлена еженедельная и ежемесячная статистика температуры в analytics.statistics.temperature.week и analytics.statistics.temperature.month с автоматическими сводками, независимыми помощниками и постоянными точками данных.",
-        "fr": "Ajout des statistiques de température hebdomadaires et mensuelles sous analytics.statistics.temperature.week et analytics.statistics.temperature.month avec résumés automatiques, helpers indépendants et points de données persistants.",
-        "it": "Aggiunte statistiche settimanali e mensili della temperatura in analytics.statistics.temperature.week e analytics.statistics.temperature.month con riepiloghi automatici, helper indipendenti e punti dati persistenti.",
-        "es": "Se añadieron estadísticas semanales y mensuales de temperatura en analytics.statistics.temperature.week y analytics.statistics.temperature.month con resúmenes automáticos, ayudantes independientes y puntos de datos persistentes.",
-        "nl": "Wekelijkse en maandelijkse temperatuurstatistieken toegevoegd onder analytics.statistics.temperature.week en analytics.statistics.temperature.month met automatische samenvattingen, onafhankelijke helpers en persistente gegevenspunten.",
-        "pl": "Dodano tygodniowe i miesięczne statystyki temperatury w analytics.statistics.temperature.week i analytics.statistics.temperature.month z automatycznymi podsumowaniami, niezależnymi pomocnikami i trwałymi punktami danych.",
-        "uk": "Додано щотижневу та щомісячну статистику температури в analytics.statistics.temperature.week та analytics.statistics.temperature.month з автоматичними зведеннями, незалежними помічниками та постійними точками даних.",
-        "zh-cn": "在 analytics.statistics.temperature.week 和 analytics.statistics.temperature.month 中添加了每周和每月温度统计，具有自动摘要、独立助手和持久数据点。"
-      },
-      "0.4.0": {
-        "en": "Added daily temperature statistics under analytics.statistics.temperature.today with automatic min/max/average tracking, JSON and HTML summaries, and midnight reset logic.",
-        "de": "Tägliche Temperaturstatistik unter analytics.statistics.temperature.today hinzugefügt mit automatischer Erfassung von Min-/Max-/Durchschnittswerten, JSON- und HTML-Zusammenfassungen sowie Mitternachts-Reset.",
-        "ru": "Добавлена ежедневная статистика температуры в analytics.statistics.temperature.today с автоматическим отслеживанием мин./макс./средних значений, JSON и HTML сводками и логикой сброса в полночь.",
-        "pt": "Adicionadas estatísticas diárias de temperatura em analytics.statistics.temperature.today com rastreamento automático de mínimo/máximo/média, resumos em JSON e HTML e redefinição automática à meia-noite.",
-        "nl": "Dagelijkse temperatuurstatistieken toegevoegd onder analytics.statistics.temperature.today met automatische min/max/gemiddelde tracking, JSON- en HTML-samenvattingen en middernachtreset.",
-        "fr": "Ajout de statistiques quotidiennes de température sous analytics.statistics.temperature.today avec suivi automatique min/max/moyenne, résumés JSON et HTML et réinitialisation automatique à minuit.",
-        "it": "Aggiunte statistiche giornaliere della temperatura in analytics.statistics.temperature.today con monitoraggio automatico di min/max/media, riepiloghi JSON e HTML e reset automatico a mezzanotte.",
-        "es": "Se añadieron estadísticas diarias de temperatura en analytics.statistics.temperature.today con seguimiento automático de mínimos/máximos/promedios, resúmenes en JSON y HTML y reinicio automático a medianoche.",
-        "pl": "Dodano dzienne statystyki temperatury w analytics.statistics.temperature.today z automatycznym śledzeniem wartości min/max/średnich, podsumowaniami JSON i HTML oraz resetem o północy.",
-        "uk": "Додано щоденну статистику температури в analytics.statistics.temperature.today з автоматичним відстеженням мін/макс/середніх значень, JSON і HTML зведеннями та скиданням опівночі.",
-        "zh-cn": "在 analytics.statistics.temperature.today 中添加了每日温度统计，具有自动最小/最大/平均跟踪、JSON 和 HTML 摘要以及午夜重置功能。"
-      }
+       }
 	},
     "titleLang": {
       "en": "PoolControl",

package/lib/helpers/migrationHelper.js

@@ -9,7 +9,7 @@
  * - Wird beim Adapterstart einmalig ausgeführt.
  * - Korrigiert veraltete Definitionen (z. B. Schreibrechte, persist-Flags, etc.)
  *
- * Version: 1.0.1
+ * Version: 1.0.3
  */
 
 const migrationHelper = {
@@ -31,10 +31,8 @@ const migrationHelper = {
             // ------------------------------------------------------
             await this._fixSpeechQueue();
             await this._fixSolarWarnActivePersist();
-
-            // Weitere Routinen folgen hier später:
-            // await this._ensurePumpReason();
-            // await this._cleanupOldStates();
+            await this._fixPumpModeStates(); // NEU: PV-Automatik hinzufügen
+            await this._removeInvalidResetButtons(); // NEU: Entfernt Week/Month-Reset-Buttons
 
             this.adapter.log.debug('[migrationHelper] Migration-Checks abgeschlossen.');
         } catch (err) {
@@ -47,17 +45,11 @@ const migrationHelper = {
     // ------------------------------------------------------
     // Migration: Schreibrecht für speech.queue korrigieren
     // ------------------------------------------------------
-
-    /**
-     * Prüft und korrigiert den State "speech.queue", falls er noch write:false gesetzt hat.
-     * Dadurch verschwinden Warnungen beim Schreiben (Read-only state ... written without ack).
-     */
     async _fixSpeechQueue() {
         const id = 'speech.queue';
         try {
             const obj = await this.adapter.getObjectAsync(id);
             if (!obj) {
-                this.adapter.log.debug(`[migrationHelper] ${id} existiert nicht – keine Anpassung nötig.`);
                 return;
             }
 
@@ -70,8 +62,6 @@ const migrationHelper = {
                         desc: 'Nur intern durch den Adapter beschreibbar (nicht manuell ändern!)',
                     },
                 });
-            } else {
-                this.adapter.log.debug(`[migrationHelper] ${id} ist bereits korrekt konfiguriert.`);
             }
         } catch (err) {
             this.adapter.log.warn(`[migrationHelper] Fehler bei Prüfung von ${id}: ${err.message}`);
@@ -81,18 +71,11 @@ const migrationHelper = {
     // ------------------------------------------------------
     // Migration: persist-Flag für solar.warn_active ergänzen
     // ------------------------------------------------------
-
-    /**
-     * Ergänzt persist:true bei solar.warn_active,
-     * damit die Einstellung (Warnfunktion aktivieren/deaktivieren)
-     * nach einem Neustart erhalten bleibt.
-     */
     async _fixSolarWarnActivePersist() {
         const id = 'solar.warn_active';
         try {
             const obj = await this.adapter.getObjectAsync(id);
             if (!obj) {
-                this.adapter.log.debug(`[migrationHelper] ${id} existiert nicht – keine Anpassung nötig.`);
                 return;
             }
 
@@ -105,13 +88,74 @@ const migrationHelper = {
                         desc: `${obj.common?.desc || ''} (automatisch per Migration persistiert)`,
                     },
                 });
-            } else {
-                this.adapter.log.debug(`[migrationHelper] ${id} ist bereits mit persist:true versehen.`);
             }
         } catch (err) {
             this.adapter.log.warn(`[migrationHelper] Fehler bei Prüfung von ${id}: ${err.message}`);
         }
     },
+
+    // ------------------------------------------------------
+    // Migration: Ergänze neuen Pumpenmodus "Automatik (PV)"
+    // ------------------------------------------------------
+    async _fixPumpModeStates() {
+        const id = 'pump.mode';
+        try {
+            const obj = await this.adapter.getObjectAsync(id);
+            if (!obj) {
+                return;
+            }
+
+            const states = obj.common?.states || {};
+            if (!states.auto_pv) {
+                states.auto_pv = 'Automatik (PV)';
+                this.adapter.log.info(`[migrationHelper] Ergänze neuen Modus "Automatik (PV)" in pump.mode`);
+                await this.adapter.extendObjectAsync(id, { common: { states } });
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[migrationHelper] Fehler bei Prüfung von ${id}: ${err.message}`);
+        }
+    },
+
+    // FIX: Entferne versehentlich angelegte Reset-Buttons aus Wochen- und Monatsstatistik
+    async _removeInvalidResetButtons() {
+        try {
+            const allObjs = await this.adapter.getAdapterObjectsAsync();
+            const keys = Object.keys(allObjs);
+            let removed = 0;
+
+            for (const id of keys) {
+                if (
+                    (id.startsWith('analytics.statistics.temperature.week.') ||
+                        id.startsWith('analytics.statistics.temperature.month.')) &&
+                    id.endsWith('.reset_today')
+                ) {
+                    try {
+                        // Erst Statewert entfernen
+                        await this.adapter.delStateAsync(id);
+                    } catch {
+                        this.adapter.log.debug(`[migrationHelper] Kein Statewert für ${id} vorhanden (Überspringe).`);
+                    }
+
+                    // Danach Objekt löschen (auch wenn persist=true)
+                    try {
+                        await this.adapter.delObjectAsync(id, { recursive: false });
+                        this.adapter.log.info(`[migrationHelper] Veralteter Reset-Button entfernt: ${id}`);
+                        removed++;
+                    } catch (err) {
+                        this.adapter.log.warn(`[migrationHelper] Konnte ${id} nicht löschen: ${err.message}`);
+                    }
+                }
+            }
+
+            if (removed === 0) {
+                this.adapter.log.debug('[migrationHelper] Keine alten Reset-Buttons gefunden.');
+            } else {
+                this.adapter.log.info(`[migrationHelper] Insgesamt ${removed} alte Reset-Buttons entfernt.`);
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[migrationHelper] Fehler beim Entfernen alter Reset-Buttons: ${err.message}`);
+        }
+    },
 };
 
 module.exports = migrationHelper;

package/lib/helpers/photovoltaicHelper.js

@@ -0,0 +1,305 @@
+'use strict';
+
+/**
+ * photovoltaicHelper
+ * -------------------------------------------------------------
+ * - Liest PV-Erzeugung und Hausverbrauch (Foreign States aus Admin-Config)
+ * - Berechnet Überschussleistung und setzt Photovoltaik-States
+ * - Schaltet die Pumpe nur im Modus 'auto_pv' über pump.pump_switch
+ * - Respektiert Saison, Nachlaufzeit (Entprellung) und optionales "Umwälzung erreicht"
+ * - Einschaltlogik: Überschuss >= (pump_max_watt + threshold_w)
+ * -------------------------------------------------------------
+ */
+
+const photovoltaicHelper = {
+    adapter: null,
+    genId: null,
+    houseId: null,
+    afterrunTimer: null,
+    _pvPumpHoldUntil: 0,
+    _desiredPump: null,
+    _lastCalc: 0,
+
+    init(adapter) {
+        this.adapter = adapter;
+
+        this.genId = adapter.config?.power_generated_id || '';
+        this.houseId = adapter.config?.power_house_id || '';
+
+        if (!this.genId || !this.houseId) {
+            this.adapter.log.info(
+                '[photovoltaicHelper] PV-IDs in der Instanz-Konfiguration fehlen. Überschusserkennung bleibt passiv.',
+            );
+        } else {
+            try {
+                this.adapter.subscribeForeignStates(this.genId);
+                this.adapter.subscribeForeignStates(this.houseId);
+                this.adapter.log.info(`[photovoltaicHelper] Subscribed: PV="${this.genId}", Haus="${this.houseId}"`);
+            } catch (err) {
+                this.adapter.log.warn(`[photovoltaicHelper] Konnte Foreign-States nicht abonnieren: ${err.message}`);
+            }
+        }
+
+        this.adapter.subscribeStates('photovoltaic.afterrun_min');
+        this.adapter.subscribeStates('photovoltaic.ignore_on_circulation');
+        this.adapter.subscribeStates('status.season_active');
+        this.adapter.subscribeStates('pump.mode');
+
+        this._safeRecalc('init');
+        this.adapter.log.info('[photovoltaicHelper] Initialisierung abgeschlossen.');
+    },
+
+    async handleStateChange(id, state) {
+        if (!state) {
+            return;
+        }
+        try {
+            if (this.genId && id === this.genId) {
+                await this._updateNumberState('photovoltaic.power_generated_w', Number(state.val) || 0);
+                await this._safeRecalc('foreign:pv');
+                return;
+            }
+            if (this.houseId && id === this.houseId) {
+                await this._updateNumberState('photovoltaic.power_house_w', Number(state.val) || 0);
+                await this._safeRecalc('foreign:house');
+                return;
+            }
+
+            if (id.endsWith('photovoltaic.afterrun_min')) {
+                this.adapter.log.debug(`[photovoltaicHelper] Nachlaufzeit geändert auf ${Number(state.val) || 0} min`);
+                return;
+            }
+            if (id.endsWith('photovoltaic.ignore_on_circulation')) {
+                this.adapter.log.debug(
+                    `[photovoltaicHelper] Flag "PV ignorieren bei Umwälzung erreicht" = ${!!state.val}`,
+                );
+                return;
+            }
+
+            if (id.endsWith('status.season_active') || id.endsWith('pump.mode')) {
+                await this._safeRecalc('mode/season');
+                return;
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Fehler in handleStateChange: ${err.message}`);
+        }
+    },
+
+    async _recalc(_sourceTag = '') {
+        const now = Date.now();
+        if (now - this._lastCalc < 250) {
+            return;
+        }
+        this._lastCalc = now;
+
+        const seasonActive = !!(await this.adapter.getStateAsync('status.season_active'))?.val;
+        const pumpMode = (await this.adapter.getStateAsync('pump.mode'))?.val || 'auto';
+
+        const gen = Number((await this.adapter.getStateAsync('photovoltaic.power_generated_w'))?.val ?? 0) || 0;
+        const house = Number((await this.adapter.getStateAsync('photovoltaic.power_house_w'))?.val ?? 0) || 0;
+
+        // Schwelle & Pumpenleistung
+        const thresholdState = Number((await this.adapter.getStateAsync('photovoltaic.threshold_w'))?.val ?? NaN);
+        const threshold = Number.isFinite(thresholdState)
+            ? thresholdState
+            : Number(this.adapter.config?.threshold_w || 200);
+
+        const pumpMax = Number((await this.adapter.getStateAsync('pump.pump_max_watt'))?.val ?? 0);
+
+        const afterrunMin = Math.max(
+            0,
+            Number((await this.adapter.getStateAsync('photovoltaic.afterrun_min'))?.val ?? 0) || 0,
+        );
+        const ignoreOnCirc = !!((await this.adapter.getStateAsync('photovoltaic.ignore_on_circulation'))?.val ?? false);
+
+        // SAFETY: Solarüberhitzungsschutz
+        try {
+            const collectorWarning = !!(await this.adapter.getStateAsync('solar.collector_warning'))?.val;
+            if (collectorWarning) {
+                this.adapter.log.warn(
+                    '[photovoltaicHelper] Kollektorüberhitzung erkannt → Pumpe ZWANGSEIN (Sicherheits-Override aktiv)',
+                );
+                return this._maybeStartPump('solar_overheat_protection');
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Fehler beim Prüfen der Solarüberhitzung: ${err.message}`);
+        }
+
+        // Überschussberechnung
+        const surplus = Math.max(0, gen - house);
+        await this._updateNumberState('photovoltaic.power_surplus_w', surplus);
+
+        // **NEU:** Einschaltlogik = Pumpenleistung + Sicherheitsaufschlag
+        const requiredPower = pumpMax + threshold;
+        const surplusActive = surplus >= requiredPower && seasonActive;
+        await this._updateBoolState('photovoltaic.surplus_active', surplusActive);
+
+        const txt = surplusActive
+            ? `Überschuss aktiv (${surplus} W ≥ ${pumpMax}+${threshold} W)`
+            : `Kein Überschuss (${surplus} W < ${pumpMax}+${threshold} W)`;
+        await this._updateStringState('photovoltaic.status_text', txt);
+        await this._updateStringState('photovoltaic.last_update', new Date().toISOString());
+
+        // Saison/Modus prüfen
+        if (!seasonActive) {
+            this.adapter.log.debug('[photovoltaicHelper] Saison inaktiv → keine PV-Schaltlogik.');
+            return this._maybeStopPump(false, 0, 'season_inactive');
+        }
+        if (pumpMode !== 'auto_pv') {
+            this.adapter.log.debug(
+                `[photovoltaicHelper] Pumpenmodus ist '${pumpMode}' ≠ 'auto_pv' → keine PV-Schaltlogik.`,
+            );
+            return this._maybeStopPump(false, 0, 'mode_not_auto_pv');
+        }
+
+        // FIX: PV-Helfer darf nur aktiv sein, solange Umwälzung noch nicht erfüllt ist
+        if (ignoreOnCirc) {
+            try {
+                const remainingState = await this.adapter.getForeignStateAsync(
+                    'poolcontrol.0.circulation.daily_remaining',
+                );
+                const remaining = Number(remainingState?.val ?? NaN);
+
+                if (Number.isFinite(remaining)) {
+                    // RULE: Wenn Umwälzung bereits erfüllt → Pumpe sofort AUS (ohne Nachlauf)
+                    if (remaining <= 0) {
+                        this.adapter.log.info(
+                            `[photovoltaicHelper] Tagesumwälzung erreicht (daily_remaining=${remaining}) → PV-Steuerung beendet, Pumpe AUS.`,
+                        );
+                        return this._maybeStopPump(true, 0, 'circulation_reached_force_off');
+                    }
+
+                    // RULE: Wenn Umwälzung noch nicht erfüllt → nur dann darf bei Überschuss eingeschaltet werden
+                    if (remaining > 0 && surplusActive) {
+                        this.adapter.log.debug(
+                            `[photovoltaicHelper] Tagesumwälzung noch nicht erfüllt (${remaining}) → PV-Steuerung aktiv.`,
+                        );
+                    }
+                }
+            } catch (err) {
+                this.adapter.log.debug(
+                    `[photovoltaicHelper] daily_remaining konnte nicht gelesen werden: ${err.message}`,
+                );
+            }
+        }
+
+        // FIX: PV-Schaltlogik mit Prüfung der Umwälzung
+        if (surplusActive) {
+            try {
+                const remainingState = await this.adapter.getForeignStateAsync(
+                    'poolcontrol.0.circulation.daily_remaining',
+                );
+                const remaining = Number(remainingState?.val ?? NaN);
+
+                // RULE: Einschalten nur, wenn Umwälzung noch nicht erfüllt
+                if (Number.isFinite(remaining) && remaining <= 0) {
+                    this.adapter.log.info(
+                        `[photovoltaicHelper] Tagesumwälzung bereits erfüllt (${remaining}) → Pumpe bleibt AUS (kein Start trotz Überschuss).`,
+                    );
+                    return this._maybeStopPump(true, 0, 'circulation_already_reached');
+                }
+
+                // RULE: Überschuss aktiv UND Umwälzung noch nicht erfüllt → einschalten
+                return this._maybeStartPump('pv_surplus');
+            } catch (err) {
+                this.adapter.log.warn(`[photovoltaicHelper] Fehler beim Prüfen von daily_remaining: ${err.message}`);
+                return this._maybeStartPump('pv_surplus');
+            }
+        }
+
+        // RULE: Kein Überschuss → ggf. Nachlauf/Aus
+        return this._maybeStopPump(false, afterrunMin, 'pv_ended_afterrun');
+    },
+
+    async _maybeStartPump(reason) {
+        if (this._desiredPump === true) {
+            return;
+        }
+        this._desiredPump = true;
+        if (this.afterrunTimer) {
+            clearTimeout(this.afterrunTimer);
+            this.afterrunTimer = null;
+        }
+        this._pvPumpHoldUntil = 0;
+        this.adapter.log.info(`[photovoltaicHelper] Pumpe EIN (Grund: ${reason})`);
+        await this._setPumpSwitch(true);
+    },
+
+    async _maybeStopPump(immediate, afterrunMin, tag) {
+        if (immediate || !afterrunMin || afterrunMin <= 0) {
+            if (this._desiredPump === false) {
+                return;
+            }
+            this._desiredPump = false;
+            this.adapter.log.info(`[photovoltaicHelper] Pumpe AUS (${tag}, ohne Nachlauf)`);
+            await this._setPumpSwitch(false);
+            return;
+        }
+
+        const holdMs = Math.round(afterrunMin * 60 * 1000);
+        this._pvPumpHoldUntil = Date.now() + holdMs;
+        if (this.afterrunTimer) {
+            clearTimeout(this.afterrunTimer);
+        }
+        this.afterrunTimer = setTimeout(async () => {
+            const active = !!(await this.adapter.getStateAsync('photovoltaic.surplus_active'))?.val;
+            if (active) {
+                this.adapter.log.debug('[photovoltaicHelper] Nachlauf abgebrochen – Überschuss wieder aktiv.');
+                return;
+            }
+            this._desiredPump = false;
+            this.adapter.log.info('[photovoltaicHelper] Pumpe AUS (Nachlauf beendet)');
+            await this._setPumpSwitch(false);
+        }, holdMs);
+        this.adapter.log.debug(`[photovoltaicHelper] Nachlauf gestartet: ${afterrunMin} min (${tag})`);
+    },
+
+    async _setPumpSwitch(on) {
+        try {
+            await this.adapter.setStateAsync('pump.pump_switch', { val: !!on, ack: false });
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Konnte pump.pump_switch nicht setzen: ${err.message}`);
+        }
+    },
+
+    async _updateNumberState(id, val) {
+        try {
+            await this.adapter.setStateAsync(id, { val: Number(val) || 0, ack: true });
+        } catch (e) {
+            this.adapter.log.warn(`[photovoltaicHelper] setNumber ${id} fehlgeschlagen: ${e.message}`);
+        }
+    },
+    async _updateBoolState(id, val) {
+        try {
+            await this.adapter.setStateAsync(id, { val: !!val, ack: true });
+        } catch (e) {
+            this.adapter.log.warn(`[photovoltaicHelper] setBool ${id} fehlgeschlagen: ${e.message}`);
+        }
+    },
+    async _updateStringState(id, val) {
+        try {
+            await this.adapter.setStateAsync(id, { val: String(val ?? ''), ack: true });
+        } catch (e) {
+            this.adapter.log.warn(`[photovoltaicHelper] setString ${id} fehlgeschlagen: ${e.message}`);
+        }
+    },
+
+    async _safeRecalc(tag) {
+        try {
+            await this._recalc(tag);
+        } catch (err) {
+            this.adapter.log.warn(`[photovoltaicHelper] Recalc-Fehler (${tag}): ${err.message}`);
+        }
+    },
+
+    cleanup() {
+        if (this.afterrunTimer) {
+            clearTimeout(this.afterrunTimer);
+            this.afterrunTimer = null;
+        }
+        this._pvPumpHoldUntil = 0;
+        this._desiredPump = null;
+    },
+};
+
+module.exports = photovoltaicHelper;

package/lib/helpers/statisticsHelperMonth.js

@@ -250,6 +250,12 @@ const statisticsHelperMonth = {
         });
 
         await this._updateOverallSummary();
+
+        // FIX: last_update korrigieren (echtes Aktualisierungsdatum)
+        await adapter.setStateAsync(`${basePath}.last_update`, {
+            val: new Date().toISOString(),
+            ack: true,
+        });
     },
 
     /**
@@ -385,6 +391,20 @@ const statisticsHelperMonth = {
     async _resetMonthlyTemperatureStats() {
         const adapter = this.adapter;
 
+        // 🟢 Neuer Logikblock: Monatsreset erfolgt nur, wenn wirklich neuer Monat begonnen hat
+        try {
+            const now = new Date();
+            const currentDay = now.getDate();
+
+            // Nur am 1. Tag des Monats ausführen (00:05 Uhr geplant)
+            if (currentDay !== 1) {
+                adapter.log.debug('[statisticsHelperMonth] Kein Monatsanfang – Reset übersprungen.');
+                return;
+            }
+        } catch (err) {
+            adapter.log.warn(`[statisticsHelperMonth] Fehler bei Monatsbeginn-Prüfung: ${err.message}`);
+        }
+
         // 🟢 NEU: Schutz vor Endlosschleifen und Mehrfachausführung
         if (this.isResetting) {
             adapter.log.debug('statisticsHelperMonth: Reset bereits aktiv – übersprungen.');

package/lib/stateDefinitions/controlStates.js

@@ -151,10 +151,16 @@ async function createControlStates(adapter) {
                 role: 'date',
                 read: true,
                 write: false,
+                persist: true,
             },
             native: {},
         });
-        await adapter.setStateAsync('control.pump.backwash_last_date', { val: '', ack: true });
+
+        // 🟢 Überinstallationsschutz – nur schreiben, wenn kein Wert existiert
+        const existingLastDate = await adapter.getStateAsync('control.pump.backwash_last_date');
+        if (existingLastDate === null || existingLastDate.val === null || existingLastDate.val === undefined) {
+            await adapter.setStateAsync('control.pump.backwash_last_date', { val: '', ack: true });
+        }
 
         await adapter.setObjectNotExistsAsync('control.pump.backwash_required', {
             type: 'state',

package/lib/stateDefinitions/photovoltaicStates.js

@@ -0,0 +1,161 @@
+'use strict';
+
+/**
+ * createPhotovoltaicStates(adapter)
+ * -------------------------------------------------------------
+ * Legt alle States für den Photovoltaik-Bereich an.
+ * - persistente States
+ * - überinstallationsgeschützt (keine Überschreibung vorhandener Werte)
+ * - konsistent im Stil der übrigen State-Dateien
+ * -------------------------------------------------------------
+ */
+
+/**
+ * @param {object} adapter - ioBroker Adapterinstanz
+ * @returns {Promise<void>}
+ */
+async function createPhotovoltaicStates(adapter) {
+    adapter.log.debug('[createPhotovoltaicStates] Initialisierung gestartet.');
+
+    // --- Photovoltaik-Hauptordner ---
+    await adapter.setObjectNotExistsAsync('photovoltaic', {
+        type: 'channel',
+        common: { name: 'Photovoltaik (Überschusserkennung)' },
+        native: {},
+    });
+
+    // --- State-Liste ---
+    const states = [
+        {
+            id: 'power_generated_w',
+            name: 'PV-Erzeugungsleistung (W)',
+            desc: 'Aktuell erzeugte Leistung der PV-Anlage in Watt',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 0,
+        },
+        {
+            id: 'power_house_w',
+            name: 'Hausverbrauch (W)',
+            desc: 'Aktueller Stromverbrauch des Hauses in Watt',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 0,
+        },
+        {
+            id: 'power_surplus_w',
+            name: 'PV-Überschussleistung (W)',
+            desc: 'Berechneter Überschuss zwischen PV-Erzeugung und Hausverbrauch',
+            type: 'number',
+            role: 'value.power',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 0,
+        },
+        {
+            id: 'surplus_active',
+            name: 'PV-Überschuss aktiv',
+            desc: 'Zeigt an, ob aktuell ein PV-Überschuss vorliegt (true/false)',
+            type: 'boolean',
+            role: 'indicator',
+            read: true,
+            write: false,
+            def: false,
+        },
+        {
+            id: 'afterrun_min',
+            name: 'Nachlaufzeit (Minuten)',
+            desc: 'Dauer, wie lange die Pumpe nach Ende des PV-Überschusses weiterläuft',
+            type: 'number',
+            role: 'level',
+            unit: 'min',
+            read: true,
+            write: true,
+            def: 2,
+        },
+        {
+            id: 'ignore_on_circulation',
+            name: 'PV ignorieren, wenn Umwälzmenge erreicht',
+            desc: 'Wenn aktiviert, wird PV-Steuerung deaktiviert, sobald Tagesumwälzung erfüllt ist',
+            type: 'boolean',
+            role: 'switch.enable',
+            read: true,
+            write: true,
+            def: false,
+        },
+        {
+            id: 'threshold_w',
+            name: 'Schwellwert für PV-Überschuss (W)',
+            desc: 'Watt-Schwelle, ab der ein Überschuss erkannt wird',
+            type: 'number',
+            role: 'value',
+            unit: 'W',
+            read: true,
+            write: false,
+            def: 200,
+        },
+        {
+            id: 'status_text',
+            name: 'Statusmeldung (Text)',
+            desc: 'Klartextstatus der PV-Erkennung (z. B. Überschuss aktiv)',
+            type: 'string',
+            role: 'text',
+            read: true,
+            write: false,
+            def: '',
+        },
+        {
+            id: 'last_update',
+            name: 'Letzte Aktualisierung',
+            desc: 'Zeitstempel der letzten Berechnung der PV-Werte',
+            type: 'string',
+            role: 'date',
+            read: true,
+            write: false,
+            def: '',
+        },
+    ];
+
+    // --- States anlegen ---
+    for (const s of states) {
+        const id = `photovoltaic.${s.id}`;
+
+        await adapter.setObjectNotExistsAsync(id, {
+            type: 'state',
+            common: {
+                name: s.name,
+                desc: s.desc,
+                type: s.type,
+                role: s.role,
+                read: s.read,
+                write: s.write,
+                def: s.def,
+                unit: s.unit || '',
+                persist: true,
+            },
+            native: {},
+        });
+
+        // Überinstallationsschutz
+        const existing = await adapter.getStateAsync(id);
+        if (existing === null || existing === undefined) {
+            await adapter.setStateAsync(id, { val: s.def, ack: true });
+            adapter.log.debug(
+                `[createPhotovoltaicStates] Neuer State '${id}' initialisiert mit Default-Wert ${s.def}.`,
+            );
+        } else {
+            adapter.log.debug(`[createPhotovoltaicStates] State '${id}' bereits vorhanden – Wert bleibt erhalten.`);
+        }
+    }
+
+    adapter.log.info('[createPhotovoltaicStates] Initialisierung abgeschlossen.');
+}
+
+module.exports = { createPhotovoltaicStates };

package/lib/stateDefinitions/pumpStates.js

@@ -110,6 +110,7 @@ async function createPumpStates(adapter) {
             persist: true, // NEU: dauerhaft speichern
             states: {
                 auto: 'Automatik',
+                auto_pv: 'Automatik (PV)',
                 manual: 'Manuell',
                 off: 'Aus',
                 time: 'Zeit',

package/lib/stateDefinitions/statisticsStates.js

@@ -100,7 +100,6 @@ async function _createTemperatureStatsGroup(adapter, periodId, displayName) {
             { id: 'temp_avg', name: 'Durchschnittstemperatur', type: 'number', role: 'value.temperature', unit: '°C' },
             { id: 'data_points_count', name: 'Anzahl Messwerte', type: 'number', role: 'value' },
             { id: 'last_update', name: 'Letzte Aktualisierung', type: 'string', role: 'value.time' },
-            { id: 'reset_today', name: 'Tagesstatistik zurücksetzen', type: 'boolean', role: 'button' },
             {
                 id: 'summary_json',
                 name: `${displayName} (JSON)`,
@@ -115,6 +114,16 @@ async function _createTemperatureStatsGroup(adapter, periodId, displayName) {
             },
         ];
 
+        // FIX: Reset-Button nur bei Tagesstatistik anlegen
+        if (periodId === 'today') {
+            stateDefs.push({
+                id: 'reset_today',
+                name: 'Tagesstatistik zurücksetzen',
+                type: 'boolean',
+                role: 'button',
+            });
+        }
+
         for (const def of stateDefs) {
             await adapter.setObjectNotExistsAsync(`${basePath}.${def.id}`, {
                 type: 'state',

package/main.js

@@ -19,6 +19,7 @@ const consumptionHelper = require('./lib/helpers/consumptionHelper');
 const solarHelper = require('./lib/helpers/solarHelper');
 const frostHelper = require('./lib/helpers/frostHelper');
 const statusHelper = require('./lib/helpers/statusHelper');
+const photovoltaicHelper = require('./lib/helpers/photovoltaicHelper');
 const controlHelper = require('./lib/helpers/controlHelper');
 const controlHelper2 = require('./lib/helpers/controlHelper2');
 const debugLogHelper = require('./lib/helpers/debugLogHelper');
@@ -29,6 +30,7 @@ const { createPumpStates } = require('./lib/stateDefinitions/pumpStates');
 const { createPumpStates2 } = require('./lib/stateDefinitions/pumpStates2');
 const { createPumpStates3 } = require('./lib/stateDefinitions/pumpStates3');
 const { createSolarStates } = require('./lib/stateDefinitions/solarStates');
+const { createPhotovoltaicStates } = require('./lib/stateDefinitions/photovoltaicStates');
 const { createGeneralStates } = require('./lib/stateDefinitions/generalStates');
 const { createTimeStates } = require('./lib/stateDefinitions/timeStates');
 const { createRuntimeStates } = require('./lib/stateDefinitions/runtimeStates');
@@ -67,6 +69,9 @@ class Poolcontrol extends utils.Adapter {
         // --- Solarverwaltung ---
         await createSolarStates(this);
 
+        // --- Photovoltaik ---
+        await createPhotovoltaicStates(this);
+
         // --- Zeitsteuerung ---
         await createTimeStates(this);
 
@@ -113,6 +118,7 @@ class Poolcontrol extends utils.Adapter {
         speechHelper.init(this);
         consumptionHelper.init(this);
         solarHelper.init(this);
+        photovoltaicHelper.init(this);
         frostHelper.init(this);
         statusHelper.init(this);
         controlHelper.init(this);
@@ -225,6 +231,11 @@ class Poolcontrol extends utils.Adapter {
         } catch (e) {
             this.log.warn(`[consumptionHelper] Fehler in handleStateChange: ${e.message}`);
         }
+        try {
+            photovoltaicHelper.handleStateChange(id, state);
+        } catch (e) {
+            this.log.warn(`[photovoltaicHelper] Fehler in handleStateChange: ${e.message}`);
+        }
         try {
             statusHelper.handleStateChange(id, state);
         } catch (e) {
@@ -242,6 +253,17 @@ class Poolcontrol extends utils.Adapter {
             controlHelper2.handleStateChange(id, state);
         }
 
+        // --- Photovoltaik-Parameter ---
+        if (id.endsWith('photovoltaic.afterrun_min')) {
+            this.log.debug(`[onStateChange] Nachlaufzeit (PV) geändert auf ${state.val} Minuten`);
+            this.config.pv_afterrun_min = Number(state.val);
+        }
+
+        if (id.endsWith('photovoltaic.ignore_on_circulation')) {
+            this.log.debug(`[onStateChange] PV-Logik ignorieren bei Umwälzmenge = ${state.val}`);
+            this.config.pv_ignore_on_circulation = !!state.val;
+        }
+
         await debugLogHelper.handleStateChange(id, state);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.poolcontrol",
-  "version": "0.5.5",
+  "version": "0.6.1",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",