sillyhome-next/docs/V1_6_0_OPERATING_GUIDE.md

SillyHome Next v1.6.0 Operating Guide

v1.6.0 trennt Startansicht, Aktoruebersicht, Discovery und Detaildaten staerker.

API-Pfade

• GET /v1/actuators/dashboard/system
  • nur System- und Cache-Metadaten
  • keine Aktorenliste
  • kein vollstaendiges Entity-Payload aus SQLite
• GET /v1/actuators/dashboard/start
  • Aktor-Summaries
  • Entity-Metadaten nur fuer konfigurierte Aktoren
  • keine Discovery-Gruppen und keine Jobliste
• GET /v1/actuators/discovery
  • steuerbare HA-Entities
  • nutzt SQLite-Cache, liest HA nur bei Cache-Miss oder refresh=true
• GET /v1/actuators/{id}/detail
  • genau ein ausgewaehlter Aktor
  • kompakte Modell-/Kontextdaten

Dashboard

• Frontend zeigt Daten an und loest gezielte Aktionen aus.
• Backend liefert schlanke View-Daten.
• Worker aktualisieren HA-Entity-/Discovery-Cache beim Start und danach stündlich.
• Die Detailansicht gehoert zu einem Aktor und hat eigene Navigation: Zurueck, anderes Geraet, Aktualisieren.

Erwartete Wirkung

• Systemstart muss ohne Entity-Materialisierung reagieren.
• Lernen und Details laden nur ihren eigenen Datenkern.
• Discovery bleibt ein eigener Bedarfspfad.
• Texte im Dashboard sind kurz und handlungsnah.