Installationsskript: eine Zeile statt dreissig Minuten Handarbeit

homeassistant/install.sh richtet das Panel samt Backend auf einer
Home-Assistant-Instanz ein und verdrahtet dabei die Selbstaktualisierung, so
dass danach alles Weitere ueber die Weboberflaeche laeuft: Sensoren zuordnen,
nach Updates suchen, einspielen.

Gedacht fuer das Add-on "Terminal & SSH" direkt auf der Instanz:
  bash <(curl -fsSL <ROH-URL>/homeassistant/install.sh)
Alternativ von einem Rechner aus mit --ziel gegen ein eingebundenes
config-Verzeichnis, oder mit --von gegen eine lokale Arbeitskopie.

Was es tut: pyscript installieren (neueste Version von GitHub, falls nicht
vorhanden), pyscript/ und www/ einspielen, den Belegleser mitliefern (er
liegt in data/, ist aber Code), fehlende Datenbestaende aus der Vorlage
anlegen, den Abschnitt in die configuration.yaml eintragen und
UPDATE_REPO_URL setzen.

Drei Eigenschaften, auf die es dabei ankommt:

- Mehrfach ausfuehrbar. Der Abschnitt in der configuration.yaml steht
  zwischen Markern und wird beim zweiten Lauf ersetzt statt angehaengt.
  Stehen pyscript oder panel_custom bereits ausserhalb dieses Abschnitts,
  weist das Skript darauf hin, statt einen doppelten Schluessel zu erzeugen.
- Vorhandene Daten bleiben unangetastet. Fahrzeugprofil, Fahrten,
  Tankvorgaenge und ein bereits hinterlegtes Token werden nie ueberschrieben,
  nur fehlende Dateien angelegt.
- Die configuration.yaml wird vor jeder Aenderung mit Zeitstempel gesichert.

Geprueft gegen eine frische Home-Assistant-Instanz im Container: HA startet
ohne Konfigurationsfehler, alle neun pyscript-Entitaeten werden
veroeffentlicht, das Panel ist als "Mein Audi" mit mdi:car-sports unter
/audi-dashboard-panel registriert und rendert im Browser mit fuenf Tabs. Ein
zweiter Durchlauf laesst Profil und Token unveraendert und den
Konfigurationsabschnitt genau einmal stehen.

Ausserdem den blockierenden Verlaufsabruf in fahrtabschluss_logik.py
uebernommen: urlopen lief direkt statt ueber task.executor, was Home
Assistant seit 2026.8 abbricht - jede Fahrt waere ohne Strecke geblieben.
Der Fix lag bisher nur im Branch umsetzung-datametric360; eine frische
Installation haette den Fehler sonst mitgebracht.

INSTALL.md nennt den schnellen Weg jetzt vor der ausfuehrlichen Anleitung.

homeassistant/INSTALL.md

@@ -34,6 +34,45 @@ Zeitaufwand: ca. 30–40 Minuten, größtenteils Warten auf Neustarts.
 
 ---
 
+
+## Der schnelle Weg: install.sh
+
+Für eine neue Instanz gibt es ein Skript, das die Schritte 1 bis 3 und 5
+zusammen erledigt. Am einfachsten direkt auf der HA-Instanz im Add-on
+**Terminal & SSH**:
+
+```bash
+bash <(curl -fsSL https://gitea.nothaft.cloud/paul/audi-app/raw/branch/main/homeassistant/install.sh)
+```
+
+Liegt das Repository privat (Standard), braucht der Aufruf ein Zugangstoken:
+
+```bash
+curl -fsSL -H "Authorization: token <DEIN-GITEA-TOKEN>" \
+  https://gitea.nothaft.cloud/paul/audi-app/raw/branch/main/homeassistant/install.sh -o install.sh
+bash install.sh --repo https://<nutzer>:<token>@gitea.nothaft.cloud/paul/audi-app.git
+```
+
+Alternativ von einem Rechner aus gegen ein eingebundenes config-Verzeichnis:
+
+```bash
+./install.sh --ziel /Volumes/config --von ~/Development/audi-app
+```
+
+Das Skript installiert pyscript, spielt Backend und Oberfläche ein, legt das
+Fahrzeugprofil aus der Vorlage an (**vorhandene Daten bleiben unangetastet**),
+trägt den Abschnitt in die `configuration.yaml` ein — mit Sicherungskopie und
+so, dass ein zweiter Lauf ihn ersetzt statt anhängt — und verdrahtet die
+Selbstaktualisierung, damit „Update suchen" in der App funktioniert.
+`--hilfe` zeigt alle Optionen.
+
+Danach bleiben nur noch drei Dinge, alle in der Weboberfläche: neu starten,
+Sensoren zuordnen (Schritt 4 unten), Fahrzeugdaten eintragen.
+
+Wer lieber jeden Schritt selbst nachvollzieht, folgt der ausführlichen
+Anleitung ab hier.
+
+
 ## Schritt 1 — pyscript installieren
 
 1. In Home Assistant: **HACS → Integrationen → Explore & Download Repositories**