Refactor: Multi-File-Struktur mit wiederverwendbaren Intent-Factories #1

2026-08-24T20:20:27+02:00

vogto commented

2026-08-24 20:20:27 +02:00

Was ist neu

Der Custom Skill ist jetzt auf mehrere Dateien aufgeteilt, damit neue Sensoren/Geräte nur noch wenige Zeilen Config statt eines kompletten Handlers brauchen.

Neue/geänderte Dateien:

index.js — schlank, nur noch Config-Aufrufe der Factories + Handler-Registrierung
factories.js (neu) — makeApplianceIntent, makeSimpleSensorIntent, makeSlotSensorIntent, PERIOD_PHRASES
ha-client.js (neu) — getHaState() als eigenes Modul
static-handlers.js (neu) — Launch/Help/Cancel/Fallback/Error-Handler
ARCHITECTURE.md (neu) — Doku zur neuen Struktur mit Beispielen für neue Sensoren/Geräte/Kostengruppen

Inhaltliche Änderungen:

Temperaturabfragen (GetTemperatureIntent, roomToClimateEntity) entfernt — läuft jetzt über die native Nabu-Casa-Smart-Home-Integration
Neu: GetPowerKammerUsageIntent (Leistung Kammer-Serverschrank)
Neu: GetEnergyCostKammerIntent (Stromkosten Kammer-Serverschrank nach Tag/Woche/Monat)
Grammatik-Fix bei Stromkosten: PERIOD_PHRASES sorgt für "diese Woche" statt "diesen Woche"

Vor dem Merge in der Alexa Console prüfen

GetTemperatureIntent und RoomList Slot Type können optional entfernt werden (werden nicht mehr genutzt)
GetPowerKammerUsageIntent und GetEnergyCostKammerIntent müssen dort als Intents mit Sample Utterances angelegt sein
Nach dem Merge: index.js, factories.js, ha-client.js, static-handlers.js in den Code-Tab kopieren, Deploy

Bekannter offener Punkt

Die Haupt-README (home-assistant-skill/README.md) wurde in diesem PR nicht aktualisiert (Übertragungsprobleme bei sehr langen Inhalten). Die neue Struktur ist stattdessen in ARCHITECTURE.md dokumentiert — ein README-Update kann in einem Folge-PR nachgezogen werden.

## Was ist neu Der Custom Skill ist jetzt auf mehrere Dateien aufgeteilt, damit neue Sensoren/Geräte nur noch wenige Zeilen Config statt eines kompletten Handlers brauchen. **Neue/geänderte Dateien:** - `index.js` — schlank, nur noch Config-Aufrufe der Factories + Handler-Registrierung - `factories.js` (neu) — `makeApplianceIntent`, `makeSimpleSensorIntent`, `makeSlotSensorIntent`, `PERIOD_PHRASES` - `ha-client.js` (neu) — `getHaState()` als eigenes Modul - `static-handlers.js` (neu) — Launch/Help/Cancel/Fallback/Error-Handler - `ARCHITECTURE.md` (neu) — Doku zur neuen Struktur mit Beispielen für neue Sensoren/Geräte/Kostengruppen **Inhaltliche Änderungen:** - Temperaturabfragen (`GetTemperatureIntent`, `roomToClimateEntity`) entfernt — läuft jetzt über die native Nabu-Casa-Smart-Home-Integration - Neu: `GetPowerKammerUsageIntent` (Leistung Kammer-Serverschrank) - Neu: `GetEnergyCostKammerIntent` (Stromkosten Kammer-Serverschrank nach Tag/Woche/Monat) - Grammatik-Fix bei Stromkosten: `PERIOD_PHRASES` sorgt für "diese Woche" statt "diesen Woche" ## Vor dem Merge in der Alexa Console prüfen - `GetTemperatureIntent` und `RoomList` Slot Type können optional entfernt werden (werden nicht mehr genutzt) - `GetPowerKammerUsageIntent` und `GetEnergyCostKammerIntent` müssen dort als Intents mit Sample Utterances angelegt sein - Nach dem Merge: `index.js`, `factories.js`, `ha-client.js`, `static-handlers.js` in den Code-Tab kopieren, Deploy ## Bekannter offener Punkt Die Haupt-README (`home-assistant-skill/README.md`) wurde in diesem PR nicht aktualisiert (Übertragungsprobleme bei sehr langen Inhalten). Die neue Struktur ist stattdessen in `ARCHITECTURE.md` dokumentiert — ein README-Update kann in einem Folge-PR nachgezogen werden.

vogto added 6 commits 2026-08-24 20:20:27 +02:00

ha-client.js: HA-API-Client als eigenes Modul ausgelagert 30ae802628

static-handlers.js: Pflicht-Handler (Launch/Help/Cancel/Fallback/Error) ausgelagert 6446712f50

factories.js: makeApplianceIntent, makeSimpleSensorIntent, makeSlotSensorIntent + PERIOD_PHRASES 8b3efe99e5

factories.js: Dateiende-Korruption beheben (fehlendes '};' vor module.exports) a0f6b0a8eb

index.js: schlanke Version mit Factories, PERIOD_PHRASES, GetPowerKammerUsageIntent, GetEnergyCostKammerIntent 11aea0a6ab

ARCHITECTURE.md: neue Multi-File-Struktur und Factory-Muster dokumentiert 1b66117b25

vogto merged commit 373ee83212 into main

2026-08-24 20:21:37 +02:00

vogto referenced this pull request

2026-08-25 05:07:45 +02:00

Docs: README bereinigen (keine climate/RoomList/GetTemperatureIntent-Reste mehr) #2