[2026-09-16] eagle: family/tech/kitchen-hood-fan-template.md

family/tech/kitchen-hood-fan-template.md

@@ -226,3 +226,66 @@ related:
 - [[family/how-to/home-automation]] — топология, t610, Zigbee, команды, питфоллы
 - [[family/tech/zigbee-t610-z2m-i-zha]] — ZHA, реестры, переименование, питфолл «домен менять нельзя»
 - [[family/how-to/ha-automations]] — автоматизации, справочник
+
+---
+
+## 7.1. 🔴 Доводка UI (2026-09-16, по факту «ничего не вижу»)
+
+**Симптом Alex:** «Я в кухне до сих пор вижу показатели kitchen hood и нет нового вентилятора».
+
+**Две причины, обе найдены фактом:**
+
+| # | Причина | Факт |
+|---|---|---|
+| 1 | **`fan.kitchen_hood` создан без зоны** — Template-сущность из YAML не привязана к устройству → `area_id: null`, на кухне не видна | WS-реестр: `area=null`. У `fan.fan_3` зона `kitchen` **была** → он и торчал на кухне вместо нового |
+| 2 | **Диагностика устройства не скрыта** — «показатели kitchen hood» = 4 сенсора + 2 select + update + button, все `hidden_by=None` | Найдено сканом `config/entity_registry/list` |
+
+**Фикс — скрипт `~/tmp-t610/hood_cleanup.py`** (обратимо флагом `--unhide`):
+
+1. `fan.kitchen_hood` → `area_id: kitchen` ✅
+2. Скрыто `hidden_by: user` — **13 сущностей**:
+   - `fan.fan_3` (мёртвый template-фан «Вытяжка Кухня»)
+   - `switch.fan_3_low` / `_medium` / `_high` + `script.set_fan_3_speed` — подтверждены `unavailable` (slave 10 / AT2 офлайн)
+   - `sensor.kitchen_hood_energy` / `_power` / `_voltage` / `_current`
+   - `select.kitchen_hood_indicator_mode` / `_power_outage_memory`
+   - `update.kitchen_hood_firmware`
+   - `button.kitchen_hood_identify`
+
+**Проверено чтением обратно:** все 13 → `hidden_by=user`; `fan.kitchen_hood` → `area=kitchen`, `hidden_by=None`.
+
+> 🔑 **Урок 1:** Template-сущности из YAML **не получают зону автоматически** — у них нет `device_id`. После создания такой сущности назначать зону вручную через WS `config/entity_registry/update` с `area_id`, иначе она «невидима» на дашбордах зон и в списке кухни.
+> 🔑 **Урок 2:** `hidden_by: user` убирает сущность из автогенерируемых дашбордов и списков, но **не из карточки устройства** в UI. Реестр HA кэширует UI → после массовых правок реестра нужен hard-refresh (Cmd+Shift+R).
+> 🔑 **Урок 3:** «Создал сущность» ≠ «видно в UI». Проверять **обе** вещи: (а) `/api/states/<entity>` отвечает, (б) в реестре есть `area_id`. Наличие в бэкенде без зоны выглядит для пользователя как «ничего не появилось».
+
+---
+
+## 7.2. Итоговое состояние кухни (вытяжка)
+
+| Видно пользователю | Скрыто (`hidden_by: user`) |
+|---|---|
+| `fan.kitchen_hood` (зона `kitchen`) | `fan.fan_3`, `switch.fan_3_low/medium/high`, `script.set_fan_3_speed` |
+| `light.kitchen_hood_light` / `_2` / `_3` | `sensor.kitchen_hood_energy/power/voltage/current` |
+| | `select.kitchen_hood_indicator_mode` / `_power_outage_memory` |
+| | `update.kitchen_hood_firmware`, `button.kitchen_hood_identify` |
+
+> `sensor.kitchen_hood_lqi` / `_rssi` — `disabled_by: integration`, не отображаются нигде (норма).
+
+## 8. Артефакты
+
+| Файл | Назначение |
+|---|---|
+| `~/tmp-t610/configuration.yaml.current` | рабочая копия конфига (с новым блоком) |
+| `~/tmp-t610/hood_scan.py` | скан сущностей/устройств вытяжки через WS+rest |
+| `~/tmp-t610/hood_hide.py` | скрыть/показать три `light.*` (`--unhide`) |
+| `~/tmp-t610/hood_cleanup.py` | зона + скрытие 13 сущностей (`--unhide`) |
+
+## 9. ⚠️ ОТКРЫТО — требует проверки Alex
+
+1. 🔴 **Порядок скоростей не подтверждён физически.** Принято `_1`=33 / `_2`=66 / `_3`=100, но какое **реле** = какая **скорость** — не проверялось. Нужно встать у вытяжки: поставить 33 % и 100 %. Если перепутано — правка трёх строк в `percentage` и `set_percentage`.
+2. ⚠️ **`light.kitchen_hood_light` мог быть лампой подсветки, а не скоростью.** До работ был `on`, после рестарта HA → `off`. Если это лампа вытяжки — вынести отдельно, фан её гасить не должен.
+
+## Связанные
+
+- [[family/how-to/home-automation]] — топология, t610, Zigbee, команды, питфоллы
+- [[family/tech/zigbee-t610-z2m-i-zha]] — ZHA, реестры, переименование, питфолл «домен менять нельзя»
+- [[family/how-to/ha-automations]] — автоматизации, справочник