iobroker.nebenkosten-monitor 1.3.2 → 1.3.3

package/README.md

@@ -14,12 +14,14 @@
 
 ### ✨ Hauptfunktionen
 
-- 📊 **Verbrauchsüberwachung** für Gas, Wasser und Strom
+- 📊 **Verbrauchsüberwachung** für Gas, Wasser, Strom und **PV/Einspeisung**
 - 💰 **Automatische Kostenberechnung** mit Arbeitspreis und Grundgebühr
+- ☀️ **PV & Einspeisung** - Überwache deine Einspeisung und Vergütung
 - 💳 **Abschlagsüberwachung** - Sehe sofort ob Nachzahlung oder Guthaben droht
 - 🔄 **Flexible Sensoren** - Nutzt vorhandene Sensoren (Shelly, Tasmota, Homematic, etc.)
 - ⚡ **HT/NT-Tarife** - Volle Unterstützung für Hoch- und Nebentarife (Tag/Nacht)
-- 🔄 **Gas-Spezial** - Automatische Umrechnung von m³ in kWh
+- � **CSV-Import** - Importiere historische Daten (z.B. aus der EhB+ App)
+- �🔄 **Gas-Spezial** - Automatische Umrechnung von m³ in kWh
 - 🕛 **Automatische Resets** - Täglich, monatlich und jährlich (Vertragsjubiläum)
 - 🔔 **Intelligente Benachrichtigungen** - Getrennte Erinnerungen für Abrechnungsende (Zählerstand) und Vertragswechsel (Tarif-Check) mit einstellbaren Vorlaufzeiten.
 
@@ -61,7 +63,7 @@ Gefällt dir dieser Adapter? Du kannst mich gerne mit einem Kaffee unterstützen
 
 ## 📊 Datenpunkte erklärt
 
-Für jede aktivierte Verbrauchsart (Gas/Wasser/Strom) werden folgende Ordner angelegt:
+Für jede aktivierte Verbrauchsart (Gas/Wasser/Strom/PV) werden folgende Ordner angelegt:
 
 ### 🗂️ **consumption** (Verbrauch)
 
@@ -214,6 +216,25 @@ Gasverbrauch wird in **m³ gemessen**, aber in **kWh abgerechnet**.
 
 ---
 
+### 📥 CSV Import & Historische Daten
+
+Du kannst historische Daten importieren, um deine Jahresstatistik zu vervollständigen.
+
+1.  Gehe in den Tab **Import**.
+2.  Wähle das **Ziel-Medium** (Strom, Gas, Wasser, PV) oder **Benutzerdefiniert**.
+3.  Wähle das **Format** (derzeit "EhB+ App (CSV)").
+4.  Füge den **CSV-Inhalt** ein.
+    - Format: `Datum;Zählerstand;Kommentar` (z.B. `01.01.2023 00:00;12345,6;Start`)
+5.  Klicke auf **Importieren**.
+
+**Funktionen:**
+
+- Berechnet automatisch den Jahresverbrauch für vergangene Jahre.
+- Erstellt die Historie unter `history.JJJJ`.
+- Benutzerdefinierte Zähler ("Einliegerwohnung") werden automatisch angelegt.
+
+---
+
 ### 🔄 Automatische Resets
 
 Der Adapter setzt Zähler automatisch zurück:
@@ -228,6 +249,12 @@ Der Adapter setzt Zähler automatisch zurück:
 
 ## Changelog
 
+### 1.3.3 (2026-01-09)
+
+- **NEW:** **CSV-Import** - Importiere historische Daten (z.B. aus der EhB+ App) für Strom, Gas, Wasser und PV.
+- **NEW:** **Benutzerdefinierte Zähler** - Unterstützung für Zwischenzähler (z.B. Gartenhaus, Einliegerwohnung).
+- **IMPROVED:** Import-UI optimiert (Icons, Button-Layout).
+
 ### 1.3.2 (2026-01-09)
 
 - **NEW:** **PV / Einspeise-Unterstützung** ☀️ - Neuer Tab für Photovoltaik:

package/admin/jsonConfig.json

@@ -803,7 +803,7 @@
         "tabPv": {
             "type": "panel",
             "label": "PV / Einspeisung",
-            "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0Ij48cGF0aCBmaWxsPSJjdXJyZW50Q29sb3IiIGQ9Ik00IDIyaDJ0LTJoMmgydi0yaDJ2LTJoMlY4bC01LTVoLTl2MTdoM3ptOC02aC0ydjJoMnptMC00aC0ydjJoMnptMC00aC0ydjJoMnptLTQtNGgydjRoLTJ6bTQtNGgydjRoLTJ6Ii8+PC9zdmc+",
+            "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgd2lkdGg9IjI0IiBmaWxsPSJjdXJyZW50Q29sb3IiPjxwYXRoIGQ9Ik0wIDBoMjR2MjRIMHoiIGZpbGw9Im5vbmUiLz48cGF0aCBkPSJMNi43NiA0Ljg0bC0xLjgtMS43OS0xLjQxIDEuNDEgMS43OSAxLjc5IDEuNDItMS40MXpNNCAxMC41SDF2M2gzdi0zem05LTkuOTVoLTJWMy41aDJWLjU1em03LjQ1IDMuOTFsLTEuNDEtMS40MS0xLjc5IDEuNzkgMS40MSAxLjQxIDEuNzktMS43OXptLTMuMjEgMTMuN2wxLjc5IDEuOCAxLjQxLTEuNDEtMS44LTEuNzktMS40IDEuNHoyMCAxMC41djNoM3diLTNoLTN6bS04LTVjLTMuMzEgMC02IDIuNjktNiA2czIuNjkgNiA2IDYgNi0yLjY5IDYtNi0yLjY5LTYtNi02em0tMSAxNi45NWgyVjE5LjVoLTJ2Mi45NXptLTcuNDUtMy45MWwxLjQxIDEuNDEgMS43OS0xLjgtMS40MS0xLjQxLTEuNzkgMS44eiIvPjwvc3ZnPg==",
             "items": {
                 "_pvActivationHeader": {
                     "type": "header",
@@ -1120,6 +1120,107 @@
                 }
             }
         },
+        "tabImport": {
+            "type": "panel",
+            "label": "Import",
+            "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjRweCIgdmlld0JveD0iMCAwIDI0IDI0IiB3aWR0aD0iMjRweCIgZmlsbD0iY3VycmVudENvbG9yIj48cGF0aCBkPSJNMCAwaDI0djI0SDBWMHoiIGZpbGw9Im5vbmUiLz48cGF0aCBkPSJNMTkgOWgtNFYzSDl2Nkg1bDcgNyA3LTd6TTUgMTh2MmgxNHdiLTJINXoiLz48L3N2Zz4=",
+            "items": {
+                "_importHeader": {
+                    "type": "header",
+                    "text": "Historische Daten importieren",
+                    "size": 2
+                },
+                "_importDesc": {
+                    "type": "staticText",
+                    "text": "Hier kannst du alte Zählerstände aus CSV-Dateien (z.B. EhB+ App) importieren. Die Daten werden in die Historie (Jahresverbrauch) geschrieben. Bitte kopiere den Inhalt der CSV-Datei in das Textfeld.",
+                    "xs": 12
+                },
+                "importTarget": {
+                    "type": "select",
+                    "label": "Ziel-Medium",
+                    "options": [
+                        { "label": "Bitte wählen...", "value": "" },
+                        { "label": "Strom", "value": "electricity" },
+                        { "label": "Gas", "value": "gas" },
+                        { "label": "Wasser", "value": "water" },
+                        { "label": "PV / Einspeisung", "value": "pv" },
+                        { "label": "Benutzerdefiniert / Zwischenzähler", "value": "custom" }
+                    ],
+                    "default": "",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "importCustomName": {
+                    "type": "text",
+                    "label": "Name des Zählers",
+                    "placeholder": "z.B. Einliegerwohnung",
+                    "hidden": "data.importTarget !== 'custom'",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "importUnit": {
+                    "type": "select",
+                    "label": "Einheit",
+                    "options": [
+                        { "label": "kWh", "value": "kWh" },
+                        { "label": "m³", "value": "m3" }
+                    ],
+                    "default": "kWh",
+                    "hidden": "data.importTarget !== 'custom'",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "importFormat": {
+                    "type": "select",
+                    "label": "Quell-Format",
+                    "options": [{ "label": "EhB+ App (CSV)", "value": "ehb" }],
+                    "default": "ehb",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "importContent": {
+                    "type": "text",
+                    "label": "CSV Inhalt (hier einfügen)",
+                    "rows": 10,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12,
+                    "noCreate": true
+                },
+                "btnImport": {
+                    "type": "sendTo",
+                    "label": "Daten importieren",
+                    "command": "importData",
+                    "jsonData": "{\"utility\": \"${data.importTarget}\", \"type\": \"${data.importFormat}\", \"content\": \"${data.importContent}\", \"customName\": \"${data.importCustomName}\", \"unit\": \"${data.importUnit}\"}",
+                    "disabled": "!data.importTarget || !data.importContent",
+                    "variant": "outlined",
+                    "style": {
+                        "marginTop": "10px",
+                        "width": "100%"
+                    },
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 4,
+                    "lg": 4,
+                    "xl": 4,
+                    "icon": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIGhlaWdodD0iMjRweCIgdmlld0JveD0iMCAwIDI0IDI0IiB3aWR0aD0iMjRweCIgZmlsbD0iY3VycmVudENvbG9yIj48cGF0aCBkPSJNMCAwaDI0djI0SDBWMHoiIGZpbGw9Im5vbmUiLz48cGF0aCBkPSJNMTkgOWgtNFYzSDl2Nkg1bDcgNyA3LTd6TTUgMTh2MmgxNHdiLTJINXoiLz48L3N2Zz4="
+                }
+            }
+        },
         "tabInfo": {
             "type": "panel",
             "label": "ℹ️ Info & Hilfe",

package/io-package.json

@@ -1,8 +1,12 @@
 {
     "common": {
         "name": "nebenkosten-monitor",
-        "version": "1.3.2",
+        "version": "1.3.3",
         "news": {
+            "1.3.3": {
+                "en": "New: CSV Import feature for historical data (e.g. EhB+ App). New: Support for Custom Meters (intermediate meters).",
+                "de": "Neu: CSV-Import-Funktion für historische Daten (z.B. EhB+ App). Neu: Unterstützung für benutzerdefinierte Zähler (Zwischenzähler)."
+            },
             "1.3.2": {
                 "en": "New: PV/Feed-in integration! Monitor your solar feed-in and earnings. New: Notifications for PV. Improved: Reorganized config UI.",
                 "de": "Neu: PV/Einspeise-Integration! Überwache deine Solareinspeisung und Vergütung. Neu: Benachrichtigungen für PV. Verbessert: Aufgeräumte Konfigurations-Oberfläche."
@@ -18,14 +22,6 @@
             "1.2.7": {
                 "en": "New: Universal notification system for reminders. New: PayPal donation support. Fix: Improved precision for daily consumption.",
                 "de": "Neu: Universelles Benachrichtigungssystem für Erinnerungen. Neu: PayPal-Spendenunterstützung. Fix: Verbesserte Präzision für den Tagesverbrauch."
-            },
-            "1.2.6": {
-                "en": "Fix: Allow empty basic charge fields in configuration (default to 0)",
-                "de": "Fix: Grundgebühr-Felder dürfen in der Konfiguration leer sein (Standard 0)"
-            },
-            "1.2.5": {
-                "en": "Stability update: Fixed critical consumption delta calculation bug",
-                "de": "Stabilitäts-Update: Kritischen Fehler in der Verbrauchs-Delta-Berechnung behoben"
             }
         },
         "titleLang": {
@@ -112,6 +108,14 @@
         "stromPreis": 0,
         "stromGrundgebuehr": 0,
         "stromAbschlag": 0,
+        "pvAktiv": false,
+        "pvSensorDP": "",
+        "pvOffset": 0,
+        "pvInitialReading": 0,
+        "pvContractStart": "",
+        "pvPreis": 0,
+        "pvGrundgebuehr": 0,
+        "pvJahresgebuehr": 0,
         "notificationEnabled": false,
         "notificationInstance": "",
         "notificationDaysBefore": 30,

package/lib/importManager.js

@@ -0,0 +1,166 @@
+'use strict';
+
+const EhbImporter = require('./importers/ehb');
+
+/**
+ * ImportManager handles data import from different sources
+ */
+class ImportManager {
+    /**
+     * @param {object} adapter - ioBroker adapter instance
+     */
+    constructor(adapter) {
+        this.adapter = adapter;
+        this.importers = {
+            ehb: new EhbImporter(adapter),
+        };
+    }
+
+    /**
+     * handle import message
+     *
+     * @param {object} msg - The message object
+     */
+    async handleImportMessage(msg) {
+        try {
+            let { utility, type, content, customName, unit } = msg.message; // utility='gas', type='ehb', content='...'
+
+            if (utility === 'custom') {
+                if (!customName) {
+                    throw new Error('Name für benutzerdefinierten Zähler fehlt.');
+                }
+                // Sanitize name: "Garten Haus" -> "garten_haus"
+                utility = customName
+                    .toLowerCase()
+                    .replace(/\s+/g, '_')
+                    .replace(/[^a-z0-9_]/g, '');
+
+                if (utility.length === 0) {
+                    throw new Error('Ungültiger Name für Zähler.');
+                }
+
+                // Ensure unit is valid (default to kWh if something weird comes in)
+                if (unit === 'm3') {
+                    unit = 'm³'; // Fix mapping from UI value
+                }
+                if (!unit) {
+                    unit = 'kWh';
+                }
+            }
+
+            if (!this.importers[type]) {
+                throw new Error(`Unknown importer type: ${type}`);
+            }
+
+            this.adapter.log.info(`[Import] Starting import for ${utility} using ${type}...`);
+            const records = await this.importers[type].parse(content);
+
+            if (!records || records.length === 0) {
+                return { error: 'No valid data found in CSV.' };
+            }
+
+            const result = await this.processRecords(utility, records, unit);
+
+            const details = result.details.map(d => `${d.year}: ${d.consumption.toFixed(2)} ${d.unit}`).join(', ');
+            this.adapter.log.info(`[Import] Details: ${details}`);
+
+            return {
+                result: `Erfolgreich importiert: ${records.length} Datensätze verarbeitet.`,
+                native: {
+                    importContent: '',
+                },
+            };
+        } catch (error) {
+            this.adapter.log.error(`[Import] Error: ${error.message}`);
+            return { error: error.message };
+        }
+    }
+
+    /**
+     * Process records and write to history
+     *
+     * @param {string} utility - The utility type (gas, water, electricity, pv, or custom name)
+     * @param {Array<{timestamp: number, value: number, dateObj: Date}>} records - Parsed records
+     * @param {string} [customUnit] - Unit for custom meters
+     */
+    async processRecords(utility, records, customUnit) {
+        // Group by year
+        const years = {};
+
+        for (const r of records) {
+            const year = r.dateObj.getFullYear();
+            if (!years[year]) {
+                years[year] = [];
+            }
+            years[year].push(r);
+        }
+
+        // eslint-disable-next-line jsdoc/check-tag-names
+        /** @type {{ yearsUpdated: string[], details: Array<{year: number, consumption: number, unit: string}> }} */
+        const stats = { yearsUpdated: [], details: [] };
+
+        for (const year of Object.keys(years)) {
+            const readings = years[year];
+            // Sort just in case
+            readings.sort((a, b) => a.timestamp - b.timestamp);
+
+            const startVal = readings[0].value;
+            const endVal = readings[readings.length - 1].value;
+            let consumption = endVal - startVal;
+
+            if (consumption < 0) {
+                consumption = 0; // Reset handling? simpler for now.
+            }
+
+            let unit = customUnit || 'kWh'; // Default or custom
+
+            // Gas: Convert m3 to kWh? (Only for standard 'gas' utility)
+            if (utility === 'gas') {
+                unit = 'kWh'; // Gas is always kWh in history despite input
+
+                // Read current conversion factors (Not perfect for history, but better than nothing)
+                const brennwert = this.adapter.config.gasBrennwert || 1;
+                const zustandszahl = this.adapter.config.gasZahl || 1;
+
+                // Save Volume
+                await this.adapter.setObjectNotExistsAsync(`${utility}.history.${year}.yearlyVolume`, {
+                    type: 'state',
+                    common: { name: `Verbrauch ${year} in m³`, type: 'number', unit: 'm³', role: 'value' },
+                    native: {},
+                });
+                await this.adapter.setStateAsync(`${utility}.history.${year}.yearlyVolume`, consumption, true);
+
+                // Convert to kWh
+                consumption = consumption * brennwert * zustandszahl;
+            } else if (utility === 'water') {
+                unit = 'm³';
+            }
+
+            // Write Yearly Consumption
+            await this.adapter.setObjectNotExistsAsync(`${utility}.history.${year}`, {
+                type: 'channel',
+                common: { name: `Jahr ${year}` },
+                native: {},
+            });
+            await this.adapter.setObjectNotExistsAsync(`${utility}.history.${year}.yearly`, {
+                type: 'state',
+                common: { name: `Jahresverbrauch ${year}`, type: 'number', unit: unit, role: 'value' },
+                native: {},
+            });
+
+            const stateId = `${utility}.history.${year}.yearly`;
+            await this.adapter.setStateAsync(stateId, consumption, true);
+
+            stats.yearsUpdated.push(year);
+            stats.details.push({ year: parseInt(year), consumption, unit });
+
+            this.adapter.log.info(
+                `[Import] ${utility} ${year}: ${consumption.toFixed(2)} ${unit} (from ${startVal} to ${endVal})`,
+            );
+        }
+
+        return stats;
+    }
+}
+
+module.exports = ImportManager;

package/lib/importers/abstractImporter.js

@@ -0,0 +1,35 @@
+'use strict';
+
+/**
+ * Abstract base class for importers
+ */
+class AbstractImporter {
+    /**
+     * @param {object} adapter - Adapter instance
+     */
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+
+    /**
+     * Parses the CSV content
+     *
+     * @param {string} _content - Raw CSV string
+     * @returns {Promise<Array<{timestamp: number, value: number}>>} - Array of objects with timestamp and value
+     */
+    async parse(_content) {
+        throw new Error('Method "parse" must be implemented');
+    }
+
+    /**
+     * Validates if the content matches this importer
+     *
+     * @param {string} _content - Raw content to validate
+     * @returns {boolean} - True if valid, false otherwise
+     */
+    validate(_content) {
+        return false;
+    }
+}
+
+module.exports = AbstractImporter;

package/lib/importers/ehb.js

@@ -0,0 +1,91 @@
+'use strict';
+
+const AbstractImporter = require('./abstractImporter');
+
+/**
+ * Importer for "Energie Haushalts Buch" (EhB) App
+ * Format assumption: German CSV (semicolon separator)
+ * Date;Value;Comment
+ * 01.01.2023 12:00;1234.5;Ablesung
+ */
+class EhbImporter extends AbstractImporter {
+    /**
+     * Parse the CSV content
+     *
+     * @param {string} content - Raw content
+     * @returns {Promise<Array<any>>} - Parsed results
+     */
+    async parse(content) {
+        const results = [];
+        // Regex to match: Date;Value;Comment
+        // Supports:
+        // DD.MM.YYYY or DD.MM.YYYY HH:mm
+        // Semicolon separator
+        // Value with dot or comma
+        // Optional comment
+        const regex = /(\d{2}\.\d{2}\.\d{4}(?:\s+\d{2}:\d{2}(?::\d{2})?)?)\s*;\s*(\d+(?:[.,]\d+)?)/g;
+
+        let match;
+        while ((match = regex.exec(content)) !== null) {
+            const dateStr = match[1].trim();
+            const valueStr = match[2].trim().replace(',', '.');
+
+            const date = this.parseGermanDate(dateStr);
+            const value = parseFloat(valueStr);
+
+            if (date && !isNaN(value)) {
+                results.push({
+                    timestamp: date.getTime(),
+                    value: value,
+                    dateObj: date,
+                });
+            }
+        }
+
+        // Sort by date ascending
+        if (results.length > 0) {
+            results.sort((a, b) => a.timestamp - b.timestamp);
+        }
+
+        return results;
+    }
+
+    /**
+     * Parse german date string
+     *
+     * @param {string} dateStr - Date string
+     * @returns {Date|null} - Date object or null
+     */
+    parseGermanDate(dateStr) {
+        try {
+            // Check for time component
+            let timeStr = '00:00:00';
+            let dStr = dateStr;
+
+            if (dateStr.includes(' ')) {
+                const parts = dateStr.split(/\s+/); // Handle multiple spaces
+                dStr = parts[0];
+                if (parts[1]) {
+                    timeStr = parts[1];
+                    // Add seconds if missing
+                    if (timeStr.split(':').length === 2) {
+                        timeStr += ':00';
+                    }
+                }
+            }
+
+            const [day, month, year] = dStr.split('.');
+            // Simple check
+            if (!day || !month || !year) {
+                return null;
+            }
+
+            // Create ISO string YYYY-MM-DDTHH:mm:ss
+            return new Date(`${year}-${month}-${day}T${timeStr}`);
+        } catch {
+            return null;
+        }
+    }
+}
+
+module.exports = EhbImporter;

package/main.js

@@ -9,6 +9,7 @@ const utils = require('@iobroker/adapter-core');
 const ConsumptionManager = require('./lib/consumptionManager');
 const BillingManager = require('./lib/billingManager');
 const MessagingHandler = require('./lib/messagingHandler');
+const ImportManager = require('./lib/importManager');
 
 class NebenkostenMonitor extends utils.Adapter {
     /**
@@ -28,6 +29,7 @@ class NebenkostenMonitor extends utils.Adapter {
         this.consumptionManager = new ConsumptionManager(this);
         this.billingManager = new BillingManager(this);
         this.messagingHandler = new MessagingHandler(this);
+        this.importManager = new ImportManager(this);
 
         this.periodicTimers = {};
     }
@@ -188,7 +190,14 @@ class NebenkostenMonitor extends utils.Adapter {
      * @param {Record<string, any>} obj - Message object from config
      */
     async onMessage(obj) {
-        return this.messagingHandler.handleMessage(obj);
+        if (obj.command === 'importData') {
+            const result = await this.importManager.handleImportMessage(obj);
+            if (obj.callback) {
+                this.sendTo(obj.from, obj.command, result, obj.callback);
+            }
+        } else {
+            await this.messagingHandler.handleMessage(obj);
+        }
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.nebenkosten-monitor",
-  "version": "1.3.2",
+  "version": "1.3.3",
   "description": "Überwachung von Gas, Wasser und Strom mit Kostenrechnung",
   "author": {
     "name": "fischi87",