sillyhome-next/docs/V1_4_0_OPERATING_GUIDE.md

SillyHome Next v1.4.0 Operating Guide

v1.4.0 überarbeitet das Dashboard für mobile Nutzung, deutsche Verständlichkeit und stabileren Datenabruf.

Schneller Startpfad

• Die Startseite lädt zuerst nur die Bedienoberfläche und den kompakten Dashboard-Startdatensatz.
• Neuer Start-Endpunkt: GET /v1/actuators/dashboard/start.
• Der Start-Endpunkt liefert keine Discovery-Gruppen und keine Aufgabenliste.
• Status, Aufgabenliste, Reconciliation-Zeitpunkt und Detail-Kontext werden danach im Hintergrund geladen.
• Auf der Startansicht werden zunächst nur die ersten 24 Aktoren gerendert. Weitere Geräte werden auf Knopfdruck nachgerendert.

Deutsche Oberfläche

Interne Protokollwerte bleiben stabil, werden in der Oberfläche aber übersetzt:

• observe -> Nur beobachten
• suggest -> Vorschläge anzeigen
• shadow -> Prüfmodus ohne Schalten
• partial -> Teilfreigabe
• active -> Aktiv freigegeben
• Job-Status wie running, completed, failed erscheinen als läuft, abgeschlossen, fehlgeschlagen.
• Anomalie-Schweregrade erscheinen als Hinweis, Warnung, Kritisch.

Stabilität

• Startdaten und Statusdaten sind getrennt. Ein langsamer Statuscheck blockiert nicht mehr die Geräteübersicht.
• Die Aufgabenliste wird separat geladen und kann ausfallen, ohne die Bedienoberfläche zu blockieren.
• Detaildaten bleiben gestuft: zuerst Shell und gespeicherte Werte, danach Kontextvorschläge.

Performance-Regel

3 Sekunden bleiben die harte Grenze für den Startpfad. Alles, was schwerer ist als Startdaten, muss nachgelagert oder auf Nutzeraktion geladen werden.