# 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` не обнаружено. Рекомендация: зелёный вердикт.