baseline: docs as of pre-reorg audit (2026-05-20)

2026-05-20 23:23:31 +02:00
commit 04d54ac9b0
40 changed files with 7074 additions and 0 deletions
@@ -0,0 +1,74 @@
+# Home Info — seed for the LobeChat morning-briefing agent
+
+Discovered via the Home Assistant MCP (gateway → `home-assistant`) on 2026-05-18.
+Home Assistant: ~2492 entities, 40 domains, 19 areas, 2 floors. Language: German.
+
+## Layout
+- **Floors**: Erdgeschoss (level 0) + one upper floor; 19 areas total.
+- Erdgeschoss areas incl.: Badezimmer, Büro, Esszimmer, Gang, Küche, Wohnzimmer,
+  Schlafzimmer, Kinderzimmer, Technikraum, Terrasse … (+ more).
+
+## Key systems
+- **Heat pump**: NIBE S1255-6 E (geothermal/brine, BT10 brine-in sensor).
+- **Home battery / solar**: EcoFlow **PowerOcean** (`PowerOcean emsBpPower`,
+  `Battery HJ3AZDH5ZG3G0384`, switches `Hausbatterie: Entladesperre`,
+  `Hausbatterie: Fahrzeug zuerst`). Solar forecast: `Solar Prognose`,
+  `sensor.energy_production_today`, `sensor.energy_current_hour`,
+  `sensor.energy_next_hour`.
+- **EV charging**: evcc + PowerPulse wallbox (AC31ZEH4AG130052). Vehicle = BYD.
+- **Spa**: Whirlpool (heat-pump spa). Filter cycles, thermostat.
+- **Other**: Philips Hue (lights), smoke detectors (Rauchmelder, w/ temp+humidity),
+  Siemens dishwasher, dryer, Sonos (Playbase/TV), QNAP NAS, 3D printer,
+  grow tent, voice satellites + **Piper** (local TTS available in HA).
+
+## Briefing entities (use these in the morning briefing)
+| Briefing item | Entity / source | Notes |
+|---|---|---|
+| Car state of charge | `sensor.evcc_byd_configvehicle_soc` | % (e.g. 98) |
+| Car range | `sensor.evcc_byd_configvehicle_range` | km (e.g. 422) |
+| Car charge limit | `number.evcc_powerpulse_limit_soc` | % |
+| Solar battery (house) | PowerOcean / `select.evcc_buffer_soc`; use `ha_search_entities "PowerOcean"` / `ha_get_state` for the live battery-SoC sensor | exact SoC sensor: query PowerOcean at briefing time |
+| Solar production today | `sensor.energy_production_today` | kWh |
+| Solar forecast (hour/next) | `sensor.energy_current_hour`, `sensor.energy_next_hour` | |
+| Grid import | `sensor.evcc_powerpulse_charge_total_import` | kWh |
+| Spa temperature | `sensor.whirlpool_temperatur` | °C (e.g. 36.7) |
+| Spa thermostat | `climate.spa_thermostat` | mode (heat) |
+| Spa target temp | `number.spa_target_desired_temperature` | °C |
+| **Spa pH / bromine** | **NOT in Home Assistant** — no pH/bromine sensors exist | omit, or user adds them later / states manually |
+| Weather forecast | `weather.wetter` | use `ha_get_state` for forecast attrs |
+| Timeline highlights | Bluesky MCP (`bluesky`) — pending fix | once bluesky MCP works |
+| Memos recap (yesterday) | Memos MCP (`memos`) — `search_memo` / list by date | working |
+
+## Systematic inventory (2026-05-18)
+**Floor Erdgeschoss (level 0)** — 13 areas: Badezimmer, Büro, Esszimmer, Gang,
+Garderobe, Gästezimmer, Kinderzimmer, Küche, Schlafzimmer, Speis, Technikraum,
+WC, Wohnzimmer.
+**Floor Außen (outdoor)** — 6 areas: Eingang, Garage, Grillplatz, Ruheplatz,
+Terrasse, Grow.
+
+**Domain counts** (2492 entities / 40 domains): sensor 1309, switch 189,
+update 154, button 152, number 148, binary_sensor 143, select 141, light 62,
+device_tracker 55, event 33, automation 20, camera 10, notify 9, media_player 8,
+cover 8, zone 4, fan 4, person 3, image 3, scene 2, climate 2, calendar 1,
+water_heater 1, weather 1, vacuum 1, humidifier 1, tts 1, stt 1, todo 1,
+assist_satellite 1, sun 1.
+
+## Notifications / alerts for the briefing
+HA has no `alert` domain; surface alerts from:
+- **Persistent notifications**: `ha_get_state` on `persistent_notification.*`
+  (or `ha_search_entities "notification"`).
+- **Problem/safety binary_sensors in `on`**: smoke (Rauchmelder), water leak
+  (Wasserticker/"Batterie fast leer"), low-battery sensors — search
+  `ha_search_entities "leer"` / `"rauch"` / `"leak"`, report any `state=on`.
+- **Automations named like alerts**: e.g. `automation.low_battery` (state on).
+- **Pending updates count**: domain `update` (154 entities; report how many `on`).
+The agent should call `ha_get_state`/`ha_search_entities` at briefing time and
+list only items currently in an alert state (don't dump everything).
+
+## Caveats
+- **Spa pH & bromine are not exposed** by the Whirlpool integration — only
+  temperature/filter. The briefing should skip them (or note "no chemistry
+  sensors") unless the user adds manual input_number/sensor entities.
+- House-battery SoC sensor name varies (PowerOcean); the agent should resolve it
+  live via `ha_search_entities "PowerOcean"` + `ha_get_state` rather than a
+  hardcoded id.