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>
2026-08-11 00:10:53 +02:00
commit e1d570992e
151 changed files with 18162 additions and 0 deletions
@@ -0,0 +1,79 @@
+/* Rauchtest gegen die laufende HA-Testinstanz (Docker, Port 18123).
+   Prüft bewusst nur das, was ohne Zugangsdaten prüfbar ist:
+   die Adressbildung, die Existenz der Endpunkte und den Beginn des
+   WebSocket-Handshakes. Damit ist belegt, dass rest.ts und live.ts die
+   richtigen Pfade und das richtige Protokoll ansprechen - ohne dass dafür
+   irgendwo ein Token eingesammelt werden müsste.
+
+   Aufruf:  node scripts/smoke.ts            (Node >= 23, Typen werden entfernt)
+            node scripts/smoke.ts http://localhost:18123 */
+
+import { basisUrlNormalisieren, websocketUrl } from "../src/api/umgebung.ts";
+
+const BASIS = basisUrlNormalisieren(process.argv[2] ?? "http://localhost:18123");
+
+let fehler = 0;
+function pruefe(bezeichnung: string, bedingung: boolean, zusatz = ""): void {
+  console.log(`${bedingung ? "PASS" : "FAIL"}  ${bezeichnung}${zusatz ? `  (${zusatz})` : ""}`);
+  if (!bedingung) fehler += 1;
+}
+
+/* ------------------------------------------------- reine Funktionen */
+
+pruefe("basisUrlNormalisieren schneidet Schrägstriche ab",
+  basisUrlNormalisieren("https://host/") === "https://host");
+pruefe("basisUrlNormalisieren ergänzt fehlendes Schema",
+  basisUrlNormalisieren("host.example") === "https://host.example");
+pruefe("basisUrlNormalisieren lässt http stehen",
+  basisUrlNormalisieren("http://localhost:18123") === "http://localhost:18123");
+pruefe("websocketUrl macht aus https wss",
+  websocketUrl("https://h") === "wss://h/api/websocket");
+pruefe("websocketUrl macht aus http ws",
+  websocketUrl("http://h") === "ws://h/api/websocket");
+
+/* --------------------------------------------------- REST-Endpunkt */
+
+try {
+  const antwort = await fetch(`${BASIS}/api/`, { headers: { "Content-Type": "application/json" } });
+  /* Ohne Token muss HA mit 401 antworten. Genau das beweist zweierlei:
+     der Pfad /api/ existiert, und er ist nicht offen zugänglich. */
+  pruefe("GET /api/ ohne Token antwortet 401", antwort.status === 401, `Status ${antwort.status}`);
+} catch (e) {
+  pruefe("GET /api/ erreichbar", false, e instanceof Error ? e.message : String(e));
+}
+
+/* ---------------------------------------------- WebSocket-Handshake */
+
+const wsErgebnis = await new Promise<string>((fertig) => {
+  const frist = setTimeout(() => fertig("Zeitüberschreitung"), 8000);
+  try {
+    const socket = new WebSocket(websocketUrl(BASIS));
+    socket.addEventListener("message", (e: MessageEvent) => {
+      clearTimeout(frist);
+      try {
+        fertig(String(JSON.parse(String(e.data)).type));
+      } catch {
+        fertig("kein JSON");
+      }
+      socket.close();
+    });
+    socket.addEventListener("error", () => {
+      clearTimeout(frist);
+      fertig("Verbindungsfehler");
+    });
+  } catch (e) {
+    clearTimeout(frist);
+    fertig(e instanceof Error ? e.message : String(e));
+  }
+});
+
+/* live.ts wartet als Erstes auf genau diese Nachricht - stimmt sie nicht,
+   liefe der ganze Anmeldeablauf ins Leere. */
+pruefe("WebSocket meldet sich mit auth_required", wsErgebnis === "auth_required", `erhalten: ${wsErgebnis}`);
+
+console.log(fehler === 0 ? "\nAlle Prüfungen bestanden." : `\n${fehler} Prüfung(en) fehlgeschlagen.`);
+
+/* Nur den Rückgabewert setzen, nicht process.exit() aufrufen: unter Windows
+   stürzt libuv sonst mit einer Assertion ab, weil der eben geschlossene
+   WebSocket noch nicht vollständig abgebaut ist. So läuft Node normal aus. */
+process.exitCode = fehler === 0 ? 0 : 1;