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.
This commit is contained in:
2026-11-13 14:04:49 +03:00
parent 231490bb7c
commit 0d171915d7
408 changed files with 11812 additions and 550 deletions
+63
View File
@@ -0,0 +1,63 @@
# 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]`:
```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
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:
```bash
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`. Ссылка карточки имеет вид:
```yaml
- 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 служат только описанием схемы.