Merge branch 'umsetzung-datametric360': Companion-App-Phasen 1-10 uebernehmen

Bringt die vollstaendig gebaute DataMetric360-App zusammen (React/Vite,
21 Screens, Audi-Assets, PWA + native Capacitor-Huelle, 90+9 Tests) sowie
die profil_lesen()-Haertung gegen fehlende/kaputte Profildatei zusammen.

Konfliktaufloesung:
- AGENTS.md, INSTALL.md, README.md: main-Fassung war jeweils die
  chronologisch neuere, uebernommen und um die durch den Merge tatsaechlich
  erledigten Punkte ergaenzt (profil_lesen()-Haertung, Audit-Reste-Entscheidung).
- fahrterkennung.py: toten WLAN-Zweig vom Branch verworfen, Zuendungs-
  basierte Erkennung von main behalten.
- homeassistant/FMM003_MAPPING.md (MQTT/Mosquitto-Ansatz vom 2026-08-11,
  vor der Umstellung auf flespi) bewusst nicht uebernommen - main nutzt seit
  2026-08-12 flespi als alleinigen FMM003-Datenweg. UMSETZUNGSPLAN.md Phase 13
  entsprechend als ueberholt markiert, verweist auf AGENTS.md als massgeblich.
- REVIEW_main_2026-08-13.md, ha_install.md (add/add): main-Fassung war die
  spaetere Revision derselben Dokumente, uebernommen.

Die von REVIEW_main_2026-08-13.md befuerchtete Merge-Falle (profil_lesen()
gibt jetzt None zurueck, main-seitige Aufrufer pruefen das nicht) wurde
verifiziert als bereits entschaerft: alle 5 Aufrufstellen im gemergten Stand
(backup.py x2, fahrterkennung.py, frontend_veroeffentlichung.py,
reifenzaehler.py, tankerkennung.py) sind None-sicher.

installationspaket/ nicht Teil dieses Commits (gitignored, wird bei Bedarf
neu zusammengestellt).

homeassistant/pyscript/backup.py

@@ -53,6 +53,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()
@@ -69,6 +71,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

@@ -42,6 +42,8 @@ _fahrt_start_ts = None
 
 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

@@ -25,7 +25,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)