iobroker.poolcontrol 0.4.0 → 0.5.1

package/README.md

@@ -121,6 +121,14 @@ Funktionen können sich ändern – bitte regelmäßig den Changelog beachten.
 ## Changelog
 ### **WORK IN PROGRESS**
 
+## v0.5.0 (2025-10-28)
+- Erweiterung der Temperaturstatistik um Wochen- und Monatsauswertung  
+  (`analytics.statistics.temperature.week` / `.month`)
+- Eigenständige, eventbasierte Helper für Woche und Monat
+- Persistente Datenpunkte mit automatischen JSON- und HTML-Zusammenfassungen
+- Vorbereitung für zukünftige Erweiterungen (Saison- und Jahresstatistik)
+
+
 ### **0.4.0 (26.10.2025)**
 
 **Neue Funktionen**

package/io-package.json

@@ -1,8 +1,33 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.4.0",
+    "version": "0.5.1",
     "news": {
+       "0.5.1": {
+         "en": "Extended week and month statistics with persistent data, unified JSON format, and installation protection.",
+         "de": "Erweiterte Wochen- und Monatsstatistik mit persistenten Daten, einheitlichem JSON-Format und Überinstallationsschutz.",
+         "ru": "Расширенная недельная и месячная статистика с постоянными данными, унифицированным форматом JSON и защитой при переустановке.",
+         "pt": "Estatísticas semanais e mensais expandidas com dados persistentes, formato JSON unificado e proteção de reinstalação.",
+         "nl": "Uitgebreide week- en maandstatistieken met persistente gegevens, uniforme JSON-indeling en installatiebescherming.",
+         "fr": "Statistiques hebdomadaires et mensuelles étendues avec données persistantes, format JSON unifié et protection à la réinstallation.",
+         "it": "Statistiche settimanali e mensili estese con dati persistenti, formato JSON unificato e protezione dall'installazione.",
+         "es": "Estadísticas semanales y mensuales ampliadas con datos persistentes, formato JSON unificado y protección de reinstalación.",
+         "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.",
@@ -40,31 +65,6 @@
         "es": "Se añadió el cálculo del caudal real de la bomba, la monitorización en vivo y un sistema de rango normal autoaprendente para el análisis de la bomba.",
         "pl": "Dodano obliczanie rzeczywistego przepływu pompy, monitorowanie na żywo i samouczący się system normalnego zakresu do analizy pompy.",
         "zh-cn": "添加了实际泵流量计算、实时监控以及用于泵分析的自学习正常范围系统。"
-      },
-      "0.2.2": {
-        "en": "Added automatic backwash reminder with speech and log notifications.",
-        "de": "Automatische Rückspülerinnerung mit Sprach- und Log-Benachrichtigung hinzugefügt.",
-        "ru": "Добавлено автоматическое напоминание о обратной промывке с голосовыми и журнальными уведомлениями.",
-        "pt": "Adicionado lembrete automático de retrolavagem com notificações de voz e registro.",
-        "nl": "Automatische terugspoelherinnering toegevoegd met spraak- en logmeldingen.",
-        "fr": "Ajout d’un rappel automatique de contre-lavage avec notifications vocales et journaux.",
-        "it": "Aggiunto promemoria automatico di controlavaggio con notifiche vocali e log.",
-        "es": "Recordatorio automático de contralavado añadido con notificaciones de voz y registro.",
-        "pl": "Dodano automatyczne przypomnienie o płukaniu wstecznym z powiadomieniami głosowymi i dziennikiem.",
-        "zh-cn": "添加了带语音和日志通知的自动反冲洗提醒。"
-      },
-      "0.2.1": {
-       "en": "Fixed the issue with invisible states for speech control and added proper internal variable handling.",
-       "de": "Behebung des Problems mit unsichtbaren States für die Sprachsteuerung und hinzugefügte korrekte Handhabung interner Variablen.",
-       "ru": "Исправлена проблема с невидимыми состояниями для управления речью и добавлена правильная обработка внутренних переменных.",
-       "pt": "Corrigido o problema com estados invisíveis para controle de fala e adicionada a manipulação adequada de variáveis internas.",
-       "nl": "Het probleem met onzichtbare toestanden voor spraakbesturing is opgelost en de juiste verwerking van interne variabelen toegevoegd.",
-       "fr": "Correction du problème des états invisibles pour le contrôle vocal et ajout d'un traitement correct des variables internes.",
-       "it": "Risolto il problema con gli stati invisibili per il controllo vocale e aggiunto un corretto trattamento delle variabili interne.",
-       "es": "Se solucionó el problema con los estados invisibles para el control de voz y se añadió el manejo adecuado de las variables internas.",
-       "pl": "Naprawiono problem z niewidzialnymi stanami dla kontroli głosowej i dodano prawidłowe przetwarzanie zmiennych wewnętrznych.",
-       "uk": "Виправлено проблему з невидимими станами для керування голосом та додано правильну обробку внутрішніх змінних.",
-       "zh-cn": "修复了语音控制的隐形状态问题，并添加了正确的内部变量处理。"
       }
 	},
     "titleLang": {

package/lib/helpers/pumpHelper.js

@@ -118,6 +118,13 @@ const pumpHelper = {
         if (this.deviceId && id === this.deviceId) {
             const val = !!state.val;
             const current = (await this.adapter.getStateAsync('pump.pump_switch'))?.val;
+
+            // NEU: Filter gegen zyklische Fremdmeldungen ohne echten Zustandswechsel
+            if (current === val) {
+                this.adapter.log.debug('[pumpHelper] Fremd-State meldet identischen Wert – ignoriert.');
+                return;
+            }
+
             if (current !== val) {
                 await this.adapter.setStateAsync('pump.pump_switch', { val, ack: true });
                 await this._updateStatus();

package/lib/helpers/statisticsHelper.js

@@ -33,6 +33,14 @@ const statisticsHelper = {
         this.adapter = adapter;
         adapter.log.debug('statisticsHelper: Initialisierung gestartet.');
 
+        // --- Überinstallationsschutz ---
+        try {
+            // Prüft, ob alle States vorhanden sind, und legt fehlende still neu an
+            await this._verifyStructure();
+        } catch {
+            // keine Log-Ausgabe – stiller Schutz
+        }
+
         try {
             await this._createTemperatureStatistics();
             await this._subscribeActiveSensors();
@@ -64,14 +72,9 @@ const statisticsHelper = {
             const summaryHtmlPath = `${basePath}.summary_html`;
 
             if (!isActive) {
-                await adapter.setStateAsync(summaryJsonPath, {
-                    val: JSON.stringify({ status: 'kein Sensor aktiv' }),
-                    ack: true,
-                });
-                await adapter.setStateAsync(summaryHtmlPath, {
-                    val: '<div style="color:gray;">kein Sensor aktiv</div>',
-                    ack: true,
-                });
+                // Leere JSONs vorbereiten, damit spätere Temperaturwerte sie befüllen können
+                await adapter.setStateAsync(summaryJsonPath, { val: '[]', ack: true });
+                await adapter.setStateAsync(summaryHtmlPath, { val: '', ack: true });
                 continue;
             }
 
@@ -196,6 +199,9 @@ const statisticsHelper = {
             return;
         }
 
+        // NEU: Rundung auf 1 Nachkommastelle
+        newValue = Math.round(newValue * 10) / 10;
+
         const tempMin = (await adapter.getStateAsync(`${basePath}.temp_min`))?.val;
         const tempMax = (await adapter.getStateAsync(`${basePath}.temp_max`))?.val;
         const tempAvg = (await adapter.getStateAsync(`${basePath}.temp_avg`))?.val;
@@ -218,22 +224,33 @@ const statisticsHelper = {
         const newCount = count + 1;
         newAvg = tempAvg === null ? newValue : (tempAvg * count + newValue) / newCount;
 
+        // NEU: Alle Temperaturwerte auf 1 Nachkommastelle runden
+        newMin = Math.round(newMin * 10) / 10;
+        newMax = Math.round(newMax * 10) / 10;
+        newAvg = Math.round(newAvg * 10) / 10;
+
         await adapter.setStateAsync(`${basePath}.temp_min`, { val: newMin, ack: true });
         await adapter.setStateAsync(`${basePath}.temp_max`, { val: newMax, ack: true });
         await adapter.setStateAsync(`${basePath}.temp_avg`, { val: Math.round(newAvg * 100) / 100, ack: true });
         await adapter.setStateAsync(`${basePath}.data_points_count`, { val: newCount, ack: true });
         await adapter.setStateAsync(`${basePath}.last_update`, { val: now, ack: true });
 
-        // Summary aktualisieren
+        // Summary aktualisieren – erweitert um Datum, Zeitpunkte, Messanzahl, Name
         const summary = {
+            name: 'Tagesstatistik',
+            date: new Date().toISOString().slice(0, 10),
             temp_min: newMin,
+            temp_min_time: (await adapter.getStateAsync(`${basePath}.temp_min_time`))?.val || '',
             temp_max: newMax,
-            temp_avg: Math.round(newAvg * 100) / 100,
+            temp_max_time: (await adapter.getStateAsync(`${basePath}.temp_max_time`))?.val || '',
+            temp_avg: newAvg,
+            data_points_count: newCount,
             updated: now,
         };
         await adapter.setStateAsync(`${basePath}.summary_json`, { val: JSON.stringify(summary), ack: true });
         await adapter.setStateAsync(`${basePath}.summary_html`, {
-            val: `<div><b>Min:</b> ${newMin} °C / <b>Max:</b> ${newMax} °C / <b>Ø:</b> ${Math.round(newAvg * 100) / 100} °C</div>`,
+            // NEU: HTML-Ausgabe mit gerundeten Werten
+            val: `<div><b>Min:</b> ${newMin} °C / <b>Max:</b> ${newMax} °C / <b>Ø:</b> ${newAvg} °C</div>`,
             ack: true,
         });
 
@@ -241,45 +258,110 @@ const statisticsHelper = {
     },
 
     /**
-     * Gesamt-HTML/JSON-Ausgabe aktualisieren
+     * Gesamt-HTML/JSON-Ausgabe aktualisieren (erweiterte Version)
+     * Liest die fertigen summary_json-Werte aller aktiven Sensoren aus
+     * und erstellt daraus eine zusammengefasste HTML- und JSON-Ausgabe.
      */
     async _updateOverallSummary() {
         const adapter = this.adapter;
         const allData = [];
 
-        for (const sensor of this.sensors) {
-            const active = (await adapter.getStateAsync(`temperature.${sensor.id}.active`))?.val === true;
-            if (!active) {
-                allData.push({ name: sensor.name, status: 'kein Sensor aktiv' });
-                continue;
-            }
+        try {
+            // Alle Sensoren durchlaufen
+            for (const sensor of this.sensors) {
+                const summaryState = await adapter.getStateAsync(
+                    `analytics.statistics.temperature.today.${sensor.id}.summary_json`,
+                );
 
-            const min = (await adapter.getStateAsync(`analytics.statistics.temperature.today.${sensor.id}.temp_min`))
-                ?.val;
-            const max = (await adapter.getStateAsync(`analytics.statistics.temperature.today.${sensor.id}.temp_max`))
-                ?.val;
-            const avg = (await adapter.getStateAsync(`analytics.statistics.temperature.today.${sensor.id}.temp_avg`))
-                ?.val;
+                if (!summaryState || !summaryState.val) {
+                    continue;
+                }
 
-            allData.push({ name: sensor.name, min, max, avg });
-        }
+                // JSON-Inhalt parsen
+                let parsed;
+                try {
+                    parsed = JSON.parse(summaryState.val);
+                } catch {
+                    continue;
+                }
 
-        await adapter.setStateAsync('analytics.statistics.temperature.today.outputs.summary_all_json', {
-            val: JSON.stringify(allData),
-            ack: true,
-        });
+                const min = parsed.temp_min;
+                const max = parsed.temp_max;
+                const avg = parsed.temp_avg;
+                const date = parsed.date || '';
+                const minTime = parsed.temp_min_time || '';
+                const maxTime = parsed.temp_max_time || '';
+                const count = parsed.data_points_count || 0;
+
+                // Falls gar keine Werte vorhanden, überspringen
+                if (min == null && max == null && avg == null) {
+                    continue;
+                }
 
-        let html = '<table style="width:100%;border-collapse:collapse;">';
-        html += '<tr><th style="text-align:left;">Sensor</th><th>Min</th><th>Max</th><th>Ø</th></tr>';
-        for (const entry of allData) {
-            html += `<tr><td>${entry.name}</td><td>${entry.min ?? '-'}</td><td>${entry.max ?? '-'}</td><td>${entry.avg ?? '-'}</td></tr>`;
-        }
-        html += '</table>';
+                // Werte runden
+                const rMin = typeof min === 'number' ? Math.round(min * 10) / 10 : min;
+                const rMax = typeof max === 'number' ? Math.round(max * 10) / 10 : max;
+                const rAvg = typeof avg === 'number' ? Math.round(avg * 10) / 10 : avg;
+
+                // Erweiterte Datensammlung
+                allData.push({
+                    name: sensor.name,
+                    date,
+                    min: rMin,
+                    min_time: minTime,
+                    max: rMax,
+                    max_time: maxTime,
+                    avg: rAvg,
+                    data_points_count: count,
+                });
+            }
 
-        await adapter.setStateAsync('analytics.statistics.temperature.today.outputs.summary_all_html', {
-            val: html,
-            ack: true,
-        });
+            // Wenn noch keine Daten vorliegen → leer lassen
+            if (allData.length === 0) {
+                await adapter.setStateChangedAsync('analytics.statistics.temperature.today.outputs.summary_all_json', {
+                    val: '[]',
+                    ack: true,
+                });
+                await adapter.setStateChangedAsync('analytics.statistics.temperature.today.outputs.summary_all_html', {
+                    val: '',
+                    ack: true,
+                });
+                return;
+            }
+
+            // JSON-Ausgabe erstellen (komplett erweitert)
+            const jsonOutput = JSON.stringify(allData, null, 2);
+
+            // HTML-Ausgabe erstellen (mit Datum & Anzahl Messwerte)
+            let html = '<table style="width:100%;border-collapse:collapse;">';
+            html +=
+                '<tr><th style="text-align:left;">Sensor</th><th>Datum</th><th>Min</th><th>Zeit</th><th>Max</th><th>Zeit</th><th>Ø</th><th>Anz.</th></tr>';
+            for (const entry of allData) {
+                html += `<tr>
+                    <td>${entry.name}</td>
+                    <td>${entry.date || '-'}</td>
+                    <td>${entry.min ?? '-'}</td>
+                    <td>${entry.min_time || '-'}</td>
+                    <td>${entry.max ?? '-'}</td>
+                    <td>${entry.max_time || '-'}</td>
+                    <td>${entry.avg ?? '-'}</td>
+                    <td>${entry.data_points_count ?? '-'}</td>
+                </tr>`;
+            }
+            html += '</table>';
+
+            // States setzen (auch bei gleichen Werten → Timestamp aktualisieren)
+            await adapter.setStateChangedAsync('analytics.statistics.temperature.today.outputs.summary_all_json', {
+                val: jsonOutput,
+                ack: true,
+            });
+            await adapter.setStateChangedAsync('analytics.statistics.temperature.today.outputs.summary_all_html', {
+                val: html,
+                ack: true,
+            });
+        } catch {
+            // bewusst kein Log hier – stiller Schutz
+        }
     },
 
     /**
@@ -382,6 +464,18 @@ const statisticsHelper = {
         adapter.log.debug('statisticsHelper: Tagesstatistik zurückgesetzt.');
     },
 
+    /**
+     * Stiller Überinstallationsschutz:
+     * Prüft und legt fehlende States erneut an, ohne bestehende Werte zu überschreiben.
+     */
+    async _verifyStructure() {
+        try {
+            await this._createTemperatureStatistics();
+        } catch {
+            // bewusst keine Logs – stiller Selbstschutz
+        }
+    },
+
     cleanup() {
         if (this.midnightTimer) {
             clearTimeout(this.midnightTimer);