2 Commits

Include renames

Author	SHA1	Message	Date
Claude	f6cd99cef4	feat(tools): страница /convert для конвертера Sweet Home 3D, этап 2 ... Артефакт один — scripts/sh3d-convert/dist/index.html, самодостаточный файл, как и лендинг: раскладывается копированием, без сборщиков и CDN. Собирается склейкой тех же модулей, которые проверяют гейты этапа 1; относительных импортов на странице нет, поэтому она работает из любого каталога и без сети. Три обещания страницы проверяются тестами, а не текстом: 1. Ни одного сетевого вызова и ни одной внешней загрузки. Ищутся формы ВЫЗОВА, а не имена API: первая редакция теста краснела на собственном комментарии, где эти API перечислены как запрещённые. Шрифты системные — <link> к шрифтам это внешний запрос при загрузке, а обещание «файл не покидает браузер» должно быть буквальным. Заодно поэтому на странице нет аналитики. 2. Конвертер внутри страницы даёт тот же результат, что модули репозитория: код извлекается из собранного артефакта, прогоняется на фикстуре и сравнивается с golden. Склейка, потерявшая модуль, краснеет. 3. Собранная страница не отстала от исходников: build-page.mjs --check сверяет закоммиченный артефакт с пересборкой. Плюс полнота переводов: у каждой подписи есть ru и en, словари совпадают по ключам, у каждого кода отчёта и каждого кода отказа есть человеческий текст. Иначе пользователь увидит пустую надпись или `not_zip`. Отчёт показывается ДО скачивания и по этажам: сколько комнат, стен и проёмов, какая клетка сетки, и полный список мест, где конвертер принял решение, — спрямлённая дуга, обрезанная толщина, непривязанный проём, пропущенный этаж без комнат. Это требование задачи: искать чужие ошибки в готовом плане из сотен объектов хуже, чем прочитать их заранее. Гайды (ru/en) получили раздел про импорт из Sweet Home 3D с прямой записью, что это необязательный ярлык, а не шаг настройки: SCOPE обещает «no external editors», и обходить это молчанием нельзя. Свидетели этапа 2, все проверены отрицательным прогоном: добавленный в страницу fetch, потерянный русский перевод, правка dist руками, склейка без модуля sh3d.mjs — каждая краснит свой тест. Гейты: npm test 1871 tests, 1870 pass, 0 fail; pytest без HA 378 passed, 3 skipped. Осталось владельцу: раскладка на хост (из песочницы SSH недоступен) и проверка на настоящем файле Sweet Home 3D. Issue: #446 User-Visible: no	2026-09-04 00:41:40 +03:00
Claude	2695307ef0	feat(tools): конвертер Sweet Home 3D → документ импорта, этап 1 ... Решение владельца по итогам исследования: из чужих форматов планировок работать имеет смысл только с .sh3d, и конвертер живёт на сайте, а не в карточке. Продуктового кода задача не касается вовсе — документ импорта не подписан и не привязан к инстансу, поэтому сторонний генератор это легальный сценарий уже сегодня. Этап 1 — всё, что должно жить в репозитории и проверяться в CI: - scripts/sh3d-convert/{xml,zip}.mjs — читатели XML и zip без единой зависимости, работают и в Node, и в браузере (DecompressionStream либо node:zlib). Недоверенный ввод отбивается на входе: DOCTYPE пропускается и не загружается, объявления сущностей отвергаются, шифрованные записи, zip64 и распаковка сверх предела — отказ с кодом; - sh3d.mjs — уровни, комнаты, стены, двери и окна в сантиметрах; мебель, материалы, свет, камеры не читаются вовсе; - convert.mjs — маппинг в документ kind=space, plan-only, model 7. Форма v7 выбрана намеренно и это главное техническое решение задачи. При v8+ схема требует полный каталог сегментов: wall_ids по числу рёбер, один-два владельца у каждого сегмента, проекция walls, совпадающая с сегментами. Всё это на стороне сайта означало бы повторить серверный алгоритм и разойтись с ним на первом изменении модели. В форме v7 ту же работу делает commit_wall_segment_model — тот же путь, которым едут старые бэкапы: сегменты собираются сами, общая граница двух комнат склеивается в один сегмент с двумя владельцами, проёмы получают хозяина. Проверено прогоном: v7 → валидный v9. Второе решение — план строится по комнатам. Стена в нашей модели существует как ребро контура комнаты, поэтому стены Sweet Home 3D дают рёбрам только толщину, а уровень без комнат конвертировать нечем: это отказ с объяснением, а не пустой план. Геометрия: вершины комнат привязываются к осевым линиям стен (Sweet Home 3D обводит комнаты по внутренним граням, «как есть» получились бы две параллельные стены вместо общей), затем сваривются с точностью до сантиметра. Проёмы проецируются на ребро, угол берётся у ребра, длина обрезается до ребра — серверная привязка допускает 8° и 0.02 шага решётки, поэтому ни угол, ни центр из файла доверия не заслуживают. Гейт против дрейфа версий (AC5) — две половины: - test/sh3d-convert.test.mjs: фикстуры → конвертер → сравнение с закоммиченными golden. Правка конвертера без пересборки golden красная; - tests_backend/test_sh3d_convert.py: golden проверяются настоящими CONFIG_SCHEMA и commit_wall_segment_model, плюс кросс-рантаймовый пин формул _wall_key и канонизации решётки. Правка модели, не отражённая в конвертере, красная — до того, как это увидит пользователь; - tests_backend/test_ha_sh3d_convert.py: golden проходят настоящий create_preview (нужен HA, идёт в Linux CI). Там же отрицательная проверка: документ с приватным полем обязан получить отказ. Свидетели, все проверены отрицательным прогоном: снятое выравнивание вершин, отключённая сварка, угол проёма из файла, непроецированный центр, необрезанная длина, снятая обрезка толщины, объявленная модель v9, разошедшийся порт _wall_key, правка golden руками, поднятая PLAN_MODEL_VERSION, изменённая серверная формула, изменённая канонизация — каждая краснит свой тест. Две фикстуры пришлось усилить именно из-за таких прогонов: углы и центры проёмов в первой редакции совпадали со стенами случайно, и мутации проходили молча; появилась и фикстура с общей границей без стены и шумом в доли сантиметра — иначе сварка вершин не исполнялась ни разу. Фикстуры синтетические, собраны генератором по опубликованному формату: настоящих .sh3d в сборке нет и взять их автоматически негде. Проверка на реальном файле — ручная приёмка владельца, записана в issue. Гейты: npm test 1867 tests, 1866 pass, 0 fail; pytest без HA 378 passed, 3 skipped. Этап 2 (страница /convert на houseplan.tech, ru/en) — следующим шагом. Issue: #446 User-Visible: no	2026-09-04 00:35:21 +03:00