# 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.