houseplan-card/docs/reviews/CODE-REVIEW-29-r2.md

# CODE-REVIEW-29-r2

- Issue: #29 «[HP-UX-02] inbox и жизненный цикл устройств»
- Этап: code (PROCESS.md §2.7)
- Заход: r2 · блокирующих циклов израсходовано 1 из 4
- Проверено на SHA `8572d43c9192ace04b8e7d305d5a3589eee80071` (HEAD, ветка
  `issue/29-device-inbox-lifecycle`, приведена конвейером к `origin/dev@2b1964f9`)
- Предыдущий раунд: `docs/reviews/CODE-REVIEW-29-r1.md`, жёлтый, проверен на
  SHA `905d4847a3797a8830eb6c5c509351f142193b73` (эквивалент текущего
  `4b3b71e73bc369d04f57ef000a30465571932bf1` — см. «Скоуп разбора» ниже, это
  тот же коммит после ребейза, содержимое подтверждено идентичным)

## Скоуп разбора: почему разбор полный, а не по дельте

Заголовок задачи говорит: между r1 и этим раундом ветка приведена конвейером
к `dev` — «поверх легло 1 коммит(ов) dev, `11c0cbd4 -> 8572d43c`». Это ровно
условие §7.2 «после ребейза это другой код» — по умолчанию разбор полный.
Я не поверил этому на слово и проверил, что ребейз действительно ничего не
подмешал:

- коммит `4b3b71e7` («feat: add device lifecycle catalog») — это тот самый
  коммит, что рецензировался в r1 под SHA `905d4847` (сообщение коммита то
  же самое, дифф-статистика совпадает построчно: `src/device-inbox.ts` — ровно
  281 строка, как в тексте r1, `src/houseplan-card.ts` — 536 вставок против
  536 в свежем `git show --stat`); сам SHA `905d4847` в дереве больше не
  существует именно потому, что рецензируемая история была переиграна поверх
  нового `dev`-коммита — это и есть смена родителя, о которой предупреждает
  §7.2, а не смысловое расхождение;
- единственный коммит `dev`, который лёг поверх (`2b1964f9`, «ci: бандл
  собирается один раз…») — это перестройка CI-джобов, не трогает ни один
  файл в `src/**`, `docs/specs/**`, `demo/**`; пересечения с темой задачи нет;
- `npx tsc --noEmit` / `npm test` (1409 pass / 0 fail / 1 skip) / `npm run
  build` + сверка трёх копий бандла — зелёные на текущем HEAD, то есть
  переигранный код компилируется и проходит тот же набор тестов, что и до
  ребейза.

Итог: контент коммита, который рецензировал r1, не изменился — изменился
только его родитель. Поэтому этот раунд не повторяет построчный разбор всего
`src/houseplan-card.ts`/`src/device-inbox.ts` заново (это было бы тем самым
бесполезным полным прогоном ради нуля новой информации, о котором
предупреждает §2.9), а: (а) независимо перепроверяет, что ребейз не подменил
код тихо (сделано выше), (б) разбирает новый коммит `8572d43c` («fix: align
device catalog with plan rooms») целиком — это и есть фактическая дельта
поведения, отвечающая на находки r1, (в) заново прогоняет весь набор дешёвых
гейтов §8 на итоговом HEAD, а не только на дельте, (г) перепроверяет каждый
AC, довод которого лежит в изменённых строках (AC2, AC6, AC9 — источник
имени комнаты; AC1 — счётчик кнопок devbar), остальные наследует из r1 с
независимым подтверждением по гейтам (раздел «Унаследовано» ниже).

## Скоуп изменения (коммит `8572d43c`, единственный новый относительно r1)

Один коммит, `Issue: #29`, `User-Visible: yes`, оба CHANGELOG в этом же
коммите:

- `src/houseplan-card.ts` (`_deviceInboxRows()`): `areaNames` теперь строится
  из `this._areaToSpace[id]?.room?.name` (имя комнаты плана), а не из
  `this.hass?.areas[id].name` (имя зоны HA); второй проход по `areaMap`
  гарантирует это и для комнат, чья зона отсутствует в текущем (возможно
  урезанном) `hass.areas`-снапшоте;
- `src/device-inbox.ts`: удалено мёртвое поле `DeviceInboxRow.canOpenHa`
  (не читалось нигде, рендер использует независимый `_bindingHasHaPage`);
- `demo/smoke_editor_tabs.mjs`: ожидаемое число кнопок devbar исправлено
  с 3 на 2 (комментарий обновлён на `#29`);
- `demo/smoke_device_inbox.mjs`: добавлены 3 проверки — строка каталога
  берёт имя из комнаты плана, а не из зоны HA, переименование комнаты на
  плане отражается в каталоге и в поисковой строке немедленно;
- скриншот `docs/images/06-device-editor.png` и `screenshots.json`
  пересобраны (следствие смены отображаемого текста, docs-check зелёный).

## Как проверялось

| Гейт | Команда | Результат |
|---|---|---|
| Типы | `npx tsc --noEmit` | зелёный, без вывода |
| Юниты | `npm test` | `# tests 1410 / pass 1409 / fail 0 / skipped 1` |
| Сборка | `npm run build` | собран `dist/houseplan-card.js` за 13.4s |
| Три копии бандла | `npm run bundle:sync` + `md5sum dist/… custom_components/…` | идентичны; `git status` после сборки чист — закоммиченные копии уже актуальны |
| Документация | `node scripts/check-docs.mjs` | `Documentation checks passed (7 files, 10 external links)` |
| Выборка смоков по дельте | `node scripts/smoke-select.mjs --base 4b3b71e7 --head HEAD` | «Прямое совпадение (1): `demo/smoke_device_inbox.mjs` ← `_areaToSpace`» — единственный релевантный смок, других слабых связей нет |
| Тематический смок (H1) | `node demo/smoke_editor_tabs.mjs` | `OK` |
| Тематический смок (M2) | `node demo/smoke_device_inbox.mjs` | `OK`, включая новые `hasCatalogRowInPlanRoom`/`planRoomNameWins`/`planRoomNameIsSearchable` |
| Тематический смок (не тронут этим коммитом, перепроверен как в r1) | `node demo/smoke_hidden_flag.mjs` | `OK`, 27/27 |
| Тематический смок (не тронут этим коммитом, перепроверен как в r1) | `node demo/smoke_binding_picker.mjs` | `OK`, 24/24 |
| Single-source-numbers | `node --test test/single-source-numbers.test.mjs` | 3/3 pass (не входит в скоуп изменения — в каталоге нет дублирующихся чисел, badge-счётчиков нет) |
| Единый источник чисел (продуктовое) | — | этот диф не добавляет и не меняет ни одной видимой пользователю величины (счётчика/площади/etc.) — есть только текстовое имя комнаты; проверять нечего |
| Инварианты модели | не прогонялись | diff не трогает рёбра комнат, `layout`, `marker.space`, `open_spans`, толщину стен — geometry не затронута (grep по diff подтверждает отсутствие этих символов) |
| CI на точном SHA задачи | `gh run view 33125028109` (run триггернут этим же коммитом `8572d43c`) | «Фронтенд» ✓, «Перф-смок» ✓, все 3 шарда браузерных смоков ✓ (включая шард 2, где в r1 падал `smoke_editor_tabs` — теперь зелёный), «Golden» ✗ — `missing-baseline` для `device-inbox-desktop-en-light/ru-dark`, `device-inbox-narrow-ru-dark` (лог job подтверждает: `missing-baseline device-inbox-desktop-en-light` и т.д.) — то же самое ожидаемое состояние, что и в r1, не новая находка |

Полный `node scripts/smoke-select.mjs --base origin/dev --head HEAD` уже
выполнялся и разобран в r1 (75 прямых совпадений, обоснование см. там); для
этого раунда достаточно delta-режима (`--base 4b3b71e7`), так как только он
отвечает на вопрос «что изменилось между r1 и r2» — полная выборка от `dev`
не даёт новой информации, потому что нерассмотренная r1 часть дифа не
менялась.

Прочитан полный diff коммита `8572d43c` (все 10 файлов) построчно.

## Закрытие раунда r1

| Находка r1 | Чем закрыта | Где это видно |
|---|---|---|
| **H1** (High, в скоупе) — `demo/smoke_editor_tabs.mjs` ожидал 3 кнопки в devbar (`add/show-all/rules`), а ТЗ §10.1 оставляет 2 («Устройства», «Правила иконок») — существующий смок был красным на SHA задачи, в т.ч. в реальном CI | Ассерт исправлен на `=== 2`, комментарий переписан на `devices catalog + icon rules (#29)`; фактическая разметка `_renderDevicesBar()` (houseplan-card.ts:20950-20970) рендерит ровно 2 `.btn:not(.barclose)` (кнопка каталога + кнопка правил, `_editorToolbarGroups` в демо-конфиге пуст) | `demo/smoke_editor_tabs.mjs:159`; локальный прогон `OK`; CI run `33125028109`, job «Смоки в браузере (шард 2 из 3)» — зелёный (был красным на SHA r1) |
| **M2** (Medium, в скоупе) — источник имени «комната» в каталоге — `hass.areas[id].name` (имя зоны HA), а не `RoomCfg.name` (имя комнаты плана); расходится с остальным UI и с текстом `USER-GUIDE.ru.md` («поиск… по комнате») | `areaNames` теперь строится в первую очередь из `this._areaToSpace[id]?.room?.name`; второй проход по `areaMap` дополнительно покрывает комнаты, чья HA-зона отсутствует в (возможно урезанном) `hass.areas`-снапшоте текущего пользователя (комментарий в коде это явно объясняет) | `src/houseplan-card.ts:14100-14110`; новый смок-сценарий переименовывает `room.name` на живом конфиге и проверяет, что строка каталога и `searchText` немедленно отражают новое имя (`demo/smoke_device_inbox.mjs`, `planRoomNameWins`/`planRoomNameIsSearchable` — оба `true`) |
| **L3** (Low, снято автором) — `DeviceInboxRow.canOpenHa` — мёртвое поле, нигде не читается | Поле удалено из интерфейса и построения строки | `src/device-inbox.ts` — оба места (`interface`, `push`) отсутствуют; `grep -rn canOpenHa` по репозиторию не находит использований (только упоминание в тексте r1) |

Все три находки r1 закрыты по существу (проверено чтением кода и
исполнением тестов/смоков, а не заявлением автора).

## Проверено (полный охват AC, с указанием источника доказательства)

Диф `8572d43c` не трогает резолвер жизненного цикла, read-only контракт,
пагинацию, accessibility-разметку и compatibility-слой — они не менялись со
времени r1, где были разобраны построчно и подтверждены тестами/mutation-gate.
Ниже — не слепое доверие, а повторное подтверждение тем же набором
тестов/гейтов на итоговом HEAD (см. таблицу гейтов выше: `npm test`
1409/1410, все тематические смоки зелёные на `8572d43c`), с отдельной пометкой,
где что-то реально поменялось в этом раунде.

- **AC1** (единая точка входа, счётчик кнопок): изменилось в этом раунде —
  подтверждено чтением разметки `_renderDevicesBar` и `smoke_editor_tabs` (см.
  «Закрытие r1 → H1»).
- **AC2** (детерминированная классификация): не менялось; наследуется из r1
  (unit-тест «full lifecycle matrix», `npm test` зелёный).
- **AC3** (auto/new): не менялось; наследуется из r1.
- **AC4** (lifecycle/HA-status независимы): не менялось; наследуется из r1.
- **AC5** (exact binding/re-add): не менялось; наследуется из r1
  (`smoke_binding_picker` 24/24 перепрогнан на HEAD, зелёный).
- **AC6** (действия строки, включая «комнату» в мета-строке): источник имени
  комнаты изменился в этом раунде — закрывает M2, подтверждено новым смок-
  сценарием (`planRoomNameWins`/`planRoomNameIsSearchable`).
- **AC7** (read-only): не менялось; наследуется из r1
  (`smoke_device_inbox.browsingIsReadOnly` перепрогнан, `true`).
- **AC8** (возврат/refresh): не менялось; наследуется из r1
  (`nestedCancelReturnsContext` перепрогнан, `true`).
- **AC9** (поиск/большие реестры): поисковая строка теперь включает имя
  комнаты плана, а не зоны HA — это и есть предмет M2; unit-тест на 260
  сущностях (не менялся, не завязан на имя комнаты) и
  `searchUsesFullSnapshot` перепрогнаны, зелёные.
- **AC10** (accessibility/responsive): не менялось; наследуется из r1
  (`arrowChangesTab`, `noHorizontalOverflow` перепрогнаны, `true`).
- **AC11** (compatibility): `npm test` перепрогнан целиком на HEAD, 1409/1410
  зелёных (то же соотношение, что и в r1, плюс 10 новых утверждений в смоках).
- Трейлеры всех 7 коммитов диапазона `origin/dev..HEAD`: `Issue: #29` везде;
  `User-Visible: yes` у `8572d43c` и `4b3b71e7` (единственные, меняющие
  видимое поведение) — в обоих оба CHANGELOG правились в том же коммите
  (проверено `git show --stat` и содержимым диффов).

## Унаследовано из r1 (без повторного построчного чтения)

Документ: `docs/reviews/CODE-REVIEW-29-r1.md`, SHA `905d4847` (= текущий
`4b3b71e7` после ребейза, содержимое идентично — проверено дифф-статистикой
и повторным прогоном тестов, см. «Скоуп разбора» выше). Принято без
повторного посимвольного чтения (но с независимым перепрогоном тестов на
HEAD):

- построчный разбор `src/houseplan-card.ts` (диалог каталога, ~15 приватных
  методов рендера/действий строк) и полного модуля `src/device-inbox.ts` —
  логика приоритета статусов, `bindingCandidates`, пагинация;
- сверка терминологии с `docs/USER-GUIDE.ru.md` и `docs/SCOPE.md` (J4/J6,
  admin persona, desktop-first) — не менялась в этом раунде за пределами
  правки M2, которая саму терминологию подтверждает, а не опровергает;
- разбор 75 «прямых совпадений» `smoke-select` от `origin/dev` — обоснование
  (общие символы `_markerDialog`/`_saveConfig` и т.п., не относящиеся к теме)
  не пересматривалось, так как ни один из этих участков кода не тронут
  коммитом `8572d43c`;
- вывод о переходе `_showAll`/legacy `settings.show_all` — не менялся.

## Чего не проверял и почему

- **Полный набор `demo/smoke_*.mjs` (194 файла, `ls demo/smoke_*.mjs | wc -l`)**
  — не прогонял целиком локально; CI на точном SHA `8572d43c`
  (run `33125028109`) уже прогнал все 3 шарда браузерных смоков полностью и
  все зелёные — это закрывает вопрос лучше, чем повторный локальный прогон.
- **`npm run golden:verify` / приёмка baseline** — не прогонял; три новых
  golden-ID по-прежнему без базовых кадров (`missing-baseline` в CI job
  «Golden», run `33125028109`, лог подтверждён) — то же ожидаемое состояние,
  что и в r1, приёмка baseline — не обязанность код-ревью (PROCESS.md).
- **`python -m pytest tests_backend`** — diff не трогает
  `custom_components/**/*.py`.
- **Инварианты модели (`npm run invariants`)** — diff не трогает геометрию
  (нет изменений рёбер комнат, `layout`, `marker.space`, `open_spans`, записей
  толщины стен) — проверено grep'ом по диффу, гейт не применим.
- **Performance-профили** — не затронуты, не названы в AC/§17 ТЗ.
- **Ручной keyboard/screen-reader проход** — не менялся этим коммитом,
  унаследовано из r1 (роли/aria не тронуты).

## Вывод

Оба блокирующих/скоуповых замечания r1 (H1 — сломанный существующий смок,
M2 — комната каталога называлась по зоне HA, а не по имени комнаты плана)
закрыты по существу: чтением кода, перепрогоном тестов/смоков и реальным CI
на точном SHA задачи (шард с падением H1 теперь зелёный). L3 снято автором
чисто. Новых находок в коммите `8572d43c` не обнаружено. Рекомендация:
зелёный вердикт.