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