Files
flexly-cms/specs/001-antirion-admin/design-transfer.md
T

36 KiB
Raw Blame History

Повторный перенос дизайна 001

Дата: 2026-11-12. Основание — замечания пользователя о несоответствии оформления и поведения оригинальной вёрстке. Функциональные проверки прежней реализации не подтверждали точность переноса дизайна; визуальная приёмка 001 открыта повторно.

Порядок работы и проверки

Каждый этап передаётся пользователю на проверку. Следующий этап начинается после его проверки. Во всех этапах исходные HTML/CSS/JS из design/ задают композицию, размеры, иконки и поведение; адаптация подключает реальные данные и действия через существующий FastAPI-контракт. Демонстрационные роли, проверки и публикации не переносятся как фиктивные рабочие функции.

Этап Что переносим Источник Проверка пользователя
1. Общий каркас Sidebar, группы и пункты навигации, логотип, верхняя панель, быстрый поиск, профиль, темы, сворачивание, мобильное меню antirion-rework.html, assets/antirion-rework.css, assets/antirion-rework.js: sidebar/topbar/command Принят пользователем; разрешён этап 2
2. Обзор и страницы Композиция обзора, счётчики, поиск/фильтры, выбор строки, правый инспектор, создание страницы в модальном окне Те же исходники: overview/pages/rows/inspector/new Принят пользователем; разрешён этап 3
3. Редактор страниц Заголовок с действиями, дерево слева, превью в центре, инспектор справа, Конструктор/Эксперт, каталог блоков, поля и переключения builder-antirion.html, assets/builder.css, assets/builder.js Подготовлен к проверке пользователя
4. Контент и записи Выбор коллекции, список записей, редактор по схеме, превью, вкладки и режим Эксперт content-antirion.html, assets/content-editor.css, assets/content-editor.js Разрешён переход к этапу 5 пользователем
5. Публикация и завершение Композиция публикации/истории/отката, рабочие состояния и подтверждения; итоговая сверка всех экранов, входа, ошибок и пустых состояний publication-antirion.html, assets/publication.css, assets/publication.js Реализован; подготовлен к проверке пользователя

Для этапа 5 реализован настоящий candidate/diff и защищённое переключение Live; уточнение объёма — publication-backend.md. RBAC, медиа, durable jobs, идемпотентные операции и интеграция с агентскими changeset остаются следующей очередью.

Этап 1 — принят пользователем

  • Оригинальный antirion-rework.css включён в runtime побайтово; его SHA-256 и происхождение SVG записаны в static/VENDOR.md. Рабочий пакет не зависит от наличия design/.
  • Shell использует оригинальные классы и композицию, SVG paths и параметры штриха. Старые общие стили кнопок/полей/ссылок вынесены из области каркаса; адаптация native dialog/ссылок находится отдельно в shell.css.
  • Sidebar сохраняет группы WORKSPACE/CONFIGURATION и исходный порядок пунктов, включая положение «Медиа». Счётчик страниц получен через API. Будущие разделы недоступны и подписаны в title.
  • Topbar показывает реальный host, текущий раздел, быстрый поиск, статус публикации, тему и профиль. Несуществующий релиз не показан как LIVE. Полный реальный ID доступен в title; длинный timestamp/hash сокращается визуально, чтобы сохранить мобильную компоновку.
  • Поиск открывается кнопкой и Ctrl/Cmd+K; фильтрует разделы и реальные страницы по названию/URL/файлу. Переход на страницу выбирает её в списке, как в оригинале. Закрытие — кнопкой, Esc или фоном; фокус возвращается вызывающему элементу.
  • Окно профиля показывает действующего администратора и настоящую POST-форму выхода с CSRF. Демо-переключателя ролей нет: в текущем бэкенде один администратор.
  • Сворачивание, адаптивная узкая панель, темы и мобильное меню сохраняют исходные breakpoints/классы. Настройки хранятся локально; документы и credentials туда не попадают. Мобильное меню удерживает клавиатурный фокус и блокирует фон.
  • CSS/JS имеют URL с хешем содержимого. htmx не переносит inline style при settle: CSP остаётся строгой.

Содержимое экранов (таблицы, формы, редакторы, публикация) ещё требует переноса на следующих этапах. Их предыдущий внешний вид не считается принятым вместе с каркасом.

Свидетельства проверки этапа 1

PYTHONPATH=src python scripts/qa_shell_001.py
PYTHONPATH=src python scripts/qa_001.py --out /tmp/site-engine-shell-general
PYTHONPATH=src python -m unittest discover -s tests -q
python scripts/verify_package_001.py

qa_shell_001.py поднимает настоящий uvicorn на временной копии сайта и открывает оригинал отдельно в Chromium. Для сравнения каркаса в оригинале подставляются только те же подписи сайта/host/счётчика/профиля/статуса. Контент страницы, CSS и layout оригинала не заменяются.

Сопоставляются координаты, размеры, шрифт, padding, цвет и фон 11 элементов каркаса на 1440/1280/1024/768/390/360 px в обеих темах (12 наборов сравнения). Дополнительно проверяются реальные переходы htmx, поиск и пустая выдача, сохранение сворачивания, профиль/выход, мобильный фокус/закрытие и индикатор настоящего опубликованного релиза. С длинным build ID проверяются также 600/430/421 px. В журнал попадают JS-исключения, ошибки console/CSP и HTTP ≥400.

Артефакты: /tmp/site-engine-shell-001/ — report.json, парные runtime-*.png/reference-*.png, collapsed.png, command.png, command-mobile.png, mobile-menu.png, live-release.png.

Дополнительная регрессия: 239 тестов OK; прежний браузерный сценарий — 8 экранов/60 проверок ширины; установленный wheel без design/ работает. Эти результаты подтверждают совместимость, но не закрывают визуальную приёмку остальных экранов.

Текущий статус на 2026-11-17: пользователь разрешил этап 5 после Content; Publication реализован и подготовлен к его проверке. Общая пользовательская визуальная приёмка не закрывается автоматически.

Этап 2 — принят пользователем

  • Обзор сохраняет оригинальные headline, overview-stage, live-панель, ribbon и две колонки изменений/проверок. Статус релиза, время сборки, ошибки и предупреждения получены из API. До первой публикации отображается отдельное состояние. Последние изменения показывают время файлов, без выдуманного автора.
  • Список сохраняет исходные toolbar, tabs, workbench, размеры колонок, выделение строки, правый инспектор, миниатюру и действия. Поиск работает по названию/URL/файлу; layout и вкладки пересекаются с запросом. Выбор строки меняет инспектор, кнопка «Редактор» отдельно открывает существующий редактор. Выбор сохраняется при фильтрации и сбросе, URL поддерживает Back/Forward.
  • Поиск обновляет только результаты и сохраняет фокус ввода. Выбор Desktop/Mobile миниатюры сохраняется при переключении строки. Информация, детали и создание используют исходные .dialog, .field, .copyline, .dialog-actions с native dialog, Escape/фоном и возвратом фокуса.
  • Создание вызывает настоящий API: новая страница — draft, допускается вложенный ID, после успеха остаёмся в списке с выбранной новой страницей. Открытие/отмена ничего не записывают. При 409/422 окно остаётся открытым с ошибкой и введёнными значениями. Обычные GET/POST работают без JavaScript.
  • Оригинальный CSS по-прежнему побайтово совпадает с design/assets/antirion-rework.css. pages.css адаптирует семантические ссылки и переносит исходные inline-размеры под CSP; старые общие стили изолированы от перенесённых экранов.

Данные и ограничения

PageRow дополнен changed, description, updated_at, issues, on_live; Workspace — типизированным release и comparison_available. JSON-фильтр /pages?changed=true и HTML-вкладка используют одну проекцию. Credentials остаются на сервере.

Для настоящего сравнения файлов Page новые manifest.json сохраняют page_sources: SHA-256 только опубликованных файлов страниц. Черновые пути и исходники в публичный manifest не попадают. После редактирования/возврата исходных байтов и отката сравнение следует активному релизу. В существующих релизах без индекса сравнение неизвестно: UI показывает «—» и объяснение; перепубликовывать автоматически не нужно. Это сравнение файлов Page, а не полный dependency diff сайта: изменения layout, fragment, коллекций или assets отдельно этим счётчиком не охватываются.

Миниатюра сохраняет композицию исходного mock и показывает настоящий заголовок/литеральное SEO-описание; полный рендер страницы доступен в редакторе. Дублирование в деталях отключено с пояснением: такого действия в API пока нет. Новые действия редактора и публикации относятся к этапам 3–5.

Проверки этапа 2

PYTHONPATH=src python scripts/qa_pages_001.py
PYTHONPATH=src python scripts/qa_shell_001.py
PYTHONPATH=src python scripts/qa_editor_001.py
PYTHONPATH=src python -m unittest discover -s tests -q
python scripts/verify_package_001.py

qa_pages_001.py поднимает настоящий uvicorn на временной копии и открывает оригинал отдельно в Chromium. В оригинале для сравнения заменяются подписи headline/ribbon и данные/число строк таблицы; исходные компоненты и CSS не заменяются. Проверяются 24 набора: overview/pages × light/dark × 1440/1280/1024/768/390/360 px. Сверяются шрифты, padding, цвета, ширины и положение устойчивых компонентов; вертикальные размеры зависимых от реальных текстов областей записываются в отчёт. Это компонентная сверка и скриншоты, а не утверждение о побайтовом совпадении изображений с разными данными.

Браузер проверяет выбор мышью/клавиатурой, фильтры/сброс/пустую выдачу/историю, фокус поиска, миниатюру, диалоги, настоящие draft и 409/422, отсутствие публикации при создании, значения после publish/edit/revert и неизвестное сравнение старого релиза, GET/POST без JS. Неожиданных JS/console/CSP/HTTP-ошибок нет. Артефакты: /tmp/site-engine-pages-001/ — report.json, парные скриншоты overview/pages, окна и pages-live.png.

Регрессия: 244 теста OK; каркас — 12 наборов сравнения/6 сценариев; редактор — 25 сквозных сценариев. Wheel установлен вне checkout без design/; новые CSS/JS и страницы доступны. Общая проверка экранов — 8 экранов/60 проверок ширины.

Этап 3 — результат для проверки

Источник — builder-antirion.html и assets/builder.{css,js}. Сохранены исходные классы, SVG paths/stroke, три панели, toolbar превью, вкладки дерева/карты источников, инспектора, каталог и редактор исходника. Принятый shell остаётся общим. builder-design.css — побайтовая копия исходника; builder.css автоматически добавляет ограничивающие редактором обычные селекторы через :where, сохраняя декларации, media queries и специфичность document root. Зависимости от браузерного @scope нет. Семантические HTML/htmx/CSP-адаптации находятся отдельно в builder-adapter.css и builder.js. Проверяемое воспроизведение: python scripts/sync_builder_design.py --check; хеши — static/VENDOR.md.

Поведение

  • Дерево показывает настоящие регионы, вложенные блоки/слоты, ID, скрытие и условия. Layout-блоки выбираются в read-only инспектор; изменять/перемещать/дублировать их нельзя. Карта источников показывает реальные literal/bind/query/типизированные ссылки из props.
  • Поля строятся по схемам фрагментов. Простые поля сохраняют исходные .field/.tiny-source, списки, группы, link и query используют существующий типизированный парсер. Сложные поля не заменены плоским mock-эквивалентом. Файлы и ref выбираются из реальных choices, literal/bind сохраняются различимыми значениями.
  • Чистый выбор секции локально переключает дерево и серверную HTML-проекцию инспектора; POST и блокировки интерфейса нет. Как в оригинале, дерево выделяет и прокручивает секцию в основном окне, клик по самой секции выбирает её в дереве и инспекторе. Снимок и iframe при выборе сохраняются. Это работает и без отдельного preview-origin: родительская админка управляет служебными маркерами в iframe без scripts; CSP остаётся script-src 'none'. Bridge другого origin сохраняет проверки origin/source/snapshot/revision/адреса блока.
  • Правки инспектора применяются к текущей редакции после паузы 650 мс и обновляют настоящее превью. Кнопки Save, выбор другого блока и смена режима сначала применяют ожидающие поля. Фокус, caret и прокрутка инспектора/дерева восстанавливаются. Кнопка «Применить изменения» доступна отдельно.
  • При 422 сохраняются актуальные значения input/textarea/select/checkbox, а не старые HTML-атрибуты. Ошибка останавливает следующий Save/переход; исправленные значения можно отправить повторно. 401/сетевая ошибка не очищают исходник.
  • Каталог сохраняет поиск/категории и фильтрует реально допустимые фрагменты для региона/слота с учётом allow-паттернов. Клик вставляет блок с preview/default из настоящего manifest и выбирает новый ID. Ошибка оставляет окно с введёнными полями. Отдельного обязательного шага настройки перед каждой вставкой нет.
  • Выше/ниже, drag-and-drop, скрытие, удаление и дублирование вызывают API transform. Дублируется всё поддерево с новыми ID; anchor копий снимаются, чтобы не получить повтор. После удаления выбирается соседний блок. Подтверждения удаления/отмены используют исходную модальную композицию; Escape отменяет действие.
  • Desktop/Tablet/Mobile сохраняются при обновлении iframe. Клик настоящего превью выбирает блок, дерево прокручивает превью, обновление сохраняет viewport. Один iframe переносится между панелями Конструктора/Эксперта; перед htmx-заменой инспектора он сохраняется вне заменяемой области. Публичный HTML и JS сайта не получают служебных изменений.
  • В «Эксперте» перенесены файлы слева, codebox/гаттер/подсветка/статусная строка по центру, превью и проверки справа; responsive использует исходный .expert-layout. Есть поиск, Ctrl/Cmd+F, Ctrl/Cmd+Enter, Ctrl/Cmd+S, скачивание, реальное сравнение с последней загруженной/сохранённой версией, отмена и явное серверное форматирование. Обычное переключение режимов не сериализует исходник; CRLF сохраняется до содержательной правки.

Архитектура и границы

«Текущая редакция» в переключателе превью — изменения в памяти вкладки. Transform/validate/preview обрабатывают переданный source без записи контента; файл записывается только по «Сохранить документ», с прежними CAS/ETag, валидацией, историей и аудитом. Серверное автосохранение и восстанавливаемые draft-сессии не добавлены. status: draft остаётся статусом файла/участия в релизе. Продуктовые подписи используют «Нет несохранённых изменений», «Применить изменения», «Предпросмотр».

Контракт дополнен BlockAction.type: duplicate, Add.props; schema включает настоящие manifest preview/defaults и названия страниц. Сохранение неполного документа по-прежнему допускается по ADR-003; готовность к публикации проверяет release validation. Успешная проверка структуры не выдаётся за проверку полного релиза. Сохранение не публикует сайт.

Отдельного предупреждения о пересборке YAML при правках нет; пояснение остаётся рядом с исходником. Нативные alert/confirm/prompt и beforeunload-диалоги запрещены. Подтверждения удаления, отмены правок и внутренних переходов используют окна интерфейса, Escape отменяет действие и возвращает фокус. Перезагрузка/закрытие вкладки не вызывает системного подтверждения; несохранённая редакция при этом теряется.

Тёмный режим использует утверждённые токены antirion-rework.css; палитра Rose не перенесена. Live-переключатель недоступен с объяснением: контракт просмотра опубликованного снимка в редакторе ещё отсутствует. Обратный поиск usages, developer/RBAC, demo server и симуляция 409 из прототипа не показаны как работающие возможности. Настоящий 409 обрабатывается через сравнение двух исходников, явное принятие ETag основы и отдельное сохранение.

Проверки этапа 3

python scripts/sync_builder_design.py --check
PYTHONPATH=src python scripts/qa_builder_001.py
PYTHONPATH=src python scripts/qa_selection_001.py
PYTHONPATH=src python scripts/qa_editor_001.py
PYTHONPATH=src python scripts/qa_shell_001.py
PYTHONPATH=src python scripts/qa_pages_001.py
PYTHONPATH=src python scripts/qa_001.py
PYTHONPATH=src python -m unittest discover -s tests -q
python scripts/verify_package_001.py

Chromium открывает оригинал отдельно от настоящего приложения на временной копии сайта. Конструктор: 12 наборов сравнения (2 темы × 6 ширин 1440/1280/1024/768/390/360), сверяются ширины колонок, шрифты/отступы компонентов, исходные светлые фоны. Для тёмной темы используется утверждённая палитра shell; это не сравнение с Rose. Эксперт: 6 сравнений шрифта/padding исходника, колонок на desktop и переноса инспектора на tablet; парные скриншоты оригинала. Это компонентная сверка при разных настоящих данных, не заявление о попиксельном совпадении всего экрана.

12 браузерных групп проверяют переключение режимов до первой операции сервера с восстановлением превью/toolbar, автообновление/фокус/caret, немедленное применение перед выбором/Save, 422 с сохранённым вводом и остановкой Save, исправление и выбор настоящего изображения, viewport, binding, дублирование/отмену удаления/выбор соседа, каталог/вставку, drag-and-drop, явную запись без publish, форматирование без записи, Expert/diff/reset/фокус и карту источников. Проверяется и нижняя граница панелей на desktop: перенос кнопок не увеличивает документ за пределы viewport. Сквозная регрессия редактора — 25 сценариев, включая два origin, запрет JS сайта, границы сообщений, CRLF, две вкладки/409, сессию, сеть и Save без JS.

Полная регрессия — 248 тестов OK. Прежние shell/pages — 12/24 набора и 6/6 групп; общая проверка — 8 экранов/60 ширин. Установленный wheel работает без design/, включая новые CSS/JS/шаблоны; CLI validate/build на изолированной копии — 0 ошибок/предупреждений, 7 страниц. Артефакты: /tmp/site-engine-builder-001/ (report.json, constructor-*.png, expert-dark-*.png, reference-*.png), /tmp/site-engine-builder-general/, /tmp/site-engine-001-editor-qa/.

Этап 3 передаётся пользователю на проверку. Этапы 4–5 в этой итерации не переносились.

Исправление по скриншоту пользователя

На http://10.10.0.44:8181 выполнена проверка напрямую без прокси, с настоящим входом. В Chromium исходные CSS загружались и применялись; в Firefox 142.0.1 воспроизведён распавшийся интерфейс из data/Screenshot_198.png: CSSScopeRule отсутствует, .builder имеет grid-template-columns: none, одновременно видны оба режима. Причина — игнорирование браузером всего @scope, а не HTTP-ошибка загрузки CSS.

builder.css, builder-adapter.css и изоляция старого редактора в admin.css используют обычные селекторы с :where. Генератор сохраняет исходные декларации и media queries, новые at-rules требуют явной поддержки генератором. Дополнительно исправлены всплытие document:state, порядок переноса iframe относительно изменения классов и расчёт оставшейся высоты под фактической шапкой. При fallback-переносе iframe отправка bridge-команд ждёт проверенное preview:ready, чтобы не писать во временный about:blank до загрузки другого origin.

Исправленные ресурсы проверены на настоящем сервере подменой файлов только в тестовой вкладке: 42 комбинации переключений/тем/ширин в Chromium и Firefox, переходы htmx и каталог; отдельно — страница «Услуги» при 1673 × 948 из скриншота. Серверная сборка и рабочий контент при этом не менялись. Артефакты: /tmp/cms-live-inspect/ — firefox-constructor.png до исправления, services-firefox-fixed.png после, fixed-report.json / firefox-fixed-report.json.

Для постоянного прогона другого браузера qa_builder_001.py поддерживает QA_BROWSER=firefox, необязательный QA_BROWSER_EXECUTABLE и отдельный QA_BUILDER_OUT. Нужны совместимые версия Playwright, браузер и его системные библиотеки.

Выбор секций и подтверждения

scripts/qa_selection_001.py прошёл в Chromium 158 и Firefox 142; проверяет два режима превью — административный origin без scripts и bridge отдельного origin: дерево → выделение/прокрутка/инспектор, превью → дерево/инспектор, фиксированные блоки только для чтения, ноль POST при чистом выборе, неизменный iframe/снимок/source, отсутствие записи файла и публикации. Повторные правки после локального выбора передают текущий source. Проверяются отмена перехода через селектор/ссылку/выход, подтверждённый переход/выход из Entry, Escape, перезагрузка без системного диалога. Любой нативный диалог проваливает прогон. Артефакты: /tmp/site-engine-selection-001/ и /tmp/site-engine-selection-firefox-001/.

Этап 4 — Контент и записи

Перенесён оригинальный content-antirion.html / assets/content-editor.{css,js}: четыре панели, заголовок и действия, коллекции/счётчики/OFF, поиск и фильтры записей, форма по схеме, вкладки «Связи», «Где используется», «Схема», режим Expert, оба варианта preview и диалоги stage4-dialog. Сохранены исходные CSS/иконки/breakpoints, принятый shell и его тёмные токены; геометрия viewport адаптирована к фактической высоте shell. Данные/подписи полей берутся из настоящей схемы.

Обычное изменение свойства использует очередь 003: один update, локальный ввод и вкладки без ожидания ответа, сохранение поля/caret/iframe, обновление существующего preview. Отдельный Save пишет файл; duplicate создаёт draft-копию текущей редакции, delete требует сохранённого archived для published. Создание сразу создаёт draft-файл. Восстанавливаемой autosave-сессии нет.

Backend и границы: content-backend.md. Результаты и воспроизводимые команды: verification-content.md. Live/Page использует HTML/assets реального релиза; Live/Card имеет явное объяснение отсутствующего снимка карточки. Slug read-only, схема read-only; roles/+30 Demo/409 Demo/mock storage не переносятся как работающие функции.

После реализации Content пользователь разрешил переход к этапу 5; его результаты приведены ниже.

Этап 5 — Publication (2026-11-17)

  • Перенесены исходные заголовок, livebar, pipeline, таблица/инспектор и вкладки Changes/Checks/Candidate/History/Activity. CSS/SVG воспроизводятся scripts/sync_publication_design.py --check, HTML/JS используют реальные данные. Reset/tokens ограничены экраном; тёмная палитра соответствует принятому shell.
  • Проверка и сборка не переключают Live. Кандидат фиксирует входные данные и output; preview и diff показывают этот снимок. Публикация с комментарием проверяет source/renderer/base/current и переключает готовый build без повторного рендера.
  • История и журнал настоящие; перед откатом показаны реальные изменяемые публичные файлы. Отмена ничего не пишет; подтверждение не меняет workspace. Старые релизы без частных исходников показывают неизвестное сравнение.
  • 409/422/500/сеть/истёкшая сессия видимы. Ошибки после фактического переключения отдельно сообщают committed_build, состояние перечитывается, автоматического повтора POST нет. Нативные alert/confirm/prompt не используются.
  • Доработки и ограничения — publication-backend.md; полные результаты — verification-publication.md: 397 тестов полной регрессии, затем 16 целевых; 12 визуальных наборов и 25 групп Chromium на двух конфигурациях preview, общие 8 экранов/60 ширин, проверка отказов и установленного wheel.

Этап передаётся пользователю для визуальной проверки. Docker-образ требует пересборки для обновления Python/templates/static. Переход к следующей самостоятельной работе не считается разрешённым этой технической приёмкой.