# Повторный перенос дизайна 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. Переход к следующей самостоятельной работе не считается разрешённым этой технической приёмкой.