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.
24 KiB
24 KiB
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 из-за отличия от inlinesite.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не используются для сообщений.