sillyhome-next/docs/V1_7_0_OPERATING_GUIDE.md

SillyHome Next v1.7.0 Operating Guide

v1.7.0 erweitert den Produktivbetrieb um Diagnose, Backup, Dry-run und Planungshilfen.

Diagnose

• Jede Auswertung speichert eine kompakte decision_timeline am Aktor.
• Event-basierte Auswertungen speichern zusaetzlich latency_measurements.
• Die Timeline beantwortet: was war der Ausloeser, welches Ziel wurde vorhergesagt, wurde geschaltet oder blockiert, und warum.

Backup und Restore

• GET /v1/actuators/backup/export exportiert Aktoren, Reconciliation-Status und Job-Historie als JSON.
• POST /v1/actuators/backup/restore spielt diesen Stand wieder ein.
• Ohne replace_existing=true werden vorhandene Aktoren nicht ueberschrieben.

Dry-run

• POST /v1/actuators/{entity_id}/dry-run aktiviert oder beendet den Testmodus.
• Im Dry-run werden freigegebene Aktionen bewertet und protokolliert, aber nicht an Home Assistant gesendet.

Feedback

Feedback akzeptiert neben correct/expected_state nun optionale Typen:

• correct
• wrong
• too_early
• too_late
• never_automate

never_automate setzt eine manuelle Sicherheitssperre am Aktor.

Planung

POST /v1/actuators/planning/refresh berechnet lokale Hinweise:

• Aktorgruppen aus gemeinsamen Raum-/Kontextdaten
• einfache Szenenvorschlaege aus gemeinsamem Kontextverhalten
• Agent-Insights fuer Konflikte, Latenz und auffaelliges Feedback