Support categorized fragments, theme presets, block widths, and server-backed theme editing with onboarding and preview. Include Site Studio, design sources, specification and verification reports; remove the legacy studio-site example.
8.7 KiB
Проверка 002 — этап 1: категории фрагментов
Дата: 2026-11-13. Реализация этапа 1 подготовлена к пользовательской приёмке. Следующие этапы — тема, ширина блоков, перенос публичных компонентов, отдельный Site Studio и Theme Manager — этим отчётом не закрываются.
Это отчёт состояния на момент завершения этапа 1. Последующая реализация темы и ширины описана отдельно в проверке этапов 2–3; актуальный контракт — runtime.md.
Реализованное поведение
- Обнаружение рекурсивное, по
fragment.yaml; имя каталога не подменяет ID манифеста. Плоское, категоризированное и смешанное размещение работают одновременно. - Для вложенного фрагмента категория — первый каталог относительно
fragments/, для плоского — YAMLcategoryилиmisc. Путь имеет приоритет над YAML, дополнительная вложенность категорию не меняет. Допустимы произвольные категории сайта. - Все 15 builtin разложены по шести категориям:
content(6),data(2),forms(1),marketing(3),media(1),system(2). Их ID, шаблоны, CSS и JS сохранены; побайтовое сравнение перемещённых шаблонов и ресурсов с HEAD прошло.columnsиpage_headerсохранены. - API продолжает отдавать строку
schema.fragments[id].categoryи плоский словарьpreview. Ссылки на фрагменты остаются без префиксов категорий; повторные ID запрещены. - Необязательный соседний
preview.yamlимеет форму{name?: string, props: object}. Егоpropsпереопределяют inline preview по ключам; отсутствующие значения берутся из defaults полей.nameиз preview не меняет имя фрагмента. Некорректные файлы дают диагностику с путями, а не исключения из.get()при рендере формы. - В каталоге видны категория, название и назначение. Поиск учитывает ID, название, описание, код категории и прежнюю русскую подпись. Прежние категории объединяются со стандартными только при отображении: исходное значение API и файла сохраняется.
- Добавление блока и предпросмотр не записывают страницу. Явное сохранение, ETag, CSRF, ограничения регионов/слотов и формат новых ID сохранены.
Выполненные проверки
- Полный набор Python-проверок: 288 тестов, 0 ошибок, 0 падений, 0 пропусков. Фикстура
examples/studio-siteвзята из HEAD во временный каталог, поскольку рабочийpages/index.mdизменён пользователем; исходный пример не менялся. Машиночитаемый результат:/tmp/site-engine-fragments-002/unittest.json, подробный лог —unittest.logв том же каталоге. - Новые проверки ядра: 23 теста для обнаружения, приоритета категории, глобальных ID, дубликатов, preview и его диагностики. 7 интеграционных тестов используют самостоятельную временную файловую модель и настоящую цепочку login → HTML → внутренний API, включая экранирование пользовательских категорий, диагностику повреждённого preview в workspace/JSON/HTML и сохранность опубликованного релиза при отказе.
- Валидация текущего
examples/ai-studio: 0 ошибок, 0 предупреждений. Штатная сборка: 14 страниц в/tmp/site-engine-fragments-002/ai-studio-dist/current/. - Проверка упаковки: wheel содержит все файлы вложенных builtin. Установка wheel во временный каталог и запуск FastAPI вне checkout прошли: статика, шаблоны, API, изолированное превью и bridge работают без каталога
design/. - Браузер: настоящий FastAPI и отдельный preview origin, Chromium 158, 1440×960 и 390×844, 8 групп приёмки. Проверены категории, русские подписи, поиск, пустая выдача, ограничения региона/слота, клавиатурный фокус, sidecar defaults с
false/0, добавление/превью без записи, согласованность активного фильтра после HTML swap, явное сохранение/повторное открытие, CSS вложенных и плоских фрагментов в опубликованном бандле. Неожиданных JS-ошибок, нативных диалогов и передачи внутренних credentials браузеру нет. - Проверены Ruff для изменённого Python-кода и
git diff --check.
Браузерный отчёт и скриншоты находятся в /tmp/site-engine-fragments-002/: report.json, catalog-desktop.png, mobile.png. При проверке ответы runtime builder-adapter.css и builder.js сравниваются с текущими исходниками; их SHA-256 записывается в отчёт. Скриншоты просмотрены: категории видимы, горизонтального переполнения каталога нет.
Воспроизведение
PYTHONPATH=src python -m unittest discover -s tests -p 'test_fragment_catalog*.py' -v
PYTHONPATH=src python scripts/qa_fragments_002.py
PYTHONPATH=src python -m site_engine.cli validate examples/ai-studio
PYTHONPATH=src python -m site_engine.cli build examples/ai-studio --out /tmp/ai-studio-dist
PYTHONPATH=src python scripts/verify_package_001.py
Браузерный сценарий самостоятельно получает базовую фикстуру через git archive HEAD, не читая и не изменяя рабочий examples/studio-site/pages/index.md. Обычные команды полной проверки и verify_package_001.py используют рабочий пример: при наличии пользовательских изменений его результаты могут отличаться. Для описанной проверки установленного wheel использовалась временная копия актуальных src/, pyproject.toml, README.md и базовая фикстура из HEAD.
Развёртывание и приёмка
Рабочий SITE_ROOT, файлы сайта и исходники design/ не переключались и не менялись. Коммиты и публикация на сервер не выполнялись. Изменения builtin, загрузчика и админки требуют пересборки Docker-образа; bind-mount каталога сайта их не обновляет.
После установки новой сборки открыть конструктор → «Добавить блок»: проверить подписи шести категорий, фильтрацию и существующие локальные фрагменты. Далее этап 1 принимает пользователь; переход к ядру темы выполняется после этой приёмки согласно согласованному плану.