feat: Energiediagramm adaptieren

2026-09-27 08:48:59 +00:00
parent 75650c0621
commit db704dd011
16 changed files with 1576 additions and 30 deletions
@@ -0,0 +1,56 @@
+# Energiediagramm
+
+Das Energiediagramm stellt Produktion, Hausverbrauch, Netzbezug und
+Einspeisung aus archivierten Energiezaehlern dar. Zwei Kreisdiagramme zeigen
+Eigenverbrauchsquote und Autarkiegrad.
+
+## Voraussetzungen
+
+- IP-Symcon ab Version 8.0
+- aktiviertes Archiv
+- fortlaufende Integer- oder Floatzaehler
+- Zaehlerwerte in kWh oder ein passender gemeinsamer Zaehlerfaktor
+
+## Konfiguration
+
+Produktion, Einspeisung und Netzbezug sind Pflichtquellen. Ein vorhandener
+Hausverbrauchszaehler kann optional direkt verwendet werden. Ohne diese Quelle
+wird der Hausverbrauch als Produktion minus Einspeisung plus Netzbezug
+berechnet.
+
+Der Standardzeitraum kann auf aktuellen Tag, aktuelle Woche, aktuellen Monat,
+aktuelles Jahr oder Gesamt gesetzt werden. In der Visualisierung stehen
+zusaetzlich ein frei waehlbarer inklusiver Datumsbereich und die Navigation
+durch abgeschlossene Zeitraeume zur Verfuegung.
+
+Die Farben fuer Eigenverbrauchsquote und Autarkiegrad werden mit den beiden
+Farbauswahlen in der Instanzkonfiguration festgelegt.
+
+## Darstellung
+
+Die Kachel und ihre vergroesserte Ansicht erhalten beim Aufbau sofort einen
+vollstaendigen Datenstand. Beim Oeffnen und beim erneuten Sichtbarwerden wird
+die Darstellung aktualisiert. Das Diagrammraster wechselt bei geringer Breite
+automatisch von zwei Spalten auf eine Spalte.
+
+## Berechnung
+
+- Hausverbrauch: direkter Zaehler oder Produktion - Einspeisung + Netzbezug
+- Eigenverbrauch: Hausverbrauch - Netzbezug, begrenzt auf die Produktion
+- Eigenverbrauchsquote: Eigenverbrauch / Produktion
+- Autarkiegrad: Eigenverbrauch / Hausverbrauch
+
+Negative Zaehlerdifferenzen, etwa nach einem Zaehlerwechsel, werden fuer den
+betroffenen Zeitraum auf 0 kWh begrenzt.
+
+## Migration aus Enelix 1
+
+Uebernommen wurden die drei Pflichtzaehler, die Zeitraumsauswahl, die
+Datumsnavigation, die Energiebilanz und beide Kreisdiagramme. Neu sind die
+optionale direkte Hausverbrauchsquelle, der konfigurierbare Standardzeitraum,
+der freie Datumsbereich, waehlbare Farben, eingebettete Initialdaten fuer die
+vergroesserte Ansicht und das responsive Ein-/Zweispaltenlayout.
+
+Das Enelix-1-Modul wird nicht in-place aktualisiert. Es muss eine neue
+Energiediagramm-Instanz angelegt und mit den bisherigen Zaehlern konfiguriert
+werden.