Initial SolarEdge Optimizer Home Assistant App

README.md

@@ -0,0 +1,54 @@
+# SolarEdge Optimizer Apps
+
+Home-Assistant-App-Repository für den browserlosen Abruf von Optimierer-Daten
+aus dem SolarEdge Monitoring Portal.
+
+## In Home Assistant installieren
+
+Voraussetzung ist Home Assistant OS.
+
+1. Öffne **Einstellungen → Apps → App Store**.
+2. Öffne oben rechts **⋮ → Repositories**.
+3. Füge diese Repository-URL hinzu:
+
+   ```text
+   https://git.jensneuber.de/jens/solaredge-optimizers
+   ```
+
+4. Installiere **SolarEdge Optimizer Data**.
+5. Hinterlege im Tab **Konfiguration** Benutzername, Passwort und Site-ID.
+6. Speichere die Konfiguration und starte die App.
+
+## SolarEdge Optimizer Data
+
+Die App aktualisiert standardmäßig alle zehn Minuten und liefert für jedes
+Modul beziehungsweise jeden Optimierer:
+
+- logische ID, zum Beispiel `1.1.1`
+- Seriennummer
+- heutige Energie in Wh
+- aktuelle Leistung in W
+- Zeitpunkt der letzten Telemetrie
+
+Die Daten sind über Home Assistant Ingress und intern unter
+`GET /api/optimizers` verfügbar. Details stehen in
+[`solaredge-optimizer-data/DOCS.md`](solaredge-optimizer-data/DOCS.md).
+
+Das zur App-Version passende Multi-Arch-Image wird von
+`git.jensneuber.de/jens/solaredgeoptimizers` geladen. Unterstützt werden
+`amd64` und `aarch64`.
+
+## Entwicklung
+
+```sh
+bun install --frozen-lockfile
+bun run typecheck
+bun run test
+bun run build
+```
+
+Das erzeugte `solaredge-optimizer-data/dist/server.js` ist ein eigenständiges
+Bun-Bundle und wird vom Docker-Image direkt ausgeführt.
+
+> Die Optimierer-Endpunkte sind interne, nicht offiziell dokumentierte
+> SolarEdge-Portal-Endpunkte und können sich ohne Ankündigung ändern.