iobroker.poolcontrol 0.7.1 → 0.7.3

package/lib/helpers/infoHelper.js

@@ -0,0 +1,159 @@
+'use strict';
+
+/**
+ * infoHelper.js
+ * ----------------------------------------------------------
+ * Verwaltet die Info-States:
+ *  - info.developer_greeting
+ *  - info.adapter_version
+ * ----------------------------------------------------------
+ */
+
+const infoHelper = {
+    adapter: null,
+    dailyTimer: null,
+
+    /**
+     * Initialisierung des Info-Helpers
+     *
+     * @param {import('iobroker').Adapter} adapter - Die ioBroker-Adapterinstanz
+     */
+    init(adapter) {
+        this.adapter = adapter;
+        this.adapter.log.debug('[infoHelper] Initialisiert');
+
+        // Adapterversion setzen
+        this._updateAdapterVersion();
+
+        // Entwicklergruß setzen
+        this._updateDeveloperGreeting();
+
+        // NEU: täglichen Timer starten
+        this._startDailyTimer();
+    },
+
+    /**
+     * Liest die Version aus io-package.json und schreibt sie in info.adapter_version
+     */
+    _updateAdapterVersion() {
+        try {
+            const ioPkg = require('../../io-package.json');
+            const version = ioPkg.common.version || '';
+
+            this.adapter.setState('info.adapter_version', version, true);
+        } catch (err) {
+            this.adapter.log.error(`[infoHelper] Fehler beim Lesen der Adapterversion: ${err}`);
+        }
+    },
+
+    /**
+     * Setzt saisonale Grüße in info.developer_greeting
+     */
+    _updateDeveloperGreeting() {
+        const now = new Date();
+        const month = now.getMonth() + 1;
+        const day = now.getDate();
+        let greeting = '';
+
+        // Weihnachten: 20.12. – 27.12.
+        if (month === 12 && day >= 20 && day <= 27) {
+            greeting = '🎄 PoolControl wünscht frohe Weihnachten! 🎄';
+        }
+
+        // Jahreswechsel
+        // 31.12.: Guten Rutsch
+        if (month === 12 && day === 31) {
+            greeting = '🎆 PoolControl wünscht einen guten Rutsch ins neue Jahr! 🎆';
+        }
+
+        // 01.01.: Frohes neues Jahr
+        if (month === 1 && day === 1) {
+            greeting = '🎆 Frohes neues Jahr wünscht PoolControl! 🎆';
+        }
+
+        // Dynamische Berechnung von Ostersonntag (Computus)
+        const easter = this._computeEaster(now.getFullYear());
+        const easterMonth = easter.getMonth() + 1;
+        const easterDay = easter.getDate();
+
+        const easterMonday = new Date(easter);
+        easterMonday.setDate(easterDay + 1);
+
+        // Ostersonntag
+        if (month === easterMonth && day === easterDay) {
+            greeting = '🐣 Frohe Ostern wünscht PoolControl! 🐣';
+        }
+
+        // Ostermontag
+        if (month === easterMonday.getMonth() + 1 && day === easterMonday.getDate()) {
+            greeting = '🐣 PoolControl wünscht einen schönen Ostermontag! 🐣';
+        }
+
+        this.adapter.setState('info.developer_greeting', greeting, true);
+    },
+
+    /**
+     * Berechnet das Datum des Ostersonntags für ein bestimmtes Jahr.
+     * Algorithmus: Anonymous Gregorian Computus
+     *
+     * @param {number} year - Das Jahr, für das Ostern berechnet werden soll
+     * @returns {Date} Datum des Ostersonntags
+     */
+    _computeEaster(year) {
+        const a = year % 19;
+        const b = Math.floor(year / 100);
+        const c = year % 100;
+        const d = Math.floor(b / 4);
+        const e = b % 4;
+        const f = Math.floor((b + 8) / 25);
+        const g = Math.floor((b - f + 1) / 3);
+        const h = (19 * a + b - d - g + 15) % 30;
+        const i = Math.floor(c / 4);
+        const k = c % 4;
+        const l = (32 + 2 * e + 2 * i - h - k) % 7;
+        const m = Math.floor((a + 11 * h + 22 * l) / 451);
+        const month = Math.floor((h + l - 7 * m + 114) / 31);
+        const day = ((h + l - 7 * m + 114) % 31) + 1;
+        return new Date(year, month - 1, day);
+    },
+
+    /**
+     * Startet den täglichen Update-Intervall (Update 00:01 Uhr)
+     */
+    _startDailyTimer() {
+        // nächsten Trigger für morgen 00:01 berechnen
+        const now = new Date();
+        const next = new Date(now);
+
+        next.setDate(now.getDate() + 1);
+        next.setHours(0, 1, 0, 0);
+
+        const delay = next.getTime() - now.getTime();
+
+        // einmaliger Timer bis 00:01
+        this.dailyTimer = setTimeout(() => {
+            this._updateDeveloperGreeting();
+
+            // danach täglich um 24h
+            this.dailyTimer = setInterval(
+                () => {
+                    this._updateDeveloperGreeting();
+                },
+                24 * 60 * 60 * 1000,
+            );
+        }, delay);
+    },
+
+    /**
+     * Stoppt Timer (wichtig beim Adapter-Unload)
+     */
+    cleanup() {
+        if (this.dailyTimer) {
+            clearTimeout(this.dailyTimer);
+            clearInterval(this.dailyTimer);
+            this.dailyTimer = null;
+        }
+    },
+};
+
+module.exports = infoHelper;

package/lib/stateDefinitions/aiStates.js

@@ -0,0 +1,135 @@
+'use strict';
+
+/**
+ * aiStates.js
+ * ----------------------------------------------------------
+ * Definiert alle States für den KI-Bereich des PoolControl-Adapters.
+ * Struktur:
+ * ai.switches.*
+ * ai.schedule.*
+ * ai.outputs.*
+ * ----------------------------------------------------------
+ *
+ * @param {import('iobroker').Adapter} adapter - ioBroker Adapterinstanz
+ */
+
+/**
+ * Erstellt alle KI-bezogenen States (ai.*)
+ *
+ * @param {import('iobroker').Adapter} adapter - ioBroker Adapterinstanz
+ */
+async function createAiStates(adapter) {
+    adapter.log.debug('[aiStates] Initialisierung gestartet');
+
+    // Hauptordner
+    await adapter.setObjectNotExistsAsync('ai', {
+        type: 'channel',
+        common: { name: 'KI / AI-Funktionen' },
+        native: {},
+    });
+
+    // ------------------------------------------------------
+    // Unterordner: switches
+    // ------------------------------------------------------
+    await adapter.setObjectNotExistsAsync('ai.switches', {
+        type: 'channel',
+        common: { name: 'Schalter (KI-Steuerung)' },
+        native: {},
+    });
+
+    const switches = [
+        { id: 'enabled', name: 'KI aktivieren', def: false },
+        { id: 'allow_speech', name: 'Sprachausgabe durch KI erlauben', def: false },
+        { id: 'daily_summary_enabled', name: 'Tägliche Zusammenfassung aktiv', def: false },
+        { id: 'daily_pool_tips_enabled', name: 'Tägliche Pool-Tipps aktiv', def: false },
+        { id: 'weather_advice_enabled', name: 'Wetterhinweise aktiv', def: false },
+        { id: 'weekend_summary_enabled', name: 'Wochenende-Zusammenfassung aktiv', def: false },
+        { id: 'debug_mode', name: 'KI-Debugmodus', def: false },
+    ];
+
+    for (const s of switches) {
+        await adapter.setObjectNotExistsAsync(`ai.switches.${s.id}`, {
+            type: 'state',
+            common: {
+                name: s.name,
+                type: 'boolean',
+                role: 'switch',
+                read: true,
+                write: true,
+                def: s.def,
+                persist: true,
+            },
+            native: {},
+        });
+    }
+
+    // ------------------------------------------------------
+    // Unterordner: schedule
+    // ------------------------------------------------------
+    await adapter.setObjectNotExistsAsync('ai.schedule', {
+        type: 'channel',
+        common: { name: 'Zeitpläne (KI-Ausgaben)' },
+        native: {},
+    });
+
+    const schedule = [
+        { id: 'daily_summary_time', name: 'Zeit für tägliche Zusammenfassung', def: '09:00' },
+        { id: 'daily_pool_tips_time', name: 'Zeit für tägliche Pool-Tipps', def: '10:00' },
+        { id: 'weather_advice_time', name: 'Zeit für Wetterhinweise', def: '08:00' },
+        { id: 'weekend_summary_time', name: 'Zeit für Wochenend-Zusammenfassung', def: '18:00' },
+    ];
+
+    for (const t of schedule) {
+        await adapter.setObjectNotExistsAsync(`ai.schedule.${t.id}`, {
+            type: 'state',
+            common: {
+                name: t.name,
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: true,
+                def: t.def,
+                persist: true,
+            },
+            native: {},
+        });
+    }
+
+    // ------------------------------------------------------
+    // Unterordner: outputs
+    // ------------------------------------------------------
+    await adapter.setObjectNotExistsAsync('ai.outputs', {
+        type: 'channel',
+        common: { name: 'KI-Ausgaben (Texte)' },
+        native: {},
+    });
+
+    const outputs = [
+        { id: 'daily_summary', name: 'Tägliche Zusammenfassung' },
+        { id: 'pool_tips', name: 'Pool-Tipps' },
+        { id: 'weather_advice', name: 'Wetterhinweise' },
+        { id: 'weekend_summary', name: 'Wochenende-Zusammenfassung' },
+        { id: 'last_message', name: 'Letzte KI-Meldung' },
+    ];
+
+    for (const o of outputs) {
+        await adapter.setObjectNotExistsAsync(`ai.outputs.${o.id}`, {
+            type: 'state',
+            common: {
+                name: o.name,
+                type: 'string',
+                role: 'text',
+                read: true,
+                write: false,
+                persist: false,
+            },
+            native: {},
+        });
+    }
+
+    adapter.log.debug('[aiStates] Initialisierung abgeschlossen');
+}
+
+module.exports = {
+    createAiStates,
+};

package/lib/stateDefinitions/infoStates.js

@@ -0,0 +1,63 @@
+'use strict';
+
+/**
+ * infoStates.js
+ * ----------------------------------------------------------
+ * Legt allgemeine Informations-States an:
+ *  - info.developer_greeting
+ *  - info.adapter_version
+ *
+ * Struktur:
+ *   info.*
+ * ----------------------------------------------------------
+ */
+
+/**
+ * Erstellt alle States im Bereich info.
+ *
+ * @param {import("iobroker").Adapter} adapter - ioBroker Adapterinstanz
+ */
+async function createInfoStates(adapter) {
+    // Hauptordner: info
+    await adapter.setObjectNotExistsAsync('info', {
+        type: 'channel',
+        common: {
+            name: 'Informationen (PoolControl Systeminfos)',
+        },
+        native: {},
+    });
+
+    // Entwickler-Grußtext
+    await adapter.setObjectNotExistsAsync('info.developer_greeting', {
+        type: 'state',
+        common: {
+            name: 'Entwickler-Grußtext',
+            desc: 'Saisonale Grüße und Informationen vom PoolControl-Entwickler',
+            type: 'string',
+            role: 'text',
+            read: true,
+            write: false,
+            def: '',
+        },
+        native: {},
+    });
+
+    // Adapterversion
+    await adapter.setObjectNotExistsAsync('info.adapter_version', {
+        type: 'state',
+        common: {
+            name: 'Installierte Adapterversion',
+            desc: 'Aktuell installierte Version von PoolControl',
+            type: 'string',
+            role: 'text',
+            read: true,
+            write: false,
+            def: '',
+        },
+        native: {},
+    });
+}
+
+module.exports = {
+    createInfoStates,
+};

package/main.js

@@ -21,11 +21,13 @@ 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 aiHelper = require('./lib/helpers/aiHelper');
 const controlHelper = require('./lib/helpers/controlHelper');
 const controlHelper2 = require('./lib/helpers/controlHelper2');
 const debugLogHelper = require('./lib/helpers/debugLogHelper');
 const speechTextHelper = require('./lib/helpers/speechTextHelper');
 const migrationHelper = require('./lib/helpers/migrationHelper');
+const infoHelper = require('./lib/helpers/infoHelper');
 const { createTemperatureStates } = require('./lib/stateDefinitions/temperatureStates');
 const { createPumpStates } = require('./lib/stateDefinitions/pumpStates');
 const { createPumpStates2 } = require('./lib/stateDefinitions/pumpStates2');
@@ -42,6 +44,8 @@ const { createConsumptionStates } = require('./lib/stateDefinitions/consumptionS
 const { createStatusStates } = require('./lib/stateDefinitions/statusStates');
 const { createControlStates } = require('./lib/stateDefinitions/controlStates');
 const { createDebugLogStates } = require('./lib/stateDefinitions/debugLogStates');
+const { createInfoStates } = require('./lib/stateDefinitions/infoStates');
+const { createAiStates } = require('./lib/stateDefinitions/aiStates'); // NEU: KI-States
 
 class Poolcontrol extends utils.Adapter {
     constructor(options) {
@@ -105,6 +109,12 @@ class Poolcontrol extends utils.Adapter {
         // --- DebugLog States ---
         await createDebugLogStates(this);
 
+        // --- Info States ---
+        await createInfoStates(this);
+
+        // --- AI States ---
+        await createAiStates(this); // NEU: KI-States anlegen
+
         // --- Migration Helper zuletzt starten ---
         await migrationHelper.init(this);
 
@@ -123,8 +133,10 @@ class Poolcontrol extends utils.Adapter {
         consumptionHelper.init(this);
         solarHelper.init(this);
         photovoltaicHelper.init(this);
+		aiHelper.init(this);
         frostHelper.init(this);
         statusHelper.init(this);
+        infoHelper.init(this);
         controlHelper.init(this);
         controlHelper2.init(this);
         debugLogHelper.init(this);
@@ -180,6 +192,12 @@ class Poolcontrol extends utils.Adapter {
             }
             if (speechTextHelper.cleanup) {
                 speechTextHelper.cleanup();
+            }
+			if (aiHelper.cleanup) {
+                aiHelper.cleanup();
+            }
+            if (infoHelper.cleanup) {
+                infoHelper.cleanup();
             }
         } catch (e) {
             this.log.warn(`[onUnload] Fehler beim Cleanup: ${e.message}`);
@@ -248,6 +266,12 @@ class Poolcontrol extends utils.Adapter {
             photovoltaicHelper.handleStateChange(id, state);
         } catch (e) {
             this.log.warn(`[photovoltaicHelper] Fehler in handleStateChange: ${e.message}`);
+        }
+		// --- AI-Helper ---
+        try {
+            aiHelper.handleStateChange(id, state);
+        } catch (e) {
+            this.log.warn(`[main] Fehler in aiHelper.handleStateChange: ${e.message}`);
         }
         try {
             statusHelper.handleStateChange(id, state);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.poolcontrol",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",
@@ -28,6 +28,7 @@
     "@iobroker/adapter-dev": "^1.5.0",
     "@iobroker/eslint-config": "^2.2.0",
     "@iobroker/testing": "^5.1.1",
+    "baseline-browser-mapping": "^2.8.32",
     "eslint": "^9.36.0",
     "prettier": "^3.6.2",
     "proxyquire": "^2.1.3",