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
+50 -1
View File
@@ -11,7 +11,7 @@ pip install -e ".[dev]" # ядру нужны jinja2, PyYAML, ma
site-engine validate examples/studio-site
site-engine build examples/studio-site --out /tmp/studio-dist
site-engine preview examples/studio-site drafts/next > /tmp/draft.html
site-engine fragments # 15 встроенных фрагментов
site-engine fragments # 17 встроенных фрагментов
make test # или: pytest
```
@@ -19,6 +19,55 @@ make test # или: pytest
Расширенный пример для проверки перед возможным переносом сайта — [examples/ai-studio](examples/ai-studio/README.md), также на схеме версии 1: услуги, сценарии, кейсы, обложки, связи и понятные схемы полей. Проверка: `site-engine validate examples/ai-studio`, сборка: `site-engine build examples/ai-studio --out /tmp/ai-studio-dist`, браузерная приёмка: `PYTHONPATH=src python scripts/qa_ai_studio.py`. `studio-site` остаётся базовой фикстурой; отдельный запуск нового примера описан в его README.
Отдельный перенос публичного дизайна из `design/examples/site-studio/` — [examples/site-studio](examples/site-studio/README.md): 13 страниц, пять layouts, общие `steps` и `entry_card`, файловая тема и ширины секций, сохранённые черновики и отключённые коллекции. `site-engine validate examples/site-studio`, `site-engine build examples/site-studio --out /tmp/site-studio-dist`; браузерная сверка с оригиналом — `PYTHONPATH=src python scripts/qa_site_studio_002.py`. Отчёт — [этап 4](specs/002-site-studio-theme/verification-stage-4.md).
## Каталог фрагментов
Фрагмент определяется файлом `fragment.yaml`, поиск рекурсивный. Поддерживаются прежнее плоское размещение `fragments/richtext/fragment.yaml` и категории `fragments/content/richtext/fragment.yaml`. ID берётся из манифеста и не зависит от имени папки; в блоках по-прежнему указывается `fragment: richtext`.
Для вложенного размещения категория определяется первым каталогом относительно `fragments/` и имеет приоритет над `category` в YAML. Для плоского размещения сохраняется категория из YAML, по умолчанию `misc`. Встроенные фрагменты разложены по `content`, `data`, `forms`, `marketing`, `media`, `system`; дополнительные категории сайта допустимы. Повторные ID, включая совпадения с builtin, запрещены.
В конструкторе категория видна рядом с названием; назначение остаётся под названием. Поиск учитывает ID, название, описание и категорию, фильтры объединяют прежние русские подписи со стандартными категориями.
Данные для добавления блока можно вынести в соседний `preview.yaml`:
```yaml
name: Пример текстовой секции
props:
title: Новый раздел
text: Начальный текст раздела
```
`props` из этого файла переопределяет одноимённые значения inline `fragment.yaml:preview`, затем применяются defaults полей. Название самого фрагмента остаётся в `fragment.yaml:name`. Некорректный preview входит в диагностику загрузки и не пропускается молча.
Этапы 1–5 [спецификации 002](specs/002-site-studio-theme/spec.md) реализованы: категории, файловая тема, ширина блоков, отдельный Site Studio и Theme Manager. Экран `/admin/theme` доступен через «Дизайн сайта»; для нового сайта мастер открывается через `/admin/setup/theme`. [Отчёт этапа 5](specs/002-site-studio-theme/verification-stage-5.md) подготовлен к пользовательской приёмке.
## Тема и ширина секций
В `site.yaml` тема подключается через `theme: {file: theme.yaml}`. Документ темы:
```yaml
schema: 1
preset: minimal
preset_version: 1
overrides:
colors:
primary: '#4255b9'
ui:
container:
mode: boxed
max_width: 1080
gutter: {desktop: 36, tablet: 24, mobile: 16}
```
Доступны перенесённые из дизайна пресеты `minimal`, `dark`, `editorial`, `bold`, `natural`, `custom` версии 1. Один resolver проверяет цвета, разрешённые шрифты, числовые токены, дополнительные цвета и градиенты для CLI, сборки и preview. Недостаточный контраст — предупреждение. Без настройки темы новый сайт использует minimal@1 без записи файла; явная неправильная ссылка и старый inline `theme.tokens` дают ошибку. Конфигурации `studio-site` и `ai-studio` обновлены в исходниках; автоматической миграции нет.
Блок может задать `layout: {section_width: full, content_width: boxed}`: первая ширина отвечает за фон секции, вторая — за содержимое. Допустимы `inherit`, `boxed`, `fluid`, `full`; наследование идёт от темы. В конструкторе эти поля находятся в инспекторе «Макет блока · ширина» и сохраняются в YAML при явном Save. Изменение preview не записывает страницу.
Theme Manager переносит четыре шага исходного Antirion: пресеты, цвета/градиенты, шрифты, дизайн-токены/ширину. Правки остаются в памяти вкладки до «Сохранить тему»; YAML экспортируется после серверной проверки. Стенд компонентов и реальная страница используют изолированное серверное превью. Save изменяет workspace, публикация — отдельное действие. Состояние мастера (пропуск/повтор/завершение) хранится в `SITE_STATE_DIR/theme-onboarding.json`; палитры в нём нет. Для новых ресурсов нужна пересборка образа. Проверка: `PYTHONPATH=src python scripts/qa_theme_manager_002.py`.
Тема и вычисленные токены фиксируются в `manifest.json` релиза; fingerprint учитывает файлы сайта и ресурсы рендера. Откат возвращает готовый HTML/CSS выбранного релиза, сохраняя рабочие файлы. Подробный контракт и таблица CSS-переменных — [runtime 002](specs/002-site-studio-theme/runtime.md), приёмка — [проверки этапов 2–3](specs/002-site-studio-theme/verification-stages-2-3.md).
## Структура проекта
```