docs: code review r2 for #146

Issue: #146
User-Visible: no

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

@@ -0,0 +1,133 @@
+# Code review — issue #146, цикл r2
+
+Вердикт: **зелёный** · цикл r2/4 · High: 0 · Medium: 0
+
+Ветка: `issue/146-four-phase-sun-background` · коммиты в диапазоне
+`origin/dev..HEAD`: [`558dae9`](https://github.com/Matysh/houseplan-card/commit/558dae95cd8fa011250c69efad76d09bc8d0abcc)
+(спека, не код), [`debb13b`](https://github.com/Matysh/houseplan-card/commit/debb13baa280042c79a004c97152e3b1be5ab11b)
+(implementation, разобран в [`CODE-REVIEW-146-r1`](CODE-REVIEW-146-r1.md),
+красный, High:1), [`84cd5f9`](https://github.com/Matysh/houseplan-card/commit/84cd5f9)
+(документ r1, не код), **[`875b09c`](https://github.com/Matysh/houseplan-card/commit/875b09cd8d9dc5ea9fed4abc7b8fce23087ecc77)
+— единственный новый код с прошлого ревью, предмет этого цикла.**
+
+## Скоуп проверки
+
+Цикл r1 закончился красным вердиктом с единственной блокирующей находкой:
+`.zoomwrap { z-index: 1 }` (добавлен диффом #146) выводил всё содержимое
+`.zoomwrap` в более высокий слой стекинга, чем `.zoombadge` — индикатор
+процента зума становился невидим на любом zoom>100% независимо от `bg_mode`.
+Требование r1: убрать не обязательную для цели правку `z-index` **или** дать
+`.zoombadge` собственный явный `z-index`, подтвердить `npm run golden:verify`
+на сцене `large-house-zoom-250-dark` и просмотреть 4 новых `day-cycle-*` сцены.
+
+Коммит `875b09c` — единственное изменение с r1: `git show 875b09c --stat`
+подтверждает 7 файлов — `src/styles.ts` (−1 строка, ровно
+`z-index: 1` с `.zoomwrap`), `demo/smoke_bg_color.mjs` (+13 строк — новая
+проверка `zoomBadgeStaysAbovePlan`), оба changelog (+3/+3 строки) и три копии
+бандла. Backend, `src/sun.ts`, `day-cycle-render.ts`, i18n, тесты миграции —
+не тронуты; повторной проверки AC1–AC16 из r1 по существу не требуется —
+менялась ровно строка, вызвавшая High, и один целевой smoke-assert.
+
+Трейлеры коммита `875b09c`: `Issue: #146` · `User-Visible: yes`; оба
+changelog правлены в этом же коммите — требование выполнено.
+
+## Как проверялось
+
+| Гейт | Результат |
+|---|---|
+| `npx tsc --noEmit` | зелёный, без вывода |
+| `npm test` | **802/802 green** |
+| `npm run build` + сверка 3 копий (`dist/`, `custom_components/houseplan/frontend/`, `demo/srv/assets/`) | зелёный; свежая пересборка дала SHA-256 `1cde21df3c8fefc7d6b4b48067261e8141f86dd3b998a293412be0a74f468690` для всех трёх файлов — совпадает с хендофф-комментарием автора; `git status` после билда пуст (закоммиченные копии побайтно совпадают со свежей сборкой) |
+| `node demo/smoke_bg_color.mjs` | все проверки `true`, `OK`, включая новую `zoomBadgeStaysAbovePlan: true` |
+| `npm run golden:verify` (полный набор — инструмент не даёт частичный прогон) | **`large-house-zoom-250-dark` → `passed`** (детерминированно, два прогона подряд). Именно эта сцена была `different` на `debb13b` в r1 — прямое эмпирическое подтверждение, что находка r1 устранена, не только прочитана. Остальные не-`passed` сцены — тот же набор, что r1 уже задокументировал как пред-существующий шум/техдолг, не относящийся к #146 (см. ниже) |
+| `python -m pytest tests_backend` | не прогонялся — коммит `875b09c` не трогает ни один файл `custom_components/**/*.py`; backend уже разобран чтением в r1 и не менялся |
+| `smoke_sun.mjs`/`smoke_sun_live_bg.mjs`/`smoke_general_settings.mjs`/`smoke_render_perf.mjs` | не перезапускались в r2 — ни одна из этих поверхностей не тронута коммитом `875b09c` (изменён только `smoke_bg_color.mjs`); все были зелёными в r1 на неизменной с тех пор реализации |
+| Полный smoke-suite (127 файлов) / performance-профили / `golden:accept` | не прогонялись — предрелизный гейт (PROCESS.md §8, §11.4), диапазон изменения (одна CSS-строка) не оправдывает полный прогон |
+
+### Разбор `golden:verify`
+
+Не-`passed` сцены в этом прогоне и их статус в r1 (на `debb13b`, до фикса):
+
+- `day-cycle-dawn-dark`/`day-cycle-day-dark`/`day-cycle-dusk-dark`/`day-cycle-night-dark` — `missing-baseline` в r1 и сейчас; ожидаемо, 4 новые сцены ждут `golden:accept --reviewed` как предрелизный шаг.
+- `geometry-plan-editor-dark`, `tray-wide-selection-en`, `tray-wide-tool-ru`, `tray-medium-group-en` — `different` в r1 и сейчас; r1 сверил их с чистым `origin/dev` (та же среда/Chromium) и получил те же расхождения там, где `#146` вообще не применён — пред-существующая среда-специфичная нестабильность, не относящаяся к этой задаче. Коммит `875b09c` не трогает ни редактор плана, ни tray-компоненты.
+- `plan-snap-endpoint-light`, `plan-snap-line-gaps-dark`, `wall-junctions-plan-preview-light`, `wall-junctions-plan-t-dark`, `wall-junctions-view-dark`, `isometric-wall-junctions-dark` — `missing-baseline` в r1 и сейчас, тот же техдолг.
+- `large-house-zoom-040-dark`, `large-house-warm-remount-dark` — `passed` (соседние zoom/remount-сцены не пострадали ни в r1, ни сейчас).
+
+Единственное отличие итогового набора между r1 и r2 — переход
+`large-house-zoom-250-dark` из `different` в `passed`. Это ровно тот регресс,
+который блокировал r1.
+
+## Находки
+
+Нет. High r1 устранён и подтверждён эмпирически (golden) и по коду (см. ниже).
+Новых High/Medium/Low коммит `875b09c` не вносит.
+
+## Что проверено и корректно
+
+- **Устранение High r1.** `src/styles.ts:181-184` — `.zoomwrap` больше не
+  несёт `z-index`, только `position: absolute; inset: 0;`. Прочитан рендер:
+  `src/houseplan-card.ts:14472` (`renderDayCycleEnvironment`, включает
+  `.hp-day-cycle-env` c явным `z-index: 0`, `src/styles.ts:200-207`)
+  декларируется в DOM **раньше** `.zoomwrap` (`:14474`), а `.zoombadge`
+  (`:14758-14760`) — сиблинг **после** закрытия `.zoomwrap` (`:14757`).
+  По правилам CSS-стекинга элементы с `z-index: auto` и `z-index: 0`
+  красятся в одном слое, упорядоченном по DOM tree order — значит
+  `.hp-day-cycle-env` (z-index:0, раньше в DOM) красится первым,
+  `.zoomwrap` (auto, позже) поверх него, `.zoombadge` (auto, ещё позже) —
+  поверх `.zoomwrap`. Явный `z-index:1` действительно был не нужен для
+  заявленной цели (держать план выше окружения) — естественный порядок DOM
+  уже её обеспечивает, как и указал r1.
+- **Новая проверка `demo/smoke_bg_color.mjs:105-116`
+  (`zoomBadgeStaysAbovePlan`)** — материализует `_zoom = 2.5`, проверяет три
+  факта разом: `.zoombadge` существует, `getComputedStyle(zoomWrap).zIndex
+  === 'auto'` (прямая механическая проверка отсутствия регрессирующего
+  правила — при возврате `z-index: 1` эта проверка немедленно становится
+  `false`) и `.zoombadge` идёт в DOM после `.zoomwrap`
+  (`compareDocumentPosition & DOCUMENT_POSITION_FOLLOWING`). Тест умеет
+  падать: `checkAll`/`finish` (`demo/serve.mjs:24-40`) требуют `true` от
+  каждого ключа и выставляют `process.exitCode = 1` со списком провалов при
+  любом `false` — попытка временно вернуть `z-index: 1` для эмпирической
+  проверки была отклонена системой прав (ревьюеру запрещено править
+  продуктовый код, `src/styles.ts` — класс A), поэтому падение теста
+  подтверждено **чтением** логики ассерта; сам регресс при этом уже был
+  эмпирически пойман и задокументирован в r1 (`different` на `debb13b`) и
+  эмпирически подтверждён устранённым в этом цикле (`passed` на `875b09c`,
+  см. таблицу гейтов) — то есть внешний golden-гейт уже дал то самое
+  «умеет падать» для базового сценария, который и защищает новый smoke-assert.
+- **Changelog.** `docs/CHANGELOG.md`/`docs/CHANGELOG.ru.md` дополнены в том же
+  коммите фразой о сохранении видимости индикатора масштаба при увеличении;
+  термин не изобретён — `docs/USER-GUIDE.ru.md` не вводит отдельного названия
+  для этого индикатора (только общие «масштаб»/«масштаб просмотра»), а
+  формулировка описывает наблюдаемое поведение, а не внутреннюю реализацию.
+- **Отсутствие побочных эффектов фикса.** `git show 875b09c` полностью
+  прочитан: помимо удаления одной строки CSS и добавления одного
+  smoke-ассерта, изменений в логике (`src/sun.ts`, `day-cycle-render.ts`,
+  `houseplan-card.ts` behaviour, backend) нет — риска регрессии в остальных
+  AC1–AC16 из r1 нет по построению диффа.
+
+## Чего не проверял
+
+- **`npm run golden:accept -- --reviewed`** — не выполнялся; 4 новых
+  `day-cycle-*` сцены остаются `missing-baseline` до предрелизного принятия
+  baseline (PROCESS.md §8/§13) — не гейт код-ревью.
+- **`python -m pytest tests_backend`** — не прогонялся; коммит `875b09c` не
+  трогает backend, а backend-логика уже разобрана чтением в r1.
+- **Полный browser smoke-suite (127 файлов) и Performance/Full Performance**
+  — не прогонялись; изменение узкое (1 строка CSS + 1 smoke-ассерт), не
+  задевает поверхности, которые покрывают остальные 126 smoke или
+  performance-профили.
+- **`smoke_sun.mjs`/`smoke_sun_live_bg.mjs`/`smoke_general_settings.mjs`/
+  `smoke_render_perf.mjs`** — не перезапускались в r2; не тронуты коммитом
+  `875b09c`, были зелёными на этой же реализации в r1.
+- **Ручной интерактивный проход в браузере (не headless)** — не выполнялся;
+  визуальное подтверждение опирается на golden-пиксели (эмпирически поймали
+  и подтвердили исчезновение/возврат `.zoombadge`) и чтение CSS/DOM-порядка.
+
+## Итог
+
+High: 0, Medium: 0, Low: 0. Единственная блокирующая находка r1 устранена
+минимальным, точечным диффом; фикс подтверждён и эмпирически (сцена
+`large-house-zoom-250-dark` вернулась в `passed`), и чтением кода
+(объяснение, почему явный `z-index` не требовался). Скоуп не расширен:
+изменения ограничены строкой, вызвавшей регресс, плюс тестом и changelog.
+Вердикт: зелёный, задача готова к очереди на пре-релиз (`S8-merged`).