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

Code review — issue #146, цикл r2

Вердикт: зелёный · цикл r2/4 · High: 0 · Medium: 0

Ветка: issue/146-four-phase-sun-background · коммиты в диапазоне origin/dev..HEAD: 558dae9 (спека, не код), debb13b (implementation, разобран в CODE-REVIEW-146-r1, красный, High:1), 84cd5f9 (документ r1, не код), 875b09c — единственный новый код с прошлого ревью, предмет этого цикла.

Скоуп проверки

Цикл 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).