Files

165 lines
36 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Повторный перенос дизайна 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](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
```bash
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
```bash
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
```bash
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](content-backend.md). Результаты и воспроизводимые команды: [verification-content.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](publication-backend.md); полные результаты — [verification-publication.md](verification-publication.md): 397 тестов полной регрессии, затем 16 целевых; 12 визуальных наборов и 25 групп Chromium на двух конфигурациях preview, общие 8 экранов/60 ширин, проверка отказов и установленного wheel.
Этап передаётся пользователю для визуальной проверки. Docker-образ требует пересборки для обновления Python/templates/static. Переход к следующей самостоятельной работе не считается разрешённым этой технической приёмкой.