Files
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

12 KiB
Raw Permalink Blame History

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