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

60 lines
7.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.