Initialer Import: HA-Panel, Design-System, Companion-App

Drei zusammengehörige Teile in einem Repository:

- homeassistant/  Das fertige, im Einsatz befindliche Home-Assistant-Panel
  (panel_custom Custom Element + pyscript-Backend). Echte Fahrzeug- und
  Personendaten (fahrzeugprofil.json, fahrten.jsonl, tankvorgaenge.jsonl,
  Tankbelege) bleiben per .gitignore außen vor; die anonymisierte Vorlage
  fahrzeugprofil.example.json ist mit dabei.

- design-system/  Eigenständige React-Komponentenbibliothek (@audi-dash/ui),
  die die visuelle Sprache des Panels nachbildet - ohne Audi-Markenzeichen
  und ohne die lizenzierte Hausschrift. Dient als Grundlage für Claude
  Design. War bis hierher ein eigenes Repository und ist in dieses
  eingeschmolzen worden.

- companion-app/  Datenschicht der neuen App DataMetric360 (iOS/Android via
  Capacitor, zusätzlich als Iframe im HA-Dashboard). Noch ohne Oberfläche:
  REST- und WebSocket-Zugriff auf Home Assistant plus Warteschlange für
  Änderungen ohne Netz. Ersetzt das eingespritzte hass-Objekt, das nur
  innerhalb des HA-Frontends existiert.

Dazu die Projektdokumentation: SPECIFICATION.md (Ist-Stand des Panels),
COMPANION_APP_ARCHITECTURE.md (Architekturentscheidungen der neuen App),
AUDIT_2026-08-10.md, DESIGN_BRIEF_DATAMETRIC360.md und der ursprüngliche
Bauauftrag.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

homeassistant/www/audi-dashboard-panel.js

@@ -0,0 +1,47 @@
+/* ================================================================
+   Audi-Dashboard — Lade-Stub für panel_custom
+   ================================================================
+   Diese Datei selbst ändert sich praktisch nie und bleibt deshalb auch mit
+   der langen Standard-Cache-Zeit von Home Assistant für /local/ (31 Tage,
+   Cache-Control: public, max-age=2678400 - an der Testinstanz nachgemessen,
+   nicht vermutet) unproblematisch: sie lädt bei jedem vollständigen
+   Seitenaufruf zuerst audi-dashboard-version.json mit cache:"no-store" -
+   das erzwingt eine echte Netzwerkanfrage, unabhängig vom HTTP-Cache -, und
+   reicht deren Versionsnummer als Query-Parameter an den eigentlichen
+   Code (audi-dashboard-app.js) weiter. Jede neue Versionsnummer ist aus
+   Sicht des Browsers eine neue URL und wird deshalb nie aus einem alten
+   Cache bedient.
+
+   Update-Ablauf ohne Neustart und ohne Cache-Probleme:
+   1. audi-dashboard-app.js und/oder audi-dashboard.css ersetzen
+   2. die Zahl in audi-dashboard-version.json um 1 erhöhen
+   3. im Browser einmal ganz normal neu laden (kein Hard-Refresh nötig)
+   Diese Datei hier (audi-dashboard-panel.js) bleibt dabei unangetastet -
+   configuration.yaml und damit ein HA-Neustart sind für Frontend-Updates
+   nicht mehr nötig, nur noch für den allerersten Einbau (§10 Punkt 1).
+
+   Bekannte HA-Eigenheit (an der Testinstanz reproduziert, nicht vermutet):
+   ha-panel-custom cached geladene Skripte nur für den alten js_url-Typ,
+   nicht für module_url (siehe dessen eigener Quellcode - für "js" gibt es
+   ein url-indiziertes Cache-Objekt, für "module" fehlt das komplett). Bei
+   einem direkten/harten Seitenaufruf (nicht bei SPA-interner Navigation)
+   kann das dazu führen, dass dieses Skript zweimal als <script type=module>
+   eingefügt wird, bevor das erste fertig geladen hat - beobachtet als zwei
+   Netzwerk-Requests für diese Datei und ein hängenbleibendes "Lädt …" ohne
+   Fehler in der eigentlichen App. Der Cache unten macht starten() robust
+   gegen so einen doppelten Aufruf: der zweite Aufruf wartet einfach auf das
+   Ergebnis des ersten, statt selbst nochmal zu fetchen/zu importieren. */
+window.__audiDashboardStarten =
+  window.__audiDashboardStarten ||
+  (async () => {
+    let version = Date.now(); // Fallback, falls version.json nicht erreichbar ist
+    try {
+      const antwort = await fetch("/local/audi-dashboard-version.json", { cache: "no-store" });
+      const daten = await antwort.json();
+      version = daten.version;
+    } catch (e) {
+      console.warn("audi_dashboard: version.json nicht erreichbar, nutze Zeitstempel als Cache-Buster", e);
+    }
+    await import(`/local/audi-dashboard-app.js?v=${version}`);
+  })();
+await window.__audiDashboardStarten;