Sonnenweg-Observatory-Home-Assistant/README.md

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?