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.
11 KiB
Проверка этапа 4 — публичные фрагменты и Site Studio
Дата: 2026-11-13. Этап выполнен по отдельному поручению пользователя после этапов 2–3. Реализация готова к пользовательской приёмке; Theme Manager остаётся этапом 5.
Результат
Отдельный examples/site-studio/ перенесён из design/examples/site-studio/ на штатные registry/validation/Jinja/build. Сохранены 9 ручных страниц, 8 записей, их статусы, тексты и изображения, пять layouts и два редиректа. Сборка создаёт 13 опубликованных страниц. Локальных копий builtin, preview-dist и mini-renderer в новом примере нет. Независимый запуск описан в его README; рабочий SITE_ROOT не переключался.
HTML и CSS общего builtin взяты из исходных фрагментов и assets/site.css. Общие примитивы находятся в builtin/base.css, компонентные правила — в style.css соответствующего фрагмента. Сохранены f-классы для совместимости локальных шаблонов и штатный механизм layout-маркеров без дополнительной обёртки вокруг sticky-header. Типографика, кнопки, цвета, карточки, границы и контейнеры используют токены. Отдельный короткий assets/site.css примера сохраняет вес крупных заголовков 750 из исходного дизайна; обычные заголовки используют вес темы. Shadow примера задан none, поскольку исходные карточки не имеют теней; общий builtin поддерживает изменение этого токена.
Каталог содержит 17 встроенных фрагментов. content/steps использует прежний title/items; локальная копия ai-studio удалена, данные и ID блоков не изменены. data/entry_card имеет обязательный generic ref entry, to: '*', значение collection/slug. Фиксированные ref/refs сохраняют slug + to и прежнюю семантику. Generic picker получает только опубликованные записи включённых коллекций с публичными страницами; taxonomy без страницы исключается. Ссылки проверяются также во вложенных group/list/refs данных коллекции, даже если display их не использует. Resolver создаётся для workspace, а не заново для каждой записи.
entry_header дополнен summary/image/image_alt; form — title/description. Неограниченные списки, typed actions/query/bindings, slots, columns/page_header и прежний card_grid.variant:steps работают. Дополнительные подписи Hero/Entry, описания списков и знак бренда заданы данными примера.
Collection поддерживает requires: [feature.<имя>], схема остаётся 1. Выключенные courses/posts согласованы с features courses/blog; записи выключенной коллекции не попадают в query, релиз и generic picker. Некорректные/неизвестные requirements диагностируются. Структурная проверка workspace сохраняется; release-полнота отключённой коллекции не требуется.
Проверки
| Проверка | Результат |
|---|---|
| Полная unittest-регрессия | 338 тестов, 0 ошибок, 0 падений, 0 пропусков |
| Новые целевые тесты | 18: generic ref/refs, parser, published-target/feature checks, fixed compatibility, picker, taxonomy, сохранность current при отказе, вложенные ссылки, новый пример и списки длиннее трёх |
| Site Studio validate/build | 0 ошибок; 13 страниц, два редиректа, все локальные ссылки и ассеты доступны |
| Предупреждение нового примера | Одно ожидаемое W_THEME_GRADIENT_CONTRAST; визуальная оценка градиентов остаётся необходимой |
| AI Studio | validate без ошибок/предупреждений; 14 страниц, 18 сценариев QA, 70 проверок адаптивности |
| Тема/ширины после переноса CSS | Все 8 групп прежней browser QA: 6 пресетов, типографика/кнопки/градиенты, 243 геометрические комбинации, gutters, nested/sticky, конструктор/буфер/Save |
| Установленный wheel | Сборка, все пресеты, HTML/API, локальная статика и отдельный preview origin вне checkout, без design/ |
| Статические проверки | Ruff по изменённому Python и git diff --check прошли |
Полная регрессия использует HEAD-версию examples/studio-site во временном каталоге с актуальными site.yaml/theme.yaml. Пользовательский examples/studio-site/pages/index.md не менялся ради тестов. Это проверка базовой фикстуры, не заявление о проверке текущей пользовательской композиции. Независимый новый пример и ai-studio проверены в актуальном состоянии.
Браузерная сверка с исходником
scripts/qa_site_studio_002.py запускает настоящий FastAPI для изолированной копии нового примера и отдельный сервер исходного preview-dist. Chromium сравнивает 6 страниц (/, /about/, /services/, /services/bots/, /request/, /privacy/) на 1440/1280/1024/768/390/360 px, всего 36 сравнений. Для секций проверяются горизонтальная геометрия и фон; для страниц без расширенной формы также высоты и вертикальные координаты с допуском менее 1 px. Скриншоты desktop/mobile дополнительно просмотрены визуально.
Проверены отсутствие горизонтального переполнения, открытие FAQ с клавиатуры, отсутствие JS-ошибок, native dialogs и неожиданных HTTP-ошибок. Админка открывает новый пример; добавление entry_card предлагает ровно четыре опубликованные цели, сохраняет изменение в буфере до Save и восстанавливает его после Save/reopen.
Форма отличается от статического seed поведением и необходимым consent: используются настоящие action/method, версия схемы, honeypot и поле согласия со ссылкой на политику. Реальный POST возвращает HTTP 501, сообщение отображается рядом с формой; ввод сохраняется, перехода на thank-you нет. Backend приёма/доставки заявок не добавлялся. Статусы active/draft схем форм сохранены. Намеренно отсутствующая обложка draft booking видна как E_ASSET_MISSING в preview; черновик не блокирует релиз.
Артефакты в /tmp/site-engine-studio-002/: browser.json, unittest.log, package.log, public/source-{home,about,services,services-bots,request,privacy}-{1440,390}.png, constructor-1440.png; результаты прежних проверок — ai-studio/ и theme-regression/. Финальная сборка — dist/current/.
Повторный запуск
PYTHONPATH=src python -m site_engine.cli validate examples/site-studio
PYTHONPATH=src python -m site_engine.cli build examples/site-studio --out /tmp/site-studio-dist
PYTHONPATH=src:tests python -m unittest test_site_studio -v
PYTHONPATH=src python scripts/qa_site_studio_002.py
PYTHONPATH=src python scripts/qa_ai_studio.py
PYTHONPATH=src python scripts/qa_theme_002.py
PYTHONPATH=src python scripts/verify_package_001.py --site examples/site-studio
Для полной регрессии с сохранением пользовательского контента:
import sys
import tempfile
import unittest
from pathlib import Path
sys.path[:0] = ['tests', 'scripts']
import helpers
from qa_fragments_002 import baseline
with tempfile.TemporaryDirectory() as tmp:
helpers.EXAMPLE = baseline(Path(tmp))
suite = unittest.defaultTestLoader.discover('tests')
result = unittest.TextTestRunner(verbosity=2).run(suite)
if not result.wasSuccessful():
raise SystemExit(1)
Запускать с PYTHONPATH=src после установки server/dev. В этом окружении shell запускался с эскалацией из-за недоступности bwrap namespace; проверки выполнялись локально, внешние сервисы не использовались.
Передача на приёмку
Runtime-изменения требуют пересборки Docker-образа. Рабочие data/env, пользовательский design и страница studio-site не изменялись, live не публиковался. Коммитов этой работой нет; root examples остаются вне коммита. Пользовательская проверка на новой сборке — отдельная T059. После неё можно брать Theme Manager из исходных HTML/CSS/JS в этап 5.