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.
7.3 KiB
Site Engine — полный HTML-проект + Этап 7: backend handoff
Статус: Этапы 1–6 — интерактивный дизайн-прототип; Этап 7 — техническое проектирование переноса, без реализации backend.
Дополнение от 13.11.2026 — examples/site-studio и расширенные темы
examples/site-studio/— полный файловый пример публичного сайта: 9 ручных страниц, 8 Entries в 5 коллекциях, 5 Layouts, 15 Fragments, 5 Display templates, 2 схемы форм, меню, data, redirects, ассеты,site.yaml,theme.yaml.examples/site-studio/preview-dist/index.html— 13 уже собранных HTML-страниц; доступны локально. Пересборка:python examples/site-studio/tools/render_preview.pyпри наличии PyYAML, Jinja2 и mistune.theme.yamlсодержит стандартные семантические цвета, пользовательскиеcustom_colorsи опциональные именованныеgradients(enabled: false= однотонные фоны). Это конфигурация публичного сайта, а не Antirion/Rose theme админки.- Мастер Theme Manager в обоих оформлениях позволяет добавлять свои цвета/градиенты, проверять превью и экспортировать
theme.yaml; подтверждения — только собственные модальные окна, уведомления — toast/inline, без нативныхalert()/confirm()/prompt(). - Убрана последняя нативная
prompt()из редактора исходника Entry; вместо неё кастомный поиск. - Файлы примера ещё не подключены к HTML mock-редакторам. Их разрозненные
localStorageдолжны быть заменены этими file-first документами после реализации backend. Пример также не является production-renderer: статическое HTML создаёт вспомогательный mini-renderer.
Дополнение от 13.11.2026 — Theme Manager / первый вход
В пакет добавлен отдельный дизайн-прототип настроек публичной темы сайта для двух активных тем админки: theme-studio-antirion.html и theme-studio-rose-graphite.html. Пять готовых пресетов + Custom, палитра, шрифты, дизайн-токены, превью, локальное сохранение черновика и экспорт примера theme.yaml. Из modules-*.html?section=settings → вкладка «Тема» — ссылка на мастер. Реального backend и изменения live нет.
Техническое дополнение: docs/stage7/07_THEME_MANAGER.md, открытый ADR-007. В исходном ТЗ токены inline в site.yaml; выделение theme.yaml ещё требует архитектурного утверждения. Утверждённые четыре дизайна 03–06 сохранены, оболочки старых экранов неизменны, кроме ссылки на мастер в «Настройках».
Быстрое открытие
index.html— галерея четырёх утверждённых визуальных вариантов 03–06.builder-antirion.html/builder-rose-graphite.html— Конструктор и Эксперт.content-antirion.html/content-rose-graphite.html— коллекции и записи.publication-antirion.html/publication-rose-graphite.html— публикация, история, rollback (mock).modules-antirion.html/modules-rose-graphite.html— Медиа, Структура, Формы и заявки, Настройки, Журнал.theme-studio-antirion.html/theme-studio-rose-graphite.html— Theme Manager, мастер первоначальной настройки публичной темы.
Этап 7 — документы
Начать с docs/stage7/README.md.
Далее: архитектура, Jinja/htmx map, file-first contracts и DTO, security/release, план срезов V0–V7, аудит прототипа, 6 предложенных ADR и готовый prompt для кодового агента.
Источники
- Исходный
TZ-site-engine.mdи независимоеTZ-site-engine-architecture-review.mdприложены вdocs/stage7/reference_*.mdкак неизменённые источники для согласования. - Старый README Этапа 6 доступен в
docs/README_STAGE6.md.
Важно
Новых API, БД, логина, реальной публикации или серверного сохранения в этом пакете нет. HTML/CSS/JS старого проекта сохранены как UX-baseline. Нельзя переносить независимые localStorage seed-модели в production как систему хранения.
Целевой стек: Python 3.12+, FastAPI, Jinja2, htmx, Pydantic v2, SQLAlchemy 2, SQLite WAL, Alembic. Основные активные оформления: 04 Antirion Rework и 06 Rose Graphite. В дизайне 06 без скруглений только выбор коллекции в разделе «Контент»; остальные таблицы остались с исходным оформлением.
Как использовать с кодовым агентом
Передайте агенту весь ZIP, попросите прочитать docs/stage7/IMPLEMENTATION_HANDOFF_PROMPT.md. Согласуйте ADR-001/002/003/004/005/006/007, затем V0 и V1; не пытайтесь реализовать все модули одновременно.
Для общего localStorage текущего mock между вкладками можно открыть прототип через python -m http.server 8000, но это не сервер CMS.
Обновление: Fluid / Boxed / Full Width
- Theme Manager (
theme-studio-antirion.html,theme-studio-rose-graphite.html) → шаг 4 «Дизайн-код» — режим, max width, отступы. - Конструкторы (
builder-antirion.html,builder-rose-graphite.html) → инспектор блока → независимые настройки Внешняя секция / Контент. - Эксперт показывает
layout.section_widthиlayout.content_widthтого же блока; unsupported values не применяются. - Демо-файлы
examples/site-studio/theme.yaml,pages/index.mdиpreview-dist/обновлены. - Это всё ещё HTML mock без server-side persistence; в backend будет нужна отдельная валидируемая схема LayoutTokens.