Files
2026-05-19 08:50:19 +02:00

46 lines
1.8 KiB
Markdown

# Sternwarte Home Assistant Card
Lovelace-Card für die Sternwarte.
## Struktur
```text
dist/
astronomy.browser.min.js
sternwarte-card.js
```
`sternwarte-card.js` lädt `astronomy.browser.min.js` automatisch nach, um Dämmerungszeiten und Mondposition präziser zu berechnen.
## Dämmerungsbalken
Der Dämmerungsbalken in `dist/sternwarte-card.js` arbeitet bewusst nicht nur mit einzelnen Dawn-/Dusk-Zeitpunkten, sondern mit einem lokalen `12:00 → 12:00`-Fenster.
Wichtige Punkte:
- Die Phasen `Tag`, `bürgerliche Dämmerung`, `nautische Dämmerung`, `astronomische Dämmerung` und `Nacht` werden direkt aus der Sonnenhöhe bestimmt.
- Dafür wird das komplette lokale 24-Stunden-Fenster in kleinen Schritten durchgerechnet.
- Diese Logik ist robuster für Sommerfälle, in denen es keine astronomische Nacht mehr gibt.
Marker im Balken:
- `Öffnen geplant` wird grün dargestellt.
- `Schließen geplant` wird rot dargestellt.
- Der Marker `Jetzt` ist bewusst hell/weiß, damit er nicht mit `Schließen` verwechselt wird.
Wichtig für spätere Änderungen:
- Die Balkenachse ist eine Uhrzeitachse `12 → 12`, keine reine Datumsachse.
- Die Marker für `Öffnen geplant` und `Schließen geplant` müssen daher anhand der lokalen Uhrzeit auf diese Achse gelegt werden, nicht anhand eines festen Datumsfensters.
- Wenn die Marker verschwinden, zuerst prüfen, ob versehentlich wieder mit einem echten Zeitfenster statt mit der `12 → 12`-Achse gerechnet wird.
## Für HACS
Dieser Ordner ist als Root eines späteren HACS-Dashboard-Repositorys vorbereitet.
Empfohlener Repository-Name:
- `sternwarte-homeassistant-card`
Nach dem Einbinden über HACS muss in Home Assistant noch wie üblich die Dashboard-Ressource für die Card vorhanden sein, falls HACS sie nicht bereits automatisch registriert.