Files
flexly-cms/examples/site-studio/README.md
T
phelex 0d171915d7 Add Site Studio themes and Theme Manager
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.
2026-11-13 14:04:49 +03:00

6.6 KiB
Raw Blame History

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 служат только описанием схемы.