tobias
3b99f1f332
Datenaufbewahrung (recorder_snippet.yaml, neu): Home Assistant loescht Sensor-Verlaeufe standardmaessig nach 10 Tagen - das war die stille Obergrenze dafuer, wie weit sich ueberhaupt je etwas rekonstruieren laesst, denn geloeschte recorder-Zeilen sind endgueltig weg. Der Block hebt das auf 365 Tage. Die Bestaende der App selbst (fahrten.jsonl, tankvorgaenge.jsonl, batteriespannung.jsonl, fahrzeugprofil.json) waren davon nie betroffen, die kennen ohnehin keine Purge-Logik. Platzbedarf an der Testinstanz gemessen statt geschaetzt: 90.858 Zeilen in 17 Tagen, hochgerechnet grob 1,9 Mio. Zeilen und 1-1,5 GB im Jahr, davon 96 % aus der EU-Data-Act-Integration - dafuer liegt eine auskommentierte exclude:-Liste bei. Bewusst kein include:-Block, der wuerde jeder anderen Integration den Verlauf nehmen und dabei kaum Platz sparen. Historienimport (pyscript/historienimport.py, neu): neuer Dienst audi_dashboard_historie_importieren(start, ende) liest denselben Verlauf, den die Live-Trigger in Echtzeit sehen, und leitet rueckwirkend dieselben Datensaetze ab - Fahrten aus dem Zuendungsverlauf (inklusive der Pausenregel, kurze Unterbrechungen verschmelzen zu einer Fahrt), Tankvorgaenge nach derselben Tiefststand-Logik und denselben Schwellen wie tankerkennung.py, Tagesmin/-max der Batteriespannung. Mehrfach ausfuehrbar: ueberschneidet sich eine Fahrt mit einer bereits erfassten, wird sie uebersprungen statt doppelt angelegt. Erzeugte Datensaetze tragen source: "import". Gelesen wird ueber HAs eigene recorder-API (get_significant_states), nicht per direktem SQL auf home-assistant_v2.db: das Schema ist HA-intern und aendert sich zwischen Versionen, die Funktion ist die stabile Schnittstelle. Preis dafuer ist hass_is_global: true im pyscript-Block; ohne die Zeile laeuft alles andere unveraendert weiter, nur der Import meldet, dass er den Verlauf nicht lesen kann. Oberflaeche in beiden Codebasen: Knopf "Daten importieren aus Home Assistant" unter Einstellungen -> Einrichten, dahinter ein Fenster mit Von/Bis (Vorbelegung: letzte 30 Tage), "Importieren" als Hauptaktion und "Abbrechen" als zweite Wahl. Das Fenster bleibt offen und zeigt das Ergebnis, statt optimistisch zu schliessen - hier ist das Ergebnis der Zweck des Aufrufs. Fortschritt ueber die Entitaet pyscript.audi_dashboard_import_status, weil pyscript-Dienste sofort zurueckkehren. In companion-app bewusst NICHT ueber die Offline-Warteschlange: ein spaeter aus dem Nichts abgefeuerter Importlauf waere fuer den Nutzer nicht nachvollziehbar. Beim Testen gefunden und mitgefixt: profil.batterieverlauf_tageswert_ aktualisieren() haengte in Einfuegereihenfolge an. Solange nur die Live-Aufzeichnung schrieb, war das dasselbe wie sortiert (sie traegt immer den heutigen Tag ein) - der Import traegt vergangene Tage nach, die waeren hinter den neueren gelandet und das Diagramm haette zeitlich rueckwaerts gelaufen. Sortiert jetzt nach Datum, wie der eigene Docstring es ohnehin versprach. Auslieferstand bereinigt: einstellungen.py brachte zwei Entity-IDs einer laengst abgeraeumten Testinstanz mit (testzone_fmm003_...). Beim Testen unsichtbar, weil die Testinstanz sie ueber entitaeten.json ueberschreibt - auf einer Neuinstallation waeren sie die wirksamen Werte gewesen. Und schlimmer als nur wirkungslos: fahrterkennung.py registriert seinen @state_trigger nur, wenn das Feld belegt ist, ausdruecklich als Schutz gegen eine leere Entity-ID. Ein gesetzter, aber nicht existierender Wert hebelt genau diesen Schutz aus. Beide Felder jetzt leer wie alle anderen; Kopfkommentar der Datei ueberarbeitet, er behauptete noch, die EU-Data-Act-Integration werde nicht mehr verwendet. install.ps1 abgesichert, da die erste echte Installation auf HA OS ansteht: die feste configuration.yaml.bak wurde bei jedem Lauf ueberschrieben, ausgerechnet das Original war nach dem zweiten Lauf weg - Sicherungen jetzt zeitgestempelt. Nach dem Schreiben wird die Datei zurueckgelesen und geprueft (Laenge, genau ein Markerblock, bisheriger Inhalt unveraendert); bei der kleinsten Abweichung rollt das Skript automatisch zurueck. Die Sicherheitseigenschaften stehen jetzt im Kopf der Datei, statt dass man ihnen glauben muss. Standort-Blatt: "Teilen" war im Tagmodus unsichtbar - .standort-pille nutzte var(--tile), das Blatt darunter var(--tile-deckend), und die iOS-Auflage setzt im Tagmodus beide auf #FFFFFF. Gemessener Kontrast 1,00:1, weiss auf weiss. Beide Pillen folgen jetzt der Knopfsprache des Panels (.aktion / .aktion.primaer): Umriss fuer die Nebenaktion, var(--fg) gefuellt fuer "Route". Danach 17-21:1 Textkontrast in beiden Themes. Nebenbei ist damit --line-strong - eine Linienfarbe - nicht laenger als Knopffuellung im Einsatz. Geprueft: Import zweimal ueber die echte Oberflaeche im Browser gegen eine in die recorder-DB eingespielte Kunsthistorie (der Testcontainer laeuft nicht, waehrend das Auto faehrt, echte Fahrten liegen dort also nicht vor) - drei Fahrten wie erwartet, die 5-Minuten-Unterbrechung korrekt zu einer 50-Minuten-Fahrt verschmolzen, die 30-Sekunden-Zuendung verworfen, Strecken kilometergenau; zweiter Lauf legte 0 an und meldete 3 als vorhanden. Neuinstallation in einem Wegwerf-Container: nur Profilvorlage und Parser, keine Fahrten-/Tank-/Batteriedatei, null Fehler im Log. install.ps1 gegen Attrappen: -Pruefen schreibt nichts, echter Lauf laesst automations.yaml bytegleich (SHA-256) und fremde Bloecke stehen, Ergebnis parst als gueltiges HA-YAML, zweiter Lauf idempotent, bei fremdem pyscript:/panel_custom: bleibt die Datei bytegleich. tsc --noEmit sauber, companion-app-Tests 106/106, vite build sauber, HA-Configcheck und Start ohne Fehler. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
104 lines
5.2 KiB
YAML
104 lines
5.2 KiB
YAML
# Datenaufbewahrung (recorder) — Ergänzung zur bestehenden configuration.yaml.
|
||
#
|
||
# WOFÜR DAS DA IST
|
||
# ----------------
|
||
# Home Assistant löscht Sensor-Verlaufsdaten standardmäßig nach 10 Tagen
|
||
# (recorder.purge_keep_days, Standardwert). Das ist die Obergrenze dafür, wie
|
||
# weit ein späterer Import "Daten aus Home Assistant importieren" überhaupt
|
||
# zurückreichen KANN — was der recorder gelöscht hat, ist unwiederbringlich
|
||
# weg, auch für die App.
|
||
#
|
||
# Die App selbst speichert dagegen bereits unbegrenzt: fahrten.jsonl,
|
||
# tankvorgaenge.jsonl, batteriespannung.jsonl und fahrzeugprofil.json unter
|
||
# /config/audi_dashboard/ werden nirgends automatisch gekürzt oder gelöscht
|
||
# (siehe profil.py — es gibt keine Purge-Logik). Betroffen ist also nur der
|
||
# ROHE Sensor-Verlauf in Home Assistants eigener Datenbank, aus dem die App
|
||
# ihre Datensätze erst ableitet.
|
||
#
|
||
# Dieser Block hebt die Aufbewahrung auf ein Jahr an. Das ist die
|
||
# Übergangslösung, bis die App die Daten selbst dauerhaft übernimmt: fährt
|
||
# der Import einmal über einen Zeitraum, liegen die daraus erzeugten Fahrten/
|
||
# Tankvorgänge/Spannungswerte dauerhaft in den .jsonl-Beständen und sind vom
|
||
# recorder unabhängig.
|
||
#
|
||
# EINBAU
|
||
# ------
|
||
# Diesen Block in die bestehende configuration.yaml übernehmen (nicht die
|
||
# Datei ersetzen). Existiert dort schon ein `recorder:`-Block, die Werte dort
|
||
# zusammenführen statt einen zweiten anzulegen. Danach Home Assistant neu
|
||
# starten (Entwicklerwerkzeuge -> YAML -> Neu starten).
|
||
#
|
||
# PLATZBEDARF — an der Testinstanz gemessen, nicht geschätzt
|
||
# ---------------------------------------------------------
|
||
# Stand 2026-08-23: 90.858 Zustandsänderungen in 17 Tagen = rund 5.300 pro
|
||
# Tag, Datenbank 64,7 MB. Hochgerechnet auf 365 Tage sind das grob 1,9 Mio.
|
||
# Zeilen und in der Größenordnung 1–1,5 GB.
|
||
#
|
||
# ACHTUNG bei HA OS auf kleinem Datenträger (Raspberry Pi mit SD-Karte,
|
||
# 32-GB-eMMC): das ist der einzige Punkt dieser ganzen App, der einer sonst
|
||
# gesunden Installation gefährlich werden kann. Läuft der Datenträger voll,
|
||
# startet Home Assistant nicht mehr sauber - unabhängig von dieser App.
|
||
#
|
||
# Vor dem Einbau deshalb einmal nachsehen, wie viel Platz frei ist:
|
||
# Einstellungen -> System -> Speicher. Faustregel: mindestens 5 GB frei,
|
||
# sonst besser mit einem kürzeren Zeitraum anfangen (z. B.
|
||
# purge_keep_days: 90) und die auskommentierte exclude:-Liste unten gleich
|
||
# mit aktivieren. 90 Tage reichen für den Zweck "Vergangenheit nachtragen"
|
||
# in aller Regel aus - der Import holt die Daten ja dauerhaft in die
|
||
# .jsonl-Bestände der App, die danach vom recorder unabhängig sind.
|
||
#
|
||
# Nach ein paar Wochen noch einmal unter Einstellungen -> System -> Speicher
|
||
# nachsehen und bei Bedarf nachjustieren.
|
||
#
|
||
# 96 % dieser Zeilen stammen aus der EU-Data-Act-Integration
|
||
# (`cupra_eu_data_act`, ~1.737 Zustände je Entität in 17 Tagen, also etwa
|
||
# alle 14 Minuten ein Update über rund 50 Entitäten), 1 % vom FMM003 über
|
||
# flespi, 2 % alles Übrige. Wer den Platzbedarf drücken will, kürzt also bei
|
||
# der EU-Data-Act-Integration — die auskommentierte `exclude`-Liste unten ist
|
||
# ein Vorschlag dafür, welche Entitäten historisch nichts hergeben.
|
||
|
||
recorder:
|
||
# 365 Tage statt der 10 Tage Standardaufbewahrung.
|
||
purge_keep_days: 365
|
||
|
||
# Bewusst KEIN `include:`-Block. Ein `include` würde bedeuten, dass Home
|
||
# Assistant *nur noch* die dort genannten Entitäten aufzeichnet und für
|
||
# alles andere gar keinen Verlauf mehr führt — auch nicht für die 10 Tage,
|
||
# die es vorher hatte. Da auf dieser Instanz ohnehin 97 % der Aufzeichnung
|
||
# auf Fahrzeugdaten entfällt, spart das kaum Platz, kostet aber den Verlauf
|
||
# jeder anderen Integration. Deshalb: global ein Jahr aufbewahren.
|
||
|
||
# Standardmäßig 1 Sekunde. 30 Sekunden bündelt die Schreibvorgänge, was vor
|
||
# allem SD-Karten schont; der Preis ist, dass die letzten bis zu 30
|
||
# Sekunden bei einem harten Stromausfall fehlen können. Für Fahrzeugdaten,
|
||
# die ohnehin nur alle paar Minuten aktualisiert werden, ist das
|
||
# unerheblich.
|
||
commit_interval: 30
|
||
|
||
# Nächtliches Aufräumen (Standard 04:12) mit Neuaufbau der Datenbankdatei.
|
||
# repack gibt den durch gelöschte Zeilen frei gewordenen Platz auch
|
||
# tatsächlich ans Dateisystem zurück, statt die Datei nur intern als "leer"
|
||
# zu markieren — bei einem Jahr Aufbewahrung sonst der übliche Grund, warum
|
||
# die Datei nur noch wächst.
|
||
auto_purge: true
|
||
auto_repack: true
|
||
|
||
# OPTIONAL — nur einkommentieren, wenn die Datenbank zu groß wird.
|
||
# Diese Entitäten liefern über die Zeit keinen Erkenntniswert: reine
|
||
# Diagnose-/Netzwerkwerte des Trackers und abgeleitete Momentanwerte der
|
||
# EU-Data-Act-Integration, die sich jederzeit neu berechnen lassen.
|
||
# exclude:
|
||
# entity_globs:
|
||
# - sensor.*_tire_pressure_diff_*
|
||
# - sensor.*fmm003*_mobile_network_*
|
||
# - sensor.*fmm003*_lte_*
|
||
# - sensor.*fmm003*_network_*
|
||
# - sensor.*fmm003*_id_of_*
|
||
# - sensor.*fmm003*_*dilution_of_precision
|
||
# - sensor.*fmm003*_satellites
|
||
# entities:
|
||
# - sensor.audi_rs_4_avant_ei_t1302_echo
|
||
# - sensor.audi_rs_4_avant_ei_t1302_trueness
|
||
# - sensor.audi_rs_4_avant_uncurated_fields
|
||
# - sensor.audi_rs_4_avant_minutes_since_last_snapshot
|