tobias
d8b12da36d
Das Backend liegt jetzt als custom_components/audi_dashboard/ vor - eine normale Home-Assistant-Integration mit Config-Flow, einer sensor-Plattform und 18 Diensten. Damit ist die App über HACS installierbar; bis das Repo auf GitHub gespiegelt ist (HACS spricht ausschließlich mit GitHub), installiert homeassistant/installationspaket/install.ps1 denselben Ordner ohne HACS. Fünf Installationsschritte entfallen ersatzlos: der pyscript:-Block, der panel_custom:-Block, das Kopieren der Oberfläche nach www/, das langlebige Zugriffstoken (der Verlauf wird direkt über die recorder-API gelesen) und "pip install pypdf" (steht in manifest.json). Das Fahrzeugprofil legt die Integration beim ersten Start aus ihrer Vorlage an. Drei alte Schwächen sind dabei mit erledigt: - Die Nutzlast landet nicht mehr in der Recorder-Datenbank (_unrecorded_attributes - das kann nur eine echte Entität). - Eine laufende Fahrt überlebt einen Neustart (Store statt Arbeitsspeicher); fiel sie während eines Ausfalls ins Ende, schließt nach_neustart_fortsetzen() sie beim letzten aufgezeichneten Zeitpunkt. - Sensor-Zuordnungen wirken sofort - die Zustandsbeobachter werden neu gebunden, der Neustart-Hinweis und der Neustart-Dienst sind weg. Namensvertrag geändert, beide Oberflächen mitgezogen: pyscript.audi_dashboard_x -> sensor.audi_dashboard_x, pyscript.audi_dashboard_y -> audi_dashboard.y. Eine Companion-App vom alten Stand findet nach dem Umstieg nichts mehr und muss neu gebaut werden; das Panel liegt in der Integration und kann nicht driften. Der selbstgebaute Updater entfällt - HACS ist die Update-Mechanik, die Home Assistant kennt. Die Versionierung schrumpft auf eine Quelle: manifest.json. Geprüft am laufenden Testcontainer (Container byteweise identisch mit dem Repo): alle 18 Dienste, Panel, Config-Entry neu laden, Historienimport, echter Shell-Beleg in-process, Neuinstallation im Wegwerf-Container blank mit automatisch nachinstalliertem pypdf. Companion-App: tsc sauber, 112/112 Tests, beide Rauchtests gegen das laufende Backend grün. Belegparser 8/8. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Audi Dashboard — „Mein Audi" für Home Assistant
Fahrtenbuch, Tankstatistik, Reifen- und Servicebuch für ein einzelnes Fahrzeug — als eigener Sidebar-Eintrag in Home Assistant und als iOS-App, die dieselben Daten zeigt.
Die App wertet aus, was Home Assistant ohnehin über das Fahrzeug weiß (Zündung, Kilometerstand, Tankfüllstand, Bordspannung, GPS — etwa über einen Teltonika FMM003 oder eine EU-Data-Act-Integration des Herstellers), und macht daraus einen dauerhaften Bestand: erkannte Fahrten, erkannte Tankvorgänge, Belegdaten aus hochgeladenen Tank-PDFs, ein Spannungsverlauf über Jahre.
Privates Projekt für ein bestimmtes Fahrzeug. Es ist nicht als allgemein nutzbare Integration gedacht und steht in keinem Verhältnis zur AUDI AG.
Installation über HACS
- HACS → Integrationen → Menü oben rechts → Benutzerdefinierte Repositories
- Dieses Repository eintragen, Kategorie Integration
- Audi Dashboard herunterladen
- Home Assistant neu starten
- Einstellungen → Geräte & Dienste → Integration hinzufügen → Audi Dashboard
Danach steht Mein Audi in der Seitenleiste.
Voraussetzung, die HACS selbst mitbringt: HACS spricht ausschließlich mit
GitHub — github.com und api.github.com stecken fest im Code, Gitea, GitLab
und selbst gehostete Instanzen kennt es nicht. Liegt dieses Repository nicht
auf GitHub, findet HACS es auch als benutzerdefiniertes Repository nicht. Für
diesen Fall gibt es den Weg darunter, der denselben Ordner installiert.
Installation ohne HACS
Von einem Windows-Rechner aus, der das config-Verzeichnis der HA-Instanz
erreicht (Samba-Add-on oder gemounteter Pfad):
homeassistant\installationspaket\Installieren.cmd
Das Skript kopiert custom_components\audi_dashboard\ in die Instanz und
fasst sonst nichts an — keine configuration.yaml, keine Fahrzeugdaten. Mit
-Pruefen zeigt es vorher, was es tun würde. Details und die
Sicherheitszusagen stehen im Kopf von
install.ps1.
Danach ebenfalls: neu starten, Integration hinzufügen.
Nach der Installation
Sensoren zuordnen — Einstellungen → Fahrzeug einrichten → Setup in der App. Im Auslieferstand ist bewusst kein Sensor vorbelegt: welche Entity-IDs richtig sind, hängt an der Instanz, und eine gesetzte, aber falsche ID ist schlechter als eine leere. Zwingend ist allein der Zündungs-/ACC-Sensor — er trägt die Fahrterkennung. Änderungen wirken sofort, ohne Neustart.
Datenaufbewahrung verlängern — Home Assistant löscht Sensor-Verläufe nach
10 Tagen. Das begrenzt, wie weit „Daten importieren aus Home Assistant"
zurückreichen kann, und was einmal gelöscht ist, kommt nicht wieder. Der Block
aus recorder_snippet.yaml hebt das
auf ein Jahr an; dort steht auch der gemessene Platzbedarf. Bewusst nicht
automatisch eingefügt: das ist eine Entscheidung über den Plattenplatz der
Instanz.
Vergangenes nachholen — Einstellungen → Einrichten → Daten importieren aus Home Assistant leitet Fahrten, Tankvorgänge und Spannungswerte rückwirkend aus dem bereits aufgezeichneten Verlauf ab.
Was die Integration mitbringt
| Panel | Sidebar-Eintrag „Mein Audi", von der Integration selbst angemeldet |
| Entitäten | sensor.audi_dashboard_* — Profil, Fahrten, Tankvorgänge, Fahrzeugstatus, Batterieverlauf, Reifenzähler |
| Dienste | audi_dashboard.* — 18 Stück, in Entwicklerwerkzeuge → Aktionen dokumentiert |
| Daten | /config/audi_dashboard/ — JSON und JSON Lines, dauerhaft, nie von einem Update angefasst |
| Abhängigkeit | pypdf (für Tankbelege), von Home Assistant automatisch nachinstalliert |
Die Nutzlast der Entitäten steckt im Attribut daten und ist ausdrücklich von
der Aufzeichnung ausgenommen — das Fahrtenarchiv wächst über Jahre auf
Hunderte Kilobyte und hat in der Recorder-Datenbank nichts verloren.
Companion-App (iOS)
companion-app/ ist dieselbe Oberfläche als eigenständige App (React +
Capacitor), die über die HA-API auf dieselben Entitäten und Dienste zugreift.
Sie trägt ihre Version fest einkompiliert und meldet selbst, wenn sie älter
ist als die installierte Integration — siehe
VERSIONIERUNG.md.
Ordner in diesem Repository
| Ordner | Inhalt |
|---|---|
custom_components/audi_dashboard/ |
die Integration — Backend und Panel-Dateien |
companion-app/ |
die iOS-App |
design-system/ |
gemeinsame UI-Bausteine (@audi-dash/ui) |
homeassistant/ |
Installationspaket, Konfigurationsschnipsel, Anleitungen |
testumgebung/ |
Wegwerf-Home-Assistant in Docker für Entwicklung und Tests |
tests/belegparser/ |
Regressionstest des Tankbeleg-Lesers |