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.
167 lines
24 KiB
Markdown
167 lines
24 KiB
Markdown
|
||
|
||
## 2026-11-13 — Theme Manager / setup Wizard (дополнение к Этапу 7)
|
||
|
||
- Добавлен интерактивный мастер дизайна **публичного сайта** в 04 Antirion Rework и 06 Rose Graphite. Первичная настройка: готовые 5 presets + Custom → цвета → шрифты → tokens.
|
||
- Можно изменять выбранный пресет, просматривать Desktop/Mobile, получать предупреждения по контрасту, сохранять локальный draft и экспортировать пример `theme.yaml`. Нет реального `publish`.
|
||
- В Stage 6 `Настройки → Тема` прежняя мини-форма заменена входом в Theme Manager. Логика и палитры админки остались независимыми от пользовательской темы сайта.
|
||
- Добавлен `docs/stage7/07_THEME_MANAGER.md` и `adr/ADR-007.md`, уточнены сервисные контракты/план реализации. ADR-007 остаётся Proposed из-за отличия от inline `site.yaml.theme.tokens` в исходном ТЗ.
|
||
# Site Engine — Журнал изменений
|
||
|
||
## 2026-11-12 — Этап 6: завершение HTML-админки (04/06)
|
||
|
||
- Введены `modules-antirion.html` и `modules-rose-graphite.html`: единый shell + пять интерактивных разделов, согласованные темы Antirion Rework и Rose Graphite.
|
||
- **6.1 Медиа:** сетка/таблица, папки, локальная mock-загрузка, инспектор ассета, alt/caption, проверка missing, подтверждаемое удаление и «Где используется?».
|
||
- **6.2 Структура:** редактор меню, фиксированные Layout Regions и allow-фрагменты, каталог Fragment/Display, схематичный YAML и ограничения для разработчика.
|
||
- **6.3 Формы:** поля optional/required, mock-preview, список заявок, скрытие личных данных по ролям, статусы доставки, выгрузка синтетического CSV, предупреждения о версиях схемы при откате.
|
||
- **6.4 Настройки:** site.yaml, цвета сайта, общие данные, редиректы с проверкой циклов, роли, MCP-scopes без реальных токенов, параметры сборки.
|
||
- **6.5 Журнал:** события операций, чтение mock-аудита Stage 5, фильтры и экспорт, ролевой доступ, `Ctrl+K` и адаптивность.
|
||
- Переходы в новые разделы встроены в shell 04/06, редактор Page/Entry и публикационный экран; старые редакторы и все четыре зафиксированные концепции сохранены.
|
||
- Исправлена ширина сетки чекбоксов в компактном инспекторе форм; мобильная навигация проверяется после завершения CSS-анимации.
|
||
- Тесты на десяти экранах (5 разделов × 2 темы), на 1440×900 и 390×844, и шести ширинах для основного сценария: без ошибок JS и без общего горизонтального переполнения.
|
||
- **Ограничения:** клиентские роли не реализуют безопасность; данные Stage 6 и Stage 5 сохраняются в отдельных mock-store; реальная файловая и серверная интеграция не выполнена.
|
||
|
||
---
|
||
|
||
## 2026-11-11 — Этап 4: Контент и коллекции
|
||
|
||
- **Два новых интерактивных редактора** `content-antirion.html` и `content-rose-graphite.html` на базе утверждённых 04/06, без изменения shell и конструктора страниц.
|
||
- Каталог 5 коллекций, поиск/фильтры записей, create/edit/duplicate/delete (с подтверждением), пустые/выключенные коллекции и тестовый большой список.
|
||
- Схемный Конструктор полей Entry (`text`, `textarea`, `number`, `boolean`, `select`, `date`, `asset`, `refs`, `list`, `group`, `markdown`) с обязательными полями и ошибками.
|
||
- Связи Entry → Entry, выбор из UI, «Где используется?» и переходы в связанные записи; проверки ссылок и битого медиа.
|
||
- Два вида превью через mock Display template (карточка/полная страница); Workspace и Live снимок `build_00027` чётко разведены.
|
||
- Режим Эксперт YAML front matter + Markdown с общим state, подсветкой, номерами строк, diff, защитой от неверной структуры, резервной копией и mock 409.
|
||
- Сохранение локального workspace без публикации, подтверждение ухода с несохранёнными изменениями; `localStorage` при доступности.
|
||
- Раздел «Контент» в админках 04/06 связан с редактором; сохранённые записи читаются в обзоре коллекций, если доступен общий localStorage.
|
||
- Не менялись другие два утверждённых оформления (03, 05), страницы Конструктора 2–3 и правило скруглений в Rose Graphite.
|
||
- Восстановлены и проверены 6 ширин: 1440×900, 1280×800, 1024×768, 768×1024, 390×844, 360×740. Исправлен scroll/layout редактора на широком экране.
|
||
- Прототип без серверной интеграции. Дальше — Этап 5 «Публикация / История / Откат».
|
||
|
||
|
||
## 2026-11-11 — Исправление переключателя режима редактора (Этап 3)
|
||
|
||
- Восстановлено явное состояние `mode: constructor` при первом открытии редактора страницы.
|
||
- Верхний переключатель теперь сразу выделяет «Конструктор», а при переходе в «Эксперт» и обратно показывает правильный выбранный режим.
|
||
- Добавлены `aria-pressed` для корректной доступности переключателя.
|
||
- Проверено в Chromium для 04 Antirion Rework и 06 Rose Graphite. Остальные варианты не изменены.
|
||
|
||
# Site Engine Admin — история изменений
|
||
|
||
## Этап 3 — Expert: YAML / Markdown, round-trip и конфликты (2026-11-11)
|
||
|
||
- Новые UI «Эксперт» в `builder-antirion.html` и `builder-rose-graphite.html`: файловое дерево, редактор исходника с номерами строк, подсветкой, поиском, форматированием, Markdown и мини-превью.
|
||
- Подключён общий Page model: `Constructor → YAML/Markdown → Constructor`. `Page`, `regions.main`, `Block`, `props`, `bindings` и SEO не существуют в виде отдельной независимой модели в Expert.
|
||
- Офлайн-парсер YAML **ограниченного явно описанного подмножества**: mappings, lists, quoted strings, bool/number/null и multiline `|-`; неизвестные поля/Fragment ID, неподдерживаемый синтаксис, нарушения схемы, дубликаты ID блокируют применение. Эксперт не обходит публикационную валидацию.
|
||
- При ошибочном YAML raw-буфер остаётся доступен, превью и состояние Page не перезаписываются. Переключение в Конструктор или другой файл предлагает исправить/скопировать или сознательно отбросить исходник.
|
||
- Комментарии в YAML: предупреждение перед переходом в Конструктор и перед форматированием. Резервная копия исходника сохраняется, перед последующей пересериализацией требуется подтверждение; комментарии не теряются молча.
|
||
- Построчный source diff Workspace ↔ Saved Draft / Live, `line/path` ошибок, адаптивный режим и совместимость с предыдущими функциями 2.1–2.4.
|
||
- Mock optimistic concurrency: `if_match` как локальная ревизия; демонстрация `409 Conflict` с сравнением my/server, явное подтверждение перезаписи или принятие mock-server версии. Никакой реальной серверной записи и прав доступа нет.
|
||
- Проверены обе темы в Chromium на разрешениях 1440×900, 1280×800, 1024×768, 768×1024, 390×844 и 360×740; добавлены QA для round-trip, multiline YAML, конфликтов и защиты raw-источника.
|
||
- Согласованные 03 Antirion, 04 Antirion Rework, 05 Ember Graphite, 06 Rose Graphite сохранены; активные редакторы только 04/06. Нет вариантов 01/02 и Violet Night.
|
||
|
||
---
|
||
|
||
# История изменений Site Engine Admin
|
||
|
||
## Этап 2.4 — Draft / Validation / Diff (2026-11-11)
|
||
|
||
- Новый статус workspace и последнего сохранения; live `build_00027` по-прежнему неизменяем в mock.
|
||
- Интерактивная публикационная mock-проверка с типами проблем, фильтрами и переходом прямо к проблемному полю.
|
||
- SEO title / description, счётчики длины, SERP-превью, упрощённый Markdown-просмотр и быстрый richtext.
|
||
- Сравнение с Saved draft и Live: структурные отличия + схематичное визуальное сопоставление.
|
||
- Подтверждаемое восстановление workspace, сохранение локального черновика с отметкой времени, обработка недоступного localStorage.
|
||
- Предыдущие операции конструктора и маппинга сохранены; стили 03–06 не менялись.
|
||
- QA: оба конструктора и шесть разрешений; пройдены проверки интерактивности/адаптивности.
|
||
|
||
---
|
||
|
||
# CHANGELOG · Site Engine Admin
|
||
|
||
## 2026-11-10 — Этап 2.3: source mapping / обратные зависимости
|
||
|
||
- Общая модель Page/Block дополнена структурированным mock-каталогом `Collection`, `Entry`, `Asset`, `Data` и публичных маршрутов.
|
||
- В разделе «Связи данных» реализован маппинг каждого поля: блок, Fragment, тип источника, путь, состояние и отображаемое значение.
|
||
- В Inspector → «Связи» добавлена диагностика по полям и выбор источника без YAML. Поддерживаются literal, bind, collection query, ref, asset и page/entry link.
|
||
- Добавлен Fragment `entry_card` с конкретным Entry, query сортировка (`order`/`title`) и limit, каталог данных.
|
||
- Реализован «Где используется?» по всем демо-страницам, включая зависимость записи через collection_list, переход к использующему блоку.
|
||
- Ошибки: отсутствующие коллекции, ссылки и записи, неразрешённые bindings. Предупреждения: неопубликованные ссылки/entries, отсутствующие assets, пустая коллекция.
|
||
- Сохранены исходные сценарии этапа 2.1–2.2, в том числе iframe без перезагрузки, клики в дереве с прокруткой и клики в превью без скачка.
|
||
- Оба активных оформления 04 и 06 используют общий JS и собственные согласованные палитры. Варианты 03/05 остались без изменений.
|
||
- QA: 12 комбинаций двух тем и шести ширин (1440, 1280, 1024, 768, 390, 360), разметка без горизонтального переполнения, ошибок JS нет; отдельные сценарии binding, ref, where-used, asset и validate.
|
||
|
||
|
||
## 2026-11-10 — Навигация по блокам из дерева (Этап 2.2)
|
||
|
||
- Клик по блоку в левом дереве или в разделе «Связи данных» теперь выделяет и прокручивает iframe-превью к выбранному блоку. Если блок уже полностью виден — прокрутки нет.
|
||
- При выборе фиксированного `site_header` выполняется переход к началу страницы, `site_footer` — к подвалу.
|
||
- При клике непосредственно по блоку в iframe выделение синхронизируется с деревом и инспектором **без прокрутки**; редактирование полей также не сбрасывает позицию.
|
||
- Добавление, дублирование, перестановка кнопками или drag & drop прокручивают к новой позиции блока после обновления превью.
|
||
- Поддержка системной настройки `prefers-reduced-motion`: анимация отключена для пользователей, ограничивающих движение.
|
||
- Выбор блока больше не сбрасывает прокрутку левого дерева. Обе темы используют единый JS.
|
||
- Регрессионные проверки в Chromium через Playwright на 1440×900, 1024×768, 390×844 и 360×740, а также тесты редактирования без скачков прокрутки.
|
||
|
||
## 2026-11-10 — Исправление прокрутки при выборе блоков
|
||
|
||
- Выбор блока внутри iframe и в дереве больше не пересоздаёт iframe и не сбрасывает прокрутку к началу.
|
||
- Подсветка выбранного блока синхронизируется между деревом, инспектором и превью через `postMessage`.
|
||
- При редактировании полей содержимое preview обновляется на месте; положение прокрутки сохраняется.
|
||
- Проверено для `builder-antirion.html` и `builder-rose-graphite.html` в Chromium: клики внутри preview, выбор из дерева, редактирование заголовка. Ошибок JavaScript нет.
|
||
|
||
## 2026-11-10 — Этап 2: конструктор страниц (04 + 06)
|
||
|
||
- Сохранены четыре согласованных базовых дизайна: **03 Antirion**, **04 Antirion Rework**, **05 Ember Graphite**, **06 Rose Graphite**.
|
||
- Название **06 YuE Studio → 06 Rose Graphite**. Переименованы основные HTML/CSS/JS, в галерее обновлены ссылки и описания. Палитра и частная правка коллекций сохранены.
|
||
- Добавлены `builder-antirion.html` и `builder-rose-graphite.html`. Редактор построен на общем JS/data-state и двух визуальных темах.
|
||
- Реализованы mock Page selection, layout/region tree, блоки с устойчивыми ID, schema-driven inspector, iframe preview + Desktop/Tablet/Mobile, режим отображения workspace/live.
|
||
- Реализованы каталог Fragment, добавление, перемещение (кнопки и drag-and-drop), дублирование, удаление с подтверждением, видимость, Anchor и Note.
|
||
- Добавлен переключатель `Дерево блоков / Связи данных`, простые literal/bind/query и визуальные маршруты источников; редактирование Markdown body и SEO на вкладке «Страница».
|
||
- Добавлены индикатор несохранённости, локальное сохранение в localStorage, проверка ошибок/предупреждений, локальный diff, кнопка «Эксперт» с объяснением границ следующего этапа.
|
||
- В вариантах 04 и 06 кнопка «Редактор» теперь открывает Конструктор с выбранной страницей.
|
||
- Проведён Playwright QA на шести размерах экранов для обеих тем. Бэкенд, реальные файлы, права доступа и публикации остаются вне этого этапа.
|
||
|
||
## 2026-11-10 — Зафиксированный дизайн Этапа 1
|
||
|
||
- 03 Antirion — компактный графитово-бирюзовый.
|
||
- 04 Antirion Rework — строгий светлый/тёмный интерфейс.
|
||
- 05 Ember Graphite — медно-оранжевые градиенты.
|
||
- 06 Rose Graphite (ранее YuE Studio) — почти чёрный с розовыми акцентами, выбор коллекций без скруглений, остальные таблицы и панели со скруглениями.
|
||
- Исключены старые зелёные 01/02 и отвергнутый Violet Night.
|
||
|
||
## 2026-11-12 — Этап 5: Публикация, история релизов, откат
|
||
|
||
- Новые рабочие HTML-прототипы `publication-antirion.html` и `publication-rose-graphite.html` с общими CSS/JS и двумя темами; утверждённые дизайны 03 и 05 сохранены без изменений.
|
||
- Добавлен путь `workspace → validate → candidate → publish → live`, с разделением сохранённых черновиков, кандидата и публичного снимка.
|
||
- Показаны изменения файлов Page / Entry / Menu / Asset, фильтры, diff данных и схематичное visual diff; сохранённые данные старых редакторов подгружаются в демо-workspace.
|
||
- Строгая демо-проверка: ошибки блокируют кандидата, предупреждения не блокируют; можно исправить демо-привязку формы; отдельное предупреждение о совместимости версий формы при откате.
|
||
- Кандидат фиксирует копию всех файлов; кандидат со старым fingerprint или старым live не публикуется. Отдельный сценарий failed build не изменяет live.
|
||
- История неизменяемых снимков, детали релизов, журнал build/publish/rollback, подтверждаемый откат live без изменения workspace. История отдельного документа выделена в самостоятельный UX.
|
||
- Демо-роли owner/developer/editor/reviewer; publish, rollback и build ограничены в UI. Real RBAC остаётся серверной задачей.
|
||
- Переходы в публикационный workflow подключены в разделы 04/06, а также в редакторы Page и Entry; исправлены deep links из галереи.
|
||
- Проверены мобильные и десктопные разрешения, smoke-тесты в двух темах. Это только HTML/CSS/JS без backend.
|
||
|
||
## 2026-11-12 — Этап 7: технический handoff FastAPI/Jinja2/htmx
|
||
|
||
- Добавлен `docs/stage7/`: архитектура модульного монолита, карта Jinja partials/htmx, file-first DTO + сервисные контракты, CAS/409, RBAC/CSRF, preview isolation, immutable candidate/publish/rollback, форма/outbox, vertical slices V0–V7.
|
||
- Добавлен `docs/stage7/adr/ADR_REGISTER.md`: 6 предложенных (не утверждённых) ADR для ключевых системных решений.
|
||
- Добавлены примеры YAML/Markdown/JSON и готовое задание `IMPLEMENTATION_HANDOFF_PROMPT.md`.
|
||
- Приложены исходные ТЗ и архитектурное ревью в неизменённом виде; источник и рекомендация разграничены.
|
||
- Сохранены 4 утверждённых HTML-концепта и функциональные экраны Этапов 2–6 без изменений их JS/CSS.
|
||
- **Backend не реализован:** этап является проектированием интеграции.
|
||
|
||
## 2026-11-13 — Theme Manager extensions + example site-studio
|
||
|
||
- Согласовано: без браузерных `alert()`, `confirm()`, `prompt()`. Подтверждения — собственные dialogs, результаты — toast/inline. Из `content-editor.js` удалён нативный `prompt()` поиска по исходнику.
|
||
- Theme Manager: расширяемые именованные цвета и необязательные градиенты для публичного сайта (Hero, кнопки, CTA, пользовательские роли). Экспорт в `theme.yaml`; fallback без градиентов.
|
||
- Создан `examples/site-studio/`: Pages, Collections/Entries, Layouts, Fragments, Displays, Forms, Menus, Data, Assets, YAML-тема и redirects. Сгенерирована проверяемая автономная `preview-dist/` с 13 страницами.
|
||
- Пример — единая file-first seed-модель для будущей интеграции; действующие HTML-редакторы по-прежнему работают на локальных mock и не читают seed напрямую.
|
||
- Добавлены `tools/render_preview.py`, `tools/validate_example.py`, README примера и превью главной в галерею.
|
||
|
||
|
||
## 2026-11-13 — Container width modes
|
||
|
||
- В Theme Manager добавлены Boxed, Fluid, Full Width с максимальной шириной и адаптивными отступами.
|
||
- Оба редактора страниц получили независимый выбор внешней и внутренней ширины блока, поддерживающий режим наследования.
|
||
- YAML режима Эксперт, сравнение изменений и предпросмотр сохраняют `layout.section_width / content_width`.
|
||
- Обновлены образец `examples/site-studio/`, рендер публичного превью и описание интеграции в Этапе 7.
|
||
- Сохранены все четыре согласованных оформления 03–06. `alert/confirm/prompt` не используются для сообщений.
|