Files
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

64 lines
6.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 служат только описанием схемы.