Files
sillyhome-next/docs/V1_5_3_OPERATING_GUIDE.md
Otto 1d176cce45
Some checks failed
quality / test (3.11) (push) Has been cancelled
quality / test (3.13) (push) Has been cancelled
Add SQLite dashboard cache
2026-06-18 00:07:47 +02:00

1.3 KiB

SillyHome Next v1.5.3 Operating Guide

v1.5.3 führt eine SQLite-Cache-Schicht für Ingress-Dashboarddaten ein.

Ziel

Die Ingress-Seite soll nicht bei jedem Aufruf live Home Assistant abfragen. Home-Assistant-Daten werden geplant aktualisiert und lokal gelesen.

SQLite-Cache

  • Cache-Datei: <actuator_store>/dashboard_cache.sqlite3
  • Tabelle ha_entities: aktuelle HA-Entity-Summaries als JSON
  • Tabelle cache_meta: Aktualisierungszeitpunkt und Discovery-Gruppen

Dashboard-APIs lesen bevorzugt aus SQLite. Der alte JSON-Cache bleibt als Fallback erhalten.

Aktualisierung

  • Beim App-Start läuft ein Hintergrund-Refresh nach kurzer Verzögerung.
  • Danach läuft der Refresh stündlich.
  • Konfiguration: SILLYHOME_DASHBOARD_CACHE_REFRESH_SECONDS
  • Mindestwert: 300 Sekunden.
  • Explizite Discovery aktualisiert SQLite und JSON-Fallback.

Schaltpfad

Das direkte Schalten bleibt unverändert: Safety prüft lokale Daten, danach geht der Home-Assistant-Service-Call direkt raus. Der Dashboard-Cache liegt nicht im Schaltpfad.

Noch offen

Diese Version verschiebt Entity-/Discovery-Daten in SQLite. Die vollständige Migration aller Aktor-Konfigurationen und Workflows aus JSON in relationale Tabellen ist ein größerer Folgeschritt und muss mit Migrationsplan erfolgen.