iobroker.poolcontrol 1.3.27 → 1.3.29

package/lib/stateDefinitions/poolInsightsStates.js

@@ -0,0 +1,289 @@
+'use strict';
+
+/**
+ * poolInsightsStates.js
+ * ---------------------
+ * Creates states for analytics.insights.pool.
+ *
+ * Scope:
+ * - Rule-based overall pool insights
+ * - Read-only analysis output
+ * - Optional handoff to speech.queue handled by the helper
+ * - No automatic control, no dosing, no pump or actuator switching
+ */
+
+async function createChannel(adapter, id, name) {
+    await adapter.setObjectNotExistsAsync(id, {
+        type: 'channel',
+        common: { name },
+        native: {},
+    });
+}
+
+async function createState(adapter, id, common) {
+    await adapter.setObjectNotExistsAsync(id, {
+        type: 'state',
+        common,
+        native: {},
+    });
+
+    if (!Object.prototype.hasOwnProperty.call(common, 'def')) {
+        return;
+    }
+
+    const existing = await adapter.getStateAsync(id);
+    if (!existing || existing.val === null || existing.val === undefined) {
+        await adapter.setStateAsync(id, { val: common.def, ack: true });
+    }
+}
+
+/**
+ * @param {import('iobroker').Adapter} adapter - ioBroker adapter instance
+ * @returns {Promise<void>}
+ */
+async function createPoolInsightsStates(adapter) {
+    adapter.log.debug('[poolInsightsStates] Initialization started');
+
+    await createChannel(adapter, 'analytics', {
+        en: 'Analytics & insights (statistics, history, reports)',
+        de: 'Analysen & Statistiken (Verlauf, Berichte)',
+    });
+
+    await createChannel(adapter, 'analytics.insights', {
+        en: 'Insights & analysis',
+        de: 'Erkenntnisse & Analysen',
+    });
+
+    await createChannel(adapter, 'analytics.insights.pool', {
+        en: 'Pool insights (overall analysis)',
+        de: 'Pool Insights (Gesamtanalyse)',
+    });
+
+    await createChannel(adapter, 'analytics.insights.pool.debug', {
+        en: 'Debug',
+        de: 'Debug',
+    });
+
+    const states = [
+        {
+            id: 'analytics.insights.pool.enabled',
+            common: {
+                name: {
+                    en: 'Enable pool insights',
+                    de: 'Pool Insights aktivieren',
+                },
+                desc: {
+                    en: 'Enables the rule-based overall pool analysis. No automatic control is performed.',
+                    de: 'Aktiviert die regelbasierte Pool-Gesamtanalyse. Es erfolgt keine automatische Steuerung.',
+                },
+                type: 'boolean',
+                role: 'switch',
+                read: true,
+                write: true,
+                def: false,
+                persist: true,
+            },
+        },
+        {
+            id: 'analytics.insights.pool.manual_trigger',
+            common: {
+                name: {
+                    en: 'Run pool insights now',
+                    de: 'Pool Insights jetzt ausführen',
+                },
+                desc: {
+                    en: 'Starts a manual pool insights analysis and is reset afterwards.',
+                    de: 'Startet eine manuelle Pool-Insights-Analyse und wird danach zurückgesetzt.',
+                },
+                type: 'boolean',
+                role: 'button',
+                read: true,
+                write: true,
+                def: false,
+            },
+        },
+        {
+            id: 'analytics.insights.pool.send_to_speech_queue',
+            common: {
+                name: {
+                    en: 'Send summary to speech queue',
+                    de: 'Zusammenfassung an Speech Queue senden',
+                },
+                desc: {
+                    en: 'Allows pool insights to optionally write the summary to speech.queue.',
+                    de: 'Erlaubt Pool Insights optional, die Zusammenfassung an speech.queue zu schreiben.',
+                },
+                type: 'boolean',
+                role: 'switch',
+                read: true,
+                write: true,
+                def: false,
+                persist: true,
+            },
+        },
+        {
+            id: 'analytics.insights.pool.status',
+            common: {
+                name: {
+                    en: 'Status',
+                    de: 'Status',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: 'disabled',
+                states: {
+                    disabled: 'disabled',
+                    idle: 'idle',
+                    scheduled: 'scheduled',
+                    running: 'running',
+                    completed: 'completed',
+                    error: 'error',
+                },
+            },
+        },
+        {
+            id: 'analytics.insights.pool.level',
+            common: {
+                name: {
+                    en: 'Level',
+                    de: 'Stufe',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: 'none',
+                states: {
+                    none: 'none',
+                    ok: 'ok',
+                    info: 'info',
+                    warning: 'warning',
+                },
+            },
+        },
+        {
+            id: 'analytics.insights.pool.summary_text',
+            common: {
+                name: {
+                    en: 'Summary text',
+                    de: 'Zusammenfassungstext',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: '',
+            },
+        },
+        {
+            id: 'analytics.insights.pool.summary_html',
+            common: {
+                name: {
+                    en: 'Summary HTML',
+                    de: 'Zusammenfassung HTML',
+                },
+                type: 'string',
+                role: 'html',
+                read: true,
+                write: false,
+                def: '',
+            },
+        },
+        {
+            id: 'analytics.insights.pool.summary_json',
+            common: {
+                name: {
+                    en: 'Summary JSON',
+                    de: 'Zusammenfassung JSON',
+                },
+                type: 'string',
+                role: 'json',
+                read: true,
+                write: false,
+                def: '{}',
+            },
+        },
+        {
+            id: 'analytics.insights.pool.observations_json',
+            common: {
+                name: {
+                    en: 'Observations JSON',
+                    de: 'Beobachtungen JSON',
+                },
+                type: 'string',
+                role: 'json',
+                read: true,
+                write: false,
+                def: '[]',
+            },
+        },
+        {
+            id: 'analytics.insights.pool.recommendations_json',
+            common: {
+                name: {
+                    en: 'Recommendations JSON',
+                    de: 'Empfehlungen JSON',
+                },
+                type: 'string',
+                role: 'json',
+                read: true,
+                write: false,
+                def: '[]',
+            },
+        },
+        {
+            id: 'analytics.insights.pool.last_update',
+            common: {
+                name: {
+                    en: 'Last update',
+                    de: 'Letzte Aktualisierung',
+                },
+                type: 'string',
+                role: 'date',
+                read: true,
+                write: false,
+                def: '',
+            },
+        },
+        {
+            id: 'analytics.insights.pool.last_speech_at',
+            common: {
+                name: {
+                    en: 'Last speech output',
+                    de: 'Letzte Sprachausgabe',
+                },
+                type: 'string',
+                role: 'date',
+                read: true,
+                write: false,
+                def: '',
+            },
+        },
+        {
+            id: 'analytics.insights.pool.debug.last_reason',
+            common: {
+                name: {
+                    en: 'Last analysis reason',
+                    de: 'Letzter Analysegrund',
+                },
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                def: '',
+            },
+        },
+    ];
+
+    for (const state of states) {
+        await createState(adapter, state.id, state.common);
+    }
+
+    adapter.log.debug('[poolInsightsStates] Initialization completed');
+}
+
+module.exports = {
+    createPoolInsightsStates,
+};

package/lib/stateDefinitions/pumpStates.js

@@ -233,6 +233,45 @@ async function createPumpStates(adapter) {
         });
     }
 
+    // NEU: Sicherheits-Timeout für Leistungsprüfung nach Pumpenstart
+    await adapter.setObjectNotExistsAsync('pump.startup_power_check_timeout_sec', {
+        type: 'state',
+        common: {
+            name: {
+                en: 'Startup power check timeout',
+                de: 'Timeout Leistungsprüfung nach Pumpenstart',
+            },
+            desc: {
+                en: 'Time in seconds PoolControl waits after a pump start for valid power consumption. Higher values delay error detection and should only be used if the measurement hardware reports power values with a delay.',
+                de: 'Zeit in Sekunden, die PoolControl nach einem Pumpenstart auf eine gültige Leistungsaufnahme wartet. Höhere Werte verzögern die Fehlererkennung und sollten nur verwendet werden, wenn die eingesetzte Messhardware Leistungswerte verzögert liefert.',
+            },
+            type: 'number',
+            role: 'value',
+            unit: 's',
+            read: true,
+            write: true,
+            min: 5,
+            max: 10,
+            step: 1,
+            def: 5,
+            persist: true,
+        },
+        native: {},
+    });
+
+    // NEU: nur initial setzen, vorhandene/persistente Werte nicht überschreiben
+    const existingStartupPowerTimeout = await adapter.getStateAsync('pump.startup_power_check_timeout_sec');
+    if (
+        existingStartupPowerTimeout === null ||
+        existingStartupPowerTimeout.val === null ||
+        existingStartupPowerTimeout.val === undefined
+    ) {
+        await adapter.setStateAsync('pump.startup_power_check_timeout_sec', {
+            val: 5,
+            ack: true,
+        });
+    }
+
     // Pumpenstatus (Text)
     await adapter.setObjectNotExistsAsync('pump.status', {
         type: 'state',

package/lib/stateDefinitions/solarStates.js

@@ -245,7 +245,10 @@ async function createSolarStates(adapter) {
     const existingWarnActive = await adapter.getStateAsync('solar.warn_active');
     if (existingWarnActive === null || existingWarnActive.val === null || existingWarnActive.val === undefined) {
         // Nur bei erstmaligem Anlegen auf false setzen
-        await adapter.setStateAsync('solar.warn_active', { val: false, ack: true });
+        await adapter.setStateAsync('solar.warn_active', {
+            val: adapter.config.solar_collector_warn_active ?? false,
+            ack: true,
+        });
     }
 
     // NEU: Warnschwelle (°C, mit Persist-Schutz)
@@ -271,7 +274,10 @@ async function createSolarStates(adapter) {
     });
     const existingWarnTemp = await adapter.getStateAsync('solar.warn_temp');
     if (existingWarnTemp === null || existingWarnTemp.val === null || existingWarnTemp.val === undefined) {
-        await adapter.setStateAsync('solar.warn_temp', { val: 80, ack: true });
+        await adapter.setStateAsync('solar.warn_temp', {
+            val: adapter.config.solar_collector_warn_temp ?? 80,
+            ack: true,
+        });
     }
 
     // NEU: Sprachausgabe bei Warnung (mit Persist-Schutz)
@@ -296,7 +302,10 @@ async function createSolarStates(adapter) {
     });
     const existingWarnSpeech = await adapter.getStateAsync('solar.warn_speech');
     if (existingWarnSpeech === null || existingWarnSpeech.val === null || existingWarnSpeech.val === undefined) {
-        await adapter.setStateAsync('solar.warn_speech', { val: true, ack: true });
+        await adapter.setStateAsync('solar.warn_speech', {
+            val: adapter.config.solar_collector_warn_speech ?? true,
+            ack: true,
+        });
     }
 }
 

package/lib/stateDefinitions/statusStates.js

@@ -268,7 +268,7 @@ async function createStatusStates(adapter) {
     // Prüfen, ob bereits ein persistierter Wert existiert
     const existingSeasonActive = await adapter.getStateAsync('status.season_active');
     if (existingSeasonActive === null || existingSeasonActive.val === null || existingSeasonActive.val === undefined) {
-        await adapter.setStateAsync('status.season_active', { val: false, ack: true });
+        await adapter.setStateAsync('status.season_active', { val: adapter.config.season_active ?? false, ack: true });
     }
 }
 

package/main.js

@@ -42,6 +42,7 @@ const heatHelper = require('./lib/helpers/heatHelper');
 const actuatorsHelper = require('./lib/helpers/actuatorsHelper'); // NEU
 const solarInsightsHelper = require('./lib/helpers/solarInsightsHelper');
 const solarLogbookHelper = require('./lib/helpers/solarLogbookHelper'); // NEU
+const poolInsightsHelper = require('./lib/helpers/poolInsightsHelper');
 const { createTemperatureStates } = require('./lib/stateDefinitions/temperatureStates');
 const { createPumpStates } = require('./lib/stateDefinitions/pumpStates');
 const { createPumpStates2 } = require('./lib/stateDefinitions/pumpStates2');
@@ -71,6 +72,7 @@ const { createHeatStates } = require('./lib/stateDefinitions/heatStates');
 const { createActuatorsStates } = require('./lib/stateDefinitions/actuatorsStates');
 const { createSolarInsightsStates } = require('./lib/stateDefinitions/solarInsightsStates');
 const { createPhotovoltaicInsightsStates } = require('./lib/stateDefinitions/photovoltaicInsightsStates');
+const { createPoolInsightsStates } = require('./lib/stateDefinitions/poolInsightsStates');
 
 class Poolcontrol extends utils.Adapter {
     constructor(options) {
@@ -148,6 +150,9 @@ class Poolcontrol extends utils.Adapter {
         // --- Photovoltaic Insights / Analyse ---
         await createPhotovoltaicInsightsStates(this);
 
+        // --- Pool Insights / Gesamtanalyse ---
+        await createPoolInsightsStates(this);
+
         // --- Sprachausgaben ---
         await createSpeechStates(this);
 
@@ -224,6 +229,7 @@ class Poolcontrol extends utils.Adapter {
         actuatorsHelper.init(this); // NEU
         solarInsightsHelper.init(this);
         solarLogbookHelper.init(this); // NEU
+        poolInsightsHelper.init(this);
     }
 
     onUnload(callback) {
@@ -240,6 +246,12 @@ class Poolcontrol extends utils.Adapter {
             if (statisticsHelper.cleanup) {
                 statisticsHelper.cleanup();
             }
+            if (statisticsHelperWeek.cleanup) {
+                statisticsHelperWeek.cleanup();
+            }
+            if (statisticsHelperMonth.cleanup) {
+                statisticsHelperMonth.cleanup();
+            }
             if (pumpHelper.cleanup) {
                 pumpHelper.cleanup();
             }
@@ -288,6 +300,9 @@ class Poolcontrol extends utils.Adapter {
             if (solarLogbookHelper.cleanup) {
                 solarLogbookHelper.cleanup(); // NEU
             }
+            if (poolInsightsHelper.cleanup) {
+                poolInsightsHelper.cleanup();
+            }
             if (speechTextHelper.cleanup) {
                 speechTextHelper.cleanup();
             }
@@ -486,6 +501,11 @@ class Poolcontrol extends utils.Adapter {
         } catch (e) {
             this.log.warn(`[solarInsightsHelper] Error in handleStateChange: ${e.message}`);
         }
+        try {
+            poolInsightsHelper.handleStateChange(id, state);
+        } catch (e) {
+            this.log.warn(`[poolInsightsHelper] Error in handleStateChange: ${e.message}`);
+        }
         if (id.includes('control.')) {
             controlHelper.handleStateChange(id, state);
         }

package/package.json

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