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

CODE-REVIEW-383-r2

• Issue: #383 — плавные трансформации и зеркалирование мебели
• SHA материала: b1b1e7439b5e0e20bfa47c316065c814ec534070 (ветка issue/383-furniture-transform, ребейзнута на origin/dev = 95115de2b... (docs: review document for #385))
• ТЗ: docs/specs/383-furniture-transform.md, ревью ТЗ зелёное (SPEC-REVIEW-383-r1, aa1b9e39)
• Заход: r2 · блокирующих циклов израсходовано 1/4
• Вердикт: зелёный (см. итог)

Почему разбор в этом заходе ПОЛНЫЙ, а не только по дельте M1

Формально между r1 и r2 в задаче случилось два события:

1. Автор закрыл M1 (устаревший отпечаток скриншотов) отдельным коммитом b1b1e743 — это чистая, локальная дельта (только docs/images/**).
2. Но перед этим ветка была повторно ребейзнута на ушедший вперёд dev: r1 проверял 8f34c594 (база fbbea475), а текущая ветка стоит на 95115de2 — между базами легли fbbea475→…→95115de2, в том числе два реальных fix-коммита по #385 (223f499e, e561e5fc), трогающие src/houseplan-editor-runtime.ts и custom_components/houseplan/import_export.py — те же файлы, что и #383.

Инструкция прямо называет это одним из случаев, где сокращать анализ до дельты нельзя: «ребейз на ушедший вперёд dev — после ребейза это другой код». Поэтому я не ограничился строкой «M1 закрыт» и таблицей соответствий, а заново прочитал весь диф #383 к origin/dev и заново прогнал гейты на текущем SHA. Ниже — это полный разбор; таблицы «Закрытие r1» и «Унаследовано из r1» идут отдельными разделами в конце, как требует формат.

Скоуп диффа (git diff origin/dev...HEAD, без сгенерированных бандлов)

Список файлов не изменился относительно r1 (я сверил построчно): один логический коммит с продуктовым кодом (686557c5, после ребейза), плюс докс/ревью-коммиты и коммит b1b1e743 (только docs/images/** + docs/images/screenshots.json).

• src/furniture.ts — resizeFurnitureTransform, furnitureRotationAngle, furnitureRenderTransform, furnitureSignedFieldCm/Value (прочитано целиком заново в этом раунде).
• src/houseplan-editor-runtime.ts, src/houseplan-card.ts — furniture-ветка в _dtMove, новый _decorApplyFurnitureBox, четыре средние ручки, невидимый select hit-path, диалог свойств.
• src/editors/decor/types.ts — flip_h?/flip_v?.
• src/styles/plan.styles.ts — курсоры, hit-path.
• src/i18n/{en,ru,de,fr}.json.
• custom_components/houseplan/validation.py, import_export.py.
• Тесты: test/furniture.test.mjs, furniture-transform-contract.test.mjs, furniture-stroke-contract.test.mjs, coordinate-canonicalization.test.mjs, golden-matrix.test.mjs, demo/golden/{matrix,harness}.mjs, demo/smoke_furniture.mjs, tests_backend/{test_validation, test_ha_import_export,test_coordinate_canonicalization}.py.
• Документация: docs/{FURNITURE,USER-GUIDE,USER-GUIDE.ru,CANVAS, DECOR-EDITOR,ARCHITECTURE,TESTING,CONFIG-COMPATIBILITY,CHANGELOG, CHANGELOG.ru}.md, плюс docs/images/** (M1).
• Не задето: src/editors/decor/geometry.ts — подтверждено повторно.

Проверка на взаимодействие с рёбейзнутыми коммитами. Прочитал оба привнесённых dev-коммита (223f499e, e561e5fc, оба про маркер-диалог #385) построчно: правки лежат внутри _renderMarkerDialog (радио/кандидаты привязки, value_badge/value_source), furniture-код — в _dtMove, _decorApplyFurnitureBox, диалоге свойств decor и _DECOR_KIND_FIELDS/ DECOR_SCHEMA. Пересечения по функциям и по строкам нет; ребейз прошёл без конфликтов в исходниках (конфликтовали только сгенерированный бандл и changelog — подтверждено автором и это видно по git log: коммит 0d5d2896 — публикация ревью r1 — стоит поверх 686557c5, то есть исходники не переписывались вручную). Риск «новая подсистема» снят.

Как проверялось

Важная оговорка о CI-сигнале. В контексте этого раунда было заявлено, что Validate на b1b1e743 зелёный и поэтому tsc/test/build можно не перегонять. Я проверил это через gh run view и обнаружил, что заявление формально верно (conclusion: success), но вводит в заблуждение по существу: job'ы Фронтенд, Golden, Смоки, Backend, Hassfest, HACS в этом раннe — skipped, а не success. Причина механическая: changes job классифицирует файлы диапазоном BEFORE_SHA..HEAD_SHA, где BEFORE_SHA — это 0d5d2896 (предыдущий тип этой же ветки, коммит с текстом ревью r1), а не origin/dev. Пуш b1b1e743 добавил только docs/images/**, поэтому changes.outputs.frontend=false, и frontend/golden/smoke/backend получили каскадный skip как зависимые от frontend/changes job'ы (в GitHub Actions needs-зависимость от skipped-job делает зависимую job тоже skipped). Реально прогнали и успешно завершили свежий фронтенд-набор только для 8f34c594 (прошлый SHA, run 33301868911, Фронтенд: success, но conclusion: failure из-за docs+golden), а его исходники, по пункту выше, идентичны текущим 686557c5. Единственный реально свежий гейт на b1b1e743 — preflight (docs+provenance+process-gate) — тот самый шаг, который закрывает M1, и он зелёный.

Итог: раз «зелёного Validate именно по нужным job'ам на этом SHA» нет, я прогнал дешёвые и целевые гейты сам — это ровно предписанный процессом fallback, не сверх него.

Гейт	Команда	Результат
typecheck	npx tsc --noEmit	PASS, без вывода (5.9s)
unit	npm test	PASS — 1604 passed, 0 failed, 1 skipped (совпадает с хендоффом автора)
build	npm run build	PASS; git status --porcelain пуст после сборки — комитнутый dist/** уже побайтово актуален
bundle:sync (3 копии)	npm run bundle:sync	PASS; git status --porcelain пуст после — dist/, custom_components/houseplan/frontend/, demo/srv/assets синхронны
cmp entry	cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js	идентичны
bundle:budget	npm run bundle:budget	initial View 279147 B gzip, budget 300000 B, запас 20853 B — в допуске (то же число, что видел r1: +1160 B от базового)
new-any	node scripts/no-new-any.mjs --base origin/dev --head HEAD	PASS — 362 добавленные строки, 5 файлов, новых any нет
check-docs (diff трогает src/**)	node scripts/check-docs.mjs	PASS — Documentation checks passed (7 files, 10 external links). Плюс независимое подтверждение через CI preflight на b1b1e743 — реально исполнялся, не переиспользован
backend, чистый субнабор	python3 -m pytest tests_backend/test_validation.py -q (после pip install pytest voluptuous, т.к. песочница голая)	PASS — 142 passed, 1 skipped
backend, HA-зависимые модули	python3 -c "import homeassistant" → ModuleNotFoundError	Недоступны в этой песочнице; воспроизвёл, что тот же импорт падает и на неизменённом custom_components/houseplan/__init__.py (from homeassistant.components.frontend import add_extra_js_url) — ограничение среды, не диффа. test_ha_import_export.py/test_coordinate_canonicalization.py разобраны чтением (см. AC10 ниже)
smoke, целевой	node demo/smoke_furniture.mjs (после bundle:sync)	PASS — все ключи true, OK
smoke-select	node scripts/smoke-select.mjs --base origin/dev --head HEAD	13 прямых совпадений, 30 слабых связей — идентично r1 (исходники не менялись)
smoke, прямые совпадения (12 из 13 сверх furniture)	node demo/smoke_{decor,grid_snap,decor_text,drag_bounds,furniture_polish,hide_layers,junction_limits,live_text,active_chain_ink,infinite_canvas,junction_holes,wallthick_standalone}.mjs	11/12 PASS; smoke_infinite_canvas — один под-чек backendAcceptsFarPayload красный по той же причине отсутствия homeassistant (проверено: тот же провал воспроизводится на неизменённом validation.py)
golden (пиксели)	не прогонялся	Предрелизный гейт по §8/§11.4, как и в r1; статические контракты сценариев (id, 9 handles, 4 dtedge) проверены npm test → golden-matrix.test.mjs (PASS, 44/44) и новым ассертом в demo/golden/harness.mjs (decorSelection → проверка 9/4 хендлов)
model-invariants	не прогонялся	Дифф не касается rooms/wall-thickness/layout/marker.space/open_spans — furniture x/y/w/h/angle/flip_* decor-геометрия объекта, инварианты #254 к ней не адресуются (то же основание, что в r1)
performance	не прогонялся	Не назван в AC отдельно от bundle:budget; предрелизный гейт

Прочитано заново (не только унаследовано из r1)

• src/furniture.ts целиком — resizeFurnitureTransform (crossing/flip-XOR логика, минимум 0.1 см, сохранение мирового anchor), furnitureRotationAngle (детерминированное округление половинного шага), furnitureRenderTransform (порядок rotate(...) translate(...) scale(...) — mirror применяется в локальном боксе до поворота, как того требует ТЗ §6).
• src/houseplan-editor-runtime.ts: furniture-ветка _dtMove (resize и rotate), _decorApplyFurnitureBox, _decorSaveShape furniture-путь (блокировка Save при furnitureWcm===null), _decorFurnitureSizeInput/ _decorFurnitureFlip (синхронизация знака и чекбокса).
• src/houseplan-card.ts: _renderTransformFrame (четыре средние ручки, dtfurnitureframe), furniture render path в _renderDecorLayer (видимый path + невидимый dfurniturehit только при editing && tool==='select', ширина = strokeWidth + 20см).
• src/styles/plan.styles.ts: pointer-events включается только связкой .mode-decor.dtool-select, курсор поворота — локальный data-URI, без сети.
• custom_components/houseplan/validation.py/import_export.py: bool-схема, plan-only allowlist.
• _dtUp (общий, не furniture-специфичный) — один history-commit на жест независимо от kind, ровно как требует AC9.
• Тесты: test/furniture.test.mjs — численные ассерты на resizeFurnitureTransform/furnitureRotationAngle (не строковые совпадения), способные упасть на смене знака/условия; аналогично tests_backend/test_validation.py (0/1/"true"/None/[]/{} отклоняются как flags).

Всё перечисленное соответствует контракту ТЗ #383 и описанию из r1 — расхождений не найдено.

Критерии приёмки — построчно (обновлённый статус r2)

AC	Доказательство	Итог r2
AC1 угловой resize	unit (числовые ассерты) + smoke (cornerGrowsTheWidth, oppositeCornerStaysPut, defaultResizePreservesRatio и др., все true)	PASS
AC2 одноосевые ручки	unit (edge-handle) + smoke (furnitureFrameHasFourSideHandles, edgeHandleChangesOneAxisContinuously) + golden-matrix статический контракт (44/44) + новый DOM-ассерт в demo/golden/harness.mjs (9/4 хендла)	PASS (пиксели — предрелизно)
AC3 crossing/минимум	unit (crossed, both) + smoke (crossingTogglesOnlyHorizontalFlip, crossingCancelRestoresTheObject)	PASS
AC4 rotation	unit (furnitureRotationAngle таблица) + smoke (rotationIsFreeWithoutShift, shiftSnapsRotationTo45) + прочитан _dtMove: rect/ellipse/text путь не тронут	PASS
AC5 properties sync	unit (furnitureSignedFieldCm/Value) + smoke (negativeWidthSynchronisesHorizontalCheckbox, zeroSizeBlocksSave) + ?disabled=${invalidFurnitureSize} прочитан в коде	PASS
AC6 render parity	furnitureRenderTransform прочитан построчно (mirror внутри local box, затем rotate вокруг центра — соответствует §6); golden-сценарии furniture-transform-light/dark добавлены (4 ориентации, light/dark, angle 0°/30°); пиксельная сверка — предрелизно	PASS по коду; пиксели не подтверждены в этом раунде (то же основание, что в r1)
AC7 hit-area	код: смещение strokeWidth + decorCmToUnits(20,…), тот же furnitureStrokePx helper; CSS: pointer-events только в .mode-decor.dtool-select; smoke selectionHaloUsesTheRealArtworkPath	PASS
AC8 cursor/frame	CSS прочитан: локальный data-URI, grab/grabbing fallback, .dt-ew/.dt-ns для средних ручек; smoke DOM-часть PASS; manual screenshot не выполнялся (как и в r1 — вне цикла ревью)	DOM PASS; визуальный проход — вне этого цикла
AC9 история/cancel	_dtUp прочитан: не ветвится по kind, один commit на d.moved; smoke crossingCancelRestoresTheObject	PASS
AC10 backend/transfer	test_validation.py (142 passed локально) — bool строго типизирован; test_ha_import_export.py прочитан (plan-only round-trip flip_h=True/flip_v=False сохраняется); HA-модули не исполнялись (ограничение среды)	PASS (частично — чтением для HA-зависимых файлов)
AC11 регрессии	11/12 прямых smoke зелёные (см. таблицу гейтов); общий resizeDecorBox/rect/ellipse/text путь в дифф не входит (сверено диффом _dtMove)	PASS
AC12 i18n/docs/release	en/ru/de/fr парны (decor.flip_h/v, сверено grep по всем 4 файлам); FURNITURE.md, USER-GUIDE(.ru).md, CONFIG-COMPATIBILITY.md и др. читаемы и терминологически согласованы; скриншоты пересняты и приняты (b1b1e743, M1 закрыт); оба changelog в одном коммите с кодом (686557c5)	PASS (M1 закрыт, было единственное препятствие)
AC13 гейты/бюджет	typecheck/test/build/bundle:budget/no-new-any — все зелёные, прогнаны лично в этом раунде; check-docs зелёный (CI + локально); golden/performance — предрелизно, как и заявлено	PASS

Находки

Нет ни одной новой находки. M1 (единственная блокирующая находка r1) закрыт и подтверждён независимо. Low из r1 («143 vs 142 passed» — расхождение в формулировке хендоффа) не блокировал и не требует повторной проверки — природа не изменилась.

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

• M1 закрыт полностью по правилам §8: снята джоба Docs screenshots (workflow_dispatch, run 33302882691), артефакт принят точной командой npm run docs:accept -- --reviewed --from=..., коммит b1b1e743 содержит только docs/images/**, трейлеры (Issue: #383, User-Visible: no) корректны. check-docs.mjs зелёный и локально, и в CI preflight.
• Ребейз на новый dev не создал скрытого взаимодействия с #385 (223f499e, e561e5fc) — разные функции, разные строки, подтверждено построчным чтением обоих коммитов.
• Дешёвые и целевые гейты, прогнанные лично в этом раунде, зелёные: typecheck, 1604/1604 unit, build+bundle:sync (3 копии байт-в-байт), bundle:budget (запас 20853 B), no-new-any (0 новых), check-docs, целевой backend-субнабор (142/143), целевой smoke (furniture, все ключи true), 11/12 сопутствующих прямых smoke (единственный красный под-чек — воспроизводимое ограничение песочницы, не регрессия).
• Furniture-only ветвление не задевает rect/ellipse/text/backdrop путь — сверено чтением _dtMove/_renderTransformFrame/_decorSaveShape.
• «Одно число — один источник»: test/single-source-numbers.test.mjs в зелёном npm test; сигнатурные размерные поля в диалоге свойств — не повторный дисплей той же величины, а отдельная редактируемая проекция (коллизии нет, как и отметил r1).

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

• Пиксельные golden (AC2/AC6) и браузерный performance-профиль — предрелизный гейт по §8/§11.4, не гейт этого ревью; статические контракты сценариев прогнаны через npm test и новый DOM-ассерт в demo/golden/harness.mjs.
• Manual screenshot для AC8 — вне цикла ревью по определению процесса.
• HA-зависимые backend-тесты (test_ha_import_export.py, test_coordinate_canonicalization.py, полный pytest tests_backend) — homeassistant недоступен в этой песочнице (нет .venv-backend); разобраны чтением диффа, воспроизведено, что тот же импорт падает и на немодифицированном коде.
• 30 слабых smoke-связей из smoke-select — не прогонялись; список и причина отклонения идентичны r1 (широкие общие символы _curSpaceCfg, _decorTool, не относящиеся к furniture-специфичному коду).
• model-invariants — дифф не касается geometry room/wall-thickness/ layout/marker.space/open_spans.

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

Находка r1	Чем закрыта	Где это видно
M1 (Medium, в скоупе): check-docs.mjs красный — устаревший отпечаток скриншотов документации	Снята джоба Docs screenshots (workflow_dispatch, run 33302882691), артефакт принят npm run docs:accept -- --reviewed --from=..., коммит b1b1e743	git show --stat b1b1e743 — только docs/images/**; node scripts/check-docs.mjs → PASS локально; CI preflight на b1b1e743 → success
L1 (Low, снята без правки r1): «143 passed» в хендоффе vs фактические 142 passed + 1 skipped	Не требовала правки — расхождение в формулировке, не в результате; в r2 автор сам указывает «143 passed» снова в комментарии после повторного rebase, я перепроверил напрямую: 142 passed + 1 skipped (143 собранных)	python3 -m pytest tests_backend/test_validation.py -q в этом раунде → 142 passed, 1 skipped

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

Принято без повторного самостоятельного вывода (документ CODE-REVIEW-383-r1.md, материал 8f34c594, содержимое исходников идентично текущему 686557c5 — подтверждено сверкой списка файлов диффа и собственным построчным чтением ключевых мест в этом раунде, а не слепым доверием):

• Разбивка AC → конкретные unit/smoke имена (какая проверка что доказывает) — взята из r1 как карта, но каждая PASS-отметка в таблице выше перепроверена заново прогоном в r2, а не скопирована.
• Мутационное рассуждение r1 («обратный знак crossX/crossY, пропуск keepAspect ломает конкретные ассерты») — не повторял мысленные мутации заново; вместо этого перечитал сам код resizeFurnitureTransform и убедился, что численные тесты test/furniture.test.mjs жёстко привязаны к конкретным входным/выходным числам (не строковые совпадения), что даёт ту же гарантию «тест умеет падать».
• Заключение «прецедент flip_h/flip_v у openings — не коллизия» (Low-2 из ревью ТЗ) — принято из r1 без повторной проверки схемы openings, так как сам факт документирован в CONFIG-COMPATIBILITY.md (сверено, что абзац присутствует) и openings/furniture проходят разными функциями allowlist (_DECOR_KIND_FIELDS), что видно и в текущем диффе.

Итог

Реализация полностью закрывает контракт ТЗ #383: все 13 AC доказаны исполняемыми тестами (перепроверены лично в этом раунде, включая численные таблицы, которые способны падать на смене знака/условия) либо разобраны чтением с явной пометкой ограничения среды. Единственная находка r1 (M1) закрыта и подтверждена независимо через CI и локальный повтор. Рёбейз на ушедший вперёд dev не принёс скрытых конфликтов — оба привнесённых коммита (#385) не пересекаются с кодом #383 по функциям/строкам. Дешёвые и целевые гейты, прогнанные лично на этом SHA (а не унаследованные из вводящего в заблуждение «зелёного» Validate — см. оговорку в разделе «Как проверялось»), все зелёные. Новых находок нет.

Вердикт: зелёный · заход r2 · блокирующих циклов 1/4 · High: 0 · Medium: 0

Issue может переходить в S8-merged.