# Kurzanleitung — Installation auf einer Home-Assistant-Instanz

Ausführliche Erklärungen, Umstieg von der alten Fassung und Troubleshooting
stehen in [`../INSTALL.md`](../INSTALL.md) — hier nur die Checkliste.

## Voraussetzungen

- Home Assistant 2025.1 oder neuer
- Das **Samba-Share-Add-on** in HA läuft, damit `\\<HA-IP>\config` vom PC aus
  erreichbar ist

Das war's. Anders als früher braucht es weder HACS noch pyscript, kein
Zugriffstoken und keinen `pip install` auf der HA-Maschine.

---

## Der schnelle Weg: `Installieren.cmd`

**Doppelklick auf `Installieren.cmd`.** Das Skript sucht die HA-Instanz im
Netz (`\\homeassistant\config` und die üblichen Alternativen, sonst fragt es
nach dem Pfad) und kopiert einen einzigen Ordner:

```
custom_components\audi_dashboard\   ->   <config>\custom_components\
```

Am Ende listet es auf, was noch von Hand zu tun ist.

Erst schauen, was passieren würde, ohne dass etwas geschrieben wird:

```powershell
.\install.ps1 -Pruefen
```

Mit festem Ziel:

```powershell
.\install.ps1 -Ziel "\\192.168.1.50\config"
```

### Ist das für meine bestehende HA-Installation gefährlich?

Nein — und das lässt sich nachprüfen statt glauben.

Die riskanteste Stelle der früheren Fassung ist weg: sie musste Blöcke in die
`configuration.yaml` eintragen, und eine kaputte `configuration.yaml` ist der
eine Weg, auf dem ein Installer Home Assistant am Starten hindern kann.
**Diese Fassung fasst die Datei überhaupt nicht mehr an** — die Integration
meldet ihr Panel selbst an, dafür braucht es kein YAML.

Was bleibt:

- Geschrieben wird **ausschließlich** in
  `<config>\custom_components\audi_dashboard`. Kein anderer Pfad — nicht
  `.storage\`, nicht `configuration.yaml`, nicht `automations.yaml`, nicht
  `www\`, nicht `audi_dashboard\` (die Fahrzeugdaten).
- Gelöscht wird nur der eigene Ordner, und auch der nur, wenn darin eine
  `manifest.json` mit `"domain": "audi_dashboard"` liegt. Ein fremder Ordner
  unter demselben Namen führt zum Abbruch, nicht zum Löschen.
- Nach dem Kopieren liest das Skript die `manifest.json` im Ziel zurück und
  prüft die Version. Stimmt sie nicht, bricht es mit einer Meldung ab, statt
  eine halbe Installation stehen zu lassen.
- Es **startet HA nicht neu**. Bis zum manuellen Neustart ändert sich am
  laufenden Betrieb nichts.

Ein zweiter Lauf auf einer laufenden Installation ist damit gefahrlos — er ist
sogar der vorgesehene Weg für Updates.

Der einzige Punkt, der einer sonst gesunden Installation gefährlich werden
kann, ist **nicht** der Installer, sondern die Datenaufbewahrung aus Schritt 3
unten: ein Jahr Fahrzeugverlauf braucht grob 1–1,5 GB. Auf HA OS mit SD-Karte
oder kleiner eMMC vorher unter **Einstellungen → System → Speicher**
nachsehen; ist der Datenträger voll, startet HA nicht mehr — unabhängig von
dieser App.

---

## Der Weg von Hand

Falls `Installieren.cmd` nicht durchläuft oder lieber nachvollziehbar:

Den Ordner `custom_components\audi_dashboard` aus dem Projekt nach
`<config>\custom_components\` kopieren. Ist dort schon eine ältere Fassung,
diese vorher komplett löschen — bleibt eine Datei liegen, die es im neuen
Stand nicht mehr gibt, lädt Home Assistant sie trotzdem mit.

---

## Danach

### 1. Home Assistant neu starten

**Einstellungen → System → Neu starten.** Beim ersten Start lädt HA die
Abhängigkeit `pypdf` nach (für die Tankbelege) — das kann eine Minute dauern.

### 2. Integration hinzufügen

**Einstellungen → Geräte & Dienste → Integration hinzufügen → Audi
Dashboard.** Es gibt nichts einzugeben.

Danach steht **Mein Audi** in der Seitenleiste.

### 3. Datenaufbewahrung — zeitkritisch

Den Block aus [`recorder_snippet.yaml`](recorder_snippet.yaml) in die
`configuration.yaml` übernehmen. Home Assistant löscht Sensor-Verläufe sonst
nach 10 Tagen; was weg ist, lässt sich auch mit „Daten importieren aus Home
Assistant" nicht mehr nachtragen. Je früher der Block drin ist, desto mehr
Vergangenheit bleibt erhalten.

Vorher den Speicher prüfen (siehe oben). Bei knappem Platz mit
`purge_keep_days: 90` anfangen — Details im Kopf der Datei.

Bewusst nicht vom Installer erledigt: das ist eine Entscheidung über den
Plattenplatz der Instanz, und viele Instanzen haben schon einen eigenen
`recorder:`-Block, den man zusammenführen muss statt zu überschreiben.

### 4. Sensoren zuordnen

In der App: **Einstellungen → Fahrzeug einrichten → Setup.**

Im Auslieferstand ist **kein** Sensor vorbelegt — das ist Absicht, siehe
`../INSTALL.md`. Zwingend ist allein der Zündungs-/ACC-Sensor
(`binary_sensor`, meist vom Teltonika FMM003): er trägt die Fahrterkennung.

Änderungen wirken sofort, ein Neustart ist dafür nicht mehr nötig.

### 5. Fahrzeugdaten eintragen

**Einstellungen → Fahrzeug einrichten.** Das Profil ist bereits da — die
Integration hat es beim ersten Start aus ihrer Vorlage angelegt. Zu ersetzen
sind die Platzhalter: VIN, Kennzeichen, Erstzulassung, HU-Termin,
Versicherung, Werkstatt, Servicebuch.

### 6. Vergangenes nachholen (optional)

**Einstellungen → Einrichten → Daten importieren aus Home Assistant** holt
Fahrten, Tankvorgänge und Spannungswerte aus dem bereits aufgezeichneten
HA-Verlauf nach.

---

## Updates

Denselben Aufruf noch einmal — `Installieren.cmd` oder `install.ps1`. Der
Ordner wird ersetzt, die Fahrzeugdaten unter `audi_dashboard\` und die eigenen
Fotos unter `www\bilder\` bleiben unangetastet. Danach HA neu starten (oder
kürzer: **Einstellungen → Geräte & Dienste → Audi Dashboard → Neu laden**).

HACS ist hier bewusst keine Alternative: es kann laut eigener Dokumentation
grundsätzlich nicht mit privaten GitHub-Repositories arbeiten, und das
Repository ist privat, weil es lizenzierte Audi-Assets enthält.
