Files
flexly-cms/design/CHANGELOG.md
T
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

24 KiB
Raw Blame History

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