iobroker.utility-monitor 1.5.0 → 1.6.1

package/README.md

@@ -108,6 +108,36 @@ wasser.main.consumption.daily
 - **Klarheit**: Keine Special-Case Logik mehr im Code
 - **Multi-Meter**: Bessere Unterstützung für mehrere Zähler pro Typ
 - **CSV Import**: Einfaches Nachpflegen von historischen Daten via Drag-and-Drop im Admin-Interface
+- **Strukturierte Statistiken (v1.6.0)**: Klare Trennung von Verbrauch, Kosten und Zeitstempeln
+
+---
+
+## ⚠️ Breaking Changes in Version 1.6.0
+
+**WICHTIG:** Version 1.6.0 strukturiert das Statistik-Objekt um!
+
+### Was hat sich geändert?
+
+**Vorher (bis 1.5.1):**
+
+```
+gas.main.statistics.lastDay
+gas.main.statistics.lastMonth
+gas.main.statistics.lastDayStart
+```
+
+**Jetzt (ab 1.6.0):**
+
+```
+gas.main.statistics.consumption.lastDay      ← Verbrauchswerte
+gas.main.statistics.cost.lastDay             ← Kostenwerte (NEU!)
+gas.main.statistics.timestamps.lastDayStart   ← Zeitstempel der Resets
+```
+
+### 🔧 Migration erforderlich
+
+1. **Skripte/VIS anpassen**: Falls du direkt auf Statistik-Datenpunkte zugreifst, musst du die Pfade anpassen.
+2. **Kostenstatistiken**: Du profitierst nun von historischen Kostenübersichten (Tag/Woche/Monat).
 
 ---
 
@@ -212,17 +242,38 @@ Balance:           +62,64 € → Nachzahlung
 
 ### 📈 **statistics** (Statistiken)
 
+Seit Version 1.6.1 sind Statistiken in drei Unterkanäle unterteilt:
+
+#### 📊 **consumption** (Verbrauchshistorie)
+
 | Datenpunkt       | Beschreibung                         |
 | ---------------- | ------------------------------------ |
-| `averageDaily`   | Durchschnittlicher Tagesverbrauch    |
-| `averageMonthly` | Durchschnittlicher Monatsverbrauch   |
-| `lastDay`        | Verbrauch **gesten** (Vortag)        |
+| `lastDay`        | Verbrauch **gestern** (Vortag)       |
 | `lastWeek`       | Verbrauch **letzte Woche**           |
 | `lastMonth`      | Verbrauch **letzter Monat**          |
-| `lastDayStart`   | Letzter Tages-Reset (00:00 Uhr)      |
-| `lastWeekStart`  | Letzter Wochen-Reset (Montag)        |
-| `lastMonthStart` | Letzter Monats-Reset (1. des Monats) |
-| `lastYearStart`  | Vertragsbeginn / Jahresstart         |
+| `lastYear`       | Verbrauch **letztes Jahr** (Vorjahr) |
+| `averageDaily`   | Durchschnittlicher Tagesverbrauch    |
+| `averageMonthly` | Durchschnittlicher Monatsverbrauch   |
+
+#### 💰 **cost** (Kostenhistorie - NEU in 1.6.0)
+
+| Datenpunkt       | Beschreibung                      |
+| ---------------- | --------------------------------- |
+| `lastDay`        | Kosten **gestern** (Vortag)       |
+| `lastWeek`       | Kosten **letzte Woche**           |
+| `lastMonth`      | Kosten **letzter Monat**          |
+| `lastYear`       | Kosten **letztes Jahr** (Vorjahr) |
+| `averageDaily`   | Durchschnittliche Tageskosten     |
+| `averageMonthly` | Durchschnittliche Monatskosten    |
+
+#### 📅 **timestamps** (Reset-Zeitstempel)
+
+| Datenpunkt       | Beschreibung                             |
+| ---------------- | ---------------------------------------- |
+| `lastDayStart`   | Letzter Tages-Reset (23:59 Uhr)          |
+| `lastWeekStart`  | Letzter Wochen-Reset (Sonntag 23:59)     |
+| `lastMonthStart` | Letzter Monats-Reset (letzter Tag 23:59) |
+| `lastYearStart`  | Vertragsbeginn / Jahresstart             |
 
 ---
 
@@ -308,7 +359,34 @@ Der Adapter setzt Zähler automatisch zurück:
 
 ## Changelog
 
-### 1.5.0 (2026-01-23)
+### 1.6.1 (2026-01-28)
+
+- **NEU:** 📊 **Erweiterte Jahresstatistiken** - Einführung von `lastYear` Datenpunkten in den Statistiken:
+    - `statistics.consumption.lastYear`: Gesamtverbrauch des Vorjahres
+    - `statistics.cost.lastYear`: Gesamtkosten des Vorjahres
+    - Unterstützung für HT/NT und Gas-Volumen in der Vorjahresansicht
+- **NEU:** 🔄 **Automatisches Sichern** - Vorjahreswerte werden beim jährlichen Reset automatisch in die Statistik archiviert
+- **FIX:** 🛠️ **Syntax & Einheiten** - Korrektur von Einheiten-Inkonsistenzen (speziell Wasser/m³) und Linter-Fehlern
+- **DOCS:** 🌐 **Übersetzungen** - News-Einträge in alle unterstützten Sprachen übersetzt
+
+### 1.6.0 (2026-01-28)
+
+- **NEU:** 📊 **Strukturierte Statistiken** - Einführung von Unterkanälen für bessere Übersicht:
+    - `statistics.consumption`: Alle historischen Verbrauchswerte
+    - `statistics.cost`: Alle historischen Kostenwerte (Tag/Woche/Monat)
+    - `statistics.timestamps`: Alle Reset-Zeitstempel an einem Ort
+- **NEU:** 💰 **Kostenstatistiken** - Verfolge deine Kosten nun auch für gestern, letzte Woche und letzten Monat
+- **REFACTORING:** 🏗️ **Modulare State-Verwaltung**:
+    - `stateManager.js` wurde in spezialisierte Module aufgeteilt (`lib/state/`)
+    - Verbesserte Wartbarkeit und Testbarkeit
+- **CLEANUP:** 🧹 **Bereinigung** - Automatische Entfernung veralteter Statistik-Datenpunkte beim ersten Start
+
+### 1.5.1 (2026-01-26)
+
+- **FIX:** 🕛 **Reset-Timing** - Automatische Resets werden nun um 23:59 Uhr ausgeführt (statt 00:00 Uhr)
+- **FIX:** Utopische Werte in Monthly/MonthlyVolume (DP Monthly)
+
+### 1.5.0 (2026-01-25)
 
 - **NEU:** 📥 **CSV Import** - Importiere historische Zählerstände einfach per Drag-and-Drop:
     - Neuer "Import"-Tab in der Konfiguration

package/io-package.json

@@ -1,8 +1,38 @@
 {
     "common": {
         "name": "utility-monitor",
-        "version": "1.5.0",
+        "version": "1.6.1",
         "news": {
+            "1.6.1": {
+                "en": "New statistics data points: lastDay, lastWeek, lastMonth, and lastYear for costs and consumption.",
+                "de": "Neue Statistik-Datenpunkte: lastDay, lastWeek, lastMonth, lastYear für Kosten und Verbrauch.",
+                "ru": "Новые точки статистических данных: lastDay, lastWeek, lastMonth и lastYear для затрат и потребления.",
+                "pt": "Novos pontos de dados estatísticos: lastDay, lastWeek, lastMonth e lastYear para custos e consumo.",
+                "nl": "Nieuwe statistiekgegevenspunten: lastDay, lastWeek, lastMonth en lastYear voor kosten en verbruik.",
+                "fr": "Nouveaux points de données statistiques : lastDay, lastWeek, lastMonth et lastYear pour les coûts et la consommation.",
+                "it": "Nuovi punti dati statistici: lastDay, lastWeek, lastMonth e lastYear per costi e consumi.",
+                "es": "Nuevos puntos de datos estadísticos: lastDay, lastWeek, lastMonth y lastYear para costes y consumo.",
+                "pl": "Nowe punkty danych statystycznych: lastDay, lastWeek, lastMonth i lastYear dla kosztów i zużycia.",
+                "uk": "Нові статистичні дані: lastDay, lastWeek, lastMonth і lastYear для витрат і споживання.",
+                "zh-cn": "新的统计数据点：成本和消耗的 lastDay、lastWeek、lastMonth 和 lastYear。"
+            },
+            "1.6.0": {
+                "en": "New: Structured statistics with consumption and cost sub-channels. New: Weekly and monthly cost tracking. Refactoring: Split stateManager.js into modular files. Cleanup: Removed redundant old statistics states.",
+                "de": "Neu: Strukturierte Statistiken mit Unterkanälen für Verbrauch und Kosten. Neu: Wöchentliche und monatliche Kostenverfolgung. Refactoring: stateManager.js in modulare Dateien aufgeteilt. Bereinigung: Veraltete Statistik-Datenpunkte entfernt."
+            },
+            "1.5.1": {
+                "en": "Fix: Reset timing and monthly calculation logic. Fix: JSDoc type definitions.",
+                "de": "Fix: Reset-Timing und monatliche Berechnungslogik. Fix: JSDoc Typ-Definitionen.",
+                "ru": "Исправление: время сброса и логика ежемесячного расчета. Исправление: определения типов JSDoc.",
+                "pt": "Correção: tempo de redefinição e lógica de cálculo mensal. Correção: definições de tipo JSDoc.",
+                "nl": "Fix: Reset timing en maandelijkse berekeningslogica. Fix: JSDoc type definities.",
+                "fr": "Correctif : synchronisation de la réinitialisation et logique de calcul mensuel. Correctif : définitions de type JSDoc.",
+                "it": "Correzione: tempi di ripristino e logica di calcolo mensile. Correzione: definizioni dei tipi JSDoc.",
+                "es": "Solución: sincronización de reinicio y lógica de cálculo mensual. Solución: definiciones de tipos de JSDoc.",
+                "pl": "Naprawa: czas resetowania i logika obliczeń miesięcznych. Naprawa: definicje typów JSDoc.",
+                "uk": "Виправлення: час скидання та логіка щомісячного розрахунку. Виправлення: визначення типів JSDoc.",
+                "zh-cn": "修复：重置时间和每月计算逻辑。修复：JSDoc 类型定义。"
+            },
             "1.5.0": {
                 "en": "New: CSV Import feature with drag and drop support. New: Weekly tracking points. Fix: Resets now performed at 23:59. Refactoring: Modular backend architecture.",
                 "de": "Neu: CSV-Import mit Drag-and-Drop. Neu: Wöchentliche Datenpunkte. Fix: Resets werden jetzt um 23:59 Uhr ausgeführt. Refactoring: Modulare Backend-Architektur.",
@@ -15,58 +45,6 @@
                 "pl": "Nowość: funkcja importu CSV z obsługą przeciągnij i upuść. Nowość: tygodniowe punkty śledzenia. Naprawa: resety wykonywane teraz o 23:59. Refaktoryzacja: modułowa architektura backendu.",
                 "uk": "Нове: функція імпорту CSV з підтримкою перетягування. Нове: щотижневі точки відстеження. Виправлення: скидання тепер виконується о 23:59. Рефакторинг: модульна архітектура бекенда.",
                 "zh-cn": "新增：支持拖放的 CSV 导入功能。新增：每周跟踪点。修复：现在在 23:59 执行重置。重构：模块化后端架构。"
-            },
-            "1.4.7": {
-                "en": "Fix: Removed redundant initialization code causing state object warnings. Fix: Race conditions in multi-meter initialization. New: Support for German umlauts (ä,ö,ü,ß) in meter names.",
-                "de": "Fix: Redundanten Initialisierungscode entfernt, der State-Object-Warnungen verursachte. Fix: Race Conditions bei Multi-Meter-Initialisierung. Neu: Unterstützung für deutsche Umlaute (ä,ö,ü,ß) in Zählernamen.",
-                "ru": "Исправление: удален избыточный код инициализации, вызывавший предупреждения об объектах состояния. Исправление: состояния гонки при инициализации нескольких счетчиков. Новое: поддержка немецких умляутов (ä, ö, ü, ß) в названиях счетчиков.",
-                "pt": "Correção: código de inicialização redundante removido que causava avisos de objetos de estado. Correção: Condições de corrida na inicialização do multi-medidor. Novo: Suporte para tremas alemães (ä, ö, ü, ß) em nomes de medidores.",
-                "nl": "Fix: Overbodige initialisatiecode verwijderd die waarschuwingen voor staatsobjecten veroorzaakte. Fix: Race-omstandigheden bij initialisatie van meerdere meters. Nieuw: Ondersteuning voor Duitse umlauten (ä, ö, ü, ß) in meternamen.",
-                "fr": "Correction : suppression du code d'initialisation redondant provoquant des avertissements d'objet d'état. Correction : conditions de concurrence lors de l'initialisation de plusieurs compteurs. Nouveau : prise en charge des trémas allemands (ä, ö, ü, ß) dans les noms des compteurs.",
-                "it": "Correzione: rimosso il codice di inizializzazione ridondante che causava avvisi sugli oggetti di stato. Correzione: race condition nell'inizializzazione di più contatori. Nuovo: supporto per le dieresi tedesche (ä, ö, ü, ß) nei nomi dei contatori.",
-                "es": "Solución: se eliminó el código de inicialización redundante que causaba advertencias de objetos de estado. Solución: condiciones de carrera en la inicialización de múltiples medidores. Nuevo: soporte para diéresis alemanas (ä, ö, ü, ß) en nombres de medidores.",
-                "pl": "Naprawa: usunięto nadmiarowy kod inicjalizacji powodujący ostrzeżenia o obiektach stanu. Naprawa: wyścigi podczas inicjalizacji wielu liczników. Nowość: obsługa niemieckich umlautów (ä, ö, ü, ß) w nazwach liczników.",
-                "uk": "Виправлення: видалено надлишковий код ініціалізації, що викликав попередження про об'єкти стану. Виправлення: стан гонки при ініціалізації декількох лічильників. Нове: підтримка німецьких умляутів (ä, ö, ü, ß) у назвах лічильників.",
-                "zh-cn": "修复：删除了导致状态对象警告的冗余初始化代码。修复：多表初始化中的竞态条件。新增：支持仪表名称中的德语变音符号 (ä, ö, ü, ß)。"
-            },
-            "1.4.6": {
-                "en": "Breaking Change: Main meter now requires a name (default: 'main'). State paths changed from 'gas.*' to 'gas.METER_NAME.*'. All meters now use consistent naming structure.",
-                "de": "Breaking Change: Hauptzähler benötigt jetzt einen Namen (Standard: 'main'). State-Pfade geändert von 'gas.*' zu 'gas.METER_NAME.*'. Alle Zähler nutzen jetzt konsistente Namensstruktur.",
-                "ru": "Критическое изменение: для главного счетчика теперь требуется имя (по умолчанию — «main»). Пути состояний изменены с 'gas.*' на 'gas.METER_NAME.*'. Все счетчики теперь используют согласованную структуру именования.",
-                "pt": "Mudança estrutural: o medidor principal agora requer um nome (padrão: 'main'). Os caminhos de estado mudaram de 'gas.*' para 'gas.METER_NAME.*'. Todos os medidores agora usam uma estrutura de nomenclatura consistente.",
-                "nl": "Breaking Change: Hoofdmeter vereist nu een naam (standaard: 'main'). Staatspaden gewijzigd van 'gas.*' naar 'gas.METER_NAME.*'. Alle meters gebruiken nu een consistente naamstructuur.",
-                "fr": "Changement radical : le compteur principal nécessite désormais un nom (par défaut : 'main'). Les chemins d'état sont passés de 'gas.*' à 'gas.METER_NAME.*'. Tous los compteurs utilisent désormais une structure de dénomination cohérente.",
-                "it": "Cambiamento radicale: il contatore principale ora richiede un nome (predefinito: 'main'). I percorsi di stato sono cambiati da 'gas.*' a 'gas.METER_NAME.*'. Tutti i contatori ora utilizzano una struttura di denominazione coerente.",
-                "es": "Cambio importante: el medidor principal ahora requiere un nombre (predeterminado: 'main'). Las rutas de estado cambiaron de 'gas.*' na 'gas.METER_NAME.*'. Todos los medidores ahora utilizan una estructura de nombres consistente.",
-                "pl": "Przełomowa zmiana: licznik główny wymaga teraz nazwy (domyślnie „main”). Ścieżki stanów zmieniły się z „gas.*” na „gas.METER_NAME.*”. Wszystkie liczniki używają teraz spójnej struktury nazewnictwa.",
-                "uk": "Критична зміна: для головного лічильника тепер потрібна назва (за замовчуванням — «main»). Шляхи статусів змінено з 'gas.*' на 'gas.METER_NAME.*'. Тепер усі лічильники використовують єдину структуру назв.",
-                "zh-cn": "重大更改：主表现在需要一个名称（默认值：'main'）。状态路径从 'gas.*' 更改为 'gas.METER_NAME.*'。所有计量表现在都使用一致的命名结构。"
-            },
-            "1.4.5": {
-                "en": "Fix: Critical multi-meter cost calculation bugs (main meter sync, basicCharge/paidTotal accumulation, annualFee as fixed yearly value). Fix: Balance formula corrected. Fix: Removed duplicate initialization causing sync issues.",
-                "de": "Fix: Kritische Multi-Meter Kostenberechnungsfehler (Hauptzähler-Sync, basicCharge/paidTotal Akkumulation, Jahresgebühr als fester Jahreswert). Fix: Balance-Formel korrigiert. Fix: Doppelte Initialisierung entfernt.",
-                "ru": "Исправление: Критические ошибки расчета затрат multi-meter (синхронизация главного счетчика, накопление basicCharge/paidTotal, annualFee как фиксированное годовое значение). Исправление: Формула баланса исправлена. Исправление: Удалена дублирующая инициализация.",
-                "pt": "Correção: Bugs críticos de cálculo de custos multi-medidor (sincronização medidor principal, acumulação basicCharge/paidTotal, annualFee como valor anual fixo). Correção: Fórmula de saldo corrigida. Correção: Inicialização duplicada removida.",
-                "nl": "Fix: Kritieke multi-meter kostenberekeningsfouten (hoofdmeter sync, basicCharge/paidTotal accumulatie, annualFee als vaste jaarwaarde). Fix: Balans formule gecorrigeerd. Fix: Dubbele initialisatie verwijderd.",
-                "fr": "Correction: Bugs critiques calcul coûts multi-compteurs (sync compteur principal, accumulation basicCharge/paidTotal, annualFee comme valeur annuelle fixe). Correction: Formule de solde corrigée. Correction: Initialisation en double supprimée.",
-                "it": "Correzione: Bug critici calcolo costi multi-contatore (sync contatore principale, accumulazione basicCharge/paidTotal, annualFee come valore annuale fisso). Correzione: Formula bilancio corretta. Correzione: Inizializzazione duplicata rimossa.",
-                "es": "Corrección: Bugs críticos cálculo costos multi-medidor (sincronización medidor principal, acumulación basicCharge/paidTotal, annualFee como valor anual fijo). Corrección: Fórmula balance corregida. Corrección: Inicialización duplicada eliminada.",
-                "pl": "Naprawa: Krytyczne błędy obliczania kosztów multi-meter (synchronizacja głównego licznika, akumulacja basicCharge/paidTotal, annualFee jako stała wartość roczna). Naprawa: Formuła salda poprawiona. Naprawa: Usunięto podwójną inicjalizację.",
-                "uk": "Виправлення: Критичні помилки розрахунку витрат multi-meter (синхронізація головного лічильника, накопичення basicCharge/paidTotal, annualFee як фіксоване річне значення). Виправлення: Формула балансу виправлена. Виправлення: Видалено подвійну ініціалізацію.",
-                "zh-cn": "修复：关键多表成本计算错误（主表同步、basicCharge/paidTotal累积、annualFee作为固定年值）。修复：余额公式已更正。修复：删除重复初始化。"
-            },
-            "1.4.2": {
-                "en": "Fix: Critical multi-meter balance bug (hardcoded 12 months). Fix: TypeScript errors resolved. New: Enhanced input validation. New: Extended constants. New: Error handling wrapper.",
-                "de": "Fix: Kritischer Multi-Meter Balance-Bug (hardcodierte 12 Monate). Fix: TypeScript-Fehler behoben. Neu: Erweiterte Eingabevalidierung. Neu: Erweiterte Konstanten. Neu: Fehlerbehandlungs-Wrapper.",
-                "ru": "Исправление: Критическая ошибка баланса multi-meter (жестко заданные 12 месяцев). Исправление: Устранены ошибки TypeScript. Новое: Расширенная проверка входных данных. Новое: Расширенные константы. Новое: Обработка ошибок.",
-                "pt": "Correção: Bug crítico de saldo multi-medidor (12 meses fixos). Correção: Erros TypeScript resolvidos. Novo: Validação de entrada aprimorada. Novo: Constantes estendidas. Novo: Wrapper de tratamento de erros.",
-                "nl": "Fix: Kritieke multi-meter balans bug (hardcoded 12 maanden). Fix: TypeScript-fouten opgelost. Nieuw: Verbeterde invoervalidatie. Nieuw: Uitgebreide constanten. Nieuw: Foutafhandeling wrapper.",
-                "fr": "Correction: Bug critique de solde multi-compteurs (12 mois codés en dur). Correction: Erreurs TypeScript résolues. Nouveau: Validation d'entrée améliorée. Nouveau: Constantes étendues. Nouveau: Wrapper de gestion des erreurs.",
-                "it": "Correzione: Bug critico bilancio multi-contatore (12 mesi hardcoded). Correzione: Errori TypeScript risolti. Nuovo: Validazione input migliorata. Nuovo: Costanti estese. Nuovo: Wrapper gestione errori.",
-                "es": "Corrección: Bug crítico de saldo multi-medidor (12 meses fijos). Corrección: Errores TypeScript resueltos. Nuevo: Validación de entrada mejorada. Nuevo: Constantes extendidas. Nuevo: Wrapper manejo errores.",
-                "pl": "Naprawa: Krytyczny błąd salda multi-meter (zakodowane 12 miesięcy). Naprawa: Naprawione błędy TypeScript. Nowe: Ulepszona walidacja danych. Nowe: Rozszerzone stałe. Nowe: Wrapper obsługi błędów.",
-                "uk": "Виправлення: Критична помилка балансу multi-meter (жорстко задані 12 місяців). Виправлення: Усунено помилки TypeScript. Нове: Покращена перевірка даних. Нове: Розширені константи. Нове: Обробник помилок.",
-                "zh-cn": "修复：关键多表余额错误（硬编码12个月）。修复：解决TypeScript错误。新增：增强输入验证。新增：扩展常量。新增：错误处理包装器。"
             }
         },
         "titleLang": {