feat: Energiediagramm adaptieren

docs/module/Energiediagramm/README.md

@@ -1,29 +1,59 @@
 # Energiediagramm
 
-> Status: Diskussionsentwurf. Übernimmt `Energy_Pie` ohne EMS-Abhängigkeit.
+> Status: Implementiert fuer IP-Symcon 8.0+.
 
-Der Zeitraum wird einstellbar. Öffnen beziehungsweise Aufklappen aktualisiert
-dieselbe Darstellung wie die bestehende Aktualisieren-Aktion.
-
-## Variablen
-
-Keine klassischen Pflichtvariablen. Energiewerte und Auswahl erscheinen in der
-individuellen Darstellung; Zeitraum und Datum bleiben intern gespeichert.
+Das Modul adaptiert `Energy_Pie` als unabhaengiges Enelix-Utils-Modul. Es
+wertet fortlaufende Energiezaehler aus dem IP-Symcon-Archiv aus und zeigt die
+Energiebilanz sowie Eigenverbrauchsquote und Autarkiegrad in einer individuellen
+HTML-SDK-Darstellung.
 
 ## Properties
 
 | Ident | Typ | Standard / Beschreibung |
 | --- | --- | --- |
-| `ProduktionZaehlerID` | Integer | `0`; alt `VarProduction`. |
-| `VerbrauchZaehlerID` | Integer | `0`; alt `VarConsumption`. |
-| `EinspeisungZaehlerID` | Integer | `0`; alt `VarFeedIn`. |
-| `NetzbezugZaehlerID` | Integer | `0`; alt `VarGrid`. |
-| `Zaehlerfaktor` | Float | `1`; auf kWh normieren. |
-| `Standardzeitraum` | String/Auswahl | `Tag`; Tag, Woche, Monat, Jahr oder Gesamt. |
-| `Aktualisierungsintervall` | Integer | `60` s. |
+| `ProduktionZaehlerID` | Integer | Pflichtquelle fuer produzierte Energie |
+| `EinspeisungZaehlerID` | Integer | Pflichtquelle fuer eingespeiste Energie |
+| `NetzbezugZaehlerID` | Integer | Pflichtquelle fuer bezogene Energie |
+| `VerbrauchZaehlerID` | Integer | Optionale direkte Hausverbrauchsquelle |
+| `Zaehlerfaktor` | Float | `1.0`; gemeinsamer Faktor auf kWh |
+| `Standardzeitraum` | String | `day`; Tag, Woche, Monat, Jahr oder Gesamt |
+| `Aktualisierungsintervall` | Integer | `60 s`; 10 bis 3600 Sekunden |
+| `FarbeEigenverbrauch` | String | Farbe der Eigenverbrauchsquote |
+| `FarbeAutarkie` | String | Farbe des Autarkiegrads |
+| `Debug` | Boolean | Zusaetzliche Diagnoseausgaben |
 
-## Verhalten und offene Punkte
+## Zeitraeume und Bedienung
 
-- Nutzt Energiezähler und Symcon-Archivdaten.
-- Fehlende Historie darf nicht als echter Nullverbrauch dargestellt werden.
-- Aktualisierung beim Öffnen in den verfügbaren Symcon-Visualisierungen testen.
+Die Visualisierung bietet Tag, Woche, Monat, Jahr, Gesamt und Datumsbereich.
+Der freie Datumsbereich umfasst Start- und Enddatum jeweils vollstaendig. Fuer
+die Kalenderzeitraeume kann vor- und zuruecknavigiert oder direkt zum aktuellen
+Zeitraum gesprungen werden. Zukuenftige Datumswerte werden nicht akzeptiert.
+
+## Darstellung
+
+Kachel und vergroesserte Ansicht enthalten bereits beim ersten HTML-Aufbau
+einen vollstaendigen Datenstand. Ein nachgelagertes Refresh aktualisiert die
+Werte; beim erneuten Sichtbarwerden wird ebenfalls aktualisiert. Das
+Diagrammraster zeigt bei ausreichender Breite zwei Kreisdiagramme nebeneinander
+und bei geringer Breite automatisch untereinander.
+
+## Daten und Fehlerverhalten
+
+Die drei Pflichtzaehler muessen numerisch und im Archiv vorhanden sein. Der
+Hausverbrauch wird aus einer optionalen direkten Quelle gelesen oder aus
+Produktion minus Einspeisung plus Netzbezug berechnet. Bei fehlendem Archiv
+oder fehlenden Werten zeigt die Darstellung einen Diagnosehinweis statt einer
+leeren Flaeche.
+
+## Adaption aus Enelix 1
+
+| Bereich | Behandlung |
+| --- | --- |
+| Archivierte Produktions-, Einspeise- und Netzbezugszaehler | angepasst uebernommen |
+| Tag, Woche, Monat, Jahr und Gesamt | uebernommen |
+| Frei waehlbarer Datumsbereich | neu implementiert |
+| Standardzeitraum in der Konfiguration | neu implementiert |
+| Farben der Kreisdiagramme | neu konfigurierbar |
+| Vergroesserte Ansicht | mit eingebetteten Initialdaten stabilisiert |
+| Starres Zwei-Spalten-Layout | durch responsives Raster ersetzt |
+| Erzwungener Sprung auf Heute beim Laden | verworfen |