# Задачи 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 и не публиковать/переключать рабочий сайт без отдельной задачи.