pyscript-Backend zur echten HA-Integration umgebaut (HACS-fähig)

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

companion-app/src/api/index.ts

@@ -13,7 +13,7 @@ export * from "./live.ts";
 export * from "./warteschlange.ts";
 export * from "./ablageNativ.ts";
 
-import { ENTITAETEN } from "./types.ts";
+import { DIENST_DOMAIN, ENTITAETEN } from "./types.ts";
 import type { Fahrt, Fahrzeugstatus, ImportErgebnis, Profil, Tankvorgang } from "./types.ts";
 import { HassRest } from "./rest.ts";
 import { HassLive } from "./live.ts";
@@ -34,7 +34,7 @@ export interface TankvorgangFelder {
 }
 
 /** Eingabefelder für Fahrten - Namen wie beim Backend (fahrterkennung.py:
-    audi_dashboard_fahrt_manuell_anlegen/audi_dashboard_fahrt_aktualisieren).
+    fahrt_manuell_anlegen/fahrt_aktualisieren).
     Alles außer den Zeitpunkten ist optional: leer bleibt es liegen, bis das
     Kilometerstand-Screening (§7.2) oder eine spätere Bearbeitung es füllt. */
 export interface FahrtFelder {
@@ -92,8 +92,8 @@ export class DataMetricApi {
 
   profilSchreiben(profil: Profil): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_profil_schreiben",
+      DIENST_DOMAIN,
+      "profil_schreiben",
       { profil_json: JSON.stringify(profil) },
       "Fahrzeugdaten speichern",
     );
@@ -101,8 +101,8 @@ export class DataMetricApi {
 
   belegHochladen(pdfBase64: string, dateiname: string, tankId?: string): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_beleg_hochladen",
+      DIENST_DOMAIN,
+      "beleg_hochladen",
       { pdf_base64: pdfBase64, dateiname, ...(tankId ? { tank_id: tankId } : {}) },
       `Beleg „${dateiname}" hochladen`,
     );
@@ -111,8 +111,8 @@ export class DataMetricApi {
   /** Legt eine Fahrt von Hand an — für Fahrten ohne automatische Erkennung. */
   fahrtAnlegen(felder: FahrtFelder): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_fahrt_manuell_anlegen",
+      DIENST_DOMAIN,
+      "fahrt_manuell_anlegen",
       { ...felder },
       "Fahrt eintragen",
     );
@@ -122,8 +122,8 @@ export class DataMetricApi {
       Hand angelegt. */
   fahrtAktualisieren(tripId: string, felder: FahrtFelder): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_fahrt_aktualisieren",
+      DIENST_DOMAIN,
+      "fahrt_aktualisieren",
       { trip_id: tripId, ...felder },
       "Fahrt ändern",
     );
@@ -131,8 +131,8 @@ export class DataMetricApi {
 
   fahrtLoeschen(tripId: string): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_fahrt_loeschen",
+      DIENST_DOMAIN,
+      "fahrt_loeschen",
       { trip_id: tripId },
       "Fahrt löschen",
     );
@@ -142,8 +142,8 @@ export class DataMetricApi {
       Parameternamen — belegverarbeitung.py). */
   tankvorgangAnlegen(felder: TankvorgangFelder): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_tankvorgang_manuell",
+      DIENST_DOMAIN,
+      "tankvorgang_manuell",
       { ...felder },
       "Tankvorgang eintragen",
     );
@@ -151,8 +151,8 @@ export class DataMetricApi {
 
   tankvorgangAktualisieren(tankId: string, felder: TankvorgangFelder): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_tankvorgang_aktualisieren",
+      DIENST_DOMAIN,
+      "tankvorgang_aktualisieren",
       { tank_id: tankId, ...felder },
       "Tankvorgang ändern",
     );
@@ -160,8 +160,8 @@ export class DataMetricApi {
 
   tankvorgangLoeschen(tankId: string): Promise<unknown> {
     return this.warteschlange.einreihen(
-      "pyscript",
-      "audi_dashboard_tankvorgang_loeschen",
+      DIENST_DOMAIN,
+      "tankvorgang_loeschen",
       { tank_id: tankId },
       "Tankvorgang löschen",
     );
@@ -169,10 +169,10 @@ export class DataMetricApi {
 
   /** Stößt eine sofortige Aktualisierung im Backend an (Pull-to-refresh). */
   jetztAktualisieren(): Promise<unknown> {
-    return this.rest.dienstAufrufen("pyscript", "audi_dashboard_jetzt_aktualisieren");
+    return this.rest.dienstAufrufen(DIENST_DOMAIN, "jetzt_aktualisieren");
   }
 
-  /** Welchen Oberflächen-Stand das Backend ausliefert (Datei VERSION, siehe
+  /** Welchen Oberflächen-Stand das Backend ausliefert (Version der Integration, siehe
       VERSIONIERUNG.md). `null`, wenn die Entität fehlt — etwa weil das Backend
       älter ist als diese Funktion; dann wird nichts verglichen und nichts
       gemeldet, statt einen Fehlalarm auszulösen. */
@@ -198,7 +198,7 @@ export class DataMetricApi {
   /** Startet den Import. Kehrt zurück, sobald das Backend den Auftrag
       angenommen hat — nicht, wenn er fertig ist; dafür importStatusLesen(). */
   historieImportieren(start: string, ende: string): Promise<unknown> {
-    return this.rest.dienstAufrufen("pyscript", "audi_dashboard_historie_importieren", {
+    return this.rest.dienstAufrufen(DIENST_DOMAIN, "historie_importieren", {
       start,
       ende,
     });