# Проверка этапа 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/. ## Повторный запуск ```bash 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 ``` Для полной регрессии с сохранением пользовательского контента: ```python 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.