Compare commits
19 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| b9b5def7bb | |||
| 94530d3ecf | |||
| 63b8684197 | |||
| f8801e469a | |||
| 787516ac67 | |||
| 7ba9807a4e | |||
| 4db4276b95 | |||
| 98a2b2cc38 | |||
| 387e027fe2 | |||
| f8bee92e64 | |||
| 9ddb065f62 | |||
| 8222f24ebe | |||
| a7a2f8c78a | |||
| faf4099756 | |||
| 1b2b76455a | |||
| 18999ff68a | |||
| e2826e92ec | |||
| c5f42a39a9 | |||
| 309b33b812 |
141
CHANGELOG.md
141
CHANGELOG.md
@@ -1,5 +1,146 @@
|
|||||||
# Changelog
|
# Changelog
|
||||||
|
|
||||||
|
## 1.0.4 - 2026-06-17
|
||||||
|
- Sensor-Relevanz ist in der Aktor-Detailansicht sichtbar: automatische
|
||||||
|
Relevanz, aktive Gewichtung und Score werden pro verwendetem Sensor/Zustand
|
||||||
|
angezeigt.
|
||||||
|
- Gewichtungen koennen im Dashboard korrigiert und per API unter
|
||||||
|
`/v1/actuators/{actuator_entity_id}/weights` gespeichert werden.
|
||||||
|
- Gruppen-Gewichtungen buendeln mehrere Sensoren/Zustaende fuer einen Aktor,
|
||||||
|
damit verbundene Kontextsignale gemeinsam bewertet werden koennen.
|
||||||
|
|
||||||
|
## 1.0.3 - 2026-06-17
|
||||||
|
- Header-Menue als Pulldown umgesetzt; die separate Navigationsleiste entfaellt.
|
||||||
|
- Geraetegruppen und manuelle Kontextbereiche sind standardmaessig geschlossen.
|
||||||
|
- Dashboard startet in Phasen: leere Bedienoberflaeche, dann Status, danach
|
||||||
|
Geraetedaten.
|
||||||
|
- Detailansicht oeffnet streamartiger: zuerst Basis-Shell, dann Aktorwerte,
|
||||||
|
danach Kontextvorschlaege.
|
||||||
|
|
||||||
|
## 1.0.2 - 2026-06-17
|
||||||
|
- v1.0-Abnahme als `docs/V1_0_ACCEPTANCE.md` dokumentiert: erledigte,
|
||||||
|
teilweise erledigte und offene v1.0.x-Punkte sind getrennt sichtbar.
|
||||||
|
- Dashboard-Startstatistik erweitert: Freigabebereitschaft, Aktiv/Shadow,
|
||||||
|
Gelernt/Wartet und gelernte Handlungen werden direkt im Startbereich
|
||||||
|
zusammengefasst.
|
||||||
|
|
||||||
|
## 1.0.1 - 2026-06-17
|
||||||
|
- Dashboard-UI nach v1-Korrektur neu strukturiert: feste Steuerungsleiste,
|
||||||
|
separate Geräteübersicht, klare Freigabe-/Detailfläche und Statusbereich.
|
||||||
|
- Orange bleibt Primärfarbe; Cyan ist die sichtbare Komplementärfarbe. Rote
|
||||||
|
Aktions- und Fehlerflächen wurden aus der Oberfläche entfernt.
|
||||||
|
- Startpfad weiter beschleunigt: Dashboard lädt nur noch lokale Startdaten.
|
||||||
|
HA-Discovery, Vorschläge und Automation-Refresh laufen erst nach Nutzeraktion.
|
||||||
|
- Detailansicht öffnet ohne automatische Automation-Discovery. Passende
|
||||||
|
Automationen können gezielt per Button neu gesucht werden.
|
||||||
|
|
||||||
|
## 1.0.0 - 2026-06-17
|
||||||
|
- Neuer blockweiser Dashboard-Start über `/v1/actuators/dashboard`: lokale
|
||||||
|
Store-/Cache-Daten laden sofort, HA-Discovery und Vorschläge laufen
|
||||||
|
nachgelagert.
|
||||||
|
- Discovery liest Entities pro Anfrage nur noch einmal und klassifiziert aus
|
||||||
|
diesem Snapshot weiter. Dadurch entfallen doppelte HA-Vollabfragen.
|
||||||
|
- Persistenter JSON-Entity-Cache wird für Friendly Name, Raum, Gerät,
|
||||||
|
Discovery-Gruppen und schnelle Summaries genutzt.
|
||||||
|
- Dashboard mit Orange als Primärfarbe, kompakter Navigation, aufklappbarer
|
||||||
|
Anleitung, aufklappbaren Gerätegruppen und Cache-/Systemstatistik.
|
||||||
|
- Aktor-/Sensor-Kategorien erweitert: Feuchte, Wetter, Helligkeit, Bewegung,
|
||||||
|
Tür/Fenster, Präsenz, Lichtzustände, Schalter, Steckdosen, Lüftung, Heizung,
|
||||||
|
Cover, Helper, PV/Akku/Einspeisung.
|
||||||
|
- Kontextvorschläge vermeiden weitere doppelte HA-Discovery und sortieren
|
||||||
|
aktortypbezogen nach relevanten Bereichen.
|
||||||
|
|
||||||
|
## 0.7.21 - 2026-06-17
|
||||||
|
- Dashboard-Ladepfad getrennt: beobachtete Geräte laden sofort über
|
||||||
|
`/v1/actuators/summary`; Status, Discovery und Vorschläge laufen unabhängig
|
||||||
|
nachgelagert und blockieren die Übersicht nicht mehr.
|
||||||
|
- Systemstatus nutzt Timeouts und bleibt auch bei langsamem ML-/HA-Status
|
||||||
|
bedienbar.
|
||||||
|
- HA-Entity-Metadaten werden als JSON-Cache gespeichert und für Friendly Name,
|
||||||
|
Raum und Gerät in schlanken Summaries wiederverwendet.
|
||||||
|
- Anleitung, Gerätegruppen und manuelle Kontextauswahl sind aufklappbar und
|
||||||
|
kompakter für Smartphone- und Desktopansichten.
|
||||||
|
|
||||||
|
## 0.7.20 - 2026-06-17
|
||||||
|
- Dashboard-Übersicht ist kompatibel mit dem leichten Summary-Format und greift
|
||||||
|
nicht mehr auf `record.behavior.status` aus dem Vollformat zu.
|
||||||
|
|
||||||
|
## 0.7.19 - 2026-06-17
|
||||||
|
- Dashboard-Übersicht nutzt einen leichten `/v1/actuators/summary`-Endpunkt
|
||||||
|
statt voller Lernmuster und kompletter HA-Entityliste.
|
||||||
|
- Nach Aktionen werden Dashboard-Caches gezielt invalidiert, damit keine
|
||||||
|
stale oder doppelt geladenen Einträge entstehen.
|
||||||
|
|
||||||
|
## 0.7.18 - 2026-06-16
|
||||||
|
- Dashboard lädt Aktoren, Entities und Discovery nur noch einmal pro Refresh und
|
||||||
|
rendert daraus Auswahl und Übersicht ohne doppelte API-Ladewege.
|
||||||
|
- Manuelle Kontext-Evidenz wird dedupliziert, damit Hinweise wie
|
||||||
|
"Manuell vom Nutzer als relevant festgelegt" nicht mehrfach erscheinen.
|
||||||
|
- Kontextauswahl ist vollständiger: Feuchte, Wetter, Licht-/Schalterzustände,
|
||||||
|
Bewegungs-/Tür-/Präsenzmelder, PV/Akku/Einspeisung und Helper werden sauberer
|
||||||
|
kategorisiert und per Suche/Kategorie erreichbar.
|
||||||
|
- Domainspezifische Zuordnung geschärft: Lüftungen bevorzugen Feuchte/Temperatur,
|
||||||
|
Lichter Helligkeit/Bewegung/Tür/Präsenz, Heizungen Temperatur/Anwesenheit/Wetter.
|
||||||
|
|
||||||
|
## 0.7.17 - 2026-06-16
|
||||||
|
- WebSocket-Eventpfad ist schneller: irrelevante HA-State-Changes werden vor
|
||||||
|
dem teuren State-Cache-Listenbau verworfen.
|
||||||
|
- WebSocket nutzt Keepalive und reconnectet nach Abbrüchen nach 1s statt 5s.
|
||||||
|
|
||||||
|
## 0.7.16 - 2026-06-16
|
||||||
|
- Beobachtete Aktoren werden in der Übersicht nach Raum oder Typ gruppiert und
|
||||||
|
mit Friendly Name angezeigt.
|
||||||
|
|
||||||
|
## 0.7.15 - 2026-06-16
|
||||||
|
- Add-on-Start ist robust gegen Home-Assistant-Core-502 beim Systemboot:
|
||||||
|
API und WebSocket-Listener starten trotzdem, Reconciliation/Training werden
|
||||||
|
im Hintergrund mit Retry nachgeholt.
|
||||||
|
- Periodische Reconciliation und Fallback-Auswertung beenden den Dienst nicht
|
||||||
|
mehr bei temporären HA-Fehlern.
|
||||||
|
- Add-on-Watchdog prüft `/health`, damit Supervisor den Dienst nach Absturz
|
||||||
|
wieder starten kann.
|
||||||
|
|
||||||
|
## 0.7.14 - 2026-06-16
|
||||||
|
- Onboarding-Vorschläge laden im Dashboard nachgelagert, damit Status,
|
||||||
|
Aktor-Auswahl und bestehende Geräte nicht auf Automation-Discovery warten.
|
||||||
|
|
||||||
|
## 0.7.13 - 2026-06-16
|
||||||
|
- Diagnose-/Schutzsensoren wie Überhitzung und Überlast werden nicht mehr nur
|
||||||
|
wegen gleicher Strom-/Monitoring-Bereiche automatisch als Lichtkontext
|
||||||
|
übernommen.
|
||||||
|
- Verwendete Kontext-Entities können pro Aktor direkt entfernt und damit als
|
||||||
|
manuelle Zuordnung überschrieben werden.
|
||||||
|
- Onboarding-Vorschläge zeigen passende, noch nicht eingerichtete Aktoren aus
|
||||||
|
bestehenden Automationen und naheliegenden Kontexten.
|
||||||
|
- TV-/Medien-Aktoren über `media_player` und Fernbedienungen über `remote`
|
||||||
|
werden in Discovery und Auswahl berücksichtigt.
|
||||||
|
|
||||||
|
## 0.7.12 - 2026-06-16
|
||||||
|
- Aktor-Auswahlliste zeigt maximal 50 Treffer gleichzeitig und fordert bei
|
||||||
|
größeren Mengen zum Eingrenzen per Suche oder Typfilter auf.
|
||||||
|
|
||||||
|
## 0.7.11 - 2026-06-16
|
||||||
|
- Aktor-Discovery erkennt weitere steuerbare HA-Domains wie Buttons, Helper,
|
||||||
|
Heizungen, Schlösser, Ventile und numerische Helper.
|
||||||
|
- Aktor-Auswahl dedupliziert Licht-/Schalter-Doppelungen pro Gerät und gruppiert
|
||||||
|
zusätzliche Typen im Dashboard.
|
||||||
|
- Discovery liefert Kategorien für Mess-, Binär-, Kontext- und Aktor-Entities.
|
||||||
|
- Nutzerfeedback kann Vorhersagen als korrekt oder falsch markieren und direkt
|
||||||
|
als Lernsignal speichern.
|
||||||
|
|
||||||
|
## 0.7.10 - 2026-06-16
|
||||||
|
- WebSocket-State-Changes aktualisieren einen internen Home-Assistant-State-
|
||||||
|
Cache und werten Aktoren direkt gegen diesen frischen Event-Zustand aus.
|
||||||
|
- Event-Auswertungen lösen keine REST-Statusabfrage mehr aus, bevor sie
|
||||||
|
aktive Aktoren schalten.
|
||||||
|
|
||||||
|
## 0.7.9 - 2026-06-15
|
||||||
|
- Event-basierte Vorhersagen verwenden den frischen Sensorzustand direkt aus
|
||||||
|
dem Home-Assistant-WebSocket-Event, damit Kontextwechsel ohne REST-Race sofort
|
||||||
|
bewertet und geschaltet werden können
|
||||||
|
- Regressionstest stellt sicher, dass ein Türsensor-Event trotz veraltetem
|
||||||
|
HA-Snapshot direkt `light.turn_on` auslöst
|
||||||
|
|
||||||
## 0.7.8 - 2026-06-15
|
## 0.7.8 - 2026-06-15
|
||||||
- Home-Assistant-WebSocket-Listener deaktiviert den clientseitigen Keepalive-
|
- Home-Assistant-WebSocket-Listener deaktiviert den clientseitigen Keepalive-
|
||||||
Ping, damit stabile HA-Verbindungen nicht durch Ping-Timeouts ständig neu
|
Ping, damit stabile HA-Verbindungen nicht durch Ping-Timeouts ständig neu
|
||||||
|
|||||||
@@ -11,6 +11,10 @@ nach einer ausdrücklichen Freigabe ausführen.
|
|||||||
[`docs/CONTROL_HANDOFF.md`](docs/CONTROL_HANDOFF.md)
|
[`docs/CONTROL_HANDOFF.md`](docs/CONTROL_HANDOFF.md)
|
||||||
- Entwickeln, testen, veröffentlichen und installieren:
|
- Entwickeln, testen, veröffentlichen und installieren:
|
||||||
[`docs/OPERATIONS.md`](docs/OPERATIONS.md)
|
[`docs/OPERATIONS.md`](docs/OPERATIONS.md)
|
||||||
|
- Version 1.0.0 bedienen und prüfen:
|
||||||
|
[`docs/V1_0_0_OPERATING_GUIDE.md`](docs/V1_0_0_OPERATING_GUIDE.md)
|
||||||
|
- Version 1.0.x Abnahme und offene Punkte:
|
||||||
|
[`docs/V1_0_ACCEPTANCE.md`](docs/V1_0_ACCEPTANCE.md)
|
||||||
- Arbeitsregeln für Coding-Agenten: [`AGENTS.md`](AGENTS.md)
|
- Arbeitsregeln für Coding-Agenten: [`AGENTS.md`](AGENTS.md)
|
||||||
|
|
||||||
## Reifegrad
|
## Reifegrad
|
||||||
@@ -58,6 +62,8 @@ uvicorn app.main:app --reload
|
|||||||
- `http://127.0.0.1:8000/v1/discovery` - klassifizierte, filterbare Entities
|
- `http://127.0.0.1:8000/v1/discovery` - klassifizierte, filterbare Entities
|
||||||
- `http://127.0.0.1:8000/v1/history` - normalisierte numerische Zeitreihen
|
- `http://127.0.0.1:8000/v1/history` - normalisierte numerische Zeitreihen
|
||||||
- `http://127.0.0.1:8000/v1/actuators/discovery` - unterstützte Aktuatoren für den aktor-zentrierten Workflow
|
- `http://127.0.0.1:8000/v1/actuators/discovery` - unterstützte Aktuatoren für den aktor-zentrierten Workflow
|
||||||
|
- `http://127.0.0.1:8000/v1/actuators/dashboard` - schnelle Dashboard-Startdaten aus Store und JSON-Cache
|
||||||
|
- `http://127.0.0.1:8000/v1/actuators/summary` - schlanke Liste beobachteter Aktoren
|
||||||
- `POST http://127.0.0.1:8000/v1/actuators` - Aktor freigeben; Kontextzuordnung und Modell-Lebenszyklus starten automatisch
|
- `POST http://127.0.0.1:8000/v1/actuators` - Aktor freigeben; Kontextzuordnung und Modell-Lebenszyklus starten automatisch
|
||||||
- `POST http://127.0.0.1:8000/v1/actuators/{entity_id}/evaluate` - Shadow-Vorhersage aktualisieren
|
- `POST http://127.0.0.1:8000/v1/actuators/{entity_id}/evaluate` - Shadow-Vorhersage aktualisieren
|
||||||
- `POST http://127.0.0.1:8000/v1/actuators/{entity_id}/activation` - autonomes Schalten pro Aktor freigeben oder stoppen
|
- `POST http://127.0.0.1:8000/v1/actuators/{entity_id}/activation` - autonomes Schalten pro Aktor freigeben oder stoppen
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
name: SillyHome Next
|
name: SillyHome Next
|
||||||
version: "0.7.8"
|
version: "1.0.4"
|
||||||
slug: sillyhome_next
|
slug: sillyhome_next
|
||||||
description: Lernt automatisch aus deinem Verhalten und steuert freigegebene Aktoren
|
description: Lernt automatisch aus deinem Verhalten und steuert freigegebene Aktoren
|
||||||
url: http://192.168.6.31:3000/pino/sillyhome-next
|
url: http://192.168.6.31:3000/pino/sillyhome-next
|
||||||
@@ -7,6 +7,7 @@ arch:
|
|||||||
- amd64
|
- amd64
|
||||||
startup: application
|
startup: application
|
||||||
boot: auto
|
boot: auto
|
||||||
|
watchdog: http://[HOST]:[PORT:8000]/health
|
||||||
init: false
|
init: false
|
||||||
ingress: true
|
ingress: true
|
||||||
ingress_port: 8000
|
ingress_port: 8000
|
||||||
|
|||||||
@@ -16,11 +16,12 @@ from app.actuators.models import (
|
|||||||
ManualOverride,
|
ManualOverride,
|
||||||
ModelLifecycleState,
|
ModelLifecycleState,
|
||||||
ReconciliationState,
|
ReconciliationState,
|
||||||
|
SensorWeightGroup,
|
||||||
model_id_for_actuator,
|
model_id_for_actuator,
|
||||||
)
|
)
|
||||||
from app.actuators.store import ActuatorStore
|
from app.actuators.store import ActuatorStore
|
||||||
from app.config import Settings
|
from app.config import Settings
|
||||||
from app.ha.discovery import DiscoveredEntity, EntityRole
|
from app.ha.discovery import DiscoveredEntity, EntityRole, discover_entities
|
||||||
from app.ha.history import EntityHistorySeries, NumericHistoryPoint
|
from app.ha.history import EntityHistorySeries, NumericHistoryPoint
|
||||||
from app.ha.models import HaEntitySummary
|
from app.ha.models import HaEntitySummary
|
||||||
from app.ha.reader import HaReader
|
from app.ha.reader import HaReader
|
||||||
@@ -57,7 +58,7 @@ _STOPWORDS = frozenset(
|
|||||||
"value",
|
"value",
|
||||||
}
|
}
|
||||||
)
|
)
|
||||||
_GENERIC_AREA_NAMES = frozenset({"monitoring", "system", "technik"})
|
_GENERIC_AREA_NAMES = frozenset({"energie", "monitoring", "power", "strom", "system", "technik"})
|
||||||
_NUMERIC_AUTO_ACCEPT_SCORE = 0.82
|
_NUMERIC_AUTO_ACCEPT_SCORE = 0.82
|
||||||
_NUMERIC_AUTO_ACCEPT_MIN_SCORE = 0.5
|
_NUMERIC_AUTO_ACCEPT_MIN_SCORE = 0.5
|
||||||
_NUMERIC_MIN_MARGIN = 0.18
|
_NUMERIC_MIN_MARGIN = 0.18
|
||||||
@@ -72,38 +73,71 @@ _MANUAL_CONTEXT_DOMAINS = frozenset({
|
|||||||
"device_tracker",
|
"device_tracker",
|
||||||
"fan",
|
"fan",
|
||||||
"humidifier",
|
"humidifier",
|
||||||
|
"input_boolean",
|
||||||
|
"input_number",
|
||||||
|
"input_select",
|
||||||
"light",
|
"light",
|
||||||
|
"media_player",
|
||||||
"person",
|
"person",
|
||||||
|
"remote",
|
||||||
|
"scene",
|
||||||
"sensor",
|
"sensor",
|
||||||
|
"sun",
|
||||||
"switch",
|
"switch",
|
||||||
"weather",
|
"weather",
|
||||||
})
|
})
|
||||||
_CONTEXT_SUGGESTION_LIMIT = 120
|
_CONTEXT_SUGGESTION_LIMIT = 500
|
||||||
_OUTDOOR_TOKENS = frozenset({"aussen", "außen", "outdoor", "garten", "terrasse", "balkon"})
|
_OUTDOOR_TOKENS = frozenset({"aussen", "außen", "outdoor", "garten", "terrasse", "balkon"})
|
||||||
_DIAGNOSTIC_TOKENS = frozenset({
|
_DIAGNOSTIC_TOKENS = frozenset({
|
||||||
"basic",
|
"basic",
|
||||||
"battery",
|
"battery",
|
||||||
|
"bytes",
|
||||||
"connect",
|
"connect",
|
||||||
"count",
|
"count",
|
||||||
|
"data",
|
||||||
"diagnostic",
|
"diagnostic",
|
||||||
"firmware",
|
"firmware",
|
||||||
"gesehen",
|
"gesehen",
|
||||||
|
"heat",
|
||||||
|
"inbytes",
|
||||||
|
"interface",
|
||||||
"last",
|
"last",
|
||||||
"linkquality",
|
"linkquality",
|
||||||
"knoten",
|
"knoten",
|
||||||
"knotens",
|
"knotens",
|
||||||
"mqtt",
|
"mqtt",
|
||||||
"node",
|
"node",
|
||||||
|
"outbytes",
|
||||||
|
"pfsense",
|
||||||
"reason",
|
"reason",
|
||||||
"restart",
|
"restart",
|
||||||
"rssi",
|
"rssi",
|
||||||
"signal",
|
"signal",
|
||||||
"ssid",
|
"ssid",
|
||||||
"status",
|
"status",
|
||||||
|
"overheat",
|
||||||
|
"overheating",
|
||||||
|
"overload",
|
||||||
"uptime",
|
"uptime",
|
||||||
|
"vpn",
|
||||||
|
"uberhitzung",
|
||||||
|
"ueberhitzung",
|
||||||
|
"ueberlast",
|
||||||
|
"überhitzung",
|
||||||
|
"überlast",
|
||||||
"wifi",
|
"wifi",
|
||||||
"zuletzt",
|
"zuletzt",
|
||||||
})
|
})
|
||||||
|
_AUTO_CONTEXT_CLASSES = frozenset({
|
||||||
|
"door",
|
||||||
|
"garage_door",
|
||||||
|
"illuminance",
|
||||||
|
"motion",
|
||||||
|
"occupancy",
|
||||||
|
"opening",
|
||||||
|
"presence",
|
||||||
|
"window",
|
||||||
|
})
|
||||||
|
|
||||||
|
|
||||||
class ActuatorReconciliationService:
|
class ActuatorReconciliationService:
|
||||||
@@ -137,7 +171,7 @@ class ActuatorReconciliationService:
|
|||||||
limit: int = _CONTEXT_SUGGESTION_LIMIT,
|
limit: int = _CONTEXT_SUGGESTION_LIMIT,
|
||||||
) -> list[HaEntitySummary]:
|
) -> list[HaEntitySummary]:
|
||||||
entities = {entity.entity_id: entity for entity in self._ha_reader.read_entities()}
|
entities = {entity.entity_id: entity for entity in self._ha_reader.read_entities()}
|
||||||
discovered = {entity.entity_id: entity for entity in self._ha_reader.discover()}
|
discovered = {entity.entity_id: entity for entity in discover_entities(list(entities.values()))}
|
||||||
actuator = entities.get(actuator_entity_id)
|
actuator = entities.get(actuator_entity_id)
|
||||||
if actuator is None:
|
if actuator is None:
|
||||||
raise KeyError("Aktuator-Konfiguration nicht gefunden.")
|
raise KeyError("Aktuator-Konfiguration nicht gefunden.")
|
||||||
@@ -156,13 +190,10 @@ class ActuatorReconciliationService:
|
|||||||
selected = entity.entity_id in selected_ids
|
selected = entity.entity_id in selected_ids
|
||||||
if selected:
|
if selected:
|
||||||
score = max(score, 1.0)
|
score = max(score, 1.0)
|
||||||
if not selected and (
|
if not selected and _is_diagnostic_context(entity):
|
||||||
_is_diagnostic_context(entity)
|
|
||||||
or not _has_context_relationship(actuator, entity)
|
|
||||||
):
|
|
||||||
continue
|
|
||||||
if not selected and score < 0.1:
|
|
||||||
continue
|
continue
|
||||||
|
if not selected and not _has_context_relationship(actuator, entity):
|
||||||
|
score = max(score, 0.01)
|
||||||
ranked.append((score, _context_sort_group(entity), entity))
|
ranked.append((score, _context_sort_group(entity), entity))
|
||||||
ranked.sort(
|
ranked.sort(
|
||||||
key=lambda item: (
|
key=lambda item: (
|
||||||
@@ -209,6 +240,10 @@ class ActuatorReconciliationService:
|
|||||||
override = ManualOverride(
|
override = ManualOverride(
|
||||||
numeric_entity_id=numeric_entity_id,
|
numeric_entity_id=numeric_entity_id,
|
||||||
context_entity_ids=selected_context_ids,
|
context_entity_ids=selected_context_ids,
|
||||||
|
sensor_weights=record.manual_override.sensor_weights if record.manual_override else {},
|
||||||
|
sensor_weight_groups=(
|
||||||
|
record.manual_override.sensor_weight_groups if record.manual_override else []
|
||||||
|
),
|
||||||
updated_at=now,
|
updated_at=now,
|
||||||
note=note,
|
note=note,
|
||||||
)
|
)
|
||||||
@@ -223,17 +258,23 @@ class ActuatorReconciliationService:
|
|||||||
update={
|
update={
|
||||||
"assignment": assignment,
|
"assignment": assignment,
|
||||||
"manual_override": override,
|
"manual_override": override,
|
||||||
"numeric_candidates": _merge_manual_candidates(
|
"numeric_candidates": _apply_weight_overrides(
|
||||||
record.numeric_candidates,
|
_merge_manual_candidates(
|
||||||
entities,
|
record.numeric_candidates,
|
||||||
[numeric_entity_id] if numeric_entity_id else [],
|
entities,
|
||||||
role=EntityRole.MEASUREMENT,
|
[numeric_entity_id] if numeric_entity_id else [],
|
||||||
|
role=EntityRole.MEASUREMENT,
|
||||||
|
),
|
||||||
|
override,
|
||||||
),
|
),
|
||||||
"context_candidates": _merge_manual_candidates(
|
"context_candidates": _apply_weight_overrides(
|
||||||
record.context_candidates,
|
_merge_manual_candidates(
|
||||||
entities,
|
record.context_candidates,
|
||||||
selected_context_ids,
|
entities,
|
||||||
role=EntityRole.CONTEXT,
|
selected_context_ids,
|
||||||
|
role=EntityRole.CONTEXT,
|
||||||
|
),
|
||||||
|
override,
|
||||||
),
|
),
|
||||||
"lifecycle": lifecycle,
|
"lifecycle": lifecycle,
|
||||||
"updated_at": now,
|
"updated_at": now,
|
||||||
@@ -241,6 +282,65 @@ class ActuatorReconciliationService:
|
|||||||
)
|
)
|
||||||
return self._store.upsert(updated)
|
return self._store.upsert(updated)
|
||||||
|
|
||||||
|
def set_weight_overrides(
|
||||||
|
self,
|
||||||
|
actuator_entity_id: str,
|
||||||
|
*,
|
||||||
|
sensor_weights: dict[str, float],
|
||||||
|
sensor_weight_groups: list[SensorWeightGroup],
|
||||||
|
note: str | None = None,
|
||||||
|
) -> ActuatorRecord:
|
||||||
|
now = datetime.now(timezone.utc)
|
||||||
|
record = self._store.get(actuator_entity_id)
|
||||||
|
selected_ids = {
|
||||||
|
entity_id
|
||||||
|
for entity_id in [
|
||||||
|
record.assignment.selected_numeric_entity_id,
|
||||||
|
*record.assignment.selected_context_entity_ids,
|
||||||
|
]
|
||||||
|
if entity_id
|
||||||
|
}
|
||||||
|
selected_ids.update(sensor_weights)
|
||||||
|
for group in sensor_weight_groups:
|
||||||
|
selected_ids.update(group.entity_ids)
|
||||||
|
entities = {entity.entity_id: entity for entity in self._ha_reader.read_entities()}
|
||||||
|
missing = [entity_id for entity_id in selected_ids if entity_id not in entities]
|
||||||
|
if missing:
|
||||||
|
raise ValueError(f"Unbekannte Home-Assistant-Entity: {', '.join(sorted(missing))}")
|
||||||
|
|
||||||
|
previous = record.manual_override
|
||||||
|
override = ManualOverride(
|
||||||
|
numeric_entity_id=(
|
||||||
|
previous.numeric_entity_id
|
||||||
|
if previous is not None
|
||||||
|
else record.assignment.selected_numeric_entity_id
|
||||||
|
),
|
||||||
|
context_entity_ids=(
|
||||||
|
previous.context_entity_ids
|
||||||
|
if previous is not None
|
||||||
|
else record.assignment.selected_context_entity_ids
|
||||||
|
),
|
||||||
|
sensor_weights={entity_id: round(weight, 4) for entity_id, weight in sensor_weights.items()},
|
||||||
|
sensor_weight_groups=sensor_weight_groups,
|
||||||
|
updated_at=now,
|
||||||
|
note=note,
|
||||||
|
)
|
||||||
|
updated = record.model_copy(
|
||||||
|
update={
|
||||||
|
"manual_override": override,
|
||||||
|
"numeric_candidates": _apply_weight_overrides(
|
||||||
|
record.numeric_candidates,
|
||||||
|
override,
|
||||||
|
),
|
||||||
|
"context_candidates": _apply_weight_overrides(
|
||||||
|
record.context_candidates,
|
||||||
|
override,
|
||||||
|
),
|
||||||
|
"updated_at": now,
|
||||||
|
}
|
||||||
|
)
|
||||||
|
return self._store.upsert(updated)
|
||||||
|
|
||||||
def reconcile_all(self, trigger: str = "manual") -> ReconciliationState:
|
def reconcile_all(self, trigger: str = "manual") -> ReconciliationState:
|
||||||
state = self._store.load_reconciliation_state().model_copy(
|
state = self._store.load_reconciliation_state().model_copy(
|
||||||
update={
|
update={
|
||||||
@@ -346,6 +446,9 @@ class ActuatorReconciliationService:
|
|||||||
),
|
),
|
||||||
context=True,
|
context=True,
|
||||||
)
|
)
|
||||||
|
if record.manual_override is not None:
|
||||||
|
numeric_candidates = _apply_weight_overrides(numeric_candidates, record.manual_override)
|
||||||
|
context_candidates = _apply_weight_overrides(context_candidates, record.manual_override)
|
||||||
assignment = (
|
assignment = (
|
||||||
self._manual_assignment(record.manual_override)
|
self._manual_assignment(record.manual_override)
|
||||||
if record.manual_override is not None
|
if record.manual_override is not None
|
||||||
@@ -628,8 +731,12 @@ class ActuatorReconciliationService:
|
|||||||
if context
|
if context
|
||||||
else _NUMERIC_AUTO_ACCEPT_MIN_SCORE
|
else _NUMERIC_AUTO_ACCEPT_MIN_SCORE
|
||||||
)
|
)
|
||||||
|
can_auto_accept_context = (
|
||||||
|
not context or _eligible_for_auto_context(actuator, candidate)
|
||||||
|
)
|
||||||
auto_accepted = (
|
auto_accepted = (
|
||||||
candidate.score >= minimum_score
|
can_auto_accept_context
|
||||||
|
and candidate.score >= minimum_score
|
||||||
and confidence >= auto_score
|
and confidence >= auto_score
|
||||||
and (context or margin >= _NUMERIC_MIN_MARGIN)
|
and (context or margin >= _NUMERIC_MIN_MARGIN)
|
||||||
)
|
)
|
||||||
@@ -702,6 +809,11 @@ def _manual_context_role(
|
|||||||
|
|
||||||
def _context_sort_group(entity: HaEntitySummary) -> str:
|
def _context_sort_group(entity: HaEntitySummary) -> str:
|
||||||
device_class = entity.device_class or ""
|
device_class = entity.device_class or ""
|
||||||
|
text = " ".join(
|
||||||
|
value.lower().replace("_", " ")
|
||||||
|
for value in [entity.entity_id, entity.friendly_name, entity.area_name, entity.device_name]
|
||||||
|
if value
|
||||||
|
)
|
||||||
if device_class in {"motion", "occupancy", "presence"}:
|
if device_class in {"motion", "occupancy", "presence"}:
|
||||||
return "01_presence"
|
return "01_presence"
|
||||||
if device_class in {"illuminance"}:
|
if device_class in {"illuminance"}:
|
||||||
@@ -710,10 +822,26 @@ def _context_sort_group(entity: HaEntitySummary) -> str:
|
|||||||
return "03_opening"
|
return "03_opening"
|
||||||
if device_class in {"humidity", "moisture"}:
|
if device_class in {"humidity", "moisture"}:
|
||||||
return "04_humidity"
|
return "04_humidity"
|
||||||
|
if device_class in {"temperature"}:
|
||||||
|
return "05_temperature"
|
||||||
|
if any(token in text for token in {"pv", "solar", "akku", "batterie", "battery", "einspeisung"}):
|
||||||
|
return "06_pv_battery"
|
||||||
if device_class in {"power", "energy", "current", "voltage"}:
|
if device_class in {"power", "energy", "current", "voltage"}:
|
||||||
return "05_power"
|
return "07_power"
|
||||||
|
if entity.domain in {"weather"}:
|
||||||
|
return "08_weather"
|
||||||
|
if entity.domain in {"fan", "humidifier"}:
|
||||||
|
return "09_ventilation"
|
||||||
|
if entity.domain in {"climate"}:
|
||||||
|
return "10_heating"
|
||||||
|
if entity.domain in {"cover"}:
|
||||||
|
return "11_cover"
|
||||||
if entity.domain in {"light", "switch"}:
|
if entity.domain in {"light", "switch"}:
|
||||||
return "06_states"
|
return "12_states"
|
||||||
|
if entity.domain.startswith("input_"):
|
||||||
|
return "13_helper"
|
||||||
|
if entity.domain in {"person", "device_tracker"}:
|
||||||
|
return "14_people"
|
||||||
return f"20_{entity.domain}_{device_class}"
|
return f"20_{entity.domain}_{device_class}"
|
||||||
|
|
||||||
|
|
||||||
@@ -743,6 +871,23 @@ def _has_context_relationship(actuator: HaEntitySummary, entity: HaEntitySummary
|
|||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _eligible_for_auto_context(
|
||||||
|
actuator: HaEntitySummary,
|
||||||
|
candidate: AssignmentCandidate,
|
||||||
|
) -> bool:
|
||||||
|
device_class = candidate.device_class or ""
|
||||||
|
if device_class in _AUTO_CONTEXT_CLASSES:
|
||||||
|
return True
|
||||||
|
if (
|
||||||
|
actuator.device_name
|
||||||
|
and candidate.device_name
|
||||||
|
and actuator.device_name == candidate.device_name
|
||||||
|
and candidate.domain in {"light", "switch"}
|
||||||
|
):
|
||||||
|
return True
|
||||||
|
return False
|
||||||
|
|
||||||
|
|
||||||
def _score_candidate(
|
def _score_candidate(
|
||||||
actuator: HaEntitySummary,
|
actuator: HaEntitySummary,
|
||||||
entity: HaEntitySummary,
|
entity: HaEntitySummary,
|
||||||
@@ -809,12 +954,17 @@ def _merge_manual_candidates(
|
|||||||
for entity_id in selected_entity_ids:
|
for entity_id in selected_entity_ids:
|
||||||
existing = by_id.get(entity_id)
|
existing = by_id.get(entity_id)
|
||||||
if existing is not None:
|
if existing is not None:
|
||||||
|
evidence = [
|
||||||
|
item
|
||||||
|
for item in existing.evidence
|
||||||
|
if item != "Manuell vom Nutzer als relevant festgelegt."
|
||||||
|
]
|
||||||
by_id[entity_id] = existing.model_copy(
|
by_id[entity_id] = existing.model_copy(
|
||||||
update={
|
update={
|
||||||
"auto_accepted": True,
|
"auto_accepted": True,
|
||||||
"confidence": 1.0,
|
"confidence": 1.0,
|
||||||
"evidence": [
|
"evidence": [
|
||||||
*existing.evidence,
|
*evidence,
|
||||||
"Manuell vom Nutzer als relevant festgelegt.",
|
"Manuell vom Nutzer als relevant festgelegt.",
|
||||||
],
|
],
|
||||||
}
|
}
|
||||||
@@ -841,15 +991,66 @@ def _merge_manual_candidates(
|
|||||||
return sorted(by_id.values(), key=lambda item: (-item.confidence, item.entity_id))
|
return sorted(by_id.values(), key=lambda item: (-item.confidence, item.entity_id))
|
||||||
|
|
||||||
|
|
||||||
|
def _apply_weight_overrides(
|
||||||
|
candidates: list[AssignmentCandidate],
|
||||||
|
override: ManualOverride,
|
||||||
|
) -> list[AssignmentCandidate]:
|
||||||
|
if not override.sensor_weights and not override.sensor_weight_groups:
|
||||||
|
return candidates
|
||||||
|
group_weights: dict[str, float] = {}
|
||||||
|
for group in override.sensor_weight_groups:
|
||||||
|
for entity_id in group.entity_ids:
|
||||||
|
group_weights[entity_id] = max(group_weights.get(entity_id, 0.0), group.weight)
|
||||||
|
weighted: list[AssignmentCandidate] = []
|
||||||
|
for candidate in candidates:
|
||||||
|
explicit = override.sensor_weights.get(candidate.entity_id)
|
||||||
|
group_weight = group_weights.get(candidate.entity_id)
|
||||||
|
manual_weight = explicit if explicit is not None else group_weight
|
||||||
|
effective_weight = manual_weight if manual_weight is not None else 1.0
|
||||||
|
evidence = [
|
||||||
|
item
|
||||||
|
for item in candidate.evidence
|
||||||
|
if not item.startswith("Manuelle Gewichtung:")
|
||||||
|
]
|
||||||
|
if manual_weight is not None:
|
||||||
|
evidence.append(f"Manuelle Gewichtung: {round(manual_weight * 100)} %.")
|
||||||
|
weighted.append(
|
||||||
|
candidate.model_copy(
|
||||||
|
update={
|
||||||
|
"manual_weight": manual_weight,
|
||||||
|
"effective_weight": round(effective_weight, 4),
|
||||||
|
"evidence": evidence,
|
||||||
|
}
|
||||||
|
)
|
||||||
|
)
|
||||||
|
return sorted(weighted, key=lambda item: (-item.confidence * item.effective_weight, item.entity_id))
|
||||||
|
|
||||||
|
|
||||||
def _preferred_device_classes(domain: str, *, context: bool) -> frozenset[str]:
|
def _preferred_device_classes(domain: str, *, context: bool) -> frozenset[str]:
|
||||||
if context:
|
if context:
|
||||||
return frozenset({"door", "garage_door", "motion", "occupancy", "opening", "presence"})
|
mapping = {
|
||||||
|
"climate": {"humidity", "illuminance", "occupancy", "presence", "temperature", "window"},
|
||||||
|
"cover": {"illuminance", "motion", "occupancy", "presence", "wind_speed"},
|
||||||
|
"fan": {"humidity", "moisture", "occupancy", "presence", "temperature"},
|
||||||
|
"humidifier": {"humidity", "moisture", "temperature"},
|
||||||
|
"light": {"door", "garage_door", "illuminance", "motion", "occupancy", "opening", "presence", "window"},
|
||||||
|
"media_player": {"occupancy", "presence"},
|
||||||
|
"switch": {"door", "garage_door", "motion", "occupancy", "opening", "presence", "window"},
|
||||||
|
}
|
||||||
|
return frozenset(
|
||||||
|
mapping.get(
|
||||||
|
domain,
|
||||||
|
{"door", "garage_door", "motion", "occupancy", "opening", "presence"},
|
||||||
|
)
|
||||||
|
)
|
||||||
mapping = {
|
mapping = {
|
||||||
"climate": {"temperature", "humidity", "power"},
|
"climate": {"temperature", "humidity"},
|
||||||
"cover": {"illuminance", "temperature", "wind_speed"},
|
"cover": {"illuminance", "temperature", "wind_speed"},
|
||||||
"fan": {"temperature", "humidity", "power"},
|
"fan": {"temperature", "humidity", "moisture"},
|
||||||
"humidifier": {"humidity", "temperature", "power"},
|
"humidifier": {"humidity", "moisture", "temperature"},
|
||||||
"light": {"illuminance", "power", "energy"},
|
"light": {"illuminance"},
|
||||||
|
"media_player": {"power", "energy"},
|
||||||
|
"remote": {"battery"},
|
||||||
"switch": {"power", "energy", "current"},
|
"switch": {"power", "energy", "current"},
|
||||||
"valve": {"temperature", "pressure", "humidity"},
|
"valve": {"temperature", "pressure", "humidity"},
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -49,6 +49,8 @@ class AssignmentCandidate(BaseModel):
|
|||||||
device_name: str | None = None
|
device_name: str | None = None
|
||||||
score: float = Field(ge=0.0)
|
score: float = Field(ge=0.0)
|
||||||
confidence: float = Field(ge=0.0, le=1.0)
|
confidence: float = Field(ge=0.0, le=1.0)
|
||||||
|
manual_weight: float | None = Field(default=None, ge=0.0, le=1.0)
|
||||||
|
effective_weight: float = Field(default=1.0, ge=0.0, le=1.0)
|
||||||
auto_accepted: bool = False
|
auto_accepted: bool = False
|
||||||
evidence: list[str] = Field(default_factory=list)
|
evidence: list[str] = Field(default_factory=list)
|
||||||
|
|
||||||
@@ -62,9 +64,18 @@ class AssignmentSelection(BaseModel):
|
|||||||
reason: str = "Noch keine Zuordnung vorhanden."
|
reason: str = "Noch keine Zuordnung vorhanden."
|
||||||
|
|
||||||
|
|
||||||
|
class SensorWeightGroup(BaseModel):
|
||||||
|
group_id: str = Field(pattern=r"^[a-z0-9_-]{1,64}$")
|
||||||
|
name: str = Field(min_length=1, max_length=120)
|
||||||
|
entity_ids: list[str] = Field(default_factory=list)
|
||||||
|
weight: float = Field(default=1.0, ge=0.0, le=1.0)
|
||||||
|
|
||||||
|
|
||||||
class ManualOverride(BaseModel):
|
class ManualOverride(BaseModel):
|
||||||
numeric_entity_id: str | None = None
|
numeric_entity_id: str | None = None
|
||||||
context_entity_ids: list[str] = Field(default_factory=list)
|
context_entity_ids: list[str] = Field(default_factory=list)
|
||||||
|
sensor_weights: dict[str, float] = Field(default_factory=dict)
|
||||||
|
sensor_weight_groups: list[SensorWeightGroup] = Field(default_factory=list)
|
||||||
updated_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
|
updated_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
|
||||||
note: str | None = None
|
note: str | None = None
|
||||||
|
|
||||||
|
|||||||
@@ -1,14 +1,20 @@
|
|||||||
from __future__ import annotations
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
from datetime import datetime, timezone
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
from fastapi import APIRouter, Depends, HTTPException, Query, Request, status
|
from fastapi import APIRouter, Depends, HTTPException, Query, Request, status
|
||||||
from pydantic import BaseModel, Field
|
from pydantic import BaseModel, Field
|
||||||
|
|
||||||
from app.actuators.lifecycle import ActuatorReconciliationService
|
from app.actuators.lifecycle import ActuatorReconciliationService
|
||||||
from app.actuators.models import ActuatorRecord, ReconciliationState
|
from app.actuators.models import ActuatorRecord, ReconciliationState, SensorWeightGroup
|
||||||
from app.actuators.store import ActuatorStore
|
from app.actuators.store import ActuatorStore
|
||||||
from app.behavior.engine import BehaviorEngine
|
from app.behavior.engine import BehaviorEngine
|
||||||
|
from app.config import Settings
|
||||||
from app.dependencies import get_ha_reader
|
from app.dependencies import get_ha_reader
|
||||||
from app.ha.discovery import EntityRole
|
from app.ha.discovery import DiscoveredEntity, EntityRole, discover_entities
|
||||||
from app.ha.exceptions import HaClientError
|
from app.ha.exceptions import HaClientError
|
||||||
from app.ha.models import HaEntitySummary
|
from app.ha.models import HaEntitySummary
|
||||||
from app.ha.reader import HaReader
|
from app.ha.reader import HaReader
|
||||||
@@ -38,16 +44,161 @@ class ManualAssignmentRequest(BaseModel):
|
|||||||
note: str | None = Field(default=None, max_length=500)
|
note: str | None = Field(default=None, max_length=500)
|
||||||
|
|
||||||
|
|
||||||
|
class WeightOverrideRequest(BaseModel):
|
||||||
|
sensor_weights: dict[str, float] = Field(default_factory=dict)
|
||||||
|
sensor_weight_groups: list[SensorWeightGroup] = Field(default_factory=list)
|
||||||
|
note: str | None = Field(default=None, max_length=500)
|
||||||
|
|
||||||
|
|
||||||
|
class FeedbackRequest(BaseModel):
|
||||||
|
correct: bool
|
||||||
|
expected_state: str | None = Field(default=None, max_length=100)
|
||||||
|
|
||||||
|
|
||||||
|
class ActuatorSuggestion(BaseModel):
|
||||||
|
entity_id: str
|
||||||
|
domain: str
|
||||||
|
friendly_name: str | None = None
|
||||||
|
area_name: str | None = None
|
||||||
|
device_name: str | None = None
|
||||||
|
confidence: float
|
||||||
|
reason: str
|
||||||
|
related_automation_count: int = 0
|
||||||
|
likely_context_count: int = 0
|
||||||
|
|
||||||
|
|
||||||
|
class ActuatorSummary(BaseModel):
|
||||||
|
actuator_entity_id: str
|
||||||
|
domain: str
|
||||||
|
friendly_name: str | None = None
|
||||||
|
area_name: str | None = None
|
||||||
|
device_name: str | None = None
|
||||||
|
enabled: bool
|
||||||
|
behavior_mode: str
|
||||||
|
behavior_status: str
|
||||||
|
lifecycle_status: str
|
||||||
|
activation_ready: bool
|
||||||
|
activation_reason: str
|
||||||
|
sample_count: int
|
||||||
|
prediction_target_state: str | None = None
|
||||||
|
prediction_confidence: float | None = None
|
||||||
|
updated_at: str
|
||||||
|
|
||||||
|
|
||||||
|
class EntityCacheStatus(BaseModel):
|
||||||
|
available: bool
|
||||||
|
updated_at: str | None = None
|
||||||
|
entity_count: int = 0
|
||||||
|
|
||||||
|
|
||||||
|
class DashboardSystemStatus(BaseModel):
|
||||||
|
api_status: str = "ok"
|
||||||
|
websocket_status: str = "unavailable"
|
||||||
|
websocket_error: str | None = None
|
||||||
|
reconciliation_last_completed_at: str | None = None
|
||||||
|
configured_actuators: int = 0
|
||||||
|
trained_models: int = 0
|
||||||
|
review_required: int = 0
|
||||||
|
|
||||||
|
|
||||||
|
class DashboardDiscoveryGroup(BaseModel):
|
||||||
|
category: str
|
||||||
|
role: str
|
||||||
|
count: int
|
||||||
|
|
||||||
|
|
||||||
|
class DashboardOverview(BaseModel):
|
||||||
|
system: DashboardSystemStatus
|
||||||
|
cache: EntityCacheStatus
|
||||||
|
actuators: list[ActuatorSummary]
|
||||||
|
discovery_groups: list[DashboardDiscoveryGroup]
|
||||||
|
|
||||||
|
|
||||||
@router.get("/discovery", response_model=list[HaEntitySummary])
|
@router.get("/discovery", response_model=list[HaEntitySummary])
|
||||||
def discover_actuators(ha_reader: HaReader = Depends(get_ha_reader)) -> list[HaEntitySummary]:
|
def discover_actuators(
|
||||||
entities = {entity.entity_id: entity for entity in ha_reader.read_entities()}
|
request: Request,
|
||||||
discovered = ha_reader.discover()
|
refresh: bool = Query(default=False),
|
||||||
actuator_ids = sorted(
|
ha_reader: HaReader = Depends(get_ha_reader),
|
||||||
entity.entity_id for entity in discovered if entity.role is EntityRole.ACTUATOR
|
) -> list[HaEntitySummary]:
|
||||||
|
cached_entities = [] if refresh else _load_cached_entities(request)
|
||||||
|
if cached_entities:
|
||||||
|
entities = {entity.entity_id: entity for entity in cached_entities}
|
||||||
|
else:
|
||||||
|
fresh_entities = list(ha_reader.read_entities())
|
||||||
|
_save_cached_entities(request, fresh_entities)
|
||||||
|
entities = {entity.entity_id: entity for entity in fresh_entities}
|
||||||
|
discovered = discover_entities(list(entities.values()))
|
||||||
|
actuator_ids = _deduplicate_actuator_ids(
|
||||||
|
[
|
||||||
|
(entity.entity_id, entity.category)
|
||||||
|
for entity in discovered
|
||||||
|
if entity.role is EntityRole.ACTUATOR
|
||||||
|
],
|
||||||
|
entities,
|
||||||
)
|
)
|
||||||
return [entities[entity_id] for entity_id in actuator_ids if entity_id in entities]
|
return [entities[entity_id] for entity_id in actuator_ids if entity_id in entities]
|
||||||
|
|
||||||
|
|
||||||
|
@router.get("/suggestions", response_model=list[ActuatorSuggestion])
|
||||||
|
def suggest_actuators(
|
||||||
|
request: Request,
|
||||||
|
ha_reader: HaReader = Depends(get_ha_reader),
|
||||||
|
) -> list[ActuatorSuggestion]:
|
||||||
|
entities = {entity.entity_id: entity for entity in ha_reader.read_entities()}
|
||||||
|
discovered = {entity.entity_id: entity for entity in discover_entities(list(entities.values()))}
|
||||||
|
configured_ids = {record.actuator_entity_id for record in _service(request).list_configured()}
|
||||||
|
actuator_ids = _deduplicate_actuator_ids(
|
||||||
|
[
|
||||||
|
(entity.entity_id, entity.category)
|
||||||
|
for entity in discovered.values()
|
||||||
|
if entity.role is EntityRole.ACTUATOR
|
||||||
|
],
|
||||||
|
entities,
|
||||||
|
)
|
||||||
|
suggestions: list[ActuatorSuggestion] = []
|
||||||
|
for entity_id in actuator_ids:
|
||||||
|
if entity_id in configured_ids:
|
||||||
|
continue
|
||||||
|
entity = entities.get(entity_id)
|
||||||
|
if entity is None:
|
||||||
|
continue
|
||||||
|
try:
|
||||||
|
automations = ha_reader.find_automations_for_entity(entity_id)
|
||||||
|
except Exception:
|
||||||
|
automations = []
|
||||||
|
context_count = _likely_context_count(entity, entities, discovered)
|
||||||
|
if not automations and context_count == 0:
|
||||||
|
continue
|
||||||
|
confidence = 1.0 if automations else min(0.85, 0.35 + context_count * 0.1)
|
||||||
|
reason_parts = []
|
||||||
|
if automations:
|
||||||
|
reason_parts.append(f"{len(automations)} passende HA-Automation(en)")
|
||||||
|
if context_count:
|
||||||
|
reason_parts.append(f"{context_count} naheliegende Kontext-Entity(s)")
|
||||||
|
suggestions.append(
|
||||||
|
ActuatorSuggestion(
|
||||||
|
entity_id=entity.entity_id,
|
||||||
|
domain=entity.domain,
|
||||||
|
friendly_name=entity.friendly_name,
|
||||||
|
area_name=entity.area_name,
|
||||||
|
device_name=entity.device_name,
|
||||||
|
confidence=round(confidence, 4),
|
||||||
|
reason=", ".join(reason_parts),
|
||||||
|
related_automation_count=len(automations),
|
||||||
|
likely_context_count=context_count,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
return sorted(
|
||||||
|
suggestions,
|
||||||
|
key=lambda item: (
|
||||||
|
-item.related_automation_count,
|
||||||
|
-item.confidence,
|
||||||
|
item.area_name or "",
|
||||||
|
item.friendly_name or item.entity_id,
|
||||||
|
),
|
||||||
|
)[:30]
|
||||||
|
|
||||||
|
|
||||||
@router.get("/context-options", response_model=list[HaEntitySummary])
|
@router.get("/context-options", response_model=list[HaEntitySummary])
|
||||||
def context_options(
|
def context_options(
|
||||||
request: Request,
|
request: Request,
|
||||||
@@ -61,6 +212,95 @@ def context_options(
|
|||||||
raise HTTPException(status_code=404, detail=str(exc)) from exc
|
raise HTTPException(status_code=404, detail=str(exc)) from exc
|
||||||
|
|
||||||
|
|
||||||
|
@router.get("/summary", response_model=list[ActuatorSummary])
|
||||||
|
def list_configured_summary(request: Request) -> list[ActuatorSummary]:
|
||||||
|
records = _service(request).list_configured()
|
||||||
|
entity_map = _load_cached_entity_map(
|
||||||
|
request,
|
||||||
|
{record.actuator_entity_id for record in records},
|
||||||
|
)
|
||||||
|
return [
|
||||||
|
ActuatorSummary(
|
||||||
|
actuator_entity_id=record.actuator_entity_id,
|
||||||
|
domain=record.actuator_entity_id.split(".", 1)[0],
|
||||||
|
friendly_name=(
|
||||||
|
entity_map[record.actuator_entity_id].friendly_name
|
||||||
|
if record.actuator_entity_id in entity_map
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
area_name=(
|
||||||
|
entity_map[record.actuator_entity_id].area_name
|
||||||
|
if record.actuator_entity_id in entity_map
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
device_name=(
|
||||||
|
entity_map[record.actuator_entity_id].device_name
|
||||||
|
if record.actuator_entity_id in entity_map
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
enabled=record.enabled,
|
||||||
|
behavior_mode=record.behavior.mode.value,
|
||||||
|
behavior_status=record.behavior.status.value,
|
||||||
|
lifecycle_status=record.lifecycle.status.value,
|
||||||
|
activation_ready=record.behavior.activation_ready,
|
||||||
|
activation_reason=record.behavior.activation_reason,
|
||||||
|
sample_count=record.behavior.sample_count,
|
||||||
|
prediction_target_state=(
|
||||||
|
record.behavior.prediction.target_state
|
||||||
|
if record.behavior.prediction is not None
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
prediction_confidence=(
|
||||||
|
record.behavior.prediction.confidence
|
||||||
|
if record.behavior.prediction is not None
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
updated_at=record.updated_at.isoformat(),
|
||||||
|
)
|
||||||
|
for record in records
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
@router.get("/dashboard", response_model=DashboardOverview)
|
||||||
|
def dashboard_overview(request: Request) -> DashboardOverview:
|
||||||
|
cache_payload = _load_entity_cache_payload(request)
|
||||||
|
raw_entities = cache_payload.get("entities", [])
|
||||||
|
if not isinstance(raw_entities, list):
|
||||||
|
raw_entities = []
|
||||||
|
raw_updated_at = cache_payload.get("updated_at")
|
||||||
|
updated_at = raw_updated_at if isinstance(raw_updated_at, str) else None
|
||||||
|
raw_groups = cache_payload.get("discovery_groups", [])
|
||||||
|
cached_groups = [
|
||||||
|
DashboardDiscoveryGroup.model_validate(group)
|
||||||
|
for group in raw_groups
|
||||||
|
if isinstance(group, dict)
|
||||||
|
] if isinstance(raw_groups, list) else []
|
||||||
|
reconciliation = _reconciliation_state_or_default(request)
|
||||||
|
ws_status = getattr(request.app.state, "ws_status", None)
|
||||||
|
actuators = list_configured_summary(request)
|
||||||
|
return DashboardOverview(
|
||||||
|
system=DashboardSystemStatus(
|
||||||
|
websocket_status=getattr(ws_status, "status", "unavailable"),
|
||||||
|
websocket_error=getattr(ws_status, "error", None),
|
||||||
|
reconciliation_last_completed_at=(
|
||||||
|
reconciliation.last_completed_at.isoformat()
|
||||||
|
if reconciliation.last_completed_at is not None
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
configured_actuators=len(actuators),
|
||||||
|
trained_models=reconciliation.trained_models,
|
||||||
|
review_required=reconciliation.review_required,
|
||||||
|
),
|
||||||
|
cache=EntityCacheStatus(
|
||||||
|
available=bool(raw_entities),
|
||||||
|
updated_at=updated_at,
|
||||||
|
entity_count=len(raw_entities),
|
||||||
|
),
|
||||||
|
actuators=actuators,
|
||||||
|
discovery_groups=cached_groups,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
@router.get("", response_model=list[ActuatorRecord])
|
@router.get("", response_model=list[ActuatorRecord])
|
||||||
def list_configured(request: Request) -> list[ActuatorRecord]:
|
def list_configured(request: Request) -> list[ActuatorRecord]:
|
||||||
return _service(request).list_configured()
|
return _service(request).list_configured()
|
||||||
@@ -116,6 +356,22 @@ def evaluate_actuator(
|
|||||||
raise HTTPException(status_code=404, detail=str(exc)) from exc
|
raise HTTPException(status_code=404, detail=str(exc)) from exc
|
||||||
|
|
||||||
|
|
||||||
|
@router.post("/{actuator_entity_id}/feedback", response_model=ActuatorRecord)
|
||||||
|
def record_feedback(
|
||||||
|
actuator_entity_id: str,
|
||||||
|
payload: FeedbackRequest,
|
||||||
|
request: Request,
|
||||||
|
) -> ActuatorRecord:
|
||||||
|
try:
|
||||||
|
return _behavior(request).record_feedback(
|
||||||
|
actuator_entity_id,
|
||||||
|
correct=payload.correct,
|
||||||
|
expected_state=payload.expected_state,
|
||||||
|
)
|
||||||
|
except KeyError as exc:
|
||||||
|
raise HTTPException(status_code=404, detail=str(exc)) from exc
|
||||||
|
|
||||||
|
|
||||||
@router.post("/{actuator_entity_id}/activation", response_model=ActuatorRecord)
|
@router.post("/{actuator_entity_id}/activation", response_model=ActuatorRecord)
|
||||||
def set_activation(
|
def set_activation(
|
||||||
actuator_entity_id: str,
|
actuator_entity_id: str,
|
||||||
@@ -156,6 +412,27 @@ def set_manual_assignment(
|
|||||||
raise HTTPException(status_code=422, detail=str(exc)) from exc
|
raise HTTPException(status_code=422, detail=str(exc)) from exc
|
||||||
|
|
||||||
|
|
||||||
|
@router.post("/{actuator_entity_id}/weights", response_model=ActuatorRecord)
|
||||||
|
def set_weight_overrides(
|
||||||
|
actuator_entity_id: str,
|
||||||
|
payload: WeightOverrideRequest,
|
||||||
|
request: Request,
|
||||||
|
) -> ActuatorRecord:
|
||||||
|
try:
|
||||||
|
_validate_weight_payload(payload)
|
||||||
|
record = _service(request).set_weight_overrides(
|
||||||
|
actuator_entity_id,
|
||||||
|
sensor_weights=payload.sensor_weights,
|
||||||
|
sensor_weight_groups=payload.sensor_weight_groups,
|
||||||
|
note=payload.note,
|
||||||
|
)
|
||||||
|
return record
|
||||||
|
except KeyError as exc:
|
||||||
|
raise HTTPException(status_code=404, detail=str(exc)) from exc
|
||||||
|
except ValueError as exc:
|
||||||
|
raise HTTPException(status_code=422, detail=str(exc)) from exc
|
||||||
|
|
||||||
|
|
||||||
@router.post(
|
@router.post(
|
||||||
"/{actuator_entity_id}/related-automations/refresh",
|
"/{actuator_entity_id}/related-automations/refresh",
|
||||||
response_model=ActuatorRecord,
|
response_model=ActuatorRecord,
|
||||||
@@ -233,3 +510,207 @@ def _behavior(request: Request) -> BehaviorEngine:
|
|||||||
detail="Verhaltenslernen ist nicht initialisiert.",
|
detail="Verhaltenslernen ist nicht initialisiert.",
|
||||||
)
|
)
|
||||||
return engine
|
return engine
|
||||||
|
|
||||||
|
|
||||||
|
def _validate_weight_payload(payload: WeightOverrideRequest) -> None:
|
||||||
|
for entity_id, weight in payload.sensor_weights.items():
|
||||||
|
if "." not in entity_id:
|
||||||
|
raise ValueError(f"Ungültige Entity-ID: {entity_id}")
|
||||||
|
if not 0.0 <= weight <= 1.0:
|
||||||
|
raise ValueError(f"Ungültige Gewichtung für {entity_id}: {weight}")
|
||||||
|
for group in payload.sensor_weight_groups:
|
||||||
|
if not group.entity_ids:
|
||||||
|
raise ValueError(f"Gruppe {group.name} enthält keine Entities.")
|
||||||
|
for entity_id in group.entity_ids:
|
||||||
|
if "." not in entity_id:
|
||||||
|
raise ValueError(f"Ungültige Entity-ID in Gruppe {group.name}: {entity_id}")
|
||||||
|
|
||||||
|
|
||||||
|
def _reconciliation_state_or_default(request: Request) -> ReconciliationState:
|
||||||
|
store = getattr(request.app.state, "actuator_store", None)
|
||||||
|
if not isinstance(store, ActuatorStore):
|
||||||
|
return ReconciliationState()
|
||||||
|
try:
|
||||||
|
return store.load_reconciliation_state()
|
||||||
|
except ValueError:
|
||||||
|
return ReconciliationState(last_summary="Reconciliation-Status ist unlesbar.")
|
||||||
|
|
||||||
|
|
||||||
|
def _entity_cache_path(request: Request) -> Path:
|
||||||
|
store = getattr(request.app.state, "actuator_store", None)
|
||||||
|
settings = getattr(request.app.state, "settings", None)
|
||||||
|
if isinstance(store, ActuatorStore):
|
||||||
|
base_dir = store._root
|
||||||
|
elif isinstance(settings, Settings):
|
||||||
|
base_dir = Path(settings.actuator_store).resolve().parent
|
||||||
|
else:
|
||||||
|
base_dir = Path(".").resolve()
|
||||||
|
return Path(os.getenv("SILLYHOME_ENTITY_CACHE", base_dir / "ha_entity_cache.json"))
|
||||||
|
|
||||||
|
|
||||||
|
def _load_cached_entities(request: Request) -> list[HaEntitySummary]:
|
||||||
|
payload = _load_entity_cache_payload(request)
|
||||||
|
raw_entities = payload.get("entities", [])
|
||||||
|
if not isinstance(raw_entities, list):
|
||||||
|
return []
|
||||||
|
try:
|
||||||
|
return [HaEntitySummary.model_validate(entity) for entity in raw_entities]
|
||||||
|
except ValueError:
|
||||||
|
return []
|
||||||
|
|
||||||
|
|
||||||
|
def _load_cached_entity_map(
|
||||||
|
request: Request,
|
||||||
|
entity_ids: set[str],
|
||||||
|
) -> dict[str, HaEntitySummary]:
|
||||||
|
if not entity_ids:
|
||||||
|
return {}
|
||||||
|
payload = _load_entity_cache_payload(request)
|
||||||
|
raw_entities = payload.get("entities", [])
|
||||||
|
if not isinstance(raw_entities, list):
|
||||||
|
return {}
|
||||||
|
result: dict[str, HaEntitySummary] = {}
|
||||||
|
for raw_entity in raw_entities:
|
||||||
|
if not isinstance(raw_entity, dict):
|
||||||
|
continue
|
||||||
|
entity_id = raw_entity.get("entity_id")
|
||||||
|
if not isinstance(entity_id, str) or entity_id not in entity_ids:
|
||||||
|
continue
|
||||||
|
try:
|
||||||
|
result[entity_id] = HaEntitySummary.model_validate(raw_entity)
|
||||||
|
except ValueError:
|
||||||
|
continue
|
||||||
|
return result
|
||||||
|
|
||||||
|
|
||||||
|
def _load_entity_cache_payload(request: Request) -> dict[str, object]:
|
||||||
|
path = _entity_cache_path(request)
|
||||||
|
if not path.exists():
|
||||||
|
return {}
|
||||||
|
try:
|
||||||
|
payload = json.loads(path.read_text(encoding="utf-8"))
|
||||||
|
return payload if isinstance(payload, dict) else {}
|
||||||
|
except (OSError, TypeError, ValueError):
|
||||||
|
return {}
|
||||||
|
|
||||||
|
|
||||||
|
def _save_cached_entities(request: Request, entities: list[HaEntitySummary]) -> None:
|
||||||
|
path = _entity_cache_path(request)
|
||||||
|
path.parent.mkdir(parents=True, exist_ok=True)
|
||||||
|
group_counts: dict[tuple[str, str], int] = {}
|
||||||
|
for entity in discover_entities(entities):
|
||||||
|
key = (entity.category, entity.role.value)
|
||||||
|
group_counts[key] = group_counts.get(key, 0) + 1
|
||||||
|
payload = {
|
||||||
|
"updated_at": datetime.now(timezone.utc).isoformat(),
|
||||||
|
"discovery_groups": [
|
||||||
|
{"category": category, "role": role, "count": count}
|
||||||
|
for (category, role), count in sorted(group_counts.items())
|
||||||
|
],
|
||||||
|
"entities": [entity.model_dump(mode="json") for entity in entities],
|
||||||
|
}
|
||||||
|
temporary = path.with_suffix(".json.tmp")
|
||||||
|
temporary.write_text(
|
||||||
|
json.dumps(payload, ensure_ascii=True, sort_keys=True) + "\n",
|
||||||
|
encoding="utf-8",
|
||||||
|
)
|
||||||
|
os.replace(temporary, path)
|
||||||
|
|
||||||
|
|
||||||
|
def _deduplicate_actuator_ids(
|
||||||
|
discovered: list[tuple[str, str]],
|
||||||
|
entities: dict[str, HaEntitySummary],
|
||||||
|
) -> list[str]:
|
||||||
|
priority = {
|
||||||
|
"light": 0,
|
||||||
|
"cover_shutter": 1,
|
||||||
|
"heating": 2,
|
||||||
|
"lock": 3,
|
||||||
|
"fan": 4,
|
||||||
|
"switch_socket": 5,
|
||||||
|
"button": 6,
|
||||||
|
"helper": 7,
|
||||||
|
}
|
||||||
|
selected: dict[str, tuple[int, str]] = {}
|
||||||
|
for entity_id, category in discovered:
|
||||||
|
entity = entities.get(entity_id)
|
||||||
|
if entity is None:
|
||||||
|
continue
|
||||||
|
key = _actuator_duplicate_key(entity, category)
|
||||||
|
rank = priority.get(category, 50)
|
||||||
|
current = selected.get(key)
|
||||||
|
if current is None or (rank, entity_id) < current:
|
||||||
|
selected[key] = (rank, entity_id)
|
||||||
|
return sorted(entity_id for _, entity_id in selected.values())
|
||||||
|
|
||||||
|
|
||||||
|
def _actuator_duplicate_key(entity: HaEntitySummary, category: str) -> str:
|
||||||
|
if entity.device_id and category in {"light", "switch_socket", "button"}:
|
||||||
|
return f"device:{entity.device_id}:control"
|
||||||
|
if entity.device_name and category in {"light", "switch_socket", "button"}:
|
||||||
|
return f"device-name:{entity.device_name.lower()}:control"
|
||||||
|
return f"entity:{entity.entity_id}"
|
||||||
|
|
||||||
|
|
||||||
|
def _likely_context_count(
|
||||||
|
actuator: HaEntitySummary,
|
||||||
|
entities: dict[str, HaEntitySummary],
|
||||||
|
discovered: dict[str, DiscoveredEntity],
|
||||||
|
) -> int:
|
||||||
|
actuator_tokens = _tokens(actuator)
|
||||||
|
count = 0
|
||||||
|
for entity in entities.values():
|
||||||
|
if entity.entity_id == actuator.entity_id:
|
||||||
|
continue
|
||||||
|
descriptor = discovered.get(entity.entity_id)
|
||||||
|
role = descriptor.role if descriptor is not None else None
|
||||||
|
if role not in {
|
||||||
|
EntityRole.MEASUREMENT,
|
||||||
|
EntityRole.BINARY_CONTEXT,
|
||||||
|
EntityRole.CONTEXT,
|
||||||
|
}:
|
||||||
|
continue
|
||||||
|
if entity.device_class not in {
|
||||||
|
"door",
|
||||||
|
"energy",
|
||||||
|
"garage_door",
|
||||||
|
"humidity",
|
||||||
|
"illuminance",
|
||||||
|
"motion",
|
||||||
|
"occupancy",
|
||||||
|
"opening",
|
||||||
|
"power",
|
||||||
|
"presence",
|
||||||
|
"temperature",
|
||||||
|
"window",
|
||||||
|
}:
|
||||||
|
continue
|
||||||
|
same_area = bool(
|
||||||
|
actuator.area_name
|
||||||
|
and entity.area_name
|
||||||
|
and actuator.area_name == entity.area_name
|
||||||
|
)
|
||||||
|
same_device = bool(
|
||||||
|
actuator.device_id
|
||||||
|
and entity.device_id
|
||||||
|
and actuator.device_id == entity.device_id
|
||||||
|
)
|
||||||
|
token_match = bool(actuator_tokens.intersection(_tokens(entity)))
|
||||||
|
if same_area or same_device or token_match:
|
||||||
|
count += 1
|
||||||
|
return count
|
||||||
|
|
||||||
|
|
||||||
|
def _tokens(entity: HaEntitySummary) -> set[str]:
|
||||||
|
values = [
|
||||||
|
entity.entity_id,
|
||||||
|
entity.friendly_name,
|
||||||
|
entity.area_name,
|
||||||
|
entity.device_name,
|
||||||
|
]
|
||||||
|
tokens: set[str] = set()
|
||||||
|
for value in values:
|
||||||
|
if not value:
|
||||||
|
continue
|
||||||
|
tokens.update(token for token in value.lower().replace("_", " ").split() if len(token) > 2)
|
||||||
|
return tokens
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
from __future__ import annotations
|
from __future__ import annotations
|
||||||
|
|
||||||
import logging
|
import logging
|
||||||
|
from collections.abc import Sequence
|
||||||
from datetime import datetime, timedelta, timezone
|
from datetime import datetime, timedelta, timezone
|
||||||
from zoneinfo import ZoneInfo
|
from zoneinfo import ZoneInfo
|
||||||
|
|
||||||
@@ -18,6 +19,7 @@ from app.actuators.store import ActuatorStore
|
|||||||
from app.config import Settings
|
from app.config import Settings
|
||||||
from app.ha.exceptions import HaClientError
|
from app.ha.exceptions import HaClientError
|
||||||
from app.ha.history import LogbookEntry, StateHistoryPoint, StateHistorySeries
|
from app.ha.history import LogbookEntry, StateHistoryPoint, StateHistorySeries
|
||||||
|
from app.ha.models import HaEntitySummary
|
||||||
from app.ha.reader import HaReader
|
from app.ha.reader import HaReader
|
||||||
|
|
||||||
_MAX_PATTERNS = 500
|
_MAX_PATTERNS = 500
|
||||||
@@ -187,23 +189,32 @@ class BehaviorEngine:
|
|||||||
results.append(record)
|
results.append(record)
|
||||||
return results
|
return results
|
||||||
|
|
||||||
def evaluate(self, actuator_entity_id: str) -> ActuatorRecord:
|
def evaluate(
|
||||||
|
self,
|
||||||
|
actuator_entity_id: str,
|
||||||
|
*,
|
||||||
|
context_state_overrides: dict[str, str | None] | None = None,
|
||||||
|
context_changed_at_overrides: dict[str, datetime | None] | None = None,
|
||||||
|
current_entities: Sequence[HaEntitySummary] | None = None,
|
||||||
|
) -> ActuatorRecord:
|
||||||
record = self._store.get(actuator_entity_id)
|
record = self._store.get(actuator_entity_id)
|
||||||
now = datetime.now(timezone.utc)
|
now = datetime.now(timezone.utc)
|
||||||
try:
|
if current_entities is None:
|
||||||
entities = {entity.entity_id: entity for entity in self._ha_reader.read_entities()}
|
try:
|
||||||
except HaClientError as exc:
|
current_entities = self._ha_reader.read_entities()
|
||||||
logger.warning("Current HA state unavailable for %s: %s", actuator_entity_id, exc)
|
except HaClientError as exc:
|
||||||
return self._save_behavior(
|
logger.warning("Current HA state unavailable for %s: %s", actuator_entity_id, exc)
|
||||||
record,
|
return self._save_behavior(
|
||||||
record.behavior.model_copy(
|
record,
|
||||||
update={
|
record.behavior.model_copy(
|
||||||
"last_evaluated_at": now,
|
update={
|
||||||
"prediction": None,
|
"last_evaluated_at": now,
|
||||||
"reason": f"Aktueller Home-Assistant-Zustand ist nicht verfügbar: {exc}",
|
"prediction": None,
|
||||||
}
|
"reason": f"Aktueller Home-Assistant-Zustand ist nicht verfügbar: {exc}",
|
||||||
),
|
}
|
||||||
)
|
),
|
||||||
|
)
|
||||||
|
entities = {entity.entity_id: entity for entity in current_entities}
|
||||||
actuator = entities.get(actuator_entity_id)
|
actuator = entities.get(actuator_entity_id)
|
||||||
if actuator is None:
|
if actuator is None:
|
||||||
return self._save_behavior(
|
return self._save_behavior(
|
||||||
@@ -230,6 +241,22 @@ class BehaviorEngine:
|
|||||||
entity_id: entities[entity_id].last_changed
|
entity_id: entities[entity_id].last_changed
|
||||||
for entity_id in current_context
|
for entity_id in current_context
|
||||||
}
|
}
|
||||||
|
selected_context_ids = {
|
||||||
|
entity_id
|
||||||
|
for entity_id in (
|
||||||
|
[
|
||||||
|
record.assignment.selected_numeric_entity_id,
|
||||||
|
*record.assignment.selected_context_entity_ids,
|
||||||
|
]
|
||||||
|
)
|
||||||
|
if entity_id
|
||||||
|
}
|
||||||
|
for entity_id, state in (context_state_overrides or {}).items():
|
||||||
|
if entity_id in selected_context_ids and state is not None:
|
||||||
|
current_context[entity_id] = state
|
||||||
|
for entity_id, changed_at in (context_changed_at_overrides or {}).items():
|
||||||
|
if entity_id in current_context:
|
||||||
|
current_context_changed_at[entity_id] = changed_at or now
|
||||||
prediction = predict_behavior(
|
prediction = predict_behavior(
|
||||||
record.behavior.patterns,
|
record.behavior.patterns,
|
||||||
current_context=current_context,
|
current_context=current_context,
|
||||||
@@ -329,6 +356,95 @@ class BehaviorEngine:
|
|||||||
)
|
)
|
||||||
return self._save_behavior(record, behavior)
|
return self._save_behavior(record, behavior)
|
||||||
|
|
||||||
|
def record_feedback(
|
||||||
|
self,
|
||||||
|
actuator_entity_id: str,
|
||||||
|
*,
|
||||||
|
correct: bool,
|
||||||
|
expected_state: str | None = None,
|
||||||
|
) -> ActuatorRecord:
|
||||||
|
record = self._store.get(actuator_entity_id)
|
||||||
|
now = datetime.now(timezone.utc)
|
||||||
|
entities = {entity.entity_id: entity for entity in self._ha_reader.read_entities()}
|
||||||
|
actuator = entities.get(actuator_entity_id)
|
||||||
|
if actuator is None:
|
||||||
|
raise KeyError("Aktor ist aktuell nicht in Home Assistant verfügbar.")
|
||||||
|
context_ids = [
|
||||||
|
entity_id
|
||||||
|
for entity_id in [
|
||||||
|
record.assignment.selected_numeric_entity_id,
|
||||||
|
*record.assignment.selected_context_entity_ids,
|
||||||
|
]
|
||||||
|
if entity_id
|
||||||
|
]
|
||||||
|
current_context = {
|
||||||
|
entity_id: entities[entity_id].state
|
||||||
|
for entity_id in context_ids
|
||||||
|
if entity_id in entities and entities[entity_id].state is not None
|
||||||
|
}
|
||||||
|
prediction = record.behavior.prediction
|
||||||
|
patterns = list(record.behavior.patterns)
|
||||||
|
reason = "Nutzerfeedback gespeichert."
|
||||||
|
if correct and prediction is not None:
|
||||||
|
local = now.astimezone(ZoneInfo(self._settings.timezone))
|
||||||
|
patterns.append(
|
||||||
|
BehaviorPattern(
|
||||||
|
target_state=prediction.target_state,
|
||||||
|
minute_of_day=local.hour * 60 + local.minute,
|
||||||
|
weekday=local.weekday(),
|
||||||
|
context_states={
|
||||||
|
entity_id: state
|
||||||
|
for entity_id, state in current_context.items()
|
||||||
|
if state is not None
|
||||||
|
},
|
||||||
|
source="user_feedback",
|
||||||
|
weight=1.0,
|
||||||
|
observed_at=now,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
reason = "Vorhersage wurde vom Nutzer als korrekt bestätigt."
|
||||||
|
else:
|
||||||
|
target = prediction.target_state if prediction is not None else None
|
||||||
|
if target:
|
||||||
|
patterns = [
|
||||||
|
pattern.model_copy(update={"weight": 0.1})
|
||||||
|
if pattern.target_state == target
|
||||||
|
and _pattern_context_matches(pattern, current_context)
|
||||||
|
else pattern
|
||||||
|
for pattern in patterns
|
||||||
|
]
|
||||||
|
if expected_state:
|
||||||
|
local = now.astimezone(ZoneInfo(self._settings.timezone))
|
||||||
|
patterns.append(
|
||||||
|
BehaviorPattern(
|
||||||
|
target_state=expected_state,
|
||||||
|
minute_of_day=local.hour * 60 + local.minute,
|
||||||
|
weekday=local.weekday(),
|
||||||
|
context_states={
|
||||||
|
entity_id: state
|
||||||
|
for entity_id, state in current_context.items()
|
||||||
|
if state is not None
|
||||||
|
},
|
||||||
|
source="user_correction",
|
||||||
|
weight=1.0,
|
||||||
|
observed_at=now,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
reason = "Vorhersage wurde vom Nutzer als falsch markiert."
|
||||||
|
behavior = record.behavior.model_copy(
|
||||||
|
update={
|
||||||
|
"patterns": patterns[-_MAX_PATTERNS:],
|
||||||
|
"prediction": (
|
||||||
|
prediction.model_copy(update={"execution_reason": reason})
|
||||||
|
if prediction is not None
|
||||||
|
else None
|
||||||
|
),
|
||||||
|
"reason": reason,
|
||||||
|
"last_trained_at": now,
|
||||||
|
}
|
||||||
|
)
|
||||||
|
return self._save_behavior(record, behavior)
|
||||||
|
|
||||||
def refresh_related_automations(self, actuator_entity_id: str) -> ActuatorRecord:
|
def refresh_related_automations(self, actuator_entity_id: str) -> ActuatorRecord:
|
||||||
record = self._store.get(actuator_entity_id)
|
record = self._store.get(actuator_entity_id)
|
||||||
related = [
|
related = [
|
||||||
@@ -608,20 +724,30 @@ class BehaviorEngine:
|
|||||||
)
|
)
|
||||||
return self._store.upsert(updated)
|
return self._store.upsert(updated)
|
||||||
|
|
||||||
def handle_state_change(self, entity_id: str, new_state: dict[str, object] | None) -> None:
|
def handle_state_change(
|
||||||
|
self,
|
||||||
|
entity_id: str,
|
||||||
|
new_state: dict[str, object] | None,
|
||||||
|
*,
|
||||||
|
current_entities: Sequence[HaEntitySummary] | None = None,
|
||||||
|
) -> None:
|
||||||
"""Wird bei jedem HA-State-Change aufgerufen und löst sofortige Vorhersage aus.
|
"""Wird bei jedem HA-State-Change aufgerufen und löst sofortige Vorhersage aus.
|
||||||
|
|
||||||
- Wenn entity_id ein Aktor ist: evaluate() direkt.
|
- Wenn entity_id ein Aktor ist: evaluate() direkt.
|
||||||
- Wenn entity_id ein Kontext-Entity ist: alle betroffenen Aktoren evaluieren.
|
- Wenn entity_id ein Kontext-Entity ist: alle betroffenen Aktoren evaluieren.
|
||||||
|
- Wenn current_entities gesetzt ist, kommt die Auswertung direkt aus dem
|
||||||
|
WebSocket-State-Cache statt aus einer frischen REST-Abfrage.
|
||||||
"""
|
"""
|
||||||
# Aktor direkt evaluieren
|
# Aktor direkt evaluieren
|
||||||
for record in self._store.list():
|
for record in self._store.list():
|
||||||
if record.actuator_entity_id == entity_id:
|
if record.actuator_entity_id == entity_id:
|
||||||
try:
|
try:
|
||||||
self.evaluate(record.actuator_entity_id)
|
self.evaluate(record.actuator_entity_id, current_entities=current_entities)
|
||||||
except Exception:
|
except Exception:
|
||||||
logger.exception("Event-basierte Vorhersage fehlgeschlagen für %s", record.actuator_entity_id)
|
logger.exception("Event-basierte Vorhersage fehlgeschlagen für %s", record.actuator_entity_id)
|
||||||
return
|
return
|
||||||
|
event_state = _event_state(new_state)
|
||||||
|
event_changed_at = _event_changed_at(new_state) or datetime.now(timezone.utc)
|
||||||
# Kontext-Entity: alle Aktoren finden, die diesen Kontext nutzen
|
# Kontext-Entity: alle Aktoren finden, die diesen Kontext nutzen
|
||||||
affected_actuators = [
|
affected_actuators = [
|
||||||
record.actuator_entity_id
|
record.actuator_entity_id
|
||||||
@@ -633,11 +759,38 @@ class BehaviorEngine:
|
|||||||
]
|
]
|
||||||
for actuator_entity_id in affected_actuators:
|
for actuator_entity_id in affected_actuators:
|
||||||
try:
|
try:
|
||||||
self.evaluate(actuator_entity_id)
|
self.evaluate(
|
||||||
|
actuator_entity_id,
|
||||||
|
context_state_overrides={entity_id: event_state},
|
||||||
|
context_changed_at_overrides={entity_id: event_changed_at},
|
||||||
|
current_entities=current_entities,
|
||||||
|
)
|
||||||
except Exception:
|
except Exception:
|
||||||
logger.exception("Event-basierte Vorhersage fehlgeschlagen für %s", actuator_entity_id)
|
logger.exception("Event-basierte Vorhersage fehlgeschlagen für %s", actuator_entity_id)
|
||||||
|
|
||||||
|
|
||||||
|
def _event_state(new_state: dict[str, object] | None) -> str | None:
|
||||||
|
if not isinstance(new_state, dict):
|
||||||
|
return None
|
||||||
|
state = new_state.get("state")
|
||||||
|
return state if isinstance(state, str) else None
|
||||||
|
|
||||||
|
|
||||||
|
def _event_changed_at(new_state: dict[str, object] | None) -> datetime | None:
|
||||||
|
if not isinstance(new_state, dict):
|
||||||
|
return None
|
||||||
|
value = new_state.get("last_changed") or new_state.get("last_updated")
|
||||||
|
if not isinstance(value, str):
|
||||||
|
return None
|
||||||
|
try:
|
||||||
|
parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
|
||||||
|
except ValueError:
|
||||||
|
return None
|
||||||
|
if parsed.tzinfo is None:
|
||||||
|
return parsed.replace(tzinfo=timezone.utc)
|
||||||
|
return parsed
|
||||||
|
|
||||||
|
|
||||||
def predict_behavior(
|
def predict_behavior(
|
||||||
patterns: list[BehaviorPattern],
|
patterns: list[BehaviorPattern],
|
||||||
*,
|
*,
|
||||||
@@ -745,8 +898,10 @@ def predict_behavior(
|
|||||||
|
|
||||||
|
|
||||||
def service_for_state(domain: str, target_state: str) -> str | None:
|
def service_for_state(domain: str, target_state: str) -> str | None:
|
||||||
if domain in {"fan", "humidifier", "light", "switch"}:
|
if domain in {"fan", "humidifier", "light", "media_player", "remote", "switch"}:
|
||||||
return {"on": "turn_on", "off": "turn_off"}.get(target_state)
|
return {"on": "turn_on", "off": "turn_off"}.get(target_state)
|
||||||
|
if domain == "scene":
|
||||||
|
return "turn_on" if target_state == "on" else None
|
||||||
if domain == "cover":
|
if domain == "cover":
|
||||||
return {"open": "open_cover", "closed": "close_cover"}.get(target_state)
|
return {"open": "open_cover", "closed": "close_cover"}.get(target_state)
|
||||||
return None
|
return None
|
||||||
@@ -792,6 +947,20 @@ def _matches_own_execution(
|
|||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _pattern_context_matches(
|
||||||
|
pattern: BehaviorPattern,
|
||||||
|
current_context: dict[str, str | None],
|
||||||
|
) -> bool:
|
||||||
|
comparable = [
|
||||||
|
(entity_id, expected)
|
||||||
|
for entity_id, expected in pattern.context_states.items()
|
||||||
|
if entity_id in current_context
|
||||||
|
]
|
||||||
|
if not comparable:
|
||||||
|
return False
|
||||||
|
return all(current_context[entity_id] == expected for entity_id, expected in comparable)
|
||||||
|
|
||||||
|
|
||||||
def _recent_context_transition(
|
def _recent_context_transition(
|
||||||
history: dict[str, StateHistorySeries],
|
history: dict[str, StateHistorySeries],
|
||||||
context_ids: list[str],
|
context_ids: list[str],
|
||||||
|
|||||||
@@ -21,6 +21,7 @@ class DiscoveredEntity(BaseModel):
|
|||||||
device_class: str | None = None
|
device_class: str | None = None
|
||||||
state_class: str | None = None
|
state_class: str | None = None
|
||||||
unit_of_measurement: str | None = None
|
unit_of_measurement: str | None = None
|
||||||
|
category: str
|
||||||
role: EntityRole
|
role: EntityRole
|
||||||
learnable: bool
|
learnable: bool
|
||||||
reason: str
|
reason: str
|
||||||
@@ -82,14 +83,42 @@ _BINARY_CONTEXT_CLASSES = frozenset({
|
|||||||
"window",
|
"window",
|
||||||
})
|
})
|
||||||
_ACTUATOR_DOMAINS = frozenset({
|
_ACTUATOR_DOMAINS = frozenset({
|
||||||
|
"button",
|
||||||
|
"climate",
|
||||||
"cover",
|
"cover",
|
||||||
"fan",
|
"fan",
|
||||||
"humidifier",
|
"humidifier",
|
||||||
|
"input_boolean",
|
||||||
|
"input_button",
|
||||||
|
"lock",
|
||||||
"light",
|
"light",
|
||||||
|
"media_player",
|
||||||
|
"number",
|
||||||
|
"remote",
|
||||||
|
"scene",
|
||||||
|
"siren",
|
||||||
"switch",
|
"switch",
|
||||||
|
"valve",
|
||||||
|
})
|
||||||
|
_CONTEXT_DOMAINS = frozenset({
|
||||||
|
"device_tracker",
|
||||||
|
"input_boolean",
|
||||||
|
"input_datetime",
|
||||||
|
"input_number",
|
||||||
|
"input_select",
|
||||||
|
"person",
|
||||||
|
"sun",
|
||||||
|
"weather",
|
||||||
|
"zone",
|
||||||
|
})
|
||||||
|
_LEARNABLE_CONTEXT_DOMAINS = frozenset({
|
||||||
|
"device_tracker",
|
||||||
|
"input_boolean",
|
||||||
|
"input_number",
|
||||||
|
"input_select",
|
||||||
|
"person",
|
||||||
|
"weather",
|
||||||
})
|
})
|
||||||
_CONTEXT_DOMAINS = frozenset({"device_tracker", "person", "sun", "weather", "zone"})
|
|
||||||
_LEARNABLE_CONTEXT_DOMAINS = frozenset({"device_tracker", "person", "weather"})
|
|
||||||
_NUMERIC_STATE_CLASSES = frozenset({"measurement", "total", "total_increasing"})
|
_NUMERIC_STATE_CLASSES = frozenset({"measurement", "total", "total_increasing"})
|
||||||
|
|
||||||
|
|
||||||
@@ -102,6 +131,7 @@ def classify_entity(entity: HaEntitySummary) -> DiscoveredEntity:
|
|||||||
return _result(
|
return _result(
|
||||||
entity,
|
entity,
|
||||||
EntityRole.MEASUREMENT,
|
EntityRole.MEASUREMENT,
|
||||||
|
category=_measurement_category(entity),
|
||||||
learnable=True,
|
learnable=True,
|
||||||
reason="Numerischer Messsensor für Zeitreihen und Training.",
|
reason="Numerischer Messsensor für Zeitreihen und Training.",
|
||||||
)
|
)
|
||||||
@@ -110,6 +140,7 @@ def classify_entity(entity: HaEntitySummary) -> DiscoveredEntity:
|
|||||||
return _result(
|
return _result(
|
||||||
entity,
|
entity,
|
||||||
EntityRole.BINARY_CONTEXT,
|
EntityRole.BINARY_CONTEXT,
|
||||||
|
category=_binary_category(entity),
|
||||||
learnable=True,
|
learnable=True,
|
||||||
reason="Binärer Kontextsensor für Zustands- und Anwesenheitsmuster.",
|
reason="Binärer Kontextsensor für Zustands- und Anwesenheitsmuster.",
|
||||||
)
|
)
|
||||||
@@ -119,6 +150,7 @@ def classify_entity(entity: HaEntitySummary) -> DiscoveredEntity:
|
|||||||
return _result(
|
return _result(
|
||||||
entity,
|
entity,
|
||||||
EntityRole.CONTEXT,
|
EntityRole.CONTEXT,
|
||||||
|
category=_context_category(entity),
|
||||||
learnable=learnable,
|
learnable=learnable,
|
||||||
reason=(
|
reason=(
|
||||||
"Kontextquelle für Training und Erklärungen."
|
"Kontextquelle für Training und Erklärungen."
|
||||||
@@ -131,6 +163,7 @@ def classify_entity(entity: HaEntitySummary) -> DiscoveredEntity:
|
|||||||
return _result(
|
return _result(
|
||||||
entity,
|
entity,
|
||||||
EntityRole.ACTUATOR,
|
EntityRole.ACTUATOR,
|
||||||
|
category=_actuator_category(entity),
|
||||||
learnable=False,
|
learnable=False,
|
||||||
reason="Aktor ist ein mögliches Automationsziel, aber kein Trainingssensor.",
|
reason="Aktor ist ein mögliches Automationsziel, aber kein Trainingssensor.",
|
||||||
)
|
)
|
||||||
@@ -138,6 +171,7 @@ def classify_entity(entity: HaEntitySummary) -> DiscoveredEntity:
|
|||||||
return _result(
|
return _result(
|
||||||
entity,
|
entity,
|
||||||
EntityRole.UNSUPPORTED,
|
EntityRole.UNSUPPORTED,
|
||||||
|
category="unsupported",
|
||||||
learnable=False,
|
learnable=False,
|
||||||
reason="Entity-Typ ist noch nicht für Lernen oder Automationen klassifiziert.",
|
reason="Entity-Typ ist noch nicht für Lernen oder Automationen klassifiziert.",
|
||||||
)
|
)
|
||||||
@@ -162,6 +196,7 @@ def _result(
|
|||||||
entity: HaEntitySummary,
|
entity: HaEntitySummary,
|
||||||
role: EntityRole,
|
role: EntityRole,
|
||||||
*,
|
*,
|
||||||
|
category: str,
|
||||||
learnable: bool,
|
learnable: bool,
|
||||||
reason: str,
|
reason: str,
|
||||||
) -> DiscoveredEntity:
|
) -> DiscoveredEntity:
|
||||||
@@ -171,7 +206,117 @@ def _result(
|
|||||||
device_class=entity.device_class,
|
device_class=entity.device_class,
|
||||||
state_class=entity.state_class,
|
state_class=entity.state_class,
|
||||||
unit_of_measurement=entity.unit_of_measurement,
|
unit_of_measurement=entity.unit_of_measurement,
|
||||||
|
category=category,
|
||||||
role=role,
|
role=role,
|
||||||
learnable=learnable,
|
learnable=learnable,
|
||||||
reason=reason,
|
reason=reason,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _actuator_category(entity: HaEntitySummary) -> str:
|
||||||
|
text = _entity_text(entity)
|
||||||
|
if entity.domain == "light":
|
||||||
|
return "light"
|
||||||
|
if entity.domain == "switch":
|
||||||
|
if any(token in text for token in {"steckdose", "socket", "plug", "outlet", "shelly"}):
|
||||||
|
return "socket"
|
||||||
|
return "switch_socket"
|
||||||
|
if entity.domain == "button" or entity.domain == "input_button":
|
||||||
|
return "button"
|
||||||
|
if entity.domain == "cover":
|
||||||
|
return "cover_shutter"
|
||||||
|
if entity.domain == "climate":
|
||||||
|
return "heating"
|
||||||
|
if entity.domain == "lock":
|
||||||
|
return "lock"
|
||||||
|
if entity.domain == "fan":
|
||||||
|
return "fan"
|
||||||
|
if entity.domain in {"media_player", "remote"}:
|
||||||
|
return "media_tv"
|
||||||
|
if entity.domain == "scene":
|
||||||
|
return "scene"
|
||||||
|
if entity.domain in {"input_boolean", "number"}:
|
||||||
|
return "helper"
|
||||||
|
return entity.domain
|
||||||
|
|
||||||
|
|
||||||
|
def _measurement_category(entity: HaEntitySummary) -> str:
|
||||||
|
device_class = entity.device_class or ""
|
||||||
|
text = _entity_text(entity)
|
||||||
|
if any(
|
||||||
|
token in text
|
||||||
|
for token in {
|
||||||
|
"pv",
|
||||||
|
"solar",
|
||||||
|
"photovoltaik",
|
||||||
|
"akku",
|
||||||
|
"batterie",
|
||||||
|
"battery",
|
||||||
|
"einspeisung",
|
||||||
|
"wechselrichter",
|
||||||
|
"inverter",
|
||||||
|
}
|
||||||
|
):
|
||||||
|
return "pv_battery_grid"
|
||||||
|
if entity.domain == "weather":
|
||||||
|
return "weather"
|
||||||
|
if device_class == "illuminance":
|
||||||
|
return "brightness"
|
||||||
|
if device_class == "temperature":
|
||||||
|
return "temperature"
|
||||||
|
if device_class in {"humidity", "moisture"}:
|
||||||
|
return "humidity"
|
||||||
|
if device_class in {"power", "energy", "current", "voltage", "apparent_power"}:
|
||||||
|
return "energy_power"
|
||||||
|
if device_class in {"battery", "signal_strength"}:
|
||||||
|
return "diagnostic"
|
||||||
|
return "measurement"
|
||||||
|
|
||||||
|
|
||||||
|
def _binary_category(entity: HaEntitySummary) -> str:
|
||||||
|
device_class = entity.device_class or ""
|
||||||
|
if device_class in {"motion", "occupancy", "presence"}:
|
||||||
|
return "presence_motion"
|
||||||
|
if device_class in {"door", "garage_door", "opening", "window"}:
|
||||||
|
return "opening"
|
||||||
|
if device_class in {"smoke", "safety", "problem"}:
|
||||||
|
return "safety"
|
||||||
|
if device_class in {"lock"}:
|
||||||
|
return "lock_state"
|
||||||
|
return "binary"
|
||||||
|
|
||||||
|
|
||||||
|
def _context_category(entity: HaEntitySummary) -> str:
|
||||||
|
text = _entity_text(entity)
|
||||||
|
if entity.domain.startswith("input_"):
|
||||||
|
return "helper"
|
||||||
|
if entity.domain in {"person", "device_tracker", "zone"}:
|
||||||
|
return "presence_location"
|
||||||
|
if entity.domain == "weather":
|
||||||
|
return "weather"
|
||||||
|
if entity.domain in {"light"}:
|
||||||
|
return "light_state"
|
||||||
|
if entity.domain in {"switch"}:
|
||||||
|
if any(token in text for token in {"steckdose", "socket", "plug", "outlet", "shelly"}):
|
||||||
|
return "socket_state"
|
||||||
|
return "switch_state"
|
||||||
|
if entity.domain in {"climate"}:
|
||||||
|
return "heating_state"
|
||||||
|
if entity.domain in {"fan", "humidifier"}:
|
||||||
|
return "ventilation_state"
|
||||||
|
if entity.domain in {"cover"}:
|
||||||
|
return "cover_state"
|
||||||
|
return entity.domain
|
||||||
|
|
||||||
|
|
||||||
|
def _entity_text(entity: HaEntitySummary) -> str:
|
||||||
|
return " ".join(
|
||||||
|
value.lower().replace("_", " ")
|
||||||
|
for value in [
|
||||||
|
entity.entity_id,
|
||||||
|
entity.friendly_name,
|
||||||
|
entity.area_name,
|
||||||
|
entity.device_name,
|
||||||
|
]
|
||||||
|
if value
|
||||||
|
)
|
||||||
|
|||||||
160
app/main.py
160
app/main.py
@@ -3,6 +3,7 @@ import json
|
|||||||
import logging
|
import logging
|
||||||
from contextlib import asynccontextmanager, suppress
|
from contextlib import asynccontextmanager, suppress
|
||||||
from collections.abc import AsyncIterator
|
from collections.abc import AsyncIterator
|
||||||
|
from datetime import datetime, timezone
|
||||||
from pathlib import Path
|
from pathlib import Path
|
||||||
from typing import cast
|
from typing import cast
|
||||||
|
|
||||||
@@ -19,6 +20,7 @@ from app.behavior.engine import BehaviorEngine
|
|||||||
from app.config import load_settings
|
from app.config import load_settings
|
||||||
from app.core.exception_handlers import register_exception_handlers
|
from app.core.exception_handlers import register_exception_handlers
|
||||||
from app.ha.client import HaClient, HaClientSettings
|
from app.ha.client import HaClient, HaClientSettings
|
||||||
|
from app.ha.models import HaEntitySummary
|
||||||
from app.ha.reader import HaReader
|
from app.ha.reader import HaReader
|
||||||
from app.ml.registry.model_registry import ModelRegistry
|
from app.ml.registry.model_registry import ModelRegistry
|
||||||
from backend.routes.ml import init_ml_routes
|
from backend.routes.ml import init_ml_routes
|
||||||
@@ -41,6 +43,7 @@ class _WsStatus:
|
|||||||
async def lifespan(app: FastAPI) -> AsyncIterator[None]:
|
async def lifespan(app: FastAPI) -> AsyncIterator[None]:
|
||||||
settings = app.state.settings
|
settings = app.state.settings
|
||||||
client: HaClient | None = None
|
client: HaClient | None = None
|
||||||
|
startup_task: asyncio.Task[None] | None = None
|
||||||
reconcile_task: asyncio.Task[None] | None = None
|
reconcile_task: asyncio.Task[None] | None = None
|
||||||
event_listener_task: asyncio.Task[None] | None = None
|
event_listener_task: asyncio.Task[None] | None = None
|
||||||
fallback_task: asyncio.Task[None] | None = None
|
fallback_task: asyncio.Task[None] | None = None
|
||||||
@@ -72,15 +75,17 @@ async def lifespan(app: FastAPI) -> AsyncIterator[None]:
|
|||||||
settings=settings,
|
settings=settings,
|
||||||
)
|
)
|
||||||
app.state.ws_status = _WsStatus()
|
app.state.ws_status = _WsStatus()
|
||||||
await asyncio.to_thread(app.state.actuator_service.reconcile_all, "startup")
|
startup_task = asyncio.create_task(_startup_reconciliation(app))
|
||||||
await asyncio.to_thread(app.state.behavior_engine.train_all)
|
|
||||||
await asyncio.to_thread(app.state.behavior_engine.evaluate_all)
|
|
||||||
reconcile_task = asyncio.create_task(_periodic_reconciliation(app))
|
reconcile_task = asyncio.create_task(_periodic_reconciliation(app))
|
||||||
event_listener_task = asyncio.create_task(_ha_event_listener(app, client))
|
event_listener_task = asyncio.create_task(_ha_event_listener(app, client))
|
||||||
fallback_task = asyncio.create_task(_fallback_prediction(app))
|
fallback_task = asyncio.create_task(_fallback_prediction(app))
|
||||||
try:
|
try:
|
||||||
yield
|
yield
|
||||||
finally:
|
finally:
|
||||||
|
if startup_task is not None:
|
||||||
|
startup_task.cancel()
|
||||||
|
with suppress(asyncio.CancelledError):
|
||||||
|
await startup_task
|
||||||
if reconcile_task is not None:
|
if reconcile_task is not None:
|
||||||
reconcile_task.cancel()
|
reconcile_task.cancel()
|
||||||
with suppress(asyncio.CancelledError):
|
with suppress(asyncio.CancelledError):
|
||||||
@@ -100,7 +105,7 @@ async def lifespan(app: FastAPI) -> AsyncIterator[None]:
|
|||||||
app = FastAPI(
|
app = FastAPI(
|
||||||
title="SillyHome Next API",
|
title="SillyHome Next API",
|
||||||
description="Lokales Smart-Home-Intelligenzsystem für Home Assistant.",
|
description="Lokales Smart-Home-Intelligenzsystem für Home Assistant.",
|
||||||
version="0.7.8",
|
version="1.0.4",
|
||||||
lifespan=lifespan,
|
lifespan=lifespan,
|
||||||
)
|
)
|
||||||
app.state.settings = load_settings()
|
app.state.settings = load_settings()
|
||||||
@@ -145,24 +150,59 @@ async def _periodic_reconciliation(app: FastAPI) -> None:
|
|||||||
service = getattr(app.state, "actuator_service", None)
|
service = getattr(app.state, "actuator_service", None)
|
||||||
if not isinstance(service, ActuatorReconciliationService):
|
if not isinstance(service, ActuatorReconciliationService):
|
||||||
continue
|
continue
|
||||||
await asyncio.to_thread(service.reconcile_all, "scheduled")
|
try:
|
||||||
|
await asyncio.to_thread(service.reconcile_all, "scheduled")
|
||||||
|
engine = getattr(app.state, "behavior_engine", None)
|
||||||
|
if isinstance(engine, BehaviorEngine):
|
||||||
|
await asyncio.to_thread(engine.train_all)
|
||||||
|
except Exception:
|
||||||
|
logger.exception("Geplante Reconciliation fehlgeschlagen; nächster Lauf versucht es erneut.")
|
||||||
|
|
||||||
|
|
||||||
|
async def _startup_reconciliation(app: FastAPI) -> None:
|
||||||
|
delay_seconds = 5
|
||||||
|
while True:
|
||||||
|
service = getattr(app.state, "actuator_service", None)
|
||||||
engine = getattr(app.state, "behavior_engine", None)
|
engine = getattr(app.state, "behavior_engine", None)
|
||||||
if isinstance(engine, BehaviorEngine):
|
if not isinstance(service, ActuatorReconciliationService) or not isinstance(
|
||||||
|
engine,
|
||||||
|
BehaviorEngine,
|
||||||
|
):
|
||||||
|
return
|
||||||
|
try:
|
||||||
|
await asyncio.to_thread(service.reconcile_all, "startup")
|
||||||
await asyncio.to_thread(engine.train_all)
|
await asyncio.to_thread(engine.train_all)
|
||||||
|
await asyncio.to_thread(engine.evaluate_all)
|
||||||
|
logger.info("Startup-Reconciliation erfolgreich abgeschlossen.")
|
||||||
|
return
|
||||||
|
except Exception as exc:
|
||||||
|
logger.warning(
|
||||||
|
"Startup-Reconciliation verschoben: %s. Neuer Versuch in %ss.",
|
||||||
|
exc,
|
||||||
|
delay_seconds,
|
||||||
|
)
|
||||||
|
await asyncio.sleep(delay_seconds)
|
||||||
|
delay_seconds = min(delay_seconds * 2, 60)
|
||||||
|
|
||||||
|
|
||||||
async def _ha_event_listener(app: FastAPI, client: HaClient) -> None:
|
async def _ha_event_listener(app: FastAPI, client: HaClient) -> None:
|
||||||
"""Hört auf Home-Assistant-Websocket-Events und löst sofortige Vorhersagen aus."""
|
"""Hört auf Home-Assistant-Websocket-Events und löst sofortige Vorhersagen aus."""
|
||||||
settings = app.state.settings
|
settings = app.state.settings
|
||||||
engine = app.state.behavior_engine
|
engine = app.state.behavior_engine
|
||||||
|
ha_reader = getattr(app.state, "ha_reader", None)
|
||||||
store = app.state.actuator_store
|
store = app.state.actuator_store
|
||||||
if not isinstance(engine, BehaviorEngine) or not isinstance(store, ActuatorStore):
|
if (
|
||||||
|
not isinstance(engine, BehaviorEngine)
|
||||||
|
or not isinstance(store, ActuatorStore)
|
||||||
|
or not isinstance(ha_reader, HaReader)
|
||||||
|
):
|
||||||
logger.error("BehaviorEngine oder ActuatorStore nicht initialisiert")
|
logger.error("BehaviorEngine oder ActuatorStore nicht initialisiert")
|
||||||
ws_status = getattr(app.state, "ws_status", None)
|
ws_status = getattr(app.state, "ws_status", None)
|
||||||
if ws_status is not None:
|
if ws_status is not None:
|
||||||
ws_status.status = "error"
|
ws_status.status = "error"
|
||||||
ws_status.error = "BehaviorEngine oder ActuatorStore nicht initialisiert"
|
ws_status.error = "BehaviorEngine oder ActuatorStore nicht initialisiert"
|
||||||
return
|
return
|
||||||
|
state_cache: dict[str, HaEntitySummary] = {}
|
||||||
ha_url = str(settings.ha_url).rstrip("/")
|
ha_url = str(settings.ha_url).rstrip("/")
|
||||||
ws_url = ha_url.replace("http://", "ws://").replace("https://", "wss://") + "/api/websocket"
|
ws_url = ha_url.replace("http://", "ws://").replace("https://", "wss://") + "/api/websocket"
|
||||||
auth_token = cast(str, settings.ha_token)
|
auth_token = cast(str, settings.ha_token)
|
||||||
@@ -171,7 +211,11 @@ async def _ha_event_listener(app: FastAPI, client: HaClient) -> None:
|
|||||||
if ws_status is not None:
|
if ws_status is not None:
|
||||||
ws_status.status = "connecting"
|
ws_status.status = "connecting"
|
||||||
try:
|
try:
|
||||||
async with websockets.connect(ws_url, ping_interval=None) as websocket:
|
async with websockets.connect(
|
||||||
|
ws_url,
|
||||||
|
ping_interval=20,
|
||||||
|
ping_timeout=10,
|
||||||
|
) as websocket:
|
||||||
auth_required_msg = await websocket.recv()
|
auth_required_msg = await websocket.recv()
|
||||||
auth_required_data = json.loads(auth_required_msg)
|
auth_required_data = json.loads(auth_required_msg)
|
||||||
if auth_required_data.get("type") != "auth_required":
|
if auth_required_data.get("type") != "auth_required":
|
||||||
@@ -194,6 +238,7 @@ async def _ha_event_listener(app: FastAPI, client: HaClient) -> None:
|
|||||||
continue
|
continue
|
||||||
|
|
||||||
logger.info("WebSocket-Verbindung zu Home Assistant hergestellt")
|
logger.info("WebSocket-Verbindung zu Home Assistant hergestellt")
|
||||||
|
state_cache = await asyncio.to_thread(_load_ha_state_cache, ha_reader)
|
||||||
if ws_status is not None:
|
if ws_status is not None:
|
||||||
ws_status.status = "connected"
|
ws_status.status = "connected"
|
||||||
ws_status.error = None
|
ws_status.error = None
|
||||||
@@ -220,29 +265,38 @@ async def _ha_event_listener(app: FastAPI, client: HaClient) -> None:
|
|||||||
entity_id = event_data.get("entity_id")
|
entity_id = event_data.get("entity_id")
|
||||||
if not entity_id:
|
if not entity_id:
|
||||||
continue
|
continue
|
||||||
|
new_state = event_data.get("new_state")
|
||||||
|
_update_ha_state_cache(state_cache, entity_id, new_state)
|
||||||
|
if not _is_relevant_state_change(store, str(entity_id)):
|
||||||
|
continue
|
||||||
# Prüfe, ob Entity ein Aktor oder relevanter Kontext ist
|
# Prüfe, ob Entity ein Aktor oder relevanter Kontext ist
|
||||||
# Sofortige Vorhersage für betroffene Aktoren auslösen
|
# Sofortige Vorhersage für betroffene Aktoren auslösen
|
||||||
await asyncio.to_thread(
|
await asyncio.to_thread(
|
||||||
engine.handle_state_change,
|
engine.handle_state_change,
|
||||||
entity_id,
|
entity_id,
|
||||||
event_data.get("new_state"),
|
new_state,
|
||||||
|
current_entities=list(state_cache.values()),
|
||||||
)
|
)
|
||||||
except json.JSONDecodeError:
|
except json.JSONDecodeError:
|
||||||
logger.warning("Ungültige JSON-Nachricht von HA-WebSocket")
|
logger.warning("Ungültige JSON-Nachricht von HA-WebSocket")
|
||||||
except Exception as exc:
|
except Exception as exc:
|
||||||
logger.exception("Fehler bei Event-Verarbeitung: %s", exc)
|
logger.exception("Fehler bei Event-Verarbeitung: %s", exc)
|
||||||
except (websockets.exceptions.ConnectionClosed, OSError) as exc:
|
except (
|
||||||
logger.warning("WebSocket-Verbindung unterbrochen: %s. Wiederholung in 5s...", exc)
|
websockets.exceptions.ConnectionClosed,
|
||||||
|
websockets.exceptions.InvalidStatus,
|
||||||
|
OSError,
|
||||||
|
) as exc:
|
||||||
|
logger.warning("WebSocket-Verbindung unterbrochen: %s. Wiederholung in 1s...", exc)
|
||||||
if ws_status is not None:
|
if ws_status is not None:
|
||||||
ws_status.status = "reconnecting"
|
ws_status.status = "reconnecting"
|
||||||
ws_status.error = str(exc)
|
ws_status.error = str(exc)
|
||||||
await asyncio.sleep(5)
|
await asyncio.sleep(1)
|
||||||
except Exception as exc:
|
except Exception as exc:
|
||||||
logger.exception("Unerwarteter Fehler im Event-Listener: %s", exc)
|
logger.exception("Unerwarteter Fehler im Event-Listener: %s", exc)
|
||||||
if ws_status is not None:
|
if ws_status is not None:
|
||||||
ws_status.status = "error"
|
ws_status.status = "error"
|
||||||
ws_status.error = str(exc)
|
ws_status.error = str(exc)
|
||||||
await asyncio.sleep(5)
|
await asyncio.sleep(1)
|
||||||
|
|
||||||
|
|
||||||
# Fallback: periodische Vorhersage falls Event-Stream ausfällt
|
# Fallback: periodische Vorhersage falls Event-Stream ausfällt
|
||||||
@@ -268,4 +322,82 @@ async def _fallback_prediction(app: FastAPI) -> None:
|
|||||||
"Fallback-Vorhersage aktiv (WebSocket-Status: %s)",
|
"Fallback-Vorhersage aktiv (WebSocket-Status: %s)",
|
||||||
ws_status.status if ws_status else "unavailable",
|
ws_status.status if ws_status else "unavailable",
|
||||||
)
|
)
|
||||||
await asyncio.to_thread(engine.evaluate_all)
|
try:
|
||||||
|
await asyncio.to_thread(engine.evaluate_all)
|
||||||
|
except Exception:
|
||||||
|
logger.exception("Fallback-Vorhersage fehlgeschlagen.")
|
||||||
|
|
||||||
|
|
||||||
|
def _load_ha_state_cache(reader: HaReader) -> dict[str, HaEntitySummary]:
|
||||||
|
return {entity.entity_id: entity for entity in reader.read_entities()}
|
||||||
|
|
||||||
|
|
||||||
|
def _update_ha_state_cache(
|
||||||
|
state_cache: dict[str, HaEntitySummary],
|
||||||
|
entity_id: str,
|
||||||
|
new_state: object,
|
||||||
|
) -> None:
|
||||||
|
if not isinstance(new_state, dict):
|
||||||
|
state_cache.pop(entity_id, None)
|
||||||
|
return
|
||||||
|
state_cache[entity_id] = _ha_entity_from_event(
|
||||||
|
entity_id,
|
||||||
|
new_state,
|
||||||
|
state_cache.get(entity_id),
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _is_relevant_state_change(store: ActuatorStore, entity_id: str) -> bool:
|
||||||
|
for record in store.list():
|
||||||
|
if record.actuator_entity_id == entity_id:
|
||||||
|
return True
|
||||||
|
if record.assignment.selected_numeric_entity_id == entity_id:
|
||||||
|
return True
|
||||||
|
if entity_id in record.assignment.selected_context_entity_ids:
|
||||||
|
return True
|
||||||
|
return False
|
||||||
|
|
||||||
|
|
||||||
|
def _ha_entity_from_event(
|
||||||
|
entity_id: str,
|
||||||
|
new_state: dict[str, object],
|
||||||
|
previous: HaEntitySummary | None,
|
||||||
|
) -> HaEntitySummary:
|
||||||
|
attributes = new_state.get("attributes")
|
||||||
|
attr = attributes if isinstance(attributes, dict) else {}
|
||||||
|
state_class = _optional_event_string(attr.get("state_class"))
|
||||||
|
device_class = _optional_event_string(attr.get("device_class"))
|
||||||
|
unit_of_measurement = _optional_event_string(attr.get("unit_of_measurement"))
|
||||||
|
friendly_name = _optional_event_string(attr.get("friendly_name"))
|
||||||
|
return HaEntitySummary(
|
||||||
|
entity_id=entity_id,
|
||||||
|
domain=entity_id.split(".", 1)[0],
|
||||||
|
state=_optional_event_string(new_state.get("state")),
|
||||||
|
last_changed=_event_datetime(new_state.get("last_changed"))
|
||||||
|
or _event_datetime(new_state.get("last_updated")),
|
||||||
|
state_class=state_class or (previous.state_class if previous else None),
|
||||||
|
device_class=device_class or (previous.device_class if previous else None),
|
||||||
|
unit_of_measurement=unit_of_measurement
|
||||||
|
or (previous.unit_of_measurement if previous else None),
|
||||||
|
friendly_name=friendly_name or (previous.friendly_name if previous else None),
|
||||||
|
area_id=previous.area_id if previous else None,
|
||||||
|
area_name=previous.area_name if previous else None,
|
||||||
|
device_id=previous.device_id if previous else None,
|
||||||
|
device_name=previous.device_name if previous else None,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _optional_event_string(value: object) -> str | None:
|
||||||
|
return value if isinstance(value, str) else None
|
||||||
|
|
||||||
|
|
||||||
|
def _event_datetime(value: object) -> datetime | None:
|
||||||
|
if not isinstance(value, str):
|
||||||
|
return None
|
||||||
|
try:
|
||||||
|
parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
|
||||||
|
except ValueError:
|
||||||
|
return None
|
||||||
|
if parsed.tzinfo is None:
|
||||||
|
return parsed.replace(tzinfo=timezone.utc)
|
||||||
|
return parsed
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
111
docs/V1_0_0_OPERATING_GUIDE.md
Normal file
111
docs/V1_0_0_OPERATING_GUIDE.md
Normal file
@@ -0,0 +1,111 @@
|
|||||||
|
# SillyHome Next 1.0.0 Operating Guide
|
||||||
|
|
||||||
|
Diese Version stabilisiert den produktiven Kern: schnelle Dashboard-Nutzung,
|
||||||
|
lokales Caching, klare Aktor-/Sensor-Kategorien und nachvollziehbare Freigabe
|
||||||
|
gelernter Aktionen.
|
||||||
|
|
||||||
|
Die detaillierte Abnahme steht in
|
||||||
|
[`V1_0_ACCEPTANCE.md`](V1_0_ACCEPTANCE.md). Dort sind erledigte, teilweise
|
||||||
|
erledigte und fuer v1.0.x offene Punkte getrennt dokumentiert.
|
||||||
|
|
||||||
|
## Grundprinzip
|
||||||
|
|
||||||
|
- Home Assistant bleibt die Quelle fuer aktuelle States und Services.
|
||||||
|
- SillyHome cached schwere Entity-/Discovery-Metadaten lokal als JSON.
|
||||||
|
- Die Startansicht liest nur lokale Store-/Cache-Daten.
|
||||||
|
- Vollstaendige Discovery, Vorschlaege und Detailanalysen laden blockweise nach.
|
||||||
|
- Es gibt keine externen Pings oder Cloud-Abfragen im Dashboard-Startpfad.
|
||||||
|
|
||||||
|
## Wichtige Endpunkte
|
||||||
|
|
||||||
|
- `GET /health`
|
||||||
|
Lokaler API-Status ohne externe Abfrage.
|
||||||
|
- `GET /health/websocket`
|
||||||
|
Status des Home-Assistant-WebSocket-Listeners.
|
||||||
|
- `GET /v1/actuators/dashboard`
|
||||||
|
Schnelle Dashboard-Startdaten aus Store und JSON-Cache.
|
||||||
|
- `GET /v1/actuators/summary`
|
||||||
|
Schlanke Liste beobachteter Aktoren ohne Lernmuster-Payload.
|
||||||
|
- `GET /v1/actuators/discovery`
|
||||||
|
Aktor-Auswahl aus gecachten oder frisch geladenen HA-Entities.
|
||||||
|
- `GET /v1/actuators/context-options?actuator_entity_id=...`
|
||||||
|
Sensor-/Kontextvorschlaege fuer einen konkreten Aktor.
|
||||||
|
- `POST /v1/actuators/{entity_id}/assignment`
|
||||||
|
Manuelle Sensor-/Kontextzuordnung speichern.
|
||||||
|
- `POST /v1/actuators/{entity_id}/activation`
|
||||||
|
Freigabe oder Stop des automatischen Schaltens.
|
||||||
|
|
||||||
|
## Cache
|
||||||
|
|
||||||
|
Der Entity-Cache liegt neben dem Aktor-Store als `ha_entity_cache.json`.
|
||||||
|
Er enthaelt HA-Entity-Metadaten wie Friendly Name, Bereich, Device und
|
||||||
|
Kategoriegrundlagen.
|
||||||
|
|
||||||
|
Der Cache wird geschrieben, wenn Discovery frische HA-Entities liest. Danach
|
||||||
|
koennen Dashboard und Summary ohne erneute HA-Vollabfrage Namen, Raeume und
|
||||||
|
Gruppen anzeigen.
|
||||||
|
|
||||||
|
## Dashboard-Nutzung
|
||||||
|
|
||||||
|
1. Startansicht oeffnen.
|
||||||
|
2. `System & Cache` zeigt API, WebSocket, Cache-Groesse und geladene
|
||||||
|
Discovery-Gruppen.
|
||||||
|
3. `Geraet zum Lernen auswaehlen` nutzt Suche, Typfilter und direkte
|
||||||
|
Entity-ID-Eingabe.
|
||||||
|
4. `Beobachtete Geraete` zeigt gelernte Aktoren nach Raum oder Typ gruppiert.
|
||||||
|
5. `Details` zeigt Lernfortschritt, Freigabe, Vorhersage, verwendete
|
||||||
|
Sensoren/Zustaende und Entscheidungsgruende.
|
||||||
|
|
||||||
|
## Kategorien
|
||||||
|
|
||||||
|
Aktoren:
|
||||||
|
|
||||||
|
- Licht, LED, Lampen
|
||||||
|
- Schalter, Steckdosen, Helper
|
||||||
|
- Lueftung, Ventilatoren, Befeuchter/Entfeuchter
|
||||||
|
- Heizungen/Klima
|
||||||
|
- Rolllaeden/Cover
|
||||||
|
- TV/Medien/Fernbedienungen
|
||||||
|
- Szenen, Buttons, Schloesser, Ventile
|
||||||
|
|
||||||
|
Sensoren und Kontext:
|
||||||
|
|
||||||
|
- Luftfeuchtigkeit und Feuchte
|
||||||
|
- Temperatur
|
||||||
|
- Wetter
|
||||||
|
- Helligkeit/Lux
|
||||||
|
- Bewegung, Praesenz, Anwesenheit
|
||||||
|
- Tuer/Fenster/Oeffnung
|
||||||
|
- Licht-/Schalter-/Steckdosenstatus
|
||||||
|
- Strom, Leistung, Energie, Einspeisung
|
||||||
|
- PV, Akku, Wechselrichter
|
||||||
|
- Helper und Szenen
|
||||||
|
|
||||||
|
## Qualitaetspruefung
|
||||||
|
|
||||||
|
Vor Release:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
.venv/bin/pytest -q
|
||||||
|
.venv/bin/ruff check .
|
||||||
|
.venv/bin/mypy app backend tests
|
||||||
|
git diff --check
|
||||||
|
```
|
||||||
|
|
||||||
|
Live nach Installation:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
wget -qO- http://58adbe1e-sillyhome-next:8000/health
|
||||||
|
wget -qO- http://58adbe1e-sillyhome-next:8000/health/websocket
|
||||||
|
wget -qO /tmp/summary.json http://58adbe1e-sillyhome-next:8000/v1/actuators/summary
|
||||||
|
wget -qO /tmp/dashboard.json http://58adbe1e-sillyhome-next:8000/v1/actuators/dashboard
|
||||||
|
```
|
||||||
|
|
||||||
|
## Rollback
|
||||||
|
|
||||||
|
Der stabile Vor-1.0-Stand ist `v0.7.21`. Vor dem 1.0.0-Umbau wurde ein
|
||||||
|
Git-Bundle-Backup erstellt:
|
||||||
|
|
||||||
|
`/root/.openclaw/workspace/backups/sillyhome-next/`
|
||||||
|
|
||||||
|
Bei Problemen kann auf `v0.7.21` zurueck installiert werden.
|
||||||
80
docs/V1_0_ACCEPTANCE.md
Normal file
80
docs/V1_0_ACCEPTANCE.md
Normal file
@@ -0,0 +1,80 @@
|
|||||||
|
# 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`
|
||||||
|
|
||||||
|
## 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
|
||||||
|
|
||||||
|
- Echte Dashboard-Performance-Budget-Tests, die Start-HTML und
|
||||||
|
`/v1/actuators/dashboard` gegen ein 5-Sekunden-Limit messen.
|
||||||
|
- 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.
|
||||||
|
- Dokumentierte HA-Installationspruefung mit Supervisor-/Ingress-Hinweisen,
|
||||||
|
weil direkte Container-HTTP-Pruefung ausserhalb HA nicht immer routbar ist.
|
||||||
|
|
||||||
|
## 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`.
|
||||||
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
|
|||||||
|
|
||||||
[project]
|
[project]
|
||||||
name = "sillyhome-next"
|
name = "sillyhome-next"
|
||||||
version = "0.7.8"
|
version = "1.0.4"
|
||||||
description = "Lokales Smart-Home-Intelligenzsystem für Home Assistant"
|
description = "Lokales Smart-Home-Intelligenzsystem für Home Assistant"
|
||||||
requires-python = ">=3.11"
|
requires-python = ">=3.11"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
|
|||||||
@@ -277,6 +277,81 @@ def test_reconciliation_ignores_generic_monitoring_area_for_automatic_context(
|
|||||||
assert record.lifecycle.status is LifecycleStatus.ARCHIVED
|
assert record.lifecycle.status is LifecycleStatus.ARCHIVED
|
||||||
|
|
||||||
|
|
||||||
|
def test_reconciliation_does_not_auto_select_overload_sensors_by_power_area(
|
||||||
|
tmp_path: Path,
|
||||||
|
) -> None:
|
||||||
|
entities = [
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="light.treppe_unten",
|
||||||
|
domain="light",
|
||||||
|
friendly_name="Licht Treppe Unten",
|
||||||
|
area_name="Strom",
|
||||||
|
),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.shelly_schrank_channel_1_overload",
|
||||||
|
domain="binary_sensor",
|
||||||
|
device_class="problem",
|
||||||
|
friendly_name="Shelly Schrank Channel 1 Überlast",
|
||||||
|
area_name="Strom",
|
||||||
|
),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.terrasse_terasse_overheating",
|
||||||
|
domain="binary_sensor",
|
||||||
|
device_class="problem",
|
||||||
|
friendly_name="Terrasse Terasse Überhitzung",
|
||||||
|
area_name="Strom",
|
||||||
|
),
|
||||||
|
]
|
||||||
|
service = _service(tmp_path, entities, {})
|
||||||
|
|
||||||
|
record = service.configure_actuator("light.treppe_unten")
|
||||||
|
|
||||||
|
assert record.assignment.selected_context_entity_ids == []
|
||||||
|
assert all(candidate.auto_accepted is False for candidate in record.context_candidates)
|
||||||
|
|
||||||
|
|
||||||
|
def test_fan_prefers_humidity_over_power_sensor(tmp_path: Path) -> None:
|
||||||
|
start = datetime(2026, 6, 1, tzinfo=timezone.utc)
|
||||||
|
entities = [
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="fan.bad_lueftung",
|
||||||
|
domain="fan",
|
||||||
|
friendly_name="Bad Lüftung",
|
||||||
|
area_name="Bad",
|
||||||
|
),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="sensor.bad_luftfeuchtigkeit",
|
||||||
|
domain="sensor",
|
||||||
|
device_class="humidity",
|
||||||
|
state_class="measurement",
|
||||||
|
unit_of_measurement="%",
|
||||||
|
friendly_name="Bad Luftfeuchtigkeit",
|
||||||
|
area_name="Bad",
|
||||||
|
),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="sensor.bad_power",
|
||||||
|
domain="sensor",
|
||||||
|
device_class="power",
|
||||||
|
state_class="measurement",
|
||||||
|
unit_of_measurement="W",
|
||||||
|
friendly_name="Bad Leistung",
|
||||||
|
area_name="Bad",
|
||||||
|
),
|
||||||
|
]
|
||||||
|
service = _service(
|
||||||
|
tmp_path,
|
||||||
|
entities,
|
||||||
|
{
|
||||||
|
"sensor.bad_luftfeuchtigkeit": _points(8, start, 55.0),
|
||||||
|
"sensor.bad_power": _points(8, start, 5.0),
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
record = service.configure_actuator("fan.bad_lueftung")
|
||||||
|
|
||||||
|
assert record.assignment.selected_numeric_entity_id == "sensor.bad_luftfeuchtigkeit"
|
||||||
|
|
||||||
|
|
||||||
def test_manual_assignment_persists_and_wins_over_automatic_mapping(tmp_path: Path) -> None:
|
def test_manual_assignment_persists_and_wins_over_automatic_mapping(tmp_path: Path) -> None:
|
||||||
start = datetime(2026, 6, 1, tzinfo=timezone.utc)
|
start = datetime(2026, 6, 1, tzinfo=timezone.utc)
|
||||||
entities = [
|
entities = [
|
||||||
@@ -325,3 +400,39 @@ def test_manual_assignment_persists_and_wins_over_automatic_mapping(tmp_path: Pa
|
|||||||
assert record.assignment.selected_context_entity_ids == ["sensor.abstellkammer_illuminance"]
|
assert record.assignment.selected_context_entity_ids == ["sensor.abstellkammer_illuminance"]
|
||||||
assert record.assignment.source is AssignmentSource.MANUAL
|
assert record.assignment.source is AssignmentSource.MANUAL
|
||||||
assert record.manual_override is not None
|
assert record.manual_override is not None
|
||||||
|
|
||||||
|
|
||||||
|
def test_manual_assignment_evidence_is_not_duplicated(tmp_path: Path) -> None:
|
||||||
|
entities = [
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="light.abstellkammer",
|
||||||
|
domain="light",
|
||||||
|
friendly_name="Abstellkammer Licht",
|
||||||
|
area_name="Abstellkammer",
|
||||||
|
),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.abstellkammer_motion",
|
||||||
|
domain="binary_sensor",
|
||||||
|
device_class="motion",
|
||||||
|
friendly_name="Abstellkammer Bewegung",
|
||||||
|
area_name="Abstellkammer",
|
||||||
|
),
|
||||||
|
]
|
||||||
|
service = _service(tmp_path, entities, {})
|
||||||
|
service.configure_actuator("light.abstellkammer")
|
||||||
|
for _ in range(3):
|
||||||
|
service.set_manual_assignment(
|
||||||
|
"light.abstellkammer",
|
||||||
|
numeric_entity_id=None,
|
||||||
|
context_entity_ids=["binary_sensor.abstellkammer_motion"],
|
||||||
|
note="Manuell gesetzt",
|
||||||
|
)
|
||||||
|
|
||||||
|
record = service.get_actuator("light.abstellkammer")
|
||||||
|
candidate = next(
|
||||||
|
item
|
||||||
|
for item in record.context_candidates
|
||||||
|
if item.entity_id == "binary_sensor.abstellkammer_motion"
|
||||||
|
)
|
||||||
|
|
||||||
|
assert candidate.evidence.count("Manuell vom Nutzer als relevant festgelegt.") == 1
|
||||||
|
|||||||
@@ -9,6 +9,7 @@ from app.actuators.lifecycle import ActuatorReconciliationService
|
|||||||
from app.actuators.store import ActuatorStore
|
from app.actuators.store import ActuatorStore
|
||||||
from app.behavior.engine import BehaviorEngine
|
from app.behavior.engine import BehaviorEngine
|
||||||
from app.config import Settings
|
from app.config import Settings
|
||||||
|
from app.api.v1.actuators import _deduplicate_actuator_ids
|
||||||
from app.ha.discovery import DiscoveredEntity
|
from app.ha.discovery import DiscoveredEntity
|
||||||
from app.ha.discovery import discover_entities
|
from app.ha.discovery import discover_entities
|
||||||
from app.ha.history import (
|
from app.ha.history import (
|
||||||
@@ -27,8 +28,10 @@ class FakeHaReader(HaReader):
|
|||||||
def __init__(self, entities: list[HaEntitySummary], history: dict[str, list[float]]) -> None:
|
def __init__(self, entities: list[HaEntitySummary], history: dict[str, list[float]]) -> None:
|
||||||
self._entities = entities
|
self._entities = entities
|
||||||
self._history = history
|
self._history = history
|
||||||
|
self.read_entities_calls = 0
|
||||||
|
|
||||||
def read_entities(self) -> list[HaEntitySummary]:
|
def read_entities(self) -> list[HaEntitySummary]:
|
||||||
|
self.read_entities_calls += 1
|
||||||
return list(self._entities)
|
return list(self._entities)
|
||||||
|
|
||||||
def discover(
|
def discover(
|
||||||
@@ -212,6 +215,101 @@ def test_manual_assignment_endpoint_updates_context(tmp_path: Path) -> None:
|
|||||||
]
|
]
|
||||||
|
|
||||||
|
|
||||||
|
def test_weight_override_endpoint_updates_sensor_relevance(tmp_path: Path) -> None:
|
||||||
|
with TestClient(app) as client:
|
||||||
|
_install_service(tmp_path)
|
||||||
|
client.post("/v1/actuators", json={"actuator_entity_id": "light.abstellkammer"})
|
||||||
|
client.post(
|
||||||
|
"/v1/actuators/light.abstellkammer/assignment",
|
||||||
|
json={
|
||||||
|
"numeric_entity_id": "sensor.abstellkammer_illuminance",
|
||||||
|
"context_entity_ids": ["binary_sensor.abstellkammer_motion"],
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
response = client.post(
|
||||||
|
"/v1/actuators/light.abstellkammer/weights",
|
||||||
|
json={
|
||||||
|
"sensor_weights": {
|
||||||
|
"sensor.abstellkammer_illuminance": 0.75,
|
||||||
|
"binary_sensor.abstellkammer_motion": 0.5,
|
||||||
|
},
|
||||||
|
"sensor_weight_groups": [
|
||||||
|
{
|
||||||
|
"group_id": "abstellkammer_context",
|
||||||
|
"name": "Abstellkammer Kontext",
|
||||||
|
"entity_ids": [
|
||||||
|
"sensor.abstellkammer_illuminance",
|
||||||
|
"binary_sensor.abstellkammer_motion",
|
||||||
|
],
|
||||||
|
"weight": 0.8,
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"note": "Gewichtung korrigiert",
|
||||||
|
},
|
||||||
|
)
|
||||||
|
|
||||||
|
assert response.status_code == 200
|
||||||
|
payload = response.json()
|
||||||
|
assert payload["manual_override"]["sensor_weights"]["sensor.abstellkammer_illuminance"] == 0.75
|
||||||
|
assert payload["manual_override"]["sensor_weight_groups"][0]["group_id"] == (
|
||||||
|
"abstellkammer_context"
|
||||||
|
)
|
||||||
|
numeric = {
|
||||||
|
candidate["entity_id"]: candidate
|
||||||
|
for candidate in payload["numeric_candidates"]
|
||||||
|
}
|
||||||
|
assert numeric["sensor.abstellkammer_illuminance"]["manual_weight"] == 0.75
|
||||||
|
assert numeric["sensor.abstellkammer_illuminance"]["effective_weight"] == 0.75
|
||||||
|
|
||||||
|
|
||||||
|
def test_summary_is_lightweight_and_uses_cached_entity_metadata(tmp_path: Path) -> None:
|
||||||
|
with TestClient(app) as client:
|
||||||
|
_install_service(tmp_path)
|
||||||
|
client.get("/v1/actuators/discovery")
|
||||||
|
client.post("/v1/actuators", json={"actuator_entity_id": "light.abstellkammer"})
|
||||||
|
|
||||||
|
response = client.get("/v1/actuators/summary")
|
||||||
|
|
||||||
|
assert response.status_code == 200
|
||||||
|
payload = response.json()
|
||||||
|
assert payload[0]["actuator_entity_id"] == "light.abstellkammer"
|
||||||
|
assert payload[0]["friendly_name"] == "Abstellkammer Licht"
|
||||||
|
assert payload[0]["area_name"] == "Abstellkammer"
|
||||||
|
assert "behavior" not in payload[0]
|
||||||
|
assert "numeric_candidates" not in payload[0]
|
||||||
|
|
||||||
|
|
||||||
|
def test_dashboard_overview_uses_cache_without_ha_roundtrip(tmp_path: Path) -> None:
|
||||||
|
with TestClient(app) as client:
|
||||||
|
_install_service(tmp_path)
|
||||||
|
reader = app.state.ha_reader
|
||||||
|
client.get("/v1/actuators/discovery")
|
||||||
|
client.post("/v1/actuators", json={"actuator_entity_id": "light.abstellkammer"})
|
||||||
|
calls_before = reader.read_entities_calls
|
||||||
|
|
||||||
|
response = client.get("/v1/actuators/dashboard")
|
||||||
|
|
||||||
|
assert response.status_code == 200
|
||||||
|
assert reader.read_entities_calls == calls_before
|
||||||
|
payload = response.json()
|
||||||
|
assert payload["cache"]["available"] is True
|
||||||
|
assert payload["cache"]["entity_count"] == 4
|
||||||
|
assert payload["actuators"][0]["friendly_name"] == "Abstellkammer Licht"
|
||||||
|
assert payload["discovery_groups"]
|
||||||
|
|
||||||
|
|
||||||
|
def test_discovery_reads_entities_once_and_reuses_them(tmp_path: Path) -> None:
|
||||||
|
with TestClient(app) as client:
|
||||||
|
_install_service(tmp_path)
|
||||||
|
reader = app.state.ha_reader
|
||||||
|
|
||||||
|
response = client.get("/v1/actuators/discovery", params={"refresh": True})
|
||||||
|
|
||||||
|
assert response.status_code == 200
|
||||||
|
assert reader.read_entities_calls == 1
|
||||||
|
|
||||||
|
|
||||||
def test_context_options_returns_learnable_entities(tmp_path: Path) -> None:
|
def test_context_options_returns_learnable_entities(tmp_path: Path) -> None:
|
||||||
with TestClient(app) as client:
|
with TestClient(app) as client:
|
||||||
_install_service(tmp_path)
|
_install_service(tmp_path)
|
||||||
@@ -227,3 +325,37 @@ def test_context_options_returns_learnable_entities(tmp_path: Path) -> None:
|
|||||||
assert "sensor.abstellkammer_illuminance" in entity_ids
|
assert "sensor.abstellkammer_illuminance" in entity_ids
|
||||||
assert "binary_sensor.abstellkammer_motion" in entity_ids
|
assert "binary_sensor.abstellkammer_motion" in entity_ids
|
||||||
assert "sensor.pfsense_interface_vpn_inbytes" not in entity_ids
|
assert "sensor.pfsense_interface_vpn_inbytes" not in entity_ids
|
||||||
|
|
||||||
|
|
||||||
|
def test_actuator_discovery_prefers_light_over_duplicate_switch() -> None:
|
||||||
|
entities = {
|
||||||
|
"light.schreibtisch": HaEntitySummary(
|
||||||
|
entity_id="light.schreibtisch",
|
||||||
|
domain="light",
|
||||||
|
friendly_name="Schreibtisch Licht",
|
||||||
|
device_id="device-1",
|
||||||
|
),
|
||||||
|
"switch.schreibtisch": HaEntitySummary(
|
||||||
|
entity_id="switch.schreibtisch",
|
||||||
|
domain="switch",
|
||||||
|
friendly_name="Schreibtisch Schalter",
|
||||||
|
device_id="device-1",
|
||||||
|
),
|
||||||
|
"cover.rollladen": HaEntitySummary(
|
||||||
|
entity_id="cover.rollladen",
|
||||||
|
domain="cover",
|
||||||
|
friendly_name="Rollladen",
|
||||||
|
device_id="device-2",
|
||||||
|
),
|
||||||
|
}
|
||||||
|
|
||||||
|
result = _deduplicate_actuator_ids(
|
||||||
|
[
|
||||||
|
("switch.schreibtisch", "switch_socket"),
|
||||||
|
("light.schreibtisch", "light"),
|
||||||
|
("cover.rollladen", "cover_shutter"),
|
||||||
|
],
|
||||||
|
entities,
|
||||||
|
)
|
||||||
|
|
||||||
|
assert result == ["cover.rollladen", "light.schreibtisch"]
|
||||||
|
|||||||
@@ -27,6 +27,7 @@ class FakeHaReader(HaReader):
|
|||||||
entity_id="sensor.temperature",
|
entity_id="sensor.temperature",
|
||||||
domain="sensor",
|
domain="sensor",
|
||||||
device_class="temperature",
|
device_class="temperature",
|
||||||
|
category="temperature",
|
||||||
role=EntityRole.MEASUREMENT,
|
role=EntityRole.MEASUREMENT,
|
||||||
learnable=True,
|
learnable=True,
|
||||||
reason="Numerischer Messsensor für Zeitreihen und Training.",
|
reason="Numerischer Messsensor für Zeitreihen und Training.",
|
||||||
@@ -116,6 +117,7 @@ def test_discovery_filters_entities() -> None:
|
|||||||
"device_class": "temperature",
|
"device_class": "temperature",
|
||||||
"state_class": None,
|
"state_class": None,
|
||||||
"unit_of_measurement": None,
|
"unit_of_measurement": None,
|
||||||
|
"category": "temperature",
|
||||||
"role": "measurement",
|
"role": "measurement",
|
||||||
"learnable": True,
|
"learnable": True,
|
||||||
"reason": "Numerischer Messsensor für Zeitreihen und Training.",
|
"reason": "Numerischer Messsensor für Zeitreihen und Training.",
|
||||||
|
|||||||
@@ -8,6 +8,7 @@ import pytest
|
|||||||
from app.actuators.models import (
|
from app.actuators.models import (
|
||||||
BehaviorMode,
|
BehaviorMode,
|
||||||
BehaviorPattern,
|
BehaviorPattern,
|
||||||
|
BehaviorPrediction,
|
||||||
BehaviorState,
|
BehaviorState,
|
||||||
BehaviorStatus,
|
BehaviorStatus,
|
||||||
ExecutionEvent,
|
ExecutionEvent,
|
||||||
@@ -212,6 +213,125 @@ def test_engine_counts_known_automation_actions_like_manual_actions(
|
|||||||
assert {pattern.weight for pattern in trained.behavior.patterns} == {1.0}
|
assert {pattern.weight for pattern in trained.behavior.patterns} == {1.0}
|
||||||
|
|
||||||
|
|
||||||
|
def test_feedback_marks_prediction_correct_as_learning_pattern(
|
||||||
|
tmp_path: Path,
|
||||||
|
) -> None:
|
||||||
|
now = datetime.now(timezone.utc).replace(second=0, microsecond=0)
|
||||||
|
settings = _settings(tmp_path)
|
||||||
|
store = ActuatorStore(settings.actuator_store)
|
||||||
|
record = store.configure("light.office")
|
||||||
|
record = record.model_copy(
|
||||||
|
update={
|
||||||
|
"assignment": record.assignment.model_copy(
|
||||||
|
update={
|
||||||
|
"selected_context_entity_ids": [
|
||||||
|
"binary_sensor.office_presence"
|
||||||
|
],
|
||||||
|
}
|
||||||
|
),
|
||||||
|
"behavior": record.behavior.model_copy(
|
||||||
|
update={
|
||||||
|
"prediction": BehaviorPrediction(
|
||||||
|
target_state="on",
|
||||||
|
confidence=0.9,
|
||||||
|
generated_at=now,
|
||||||
|
reason="test",
|
||||||
|
)
|
||||||
|
}
|
||||||
|
),
|
||||||
|
}
|
||||||
|
)
|
||||||
|
store.upsert(record)
|
||||||
|
reader = FakeBehaviorReader(
|
||||||
|
entities=[
|
||||||
|
HaEntitySummary(entity_id="light.office", domain="light", state="off"),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.office_presence",
|
||||||
|
domain="binary_sensor",
|
||||||
|
state="on",
|
||||||
|
),
|
||||||
|
],
|
||||||
|
history=[],
|
||||||
|
logbook=[],
|
||||||
|
)
|
||||||
|
engine = BehaviorEngine(ha_reader=reader, store=store, settings=settings)
|
||||||
|
|
||||||
|
result = engine.record_feedback("light.office", correct=True)
|
||||||
|
|
||||||
|
assert result.behavior.patterns[-1].target_state == "on"
|
||||||
|
assert result.behavior.patterns[-1].context_states == {
|
||||||
|
"binary_sensor.office_presence": "on"
|
||||||
|
}
|
||||||
|
assert result.behavior.patterns[-1].source == "user_feedback"
|
||||||
|
assert result.behavior.reason == "Vorhersage wurde vom Nutzer als korrekt bestätigt."
|
||||||
|
|
||||||
|
|
||||||
|
def test_feedback_marks_prediction_wrong_and_adds_correction(
|
||||||
|
tmp_path: Path,
|
||||||
|
) -> None:
|
||||||
|
now = datetime.now(timezone.utc).replace(second=0, microsecond=0)
|
||||||
|
settings = _settings(tmp_path)
|
||||||
|
store = ActuatorStore(settings.actuator_store)
|
||||||
|
record = store.configure("light.office")
|
||||||
|
record = record.model_copy(
|
||||||
|
update={
|
||||||
|
"assignment": record.assignment.model_copy(
|
||||||
|
update={
|
||||||
|
"selected_context_entity_ids": [
|
||||||
|
"binary_sensor.office_presence"
|
||||||
|
],
|
||||||
|
}
|
||||||
|
),
|
||||||
|
"behavior": record.behavior.model_copy(
|
||||||
|
update={
|
||||||
|
"patterns": [
|
||||||
|
BehaviorPattern(
|
||||||
|
target_state="on",
|
||||||
|
minute_of_day=60,
|
||||||
|
weekday=0,
|
||||||
|
context_states={"binary_sensor.office_presence": "on"},
|
||||||
|
source="automation",
|
||||||
|
weight=1.0,
|
||||||
|
observed_at=now - timedelta(days=1),
|
||||||
|
)
|
||||||
|
],
|
||||||
|
"prediction": BehaviorPrediction(
|
||||||
|
target_state="on",
|
||||||
|
confidence=0.9,
|
||||||
|
generated_at=now,
|
||||||
|
reason="test",
|
||||||
|
),
|
||||||
|
}
|
||||||
|
),
|
||||||
|
}
|
||||||
|
)
|
||||||
|
store.upsert(record)
|
||||||
|
reader = FakeBehaviorReader(
|
||||||
|
entities=[
|
||||||
|
HaEntitySummary(entity_id="light.office", domain="light", state="off"),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.office_presence",
|
||||||
|
domain="binary_sensor",
|
||||||
|
state="on",
|
||||||
|
),
|
||||||
|
],
|
||||||
|
history=[],
|
||||||
|
logbook=[],
|
||||||
|
)
|
||||||
|
engine = BehaviorEngine(ha_reader=reader, store=store, settings=settings)
|
||||||
|
|
||||||
|
result = engine.record_feedback(
|
||||||
|
"light.office",
|
||||||
|
correct=False,
|
||||||
|
expected_state="off",
|
||||||
|
)
|
||||||
|
|
||||||
|
assert result.behavior.patterns[0].weight == 0.1
|
||||||
|
assert result.behavior.patterns[-1].target_state == "off"
|
||||||
|
assert result.behavior.patterns[-1].source == "user_correction"
|
||||||
|
assert result.behavior.reason == "Vorhersage wurde vom Nutzer als falsch markiert."
|
||||||
|
|
||||||
|
|
||||||
def test_engine_learns_causal_automation_with_activation_credit(
|
def test_engine_learns_causal_automation_with_activation_credit(
|
||||||
tmp_path: Path,
|
tmp_path: Path,
|
||||||
) -> None:
|
) -> None:
|
||||||
@@ -438,6 +558,7 @@ def test_cooldown_allows_opposite_follow_up_action(tmp_path: Path) -> None:
|
|||||||
("domain", "state", "service"),
|
("domain", "state", "service"),
|
||||||
[
|
[
|
||||||
("light", "on", "turn_on"),
|
("light", "on", "turn_on"),
|
||||||
|
("media_player", "off", "turn_off"),
|
||||||
("switch", "off", "turn_off"),
|
("switch", "off", "turn_off"),
|
||||||
("cover", "open", "open_cover"),
|
("cover", "open", "open_cover"),
|
||||||
("cover", "closed", "close_cover"),
|
("cover", "closed", "close_cover"),
|
||||||
@@ -523,3 +644,137 @@ def test_prediction_ignores_stale_causal_context_state() -> None:
|
|||||||
min_support=1,
|
min_support=1,
|
||||||
window_minutes=30,
|
window_minutes=30,
|
||||||
) is None
|
) is None
|
||||||
|
|
||||||
|
|
||||||
|
def test_state_change_uses_websocket_context_state_for_immediate_action(
|
||||||
|
tmp_path: Path,
|
||||||
|
) -> None:
|
||||||
|
now = datetime.now(timezone.utc).replace(microsecond=0)
|
||||||
|
settings = _settings(tmp_path)
|
||||||
|
store = ActuatorStore(settings.actuator_store)
|
||||||
|
record = store.configure("light.storage")
|
||||||
|
record = record.model_copy(
|
||||||
|
update={
|
||||||
|
"assignment": record.assignment.model_copy(
|
||||||
|
update={
|
||||||
|
"selected_context_entity_ids": ["binary_sensor.storage_door"],
|
||||||
|
}
|
||||||
|
),
|
||||||
|
"behavior": record.behavior.model_copy(
|
||||||
|
update={
|
||||||
|
"mode": BehaviorMode.ACTIVE,
|
||||||
|
"status": BehaviorStatus.TRAINED,
|
||||||
|
"activation_ready": True,
|
||||||
|
"patterns": [
|
||||||
|
BehaviorPattern(
|
||||||
|
target_state="on",
|
||||||
|
minute_of_day=60,
|
||||||
|
weekday=0,
|
||||||
|
context_states={"binary_sensor.storage_door": "on"},
|
||||||
|
trigger_entity_id="binary_sensor.storage_door",
|
||||||
|
trigger_from_state="off",
|
||||||
|
trigger_to_state="on",
|
||||||
|
source="automation",
|
||||||
|
weight=1.0,
|
||||||
|
observed_at=now - timedelta(days=days_ago),
|
||||||
|
)
|
||||||
|
for days_ago in (3, 2, 1)
|
||||||
|
],
|
||||||
|
}
|
||||||
|
),
|
||||||
|
}
|
||||||
|
)
|
||||||
|
store.upsert(record)
|
||||||
|
reader = FakeBehaviorReader(
|
||||||
|
entities=[
|
||||||
|
HaEntitySummary(entity_id="light.storage", domain="light", state="off"),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.storage_door",
|
||||||
|
domain="binary_sensor",
|
||||||
|
state="off",
|
||||||
|
last_changed=now - timedelta(minutes=5),
|
||||||
|
),
|
||||||
|
],
|
||||||
|
history=[],
|
||||||
|
logbook=[],
|
||||||
|
)
|
||||||
|
engine = BehaviorEngine(ha_reader=reader, store=store, settings=settings)
|
||||||
|
|
||||||
|
engine.handle_state_change(
|
||||||
|
"binary_sensor.storage_door",
|
||||||
|
{"state": "on", "last_changed": now.isoformat()},
|
||||||
|
)
|
||||||
|
|
||||||
|
assert reader.service_calls == [
|
||||||
|
("light", "turn_on", {"entity_id": "light.storage"})
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
def test_state_change_uses_event_cache_without_rest_state_query(
|
||||||
|
tmp_path: Path,
|
||||||
|
) -> None:
|
||||||
|
now = datetime.now(timezone.utc).replace(microsecond=0)
|
||||||
|
settings = _settings(tmp_path)
|
||||||
|
store = ActuatorStore(settings.actuator_store)
|
||||||
|
record = store.configure("light.storage")
|
||||||
|
record = record.model_copy(
|
||||||
|
update={
|
||||||
|
"assignment": record.assignment.model_copy(
|
||||||
|
update={
|
||||||
|
"selected_context_entity_ids": ["binary_sensor.storage_door"],
|
||||||
|
}
|
||||||
|
),
|
||||||
|
"behavior": record.behavior.model_copy(
|
||||||
|
update={
|
||||||
|
"mode": BehaviorMode.ACTIVE,
|
||||||
|
"status": BehaviorStatus.TRAINED,
|
||||||
|
"activation_ready": True,
|
||||||
|
"patterns": [
|
||||||
|
BehaviorPattern(
|
||||||
|
target_state="on",
|
||||||
|
minute_of_day=60,
|
||||||
|
weekday=0,
|
||||||
|
context_states={"binary_sensor.storage_door": "on"},
|
||||||
|
trigger_entity_id="binary_sensor.storage_door",
|
||||||
|
trigger_from_state="off",
|
||||||
|
trigger_to_state="on",
|
||||||
|
source="automation",
|
||||||
|
weight=1.0,
|
||||||
|
observed_at=now - timedelta(days=days_ago),
|
||||||
|
)
|
||||||
|
for days_ago in (3, 2, 1)
|
||||||
|
],
|
||||||
|
}
|
||||||
|
),
|
||||||
|
}
|
||||||
|
)
|
||||||
|
store.upsert(record)
|
||||||
|
reader = FakeBehaviorReader(
|
||||||
|
entities=[],
|
||||||
|
history=[],
|
||||||
|
logbook=[],
|
||||||
|
)
|
||||||
|
|
||||||
|
def fail_read_entities() -> list[HaEntitySummary]:
|
||||||
|
raise AssertionError("Event-Auswertung darf keinen REST-State lesen.")
|
||||||
|
|
||||||
|
reader.read_entities = fail_read_entities # type: ignore[method-assign]
|
||||||
|
engine = BehaviorEngine(ha_reader=reader, store=store, settings=settings)
|
||||||
|
|
||||||
|
engine.handle_state_change(
|
||||||
|
"binary_sensor.storage_door",
|
||||||
|
{"state": "on", "last_changed": now.isoformat()},
|
||||||
|
current_entities=[
|
||||||
|
HaEntitySummary(entity_id="light.storage", domain="light", state="off"),
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.storage_door",
|
||||||
|
domain="binary_sensor",
|
||||||
|
state="on",
|
||||||
|
last_changed=now,
|
||||||
|
),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
|
||||||
|
assert reader.service_calls == [
|
||||||
|
("light", "turn_on", {"entity_id": "light.storage"})
|
||||||
|
]
|
||||||
|
|||||||
@@ -74,3 +74,60 @@ def test_discovery_filters_domain_and_learnable() -> None:
|
|||||||
result = discover_entities(entities, domains={" SENSOR "}, learnable=True)
|
result = discover_entities(entities, domains={" SENSOR "}, learnable=True)
|
||||||
|
|
||||||
assert [item.entity_id for item in result] == ["sensor.temperature"]
|
assert [item.entity_id for item in result] == ["sensor.temperature"]
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize(
|
||||||
|
("entity", "category"),
|
||||||
|
[
|
||||||
|
(
|
||||||
|
HaEntitySummary(entity_id="climate.bad", domain="climate"),
|
||||||
|
"heating",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
HaEntitySummary(entity_id="lock.front_door", domain="lock"),
|
||||||
|
"lock",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
HaEntitySummary(entity_id="input_boolean.sleep_mode", domain="input_boolean"),
|
||||||
|
"helper",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
HaEntitySummary(entity_id="media_player.tv", domain="media_player"),
|
||||||
|
"media_tv",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="sensor.brightness",
|
||||||
|
domain="sensor",
|
||||||
|
device_class="illuminance",
|
||||||
|
),
|
||||||
|
"brightness",
|
||||||
|
),
|
||||||
|
(
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="binary_sensor.motion",
|
||||||
|
domain="binary_sensor",
|
||||||
|
device_class="motion",
|
||||||
|
),
|
||||||
|
"presence_motion",
|
||||||
|
),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
def test_classify_entity_categories(entity: HaEntitySummary, category: str) -> None:
|
||||||
|
assert classify_entity(entity).category == category
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize(
|
||||||
|
"entity",
|
||||||
|
[
|
||||||
|
HaEntitySummary(entity_id="automation.lights", domain="automation"),
|
||||||
|
HaEntitySummary(entity_id="update.core", domain="update"),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
def test_classify_excludes_non_actuator_management_entities(
|
||||||
|
entity: HaEntitySummary,
|
||||||
|
) -> None:
|
||||||
|
result = classify_entity(entity)
|
||||||
|
|
||||||
|
assert result.role is EntityRole.UNSUPPORTED
|
||||||
|
assert result.learnable is False
|
||||||
|
|||||||
@@ -9,11 +9,14 @@ def test_dashboard_is_served_at_root() -> None:
|
|||||||
|
|
||||||
assert response.status_code == 200
|
assert response.status_code == 200
|
||||||
assert "SillyHome Next" in response.text
|
assert "SillyHome Next" in response.text
|
||||||
|
assert "Arbeitsdashboard für gelernte Home-Assistant-Bedienung" in response.text
|
||||||
assert "So gehst du vor" in response.text
|
assert "So gehst du vor" in response.text
|
||||||
assert "Gerät zum Lernen auswählen" in response.text
|
assert "Steuerung" in response.text
|
||||||
assert "Entitätsname oder Gerät aus Home Assistant" in response.text
|
assert "Entitätsname oder Gerät aus Home Assistant" in response.text
|
||||||
assert "Oder aus Liste wählen" in response.text
|
assert "Oder aus Liste wählen" in response.text
|
||||||
assert "Liste durchsuchen" in response.text
|
assert "Liste durchsuchen" in response.text
|
||||||
|
assert "Geräteliste bei Bedarf laden" in response.text
|
||||||
|
assert "Vorschläge können Home Assistant stark abfragen" in response.text
|
||||||
assert "Wie gewohnt bedienen" in response.text
|
assert "Wie gewohnt bedienen" in response.text
|
||||||
assert "Ohne deine spätere Freigabe wird nichts geschaltet" in response.text
|
assert "Ohne deine spätere Freigabe wird nichts geschaltet" in response.text
|
||||||
assert "Du wählst keine Sensoren und erstellst keine Regeln" in response.text
|
assert "Du wählst keine Sensoren und erstellst keine Regeln" in response.text
|
||||||
@@ -32,5 +35,12 @@ def test_dashboard_is_served_at_root() -> None:
|
|||||||
assert "Kein frischer passender Sensorwechsel erkannt" in response.text
|
assert "Kein frischer passender Sensorwechsel erkannt" in response.text
|
||||||
assert "Vorhersage jetzt prüfen" not in response.text
|
assert "Vorhersage jetzt prüfen" not in response.text
|
||||||
assert "record.behavior.activation_ready" in response.text
|
assert "record.behavior.activation_ready" in response.text
|
||||||
|
assert "record.behavior.status ===" not in response.text
|
||||||
|
assert "record.behavior_status || record.behavior?.status" in response.text
|
||||||
|
assert 'api("v1/actuators")' not in response.text
|
||||||
|
assert 'api("v1/actuators/summary")' in response.text
|
||||||
|
assert 'api("v1/entities")' not in response.text
|
||||||
|
assert 'details class="collapsible"' in response.text
|
||||||
|
assert 'class="group-panel"' in response.text
|
||||||
assert "Automation-Entwurf" not in response.text
|
assert "Automation-Entwurf" not in response.text
|
||||||
assert "Manuelle Overrides" not in response.text
|
assert "Manuelle Overrides" not in response.text
|
||||||
|
|||||||
@@ -1,4 +1,5 @@
|
|||||||
import asyncio
|
import asyncio
|
||||||
|
from collections.abc import Sequence
|
||||||
from pathlib import Path
|
from pathlib import Path
|
||||||
from unittest.mock import MagicMock, patch
|
from unittest.mock import MagicMock, patch
|
||||||
|
|
||||||
@@ -8,6 +9,8 @@ from fastapi.testclient import TestClient
|
|||||||
|
|
||||||
from app.actuators.store import ActuatorStore
|
from app.actuators.store import ActuatorStore
|
||||||
from app.behavior.engine import BehaviorEngine
|
from app.behavior.engine import BehaviorEngine
|
||||||
|
from app.ha.models import HaEntitySummary
|
||||||
|
from app.ha.reader import HaReader
|
||||||
from app.main import _ha_event_listener, app as fastapi_app, lifespan
|
from app.main import _ha_event_listener, app as fastapi_app, lifespan
|
||||||
|
|
||||||
|
|
||||||
@@ -41,10 +44,32 @@ class _RecordingBehaviorEngine(BehaviorEngine):
|
|||||||
store=ActuatorStore(tmp_path / "actuators"),
|
store=ActuatorStore(tmp_path / "actuators"),
|
||||||
settings=MagicMock(),
|
settings=MagicMock(),
|
||||||
)
|
)
|
||||||
self.state_changes: list[tuple[str, dict[str, object] | None]] = []
|
self.state_changes: list[
|
||||||
|
tuple[str, dict[str, object] | None, Sequence[HaEntitySummary] | None]
|
||||||
|
] = []
|
||||||
|
|
||||||
def handle_state_change(self, entity_id: str, new_state: dict[str, object] | None) -> None:
|
def handle_state_change(
|
||||||
self.state_changes.append((entity_id, new_state))
|
self,
|
||||||
|
entity_id: str,
|
||||||
|
new_state: dict[str, object] | None,
|
||||||
|
*,
|
||||||
|
current_entities: Sequence[HaEntitySummary] | None = None,
|
||||||
|
) -> None:
|
||||||
|
self.state_changes.append((entity_id, new_state, current_entities))
|
||||||
|
|
||||||
|
|
||||||
|
class _FakeHaReader(HaReader):
|
||||||
|
def __init__(self) -> None:
|
||||||
|
pass
|
||||||
|
|
||||||
|
def read_entities(self) -> list[HaEntitySummary]:
|
||||||
|
return [
|
||||||
|
HaEntitySummary(
|
||||||
|
entity_id="light.test",
|
||||||
|
domain="light",
|
||||||
|
state="off",
|
||||||
|
)
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
def test_ha_event_listener_processes_state_change(tmp_path: Path) -> None:
|
def test_ha_event_listener_processes_state_change(tmp_path: Path) -> None:
|
||||||
@@ -69,7 +94,8 @@ def test_ha_event_listener_processes_state_change(tmp_path: Path) -> None:
|
|||||||
|
|
||||||
connect.assert_called_once_with(
|
connect.assert_called_once_with(
|
||||||
"ws://homeassistant:8123/api/websocket",
|
"ws://homeassistant:8123/api/websocket",
|
||||||
ping_interval=None,
|
ping_interval=20,
|
||||||
|
ping_timeout=10,
|
||||||
)
|
)
|
||||||
assert fake_ws.sent == [
|
assert fake_ws.sent == [
|
||||||
{"type": "auth", "access_token": "test-token"},
|
{"type": "auth", "access_token": "test-token"},
|
||||||
@@ -83,12 +109,20 @@ def test_ha_event_listener_processes_state_change(tmp_path: Path) -> None:
|
|||||||
mock_app.state.ws_status = MagicMock()
|
mock_app.state.ws_status = MagicMock()
|
||||||
mock_engine = _RecordingBehaviorEngine(tmp_path)
|
mock_engine = _RecordingBehaviorEngine(tmp_path)
|
||||||
mock_app.state.behavior_engine = mock_engine
|
mock_app.state.behavior_engine = mock_engine
|
||||||
|
mock_app.state.ha_reader = _FakeHaReader()
|
||||||
mock_store = ActuatorStore(tmp_path / "store")
|
mock_store = ActuatorStore(tmp_path / "store")
|
||||||
|
mock_store.configure("light.test")
|
||||||
mock_app.state.actuator_store = mock_store
|
mock_app.state.actuator_store = mock_store
|
||||||
mock_client = MagicMock()
|
mock_client = MagicMock()
|
||||||
|
|
||||||
anyio.run(run_test)
|
anyio.run(run_test)
|
||||||
assert mock_engine.state_changes == [("light.test", {"state": "on"})]
|
assert len(mock_engine.state_changes) == 1
|
||||||
|
entity_id, new_state, current_entities = mock_engine.state_changes[0]
|
||||||
|
assert entity_id == "light.test"
|
||||||
|
assert new_state == {"state": "on"}
|
||||||
|
assert current_entities == [
|
||||||
|
HaEntitySummary(entity_id="light.test", domain="light", state="on")
|
||||||
|
]
|
||||||
assert mock_app.state.ws_status.status == "connected"
|
assert mock_app.state.ws_status.status == "connected"
|
||||||
assert mock_app.state.ws_status.error is None
|
assert mock_app.state.ws_status.error is None
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user