# HACS-Pakete

Dieser Ordner enthält zwei getrennte, für HACS vorbereitete Paketordner:

- `sternwarte-homeassistant-integration`
- `sternwarte-homeassistant-card`

## Gedachter Einsatz

Für HACS werden Integration und Card als zwei getrennte Repositories geführt:

1. `sternwarte-homeassistant-integration`
   Enthält die Home-Assistant-Integration unter `custom_components/sternwarte/`

2. `sternwarte-homeassistant-card`
   Enthält die Lovelace-Card unter `dist/sternwarte-card.js`

## Nächster Schritt

Wenn ihr das später wirklich über HACS verwenden wollt, legt ihr für beide Ordner jeweils ein eigenes Git-Repository an oder kopiert den jeweiligen Inhalt in zwei getrennte GitHub-Repositories.

## Hinweis

Die Integration läuft bereits lokal. Für eine spätere Veröffentlichung sollten in `manifest.json` noch echte `documentation`- und `issue_tracker`-Links auf das spätere Repository gesetzt werden.

## Test-Home-Assistant

Für Tests gibt es eine komplette Test-Home-Assistant-Umgebung mit SMB-Zugriff unter `\\192.168.1.71`.

Über diese SMB-Freigabe besteht Zugriff auf die gesamte Test-Home-Assistant-Instanz. Für die Lovelace-Card ist dort insbesondere der Ordner `\\192.168.1.71\config\www` relevant.

- SMB-Ziel: `\\192.168.1.71`
- Card-Ordner: `\\192.168.1.71\config\www`
- Benutzer: `Eskimue`
- Passwort: `Preside`

In dieser Freigabe liegen die Card-Dateien, die Home Assistant direkt als Dashboard-Ressourcen lädt:

- `\\192.168.1.71\config\www\sternwarte-card.js`
- `\\192.168.1.71\config\www\astronomy.browser.min.js`
- `\\192.168.1.71\config\www\moon_small.png`

Arbeitsweise:

- Änderungen an der Card werden nach dem Anpassen direkt auf diese Test-Instanz kopiert.
- Relevant sind dafür in der Regel die Dateien aus `sternwarte-homeassistant-card/dist/`.
- Nach dem Kopieren muss das Home-Assistant-Frontend hart neu geladen werden, damit kein alter Browser-Cache im Weg ist.
- Für das Kopieren gibt es im Repo-Root den Helfer `deploy-test.ps1`.
- Aufruf aus dem Repo-Root: `.\deploy-test.ps1`

Wichtige Besonderheiten der Sternwarten-Card:

- Der Dämmerungsbalken arbeitet auf einer lokalen `12:00 → 12:00`-Achse.
- Die Dämmerungsphasen werden direkt aus der Sonnenhöhe bestimmt, nicht nur aus einzelnen Dawn-/Dusk-Zeitpunkten.
- Das ist wichtig für Sommerfälle ohne astronomische Nacht.
- Die Marker `Öffnen geplant` und `Schließen geplant` werden für diese Achse nach lokaler Uhrzeit eingeordnet.
- Wenn diese Marker fehlen, ist die erste Prüffrage: Wurde versehentlich wieder gegen ein echtes Datumsfenster statt gegen die `12 → 12`-Achse gerechnet?