Files
flexly-cms/specs/002-site-studio-theme/tasks.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

83 lines
12 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.
# Задачи 002 — Site Studio и Theme Manager
Дата: 2026-11-13. Основание: [spec.md](spec.md), порядок и зависимости: [plan.md](plan.md), фактическая проверка этапа 1: [verification.md](verification.md).
Отметка `[x]` означает выполненную работу. Пользовательская приёмка отмечается отдельной задачей; готовая спецификация не закрывает последующие этапы разработки. Следующий функциональный этап начинается после приёмки предыдущего, кроме явно разрешённого пользователем объединения этапов. Этапы 2–3 выполнены вместе по его поручению; ручная приёмка на сервере не подменяется разрешением продолжить.
## Документация
- [x] T001 Зафиксировать полный согласованный объём, источники дизайна и правила поэтапной приёмки.
- [x] T002 Зафиксировать решение theme.yaml/new-only без миграции, schema 1, отдельный Site Studio и формы только как схема/оформление.
- [x] T003 Описать архитектуру, API, состояния мастера, совместимость и проверки.
## Этап 1 — Категории и каталог
- [x] T010 Сохранить рекурсивное обнаружение по fragment.yaml и глобальные ID.
- [x] T011 Вычислять категорию по пути, сохранив flat/YAML/misc и смешанные каталоги.
- [x] T012 Добавить preview.yaml:props, приоритет по ключам, диагностику envelope/props/YAML, не менять имя фрагмента и форму API preview.
- [x] T013 Разложить 15 builtin по шести категориям, сохранить columns/page_header, сверить шаблоны и ресурсы с HEAD.
- [x] T014 Показать категории в каталоге, сохранить названия/описания/ID и ограничения allow.
- [x] T015 Добавить поиск по категории, объединить прежние русские подписи в UI, синхронизировать активный фильтр после HTML swap.
- [x] T016 Проверить плоский/вложенный/смешанный сайт, произвольные категории и глубину, несовпадение имени папки и ID, дубликаты и повреждённые файлы.
- [x] T017 Проверить API/HTML, sidecar false/0/defaults, add/preview без записи, save/reopen, ограничения slots/regions и экранирование.
- [x] T018 Проверить видимость повреждённого preview в JSON/publish/HTML и сохранность live при отказе.
- [x] T019 Проверить wheel с вложенными ресурсами и настоящий FastAPI/preview вне checkout.
- [x] T020 Проверить браузером desktop/mobile, фильтры/поиск/фокус, CSS в релизе, отсутствие JS/native-dialog/credential утечек; приложить скриншоты.
- [x] T021 Обновить AGENTS/README и отчёт о проверках; не менять дизайн и рабочие данные.
- [ ] T022 Пользовательская приёмка этапа 1 на новой сборке.
## Этап 2 — Файловая тема и релиз (реализован по поручению пользователя)
- [x] T030 Добавить ThemeDocument/EffectiveTheme, загрузку theme.file и диагностику старого inline-формата.
- [x] T031 Перенести шесть immutable preset@1 и разрешённые шрифты из дизайна в runtime-пакет.
- [x] T032 Реализовать единые validation/deep merge/Custom/CSS mapping с ограничениями токенов, цветов и градиентов.
- [x] T033 Реализовать безопасный default для нового сайта и ошибки явной плохой ссылки; не писать файл автоматически.
- [x] T034 Обновить конфигурации примеров и фикстур под новый формат в исходниках, сохранив контент.
- [x] T035 Подключить тему к bundle и всем preview, исключить перекрытие токенов defaults и влияние на админку.
- [x] T036 Зафиксировать тему/preset/version в релизе, расширить fingerprint ресурсами рендера, сохранить исторические релизы и rollback.
- [x] T037 Проверить все пресеты, Custom, воспроизводимость, контраст-warning, invalid input, installed wheel и отказ сборки без переключения current.
- [x] T038 Обновить runtime, документацию и отчёт о проверке этапа 2.
- [ ] T039 Пользовательская приёмка этапа 2 на новой сборке.
## Этап 3 — Ширина сайта и секций (реализован вместе с этапом 2)
- [x] T040 Добавить ContainerSettings и BlockLayout, строгие типы/enum/диапазоны/defaults и наследование.
- [x] T041 Провести layout через Page/Display/fixed/slots, снимки, API, формы и операции дерева.
- [x] T042 Перенести контролы инспектора из дизайна; сохранить Конструктор ↔ Эксперт, props edits, дублирование и YAML round-trip.
- [x] T043 Подключить рендер ширины без поломки вложенных блоков, sticky-header, anchors, preview markers и scroll.
- [x] T044 Проверить все режимы и пары ширины, gutters/breakpoints, mobile 360 px, отсутствие overflow и локальный выбор секции.
- [x] T045 Обновить runtime, OpenAPI и отчёт о проверке этапа 3.
- [ ] T046 Пользовательская приёмка этапа 3 на новой сборке.
## Этап 4 — Общие фрагменты и Site Studio (реализован по отдельному поручению пользователя)
- [x] T050 Перенести разметку/CSS публичных фрагментов из seed, сохранив ID, поля, описания, типизированные источники и slots.
- [x] T051 Добавить общий steps title/items, убрать локальный дубликат ai-studio и сохранить старый card_grid.variant:steps.
- [x] T052 Реализовать entry_card и generic ref to:'*' collection/slug в парсере, resolver, валидаторе и формах, не меняя фиксированные ref/refs.
- [x] T053 Дополнить entry_header и form необязательными полями из спецификации и подключить semantic tokens.
- [x] T054 Создать отдельный examples/site-studio с исходными данными/ассетами и адаптированными схемами, SEO, меню, формами и редиректами.
- [x] T055 Использовать штатные layout hooks, renderer/build; не копировать дубли builtin или mini-renderer.
- [x] T056 Проверить 13 страниц, статусы/битый draft, выключенные коллекции, ссылки/ассеты/redirects, схему форм и честный отказ отправки.
- [x] T057 Сравнить публичный сайт с design preview на desktop/mobile, проверить прежние примеры и списки более трёх элементов.
- [x] T058 Документировать отдельный запуск без переключения SITE_ROOT; обновить отчёт.
- [x] T059 Пользователь принял результат этапа 4 и разрешил этап 5: «Ну вот! Хоть какой то действительно хороший вариант получился. Давай теперь 5 этап.»
## Этап 5 — Theme Manager и onboarding (реализован; ожидает пользовательской приёмки)
- [x] T060 Реализовать ThemeService и OnboardingService, JSON endpoints/DTO и HTML-адаптер через текущий серверный API-клиент.
- [x] T061 Обеспечить Save через ContentService: точный путь, SiteLock/CAS/валидация/история/atomic write/аудит; создание с ABSENT.
- [x] T062 Реализовать ThemeSnapshot и ошибки 409 с текущим снимком, request_id, сохранением пользовательского ввода при 5xx/сети.
- [x] T063 Добавить overlay темы в изолированный PreviewStore, связать ответы с revision, сохранить CSP/origin/nonce и запрет JS сайта.
- [x] T064 Перенести Theme Manager из исходных HTML/CSS/JS Antirion: все четыре шага, пресеты, цвета/градиенты, шрифты/токены/ширину, desktop/mobile, YAML/export и диалоги.
- [x] T065 Заменить mock/localStorage API, исключить native alert/confirm/prompt/beforeunload, не создавать самостоятельный дизайн или frontend-сборку.
- [x] T066 Добавить серверный onboarding state, распознавание нового/существующего сайта, skip/restart/Save-complete и доступ текущего admin как владельца.
- [x] T067 Проверить два редактора/ETag/CSRF, рестарт/skip/repeat, сбои записи/аудита/сети, workspace/live/publish/rollback и отсутствие потери правок.
- [x] T068 Сверить UI с оригиналом на 1440/1280/1024/768/390/360 px, проверить клавиатуру/фокус, отсутствие переполнения, JS/CSP/HTTP-ошибок и влияния на skin админки.
- [x] T069a Проверить установленный пакет, полную регрессию, обновить OpenAPI/runtime/отчёт этапа 5.
- [ ] T069 Пользовательская приёмка Theme Manager на новой сборке. Проверки разработчика не заменяют её.
## Завершение
- [ ] T070 Сверить все FR/TH/WD/ST/UI/API/RL/AC требования с проверками и отметить ограничения без ложных заявлений.
- [ ] T071 Обновить документацию фактического runtime и статус 002 после всех приёмок. Не коммитить root examples и не публиковать/переключать рабочий сайт без отдельной задачи.