Files
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

7.3 KiB
Raw Permalink Blame History

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.