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.
12 KiB
Проверка 002 — этапы 2 и 3
Дата: 2026-11-13. Этапы выполнены вместе по прямому поручению пользователя. Реализация подготовлена к пользовательской приёмке; развёртывание на рабочем сервере и этапы 4–5 не выполнялись. Контракт — runtime.md, задачи — tasks.md.
Реализовано
- Файловая тема через site.yaml.theme.file, schema 1, шесть точных preset@1 из исходного дизайна и каталог разрешённых шрифтов в runtime-пакете. Inline tokens получают явную ошибку; отсутствие настройки у нового сайта использует minimal@1 без записи.
- Единый resolver dataclass-ядра для валидации, CLI/build и обоих режимов preview. Глубокие overrides, строгие числовые диапазоны/типы, HEX, дополнительные цвета и линейные градиенты, полноценный Custom; диагностика контраста — warning.
- Семантические CSS-переменные подключены после defaults. Базовая типографика, кнопки, карточки, поверхности, подписи и границы используют токены. Градиенты Hero/button/CTA применяются адресно и отключаются к однотонному fallback; outline не становится solid. Палитра админки не изменяется.
- Manifest фиксирует document/effective_tokens, source_hash/render_hash/fingerprint. Воспроизводимый ID учитывает ресурсы движка и пресеты. Коллизия не перезаписывает исторический каталог, ошибки не переключают current, rollback не меняет workspace.
- ContainerSettings и BlockLayout: inherit/boxed/fluid/full, max_width, адаптивные gutters и границы 700/1024. Одно поведение для Page/Entry/Display/fixed/slots, собственные контейнеры вложенных блоков и sticky корни.
- Контролы ширины инспектора перенесены из design/assets/builder.js: те же подписи, варианты, классы и пояснение. Существующая цепочка htmx → HTML → JSON API → DocumentService сохраняется. API объявляет BlockLayoutDTO в OpenAPI. Обновление полей до Save не записывает страницу; props/duplicate/move/toggle и Конструктор ↔ Эксперт сохраняют layout.
- Исходные конфигурации studio-site и ai-studio переведены на theme.yaml с сохранением основных цветов и тёмного Hero. Пользовательские страницы и design не менялись этой работой. Новый examples/site-studio остаётся этапом 4.
Автоматические и интеграционные проверки
Полная регрессия: 320 тестов, 0 ошибок, 0 падений, 0 пропусков. Для старых тестов использован git HEAD examples/studio-site, извлечённый во временный каталог, с наложенными актуальными site.yaml/theme.yaml. Это исключает зависимость от пользовательских изменений рабочего pages/index.md. Новые проверки используют самостоятельный файловый сайт из tests/theme_fixture.py.
Новые 21 проверки темы охватывают все пресеты, независимость копий каталога, deep merge и Custom, invalid shapes/enums/ranges/boolean/NaN/Inf/огромные числа, запрещённые CSS/URL/Jinja/шрифты, limits/reserved names, stops и отключение градиентов, пути/YAML/symlink, контраст, общий CSS, manifest, воспроизводимость, изменение ресурсов без изменения source_hash, защиту live/истории и rollback. После исправления обработки огромных чисел эти 21 проверки запущены повторно.
Ещё 11 проверок ширины и HTTP-интеграции охватывают строгий BlockLayout, все режимы/наследование, отсутствие общих wrappers и утечек в nested containers, Page/Entry/Display/fixed/slots, схему snapshot/OpenAPI, операции дерева, явное сохранение и reopen, очистку nullable-полей, настоящий HTML → API transform, invalid widths, распространение ошибок темы в API/HTML/preview/publish без переключения live.
Штатный validate актуального ai-studio: 0 ошибок, 0 предупреждений; build: 14 страниц. Отдельная базовая фикстура собирается и в установленном пакете. Проверки wheel подтверждают наличие containers.css, всех шести пресетов, fonts.json и вложенных фрагментов. Wheel установлен вне checkout и запущен без design/: разрешение всех пресетов, сборка, админская статика/шаблоны/API, ширина и отдельный preview origin с nonce bridge проходят.
Ruff изменённых модулей и git diff --check проходят. Прежние broad assertRaises(Exception) в test_security.py не изменялись и проверены с исключением существующего правила B017; изменённая проверка инъекции использует новый theme.yaml/E_THEME_COLOR. OpenAPI повторно экспортирован в specs/001-antirion-admin/openapi.json.
Настоящий браузер
scripts/qa_theme_002.py запускает изолированные FastAPI admin/public и отдельный preview origin; данные и учётная запись временные. Chromium 158, 8 групп приёмки:
- Все шесть пресетов: фактические background/text, heading weight, radius кнопки; применение и отключение градиента проверены через computed styles.
- Три глобальных режима × девять пар section/content × девять ширин: 243 проверки геометрии пар на 1440/1280/1024/1023/768/700/699/390/360 px. Проверены gutters, max-width, вложенная секция, sticky-header и отсутствие горизонтального overflow. Дополнительно gutters 0 и 96 на 360 px.
- Контролы инспектора сверены с оригинальным design/builder-antirion.html: варианты/value/подписи и computed font/color/background/border/radius/height/padding совпадают.
- Выбор секции в дереве локальный, без POST; в preview появляется выделение.
- Изменение ширины обновляет immutable preview, сохраняя выбранную секцию и scroll (расхождение менее 3 px), файл страницы не записывается.
- Конструктор ↔ Эксперт сохраняет исходник; изменение props сохраняет layout; Save и reload возвращают те же значения.
- Админка проверена на 1440/1280/1024/768/390/360 px, без горизонтального overflow.
- Нет неожиданных JS/console ошибок, нативных диалогов или внутренних API credentials в запросах браузера.
Скриншоты desktop/mobile просмотрены: контролы соответствуют исходному дизайну, preview загружен и показывает выделение. Публичный тестовый сайт проверяет поведение движка; он не является переносом нового Site Studio и не подменяет визуальную приёмку этапа 4.
Артефакты и воспроизведение
/tmp/site-engine-theme-002/:
- browser.json — браузерный отчёт и измерения;
- constructor-1440.png, constructor-390.png, reference-controls-1440.png;
- public-1440.png, public-390.png, public-360.png;
- unittest.json и unittest.log — полная регрессия;
- ai-studio-dist/current/ — штатная сборка актуального примера;
- baseline/examples/studio-site/ — изолированная базовая фикстура с новыми конфигурациями темы.
PYTHONPATH=src python -m unittest discover -s tests -p 'test_theme.py' -v
PYTHONPATH=src python -m unittest discover -s tests -p 'test_block_layout.py' -v
PYTHONPATH=src python scripts/qa_theme_002.py
PYTHONPATH=src python scripts/verify_package_001.py --site /path/to/isolated-site
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
В этой среде использовался /tmp/flexly-cms-htmx-check/bin/python. Обычный запуск полной регрессии использует рабочий пример; его результаты могут отличаться при пользовательских изменениях. Системный sandbox bwrap недоступен, поэтому команды выполнялись разрешённым инструментом вне bwrap; браузер работал с loopback и без прокси.
Пользовательская приёмка
Для проверки на сервере нужна пересборка Docker-образа. Если рабочий сайт всё ещё содержит inline theme.tokens, конфигурацию нужно явно перевести на файловый контракт; автоматической миграции нет согласно принятому решению. Изменения текущих рабочих данных, переключение SITE_ROOT, публикация на сервер и коммиты не выполнялись. Root examples не коммитились.
Проверить в конструкторе «Макет блока · ширина», пары Full/Boxed и Fluid/Full, вложенный блок, переключение Конструктор ↔ Эксперт, Save/reopen. Проверить файловую тему на своём контенте и отдельную публикацию/откат. Пользовательская приёмка отмечается отдельно; новый Site Studio и Theme Manager к этим этапам не относятся.