iobroker.poolcontrol 1.4.0 → 1.4.2

package/README.md

@@ -283,6 +283,25 @@ New features are added regularly – please refer to the changelog.
 ---
 
 ## Changelog
+### 1.4.2 (2026-07-01)
+
+- Fixed monthly temperature statistics reset scheduling
+  - Monthly reset no longer uses long timeouts above the Node.js/ioBroker limit
+  - Added persistent monthly period tracking
+  - Missed month changes after adapter downtime are detected safely
+  - Monthly reset is now checked daily and executed only once per period
+
+- Improved solar logbook logging
+  - Oversized solar logbook entries are now logged as debug instead of warning
+  - This avoids unnecessary warning noise for non-critical diagnostic information
+
+### 1.4.1 (2026-06-30)
+
+- Fixed Auto-PV holding logic for already running pumps.
+- When Auto-PV already controls the pump, the current pump power is now considered for the holding decision.
+- This prevents a running pump from triggering its own Auto-PV afterrun/stop cycle after startup.
+- The displayed PV surplus (`photovoltaic.power_surplus_w`) remains the real remaining surplus and is not artificially adjusted.
+
 ### 1.4.0 (2026-06-29)
 
 - Added a reset button for pump learning to quickly clear learned values after a pump replacement or incorrect learning while keeping user settings intact.
@@ -307,20 +326,6 @@ New features are added regularly – please refer to the changelog.
 - **Additional safeguards:** Added size protection for the solar logbook and debug log to prevent uncontrolled state growth.
 - **Maintenance:** Updated the `@iobroker/adapter-core` dependency to the latest recommended version.
 
-### 1.3.33 (2026-06-18)
-
-- Added live delta states for standard solar and Solar Extended control:
-  - `solar.collector_surface_delta`
-  - `solar.extended.collector_pool_reference_delta`
-- Documented that runtime changes to `solar.extended.pool_temperature_source` are applied automatically, but may take up to approximately 60 seconds due to the Solar Extended cyclic check interval.
-
-### 1.3.32 (2026-06-08)
-
-- Added circulation plausibility diagnostics for daily circulation calculations.
-- Added detection of implausible pump power values, flow rates and daily circulation volume jumps.
-- Added detailed diagnostic states under `circulation.plausibility` for troubleshooting and analysis.
-- Improved diagnostics for circulation calculations without changing existing pump, PV or solar control logic.
-
 ## Archived Release History
 
 For older releases and archived version history see:

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "1.4.0",
+    "version": "1.4.2",
     "news": {
+      "1.4.2": {
+        "en": "Fixed monthly temperature statistics reset scheduling to avoid long timeout errors on Node.js/ioBroker. Reduced oversized solar logbook warning to debug level.",
+        "de": "Monatsreset der Temperaturstatistik korrigiert, damit keine zu langen Timeout-Fehler unter Node.js/ioBroker entstehen. Überdimensionierte Solar-Logbuch-Hinweise von Warn auf Debug reduziert.",
+        "ru": "Исправлено расписание сброса ежемесячной статистики температуры, чтобы избежать ошибок длительного ожидания в Node.js/ioBroker. Уменьшено предупреждение о слишком большом размере журнала солнечной энергии до уровня отладки.",
+        "pt": "Corrigida a programação de redefinição de estatísticas mensais de temperatura para evitar longos erros de tempo limite no Node.js/ioBroker. Aviso de diário de bordo solar superdimensionado reduzido para o nível de depuração.",
+        "nl": "Vaste maandelijkse temperatuurstatistieken die de planning resetten om lange time-outfouten op Node.js/ioBroker te voorkomen. Waarschuwing voor te groot zonne-logboek teruggebracht tot foutopsporingsniveau.",
+        "fr": "Correction des statistiques de température mensuelles réinitialisant la planification pour éviter les longues erreurs de délai d'attente sur Node.js/ioBroker. Réduction des avertissements du journal solaire surdimensionné au niveau du débogage.",
+        "it": "Risolte le statistiche mensili sulla temperatura che ripristinano la pianificazione per evitare errori di timeout lunghi su Node.js/ioBroker. Avviso di registro solare sovradimensionato ridotto al livello di debug.",
+        "es": "Se corrigieron las estadísticas de temperatura mensuales que restablecen la programación para evitar errores de tiempo de espera prolongados en Node.js/ioBroker. Se redujo la advertencia del libro de registro solar de gran tamaño al nivel de depuración.",
+        "pl": "Naprawiono harmonogram resetowania miesięcznych statystyk temperatury, aby uniknąć błędów związanych z długim przekroczeniem limitu czasu w Node.js/ioBroker. Zmniejszono ostrzeżenie o zbyt dużym dzienniku słonecznym do poziomu debugowania.",
+        "uk": "Виправлено розклад скидання щомісячної статистики температури, щоб уникнути помилок тривалого очікування на Node.js/ioBroker. Зменшено попередження про надмірний сонячний журнал до рівня налагодження.",
+        "zh-cn": "修复了每月温度统计重置计划，以避免 Node.js/ioBroker 上的长时间超时错误。将超大太阳能日志警告减少到调试级别。"
+      },
+      "1.4.1": {
+        "en": "Fixed Auto-PV holding logic so a running pump no longer reduces its own available PV power calculation. The displayed PV surplus remains unchanged.",
+        "de": "Korrigiert die Auto-PV-Haltebedingung, damit eine laufende Pumpe ihre eigene verfügbare PV-Leistung nicht mehr rechnerisch reduziert. Der angezeigte PV-Überschuss bleibt unverändert.",
+        "ru": "Исправлена ​​логика удержания Auto-PV, поэтому работающий насос больше не уменьшает собственный расчет доступной фотоэлектрической мощности. Отображаемый излишек фотоэлектрической энергии остается неизменным.",
+        "pt": "Lógica de retenção Auto-PV corrigida para que uma bomba em funcionamento não reduza mais seu próprio cálculo de potência fotovoltaica disponível. O excedente fotovoltaico exibido permanece inalterado.",
+        "nl": "Vaste Auto-PV-houdlogica zodat een draaiende pomp niet langer zijn eigen beschikbare PV-vermogensberekening vermindert. Het weergegeven PV-overschot blijft ongewijzigd.",
+        "fr": "Correction de la logique de maintien Auto-PV afin qu'une pompe en marche ne réduise plus son propre calcul de puissance PV disponible. L'excédent PV affiché reste inchangé.",
+        "it": "Risolto il problema con la logica di mantenimento FV automatica in modo che una pompa in funzione non riducesse più il proprio calcolo della potenza FV disponibile. Il surplus FV visualizzato rimane invariato.",
+        "es": "Se corrigió la lógica de retención automática de PV para que una bomba en funcionamiento ya no reduzca su propio cálculo de potencia PV disponible. El excedente de PV mostrado permanece sin cambios.",
+        "pl": "Naprawiono logikę wstrzymywania Auto-PV, dzięki czemu działająca pompa nie zmniejsza już własnej dostępnej mocy obliczeniowej PV. Wyświetlana nadwyżka PV pozostaje niezmieniona.",
+        "uk": "Виправлена ​​логіка утримування автоматичної PV, тому працюючий насос більше не зменшує власний розрахунок доступної PV потужності. Відображений надлишок PV залишається незмінним.",
+        "zh-cn": "修复了自动光伏保持逻辑，因此运行中的泵不再减少其自身的可用光伏功率计算。显示的PV剩余量保持不变。"
+      },
       "1.4.0": {
         "en": "Added pump learning reset button with multilingual status messages, made the daily circulation factor writable and persistent with instant recalculation, introduced temperature-dependent automatic circulation factor adjustment, and extended time control with optional interval operation including diagnostic status messages.",
         "de": "Reset-Button für das Pumpen-Learning mit mehrsprachigen Statusmeldungen hinzugefügt, täglichen Umwälzfaktor beschreibbar und persistent gemacht inklusive sofortiger Neuberechnung, temperaturabhängige automatische Anpassung des Umwälzfaktors ergänzt sowie die Zeitsteuerung um einen optionalen Intervallbetrieb mit Diagnosestatus erweitert.",
@@ -41,32 +67,6 @@
         "pl": "Ulepszona architektura historii chemii z chronioną historią krótkoterminową i codzienną, zapobieganie nadmiernym stanom JSON, dodane zabezpieczenia przed rozrostem bazy danych stanu, ulepszona ochrona dziennika solarnego/dziennika debugowania oraz zaktualizowana zależność od rdzenia adaptera.",
         "uk": "Покращена архітектура хімічної історії із захищеною короткостроковою та щоденною історією, запобіганням надмірним станам JSON, доданим запобіжним засобам проти зростання бази даних стану, покращеному захисту сонячного журналу/журналу налагодження та оновленій залежності ядра адаптера.",
         "zh-cn": "改进了化学历史架构，具有受保护的短期和每日历史记录，防止过大的 JSON 状态，增加了针对状态数据库增长的保护措施，增强了太阳能日志/调试日志保护，并更新了适配器核心依赖性。"
-      },
-      "1.3.33": {
-        "en": "Added live delta states for standard solar and Solar Extended control. Documented Solar Extended pool reference runtime update behavior.",
-        "de": "Live-Delta-Datenpunkte für Standard-Solar und Solar Extended ergänzt. Laufzeitverhalten der Solar-Extended-Poolreferenz dokumentiert.",
-        "ru": "Добавлены дельта-состояния в реальном времени для стандартного и расширенного управления солнечной энергией. Документированное поведение обновления во время выполнения ссылки на расширенный пул Solar.",
-        "pt": "Adicionados estados delta ao vivo para controle solar padrão e solar estendido. Comportamento de atualização de tempo de execução de referência do pool Solar Extended documentado.",
-        "nl": "Live deltatoestanden toegevoegd voor standaard zonne-energie en Solar Extended-regeling. Gedocumenteerd runtime-updategedrag van de Solar Extended-poolreferentie.",
-        "fr": "Ajout d'états delta en direct pour le contrôle solaire standard et solaire étendu. Comportement documenté de la mise à jour du runtime de référence du pool Solar Extended.",
-        "it": "Aggiunti stati delta live per il controllo solare standard e Solar Extended. Comportamento documentato dell'aggiornamento runtime di riferimento del pool Solar Extended.",
-        "es": "Se agregaron estados delta en vivo para control solar estándar y solar extendido. Comportamiento de actualización del tiempo de ejecución de referencia del grupo Solar Extended documentado.",
-        "pl": "Dodano stany delta na żywo dla standardowego sterowania solarnego i Solar Extended. Udokumentowane zachowanie aktualizacji środowiska uruchomieniowego referencyjnej puli Solar Extended.",
-        "uk": "Додано живі дельта-стани для стандартного сонячного та розширеного керування Solar. Задокументована поведінка оновлення середовища виконання довідкового пулу Solar Extended.",
-        "zh-cn": "为标准太阳能和太阳能扩展控制添加了实时增量状态。记录了 Solar Extended 池参考运行时更新行为。"
-      },
-      "1.3.32": {
-        "en": "Added circulation plausibility diagnostics. New checks detect implausible pump power, flow rates, and daily circulation jumps. Added detailed diagnostic states under circulation.plausibility to simplify troubleshooting and analysis of circulation calculations.",
-        "de": "Plausibilitätsdiagnose für die Umwälzberechnung hinzugefügt. Neue Prüfungen erkennen unplausible Pumpenleistungen, Durchflusswerte und Sprünge der Tagesumwälzung. Detaillierte Diagnose-States unter circulation.plausibility erleichtern die Fehlersuche und Analyse der Umwälzberechnung.",
-        "ru": "Добавлена ​​диагностика достоверности циркуляции. Новые проверки выявляют неправдоподобную мощность насоса, скорость потока и скачки суточной циркуляции. Добавлены подробные диагностические состояния в разделе «циркуляция.достоверность» для упрощения поиска и устранения неисправностей и анализа расчетов циркуляции.",
-        "pt": "Adicionados diagnósticos de plausibilidade de circulação. Novas verificações detectam potências de bomba, taxas de fluxo e saltos diários de circulação implausíveis. Adicionados estados de diagnóstico detalhados em circulação.plausibilidade para simplificar a solução de problemas e a análise de cálculos de circulação.",
-        "nl": "Diagnostiek van circulatieplausibiliteit toegevoegd. Nieuwe controles detecteren onwaarschijnlijk pompvermogen, debieten en dagelijkse circulatiesprongen. Gedetailleerde diagnostische statussen toegevoegd onder circulatie.plausibiliteit om probleemoplossing en analyse van circulatieberekeningen te vereenvoudigen.",
-        "fr": "Ajout de diagnostics de plausibilité de la circulation. De nouveaux contrôles détectent une puissance de pompe, des débits et des sauts de circulation quotidiens invraisemblables. Ajout d'états de diagnostic détaillés sous circulation.plausibilité pour simplifier le dépannage et l'analyse des calculs de circulation.",
-        "it": "Aggiunta diagnostica di plausibilità della circolazione. Nuovi controlli rilevano potenza della pompa, portate e salti di circolazione giornalieri non plausibili. Aggiunti stati diagnostici dettagliati in circolazione.plausibilità per semplificare la risoluzione dei problemi e l'analisi dei calcoli della circolazione.",
-        "es": "Se agregaron diagnósticos de plausibilidad de circulación. Las nuevas comprobaciones detectan potencias de bombeo, caudales y saltos diarios de circulación inverosímiles. Se agregaron estados de diagnóstico detallados bajo circulación. Plausibilidad para simplificar la resolución de problemas y el análisis de los cálculos de circulación.",
-        "pl": "Dodano diagnostykę wiarygodności obiegu. Nowe kontrole wykrywają nieprawdopodobną moc pompy, natężenie przepływu i codzienne skoki cyrkulacji. Dodano szczegółowe stany diagnostyczne w obszarze cyrkulacja.wiarygodność, aby uprościć rozwiązywanie problemów i analizę obliczeń cyrkulacji.",
-        "uk": "Додана діагностика вірогідності циркуляції. Нові перевірки виявляють неправдоподібну потужність насоса, швидкість потоку та щоденні стрибки циркуляції. Додано детальні діагностичні стани під циркуляцією. Правдоподібність для спрощення пошуку несправностей і аналізу розрахунків циркуляції.",
-        "zh-cn": "添加了循环合理性诊断。新的检查可以检测到难以置信的泵功率、流量和每日循环跳跃。在循环下添加了详细的诊断状态。合理性以简化循环计算的故障排除和分析。"
       }
     },
     "titleLang": {

package/lib/helpers/photovoltaicHelper.js

@@ -8,6 +8,7 @@
  * - 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)
+ * - Haltebedingung: Restüberschuss + aktuelle Pumpenleistung >= erforderliche Leistung
  * -------------------------------------------------------------
  */
 
@@ -133,13 +134,32 @@ const photovoltaicHelper = {
         // FIX: Nur für die Textausgabe auf ganze Watt runden
         const surplusDisplay = Math.round(surplus);
 
-        // **NEU:** Einschaltlogik = Pumpenleistung + Sicherheitsaufschlag
         const requiredPower = pumpMax + threshold;
-        const surplusActive = surplus >= requiredPower && seasonActive;
+
+        // Wenn Auto-PV die laufende Pumpe tatsächlich hält, ist ihre Leistungsaufnahme
+        // bereits im Hausverbrauch enthalten und wird nur für die Halteentscheidung addiert.
+        const activeHelper = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+        const pumpSwitch = !!(await this.adapter.getStateAsync('pump.pump_switch'))?.val;
+        const currentPumpPower = Math.max(
+            0,
+            Number((await this.adapter.getStateAsync('pump.current_power'))?.val ?? 0) || 0,
+        );
+        const pvHoldsRunningPump =
+            pumpMode === 'auto_pv' &&
+            activeHelper === 'photovoltaicHelper' &&
+            pumpSwitch &&
+            this._desiredPump === true &&
+            !this.afterrunTimer;
+        const availablePowerForDecision = surplus + (pvHoldsRunningPump ? currentPumpPower : 0);
+        const surplusActive = availablePowerForDecision >= requiredPower && seasonActive;
 
         const txt = surplusActive
-            ? `Überschuss aktiv (${surplusDisplay} W ≥ ${pumpMax}+${threshold} W)`
-            : `Kein Überschuss (${surplusDisplay} W < ${pumpMax}+${threshold} W)`;
+            ? pvHoldsRunningPump
+                ? `Überschuss aktiv (Halteprüfung: ${surplusDisplay}+${Math.round(currentPumpPower)} W ≥ ${pumpMax}+${threshold} W)`
+                : `Überschuss aktiv (${surplusDisplay} W ≥ ${pumpMax}+${threshold} W)`
+            : pvHoldsRunningPump
+              ? `Kein ausreichender Überschuss (Halteprüfung: ${surplusDisplay}+${Math.round(currentPumpPower)} W < ${pumpMax}+${threshold} W)`
+              : `Kein Überschuss (${surplusDisplay} W < ${pumpMax}+${threshold} W)`;
 
         // FIX: Bestehende Ergebnisstates zuerst lesen, damit last_update nur bei echter Ergebnisänderung gesetzt wird
         const currentSurplus = Number((await this.adapter.getStateAsync('photovoltaic.power_surplus_w'))?.val ?? 0);

package/lib/helpers/solarLogbookHelper.js

@@ -539,7 +539,7 @@ const solarLogbookHelper = {
         }
 
         if (wasTrimmed) {
-            this.adapter.log.warn('[solarLogbookHelper] Day log was trimmed to keep JSON and text within 64 KB.');
+            this.adapter.log.debug('[solarLogbookHelper] Day log was trimmed to keep JSON and text within 64 KB.');
         }
 
         return { entries: limitedEntries, json, text };
@@ -617,7 +617,7 @@ const solarLogbookHelper = {
         }
 
         if (Buffer.byteLength(jsonText, 'utf8') > MAX_LOGBOOK_BYTES) {
-            this.adapter.log.warn('[solarLogbookHelper] Oversized day_log_json was discarded before parsing.');
+            this.adapter.log.debug('[solarLogbookHelper] Oversized day_log_json was discarded before parsing.');
             return [];
         }
 

package/lib/helpers/statisticsHelperMonth.js

@@ -19,6 +19,9 @@ const statisticsHelperMonth = {
     adapter: null,
     monthResetTimer: null,
     isResetting: false,
+    isPeriodCheckRunning: false,
+    periodStateId: 'analytics.statistics.temperature.month.last_processed_period',
+    maxCheckIntervalMs: 24 * 60 * 60 * 1000,
     sensors: [
         { id: 'outside', name: 'Außentemperatur' },
         { id: 'ground', name: 'Bodentemperatur' },
@@ -42,6 +45,13 @@ const statisticsHelperMonth = {
         try {
             await this._createTemperatureStatistics();
             await this._subscribeActiveSensors();
+
+            try {
+                await this._checkMonthPeriod();
+            } catch (err) {
+                adapter.log.warn(`statisticsHelperMonth: Error while checking monthly period: ${err.message}`);
+            }
+
             await this._scheduleMonthReset();
             adapter.log.debug('statisticsHelperMonth: Initialization completed (sensor monitoring active).');
         } catch (err) {
@@ -151,6 +161,20 @@ const statisticsHelperMonth = {
                 await adapter.setStateAsync(fullPath, { val: out.id.endsWith('json') ? '{}' : '', ack: true });
             }
         }
+
+        await adapter.setObjectNotExistsAsync(this.periodStateId, {
+            type: 'state',
+            common: {
+                name: 'Last processed monthly statistics period',
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: '',
+                persist: true,
+            },
+            native: {},
+        });
     },
 
     /**
@@ -343,7 +367,47 @@ const statisticsHelperMonth = {
     },
 
     /**
-     * Monats-Reset planen (1. Tag des Monats 00:05 Uhr)
+     * Prüft, ob seit dem letzten erfolgreichen Reset ein neuer Monat begonnen hat.
+     */
+    async _checkMonthPeriod() {
+        if (this.isPeriodCheckRunning) {
+            this.adapter.log.debug('statisticsHelperMonth: Monthly period check already running – skipped.');
+            return;
+        }
+
+        this.isPeriodCheckRunning = true;
+
+        try {
+            const currentPeriod = this._getCurrentPeriodKey();
+            const periodState = await this.adapter.getStateAsync(this.periodStateId);
+            const lastProcessedPeriod = typeof periodState?.val === 'string' ? periodState.val.trim() : '';
+
+            if (!lastProcessedPeriod) {
+                await this.adapter.setStateAsync(this.periodStateId, { val: currentPeriod, ack: true });
+                this.adapter.log.debug(
+                    `statisticsHelperMonth: Monthly period initialized with ${currentPeriod}; no reset required.`,
+                );
+                return;
+            }
+
+            if (lastProcessedPeriod === currentPeriod) {
+                return;
+            }
+
+            const resetSuccessful = await this._resetMonthlyTemperatureStats();
+            if (!resetSuccessful) {
+                throw new Error(`Monthly reset for period ${currentPeriod} was not completed`);
+            }
+
+            await this.adapter.setStateAsync(this.periodStateId, { val: currentPeriod, ack: true });
+            this.adapter.log.debug(`statisticsHelperMonth: Monthly period ${currentPeriod} marked as processed.`);
+        } finally {
+            this.isPeriodCheckRunning = false;
+        }
+    },
+
+    /**
+     * Nächsten Monatsperioden-Check planen (täglich um 00:10 Uhr, maximal 24 Stunden).
      */
     async _scheduleMonthReset() {
         if (this.monthResetTimer) {
@@ -352,39 +416,33 @@ const statisticsHelperMonth = {
         }
 
         const now = new Date();
-        const nextReset = new Date(now.getFullYear(), now.getMonth() + 1, 1, 0, 5, 0, 0);
-        let msUntilReset = nextReset.getTime() - now.getTime();
-
-        // // Wenn heute bereits der 1. ist → keinen sofortigen Reset starten!
-        // if (now.getDate() === 1) {
-        //     this.adapter.log.debug('statisticsHelperMonth: Today is already the 1st – reset skipped.');
-        //    // 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) {
-            this.adapter.log.debug('statisticsHelperMonth: msUntilReset was too small – adjusting timer.');
-            msUntilReset = 10 * 60 * 1000; // mindestens 10 Minuten warten
+        const nextCheck = new Date(now);
+        nextCheck.setHours(0, 10, 0, 0);
+        if (nextCheck <= now) {
+            nextCheck.setDate(nextCheck.getDate() + 1);
         }
+        const msUntilCheck = Math.min(nextCheck.getTime() - now.getTime(), this.maxCheckIntervalMs);
 
-        // Timer setzen
         this.monthResetTimer = this.adapter.setTimeout(async () => {
             this.monthResetTimer = null;
 
-            if (this.isResetting) {
-                this.adapter.log.debug('statisticsHelperMonth: Reset already running – timer skipped.');
-                await this._scheduleMonthReset();
-                return;
+            try {
+                await this._checkMonthPeriod();
+            } catch (err) {
+                this.adapter.log.warn(`statisticsHelperMonth: Error during monthly period check: ${err.message}`);
             }
 
-            await this._resetMonthlyTemperatureStats();
-            await this._scheduleMonthReset();
-        }, msUntilReset);
+            try {
+                await this._scheduleMonthReset();
+            } catch (err) {
+                this.adapter.log.warn(
+                    `statisticsHelperMonth: Error while scheduling monthly period check: ${err.message}`,
+                );
+            }
+        }, msUntilCheck);
 
         this.adapter.log.debug(
-            `statisticsHelperMonth: Monthly reset scheduled in ${Math.round(msUntilReset / 60000)} minutes.`,
+            `statisticsHelperMonth: Monthly period check scheduled in ${Math.round(msUntilCheck / 60000)} minutes.`,
         );
     },
 
@@ -394,24 +452,9 @@ 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] Not the first day of the month – reset skipped.');
-                return;
-            }
-        } catch (err) {
-            adapter.log.warn(`[statisticsHelperMonth] Error while checking month start: ${err.message}`);
-        }
-
-        // 🟢 NEU: Schutz vor Endlosschleifen und Mehrfachausführung
         if (this.isResetting) {
             adapter.log.debug('statisticsHelperMonth: Reset already active – skipped.');
-            return;
+            return false;
         }
         this.isResetting = true;
 
@@ -486,10 +529,12 @@ const statisticsHelperMonth = {
             });
 
             adapter.log.debug('statisticsHelperMonth: Monthly statistics reset completed.');
+            return true;
         } catch (err) {
             adapter.log.warn(`statisticsHelperMonth: Error during monthly reset: ${err.message}`);
+            return false;
         } finally {
-            this.isResetting = false; // 🟢 NEU: Flag wieder freigeben
+            this.isResetting = false;
         }
     },
 
@@ -515,6 +560,18 @@ const statisticsHelperMonth = {
         return `${month.charAt(0).toUpperCase() + month.slice(1)} ${year}`;
     },
 
+    /**
+     * Gibt die aktuelle lokale Monatsperiode als YYYY-MM zurück.
+     *
+     * @param {Date} date Zu formatierender lokaler Zeitpunkt
+     * @returns {string} Lokaler Monats-Schlüssel
+     */
+    _getCurrentPeriodKey(date = new Date()) {
+        const year = date.getFullYear();
+        const month = String(date.getMonth() + 1).padStart(2, '0');
+        return `${year}-${month}`;
+    },
+
     cleanup() {
         if (this.monthResetTimer) {
             this.adapter.clearTimeout(this.monthResetTimer);

package/package.json

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