Add the shared document API, constructor and expert editors, isolated preview, and fragment catalog metadata with typed block IDs. Include design references, specification 001, QA scripts, project guidance, and cached Docker dependency installation. Leave example sites for a separate commit.
142 lines
21 KiB
Markdown
142 lines
21 KiB
Markdown
# 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 не реализован:** этап является проектированием интеграции.
|