Solar-System-Plugin

Changelog - Solar System Plugin

Alle wichtigen Änderungen am solar_system.py Plugin für Alternative Time.

---

[1.3.0] - 2026-01-05

🐛 Kritische Bugfixes

Blocking I/O im Event-Loop behoben

• Problem: _write_local_assets() wurde aus extra_state_attributes aufgerufen, was blockierende Datei-Operationen (open()) im Home Assistant Event-Loop verursachte.
• Fehlermeldung: Detected blocking call to open with args ('/config/www/alternative_time/solar_system_map.svg', 'w') inside the event loop
• Lösung:
  • Neue Cache-Variablen eingeführt: _cached_svg, _cached_png_data_uri, _cached_local_paths
  • Visualisierungsgenerierung und Datei-Schreiboperationen in update() verschoben
  • extra_state_attributes verwendet jetzt nur noch gecachte Werte

Falsche Erdposition korrigiert

• Problem: Die Erde wurde im Januar nicht oben (0°) angezeigt, sondern bei ~110° (rechts)
• Ursache: Falscher Referenzwinkel von 100° (fest codiert) statt ~206° (tatsächliche heliozentrische Länge am 1. Januar)
• Lösung: _get_earth_reference_angle() berechnet jetzt dynamisch die Erdposition am 1. Januar des aktuellen Jahres

✨ Neue Features

"Sie sind hier" Marker für die Erde

• Die Erde wird jetzt in der Visualisierung mit einem speziellen Marker angezeigt
• Grüne Umrandung und grüne Beschriftung für bessere Sichtbarkeit
• Mehrsprachiger "Sie sind hier" Text in allen 12 Sprachen

Verbesserte Mehrsprachigkeit

• Neue lokalisierte Texte hinzugefügt:
  • you_are_here: "Sie sind hier" in 12 Sprachen
  • footer: Footer-Text in 12 Sprachen
  • months: Monatsnamen in 12 Sprachen
• Neue Hilfsmethoden: _get_solar_data_text(), _get_month_names()

🗑️ Entfernt

James Webb Space Telescope (JWST)

• Komplett aus dem Plugin entfernt:
  • Aus planets Dictionary entfernt
  • Aus config_options (display_planet) entfernt
  • Aus allen Berechnungen und Visualisierungen ausgeschlossen

🔧 Technische Verbesserungen

Strukturelle Änderungen

• Planetenfarben direkt in den Planetendaten als color Attribut
• Klarere Winkelberechnung mit angle_to_xy() Funktion
• Voyager-Positionen für 2025 aktualisiert (Voyager 1: 163 AU, Voyager 2: 136 AU)
• Pluto als Zwergplanet mit is_dwarf_planet Flag und gestrichelter Orbitlinie

Code-Qualität

• Bessere Fehlerbehandlung in update() für Visualisierungsgenerierung
• Verbesserte Sprachhandhabung (z.B. "de-DE" → "de")
• Konstante AU_TO_KM als Klassenvariable

Unterstützte Sprachen

Alle Texte sind in folgenden Sprachen verfügbar:

Code	Sprache
en	Englisch
de	Deutsch
es	Spanisch
fr	Französisch
it	Italienisch
nl	Niederländisch
pl	Polnisch
pt	Portugiesisch
ru	Russisch
ja	Japanisch
zh	Chinesisch
ko	Koreanisch

---

Visualisierung - Koordinatensystem

              Jan (0°)
                 │
                 ⊕ ← Erde im Januar
                 │
    Okt ─────────☉─────────Apr
   (270°)    (Sonne)      (90°)
                 │
                 │
              Jul (180°)

• 0° (oben): Januar
• 90° (rechts): April
• 180° (unten): Juli
• 270° (links): Oktober
• Bewegungsrichtung: Im Uhrzeigersinn

---

Konfigurationsoptionen

Option	Typ	Standard	Beschreibung
display_planet	select	all	Welcher Planet angezeigt wird
coordinate_system	select	heliocentric	Helio- oder geozentrisch
show_distance	boolean	true	Entfernung anzeigen
show_constellation	boolean	true	Sternbild anzeigen
show_retrograde	boolean	true	Rückläufigkeit anzeigen
show_visibility	boolean	true	Sichtbarkeit anzeigen
enable_visualization	boolean	true	SVG/PNG Karte generieren
visualization_scale	select	logarithmic	Kartenskalierung
observer_latitude	number	0.0	Beobachter-Breitengrad
observer_longitude	number	0.0	Beobachter-Längengrad