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.
Site Studio — публичный дизайн на штатном движке
Отдельный пример на схеме 1, перенесённый из design/examples/site-studio/. Он не заменяет studio-site или ai-studio и не переключает рабочий SITE_ROOT.
Здесь 9 страниц, 8 записей и 5 layouts. Обычная сборка публикует 13 страниц: 9 ручных и 4 страницы записей (services/bots, services/ai, scenarios/legal, cases/ai-reception). Четыре записи со статусом draft исключаются. Два редиректа создаются отдельно: /bot/ → /services/bots/, /about-us/ → /about/.
Проверка и отдельный запуск
Из корня репозитория, после установки .[server,dev]:
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
SITE_ROOT="$PWD/examples/site-studio" SITE_DIST=/tmp/site-studio-dist SITE_STATE_DIR=/tmp/site-studio-state \
PYTHONPATH=src python -m uvicorn site_engine.web.app:create_app --factory --host 127.0.0.1 --port 8182
Сайт доступен на http://127.0.0.1:8182/. Для админки нужны обычные SITE_ADMIN_LOGIN, SITE_ADMIN_PASSWORD_HASH, SITE_SECRET_KEY из основного README; отдельное состояние остаётся в /tmp/site-studio-state. Переменные выше действуют для одной команды; рабочие Docker/env/data не меняются. Runtime-фрагменты поставляются в пакете движка, поэтому для Docker нужна пересборка образа.
Автоматическая приёмка на изолированной копии с настоящим FastAPI и Chromium:
PYTHONPATH=src python scripts/qa_site_studio_002.py
PYTHONPATH=src python scripts/verify_package_001.py --site examples/site-studio
validate выдаёт одно ожидаемое предупреждение W_THEME_GRADIENT_CONTRAST: фоновые градиенты требуют визуальной оценки контраста. Намеренно отсутствующая обложка cases/booking не мешает релизу; preview черновика показывает E_ASSET_MISSING.
Как адаптирован исходник
| Исходный seed | Штатный контракт |
|---|---|
heading |
title |
card1…3, step1…3, question/answer |
Списки items; количество не ограничено тремя |
button/buttonUrl |
actions со ссылками на ID страниц |
collection/sort/limit |
source: {query: …} |
source: body / entry.body |
content: {bind: page.body} / {bind: entry.body} |
| Строковые Jinja-выражения в SEO | {bind: entry.title} и {bind: entry.summary} |
Маршруты в меню и success.page |
ID страниц, например services/index, request, thank-you |
Поля формы с id, enabled, отдельная privacy |
key, активные поля, отдельный consent со ссылкой на privacy |
redirects.yaml: rules |
Список {from, to, status} |
| Неполные list/group | Явные of, fields, типизированные ссылки |
enabled: false у courses/posts |
requires: [feature.courses] / [feature.blog] и выключенные features в site.yaml |
slug/status/body — системные поля записи; они не дублируются в fields. Данные, статусы, тексты и изображения сохранены. Статические подписи вроде метки Hero и описания списка заданы в props, а не в шаблоне всех сайтов. Разметка и CSS общего builtin перенесены из seed, с сохранением slots, вариантов, типизированных ссылок и списков произвольной длины.
Layouts используют seo_head(), assets_head(), region(), assets_body(). Для демо сохранён noindex,nofollow. Локальных копий builtin, preview-dist и собственного mini-renderer здесь нет; public CSS/JS собирает движок. Тема находится в theme.yaml, ширины секций — в layout блоков. Объявленные роли цветов подключены к общим семантическим переменным. В assets/site.css сохранён особый вес крупных заголовков Hero/Entry (750) из исходного дизайна; обычные заголовки используют вес темы. Shadow в теме задан none, поскольку исходные карточки не имеют теней; изменение токена включает их в общем builtin.
Каталог содержит общие steps и entry_card. Ссылка карточки имеет вид:
- id: recommended_service
fragment: entry_card
props:
title: Рекомендуем
entry: services/bots
entry_card.entry — обязательный ref с to: '*'. Конструктор предлагает опубликованные записи всех включённых коллекций. Старые фиксированные ref/refs продолжают принимать slug с to: <collection>.
Формы
form_contact сохраняет статус active, form_brief — draft. Схемы и оформление перенесены; приём заявок ещё не подключён. Реальный POST /forms/form_contact возвращает HTTP 501, интерфейс показывает причину и сохраняет введённые значения. Переход на thank-you при отказе не выполняется. Страница thank-you сохранена как самостоятельная демонстрационная страница, её текст прямо поясняет отсутствие реальной отправки. Доставка email/Telegram не реализована; значения notification в seed служат только описанием схемы.