Files
flexly-cms/design/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

45 lines
6.2 KiB
Markdown

# Site Studio — пример file-first сайта для Site Engine
Это **полный файловый seed** студии автоматизации, который собирает воедино демонстрационные страницы, блоки, записи и настройки из HTML-превью Site Engine. Все данные и контакты вымышлены. Это **не production-сайт** и не подтверждение работы FastAPI или BuildService.
## Каталоги
- `site.yaml` — сайт, маршруты, фичи и ссылка на тему; `theme.yaml` — пресет + overrides, кастомные цвета и **опциональные** градиенты. Отдельный файл темы предложен в ADR-007 (решение ещё требует утверждения).
- `pages/**/*.md` — ручные страницы с YAML front matter, `regions.main`, стабильными ID блоков и Markdown body.
- `collections/*.yaml` — схемы пяти типов записей. `content/<collection>/*.md` — записи (8 шт.); `courses` и `posts` специально выключены и не содержат записей.
- `display/*.yaml` — правила сборки страниц из Entry, `layouts/*/layout.yaml` и `layout.html.j2` — регионы и fixed header/footer.
- `fragments/<категория>/<id>/` — по одному `fragment.yaml`, `template.html.j2`, `preview.yaml` для каждого фрагмента.
- `menus/`, `data/`, `forms/`, `redirects.yaml` — навигация, общие данные, схемы форм, редиректы.
- `assets/` — собственные локальные абстрактные иллюстрации-заглушки (не реальные фотографии), метаданные, CSS и JavaScript сайта.
- `tools/render_preview.py` — **вспомогательный мини-рендерер** для просмотра файлов в браузере; не заменяет production engine и не моделирует ReleaseService.
- `preview-dist/` — статические HTML-страницы, уже собранные мини-рендерером для просмотра без backend.
Подробное сопоставление экранов и файлов — [`SOURCE_MAP.md`](SOURCE_MAP.md).
## Что совпадает с демо
Главная: Hero «Автоматизируем бизнес с помощью AI», `services_list`, преимущества, этапы, CTA. Есть «Услуги», «О компании», «Контакты», «Заявка», «Политика», «Спасибо», списки кейсов и сценариев. Записи `services/bots`, `services/ai`, `services/automation`, `scenarios/legal`, `scenarios/real-estate`, `scenarios/services`, `cases/ai-reception`, `cases/booking` отражают имена и содержимое редактора Content. `form_contact` соответствует настройкам форм Stage 6.
**Нормализация прототипа:** в разных HTML-модулях встречаются пути `media/*.webp` и `assets/*.webp`, ID `layouts/standard` vs `layouts/default`, разные mock-наборы и несколько независимых `localStorage`. Здесь все источники сведены в **одну файловую модель** с каноническим каталогом `assets/`. Поэтому отдельные имена/пути отличаются от локальных моков, а существующие HTML-редакторы **ещё не читают эти файлы напрямую**. Это произойдёт только после подключения сервисного слоя.
`content/cases/booking.md` — **преднамеренный черновик с отсутствующим** `assets/missing-cover.webp`, для проверки UI-валидации. Он не включается в live preview. Настоящий релиз должен блокировать публикацию битых ссылок, если такая запись входит в кандидат.
## Локальный просмотр
Открой `preview-dist/index.html` двойным нажатием — относительные ссылки на страницы и ассеты работают без запуска сервера. При изменении YAML/Markdown можно пересобрать demo-preview командой:
```bash
python tools/render_preview.py
```
Зависимости мини-рендерера: `PyYAML`, `Jinja2`, `mistune`, `Pillow` нужен только для повторной генерации графических ассетов из сценария сборки. Сам `preview-dist/` полностью автономен и не требует Python.
## Безопасность
Никаких `alert()`, `confirm()` или `prompt()`; формы в preview **не отправляют данные**. Пароли, API-токены, заявки, реальный контактный адрес или личные данные в примере отсутствуют. `site.example` и `studio.example` — демонстрационные значения. UI-статусы `published` не означают, что релиз действительно публиковался сервером.
## Container modes (новое)
`theme.yaml` задаёт глобальный режим `boxed | fluid | full`, `max_width`, отступы для desktop/tablet/mobile. Пример главной `pages/index.md`: **Hero** full background + boxed text, **services_list** fluid section + fluid content, **CTA** full + boxed. Все остальные фрагменты наследуют настройки, если не переопределено `layout` блока. `preview-dist` пересобирается через `python tools/render_preview.py`. Админка Theme Manager и оба Конструктора показывают те же варианты в рамках mock.