# CODE-REVIEW-377-r2 - Issue: https://github.com/Matysh/houseplan-card/issues/377 - Заход: r2 (номер — для имени документа; предыдущий код-ревью, r1, был зелёным и цикл не тратил, см. §4/#227) - Ветка: `issue/377-decor-default-persist`, HEAD `82d710f1` - SHA материала ревью: `82d710f160d8572ef6687499c4b8acdc7995ed45` (`git rev-parse HEAD`) - Диапазон: `git diff origin/dev...HEAD` — `origin/dev` = `720200e3` (текущий тип), 43 файла, +1008/-488 ## Почему это ПОЛНЫЙ разбор, а не разбор по дельте Между r1 и r2 ветка была **ребейзнута на ушедший вперёд `dev`**: r1 вынесен на материале `2edaf1adac60f9939b836da87f5f1f549dab2548` — этого объекта в репозитории больше нет (`git cat-file -t` → `fatal: could not get object info`), он выпал при ребейзе. Автор сам зафиксировал это в issue сразу после публикации r1: «Пока шло ревью, `dev` продвинулся на 7 коммит(ов)... слияние приведёт ветку к dev, и это другой код (§7.2)» и следом провёл ребейз, затянувший в базу #373 (`feat: add tight house framing to space card`, `0d33691f`). Это ровно исключение из инструкции («ребейз на ушедший вперёд dev — после ребейза это другой код»), поэтому объём разбора в r2 — полный, а не только по находкам r1 (которых, забегая вперёд, и не было ни одной блокирующей). `git merge-base HEAD origin/dev` = `origin/dev` — ветка полностью лежит на текущей вершине `dev`, конфликтов нет, `git grep '<<<<<<<'` по дереву чист. ## Скоуп Без изменений с r1: персист серверного ключа `settings.decor_default_style` (цвет/стиль декора «по умолчанию» из тулбара Background-редактора, #360) — переживает перезагрузку, общий для всех редакторов плана. Три поверхности: схема (`validation.py`), инициализация (`houseplan-card.ts`), запись (`houseplan-editor-runtime.ts`). ## Как проверялось Два независимых источника уверенности, оба обязательны для полного разбора после ребейза: **1. Текстовое сличение продуктового кода #377 «было vs стало».** Для каждого из файлов, которые правит именно #377 (`validation.py`, `src/editors/decor/geometry.ts`, `src/houseplan-card.ts`, `src/houseplan-editor-runtime.ts`, `test/decor-style-persist.test.mjs`, `demo/smoke_decor_default_persist.mjs`, `tests_backend/test_validation.py`) взял текущий `git diff origin/dev...HEAD` построчно и сверил его с тем, что описывает и цитирует `docs/reviews/CODE-REVIEW-377-r1.md` (сам файл — часть этого диапазона, довезён ребейзом через cherry-pick, как и написал автор). Совпадает дословно: тот же маппинг 6 полей в `decorStyleFromSettings`/ `decorStyleToSettings`, тот же `_seedDecorStyle` (единственный сдвиг — номера строк из-за более раннего кода, добавленного #373 в этом же файле), тот же `_updateDecorStyle`/`_persistDecorStyle` с дебаунсом 1000 мс и все шесть UI-точек, переведённые на него, та же схема `validation.py`, тот же набор из 10 мусорных вариантов + `"solid"` в pytest, тот же смок. Значит семантика правки не изменилась — только база под ней. **2. Проверка, что ребейз безопасен по существу**, а не только по отсутствию текстовых конфликтов: `#373` (единственный feat-коммит, затянутый в базу между r1 и r2) правит только `src/space-geometry.ts` — три новых экспорта (`resolveSpaceCardFit`, `itemOfGeometry`, `expandItem`, `structuralFrame`), все аддитивные, используются только `src/space-card.ts`. Ни один из файлов #377 (`houseplan-card.ts`, `houseplan-editor-runtime.ts`, `editors/decor/geometry.ts`, `validation.py`) не пересекается с диффом #373. Разобрано чтением: общих символов между двумя изменениями нет, путь записи декора (`_updateDecorStyle` → `_saveConfig` → `expected_rev`) и путь фрейминга space-card не имеют точек соприкосновения. **3. Гейты — прогнаны заново лично на актуальном SHA** (зелёного Validate на `82d710f1` нет — см. плашку задачи), поскольку старый прогон r1 стоял на объекте, которого больше не существует, и переносить его результат без повторного прогона на новой базе было бы недопустимо. ### Гейты — прогнал сам | Гейт | Команда | Результат | |---|---|---| | Typecheck | `npx tsc --noEmit` | чисто | | Юниты | `npm test` | 1567 pass / 0 fail / 1 skipped (совпадает с заявкой автора после ребейза: «юниты 1567/0») | | Сборка | `npm run build` | ok, 9.6s | | Синхронизация бандлов | `npm run bundle:sync` | ok; `git status --porcelain` после — пусто (три копии дерева байт-в-байт совпадают с закоммиченными) | | Бюджет | `npm run bundle:budget` | initial View 277 310 Б / 300 000 (запас 22 690 Б) — байт-в-байт совпадает с заявкой автора после ребейза | | Доки | `node scripts/check-docs.mjs` | «Documentation checks passed (7 files, 10 external links)» — diff трогает `src/**` (в т.ч. через #373), гейт обязателен и зелёный. Отпечаток скриншотов (`sourceFingerprint`) обновлён коммитом `40ba222a` вместе с 10 канонических PNG — ожидаемо: любая правка `src/**` делает старый отпечаток устаревшим, а #373 такую правку внесла | | Backend (чистое подмножество) | `python -m pytest tests_backend -q --ignore=tests_backend/test_coordinate_canonicalization.py` (после `pip install pytest voluptuous`) | 235 passed, 1 skipped — совпадает с заявкой автора и с r1. `test_coordinate_canonicalization.py` падает на отсутствующем `homeassistant` при коллекции — не связано с #377, гейт CI | | Единственный источник числа | `node --test test/single-source-numbers.test.mjs` | 3/3 pass | | Мутанты (только новые, точечно `--id=`) | `mutation-gate.mjs --id=decor-default-style-seed-cut` и `--id=decor-default-style-debounce-cut` | оба «поймано 1 из 1» — тесты умеют падать | Полный `mutation-gate.mjs` без `--id=` не гонял — та же причина, что в r1: несоразмерно точечной правке, к тому же в этом окружении падает на несвязанном backend-guard'е (нет `homeassistant`). ### Смоки — `scripts/smoke-select.mjs --base origin/dev --head HEAD` Инструмент на актуальном диапазоне дал те же 7 «прямых совпадений» и те же 13 «слабых связей» (единое имя `_saveConfig`), что и в r1 — состав диффа #377 не изменился, поэтому выбор не изменился. Прогнал все 7 прямых совпадений — все OK: `smoke_decor_default_persist` (AC4/AC5), `smoke_bg_color`, `smoke_color_picker`, `smoke_decor`, `smoke_dialog_zombie`, `smoke_furniture`, `smoke_general_settings`. Из 13 слабых связей прогнал `smoke_config_writer` (та же, что в r1 и что заявлял автор) — OK. Остальные 12 не гонял: diff #377 по-прежнему не трогает геометрию/стены/толщину, а #373 (единственное новое в базе) отдельно проверено на отсутствие пересечения файлов (см. выше) — обоснование переносится из r1 без изменений. `npm run invariants` не требовался — diff #377 не трогает рёбра комнат, `layout`, `marker.space`, `open_spans` или записи толщины. `npm run golden:verify` не гонял: продуктовый код #377 не рендерит View (`_decorStyle` управляет только дефолтом для новых объектов декора/мебели в редакторе, не View) — это не изменилось с r1. Визуальные изменения в диапазоне (10 канонических PNG) целиком принадлежат #373 (fit-to-content пространства) и уже прошли отдельный цикл ревью этой задачи (`docs: review document for #373`, трижды в истории `dev`) — повторно ревьюить чужой змерженный и принятый результат в рамках #377 не требуется. ## Закрытие раунда r1 | Находка r1 | Чем закрыта | Где видно | |---|---|---| | Low: `_updateDecorStyle` заводит свой `setTimeout(1000)` и не флашит его в `disconnectedCallback` | Не чинилась — r1 снял находку без правки как приемлемый риск (цена ошибки мала, штатный `disconnectedCallback` не единственный путь доставки таймера) | `houseplan-editor-runtime.ts:9403-9411` (номера строк сдвинуты ребейзом, код идентичен); решение зафиксировано в `docs/reviews/CODE-REVIEW-377-r1.md`, раздел «Находки» | High/Medium-находок в r1 не было — таблица закрытия по ним пуста, возврата на правки не было. ## Унаследовано из r1 Полностью, без переоткрытия по существу, наследуется анализ AC1–AC7 и раздел «Что проверено и корректно» из `docs/reviews/CODE-REVIEW-377-r1.md` (SHA материала того ревью: `2edaf1adac60f9939b836da87f5f1f549dab2548`, документ смёржен в ветку cherry-pick'ом при ребейзе) — построчная сверка выше (раздел «Как проверялось», пункт 1) подтвердила, что продуктовый код #377 между r1 и r2 не изменился ни на символ, изменилась только база под ним. В частности без повторной сверки по существу приняты: - маппинг snake_case↔camelCase в `decorStyleFromSettings`/ `decorStyleToSettings` и соответствие ТЗ п.7; - логика однократного посева `_seedDecorStyle` из кэша и первого серверного ответа, не переоткрывающая живую сессию; - то, что запись идёт исключительно штатным сериализованным путём (`_saveConfig` → `_saveConfigDebounced` → `_writeConfig` → `_sendConfigCandidate` с `expected_rev`); - то, что все шесть UI-точек изменения стиля переведены на `_updateDecorStyle` (сверка «ни одна не забыта» из r1); - разбор AC6 через чтение `import_export.py` (путь `settings` для non-same-source импорта не трогает `decor_default_style`); - разбор AC7 (недостижимость в холодном View — код рантайма грузится лениво и нигде вне него `_decorStyle` не пишется). Не наследуется, а перепроверено заново в r2: все автоматические гейты (иной SHA — не тот же прогон), совместимость с #373 (новое в базе, r1 об этом знать не мог), актуальность отпечатка скриншотов документации. ## Находки Новых находок в r2 нет. High/Medium — 0. **Low (унаследована из r1, по-прежнему снята без правки).** См. таблицу «Закрытие раунда r1» выше — код не менялся, довод не изменился. **Наблюдение вне находок.** Коммит `40ba222a` (`build: refresh bundle trees for #377; align the color-picker contract`) помимо ожидаемого пересбора бандлов и обновления `test/color-picker.test.mjs:67` (замена ожидаемого паттерна `this._decorStyle = {...}` на `this._updateDecorStyle({...})` — тест синхронизирован с уже существующим кодом `feat`-коммита, а не наоборот: сверено, что `houseplan-editor-runtime.ts` действительно вызывает `_updateDecorStyle` в этом месте с самого `feat`-коммита `10a1a266`). Это задним числом закрывает пробел покрытия, оставленный в `feat`-коммите (тест не был обновлён вместе с кодом), но не меняет поведение и не затрагивает AC — не поднимаю до Low, так как ошибки не произошло: `npm test` был бы красным до этого коммита, и это увидели бы до публикации ветки на ревью, что и произошло (гейт-перегон автора после ребейза). ## Что проверено и корректно (специфично для r2) - Ребейз чист: `git merge-base HEAD origin/dev` = `origin/dev`, маркеров конфликта нет. - Диапазон #377 (файлы, диффы, коммиты) не пересекается по файлам с #373 — проверено построчным чтением диффа #373. - Все гейты, зелёные в r1, остаются зелёными на новой базе; числовые показатели (юниты, backend, бюджет бандла) совпадают с тем, что заявил автор в двух комментариях после ребейза («юниты 1567/0», «бюджет 277 310/300 000»). - Трейлеры (`Issue: #377`, `User-Visible`) на месте во всех 4 коммитах диапазона; `feat`-коммит (`User-Visible: yes`) правит оба changelog и оба USER-GUIDE в себе же, не отдельным коммитом. - `docs/reviews/CODE-REVIEW-377-r1.md` присутствует в дереве как обычный файл истории ревью, довезённый ребейзом — само по себе не находка. ## Чего не проверял - Заново — семантику продуктового кода #377 построчно «с нуля»: сверил текстовым сличением с уже проверенным в r1 кодом (см. «Как проверялось», п.1) вместо повторного независимого прочтения каждой строки — обоснование выше (§7.2 требует полноты разбора при таком ребейзе, но не требует игнорировать то, что код внутри диапазона #377 доказуемо не менялся). - Визуальную корректность фрейминга space-card (#373) — чужая, уже принятая задача, вне скоупа #377. - Полный `npm run golden:verify` и полный `demo/smoke_*.mjs` (все ~204) — не оправдано объёмом правки #377; обоснование — выше. - Полный HA backend harness (`test_ha_*.py`, `test_coordinate_canonicalization.py`) — недоступен в этом окружении (нет `homeassistant`), гейт CI/бета, расхождение не связано с #377. - Живое ручное тестирование в браузере — замещено чтением кода и прогоном автотестов/смоков. - Гонку двух вкладок (#340) — не тронута этой задачей, отдельно не воспроизводил, как и в r1. ## Вердикт Ребейз на ушедший вперёд `dev` потребовал полного разбора (§7.2): проведена как текстовая сверка продуктового кода #377 «было vs стало» (не изменился ни на символ), так и проверка отсутствия пересечения с тем, что реально привнёс новый `dev` (#373 — аддитивные, несвязанные файлы). Все 7 AC доказаны — унаследовано из r1 с подтверждением, что доказательство всё ещё соответствует коду. Все гейты, соразмерные объёму задачи, прогнаны заново на актуальном SHA и зелёные. High/Medium-находок нет, одна Low унаследована из r1 и остаётся снятой без правки. Вердикт: зелёный · заход r2 · блокирующих циклов 0/4 · High: 0 · Medium: 0 Готово к очереди на пре-релиз.