iobroker.poolcontrol 0.6.1 → 0.6.3

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,33 @@
 {
   "common": {
     "name": "poolcontrol",
-    "version": "0.6.1",
+    "version": "0.6.3",
     "news": {
+       "0.6.3": {
+         "en": "Fix for weekly, monthly and yearly reset in consumptionHelper",
+         "de": "Fix für Wochen-, Monats- und Jahres-Reset im ConsumptionHelper",
+         "ru": "Исправление еженедельного, ежемесячного и ежегодного сброса в consumptionHelper",
+         "pt": "Correção para redefinição semanal, mensal e anual no consumptionHelper",
+         "nl": "Fix voor wekelijkse, maandelijkse en jaarlijkse reset in consumptionHelper",
+         "fr": "Correctif pour la réinitialisation hebdomadaire, mensuelle et annuelle dans consumptionHelper",
+         "it": "Correzione per il reset settimanale, mensile e annuale in consumptionHelper",
+         "es": "Corrección para el reinicio semanal, mensual y anual en consumptionHelper",
+         "pl": "Poprawka cotygodniowego, comiesięcznego i corocznego resetu w consumptionHelper",
+         "uk": "Виправлення щотижневого, щомісячного та щорічного скидання в consumptionHelper",
+         "zh-cn": "修复 consumptionHelper 中每周、每月和每年重置的问题"
+       },
+       "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.",
@@ -66,31 +91,6 @@
          "pl": "Dodano wybór użytkowników dla powiadomień Telegram. Gdy nie wybrano żadnego użytkownika, wiadomości są wysyłane globalnie jak wcześniej; po podaniu jednego lub kilku nazw użytkowników wiadomości otrzymują tylko oni. Ulepszono UI administracyjne (pole odbiorców pod instancją). Zaktualizowano speechHelper i jsonConfig.json.",
          "uk": "Додано вибір користувачів для сповіщень Telegram. Якщо користувача не вибрано, повідомлення надсилаються глобально, як і раніше; якщо вказано одне чи кілька імен, їх отримують лише ці користувачі. Візуально покращено інтерфейс адміністрування (поле одержувача під екземпляром). Оновлено speechHelper та jsonConfig.json.",
          "zh-cn": "新增 Telegram 通知的用户选择功能。未选择用户时消息将像以前一样全局发送；指定一个或多个用户名时，仅这些用户会收到消息。优化了管理界面显示（收件人字段缩进至实例下方）。已更新 speechHelper 和 jsonConfig.json。"
-       },
-       "0.5.2": {
-         "en": "Extended helper priority system: fixed time/solar conflicts, frost pauses during time windows. Stable pump behavior and improved coordination between helpers.",
-         "de": "Erweitertes Helper-Vorrangsystem: Konflikte zwischen Zeit- und Solarsteuerung behoben, Frostschutz pausiert während Zeitfenstern. Stabiles Pumpenverhalten und verbesserte Koordination zwischen den Helpern.",
-         "ru": "Расширена система приоритетов помощников: устранены конфликты между таймером и солнечным управлением, мороз приостанавливается во время временных окон. Стабильная работа насоса и улучшенная координация между помощниками.",
-         "pt": "Sistema de prioridade dos helpers expandido: corrigidos conflitos de tempo/solar, proteção contra geada pausa durante janelas de tempo. Comportamento estável da bomba e melhor coordenação entre helpers.",
-         "nl": "Uitgebreid helperprioriteitssysteem: conflicten tussen tijd- en zonregeling opgelost, vorstbeveiliging pauzeert tijdens tijdvensters. Stabiel pompgedrag en betere coördinatie tussen helpers.",
-         "fr": "Système de priorité des helpers étendu : conflits temps/solaire corrigés, protection antigel en pause pendant les plages horaires. Comportement de pompe stable et meilleure coordination entre les helpers.",
-         "it": "Sistema di priorità degli helper esteso: risolti i conflitti tempo/solare, la protezione antigelo si mette in pausa durante le finestre temporali. Comportamento stabile della pompa e migliore coordinamento tra gli helper.",
-         "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/consumptionHelper.js

@@ -39,6 +39,11 @@ const consumptionHelper = {
         this._scheduleDailyReset();
         this._loadCostBaselines();
         this._restoreBaselinesFromStates();
+
+        // NEU: regelmäßige Perioden-Resets
+        this._scheduleWeeklyReset();
+        this._scheduleMonthlyReset();
+        this._scheduleYearlyReset();
     },
 
     async _loadCostBaselines() {
@@ -262,6 +267,77 @@ const consumptionHelper = {
         }, msUntilMidnight);
     },
 
+    // ---------------------------------------------------------
+    // 🔵 WÖCHENTLICHER RESET (Montag 00:05 Uhr)
+    // ---------------------------------------------------------
+    _scheduleWeeklyReset() {
+        const now = new Date();
+        const next = new Date(now);
+
+        // Montag = 1 (Sonntag = 0)
+        const day = now.getDay();
+        const daysUntilMonday = (1 - day + 7) % 7;
+
+        next.setDate(now.getDate() + daysUntilMonday);
+        next.setHours(0, 5, 0, 0);
+
+        const delay = next - now;
+
+        setTimeout(async () => {
+            try {
+                this.adapter.log.info('[consumptionHelper] Wochen-Reset (Montag 00:05)');
+                await this.adapter.setStateAsync('consumption.week_kwh', { val: 0, ack: true });
+                await this.adapter.setStateAsync('costs.week_eur', { val: 0, ack: true });
+                this.baselines.week = (await this.adapter.getStateAsync('consumption.total_kwh'))?.val || 0;
+            } catch (err) {
+                this.adapter.log.warn(`[consumptionHelper] Fehler beim Wochenreset: ${err.message}`);
+            }
+            this._scheduleWeeklyReset(); // erneut planen
+        }, delay);
+    },
+
+    // ---------------------------------------------------------
+    // 🔵 MONATLICHER RESET (1. des Monats 00:05 Uhr)
+    // ---------------------------------------------------------
+    _scheduleMonthlyReset() {
+        const now = new Date();
+        const next = new Date(now.getFullYear(), now.getMonth() + 1, 1, 0, 5, 0, 0);
+        const delay = next - now;
+
+        setTimeout(async () => {
+            try {
+                this.adapter.log.info('[consumptionHelper] Monats-Reset (1. 00:05)');
+                await this.adapter.setStateAsync('consumption.month_kwh', { val: 0, ack: true });
+                await this.adapter.setStateAsync('costs.month_eur', { val: 0, ack: true });
+                this.baselines.month = (await this.adapter.getStateAsync('consumption.total_kwh'))?.val || 0;
+            } catch (err) {
+                this.adapter.log.warn(`[consumptionHelper] Fehler beim Monatsreset: ${err.message}`);
+            }
+            this._scheduleMonthlyReset();
+        }, delay);
+    },
+
+    // ---------------------------------------------------------
+    // 🔵 JÄHRLICHER RESET (1. Januar 00:10 Uhr)
+    // ---------------------------------------------------------
+    _scheduleYearlyReset() {
+        const now = new Date();
+        const next = new Date(now.getFullYear() + 1, 0, 1, 0, 10, 0, 0);
+        const delay = next - now;
+
+        setTimeout(async () => {
+            try {
+                this.adapter.log.info('[consumptionHelper] Jahres-Reset (1. Januar 00:10)');
+                await this.adapter.setStateAsync('consumption.year_kwh', { val: 0, ack: true });
+                await this.adapter.setStateAsync('costs.year_eur', { val: 0, ack: true });
+                this.baselines.year = (await this.adapter.getStateAsync('consumption.total_kwh'))?.val || 0;
+            } catch (err) {
+                this.adapter.log.warn(`[consumptionHelper] Fehler beim Jahresreset: ${err.message}`);
+            }
+            this._scheduleYearlyReset();
+        }, delay);
+    },
+
     cleanup() {
         if (this.resetTimer) {
             clearTimeout(this.resetTimer);

package/lib/helpers/frostHelper.js

@@ -13,6 +13,9 @@ const frostHelper = {
     adapter: null,
     checkTimer: null,
 
+    // NEU: interner Zwischenspeicher für den vorherigen Modus, um nach Frost sauber zurückzuspringen
+    _prevModeBeforeFrost: null, // ENDE NEU
+
     init(adapter) {
         this.adapter = adapter;
 
@@ -92,6 +95,30 @@ const frostHelper = {
 
             // Schalten nur, wenn sich etwas ändert
             if (shouldRun !== pumpActive) {
+                // NEU: Beim Einschalten Modus/Helper setzen und vorherigen Modus merken
+                if (shouldRun) {
+                    // Nur merken, wenn wir nicht bereits im Frostmodus sind
+                    const currentMode = (await this.adapter.getStateAsync('pump.mode'))?.val || 'auto';
+                    if (this._prevModeBeforeFrost == null) {
+                        this._prevModeBeforeFrost = currentMode;
+                    }
+
+                    // Frost als aktiven Helper/Modus setzen (damit der pumpHelper "EIN (Frostschutz)" anzeigt)
+                    await this.adapter.setStateAsync('pump.active_helper', { val: 'frostHelper', ack: true });
+                    await this.adapter.setStateAsync('pump.mode', { val: 'frostHelper', ack: true });
+                } else {
+                    // Ausschalten: Nur zurücksetzen, wenn der Frosthelfer wirklich aktiv war
+                    const activeHelperNow = (await this.adapter.getStateAsync('pump.active_helper'))?.val || '';
+                    if (activeHelperNow === 'frostHelper') {
+                        const modeToRestore = this._prevModeBeforeFrost || 'auto';
+                        await this.adapter.setStateAsync('pump.active_helper', { val: '', ack: true });
+                        await this.adapter.setStateAsync('pump.mode', { val: modeToRestore, ack: true });
+                    }
+                    // internen Zwischenspeicher nach Ende löschen
+                    this._prevModeBeforeFrost = null;
+                }
+                // ENDE NEU
+
                 await this.adapter.setStateAsync('pump.pump_switch', {
                     val: shouldRun,
                     ack: false,

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.3",
   "description": "Steuerung & Automatisierung für den Pool (Pumpe, Heizung, Ventile, Sensoren).",
   "author": "DasBo1975 <dasbo1975@outlook.de>",
   "homepage": "https://github.com/DasBo1975/ioBroker.poolcontrol",