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.
This commit is contained in:
@@ -0,0 +1,82 @@
|
||||
# Задачи 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 и не публиковать/переключать рабочий сайт без отдельной задачи.
|
||||
Reference in New Issue
Block a user