Phase 2: Doku an Codestand angleichen, profil_lesen haerten

Doku-Drift behoben: die Statistik-Seite rechnet laengst echt (Behauptung
stand an drei Stellen), INSTALL.md nannte in Schritt 4 vier Variablennamen,
die es nie gab, README erwaehnte die entfernte 97-Prozent-Volltankungsregel
und liess fuenf pyscript-Dateien in der Uebersicht aus. Obsoleter
TODO-Kommentar in belegverarbeitung.py entfernt.

profil_lesen() gibt bei fehlender oder beschaedigter Profildatei None
zurueck statt zu werfen; alle sieben Aufrufstellen fangen den Fall ab.
An der Testinstanz geprueft: Datei entfernt, es folgt eine verstaendliche
Fehlermeldung mit Verweis auf INSTALL.md statt eines Tracebacks pro
Trigger-Durchlauf, Home Assistant laeuft normal weiter.

homeassistant/pyscript/backup.py

@@ -44,6 +44,8 @@ def _backup_jetzt():
 
 def _letztes_backup_vermerken():
     p = profil.profil_lesen()
+    if p is None:
+        return
     p.setdefault("einstellungen", {})["letztes_backup"] = datetime.datetime.now().isoformat()
     profil.profil_schreiben(p)
     frontend_veroeffentlichung.profil_veroeffentlichen()
@@ -60,6 +62,8 @@ def audi_dashboard_backup_jetzt():
 @time_trigger("cron(0 4 * * *)")
 def _automatisches_backup():
     p = profil.profil_lesen()
+    if p is None:
+        return
     intervall = p.get("einstellungen", {}).get("backup_intervall", "aus")
     heute = datetime.date.today()
     faellig = (

homeassistant/pyscript/belegverarbeitung.py

@@ -38,7 +38,7 @@ import einstellungen
 import frontend_veroeffentlichung
 import profil
 
-PARSER_SKRIPT = "/config/audi_dashboard/shell_beleg_parser.py"  # TODO: Datei ablegen
+PARSER_SKRIPT = "/config/audi_dashboard/shell_beleg_parser.py"
 
 
 # --------------------------------------------------------------- Hilfsfunktionen

homeassistant/pyscript/fahrterkennung.py

@@ -34,11 +34,15 @@ _fahrt_start_ts = None
 
 def _profil_wlan_name():
     p = profil.profil_lesen()
+    if p is None:
+        return None
     return p.get("fahrzeug", {}).get("wlan_name")
 
 
 def _pausenzeit_sekunden():
     p = profil.profil_lesen()
+    if p is None:
+        return 15 * 60
     return p.get("einstellungen", {}).get("fahrten_pausenzeit_min", 15) * 60
 
 

homeassistant/pyscript/modules/frontend_veroeffentlichung.py

@@ -24,7 +24,10 @@ import profil
 
 
 def profil_veroeffentlichen():
-    state.set("pyscript.audi_dashboard_profil", "aktuell", new_attributes={"daten": profil.profil_lesen()})
+    daten = profil.profil_lesen()
+    if daten is None:
+        return
+    state.set("pyscript.audi_dashboard_profil", "aktuell", new_attributes={"daten": daten})
 
 
 def fahrten_veroeffentlichen():

homeassistant/pyscript/modules/profil.py

@@ -49,10 +49,29 @@ def ordner_sicherstellen():
 # ----------------------------------------------------------- Fahrzeugprofil
 
 def profil_lesen():
+    """Liest das Fahrzeugprofil, oder None wenn es fehlt bzw. beschädigt ist.
+
+    Ohne diese Prüfung reißt eine fehlende Datei (Installation unvollständig,
+    siehe INSTALL.md Schritt 2) jeden Trigger und jeden Service mit, der das
+    Profil braucht — bei laufenden Zeittriggern also im Minutentakt. Jeder
+    Aufrufer muss den None-Fall abfangen."""
+    if not os.path.exists(PROFIL_PFAD):
+        log.error(
+            f"audi_dashboard: {PROFIL_PFAD} fehlt. Siehe INSTALL.md Schritt 2 — "
+            "bis dahin bleiben alle Funktionen aus, die das Profil brauchen."
+        )
+        return None
     f = task.executor(io.open, PROFIL_PFAD, "r")
     inhalt = f.read()
     f.close()
-    return json.loads(inhalt)
+    try:
+        return json.loads(inhalt)
+    except ValueError as fehler:
+        log.error(
+            f"audi_dashboard: {PROFIL_PFAD} ist kein gültiges JSON ({fehler}). "
+            "Letztes Backup aus audi_dashboard/backups/ zurückspielen."
+        )
+        return None
 
 
 def profil_schreiben(profil):

homeassistant/pyscript/reifenzaehler.py

@@ -60,6 +60,8 @@ def _fortschreiben_und_veroeffentlichen(neuer_km, neuer_aktiv=None):
     Reihenfolge, damit beim Wechseln selbst keine km dem neuen Satz
     zugerechnet werden, die eigentlich noch auf dem alten gefahren wurden."""
     p = profil.profil_lesen()
+    if p is None:
+        return
     reifen = p.setdefault("reifen", {})
     saetze = reifen.setdefault("saetze", {})
     aktiv = reifen.get("aktiv", "sommer")

homeassistant/pyscript/tankerkennung.py

@@ -57,7 +57,10 @@ def _als_zahl(wert):
 
 def _schwelle_prozent():
     p = profil.profil_lesen()
-    tankvolumen = p.get("fahrzeug", {}).get("tankvolumen_liter") or STANDARD_TANKVOLUMEN_LITER
+    if p is None:
+        tankvolumen = STANDARD_TANKVOLUMEN_LITER
+    else:
+        tankvolumen = p.get("fahrzeug", {}).get("tankvolumen_liter") or STANDARD_TANKVOLUMEN_LITER
     liter_als_prozent = (LITER_SCHWELLE / tankvolumen) * 100
     return min(liter_als_prozent, PROZENT_SCHWELLE)