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