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.
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.
Что совпадает с демо
Главная: 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 командой:
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.