iobroker.poolcontrol 0.6.1 → 0.6.2

package/README.md

@@ -135,6 +135,13 @@ Neue Funktionen werden regelmäßig ergänzt – bitte den Changelog beachten.
 ## Changelog
 ### **WORK IN PROGRESS**
 
+## v0.6.2 (2025-11-07)
+- Überarbeitung der Instanzübersicht mit neuen Header-Strukturen für klarere Bedienung
+- Neues Startseitenbild „Egon im Blaumann“ in der Admin-Oberfläche integriert
+- Erweiterung des Sprachsystems um konfigurierbare Alexa-Ausgabezeiten
+- Anpassungen und Aufräumarbeiten in jsonConfig, speechHelper und speechStates
+
+
 ## v0.6.0 (2025-11-03)
 - Einführung der vollständigen Photovoltaik-Steuerung mit automatischer Pumpenlogik  
   (neuer Pumpenmodus `Automatik (PV)` unter `pump.mode`)
@@ -185,31 +192,6 @@ Neue Funktionen werden regelmäßig ergänzt – bitte den Changelog beachten.
 Diese Version bildet die stabile Basis für alle folgenden Statistik- und Analysefunktionen  
 (z. B. Wochen- und Monatsstatistik, Historien- und Effizienz-Auswertungen).
 
----
-
-### 0.3.1 (2025-10-18)
-- FrostHelper stabilisiert:
-  - Feste Hysterese von +2 °C (bisher +1 °C)
-  - Ganzzahl-Rundung eingeführt zur Vermeidung von Schaltflattern um 3 °C
-  - Keine Änderungen an States oder Konfiguration erforderlich
-
----
-
-### 0.3.0 (12.10.2025)
-**Neu:** Intelligentes Pumpen-Monitoring & Lernsystem
-
-- Hinzugefügt: **Reelle Durchflussberechnung** auf Basis der tatsächlichen Leistungsaufnahme.  
-- Neuer Bereich **`pump.live`** zur Live-Überwachung von Leistung, Durchfluss und prozentualer Auslastung.  
-- Die **tägliche Umwälzberechnung** verwendet nun den realen Durchflusswert anstelle eines Fixwerts.  
-- Neuer Lernbereich **`pump.learning`**:
-  - Lernt automatisch die durchschnittlichen Leistungs- und Durchflusswerte.  
-  - Bestimmt daraus einen dynamischen **Normalbereich (± 15 %)**.  
-  - Berechnet prozentuale Abweichungen und erstellt **textbasierte Statusmeldungen**.  
-  - Alle Lernwerte werden **persistent** gespeichert und bleiben auch nach Neustart erhalten.  
-- Vollständig **ereignisgesteuerte Logik** ohne zusätzliche Timer oder Polling-Zyklen.  
-
-> Mit dieser Version beginnt die lernfähige Phase des PoolControl-Adapters:  
-> Deine Pumpe weiß jetzt selbst, was für sie „normal“ ist.
 
 
 *(ältere Versionen siehe [io-package.json](./io-package.json))*  

package/admin/jsonConfig.json

@@ -6,9 +6,16 @@
       "type": "panel",
       "label": "Allgemeine Einstellungen",
       "items": {
-        "divider1": {
-          "type": "divider",
-          "newLine": true
+        "general_header": {
+          "type": "header",
+          "text": "Allgemeine Einstellungen zum Pool",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "pool_name": {
           "type": "text",
@@ -18,7 +25,8 @@
           "sm": 3,
 		  "md": 3,
 		  "lg": 3,
-		  "xl": 3
+		  "xl": 3,
+          "newLine": true
         },
         "pool_size": {
           "type": "number",
@@ -47,12 +55,18 @@
           "sm": 3,
 		  "md": 3,
 		  "lg": 3,
-		  "xl": 3,
-          "newLine": true
+		  "xl": 3
         },
-		"divider_season1": {
-          "type": "divider",
-          "newLine": true
+        "general_season_header": {
+          "type": "header",
+          "text": "Saisoneinstellungen",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "season_active": {
           "type": "checkbox",
@@ -65,19 +79,32 @@
           "xl": 3,
           "newLine": true
         },
-                "divider_hardware1": {
-          "type": "divider",
-          "newLine": true
-        }
+        "egon_image": {
+          "type": "staticImage",
+          "src": "adapter/poolcontrol/admin/egon_blaumann.jpg",
+          "newLine": true,
+          "xs": 3,
+          "sm": 3,
+          "md": 3,
+          "lg": 3,
+          "xl": 3
+        },
       }
     },
     "pump": {
       "type": "panel",
       "label": "Pumpe",
       "items": {
-        "divider2": {
-          "type": "divider",
-          "newLine": true
+        "Leistung_header": {
+          "type": "header",
+          "text": "Pumpeneinstellungen (Nennleistung)",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "pump_max_watt": {
           "type": "number",
@@ -87,7 +114,8 @@
           "sm": 3,
 		  "md": 3,
 		  "lg": 3,
-		  "xl": 3
+		  "xl": 3,
+          "newLine": true
         },
         "pump_power_lph": {
           "type": "number",
@@ -97,12 +125,18 @@
           "sm": 3,
 		  "md": 3,
 		  "lg": 3,
-		  "xl": 3,
-          "newLine": true
+		  "xl": 3
         },
-        "divider3": {
-          "type": "divider",
-          "newLine": true
+        "Frostschutz_header": {
+          "type": "header",
+          "text": "Frostschutz",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "frost_protection_active": {
           "type": "checkbox",
@@ -125,9 +159,16 @@
 		  "lg": 3,
 		  "xl": 3
         },
-        "divider4": {
-          "type": "divider",
-          "newLine": true
+        "pumpswitch_header": {
+          "type": "header",
+          "text": "Pumpendatenpunkte (Messsteckdose & Aktueller Verbrauch Watt)",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "pump_switch": {
           "type": "objectId",
@@ -149,10 +190,6 @@
 		  "lg": 3,
 		  "xl": 3
 		},
-        "divider9": {
-          "type": "divider",
-          "newLine": true
-        },
         "pump_mode_hint": {
           "type": "staticText",
           "text": "Pumpenmodus (Automatik/Manuell/Aus/Zeit) kann über den Datenpunkt 'pump.mode' gesteuert werden.",
@@ -163,9 +200,16 @@
           "lg": 12,
           "xl": 12
         },
-        "divider10": {
-          "type": "divider",
-          "newLine": true
+        "pump_safety_header": {
+          "type": "header",
+          "text": "Sicherheitsfunktionen",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "manual_safety_enabled": {
           "type": "checkbox",
@@ -194,9 +238,16 @@
       "type": "panel",
       "label": "Temperaturverwaltung",
       "items": {
-        "divider5": {
-          "type": "divider",
-          "newLine": true
+        "tempsensor_header": {
+          "type": "header",
+          "text": "Temperatursensoren",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "surface_temp_active": {
           "type": "checkbox",
@@ -330,9 +381,16 @@
       "type": "panel",
       "label": "Solarverwaltung",
       "items": {
-        "divider6": {
-          "type": "divider",
-          "newLine": true
+        "solar_control_active_header": {
+          "type": "header",
+          "text": "Solarsteuerung aktivieren",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "solar_control_active": {
           "type": "checkbox",
@@ -345,9 +403,16 @@
 		  "xl": 3,
           "newLine": true
         },
-        "divider_solar1": {
-          "type": "divider",
-          "newLine": true
+        "solar_hysteresis_active_header": {
+          "type": "header",
+          "text": "Hysterese",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "solar_hysteresis_active": {
           "type": "checkbox",
@@ -380,10 +445,17 @@
 		  "lg": 3,
 		  "xl": 3
         },
-		"divider_solar2": {
-		  "type": "divider",
-		  "newLine": true
-		},
+        "solar_collector_warn_active_header": {
+          "type": "header",
+          "text": "Kollektortemperatur-Warnung",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
 		"solar_collector_warn_active": {
 		  "type": "checkbox",
 		  "label": "Kollektortemperatur-Warnung aktivieren",
@@ -432,9 +504,16 @@
       "type": "panel",
       "label": "Zeitsteuerung",
       "items": {
-        "divider_time1": {
-          "type": "divider",
-          "newLine": true
+        "time1_active_header": {
+          "type": "header",
+          "text": "Zeitfenster 1",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "time1_active": {
           "type": "checkbox",
@@ -538,9 +617,16 @@
 		  "lg": 1,
 		  "xl": 1
 		},
-        "divider_time2": {
-          "type": "divider",
-          "newLine": true
+        "time2_active_header": {
+          "type": "header",
+          "text": "Zeitfenster 2",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "time2_active": {
           "type": "checkbox",
@@ -644,9 +730,16 @@
 		  "lg": 1,
 		  "xl": 1
 		},
-        "divider_time3": {
-          "type": "divider",
-          "newLine": true
+        "time3_active_header": {
+          "type": "header",
+          "text": "Zeitfenster 3",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "time3_active": {
           "type": "checkbox",
@@ -756,10 +849,17 @@
 	  "type": "panel",
 	  "label": "Sprachausgaben",
 	  "items": {
-		"divider_speech1": {
-		  "type": "divider",
-		  "newLine": true
-		},
+        "speech_general_header": {
+          "type": "header",
+          "text": "Generell",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
 		"speech_active": {
 		  "type": "checkbox",
 		  "label": "Sprachausgaben aktivieren",
@@ -772,10 +872,17 @@
 		  "newLine": true
 		},
 
-		"divider_speech2": {
-		  "type": "divider",
-		  "newLine": true
-		},
+        "speech_alexa_header": {
+          "type": "header",
+          "text": "Amazon Alexa",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
 		"speech_alexa_enabled": {
 		  "type": "checkbox",
 		  "label": "Ausgabe über Alexa aktivieren",
@@ -823,10 +930,17 @@
 		  "xl": 3
 		},
 
-		"divider_speech3": {
-		  "type": "divider",
-		  "newLine": true
-		},
+        "speech_telegram_header": {
+          "type": "header",
+          "text": "Telegram",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
 		"speech_telegram_enabled": {
 		  "type": "checkbox",
 		  "label": "Ausgabe über Telegram aktivieren",
@@ -870,9 +984,16 @@
           "lg": 6,
           "xl": 6
         },
-		  "divider_speech_email": {
-          "type": "divider",
-          "newLine": true
+        "speech_mail_header": {
+          "type": "header",
+          "text": "Mail",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "speech_email_enabled": {
           "type": "checkbox",
@@ -948,10 +1069,17 @@
 	  "type": "panel",
 	  "label": "PV, Verbrauch & Kosten",
 	  "items": {
-		"divider_cons1": {
-		  "type": "divider",
-		  "newLine": true
-		},
+        "consumption_header": {
+          "type": "header",
+          "text": "Verbrauch- und Kostenberechnung",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
+        },
 		"consumption_enabled": {
 		  "type": "checkbox",
 		  "label": "Verbrauchs- und Kostenberechnung aktivieren",
@@ -974,11 +1102,6 @@
 		  "lg": 6,
 		  "xl": 6
 		},
-
-		"divider_cons2": {
-		  "type": "divider",
-		  "newLine": true
-		},
 		"energy_price_eur_kwh": {
 		  "type": "number",
 		  "label": "Strompreis (€ / kWh)",
@@ -1003,11 +1126,6 @@
           "lg": 12,
           "xl": 12
 		},
-
-        "divider_pv1": {
-          "type": "divider",
-          "newLine": true
-        },
         "pv_header": {
           "type": "header",
           "text": "Photovoltaik (Überschusserkennung)",
@@ -1061,9 +1179,16 @@
       "type": "panel",
       "label": "Hilfe",
       "items": {
-        "divider_help": {
-          "type": "divider",
-          "newLine": true
+        "help_header": {
+          "type": "header",
+          "text": "Hilfe und Hinweise",
+          "size": 4,
+          "newLine": true,
+          "xs": 12,
+          "sm": 12,
+          "md": 12,
+          "lg": 12,
+          "xl": 12
         },
         "helpLink": {
           "type": "staticLink",

package/io-package.json

@@ -1,8 +1,20 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.6.1",
+    "version": "0.6.2",
     "news": {
+       "0.6.2": {
+         "en": "UI refinement and admin interface improvements. Added image integration ('Egon in blue overalls') for visual identification. Speech system extended with Alexa output time configuration. Cleaned and optimized jsonConfig with section headers for improved clarity.",
+         "de": "Oberflächenüberarbeitung und Verbesserungen der Admin-Ansicht. Bildintegration ('Egon im Blaumann') zur visuellen Wiedererkennung hinzugefügt. Sprachsystem um konfigurierbare Alexa-Ausgabezeiten erweitert. jsonConfig mit Abschnittsüberschriften bereinigt und übersichtlicher gestaltet.",
+         "ru": "Улучшение интерфейса и доработка административной панели. Добавлено изображение ('Эгон в синем комбинезоне') для визуальной идентификации. Расширена система речи с настройкой времени вывода Alexa. Очищена и оптимизирована jsonConfig с заголовками разделов для лучшей читаемости.",
+         "pt": "Aprimoramento da interface e melhorias na administração. Adicionada imagem ('Egon de macacão azul') para identificação visual. Sistema de fala ampliado com configuração de horários de saída Alexa. jsonConfig limpa e otimizada com cabeçalhos de seção para melhor clareza.",
+         "nl": "UI verfijnd en verbeteringen in het beheerpaneel. Afbeelding ('Egon in blauwe overall') toegevoegd voor visuele herkenning. Spraaksysteem uitgebreid met Alexa-uitvoertijdaanpassing. jsonConfig opgeschoond en overzichtelijker gemaakt met sectiekoppen.",
+         "fr": "Amélioration de l'interface utilisateur et du panneau d'administration. Image ajoutée ('Egon en bleu de travail') pour identification visuelle. Système vocal étendu avec configuration des heures de sortie Alexa. jsonConfig nettoyé et optimisé avec en-têtes de section pour plus de clarté.",
+         "it": "Raffinamento dell'interfaccia e miglioramenti al pannello di amministrazione. Aggiunta l'immagine ('Egon in tuta blu') per l'identificazione visiva. Sistema vocale ampliato con configurazione degli orari di uscita Alexa. jsonConfig ripulito e ottimizzato con intestazioni di sezione per maggiore chiarezza.",
+         "es": "Refinamiento de la interfaz y mejoras en el panel de administración. Se agregó imagen ('Egon con mono azul') para identificación visual. Sistema de voz ampliado con configuración de horarios de salida de Alexa. jsonConfig limpiado y optimizado con encabezados de sección para mayor claridad.",
+         "pl": "Udoskonalenie interfejsu i panelu administracyjnego. Dodano obraz ('Egon w niebieskim kombinezonie') dla wizualnej identyfikacji. Rozszerzono system mowy o konfigurację czasu wyjścia Alexa. Wyczyczono i zoptymalizowano jsonConfig z nagłówkami sekcji dla lepszej przejrzystości.",
+         "zh-cn": "改进了界面和管理界面。添加了图像（'蓝色工作服的Egon'）以实现视觉识别。语音系统扩展了Alexa输出时间配置。清理并优化了带有章节标题的jsonConfig，使其更清晰。"
+       },
        "0.6.1": {
          "en": "Fixed false monthly reset when no last_reset date existed. Corrected real last_update timestamp in monthly statistics.",
          "de": "Fehlerhaften Monatsreset ohne gültiges last_reset-Datum behoben. Korrigierter echter Zeitstempel last_update in der Monatsstatistik.",
@@ -78,19 +90,6 @@
          "es": "Sistema de prioridad de helpers ampliado: solucionados los conflictos de tiempo/solar, la protección contra heladas se pausa durante las ventanas de tiempo. Comportamiento estable de la bomba y mejor coordinación entre helpers.",
          "pl": "Rozszerzony system priorytetów helperów: naprawiono konflikty między czasem a sterowaniem solarnym, ochrona przed mrozem wstrzymuje się podczas okien czasowych. Stabilne działanie pompy i lepsza koordynacja między helperami.",
          "zh-cn": "扩展的助手优先级系统：修复时间/太阳能冲突，防冻在时间窗口内暂停。泵运行稳定，助手之间协调更好。"
-       },
-       "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 格式和重新安装保护。"
        }
 	},
     "titleLang": {

package/lib/helpers/speechHelper.js

@@ -10,6 +10,7 @@ const speechHelper = {
     adapter: null,
     lastTempNotify: {}, // Cooldown-Speicher pro Sensor
     lastPumpState: null, // interner Speicher für letzten Pumpenzustand
+    quietTime: {}, // 🆕 Cache für Alexa-Ruhezeiten
 
     init(adapter) {
         this.adapter = adapter;
@@ -22,7 +23,10 @@ const speechHelper = {
         this.adapter.subscribeStates('temperature.*.current'); // Temp-Trigger
         this.adapter.subscribeStates('pump.pump_switch'); // wichtig für Flankenerkennung
         this.adapter.subscribeStates('speech.last_text');
-        this.adapter.subscribeStates('speech.queue'); // <<< NEU: zentrale Nachrichtenwarteschlange
+        this.adapter.subscribeStates('speech.queue'); // zentrale Nachrichtenwarteschlange
+
+        // 🆕 Alexa-Ruhezeit-States abonnieren
+        this.adapter.subscribeStates('speech.amazon_alexa.*');
 
         this.adapter.log.debug('[speechHelper] initialisiert');
     },
@@ -32,6 +36,13 @@ const speechHelper = {
             return;
         }
 
+        // 🆕 Wenn sich ein Alexa-Ruhezeit-State geändert hat, Werte zwischenspeichern
+        if (id.startsWith('poolcontrol.0.speech.amazon_alexa.')) {
+            const key = id.split('.').pop();
+            this.quietTime[key] = state.val;
+            return;
+        }
+
         // Globale Aktivierung prüfen
         const active = (await this.adapter.getStateAsync('speech.active'))?.val;
         if (!active) {
@@ -66,35 +77,6 @@ const speechHelper = {
             return;
         }
 
-        /*
-         *
-         * Deaktiviert, ersetzt durch speechTextHelper
-         *
-         * // === Pumpenstart / -stop nur bei Zustandswechsel ===
-         * if (id.endsWith('pump.pump_switch')) {
-         *     const newVal = !!state.val;
-         *
-         *     // Nur wenn sich der Zustand wirklich geändert hat
-         *     if (this.lastPumpState !== newVal) {
-         *         this.lastPumpState = newVal;
-         *
-         *         if (newVal) {
-         *             const txt =
-         *                 (await this.adapter.getStateAsync('speech.start_text'))?.val ||
-         *                 'Die Poolpumpe wurde gestartet.';
-         *             await this._speak(txt);
-         *         } else {
-         *             const txt =
-         *                 (await this.adapter.getStateAsync('speech.end_text'))?.val || 'Die Poolpumpe wurde gestoppt.';
-         *             await this._speak(txt);
-         *         }
-         *     } else {
-         *         this.adapter.log.debug('[speechHelper] Ignoriere Pumpenmeldung – kein Zustandswechsel.');
-         *     }
-         *     return;
-         * }
-         */
-
         // Nur Pool-Oberflächentemperatur berücksichtigen
         if (!id.includes('temperature.surface')) {
             return;
@@ -129,6 +111,64 @@ const speechHelper = {
         return;
     },
 
+    // 🆕 Prüft, ob Alexa aktuell sprechen darf
+    async _isAlexaAllowed() {
+        try {
+            const now = new Date();
+            const currentDay = now.getDay(); // 0=So, 6=Sa
+            const isWeekend = currentDay === 0 || currentDay === 6;
+            const hhmm = now.toTimeString().slice(0, 5);
+
+            // Werte aus Cache oder States holen
+            const prefix = 'speech.amazon_alexa.';
+            const enabledState = isWeekend ? 'quiet_time_weekend_enabled' : 'quiet_time_week_enabled';
+            const startState = isWeekend ? 'quiet_time_weekend_start' : 'quiet_time_week_start';
+            const endState = isWeekend ? 'quiet_time_weekend_end' : 'quiet_time_week_end';
+
+            const enabled =
+                this.quietTime[enabledState] ?? (await this.adapter.getStateAsync(prefix + enabledState))?.val ?? false;
+            const start =
+                this.quietTime[startState] ?? (await this.adapter.getStateAsync(prefix + startState))?.val ?? '22:00';
+            const end =
+                this.quietTime[endState] ?? (await this.adapter.getStateAsync(prefix + endState))?.val ?? '07:00';
+
+            if (!enabled) {
+                await this.adapter.setStateAsync(`${prefix}quiet_time_active_now`, { val: false, ack: true });
+                return true;
+            }
+
+            // Zeitvergleich
+            const inRange = this._isTimeInRange(hhmm, start, end);
+            await this.adapter.setStateAsync(`${prefix}quiet_time_active_now`, { val: inRange, ack: true });
+
+            if (inRange) {
+                this.adapter.log.debug('[speechHelper] Alexa-Ruhezeit aktiv – Sprachausgabe blockiert.');
+                return false;
+            }
+            return true;
+        } catch (err) {
+            this.adapter.log.warn(`[speechHelper] Fehler bei Alexa-Ruhezeitprüfung: ${err.message}`);
+            return true; // im Zweifel sprechen lassen
+        }
+    },
+
+    // 🆕 Hilfsfunktion zum Zeitvergleich
+    _isTimeInRange(now, start, end) {
+        // Umwandeln in Minuten
+        const toMinutes = t => {
+            const [h, m] = t.split(':').map(Number);
+            return h * 60 + m;
+        };
+        const n = toMinutes(now);
+        const s = toMinutes(start);
+        const e = toMinutes(end);
+
+        if (s < e) {
+            return n >= s && n < e;
+        }
+        return n >= s || n < e; // über Mitternacht
+    },
+
     async _speak(text) {
         try {
             if (!text) {
@@ -138,29 +178,31 @@ const speechHelper = {
             // Letzten Text speichern
             await this.adapter.setStateAsync('speech.last_text', { val: text, ack: true });
 
-            // Alexa-Ausgabe
+            // 🆕 Alexa-Ausgabe mit Ruhezeitprüfung
             if (this.adapter.config.speech_alexa_enabled && this.adapter.config.speech_alexa_device) {
-                await this.adapter.setForeignStateAsync(this.adapter.config.speech_alexa_device, text);
-                this.adapter.log.info(`[speechHelper] Alexa sagt: ${text}`);
+                const allowed = await this._isAlexaAllowed();
+                if (allowed) {
+                    await this.adapter.setForeignStateAsync(this.adapter.config.speech_alexa_device, text);
+                    this.adapter.log.info(`[speechHelper] Alexa sagt: ${text}`);
+                } else {
+                    this.adapter.log.debug('[speechHelper] Alexa stumm (Ruhezeit aktiv).');
+                }
             }
 
             // Telegram-Ausgabe (modern über sendTo)
             if (this.adapter.config.speech_telegram_enabled && this.adapter.config.speech_telegram_instance) {
                 const instance = this.adapter.config.speech_telegram_instance;
                 try {
-                    // NEU: Benutzerliste aus Admin lesen (Komma-getrennte Namen)
                     const rawUsers = this.adapter.config.speech_telegram_users || '';
                     const users = rawUsers
                         .split(',')
                         .map(u => u.trim())
                         .filter(Boolean);
 
-                    // Wenn keine Benutzer angegeben → Standard: global an alle senden
                     if (users.length === 0) {
                         await this.adapter.sendToAsync(instance, { text, parse_mode: 'Markdown' });
                         this.adapter.log.info(`[speechHelper] Telegram (global): ${text}`);
                     } else {
-                        // Nur an ausgewählte Benutzer senden
                         for (const user of users) {
                             await this.adapter.sendToAsync(instance, { user, text, parse_mode: 'Markdown' });
                             this.adapter.log.info(`[speechHelper] Telegram an ${user}: ${text}`);
@@ -175,7 +217,7 @@ const speechHelper = {
 
             // E-Mail-Ausgabe (modern über sendTo)
             if (this.adapter.config.speech_email_enabled && this.adapter.config.speech_email_instance) {
-                const instance = this.adapter.config.speech_email_instance; // z. B. "email.0"
+                const instance = this.adapter.config.speech_email_instance;
                 try {
                     this.adapter.sendTo(instance, {
                         to: this.adapter.config.speech_email_recipient,
@@ -195,7 +237,9 @@ const speechHelper = {
     },
 
     cleanup() {
-        // nichts nötig bisher
+        if (this.adapter) {
+            this.adapter.log.debug('[speechHelper] Cleanup abgeschlossen.');
+        }
     },
 };
 

package/lib/stateDefinitions/speechStates.js

@@ -104,6 +104,93 @@ async function createSpeechStates(adapter) {
         ack: true,
     });
 
+    // ------------------------------------------------------------------
+    // 🆕 Amazon Alexa – Ruhezeiten
+    // ------------------------------------------------------------------
+
+    await adapter.setObjectNotExistsAsync('speech.amazon_alexa', {
+        type: 'channel',
+        common: { name: 'Amazon Alexa (Sprachausgabe)' },
+        native: {},
+    });
+
+    const alexaStates = [
+        {
+            id: 'quiet_time_week_enabled',
+            name: 'Ruhezeit (Mo–Fr) aktiv',
+            type: 'boolean',
+            role: 'switch',
+            def: false,
+        },
+        {
+            id: 'quiet_time_week_start',
+            name: 'Ruhezeit (Mo–Fr) Startzeit (HH:MM)',
+            type: 'string',
+            role: 'value.time',
+            def: '22:00',
+        },
+        {
+            id: 'quiet_time_week_end',
+            name: 'Ruhezeit (Mo–Fr) Endzeit (HH:MM)',
+            type: 'string',
+            role: 'value.time',
+            def: '07:00',
+        },
+        {
+            id: 'quiet_time_weekend_enabled',
+            name: 'Ruhezeit (Sa–So) aktiv',
+            type: 'boolean',
+            role: 'switch',
+            def: false,
+        },
+        {
+            id: 'quiet_time_weekend_start',
+            name: 'Ruhezeit (Sa–So) Startzeit (HH:MM)',
+            type: 'string',
+            role: 'value.time',
+            def: '22:00',
+        },
+        {
+            id: 'quiet_time_weekend_end',
+            name: 'Ruhezeit (Sa–So) Endzeit (HH:MM)',
+            type: 'string',
+            role: 'value.time',
+            def: '08:00',
+        },
+        {
+            id: 'quiet_time_active_now',
+            name: 'Alexa derzeit stumm (Ruhezeit aktiv)',
+            type: 'boolean',
+            role: 'indicator',
+            def: false,
+            write: false,
+        },
+    ];
+
+    for (const s of alexaStates) {
+        const fullId = `speech.amazon_alexa.${s.id}`;
+        await adapter.setObjectNotExistsAsync(fullId, {
+            type: 'state',
+            common: {
+                name: s.name,
+                type: s.type,
+                role: s.role,
+                read: true,
+                write: Boolean(s.write !== false), // Standard: true
+                def: s.def,
+                persist: true,
+            },
+            native: {},
+        });
+
+        const current = await adapter.getStateAsync(fullId);
+        if (!current || current.val === null || current.val === undefined) {
+            await adapter.setStateAsync(fullId, { val: s.def, ack: true });
+        }
+    }
+
+    adapter.log.debug('[speechStates] Amazon Alexa – Ruhezeit-States geprüft und angelegt.');
+
     // versteckte Dateien
 
     await adapter.setObjectNotExistsAsync('speech.solar_active', {

package/package.json

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