# 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`](docs/stage7/07_THEME_MANAGER.md), открытый [`ADR-007`](docs/stage7/adr/ADR-007.md). В исходном ТЗ токены 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`](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.