sillyhome-next/docs/V1_0_ACCEPTANCE.md

SillyHome Next v1.0 Acceptance

Stand: 2026-06-17

Diese Abnahme trennt belegte Umsetzung von offenen v1.0.x-Nacharbeiten. Der Funktionskern bleibt aktorzentriert: Nutzer waehlen Aktoren, SillyHome lernt Kontext und Verhalten, laeuft zuerst im Shadow-Modus und schaltet erst nach expliziter Freigabe.

Erfuellt

• Versioniert, gepusht und installiert:
  • v1.0.0: API-/Cache-Umbau
  • v1.0.1: Dashboard-/Performance-Korrektur
• Startpfad:
  • /v1/actuators/dashboard liefert lokale Startdaten aus Store und Cache.
  • Dashboard blockiert nicht mehr auf Discovery, Vorschlaegen oder Automation-Refresh.
  • Frontend bricht den Startdaten-Request nach 4,5 Sekunden ab und bleibt bedienbar.
• Cache:
  • HA-Entity-Metadaten werden als ha_entity_cache.json gespeichert.
  • Summary und Dashboard verwenden Friendly Name, Area und Device aus Cache.
• Keine externen Abfragen im Dashboard-Startpfad:
  • Kein Cloud-Ping, keine Fremd-API.
  • HA-Zugriffe bleiben lokal gegen Home Assistant.
• Dashboard:
  • Orange ist Primaerfarbe.
  • Cyan ist sichtbare Komplementaerfarbe.
  • Rote UI-Flaechen wurden entfernt.
  • Steuerung, beobachtete Geraete, Lernfortschritt/Freigabe und Systemstatus sind getrennte Bereiche.
  • Discovery, Vorschlaege und Automation-Suche laden erst bei Nutzeraktion.
• Lernfortschritt und Freigabe:
  • Karten zeigen Modus, Status, Handlungen, Vorhersage und Freigabestatus.
  • Detailansicht zeigt Zuordnung, Sicherheit, Lernstand, Vorhersage, Feedback, passende HA-Automationen und verwendete Sensoren/Zustaende.
• Direkte HA-Nutzung:
  • Aktor-Schaltungen laufen ueber Home-Assistant-Serviceaufrufe.
  • Automation-Steuerung nutzt Home-Assistant-Endpunkte und gecachte Automation-Metadaten.
• Qualitaet:
  • pytest -q
  • ruff check .
  • mypy app backend tests
  • git diff --check
• Performance-Budget:
  • Automatisierter Test prueft Root-HTML und /v1/actuators/dashboard gegen das 5-Sekunden-Budget mit kontrollierten Fake-HA-/Cache-Daten.
• HA-/Ingress-Verifikation:
  • Supervisor-Update, Add-on-Status, Watchdog, Backup, Ingress-Hard-Reload und Rollback sind im Operating Guide dokumentiert.

Teilweise Erfuellt

• Bessere Statistik:
  • Startbereich zeigt Aktoren, Freigabebereitschaft, Aktiv/Shadow, Gelernt/Wartet, gelernte Handlungen, Discovery-Gruppen und Cache-Zeitpunkt.
  • Noch offen: Verlaufsgrafiken, p95-Latenzen und Trendstatistik je Aktor.
• Kontrollierte Abarbeitung und Queue:
  • Reconciliation/Training laufen kontrolliert im Prozess und sind testbar.
  • Noch offen: sichtbare Job-Queue mit Laufzeit, Fehlern und Retry-Status im Dashboard.
• Saubere Issues:
  • v1.0.0-Issues #41 bis #47 wurden geschlossen.
  • Rueckblickend waren sie zu grob; v1.0.x bekommt feinere Folgeissues fuer Statistik, Queue-Sichtbarkeit und Performance-Budgets.

Offen Fuer v1.0.x

• Dashboard-Jobstatus fuer Reconciliation, Training, Discovery und Automation-Refresh.
• Mehr Entscheidungsstatistik pro Aktor: welche Sensoren wie stark beigetragen haben, wie sich Confidence und Sample Count entwickeln.

Rollback

• Git-Bundle-Backups liegen unter /root/.openclaw/workspace/backups/sillyhome-next/.
• Vor v1.0.1 wurde ein Home-Assistant-Teilbackup des Add-ons angelegt. Referenz: 18a5b387.
• Letzter Vor-1.0-Stand: v0.7.21.