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

# CODE-REVIEW-371-r2

Issue: #371 — Add French localization files
Заход: r2 · блокирующих циклов израсходовано 0 из 2 (зелёный вердикт цикла не образует, #227)
Материал ревью: `1cd84dd0` (HEAD ветки `issue/371-french-locale` на момент разбора; `git merge-base origin/dev HEAD == origin/dev`, т.е. ветка полностью содержит `dev`, дальнейший ребейз не требуется)
Ревьюер: Claude (код-ревью, свежая сессия, без контекста реализации)

## Почему разбор полный, а не по дельте

r1 код-ревью было **зелёным** (`High: 0 · Medium: 0`, документ
`docs/reviews/CODE-REVIEW-371-r1.md`, материал — SHA `3c19ba18`, названный не в
самом вердикте, а в следующем комментарии автора; отсутствие SHA в тексте
вердикта — процессное наблюдение, см. ниже). Слияние этого зелёного вердикта не
удалось: пока шло ревью, `dev` продвинулся на 6 коммитов, и конвейер вернул
задачу в `S6-in-progress` не как правку по находке, а как чистый ребейз
(комментарий от 2026-08-29T10:35:47Z). Автор перебазировал ветку на
`origin/dev`, разрешив конфликты в бандл-деревьях (`bundle:sync`), changelog’ах
(union) и скриншотах (`demo/docs/capture.mjs`), и вернул `S7-code-review`.

По PROCESS.md §7.2/§10.4 это ровно тот случай, когда «разбор остаётся полным»:
ребейз на ушедший вперёд `dev` — другой код, а не локальная дельта. Поэтому
этот документ — не сокращённый разбор по дельте r1→r2, а полный независимый
код-ревью текущего дерева, как будто это первый заход. Разделы «Закрытие
раунда r1» и «Унаследовано из r1» ниже присутствуют по формату r2+, но
содержательно короткие: r1 не оставил ни одной находки для закрытия, и ничего
не принято без собственной перепроверки в этом раунде.

## Скоуп диффа

`git diff origin/dev...HEAD` — 45 файлов, класс A: `src/i18n/fr.json` (новый,
1128 ключей), `src/i18n/fr.ts` (новый, клон `de.ts`), `src/i18n/registry.ts`
(+`loadFrench`, +`FRENCH_RETRY_ASSET`, +запись реестра),
`custom_components/houseplan/translations/fr.json` (новый). Класс B:
`scripts/bundle-manifest.mjs` (locale-role/localeRoots/retry-guard/
entryFallbackPlugin обобщены на `fr`), `scripts/mutation-gate.mjs` (новый
мутант `french-locale-wrong-dictionary`), `scripts/smoke-links.mjs`
(`smoke_french_locale.mjs` добавлен в существующую запись локалей),
`demo/smoke_french_locale.mjs` (новый), `demo/smoke_entry_stale.mjs` (fr-прогон),
`test/i18n.test.mjs` (+резолвер fr-профилей, +2 French-персональных теста),
`test/bundle-assets.test.mjs` (fr-ветка retry-guard теста). Класс C:
`docs/USER-GUIDE(.ru).md`, `docs/CHANGELOG(.ru).md`, `docs/images/*` +
`screenshots.json` (пересъёмка отпечатка после ребейза). Класс D: `dist/**`,
`custom_components/houseplan/frontend/**` — байт-в-байт пересобраны.

Геометрия, `layout`, `marker.space`, `open_spans`, толщина стен — не
затронуты. Python-код (`custom_components/houseplan/**/*.py`) — не затронут,
только новый JSON перевода. Видимый рендер/геометрия/стили карточки — не
меняются (добавляется только выбираемый язык интерфейса).

## Гейты — прогнаны лично на SHA `1cd84dd0`

| Гейт | Команда | Результат |
|---|---|---|
| typecheck | `npx tsc --noEmit` | зелёный, без вывода |
| unit | `npm test` | `1546 tests, 1545 pass, 0 fail, 1 skipped` — совпадает с заявленным автором |
| build + бандл | `npm run build && cmp dist/houseplan-card.js custom_components/houseplan/frontend/houseplan-card.js` | сборка зелёная, `cmp` без вывода (побайтовое совпадение) |
| bundle:budget | `npm run bundle:budget` | initial **273 927 / 300 000 Б** gzip, lazy locale 45 200 Б — совпадает с хендоффом |
| check-docs | `node scripts/check-docs.mjs` (обязателен — diff трогает `src/**`) | «Documentation checks passed (7 files, 10 external links)» |
| no-new-any | `node scripts/no-new-any.mjs --base origin/dev --head HEAD` | «Новых any нет» (15 добавленных строк в 2 файлах) |
| smoke-select | `node scripts/smoke-select.mjs --base origin/dev --head HEAD` | НЕОПРЕДЕЛЁННОСТЬ по `FRENCH_RETRY_ASSET`, `LazyLanguageModule`, `loadFrench` — разбор ниже |
| смок AC3 (прямое совпадение) | `node demo/smoke_french_locale.mjs` (после `npm run bundle:sync` — первый прогон без свежего стенда падал по стухшему бандлу, ожидаемо) | все 5 проверок `true`, `OK` |
| смок (зарегистрированная связь) | `node demo/smoke_entry_stale.mjs` | `OK`, включая `frenchMessageVisible` |
| смок (регресс на общем de/fr коде) | `node demo/smoke_german_locale.mjs` | `OK`, все 9 проверок `true` |
| мутант AC5 | `node scripts/mutation-gate.mjs --id=french-locale-wrong-dictionary` (целевой прогон одного мутанта, не полный дорогой набор) | «поймано 1 из 1»: чистый прогон смока зелёный, мутант красит `smoke_french_locale.mjs`, как обязан |
| inventory | `npm run inventory` | 1546 unit / 213 pure-backend / 150 HA-harness / 203 browser-smoke — счётчики не переписывались вручную |

Разбор `smoke-select`: инструмент не находит `FRENCH_RETRY_ASSET`,
`LazyLanguageModule`, `loadFrench` ни в одном смоке текстовым совпадением. Это
не новый пробел: German-аналоги (`GERMAN_RETRY_ASSET`, `loadGerman`) точно так
же не перечислены в `scripts/smoke-links.mjs` — там регистрируются символы
рантайм-уровня (`LanguageRuntime`, `dictionaryFor`, `ensureLanguage`), а не
внутренние функции-загрузчики реестра. Автор корректно расширил ровно ту же
запись, добавив `smoke_french_locale.mjs` вторым смоком (диф
`scripts/smoke-links.mjs`), — это «зарегистрированная связь» в терминологии
инструмента, и она уже покрывает `loadFrench`/`FRENCH_RETRY_ASSET` косвенно:
я прогнал `smoke_french_locale.mjs` напрямую (см. таблицу) и он проверяет
именно этот путь (fr-чанк грузится ровно раз, `_t` отдаёт французский текст).
Не гейт, а решение ревьюера засчитать связь достаточной без правки реестра.

Не прогонялось и почему:
- `python -m pytest tests_backend -q` — ни один `.py`-файл не тронут, только
  `custom_components/houseplan/translations/fr.json` (не код);
- `node scripts/model-invariants.mjs` — геометрия/`layout`/толщина стен/
  `marker.space`/`open_spans` не затронуты этим диффом;
- `npm run golden:verify` — видимый рендер карточки не меняется (новый язык —
  не новый визуал; геометрия и стили не тронуты);
- performance-профили — не названы в AC, чувствительные к перфу пути (canvas,
  layout) не тронуты;
- полный `ls demo/smoke_*.mjs` (203 файла) — диапазон диффа локален
  (i18n/manifest/registry), прогон всей матрицы это предрелизный гейт (§8), не
  гейт ревью; выбраны прямое совпадение + зарегистрированная связь + один
  смежный смок вручную (регресс на общем German/French коде манифеста), как и
  в r1.

**Одно число — один источник.** Дифф не добавляет и не меняет ни одной
пользовательской величины (только текстовые строки интерфейса и служебные
токены сборки) — проверка неприменима, новых чисел для сверки нет.

## Проверка AC (по тексту ТЗ ревизии 2, комментарий S3→S4)

- **AC1** (паритет словаря + French-персональные тесты): проверено
  независимым скриптом, не доверяя заявлению автора — `en.json`/`fr.json`:
  1128/1128 ключей, 0 пустых, 0 расхождений плейсхолдеров, порядок ключей
  идентичен. `test/i18n.test.mjs` содержит французский глоссарий (`btn.save`,
  `space.header`, `opening.passage` и др.) и скан на кириллицу/сентинелы +
  allow-list из 22 омографов — прогнан `npm test`, зелёный. Точечно
  перепроверил 5 записей allow-list (`color_picker.saturation`, `gs.unit_m`,
  `wallthick.unit_cm`, `furn.cat_bidet`, `run.script`) — все действительно
  идентичны en (единицы измерения/бренд-термины), не забытый перевод.
  Доказано автотестом, тест умеет падать (мутант ниже красит именно этот
  контракт на уровне смока, юнит-паритет красится удалением ключа — проверено
  чтением структуры теста, не отдельным прогоном мутации паритета).
- **AC2** (реестр): `test/i18n.test.mjs` содержит `resolveLanguageCode` для
  `fr-FR/fr-CA/fr_BE/fr-CH`, `langOf` для `fr-CA` — прогнано `npm test`,
  зелёное. `LANGUAGE_REGISTRY` — ровно en/ru/de/fr (прочитано в
  `src/i18n/registry.ts`).
  Доказано автотестом.
- **AC3** (смок реальным бандлом): `demo/smoke_french_locale.mjs` прогнан лично
  на свежем `bundle:sync` — fr-CA → французский, `btn.save`→`Enregistrer`,
  `lang`-атрибут `fr`, fr-чанк запрошен ровно 1 раз, initial-граф без fr,
  lazy-граф с fr. Доказано автотестом, прогнан лично.
- **AC4** (бюджет): `npm run bundle:budget` — fr в `lazyLocaleFiles`, initial
  273 927 Б (в пределах 300 000, +0,5 КБ к строке дифф-хендоффа автора —
  различие в пределах шума пересборки). Доказано прогоном.
- **AC5** (мутант): `french-locale-wrong-dictionary` в
  `scripts/mutation-gate.mjs` (замена `import('./fr')` на возврат английского
  словаря при живом импорте — вторая версия мутанта после того, как первая
  ломала саму сборку, а не смок, что зафиксировано в коммитах `7f3e67bc`/
  `c7dfd712`). Прогнан лично целевым `--id=french-locale-wrong-dictionary`:
  «поймано 1 из 1», тест умеет падать — не голословное заявление автора.

`entryFallbackPlugin` (М1 из ревью ТЗ r1) и French-персональные тесты (М2 из
ревью ТЗ r1) — обе спек-находки закрыты в коде, проверено чтением
(`scripts/bundle-manifest.mjs:224-225` — французская ветка ternary с текстом
«House Plan a été mis à jour…», плюс fr-прогон в `demo/smoke_entry_stale.mjs`,
прогнан лично, зелёный).

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

r1 (код-этап) — зелёный вердикт, **High: 0, Medium: 0**. Находок, которые
требовалось бы закрывать в r2, у r1 не было; таблица «находка → чем закрыта»
пуста по существу. Единственное процессное наблюдение к r1: вердикт-комментарий
не назвал SHA материала (см. ниже) — это не находка по коду, а пробел в
оформлении вердикта, не влияющий на итог, поскольку код перепроверен заново в
этом раунде целиком.

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

Ничего не принято без собственной перепроверки. Причина — не сокращение
объёма по §2.10 (обычная делегированная дельта), а прямое указание процесса:
ребейз на ушедший вперёд `dev` делает материал другим кодом (§7.2), поэтому
весь список AC, все гейты и все находки ревью ТЗ перепроверены заново в этом
документе (таблица гейтов и раздел AC выше), а не сославшись на
`docs/reviews/CODE-REVIEW-371-r1.md` (SHA `3c19ba18`, предребейзный, самим
вердиктом не назван — восстановлен по комментарию автора от
2026-08-29T10:35:47Z «Материал ревью — `3c19ba18`»).

## Находки

Нет находок High. Нет находок Medium — ни в скоупе, ни вне его.

**Low (процессное наблюдение, не по коду задачи):** вердикт код-ревью r1 не
назвал SHA материала прямо в тексте комментария (требование §2.10/#312 —
«SHA в вердикте не назван — это находка»). SHA восстановим по соседнему
комментарию автора того же раунда, поэтому не блокирует и не искажает вывод:
полный повторный разбор в r2 из-за ребейза делает вопрос неактуальным для
самой задачи #371. Снимаю без правки — адресовать в механике публикации
вердиктов, а не в этой задаче (чужой скоуп: инфраструктура ревью, не код
French-локали).

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

- Полный паритет словарей (фронт 1128/1128, бэкенд 6/6), без пустых значений,
  без расхождений плейсхолдеров, порядок ключей = en.json — перепроверено
  независимым скриптом, не только словами автора.
- Обобщение German-механики на French в `bundle-manifest.mjs`
  (`_role: 'locale'`, `localeRoots`, retry-guard 1/1/1/1, `entryFallbackPlugin`)
  — построчно сверено с рабочим de-эквивалентом, консистентно.
- `src/i18n/fr.ts` — точный клон `de.ts` (сверено побайтово текстом).
- Автоматический выбор French по профилю HA (`fr`, `fr-FR`, `fr-CA`, `fr-BE`,
  `fr-CH`) — юнитами, зелёные.
- `demo/smoke_french_locale.mjs`, `smoke_entry_stale.mjs` (fr-ветка),
  `smoke_german_locale.mjs` (регресс на общем коде) — прогнаны лично, зелёные.
- Мутант AC5 — прогнан лично целевым `--id`, красит смок, как обязан.
- Оба changelog (en+ru) и `USER-GUIDE(.ru).md` правлены в том же
  feature-коммите (`89fa8ca5`, `User-Visible: yes`), терминология
  («Français», «lazy dictionaries») согласована с существующим German-текстом.
- Трейлеры на всех коммитах диапазона (`Issue: #371`, ровно один
  `User-Visible: yes|no`) — прочитаны `git log --format`, соответствуют
  классам изменений.
- `demo/srv/assets/**` не закоммичен (соответствует #255); `dist/**` и
  `custom_components/houseplan/frontend/**` побайтово совпадают со свежей
  локальной сборкой (`cmp`, без вывода).
- Ребейз выполнен корректно: `git merge-base origin/dev HEAD == origin/dev`,
  конфликтов для слияния больше нет.

## Что не проверялось

- Лингвистическое качество перевода — вне код-ревью; носитель (@OUARZA)
  проверит 121 добавленный автором ключ постфактум по решению владельца,
  зафиксированному в этом же issue (комментарий 2026-08-29T10:26:18Z).
- `pytest tests_backend`, `model-invariants`, `golden:verify`, performance —
  не запускались, обоснование см. в таблице гейтов выше (диапазоны диффа их не
  задевают).
- Полная матрица `smoke_*.mjs` (203 файла) — не предмет код-ревью, это
  предрелизный гейт.
- Дорогой полный прогон `mutation-gate.mjs` без `--id` (все мутанты проекта) —
  не гейт код-ревью; для AC5 достаточен целевой прогон, выполнен.

## Вердикт

Зелёный. High: 0, Medium: 0. Задача уходит в очередь на пре-релиз.