docs: review document for #594

Issue: #594
User-Visible: no

docs/reviews/CODE-REVIEW-594-r2.md

@@ -0,0 +1,201 @@
+# CODE-REVIEW-594-r2
+
+Issue: #594 · Этап: code · Заход: r2 · блокирующих циклов израсходовано 1 из 4
+
+Материал: `fd33a0dce3b9d7ffdcf37068dc5afc17dccbe39d` (рабочая копия уже на нём,
+HEAD detached). `git diff origin/dev...HEAD` — 66 файлов, ветка `issue/594-form-kit-room`,
+пять коммитов: `fb361c49` (feat), `bd3f0019` (refactor: типизация ключей заливки),
+`63059739` (review-документ r1), `bbaa469c` (test: M2/M3), `fd33a0dc` (test: приёмка
+четырёх эталонов).
+
+## Почему разбор полный, а не по дельте
+
+Между применением `S7-code-review` в прошлый раз (комментарий владельца от
+2026-09-19 05:49) и этим запуском ветка была ребейзнута конвейером на ушедший
+вперёд `dev`: поверх легло 4 чужих коммита (`dcd66575`, `2167d439`, `5b6d5d1d`,
+`41722e15` — доработки issue #593 и #595), исходные SHA задачи переписаны
+(`c54a7770→bd3f0019`, `ec23a351→bbaa469c`, `0585c1ba→fd33a0dc`, плюс появился
+промежуточный `073c45b0/fb361c49`). Это другой код (§7.2 PROCESS.md), поэтому
+разбор — полный: прочитан весь `git diff origin/dev...HEAD`, а не только три
+находки r1.
+
+Проверил отдельно, что чужие коммиты не задели предмет ревью: `git diff
+origin/dev...HEAD` содержит исключительно файлы задачи #594 (`form-kit.*`,
+`room-settings-dialog.ts`, i18n, тесты/смоки, changelog, эталоны, dist/D-классы) —
+никаких посторонних правок в дифф не просочилось, значит ребейз не изменил
+семантику того, что писал автор, только базу.
+
+## Закрытие раунда r1
+
+Код-ревью r1 (комментарий от 2026-09-18T21:36:30Z, документ
+`docs/reviews/CODE-REVIEW-594-r1.md`) на материале `c54a7770` дал жёлтый
+вердикт, три Medium в скоупе:
+
+| # находка r1 | Чем закрыта | Где это видно | Перепроверено сейчас |
+|---|---|---|---|
+| M1 — `npm run golden:verify` показывал диф по объявленным сценам, но `demo/golden/baselines/**` в диффе не было: приёмки не произошло | Коммит `fd33a0dc` (после ребейза — прежний `0585c1ba`): 4 PNG + `baselines-index.json` | `git show fd33a0dc --stat`: только класс D; трейлеры `Release: v1.76.0-beta.5`, `Baseline-Reviewed: .../runs/35407468491` на месте | Прогнал `npm run golden:verify` сам (Chromium в песочнице — 151.0.7922.34, совпадает с индексом эталонов, в отличие от песочницы автора). **exit 0, все сцены `passed`**, включая обе объявленные AC7 (`room-temperature-dialog-{desktop-en,mobile-ru}`) и посторонний долг #588 (`device-icon-state-table-{light,dark}`) |
+| M2 — отпечаток `docs/images/screenshots.json` устарел (диф трогает `src/**`) | Коммит `bbaa469c`: `npm run docs:accept -- --identical` | `git diff` по `docs/images/screenshots.json`: изменился только `sourceFingerprint`/`sourceSha256` во всех 10 сценариях, ни один `imageSha256` не сдвинулся — пиксели те же | Прогнал `node scripts/check-docs.mjs --screenshots=strict` сам — **зелёный**: «Documentation checks passed» |
+| M3 — свидетель AC1 доказывал «пишет только своё поле» лишь для 3 из 8 контролов; `_areaSel`/`_roomFill` не имели исполнимого oracle | Коммит `bbaa469c`: добавлены `areaWritesOnlyItsOwnKey`, `fillWritesOnlyItsOwnKey` в `demo/smoke_room_settings.mjs`, по образцу трёх уже существующих | `git diff` по `demo/smoke_room_settings.mjs` — оба факта на месте, используют тот же снимок-черновика (`draft()`/`changedFields`) | Прогнал `node demo/smoke_room_settings.mjs` сам — **зелёный**, все 13 булевых полей `true`, включая оба новых |
+
+Находка r1 была узко сформулирована («добавить 1–2 проверки по образцу...» — именно
+для `_areaSel`/`_roomFill`); `tempSrc` и `labelScale` r1 не называл дефектом
+(перепутывание temp/hum ловит мутант `form-kit-writes-to-a-neighbour-key`,
+`labelScale` структурно идентичен уже проверенному `nameScale`) — фикс не расширяет
+скоуп находки, а закрывает её ровно как сформулировано.
+
+Все три находки закрыты и подтверждены исполнением, а не чтением заявления автора.
+
+## Что проверялось и как (полный AC-разбор)
+
+Материал изучен диффом (`git diff origin/dev...HEAD`), затем гейты прогнаны
+руками (сборка `dist`/`custom_components/houseplan/frontend` через
+`npm run bundle:sync` пересобралась байт-в-байт идентично закоммиченному —
+заодно подтверждает `tsc --noEmit`/`build`, поверх подтверждённого Validate на
+этом SHA):
+
+| Команда | Результат |
+|---|---|
+| `npm run bundle:sync` (build+tsc, затем сверка дерева) | `git status` после — чисто, ни одного расхождения |
+| `npx tsc -p tsconfig.test.json && node scripts/fix-test-build.mjs && node --test test/form-kit.test.mjs test/i18n.test.mjs test/i18n-dead-keys.test.mjs test/styles-split.test.mjs` | 43/43 |
+| `node --test test/editor-dialog-modules.test.mjs` | 2/2 (набор остаётся в ленивом графе) |
+| `node --test test/bundle-assets.test.mjs` | 31/31 |
+| `node --test test/single-source-numbers.test.mjs` | 3/3 (диф не заводит второй источник числа) |
+| `node scripts/mutation-gate.mjs --id=form-kit-segment-drops-radio-semantics` | поймано 1 из 1 |
+| `node scripts/mutation-gate.mjs --id=form-kit-writes-to-a-neighbour-key` | поймано 1 из 1 |
+| `npm run bundle:budget` | initial View 291872 Б / потолок 292400 Б, запас 9194 Б (совпадает с цифрой автора день-в-день); предупреждение про низкий общий запас — старый долг #367/#474, к #594 не относится |
+| `npm run golden:verify` (Chromium 151.0.7922.34, совпадает с индексом) | **все сцены `passed`**, включая AC7 |
+| `node scripts/check-docs.mjs --screenshots=strict` | зелёный |
+| `node demo/smoke_room_settings.mjs` | зелёный, все поля включая новые `areaWritesOnlyItsOwnKey`/`fillWritesOnlyItsOwnKey`/`humiditySourceWritesOnlyItsOwnKey` |
+| `node demo/smoke_color_picker_consumers.mjs` (AC3, без правок) | зелёный |
+| `node demo/smoke_room_temperature_thresholds.mjs` (AC4, без правок) | зелёный |
+| `node demo/smoke_help_affordance.mjs` (AC6, расширенный) | зелёный |
+| `node demo/smoke_summary_panel.mjs`, `smoke_summary_panel_polish.mjs` (AC9, без правок) | зелёные |
+| `node demo/smoke_font_scales.mjs`, `smoke_editor_tabs.mjs` (план автотестов, без правок) | зелёные |
+| `node scripts/smoke-select.mjs --base origin/dev --head HEAD` | 19 «прямых совпадений» — прогнаны названные в ТЗ плюс `smoke_render_parity` (упоминает `cardStyles` напрямую); остальные 15 не прогонялись (см. ниже) |
+| `node demo/smoke_backup_transfer.mjs`, `smoke_binding_ui.mjs`, `smoke_general_settings.mjs`, `smoke_size_angle_parity.mjs`, `smoke_space_scale_defaults.mjs` | зелёные (см. отдельное расследование ниже) |
+
+### Отдельное расследование: смоки, использующие общие классы
+
+`smoke-select.mjs` матчит по JS-символам и не увидел совпадения по строковым
+CSS-селекторам. Грепом по `demo/*.mjs` нашёл пять смоков, дёргающих классы,
+которые диалог комнаты раньше рисовал (`.dispsection`, `.gsrow`, `.colorrow`,
+`.dropbtn`, `.droppanel`): `smoke_backup_transfer.mjs`, `smoke_binding_ui.mjs`,
+`smoke_general_settings.mjs`, `smoke_size_angle_parity.mjs`,
+`smoke_space_scale_defaults.mjs`. Прочитал каждый: все пять открывают ДРУГИЕ
+диалоги (настройки, бэкап, привязка устройства, диалог устройства/пространства)
+— классы общие по имени, но не по диалогу, поэтому правка `room-settings-dialog.ts`
+их не касается структурно. Прогнал все пять — зелёные. Это не было в списке ТЗ
+и не входило в «прямое совпадение» инструмента, но стоило проверить именно
+потому, что инструмент матчит по символам, а не по строкам-селекторам.
+
+### AC-таблица (все — свежая проверка исполнением или чтением, не наследование)
+
+| AC | Результат | Как подтверждено |
+|---|---|---|
+| AC1 | 8/8 ключей черновика подтверждены: name/nameScale/humSrc (было в r1), area/fill (добавлено в r2-фиксе), color/thresholds — отдельными AC3/AC4, tempSrc — мутантом (перепутывание с humSrc ловится) | чтение + исполнение смока и мутанта |
+| AC2 | запись каждого поля через снимок-черновика; условия «Сохранить» не менялись (код диалога идентичен по условиям `canSaveNew`/`?disabled`) | смок зелёный, диф читаем |
+| AC3 | `hp-color-opacity` не подменён, нативных пикеров 0 | смок без правок зелёный |
+| AC4 | пороги температуры не изменились | смок без правок зелёный |
+| AC5 | сегмент — радиогруппа, цель ≥44px, фокус берётся | смок + unit-тест `form-kit.test.mjs` |
+| AC6 | 4 заголовка, у каждого «?» с текстом и aria-label, абзацев не осталось, мёртвых ключей нет | смок + `i18n-dead-keys.test.mjs` (24, было 20) |
+| AC7 | ровно 2 объявленные сцены изменились и приняты, остальные (включая 3 сцены панели и все прочие диалоги) — побайтово прежние | `golden:verify` — все `passed`, эталоны в индексе принятые |
+| AC8 | размер назван (+516 Б до initial View), лист набора ушёл в ленивый граф, а не в `cardStyles` | `bundle:budget` зелёный под потолком; `grep form-kit` — не встречается в `src/styles.ts`/`houseplan-card.ts`; `styles-split.test.mjs` подтверждает пятёрку каскада неприкосновенной |
+| AC9 | `src/summary-panel-*` в диффе отсутствуют | `git diff --stat` — подтверждено; оба смока панели зелёные без правок |
+| AC10 | полный набор зелёный | tsc/test/build — подтверждено Validate на этом SHA (ссылка в задаче ревью) + сборка вручную идентична; unit/смоки/мутанты/бандл/golden/docs — прогнаны вручную выше, все зелёные |
+| AC11 | генератор с параметрами панели воспроизводит её текущие правила дословно | `test/form-kit.test.mjs` зелёный, плюс лично сверил фрагменты `PANEL_FRAGMENTS` с текстом `src/summary-panel-editor-style.ts` — совпадают |
+
+К1–К7 (контракт поведения) проверены чтением `room-settings-dialog.ts` (см. диф
+в анализе): ключи черновика те же, `hp-color-opacity`/событие те же,
+`_renderRoomSource` переехал в модуль комнаты как единственный потребитель,
+`FILL_CHOICES` типизирован без `as any` (закрывает красный `no-new-any` из
+первого пуша), генератор параметризован скоупом/префиксом.
+
+Трейлеры: все 5 коммитов несут `Issue: #594`; `User-Visible: yes` только на
+`fb361c49`, и в нём же правки обоих changelog (`docs/CHANGELOG.md`,
+`docs/CHANGELOG.ru.md`) и обоих `USER-GUIDE` — проверено `git show --stat` и
+чтением текста, терминология («карточки-группы», «?», переключатель
+«среднее/выбранный датчик») совпадает с формулировками ТЗ и UX-разделом.
+Коммит с эталонами несёт `Release:`/`Baseline-Reviewed:` со ссылкой на реальный
+прогон.
+
+## Что проверено и корректно
+
+- Полный контракт К1–К7 и AC1–AC11 — построчно, включая обе фиксовые правки r1.
+- Golden — впервые в этом раунде подтверждён личным прогоном (не чтением
+  утверждения автора): AC7 закрыт полностью, регрессий вне двух объявленных
+  сцен нет.
+- Отпечаток документации — тоже личным прогоном в строгом режиме.
+- Пять «скрытых» смоков на общих CSS-классах — прогнаны, регрессий нет.
+- Сборка (`bundle:sync`) воспроизводится байт-в-байт из исходников этого SHA —
+  дифф в `dist/**`/`custom_components/houseplan/frontend/**` не является
+  посторонним артефактом.
+- Размер и архитектурное решение (лист в ленивом графе, `unsafeCSS`,
+  параметризованный генератор) соответствуют цифрам, названным в хендоффе, и
+  не расходятся с кодом.
+
+## Чего не проверял и почему
+
+- `npx tsc --noEmit` / `npm test` (весь набор) / `npm run build` как отдельные
+  команды — не перегонял: Validate на этом SHA (`fd33a0dc`) зелёный, дешёвые
+  гейты уже подтверждены; вместо этого пересобрал `bundle:sync`, что тоже
+  прогоняет `tsc --noEmit`+`build` и byte-for-byte сверило дерево — то же самое
+  доказательство другим путём.
+- Полная матрица браузерных смоков (250 файлов) — не прогонял; прогнаны
+  названные в ТЗ, `smoke_render_parity` (прямое совпадение по `cardStyles`) и
+  пять найденных вручную по общим CSS-классам. Остальные 15 «прямых
+  совпадений» инструмента (`smoke_room_autoclose`, `smoke_merge_split`,
+  `smoke_plan_drawing_repairs`, `smoke_unified_wall_tool`,
+  `smoke_v8_draft_write`, `smoke_feedback_v2`, `smoke_island_rooms`,
+  `smoke_junction_limits`, `smoke_wall_face_overlap`,
+  `smoke_wall_thickness_transition`, `smoke_draw_wall_thickness`,
+  `smoke_split_polyline`, `smoke_zero_divider_taper`, `smoke_split_nonsnap`) не
+  прогонял: символы совпадения — это состояние хоста комнаты (`_nameSel`,
+  `_areaSel`, `_curSpaceCfg`, `_saveRoom`, `_pendingSplit`, `_wallFaceBatch`,
+  `_roomDialogCancel`), а не что-то, что этот диф меняет — обработчики кнопок
+  и сигнатуры методов в диффе идентичны прежним (см. `diff2.patch`/`diff3.patch`
+  анализа), меняется только обёртка разметки внутри `.body`. 31 «слабых связей»
+  инструмент сам не считает основанием для прогона.
+- Полный HA-харнесс, перф-профили — не названы в AC и диф не касается
+  чувствительных к перфу путей (только разметка/CSS одного диалога).
+- `python -m pytest tests_backend` — диф не трогает `custom_components/**/*.py`.
+- `npm run invariants` — диф не трогает геометрию/`layout`/`marker.space`/
+  `open_spans`/записи толщины.
+
+## Находки
+
+Нет. Все три Medium из r1 закрыты и подтверждены исполнением; новых дефектов
+в правках r1→r2 (типизация `FILL_CHOICES`, свидетель полей, отпечаток
+документации, приёмка эталонов) и в ребейзе не найдено.
+
+## Унаследовано из r1
+
+Формально этот раздел почти пуст: инструкция для ребейза (§7.2) требует полный
+разбор, поэтому весь код перепроверен заново своими руками (см. выше), а не
+принят на слово документа r1. Единственное, что не переоткрывается сознательно —
+продуктовые решения ТЗ, которые не относятся к предмету код-ревью:
+
+- Само распределение полей по четырём группам, названия групп, решение не
+  трогать ширину диалога и не менять «Сохранить только при изменениях» —
+  приняты на этапе спецификации (`SPEC-REVIEW-594-r3.md`, зелёный вердикт,
+  материал — тело issue #594 на момент коммита `073c45b0`/`63059739`). Код-ревью
+  не переоценивает эти решения, только соответствие им реализации — оно
+  проверено выше по каждому AC.
+
+## Вердикт
+
+Зелёный. Все находки r1 закрыты и подтверждены исполнением; полный повторный
+разбор после ребейза новых дефектов не выявил.
+
+---
+
+<!-- material-anchors: сгенерировано конвейером (#414) -->
+
+## Материал раунда
+
+- Ветка: `issue/594-form-kit-room`, коммит `fd33a0dce3b9` — ребейз его осиротит, и это нормально: ниже якоря, которые ребейз не меняет.
+- Дерево материала: `8fefb135dda0fc5fae81091314c8a16df4fec42c`
+  ```
+  git log --all --format='%H %T' | grep 8fefb135dda0
+  ```
+- Тело issue: `594c7771e678dae203db75069c75806da3eec9c1d9b155a3d7ba2236d338052a`
+- Вердикт конвейера: `green` · High 0