iobroker.poolcontrol 0.5.4 → 0.6.0

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,18 @@ 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
+
 ## v0.5.3 (2025-10-30)
 - Telegram-Benutzerwahl hinzugefügt
 

package/admin/jsonConfig.json

@@ -851,8 +851,7 @@
 		},
         "speech_telegram_placeholder": {
           "type": "staticText",
-          "label": "",
-          "text": "",
+          "text": " ",
 		  "xs": 12,
           "sm": 3,
 		  "md": 3,
@@ -863,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,
@@ -948,7 +946,7 @@
 	},
 	"consumption": {
 	  "type": "panel",
-	  "label": "Verbrauch & Kosten",
+	  "label": "PV, Verbrauch & Kosten",
 	  "items": {
 		"divider_cons1": {
 		  "type": "divider",
@@ -1004,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,34 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.5.4",
+    "version": "0.6.0",
     "news": {
+       "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.",
+         "ru": "Исправлена оставшаяся рекурсия таймера в еженедельной и ежемесячной статистике для полного предотвращения бесконечных циклов сброса. Упрощена структура jsonConfig и улучшено управление таймерами.",
+         "pt": "Corrigida a recursão restante do temporizador nas estatísticas semanais e mensais para evitar completamente loops de redefinição infinitos. Estrutura jsonConfig limpa e manuseio de temporizador aprimorado.",
+         "nl": "Overgebleven timerrecursie in week- en maandstatistieken opgelost om oneindige resetlussen volledig te voorkomen. jsonConfig-structuur opgeschoond en timerafhandeling verbeterd.",
+         "fr": "Correction de la récursion restante du minuteur dans les statistiques hebdomadaires et mensuelles afin d'éviter définitivement les boucles de réinitialisation infinies. Structure jsonConfig nettoyée et gestion du minuteur améliorée.",
+         "it": "Corretta la ricorsione residua del timer nelle statistiche settimanali e mensili per prevenire completamente i loop di reset infiniti. Pulita la struttura jsonConfig e migliorata la gestione dei timer.",
+         "es": "Corregida la recursión restante del temporizador en las estadísticas semanales y mensuales para evitar completamente los bucles de reinicio infinitos. Estructura jsonConfig limpiada y manejo del temporizador mejorado.",
+         "pl": "Naprawiono pozostałą rekursję timera w statystykach tygodniowych i miesięcznych, aby całkowicie zapobiec nieskończonym pętlom resetowania. Uporządkowano strukturę jsonConfig i ulepszono obsługę timera.",
+         "uk": "Виправлено залишкову рекурсію таймера у тижневій та місячній статистиці, щоб повністю запобігти нескінченним циклам скидання. Очищено структуру jsonConfig і покращено обробку таймерів.",
+         "zh-cn": "修复了每周和每月统计中的剩余计时器递归问题，以完全防止无限重置循环。清理了 jsonConfig 结构并改进了计时器处理。"
+       },
        "0.5.4": {
          "en": "Fixed a rare infinite loop during weekly and monthly statistics reset that could cause Redis overload. Added timer protection and improved stability.",
          "de": "Selten auftretende Endlosschleife beim Wochen- und Monatsreset der Statistik behoben, die zu Redis-Überlastung führen konnte. Timer-Schutz und Stabilität verbessert.",
@@ -65,33 +91,7 @@
         "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 摘要以及午夜重置功能。"
-      },
-      "0.3.1": {
-        "en": "Frost protection logic stabilized: fixed hysteresis of +2 °C and rounded temperature values to avoid pump switching fluctuations around 3 °C.",
-        "de": "Frostschutz-Logik stabilisiert: feste Hysterese von +2 °C und gerundete Temperaturwerte zur Vermeidung von Pumpenschaltflattern um 3 °C.",
-        "ru": "Логика защиты от замерзания стабилизирована: фиксированная гистерезис +2 °C и округленные значения температуры для предотвращения колебаний включения насоса около 3 °C.",
-        "pt": "Lógica de proteção contra congelamento estabilizada: histerese fixa de +2 °C e valores de temperatura arredondados para evitar flutuações de comutação da bomba em torno de 3 °C.",
-        "nl": "Vorstbeschermingslogica gestabiliseerd: vaste hysterese van +2 °C en afgeronde temperatuurwaarden om pompfluctuaties rond 3 °C te voorkomen.",
-        "fr": "Logique de protection antigel stabilisée : hystérésis fixe de +2 °C et valeurs de température arrondies pour éviter les fluctuations de commutation de la pompe autour de 3 °C.",
-        "it": "Logica di protezione antigelo stabilizzata: isteresi fissa di +2 °C e valori di temperatura arrotondati per evitare fluttuazioni di commutazione della pompa intorno a 3 °C.",
-        "es": "Lógica de protección contra heladas estabilizada: histéresis fija de +2 °C y valores de temperatura redondeados para evitar fluctuaciones de conmutación de la bomba alrededor de 3 °C.",
-        "pl": "Ustabilizowano logikę ochrony przed zamarzaniem: stała histereza +2 °C i zaokrąglone wartości temperatury, aby uniknąć wahań przełączania pompy w okolicach 3 °C.",
-        "uk": "Стабілізовано логіку захисту від замерзання: фіксована гістерезис +2 °C і округлені значення температури, щоб уникнути коливань увімкнення насоса біля 3 °C.",
-        "zh-cn": "防冻逻辑稳定：固定 +2 °C 滞后并四舍五入温度值，以避免泵在 3 °C 附近频繁切换。"
-      }
+       }
 	},
     "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.2
  */
 
 const migrationHelper = {
@@ -31,6 +31,7 @@ const migrationHelper = {
             // ------------------------------------------------------
             await this._fixSpeechQueue();
             await this._fixSolarWarnActivePersist();
+            await this._fixPumpModeStates(); // NEU: PV-Automatik hinzufügen
 
             // Weitere Routinen folgen hier später:
             // await this._ensurePumpReason();
@@ -112,6 +113,39 @@ const migrationHelper = {
             this.adapter.log.warn(`[migrationHelper] Fehler bei Prüfung von ${id}: ${err.message}`);
         }
     },
+
+    // ------------------------------------------------------
+    // Migration: Ergänze neuen Pumpenmodus "Automatik (PV)"
+    // ------------------------------------------------------
+
+    /**
+     * Prüft den State pump.mode und ergänzt, falls nötig, den neuen
+     * Eintrag "auto_pv" → "Automatik (PV)".
+     * Dadurch wird der PV-Modus automatisch in bestehenden Installationen sichtbar.
+     */
+    async _fixPumpModeStates() {
+        const id = 'pump.mode';
+        try {
+            const obj = await this.adapter.getObjectAsync(id);
+            if (!obj) {
+                this.adapter.log.debug(`[migrationHelper] ${id} existiert nicht – keine Anpassung nötig.`);
+                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 },
+                });
+            } else {
+                this.adapter.log.debug(`[migrationHelper] pump.mode enthält bereits "Automatik (PV)".`);
+            }
+        } catch (err) {
+            this.adapter.log.warn(`[migrationHelper] Fehler bei Prüfung von ${id}: ${err.message}`);
+        }
+    },
 };
 
 module.exports = migrationHelper;

package/lib/helpers/photovoltaicHelper.js

@@ -0,0 +1,273 @@
+'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');
+        }
+
+        // Optional: Umwälzung erreicht?
+        if (ignoreOnCirc) {
+            try {
+                const remainingState = await this.adapter.getForeignStateAsync(
+                    'poolcontrol.0.circulation.daily_remaining',
+                );
+                const remaining = Number(remainingState?.val ?? NaN);
+                if (Number.isFinite(remaining) && remaining <= 0) {
+                    this.adapter.log.debug(
+                        `[photovoltaicHelper] Tagesumwälzung erreicht (daily_remaining = ${remaining}) → PV-Steuerung ignoriert.`,
+                    );
+                    return this._maybeStopPump(false, afterrunMin, 'circulation_reached');
+                }
+            } catch (err) {
+                this.adapter.log.debug(
+                    `[photovoltaicHelper] daily_remaining konnte nicht gelesen werden: ${err.message}`,
+                );
+            }
+        }
+
+        // Schaltlogik
+        if (surplusActive) {
+            return this._maybeStartPump('pv_surplus');
+        }
+        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

@@ -347,26 +347,31 @@ const statisticsHelperMonth = {
 
         const now = new Date();
         const nextReset = new Date(now.getFullYear(), now.getMonth() + 1, 1, 0, 5, 0, 0);
-        const msUntilReset = nextReset.getTime() - now.getTime();
-
-        // 🟢 NEU: Schutz – falls Resetzeitpunkt in der Vergangenheit liegt
-        if (msUntilReset < 60 * 1000) {
-            // unter 1 Minute Differenz
-            adapter.log.warn(
-                'statisticsHelperMonth: Berechneter Resetzeitpunkt liegt in der Vergangenheit – Korrigiere auf nächsten Monat.',
-            );
-            const corrected = new Date(now.getFullYear(), now.getMonth() + 1, 1, 0, 5, 0, 0);
-            const diff = corrected.getTime() - now.getTime();
-            this.monthResetTimer = setTimeout(async () => {
-                await this._resetMonthlyTemperatureStats();
-                await this._scheduleMonthReset();
-            }, diff);
-            return;
+        let msUntilReset = nextReset.getTime() - now.getTime();
+
+        // Wenn heute bereits der 1. ist → keinen sofortigen Reset starten!
+        if (now.getDate() === 1) {
+            adapter.log.debug('statisticsHelperMonth: Heute ist bereits der 1. – Reset wurde übersprungen.');
+            // Plan auf nächsten Monat verschieben
+            nextReset.setMonth(nextReset.getMonth() + 1);
+            msUntilReset = nextReset.getTime() - now.getTime();
+        }
+
+        // Wenn Berechnung negativ oder zu klein ist → Sicherheit
+        if (msUntilReset <= 0 || msUntilReset < 10 * 60 * 1000) {
+            adapter.log.debug('statisticsHelperMonth: msUntilReset war zu klein – korrigiere Timer.');
+            msUntilReset = 10 * 60 * 1000; // mindestens 10 Minuten warten
         }
 
+        // Timer setzen
         this.monthResetTimer = setTimeout(async () => {
+            if (this.isResetting) {
+                adapter.log.debug('statisticsHelperMonth: Reset läuft bereits – Timer übersprungen.');
+                return;
+            }
+
             await this._resetMonthlyTemperatureStats();
-            await this._scheduleMonthReset();
+            // await this._scheduleMonthReset();
         }, msUntilReset);
 
         adapter.log.debug(

package/lib/helpers/statisticsHelperWeek.js

@@ -389,7 +389,7 @@ const statisticsHelperWeek = {
 
         this.weekResetTimer = setTimeout(async () => {
             await this._resetWeeklyTemperatureStats();
-            await this._scheduleWeekReset();
+            // await this._scheduleWeekReset();
         }, msUntilReset);
 
         adapter.log.debug(`statisticsHelperWeek: Wochen-Reset geplant in ${Math.round(msUntilReset / 60000)} Minuten.`);

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/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.4",
+  "version": "0.6.0",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",