iobroker.utility-monitor 1.4.4 → 1.4.6

package/README.md

@@ -61,10 +61,55 @@ Gefällt dir dieser Adapter? Du kannst mich gerne mit einem Kaffee unterstützen
 
 ---
 
+## ⚠️ Breaking Changes in Version 1.4.6
+
+**WICHTIG:** Version 1.4.6 ändert die State-Struktur grundlegend!
+
+### Was hat sich geändert?
+
+**Vorher (bis 1.4.5):**
+```
+gas.consumption.daily
+gas.costs.monthly
+wasser.consumption.daily
+```
+
+**Jetzt (ab 1.4.6):**
+```
+gas.main.consumption.daily          ← Hauptzähler mit Namen "main"
+gas.main.costs.monthly
+wasser.main.consumption.daily
+```
+
+### 🔧 Migration erforderlich
+
+1. **Config öffnen**: Neue Felder "Name des Hauptzählers" für Gas/Wasser/Strom/PV
+2. **Namen eingeben**: Standard ist "main" (empfohlen), oder eigener Name wie "wohnung", "haus"
+3. **Skripte anpassen**: Alle Verweise auf States müssen angepasst werden
+   ```javascript
+   // Alt:
+   getState('utility-monitor.0.gas.consumption.daily')
+
+   // Neu:
+   getState('utility-monitor.0.gas.main.consumption.daily')
+   ```
+4. **Visualisierungen updaten**: VIS, Grafana, etc. auf neue Pfade anpassen
+
+### 💡 Warum diese Änderung?
+
+- **Konsistenz**: Alle Zähler (Haupt + Zusätzlich) verwenden jetzt die gleiche Struktur
+- **Flexibilität**: Hauptzähler kann jetzt frei benannt werden (z.B. "erdgeschoss", "gesamt")
+- **Klarheit**: Keine Special-Case Logik mehr im Code
+- **Multi-Meter**: Bessere Unterstützung für mehrere Zähler pro Typ
+
+---
+
 ## 📊 Datenpunkte erklärt
 
 Für jede aktivierte Verbrauchsart (Gas/Wasser/Strom/PV) werden folgende Ordner angelegt:
 
+**Wichtig:** Seit Version 1.4.6 beinhalten alle Pfade den Zähler-Namen (z.B. `gas.main.*` statt `gas.*`)
+
 ### 🗂️ **consumption** (Verbrauch)
 
 | Datenpunkt      | Beschreibung                                          | Beispiel         |
@@ -96,11 +141,11 @@ Für jede aktivierte Verbrauchsart (Gas/Wasser/Strom/PV) werden folgende Ordner
 | `daily`       | Kosten **heute**                                              | daily × Arbeitspreis                       | 2,27 €                         |
 | `monthly`     | Kosten **diesen Monat**                                       | monthly × Arbeitspreis                     | 21,61 €                        |
 | `yearly`      | **Verbrauchskosten** seit Vertragsbeginn                      | yearly × Arbeitspreis                      | 137,61 €                       |
-| `totalYearly` | **Gesamtkosten Jahr** (Verbrauch + alle Fixkosten)            | yearly-cost + basicCharge + annualFee      | 162,64 €                       |
-| `basicCharge` | **Grundgebühr akkumuliert** (inkl. Jahresgebühr anteilig)     | (Grundgebühr + (Jahresgebühr/12)) × Monate | 19,20 €                        |
-| `annualFee`   | **Jahresgebühr akkumuliert**                                  | (Jahresgebühr / 12) × Monate               | 4,17 €                         |
+| `totalYearly` | **Gesamtkosten Jahr** (Verbrauch + alle Fixkosten)            | yearly-cost + basicCharge + annualFee      | 212,64 €                       |
+| `basicCharge` | **Grundgebühr akkumuliert**                                   | Grundgebühr × Monate                       | 15,03 €                        |
+| `annualFee`   | **Jahresgebühr** (fester Wert pro Jahr)                       | Jahresgebühr (aus Config)                  | 60,00 €                        |
 | `paidTotal`   | **Bezahlt** via Abschlag                                      | Abschlag × Monate                          | 150,00 €                       |
-| `balance`     | **🎯 WICHTIGSTER Wert!**<br>Nachzahlung (+) oder Guthaben (-) | totalYearly - paidTotal                    | **+12,64 €**<br>→ Nachzahlung! |
+| `balance`     | **🎯 WICHTIGSTER Wert!**<br>Nachzahlung (+) oder Guthaben (-) | totalYearly - paidTotal                    | **+62,64 €**<br>→ Nachzahlung! |
 
 #### 🔍 **balance** genauer erklärt:
 
@@ -112,13 +157,14 @@ Für jede aktivierte Verbrauchsart (Gas/Wasser/Strom/PV) werden folgende Ordner
 
 ```
 Verbrauchskosten:  137,61 € (yearly)
-Grundgebühr:      + 15,03 € (basicCharge)
+Grundgebühr:      + 15,03 € (basicCharge - 1 Monat × 15,03€)
+Jahresgebühr:     + 60,00 € (annualFee - fester Wert)
 ────────────────────────────
-Gesamtkosten:      152,64 €
+Gesamtkosten:      212,64 € (totalYearly)
 
-Bezahlt (Abschlag): 150,00 € (paidTotal)
+Bezahlt (Abschlag): 150,00 € (paidTotal - 1 Monat × 150€)
 ────────────────────────────
-Balance:           +2,64 € → Nachzahlung
+Balance:           +62,64 € → Nachzahlung
 ```
 
 ---
@@ -228,23 +274,47 @@ Der Adapter setzt Zähler automatisch zurück:
 
 ## Changelog
 
-### **WORK IN PROGRESS**
-
-### 1.4.4 (2026-01-18)
-
-- **FIX:** 🐛 **lastYearStart Recalculation Bug** - Fixed incorrect month count in paidTotal:
-    - `lastYearStart` is now always recalculated from `contractStart` on adapter initialization
-    - Fixes cases where `lastYearStart` was set incorrectly (e.g., 01.01.2026 instead of contract date)
-    - Ensures `monthsSinceYearStart` is always calculated correctly based on actual contract date
-    - Resolves issue where `paidTotal` showed only 1 month payment instead of correct accumulated amount
-
-### 1.4.3 (2026-01-18)
-
-- **FIX:** 🐛 **Critical paidTotal Calculation Bug** - Fixed incorrect paidTotal after sensor updates:
-    - `paidTotal` was stored as string instead of timestamp, causing parsing errors in `updateCosts()`
-    - Changed `lastYearStart`, `lastMonthStart`, `lastDayStart` to store timestamps (number) instead of formatted strings
-    - Now correctly calculates `paidTotal = monthlyPayment × monthsSinceYearStart` for both adapter restart and sensor updates
-    - Backward compatible: existing string values auto-convert to timestamps on next update
+### 1.4.6 (2026-01-20)
+
+- **⚠️ BREAKING CHANGE:** 🔄 **Main Meter Naming** - Hauptzähler benötigt jetzt einen Namen:
+    - **State-Pfade geändert**: `gas.*` → `gas.METER_NAME.*` (z.B. `gas.main.*`)
+    - **Neue Config-Felder**: "Name des Hauptzählers" für Gas/Wasser/Strom/PV
+    - **Default-Name**: "main" (wird automatisch verwendet wenn leer gelassen)
+    - **Konsistente Struktur**: Alle Zähler (Haupt + Zusätzlich) verwenden jetzt `type.meterName.*`
+    - **Flexibilität**: Hauptzähler kann jetzt frei benannt werden (z.B. "wohnung", "erdgeschoss", "gesamt")
+    - **Keine Special-Cases**: Vereinfachter Code ohne `meterName === 'main'` Bedingungen
+- **NEW:** 🔔 **Smart Notifications** - Zählerauswahl für Benachrichtigungen:
+    - Wähle pro Utility-Typ aus, welche Zähler benachrichtigt werden sollen
+    - Multi-Select Dropdown zeigt alle konfigurierten Zähler
+    - Wenn leer: Alle Zähler werden benachrichtigt (Standard)
+    - Wenn ausgewählt: Nur gewählte Zähler erhalten Benachrichtigungen
+    - Gilt für Abrechnungsende, Vertragswechsel und monatliche Berichte
+- **IMPROVED:** 🏗️ **Code-Architektur** - Entfernung von 19 Special-Case Checks in 7 Dateien:
+    - Vereinfachte basePath-Berechnungen in multiMeterManager, billingManager, stateManager
+    - Vereinheitlichter Config-Zugriff (alle Meter nutzen `meter.config.contractStart`)
+    - HT/NT-Logik basiert jetzt auf `config.htNtEnabled` statt Meter-Name
+    - Button-Trigger erkennt nur noch einheitliche Pfadstruktur
+    - Legacy-Code entfernt: updateBillingCountdown, updateCurrentPrice jetzt per-meter
+- **MIGRATION:** 📋 **Upgrade-Hinweise**:
+    - Bei Neuinstallation: Namen für Hauptzähler eingeben (oder "main" akzeptieren)
+    - Bei Upgrade: Adapter neu konfigurieren + Skripte/Visualisierungen anpassen
+    - History: Alte States bleiben erhalten, neue States werden parallel erstellt
+    - Empfehlung: "main" als Namen verwenden für einfachere Migration
+
+### 1.4.5 (2026-01-20)
+
+- **FIX:** 🐛 **Critical Multi-Meter Cost Calculation Bugs** - Comprehensive fixes for multi-meter functionality:
+    - **Main Meter Sync Issue**: Removed duplicate initialization that prevented `lastSync` updates on main meter
+    - **basicCharge Accumulation**: Now correctly calculates `basicCharge = grundgebuehr × months` (was showing only 1 month)
+    - **paidTotal Accumulation**: Now correctly calculates `paidTotal = abschlag × months` (was showing only 1 month)
+    - **annualFee as Fixed Value**: Jahresgebühr is now used as fixed yearly value (e.g., 60€ stays 60€)
+      - Previously incorrectly treated as monthly fee and multiplied by months
+      - User-entered value in config (e.g., 60€) is now used directly as intended
+    - **Balance Formula Corrected**: Fixed reversed formula `balance = totalYearly - paidTotal`
+      - Positive balance = Nachzahlung (you owe money)
+      - Negative balance = Guthaben (you get money back)
+- **IMPROVED:** 📦 **Dev-Dependencies**: Updated from tilde (~) to caret (^) versioning for better security updates
+- **CLEANUP:** 🧹 **Repository Compliance**: Removed unpublished versions from changelog (resolves ioBroker Bot Issue #1)
 
 ### 1.4.2 (2026-01-18)
 
@@ -268,44 +338,6 @@ Der Adapter setzt Zähler automatisch zurück:
     - Prevents silent failures in StateManager
 - **IMPROVED:** 🧪 **Code Quality** - All tests passing (31 unit + 57 package tests)
 
-### 1.4.1 (2026-01-18)
-
-- **FIX:** 🐛 **Multi-Meter Critical Bugs** - Comprehensive fixes for multi-meter functionality:
-    - Fixed `updateCosts()` to correctly delegate to multiMeterManager for all meters
-    - Fixed `closeBillingPeriod()` to archive totals instead of only main meter values
-    - Fixed `checkMonthlyReport()` to display totals in reports for multi-meter setups
-    - Fixed state type mismatch: `lastDayStart`, `lastMonthStart`, `lastYearStart` now use number (timestamp) instead of string
-- **NEW:** 🎯 **Per-Meter Billing Closure** - Each meter can now be closed individually with its own `billing.closePeriod` button
-    - Main meter: `gas.billing.closePeriod`
-    - Additional meters: `gas.erdgeschoss.billing.closePeriod`, `gas.keller.billing.closePeriod`, etc.
-    - Each meter uses its own contract date for yearly resets
-- **NEW:** 📅 **Individual Contract Anniversary Resets** - Each meter resets on its own contract date
-    - Primary: Manual `closePeriod` triggers yearly reset immediately
-    - Fallback: Automatic reset on contract anniversary if user forgets to close period
-    - Contract date is preserved when closing period early (no drift)
-- **IMPROVED:** 💰 **Billing Period Closure** - No longer resets `basicCharge` and `annualFee` to zero
-    - These values now persist from config (user must update config if tariff changes)
-    - Helpful reminder message added after closing period
-- **FIX:** 🤖 **ioBroker Bot Compliance** - All bot checker issues resolved:
-    - Removed non-existent version 1.3.4 from news
-    - Added complete translations for all news entries (9 languages)
-    - Removed `.npmignore` file (using `files` field in package.json)
-    - DevDependencies already use `~` syntax (compliant)
-
-### 1.4.0 (2026-01-17)
-
-- **NEW:** 🎉 **Multi-Meter Support** - Verwende mehrere Zähler pro Typ (z.B. Gas Hauptzähler + Werkstatt-Zähler)
-    - Beliebig viele zusätzliche Zähler mit eigenen Namen konfigurierbar
-    - Separate Kostenberechnung und Statistiken pro Zähler
-    - Automatische Totals-Berechnung über alle Zähler
-- **NEW:** ✨ **Komma-Dezimaltrenner Support** - Admin UI akzeptiert jetzt sowohl Komma als auch Punkt (z.B. `12,50` oder `12.50`)
-- **NEW:** 📊 **Pro-Meter Billing** - Jeder Zähler hat eigene `billing.daysRemaining` und `billing.periodEnd` Werte
-- **NEW:** 🔧 **Config-Parser** - Automatische Konvertierung von String→Number mit Komma-Support
-- **FIX:** 💰 **Balance-Berechnung korrigiert** - Nutzt jetzt begonnene Monate statt volle Monate (17 Tage = 1 Monat gezahlt)
-- **FIX:** 🐛 **String-Type Fehler** behoben - Config-Werte werden korrekt als Numbers verarbeitet
-- **IMPROVED:** 🔍 **Debug-Logging** - Hilfreiche Debug-Logs für Troubleshooting (nur in Debug-Modus sichtbar)
-- **CLEANUP:** 🧹 Repository aufgeräumt - Alte Backup-Dateien und temporäre Scripts entfernt
-
 ---
 
 ## License

package/admin/jsonConfig.json

@@ -21,6 +21,19 @@
                     "lg": 6,
                     "xl": 6
                 },
+                "gasMainMeterName": {
+                    "type": "text",
+                    "label": "📝 Name des Hauptzählers",
+                    "placeholder": "z.B. main, wohnung, haus, gesamt",
+                    "help": "Technischer Name für den Hauptzähler. Wird Teil des State-Pfads (gas.DIESER_NAME.*). Nur Kleinbuchstaben und Zahlen, max 20 Zeichen.",
+                    "default": "main",
+                    "hidden": "!data.gasAktiv",
+                    "sm": 12,
+                    "md": 6,
+                    "xs": 12,
+                    "lg": 6,
+                    "xl": 4
+                },
                 "_gasSensorHeader": {
                     "type": "header",
                     "text": "Sensor-Konfiguration",
@@ -451,6 +464,19 @@
                     "lg": 6,
                     "xl": 6
                 },
+                "wasserMainMeterName": {
+                    "type": "text",
+                    "label": "📝 Name des Hauptzählers",
+                    "placeholder": "z.B. main, wohnung, haus, gesamt",
+                    "help": "Technischer Name für den Hauptzähler. Wird Teil des State-Pfads (wasser.DIESER_NAME.*). Nur Kleinbuchstaben und Zahlen, max 20 Zeichen.",
+                    "default": "main",
+                    "hidden": "!data.wasserAktiv",
+                    "sm": 12,
+                    "md": 6,
+                    "xs": 12,
+                    "lg": 6,
+                    "xl": 4
+                },
                 "_wasserSensorHeader": {
                     "type": "header",
                     "text": "Sensor-Konfiguration",
@@ -745,6 +771,19 @@
                     "lg": 6,
                     "xl": 6
                 },
+                "stromMainMeterName": {
+                    "type": "text",
+                    "label": "📝 Name des Hauptzählers",
+                    "placeholder": "z.B. main, wohnung, haus, gesamt",
+                    "help": "Technischer Name für den Hauptzähler. Wird Teil des State-Pfads (strom.DIESER_NAME.*). Nur Kleinbuchstaben und Zahlen, max 20 Zeichen.",
+                    "default": "main",
+                    "hidden": "!data.stromAktiv",
+                    "sm": 12,
+                    "md": 6,
+                    "xs": 12,
+                    "lg": 6,
+                    "xl": 4
+                },
                 "_stromSensorHeader": {
                     "type": "header",
                     "text": "Sensor-Konfiguration",
@@ -1132,6 +1171,19 @@
                     "lg": 6,
                     "xl": 6
                 },
+                "pvMainMeterName": {
+                    "type": "text",
+                    "label": "📝 Name des Hauptzählers",
+                    "placeholder": "z.B. main, einspeisung, pv",
+                    "help": "Technischer Name für den Hauptzähler. Wird Teil des State-Pfads (pv.DIESER_NAME.*). Nur Kleinbuchstaben und Zahlen, max 20 Zeichen.",
+                    "default": "main",
+                    "hidden": "!data.pvAktiv",
+                    "sm": 12,
+                    "md": 6,
+                    "xs": 12,
+                    "lg": 6,
+                    "xl": 4
+                },
                 "_pvSensorHeader": {
                     "type": "header",
                     "text": "Sensor-Konfiguration",
@@ -1423,6 +1475,20 @@
                     "lg": 4,
                     "xl": 4
                 },
+                "notificationGasMeters": {
+                    "type": "selectSendTo",
+                    "label": "Welche Gas-Zähler benachrichtigen?",
+                    "command": "getMeters",
+                    "jsonData": "{\"type\": \"gas\"}",
+                    "multiple": true,
+                    "help": "Wähle die Zähler aus, für die du Benachrichtigungen erhalten möchtest. Wenn leer, werden ALLE Zähler benachrichtigt.",
+                    "hidden": "!data.notificationEnabled || !data.notificationGasEnabled || !data.gasAktiv",
+                    "sm": 12,
+                    "md": 8,
+                    "xs": 12,
+                    "lg": 8,
+                    "xl": 8
+                },
                 "notificationWasserEnabled": {
                     "type": "checkbox",
                     "label": "Wasser-Erinnerung",
@@ -1433,6 +1499,20 @@
                     "lg": 4,
                     "xl": 4
                 },
+                "notificationWasserMeters": {
+                    "type": "selectSendTo",
+                    "label": "Welche Wasser-Zähler benachrichtigen?",
+                    "command": "getMeters",
+                    "jsonData": "{\"type\": \"water\"}",
+                    "multiple": true,
+                    "help": "Wähle die Zähler aus, für die du Benachrichtigungen erhalten möchtest. Wenn leer, werden ALLE Zähler benachrichtigt.",
+                    "hidden": "!data.notificationEnabled || !data.notificationWasserEnabled || !data.wasserAktiv",
+                    "sm": 12,
+                    "md": 8,
+                    "xs": 12,
+                    "lg": 8,
+                    "xl": 8
+                },
                 "notificationStromEnabled": {
                     "type": "checkbox",
                     "label": "Strom-Erinnerung",
@@ -1443,6 +1523,20 @@
                     "lg": 4,
                     "xl": 4
                 },
+                "notificationStromMeters": {
+                    "type": "selectSendTo",
+                    "label": "Welche Strom-Zähler benachrichtigen?",
+                    "command": "getMeters",
+                    "jsonData": "{\"type\": \"electricity\"}",
+                    "multiple": true,
+                    "help": "Wähle die Zähler aus, für die du Benachrichtigungen erhalten möchtest. Wenn leer, werden ALLE Zähler benachrichtigt.",
+                    "hidden": "!data.notificationEnabled || !data.notificationStromEnabled || !data.stromAktiv",
+                    "sm": 12,
+                    "md": 8,
+                    "xs": 12,
+                    "lg": 8,
+                    "xl": 8
+                },
                 "notificationPVEnabled": {
                     "type": "checkbox",
                     "label": "PV-Erinnerung",
@@ -1452,40 +1546,20 @@
                     "xs": 12,
                     "lg": 4,
                     "xl": 4
-                }
-            }
-        },
-        "tabImport": {
-            "type": "panel",
-            "label": "📥 Import",
-            "items": {
-                "_importInfo": {
-                    "type": "header",
-                    "text": "CSV-Daten importieren",
-                    "size": 3
                 },
-                "_importLink": {
-                    "type": "staticLink",
-                    "label": "🚀 Import-Seite öffnen",
-                    "button": true,
-                    "variant": "contained",
-                    "color": "primary",
-                    "href": "/adapter/utility-monitor/tab-import.html",
-                    "target": "_blank",
-                    "sm": 12,
-                    "md": 6,
-                    "lg": 4
-                },
-                "_importDescription": {
-                    "type": "staticText",
-                    "text": "Klicke auf den Button oben, um die Import-Seite in einem neuen Tab zu öffnen. Dort kannst du CSV-Dateien mit historischen Zählerständen hochladen.",
-                    "newLine": true,
+                "notificationPVMeters": {
+                    "type": "selectSendTo",
+                    "label": "Welche PV-Zähler benachrichtigen?",
+                    "command": "getMeters",
+                    "jsonData": "{\"type\": \"pv\"}",
+                    "multiple": true,
+                    "help": "Wähle die Zähler aus, für die du Benachrichtigungen erhalten möchtest. Wenn leer, werden ALLE Zähler benachrichtigt.",
+                    "hidden": "!data.notificationEnabled || !data.notificationPVEnabled || !data.pvAktiv",
                     "sm": 12,
-                    "style": {
-                        "fontSize": "0.9em",
-                        "color": "#666",
-                        "marginTop": "20px"
-                    }
+                    "md": 8,
+                    "xs": 12,
+                    "lg": 8,
+                    "xl": 8
                 }
             }
         },
@@ -1495,12 +1569,12 @@
             "items": {
                 "_infoHeader": {
                     "type": "header",
-                    "text": "Utility Monitor",
+                    "text": "Nebenkosten-Monitor",
                     "size": 3
                 },
                 "_infoVersion": {
                     "type": "staticText",
-                    "text": "**Version:** 1.4.4\n\n**Autor:** fischi87",
+                    "text": "**Version:** 1.4.6\n\n**Autor:** fischi87\n\n⚠️ **Breaking Change in v1.4.6:** State-Pfade haben sich geändert! Siehe unten.",
                     "sm": 12,
                     "xs": 12,
                     "md": 12,
@@ -1509,7 +1583,7 @@
                 },
                 "donation": {
                     "type": "staticText",
-                    "text": "☕ [PayPal Spenden](https://paypal.me/bigplay87) | 📁 [GitHub Repository](https://github.com/fischi87/ioBroker.utility-monitor)",
+                    "text": "☕ [PayPal Spenden](https://paypal.me/bigplay87) | 📁 [GitHub Repository](https://github.com/fischi87/ioBroker.nebenkosten-monitor)",
                     "xs": 12,
                     "sm": 12,
                     "md": 12,
@@ -1526,7 +1600,7 @@
                 },
                 "_features": {
                     "type": "staticText",
-                    "text": "📊 **Verbrauchsüberwachung** - Gas, Wasser, Strom & PV/Einspeisung\n\n💰 **Automatische Kostenberechnung** - Mit Arbeitspreis & Grundgebühren\n\n☀️ **PV-Integration** - Überwachung von Einspeisung & Vergütung\n\n💳 **Abschlagsüberwachung** - Direkter Vergleich: Bezahlt vs. Verbraucht\n\n🔄 **Gas-Spezial** - Automatische m³ zu kWh Umrechnung\n\n⚡ **HT/NT-Unterstützung** - Volle Unterstützung für Doppeltarife\n\n📅 **Jahres-Historie** - Automatische Archivierung zum Vertragsbeginn",
+                    "text": "📊 **Verbrauchsüberwachung** - Gas, Wasser, Strom & PV/Einspeisung\n\n🔢 **Multi-Meter Support** *(NEU in 1.4.6)* - Mehrere Zähler pro Typ (z.B. Haus + Werkstatt)\n\n📛 **Konfigurierbare Namen** *(NEU in 1.4.6)* - Gib jedem Zähler einen individuellen Namen\n\n💰 **Automatische Kostenberechnung** - Mit Arbeitspreis & Grundgebühren\n\n☀️ **PV-Integration** - Überwachung von Einspeisung & Vergütung\n\n💳 **Abschlagsüberwachung** - Direkter Vergleich: Bezahlt vs. Verbraucht\n\n🔄 **Gas-Spezial** - Automatische m³ zu kWh Umrechnung\n\n⚡ **HT/NT-Unterstützung** - Volle Unterstützung für Doppeltarife\n\n📅 **Jahres-Historie** - Automatische Archivierung zum Vertragsbeginn\n\n🔔 **Smart Notifications** - Wähle für welche Zähler du benachrichtigt werden möchtest",
                     "sm": 12,
                     "xs": 12,
                     "md": 12,
@@ -1536,14 +1610,31 @@
                 "_divider2": {
                     "type": "divider"
                 },
+                "_breakingHeader": {
+                    "type": "header",
+                    "text": "⚠️ Breaking Changes v1.4.6",
+                    "size": 4
+                },
+                "_breakingChanges": {
+                    "type": "staticText",
+                    "text": "**State-Pfade haben sich geändert:**\n\n**Vorher:** `gas.consumption.daily`, `gas.costs.yearly`\n\n**Neu:** `gas.METER_NAME.consumption.daily`, `gas.METER_NAME.costs.yearly`\n\n**Standardname:** Wenn du keinen Namen vergibst, wird automatisch \"main\" verwendet.\n\n**Was du tun musst:**\n• Skripte anpassen die States verwenden\n• Visualisierungen (VIS, Grafana) aktualisieren\n• History-Adapter neu konfigurieren\n\n**Mehrere Zähler:** Bei mehreren Zählern wird automatisch eine `totals/` Struktur mit Summen erstellt.",
+                    "sm": 12,
+                    "xs": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "_divider2a": {
+                    "type": "divider"
+                },
                 "_usageHeader": {
                     "type": "header",
-                    "text": "Benachrichtigungen (Neu)",
+                    "text": "📬 Benachrichtigungen",
                     "size": 4
                 },
                 "_usage": {
                     "type": "staticText",
-                    "text": "**1. Abrechnungsende** 📅\n• Erinnert dich (z.B. 7 Tage vorher) daran, den Zählerstand abzulesen und den Zeitraum abzuschließen.\n\n**2. Vertragswechsel** 📋\n• Erinnert dich frühzeitig (z.B. 60 Tage vorher) daran, Tarife zu vergleichen oder die Kündigungsfrist zu prüfen.\n\n**3. Monatlicher Bericht** 📈\n• Optionaler Status-Bericht am 1. jedes Monats via Benachrichtigung.\n\n**💡 Tipp:** Nutze den **Test-Button** zum Prüfen deiner Einstellungen. Du bekommst sofort ein Popup mit dem Ergebnis!",
+                    "text": "**1. Abrechnungsende** 📅\n• Erinnert dich (z.B. 7 Tage vorher) daran, den Zählerstand abzulesen und den Zeitraum abzuschließen.\n\n**2. Vertragswechsel** 📋\n• Erinnert dich frühzeitig (z.B. 60 Tage vorher) daran, Tarife zu vergleichen oder die Kündigungsfrist zu prüfen.\n\n**3. Monatlicher Bericht** 📈\n• Optionaler Status-Bericht am 1. jedes Monats via Benachrichtigung.\n\n**4. Zählerauswahl** 🎯 *(NEU in 1.4.6)*\n• Wähle aus, für welche Zähler du Benachrichtigungen erhalten möchtest\n• Wenn leer: Alle Zähler werden benachrichtigt\n\n**💡 Tipp:** Nutze den **Test-Button** zum Prüfen deiner Einstellungen. Du bekommst sofort ein Popup mit dem Ergebnis!",
                     "sm": 12,
                     "xs": 12,
                     "md": 12,
@@ -1560,7 +1651,7 @@
                 },
                 "_statesInfo": {
                     "type": "staticText",
-                    "text": "**📅 billing/** (Abrechnung)\n• **daysRemaining** - Tage bis zum Ende\n• **closePeriod** - Button zum Abschluss\n\n**💰 costs/** (Kosten)\n• **balance** - 🎯 Aktuelle Bilanz (Guthaben/Nachzahlung)\n• **totalYearly** - Prognose Gesamtkosten inkl. Gebühren\n\n**📈 statistics/** (Statistiken)\n• **lastDay** - Verbrauch gestern (kWh)\n• **lastDayVolume** - Verbrauch gestern in m³ (Gas)\n\n**☀️ PV / Einspeisung**\n• **earnings.totalYearly** - Akkumulierte Vergütung\n• **consumption.yearly** - Gesamte Einspeisung",
+                    "text": "**⚠️ Neue Struktur ab v1.4.6:**\n\nAlle Datenpunkte sind jetzt unter `TYPE.METER_NAME.*` zu finden!\n\n**Beispiel Single-Meter:**\n• `gas.main.consumption.daily`\n• `gas.main.costs.totalYearly`\n• `gas.main.billing.closePeriod`\n\n**Beispiel Multi-Meter:**\n• `gas.haus.consumption.yearly` ← Zähler 1\n• `gas.werkstatt.consumption.yearly` ← Zähler 2\n• `gas.totals.consumption.yearly` ← Summe\n\n**📅 billing/** (Abrechnung)\n• **daysRemaining** - Tage bis zum Vertragsende\n• **closePeriod** - Button zum Zeitraum-Abschluss\n• **endReading** - Hier Endzählerstand eintragen\n\n**💰 costs/** (Kosten)\n• **balance** - Aktuelle Bilanz (Nachzahlung/Guthaben)\n• **totalYearly** - Gesamtkosten inkl. Gebühren\n• **yearly** - Nur Verbrauchskosten\n\n**📈 statistics/** (Statistiken)\n• **lastDay** - Gestern-Verbrauch\n• **averageDaily** - Durchschnitt pro Tag\n• **averageMonthly** - Durchschnitt pro Monat",
                     "sm": 12,
                     "xs": 12,
                     "md": 12,

package/io-package.json

@@ -1,33 +1,24 @@
 {
     "common": {
         "name": "utility-monitor",
-        "version": "1.4.4",
+        "version": "1.4.6",
         "news": {
-            "1.4.4": {
-                "en": "Fix: lastYearStart now always recalculated from contract date on adapter start - fixes wrong month count in paidTotal",
-                "de": "Fix: lastYearStart wird jetzt immer aus Vertragsbeginn neu berechnet - behebt falsche Monatszahl in paidTotal",
-                "ru": "Исправление: lastYearStart теперь всегда пересчитывается из даты договора при запуске - исправляет неправильный подсчет месяцев в paidTotal",
-                "pt": "Correção: lastYearStart agora sempre recalculado da data do contrato na inicialização - corrige contagem incorreta de meses em paidTotal",
-                "nl": "Fix: lastYearStart nu altijd herberekend vanaf contractdatum bij start - lost onjuiste maandtelling in paidTotal op",
-                "fr": "Correction: lastYearStart maintenant toujours recalculé à partir de la date du contrat au démarrage - corrige le comptage incorrect des mois dans paidTotal",
-                "it": "Correzione: lastYearStart ora sempre ricalcolato dalla data contratto all'avvio - corregge conteggio errato mesi in paidTotal",
-                "es": "Corrección: lastYearStart ahora siempre recalculado desde fecha contrato al iniciar - corrige recuento incorrecto meses en paidTotal",
-                "pl": "Naprawa: lastYearStart teraz zawsze przeliczany z daty umowy przy starcie - naprawia błędne liczenie miesięcy w paidTotal",
-                "uk": "Виправлення: lastYearStart тепер завжди перераховується з дати договору при запуску - виправляє неправильний підрахунок місяців у paidTotal",
-                "zh-cn": "修复：lastYearStart现在在启动时始终从合同日期重新计算 - 修复paidTotal中的错误月数计数"
+            "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."
             },
-            "1.4.3": {
-                "en": "Fix: Critical paidTotal calculation bug - now correctly calculates (monthly payment × months) after sensor updates",
-                "de": "Fix: Kritischer paidTotal-Berechnungsfehler - berechnet jetzt korrekt (monatlicher Abschlag × Monate) nach Sensor-Updates",
-                "ru": "Исправление: Критическая ошибка расчета paidTotal - теперь правильно вычисляет (ежемесячный платеж × месяцы) после обновлений датчика",
-                "pt": "Correção: Bug crítico de cálculo paidTotal - agora calcula corretamente (pagamento mensal × meses) após atualizações do sensor",
-                "nl": "Fix: Kritieke paidTotal-berekeningsfout - berekent nu correct (maandelijkse betaling × maanden) na sensor-updates",
-                "fr": "Correction: Bug critique de calcul paidTotal - calcule maintenant correctement (paiement mensuel × mois) après les mises à jour du capteur",
-                "it": "Correzione: Bug critico calcolo paidTotal - ora calcola correttamente (pagamento mensile × mesi) dopo aggiornamenti sensore",
-                "es": "Corrección: Bug crítico de cálculo paidTotal - ahora calcula correctamente (pago mensual × meses) después de actualizaciones del sensor",
-                "pl": "Naprawa: Krytyczny błąd obliczania paidTotal - teraz poprawnie oblicza (płatność miesięczna × miesiące) po aktualizacjach czujnika",
-                "uk": "Виправлення: Критична помилка розрахунку paidTotal - тепер правильно обчислює (щомісячний платіж × місяці) після оновлень датчика",
-                "zh-cn": "修复：关键的paidTotal计算错误 - 现在在传感器更新后正确计算（月付款×月数）"
+            "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.",
@@ -41,32 +32,6 @@
                 "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错误。新增：增强输入验证。新增：扩展常量。新增：错误处理包装器。"
-            },
-            "1.4.1": {
-                "en": "Fix: Multi-meter bugs (cost calculation, billing period closure, monthly reports, yearly resets). Fix: Per-meter billing closure support. Fix: State type corrections (lastDayStart). Fix: ioBroker Bot compliance.",
-                "de": "Fix: Multi-Meter-Fehler (Kostenberechnung, Periodenabschluss, Monatsberichte, Jahres-Resets). Fix: Zähler-individuelle Periodenabschlüsse. Fix: State-Typ-Korrekturen (lastDayStart). Fix: ioBroker Bot-Compliance.",
-                "ru": "Исправление: Ошибки нескольких счетчиков (расчет затрат, закрытие периода, ежемесячные отчеты, годовые сбросы). Исправление: Поддержка закрытия периода для каждого счетчика. Исправление: Исправления типов состояний. Исправление: Соответствие ioBroker Bot.",
-                "pt": "Correção: Bugs multi-medidor (cálculo custos, fechamento período, relatórios mensais, resets anuais). Correção: Suporte fechamento período por medidor. Correção: Correções tipo estado. Correção: Conformidade Bot ioBroker.",
-                "nl": "Fix: Multi-meter bugs (kostenberekening, periode afsluiting, maandraporten, jaarlijkse resets). Fix: Per-meter periode afsluiting. Fix: State type correcties. Fix: ioBroker Bot compliance.",
-                "fr": "Correction: Bugs multi-compteurs (calcul coûts, clôture période, rapports mensuels, réinitialisations annuelles). Correction: Support clôture période par compteur. Correction: Corrections type d'état. Correction: Conformité Bot ioBroker.",
-                "it": "Correzione: Bug multi-contatore (calcolo costi, chiusura periodo, report mensili, reset annuali). Correzione: Supporto chiusura periodo per contatore. Correzione: Correzioni tipo stato. Correzione: Conformità Bot ioBroker.",
-                "es": "Corrección: Bugs multi-medidor (cálculo costos, cierre período, informes mensuales, reinicios anuales). Corrección: Soporte cierre período por medidor. Corrección: Correcciones tipo estado. Corrección: Cumplimiento Bot ioBroker.",
-                "pl": "Naprawa: Błędy wielu liczników (obliczanie kosztów, zamknięcie okresu, raporty miesięczne, resety roczne). Naprawa: Wsparcie zamknięcia okresu dla licznika. Naprawa: Poprawki typu stanu. Naprawa: Zgodność z Bot ioBroker.",
-                "uk": "Виправлення: Помилки кількох лічильників (розрахунок витрат, закриття періоду, місячні звіти, річні скидання). Виправлення: Підтримка закриття періоду для лічильника. Виправлення: Виправлення типу стану. Виправлення: Відповідність ioBroker Bot.",
-                "zh-cn": "修复：多表错误（成本计算、期间关闭、月度报告、年度重置）。修复：每表期间关闭支持。修复：状态类型更正。修复：ioBroker Bot合规性。"
-            },
-            "1.4.0": {
-                "en": "New: Multi-Meter Support! Add unlimited custom-named meters per utility type (gas, water, electricity). Automatic totals calculation. Fully backward compatible.",
-                "de": "Neu: Multi-Meter-Unterstützung! Unbegrenzt viele Zähler pro Medium (Gas, Wasser, Strom) mit benutzerdefinierten Namen. Automatische Gesamt-Summen. Vollständig rückwärtskompatibel.",
-                "ru": "Новое: Поддержка нескольких счетчиков! Добавьте неограниченное количество пользовательских счетчиков для каждого типа коммунальных услуг (газ, вода, электричество). Автоматический расчет итогов. Полная обратная совместимость.",
-                "pt": "Novo: Suporte Multi-Medidor! Adicione medidores personalizados ilimitados por tipo de utilidade (gás, água, eletricidade). Cálculo automático de totais. Totalmente compatível com versões anteriores.",
-                "nl": "Nieuw: Multi-Meter Ondersteuning! Voeg onbeperkt aangepaste meters toe per type (gas, water, elektriciteit). Automatische totaalberekening. Volledig achterwaarts compatibel.",
-                "fr": "Nouveau: Support Multi-Compteur! Ajoutez des compteurs personnalisés illimités par type de service (gaz, eau, électricité). Calcul automatique des totaux. Entièrement rétrocompatible.",
-                "it": "Nuovo: Supporto Multi-Contatore! Aggiungi contatori personalizzati illimitati per tipo di servizio (gas, acqua, elettricità). Calcolo automatico dei totali. Completamente retrocompatibile.",
-                "es": "Nuevo: Soporte Multi-Medidor! Agregue medidores personalizados ilimitados por tipo de servicio (gas, agua, electricidad). Cálculo automático de totales. Totalmente compatible con versiones anteriores.",
-                "pl": "Nowe: Obsługa Wielu Liczników! Dodaj nieograniczoną liczbę niestandardowych liczników dla każdego typu mediów (gaz, woda, prąd). Automatyczne obliczanie sum. Pełna kompatybilność wsteczna.",
-                "uk": "Нове: Підтримка кількох лічильників! Додайте необмежену кількість власних лічильників для кожного типу комунальних послуг (газ, вода, електрика). Автоматичний розрахунок підсумків. Повна зворотна сумісність.",
-                "zh-cn": "新增：多表支持！为每种公用事业类型（燃气、水、电）添加无限的自定义计量表。自动总计计算。完全向后兼容。"
             }
         },
         "titleLang": {
@@ -130,6 +95,7 @@
     },
     "native": {
         "gasAktiv": false,
+        "gasMainMeterName": "main",
         "gasSensorDP": "",
         "gasOffset": 0,
         "gasInitialReading": 0,
@@ -139,6 +105,7 @@
         "gasGrundgebuehr": 0,
         "gasAbschlag": 0,
         "wasserAktiv": false,
+        "wasserMainMeterName": "main",
         "wasserSensorDP": "",
         "wasserOffset": 0,
         "wasserInitialReading": 0,
@@ -146,6 +113,7 @@
         "wasserGrundgebuehr": 0,
         "wasserAbschlag": 0,
         "stromAktiv": false,
+        "stromMainMeterName": "main",
         "stromSensorDP": "",
         "stromOffset": 0,
         "stromInitialReading": 0,
@@ -153,6 +121,7 @@
         "stromGrundgebuehr": 0,
         "stromAbschlag": 0,
         "pvAktiv": false,
+        "pvMainMeterName": "main",
         "pvSensorDP": "",
         "pvOffset": 0,
         "pvInitialReading": 0,
@@ -164,8 +133,13 @@
         "notificationInstance": "",
         "notificationDaysBefore": 30,
         "notificationGasEnabled": false,
+        "notificationGasMeters": [],
         "notificationWasserEnabled": false,
+        "notificationWasserMeters": [],
         "notificationStromEnabled": false,
+        "notificationStromMeters": [],
+        "notificationPVEnabled": false,
+        "notificationPVMeters": [],
         "notificationBillingEnabled": true,
         "notificationBillingDays": 7,
         "notificationChangeDays": 60