Vergangene Daten aus dem HA-Verlauf importierbar, Auslieferstand bereinigt

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 <[email protected]>

homeassistant/installationspaket/install.ps1

@@ -12,6 +12,35 @@
     4. configuration_snippet.yaml wird in <Ziel>\configuration.yaml eingefügt
     5. ha_token.txt wird geschrieben, wenn -Token übergeben wurde
 
+  SICHERHEIT GEGENÜBER DER BESTEHENDEN HA-INSTALLATION
+  ----------------------------------------------------
+  Das Skript ist so gebaut, dass es eine laufende Home-Assistant-Installation
+  (auch HA OS) nicht gefährden kann. Konkret und nachprüfbar:
+
+    - Es LÖSCHT NIE etwas. Im gesamten Skript kommt kein Remove-Item vor, und
+      kopiert wird bewusst ohne robocopy /MIR - fremde Dateien in pyscript\
+      und www\ bleiben liegen, es wird nur ergänzt.
+    - Es fasst .storage\ nicht an: keine Integrationen, keine Geräte, keine
+      Entitäten, keine Benutzer, keine Automatisierungen. automations.yaml,
+      scripts.yaml, scenes.yaml und secrets.yaml werden nicht gelesen und
+      nicht geschrieben.
+    - Es startet Home Assistant nicht neu und greift nicht in den laufenden
+      Betrieb ein. Bis zum manuellen Neustart ändert sich am Verhalten der
+      Instanz nichts.
+    - Die einzige Datei außerhalb der eigenen Ordner, die überhaupt verändert
+      wird, ist configuration.yaml - und das ist der einzige Weg, auf dem
+      dieses Skript HA am Starten hindern könnte. Deshalb dort drei Netze:
+      eine zeitgestempelte Sicherung vor jeder Änderung, ein Abbruch ohne
+      jede Änderung falls dort schon fremde pyscript:/panel_custom:-Blöcke
+      stehen, und eine Rücklese-Prüfung nach dem Schreiben, die bei der
+      kleinsten Abweichung automatisch zurückrollt.
+    - -Pruefen zeigt den kompletten Ablauf, ohne irgendetwas zu schreiben.
+      Im Zweifel damit anfangen.
+
+  Was das Skript NICHT kann: pyscript installieren (das macht HACS),
+  pypdf nachinstallieren (braucht eine Shell auf der HA-Maschine) und HA
+  neu starten. Diese Schritte stehen am Ende als Restliste.
+
   Grundsatz: nichts kaputtmachen, was schon da ist. Das Skript ist darauf
   ausgelegt, gefahrlos mehrfach zu laufen (etwa nach einem Abbruch):
 
@@ -214,30 +243,70 @@ if ($fremdePyscript -or $fremdePanel) {
     Write-Host ""
     Write-Host "  Bitte von Hand zusammenführen (Inhalt aus configuration_snippet.yaml):" -ForegroundColor Yellow
     Write-Host "    - unter pyscript:     allow_all_imports: true"
+    Write-Host "    -                     hass_is_global: true"
     Write-Host "    - unter panel_custom: den Listeneintrag 'audi-dashboard-panel'"
     [void]$restliste.Add("configuration.yaml von Hand ergänzen (siehe Hinweis oben) - zwei gleiche Top-Level-Schlüssel wären ungültiges YAML.")
 } elseif ($Pruefen) {
     if ($schonDa) { Info "würde den vorhandenen Mein-Audi-Block ersetzen" }
     else          { Info "würde den Mein-Audi-Block anhängen" }
 } else {
-    Copy-Item $configYaml "$configYaml.bak" -Force
-    Info "Sicherung: configuration.yaml.bak"
+    # Zeitgestempelte Sicherung statt einer festen .bak: die feste Datei wurde
+    # bei einem zweiten Lauf von der bereits geänderten Fassung überschrieben -
+    # ausgerechnet das Original, auf das man im Notfall zurückwill, war dann weg.
+    $sicherung = "$configYaml.bak"
+    $stempel = Get-Date -Format "yyyyMMdd-HHmmss"
+    $sicherungZeit = "$configYaml.$stempel.bak"
+    Copy-Item $configYaml $sicherungZeit -Force
+    if (-not (Test-Path $sicherung)) { Copy-Item $configYaml $sicherung -Force }
+    Info "Sicherung: $(Split-Path $sicherungZeit -Leaf)"
+
     if ($schonDa) {
         $neu = [regex]::Replace(
             $inhalt,
             "(?ms)" + [regex]::Escape($markeAuf) + ".*?" + [regex]::Escape($markeZu) + "\r?\n?",
             [System.Text.RegularExpressions.MatchEvaluator]{ param($m) $block }
         )
-        Gut "vorhandenen Block ersetzt"
     } else {
         $trenner = ""
         if ($inhalt.Length -gt 0 -and -not $inhalt.EndsWith("`n")) { $trenner = "`r`n" }
         $neu = $inhalt + $trenner + "`r`n" + $block
-        Gut "Block angehängt"
     }
     # Ohne BOM schreiben - HA liest die Datei als YAML, ein BOM hat da nichts
     # zu suchen (Out-File -Encoding utf8 setzt in PowerShell 5.1 eines).
     [System.IO.File]::WriteAllText($configYaml, $neu, (New-Object System.Text.UTF8Encoding($false)))
+
+    # Rücklesen und prüfen, bevor wir die Datei so stehen lassen. Eine kaputte
+    # configuration.yaml ist der einzige Weg, auf dem dieses Skript eine
+    # laufende Home-Assistant-Installation lahmlegen könnte (HA startet dann
+    # nicht mehr) - deshalb wird das Ergebnis hier verifiziert und im
+    # Zweifelsfall sofort zurückgerollt, statt es dem Nutzer zu überlassen.
+    $kontrolle = [System.IO.File]::ReadAllText($configYaml, $utf8OhneBom)
+    $bestandNoch = [regex]::Replace(
+        $kontrolle,
+        "(?ms)" + [regex]::Escape($markeAuf) + ".*?" + [regex]::Escape($markeZu) + "\r?\n?",
+        ""
+    )
+    $treffer = ([regex]::Matches($kontrolle, [regex]::Escape($markeAuf))).Count
+    $heil = $true
+    $grund = ""
+    if ($kontrolle.Length -lt $inhalt.Length) {
+        $heil = $false; $grund = "die Datei ist kürzer geworden als vorher"
+    } elseif ($treffer -ne 1) {
+        $heil = $false; $grund = "der Mein-Audi-Block steht $treffer mal statt genau einmal darin"
+    } elseif ($bestandNoch.Trim() -ne $ohneUnserenBlock.Trim()) {
+        $heil = $false; $grund = "der bisherige Inhalt der Datei hat sich verändert"
+    }
+
+    if (-not $heil) {
+        Copy-Item $sicherungZeit $configYaml -Force
+        Warnung "configuration.yaml wurde zurückgerollt - $grund."
+        Write-Host "  Die Datei ist unverändert wie vor dem Start dieses Skripts." -ForegroundColor Yellow
+        [void]$restliste.Add("configuration.yaml von Hand ergänzen (Inhalt aus configuration_snippet.yaml) - der automatische Weg wurde aus Sicherheitsgründen zurückgenommen.")
+    } elseif ($schonDa) {
+        Gut "vorhandenen Block ersetzt (geprüft)"
+    } else {
+        Gut "Block angehängt (geprüft)"
+    }
 }
 
 # --------------------------------------------------------------- 5. Token
@@ -258,9 +327,15 @@ if (Test-Path $tokenDatei) {
 }
 
 # --------------------------------------------------------------- Restliste
+# Bewusst nicht automatisch eingefügt: der recorder-Block ist eine Entscheidung
+# über den Plattenplatz der Instanz (ein Jahr Fahrzeugverlauf sind grob 1-1,5 GB,
+# siehe Kopf von recorder_snippet.yaml), und viele Instanzen haben bereits einen
+# eigenen recorder:-Block mit anderen Einstellungen. Zusammenführen ist Handarbeit.
+[void]$restliste.Add("ZEITKRITISCH - Datenaufbewahrung: den Block aus recorder_snippet.yaml in die configuration.yaml übernehmen. Home Assistant löscht Sensor-Verläufe sonst nach 10 Tagen; was weg ist, lässt sich auch mit 'Daten importieren aus Home Assistant' nicht mehr nachtragen. Je früher der Block drin ist, desto mehr Vergangenheit bleibt erhalten. VORHER Einstellungen -> System -> Speicher prüfen: ein Jahr Verlauf braucht grob 1-1,5 GB. Bei wenig freiem Platz (SD-Karte, kleine eMMC) mit purge_keep_days: 90 anfangen - Details im Kopf der Datei.")
 [void]$restliste.Add("Home Assistant neu starten: Einstellungen -> System -> Neu starten.")
 [void]$restliste.Add("Nur für Tankbeleg-Upload: auf der HA-Maschine 'pip install pypdf' ausführen (Terminal-&-SSH-Add-on oder docker exec).")
-[void]$restliste.Add("Nach dem Neustart in der App: Einstellungen -> Fahrzeug einrichten -> Setup - Sensoren zuordnen. Zwingend für die Fahrterkennung ist der Zündungs-/ACC-Sensor (binary_sensor, meist vom Teltonika FMM003).")
+[void]$restliste.Add("Nach dem Neustart in der App: Einstellungen -> Fahrzeug einrichten -> Setup - Sensoren zuordnen. Im Auslieferstand ist KEIN Sensor vorbelegt; zwingend für die Fahrterkennung ist der Zündungs-/ACC-Sensor (binary_sensor, meist vom Teltonika FMM003). Danach einmal neu starten - die drei trigger-gebundenen Felder (Zündung, Kilometerstand, Tankfüllstand) werden erst dann wirksam.")
+[void]$restliste.Add("Optional, sobald die Sensoren zugeordnet sind: Einstellungen -> Einrichten -> 'Daten importieren aus Home Assistant' holt Fahrten, Tankvorgänge und Spannungswerte aus dem bereits aufgezeichneten HA-Verlauf nach.")
 
 Write-Host ""
 if ($Pruefen) {