Verbrauchskostenreport implementieren

Verbrauchskostenreport/README.md

@@ -0,0 +1,48 @@
+# Verbrauchskostenreport
+
+IP-Symcon-Modul zur Aufbereitung von Energie- und Nebenkosten als PDF-Report.
+
+Das Modul verwendet eine eigenständige, neutrale öffentliche API mit dem
+Präfix `VKR`. Aus Enelix 1 wurde ausschließlich die fachliche Berechnungslogik
+adaptiert. Alte Modulnamen, Aktionen und Medien-Idents werden nicht angeboten.
+
+Technische Anpassungen für IP-Symcon 8.0 und PHP 8.3 umfassen einen
+deklarierten Laufzeit-Cache, ausgabefreie `RequestAction`-Aufrufe und das
+Abmelden des WebHooks beim Löschen einer Instanz.
+
+## Funktion
+
+- erstellt pro Benutzer einen Verbrauchskostenreport
+- berechnet Stromkosten aus Archivwerten in 15-Minuten-Schritten
+- berücksichtigt Netz-, Solar- und Einspeisetarife
+- berechnet zusätzliche Zählerkosten für Warmwasser, Kaltwasser und Wärme
+- erzeugt optional einen Schweizer QR-Zahlteil
+- unterstützt den konfigurierbaren MWST-Ausweis
+
+## Konfiguration
+
+| Property | Beschreibung |
+|---|---|
+| `Users` | Benutzerliste |
+| `PowerMeters` | Stromzählerliste |
+| `WaterMeters` | Nebenkostenzähler |
+| `Tariffs` | Tarifliste |
+| `LogoMediaID` | Logo für PDF-Kopf |
+| `PropertyText` | Liegenschaftstext |
+| `FooterText` | PDF-Fusszeile |
+| `EnableVAT` | aktiviert MWST |
+| `VATPercentage` | MWST-Satz |
+| `CreditorName` | Zahlungsempfänger |
+| `CreditorAddress` | Adresse Zahlungsempfänger |
+| `CreditorCity` | PLZ/Ort Zahlungsempfänger |
+| `BankIBAN` | IBAN für QR-Zahlteil |
+
+## Bedienung
+
+| Ident/Action | Beschreibung |
+|---|---|
+| `FromDate` | Startdatum |
+| `ToDate` | Enddatum |
+| `CreateReport` | erzeugt das PDF |
+| `LastResult` | letzter Lauf |
+| `ReportPDF` | erzeugtes PDF-Dokument |