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