iobroker.poolcontrol 0.5.0 → 0.5.1

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.5.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.",
@@ -52,18 +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": "添加了带语音和日志通知的自动反冲洗提醒。"
       }
 	},
     "titleLang": {

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();
@@ -227,12 +235,16 @@ const statisticsHelper = {
         await adapter.setStateAsync(`${basePath}.data_points_count`, { val: newCount, ack: true });
         await adapter.setStateAsync(`${basePath}.last_update`, { val: now, ack: true });
 
-        // Summary aktualisieren
-        // NEU: Zusammenfassung mit gerundeten Werten (1 Nachkommastelle)
+        // 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_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 });
@@ -246,7 +258,7 @@ const statisticsHelper = {
     },
 
     /**
-     * Gesamt-HTML/JSON-Ausgabe aktualisieren (Endgültige Version)
+     * 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.
      */
@@ -257,10 +269,6 @@ const statisticsHelper = {
         try {
             // Alle Sensoren durchlaufen
             for (const sensor of this.sensors) {
-                // const isActive = (await adapter.getStateAsync(`temperature.${sensor.id}.active`))?.val === true;
-                // if (!isActive) continue;
-
-                // Fertige Einzel-Summary des Sensors abrufen
                 const summaryState = await adapter.getStateAsync(
                     `analytics.statistics.temperature.today.${sensor.id}.summary_json`,
                 );
@@ -280,7 +288,12 @@ const statisticsHelper = {
                 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;
                 }
@@ -290,11 +303,16 @@ const statisticsHelper = {
                 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,
                 });
             }
 
@@ -311,14 +329,24 @@ const statisticsHelper = {
                 return;
             }
 
-            // JSON-Ausgabe erstellen
-            const jsonOutput = JSON.stringify(allData);
+            // JSON-Ausgabe erstellen (komplett erweitert)
+            const jsonOutput = JSON.stringify(allData, null, 2);
 
-            // HTML-Ausgabe erstellen
+            // 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>Min</th><th>Max</th><th>Ø</th></tr>';
+            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.min ?? '-'}</td><td>${entry.max ?? '-'}</td><td>${entry.avg ?? '-'}</td></tr>`;
+                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>';
 
@@ -331,10 +359,8 @@ const statisticsHelper = {
                 val: html,
                 ack: true,
             });
-
-            adapter.log.debug('statisticsHelper: Gesamtzusammenfassung (Summary All) erfolgreich aktualisiert.');
-        } catch (err) {
-            adapter.log.warn(`statisticsHelper: Fehler bei Gesamtzusammenfassung: ${err.message}`);
+        } catch {
+            // bewusst kein Log hier – stiller Schutz
         }
     },
 
@@ -438,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);

package/lib/helpers/statisticsHelperMonth.js

@@ -31,6 +31,13 @@ const statisticsHelperMonth = {
         this.adapter = adapter;
         adapter.log.debug('statisticsHelperMonth: Initialisierung gestartet.');
 
+        // --- Überinstallationsschutz ---
+        try {
+            await this._verifyStructure();
+        } catch {
+            // keine Log-Ausgabe – stiller Schutz
+        }
+
         try {
             await this._createTemperatureStatistics();
             await this._subscribeActiveSensors();
@@ -224,9 +231,15 @@ const statisticsHelperMonth = {
         await adapter.setStateAsync(`${basePath}.last_update`, { val: now, ack: true });
 
         const summary = {
+            name: 'Monatsstatistik',
+            month_label: this._getCurrentMonthLabel(),
+            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_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 });
@@ -269,8 +282,22 @@ const statisticsHelperMonth = {
                 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;
-
-                allData.push({ name: sensor.name, min: rMin, max: rMax, avg: rAvg });
+                const date = parsed.date || '';
+                const minTime = parsed.temp_min_time || '';
+                const maxTime = parsed.temp_max_time || '';
+                const count = parsed.data_points_count || 0;
+
+                allData.push({
+                    month_label: this._getCurrentMonthLabel(),
+                    name: sensor.name,
+                    date,
+                    min: rMin,
+                    min_time: minTime,
+                    max: rMax,
+                    max_time: maxTime,
+                    avg: rAvg,
+                    data_points_count: count,
+                });
             }
 
             if (allData.length === 0) {
@@ -407,6 +434,28 @@ const statisticsHelperMonth = {
         adapter.log.debug('statisticsHelperMonth: Monatsstatistik 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
+        }
+    },
+
+    /**
+     * Gibt den aktuellen Monat als lesbares Label zurück, z. B. "Oktober 2025".
+     */
+    _getCurrentMonthLabel() {
+        const d = new Date();
+        const month = d.toLocaleString('de-DE', { month: 'long' });
+        const year = d.getFullYear();
+        return `${month.charAt(0).toUpperCase() + month.slice(1)} ${year}`;
+    },
+
     cleanup() {
         if (this.monthResetTimer) {
             clearTimeout(this.monthResetTimer);

package/lib/helpers/statisticsHelperWeek.js

@@ -31,6 +31,14 @@ const statisticsHelperWeek = {
         this.adapter = adapter;
         adapter.log.debug('statisticsHelperWeek: 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();
@@ -225,10 +233,17 @@ const statisticsHelperWeek = {
         await adapter.setStateAsync(`${basePath}.data_points_count`, { val: newCount, ack: true });
         await adapter.setStateAsync(`${basePath}.last_update`, { val: now, ack: true });
 
+        // Summary aktualisieren – erweitert um Datum, Zeitpunkte, Messanzahl, Name
         const summary = {
+            name: 'Wochenstatistik',
+            week_range: this._getCurrentWeekRange(),
+            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_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 });
@@ -241,7 +256,7 @@ const statisticsHelperWeek = {
     },
 
     /**
-     * Gesamtzusammenfassung aller Sensoren aktualisieren
+     * Gesamt-HTML/JSON-Ausgabe aktualisieren (erweiterte Version – Woche)
      */
     async _updateOverallSummary() {
         const adapter = this.adapter;
@@ -263,7 +278,14 @@ const statisticsHelperWeek = {
                     continue;
                 }
 
-                const { temp_min: min, temp_max: max, temp_avg: avg } = parsed;
+                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;
+
                 if (min == null && max == null && avg == null) {
                     continue;
                 }
@@ -272,7 +294,17 @@ const statisticsHelperWeek = {
                 const rMax = typeof max === 'number' ? Math.round(max * 10) / 10 : max;
                 const rAvg = typeof avg === 'number' ? Math.round(avg * 10) / 10 : avg;
 
-                allData.push({ name: sensor.name, min: rMin, max: rMax, avg: rAvg });
+                allData.push({
+                    week_range: this._getCurrentWeekRange(),
+                    name: sensor.name,
+                    date,
+                    min: rMin,
+                    min_time: minTime,
+                    max: rMax,
+                    max_time: maxTime,
+                    avg: rAvg,
+                    data_points_count: count,
+                });
             }
 
             if (allData.length === 0) {
@@ -287,12 +319,22 @@ const statisticsHelperWeek = {
                 return;
             }
 
-            const jsonOutput = JSON.stringify(allData);
+            const jsonOutput = JSON.stringify(allData, null, 2);
 
             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>';
+            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.min ?? '-'}</td><td>${entry.max ?? '-'}</td><td>${entry.avg ?? '-'}</td></tr>`;
+                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>';
 
@@ -304,10 +346,8 @@ const statisticsHelperWeek = {
                 val: html,
                 ack: true,
             });
-
-            adapter.log.debug('statisticsHelperWeek: Gesamtzusammenfassung erfolgreich aktualisiert.');
-        } catch (err) {
-            adapter.log.warn(`statisticsHelperWeek: Fehler bei Gesamtzusammenfassung: ${err.message}`);
+        } catch {
+            // bewusst kein Log hier – stiller Schutz
         }
     },
 
@@ -412,6 +452,45 @@ const statisticsHelperWeek = {
         adapter.log.debug('statisticsHelperWeek: Wochenstatistik 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
+        }
+    },
+
+    /**
+     * Berechnet den Zeitraum (Start/Ende) der aktuellen Woche.
+     * Rückgabe: z. B. "27.10.2025 – 02.11.2025"
+     */
+    _getCurrentWeekRange() {
+        const today = new Date();
+
+        // Aktuellen Sonntag (nächster Wochenreset) finden
+        const nextSunday = new Date(today);
+        const day = today.getDay(); // Sonntag=0, Montag=1 …
+        const daysUntilSunday = (7 - day) % 7;
+        nextSunday.setDate(today.getDate() + daysUntilSunday);
+
+        // Wochenstart ist der Montag vor diesem Sonntag
+        const monday = new Date(nextSunday);
+        monday.setDate(nextSunday.getDate() - 6);
+
+        const fmt = d =>
+            d.toLocaleDateString('de-DE', {
+                day: '2-digit',
+                month: '2-digit',
+                year: 'numeric',
+            });
+
+        return `${fmt(monday)} – ${fmt(nextSunday)}`;
+    },
+
     cleanup() {
         if (this.weekResetTimer) {
             clearTimeout(this.weekResetTimer);

package/package.json

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