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

# CODE-REVIEW-231-r2

- **Issue:** https://github.com/Matysh/houseplan-card/issues/231
- **ТЗ:** `docs/specs/231-decor-layer-order.md` (зелёный SPEC-REVIEW r2)
- **Диапазон полной задачи:** `git log --oneline origin/dev..HEAD` →
  `e023adb`, `9410be6`, `d2e7626`, `b747316` (продуктовый фикс, `Issue: #231`,
  `User-Visible: yes`), `e943e2f`, `d46abe5`, `6d31553`
- **Диапазон этого раунда (дельта r1→r2):** `b747316..6d31553` — SHA
  предыдущего раунда взят из тела документа r1 (`docs/reviews/CODE-REVIEW-231-r1.md`,
  «Диапазон» и «Как проверялось») и из вердикта r1 в issue (комментарий
  цитирует «на HEAD (`b747316`)»); формальная первая строка вердикта r1 сам
  SHA не называет — это соответствует ожидаемому формату §7.2, находкой не
  является, так как SHA восстанавливается однозначно из тела того же
  комментария и документа
- **Заход:** r2 · блокирующих циклов израсходовано 1 из 4

## Скоуп раунда (по дельте)

`git diff b747316..6d31553 --stat`:

```
 docs/TESTING.md                    |  14 ++-
 docs/reviews/CODE-REVIEW-231-r1.md | 204 +++++++++++++++++++++++++++++++++++
```

Продуктовый код (`src/houseplan-card.ts`, три копии бандла, тесты, smoke,
golden matrix/harness) в дельте не тронут вообще — коммит `d46abe5`
архивирует документ r1 в `docs/reviews/` (публикующий шаг, не авторская
правка), а `6d31553` — единственная содержательная правка автора: расширение
чек-листа `docs/TESTING.md` до полного списка golden-сцен, затронутых #231.
Это ровно и только предмет находки M1 из r1. Дельта локальна: новая
подсистема не затронута, контракт поведения не менялся, бандл не
пересобирался (SHA-256 идентичен r1).

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

| Находка | Чем закрыта | Где это видно |
|---|---|---|
| **M1** (Medium, в скоупе) — список golden-сцен, затронутых переносом decor, называл только 2 новые сцены; 3 существующие large-house сцены (`isometric-large-warm-remount-dark`, `large-house-zoom-250-dark`, `large-house-warm-remount-dark`) реально меняются тем же коммитом, но не были задокументированы, а причина в handoff-комментарии («уже накопленный dev-дрейф») была ошибочной | `docs/TESTING.md` теперь перечисляет все 5 сцен в одном пункте чек-листа и формулирует подтверждённую причину: «The three existing large-house scenes also change because their dense decor grid now renders above Glow-base room fills» — вместо прежней ссылки только на 2 новые сцены без объяснения. Ошибочное объяснение «дрейф dev» не повторено нигде в новом тексте. Требование «reviewed baselines только из Linux release artifact» сохранено для всех пяти сцен | `docs/TESTING.md:46-54` (см. diff выше); текстовая правка причины дополнительно зафиксирована в новом комментарии автора в issue #231 (`IC_kwDOTOcLQM8AAAABQL-q0w`, 2026-08-22 15:53), который прямо отменяет прежнюю формулировку |

Проверил построчно: три id сцен (`isometric-large-warm-remount-dark`,
`large-house-zoom-250-dark`, `large-house-warm-remount-dark`) реальны и
совпадают с определениями в `demo/golden/matrix.mjs:63,364,366` — не
опечатка и не выдуманные имена.

## Унаследовано из r1

Всё, до чего дельта `b747316..6d31553` не дотягивается, принято без
повторной проверки из `docs/reviews/CODE-REVIEW-231-r1.md` @ `b747316`
(`b74731698f664a9b0dc4c187b5b1b05ccf333b61`):

- AC1–AC7 (порядок decor относительно room fill, hover, обоих тоннелей,
  Glow-base, live Glow/солнца/стен/символов/устройств), доказанные
  `demo/smoke_decor_layer_order.mjs`, `demo/smoke_glow.mjs`,
  `demo/smoke_opening_tunnel_fill.mjs`, `demo/smoke_hide_layers.mjs`,
  `demo/smoke_decor.mjs`, `demo/smoke_backdrop.mjs` и мутантом
  `decor-restored-below-room-fills` — код `src/houseplan-card.ts` в дельте не
  менялся, бандл байт-в-байт идентичен (`sha256: baf60c9a89a8…`), поэтому
  повторный прогон этих smoke не может дать новый результат;
- Q1 (владелец) — единый порядок decor без нового persisted-флага;
- AC8 в части структуры двух новых golden-сцен (`decor-over-opaque-hover-light`,
  `decor-over-glow-base-dark`) и их `missing-baseline` статуса — сцены не
  менялись;
- release-артефакты предыдущего коммита: оба changelog, `docs/BACKDROP.md`,
  `docs/DECOR-EDITOR.md`, отпечаток `docs/images/screenshots.json`, три копии
  бандла — не затронуты этой дельтой;
- вывод «AC7/perf» (`oneDecorLayer: true`, отсутствие новых
  groups/observers/listeners) — код не менялся.

## Как проверялось в этом раунде

Дельта не трогает `src/**` и не меняет бандл, поэтому полный целевой набор
smoke/golden из r1 не переисполнялся — прогнаны только дешёвые обязательные
гейты, чтобы подтвердить, что дельта не сломала ничего наследуемого.

### Гейты — обязательная часть (прогнаны все)

| Гейт | Команда | Результат |
|---|---|---|
| Typecheck | `npx tsc --noEmit` | зелёный, без вывода |
| Unit | `npm test` | зелёный, 1070/1070 pass, 0 skip (на этом раннере `gh` доступен, `process-gate.test.mjs` не пропускается) |
| Build + bundle parity | `npm run build`, затем `sha256sum` трёх копий | зелёный, все три `houseplan-card.js` идентичны и совпадают с зафиксированным в r1 хэшем `baf60c9a89a8…` — подтверждает, что дельта не изменила продуктовый вывод |
| Docs fingerprint | `node scripts/check-docs.mjs` | зелёный: «Documentation checks passed (7 files, 10 external links)» — формально не обязателен (дельта не трогает `src/**`), прогнан всё равно как дешёвый, т.к. дельта меняет `docs/TESTING.md` |

### Гейты — по необходимости

Не прогонялись повторно: `demo/smoke_decor_layer_order.mjs`, `smoke_glow.mjs`,
`smoke_opening_tunnel_fill.mjs`, `smoke_hide_layers.mjs`, `smoke_decor.mjs`,
`smoke_backdrop.mjs`, `npm run golden:verify`, `node scripts/mutation-gate.mjs`.
Причина: дельта этого раунда не касается `src/houseplan-card.ts`, тестовых
фикстур, golden-матрицы или mutation-gate — правка ограничена одним
Markdown-чек-листом. Бандл после `npm run build` в этом раунде byte-for-byte
идентичен бандлу r1 (тот же SHA-256), то есть материал, который эти гейты
проверяют, не изменился с r1 ни на бит. Повторный прогон дал бы тот же
результат, что уже запротоколирован в `docs/reviews/CODE-REVIEW-231-r1.md`, и
был бы разбором заново, а не по дельте (PROCESS §2.9).

`python -m pytest tests_backend -q` — не прогонялся, дельта не касается
Python. Performance-профили — не прогонялись, дельта не касается
производительности. Ручного тестирования в браузере не было — не
предусмотрено циклом.

## Находки

Новых находок нет. M1 закрыта полностью (см. «Закрытие раунда r1»).

## Что проверено и корректно

- Список из пяти golden-сцен в `docs/TESTING.md` полный и точный:
  2 новые + 3 существующие large-house сцены, все id проверены по существующей
  golden-матрице (`demo/golden/matrix.mjs:63,364,366`).
- Формулировка причины изменения существующих сцен верна и не противоречит
  разбору r1 (плотная decor-сетка `large-house` теперь рендерится поверх
  Glow-base заливки — прямое следствие переноса слоя, не побочный дефект).
- Правило «reviewed baseline только из Linux release artifact» сохранено для
  всех пяти сцен без исключений.
- Продуктовый код, тесты, smoke и golden-матрица не изменены этой дельтой —
  подтверждено идентичностью SHA-256 бандла и отсутствием diff вне
  `docs/TESTING.md` и архивного `docs/reviews/CODE-REVIEW-231-r1.md`.
- Трейлеры коммитов дельты (`d46abe5`, `6d31553`) — `Issue: #231`,
  `User-Visible: no`; верно, так как правка касается только внутреннего
  тест-плана, не пользовательского поведения — changelog не требуется.

## Чего не проверял

- Полный browser-smoke набор и целевые smoke из r1 (`smoke_decor_layer_order.mjs`,
  `smoke_glow.mjs`, `smoke_opening_tunnel_fill.mjs`, `smoke_hide_layers.mjs`,
  `smoke_decor.mjs`, `smoke_backdrop.mjs`) — не перепрогонялись в этом раунде,
  наследуются из r1 (см. «Унаследовано из r1»); дельта их не касается, бандл
  идентичен.
- `npm run golden:verify` и `mutation-gate` — не перепрогонялись, дельта не
  меняет рендер, геометрию, тестовые фикстуры или мутантные патчи.
- `pytest tests_backend` — не прогонялся, дельта не касается Python.
- Полный Linux golden-артефакт и его reviewed-принятие — вне цикла код-ревью
  (предрелизный шаг, §13 PROCESS.md), в этом раунде сам список сцен для
  будущего принятия проверен и признан полным.