Integrate Content Editor and Publication workflow

This commit is contained in:
2026-11-17 11:43:53 +03:00
parent f18bc9a4fd
commit c3938f24d8
55 changed files with 6207 additions and 203 deletions
@@ -0,0 +1,17 @@
# Этап 4: оригинальный Content Editor и серверный контракт
Источник композиции, размеров, CSS, SVG и сценариев: `design/content-antirion.html`, `design/assets/content-editor.{css,js}` и общие токены `design/assets/builder.css`. Сохраняется ранее принятый общий shell. Перенос не меняет файлы дизайна и контент сайта.
Необходимые доработки бэкенда:
1. Реальные коллекции и записи: enabled по feature requirements, количество и файловый статус, маршрут/display, схема, сравнение с текущим релизом. Новые manifest сохраняют `entry_sources` и `entry_routes`; старый релиз без хешей даёт неизвестный результат сравнения, а не ложное «без изменений».
2. Связи: типизированные ref/refs/link, вложенные группы и списки. Обратные зависимости: записи, композиция регионов страниц/display/Entry, fixed layout и SEO. Для запросов используется штатный Resolver с where/ids/order/limit/features и текущей редакцией записи; произвольные строки не считаются ссылками. Это зависимости структурированных данных; ссылки в Markdown, произвольном Jinja и пользовательском JS не индексируются.
3. `POST /collections/{collection}/entries/{id}/check`: проверка текущего source как кандидата к публикации; типы, обязательные поля, ссылки, assets и реальный рендер. Ничего не записывает. Проверка одной записи не заменяет проверку всего релиза. Неполный синтаксически корректный draft по-прежнему можно сохранить.
4. `POST …/duplicate` с source/etag/revision/id: CAS исходного файла и отсутствие целевого под одной SiteLock. Создаётся отдельный файл draft из текущей редакции, оригинал не меняется. `POST …/delete`: CAS, запрет удаления published до отдельного сохранения archived, история перед удалением и аудит. Ошибка аудита после записи/удаления сообщает совершённое действие и request_id.
5. Общий stateless `POST …/update` получает `preview_view: card|page`, `preview_version: workspace|live`. Workspace использует настоящий renderer и overlay; карточка — встроенный `entry_card`. Live полной страницы читает HTML и assets неизменяемого текущего релиза. Snapshot имеет прежние авторизацию/TTL/CSP и пассивный либо отдельный origin. Отдельной карточки в релизе нет: Live/Card показывает явное объяснение, а не данные workspace под видом live.
Путь запросов остаётся Browser → HTML adapter → AdminApi → JSON FastAPI → сервисы. Парсинг схем и YAML выполняет Python; mock codec и mock storage исходного прототипа не переносятся. Изменения полей остаются в памяти вкладки, обслуживаются общей очередью 003; Save пишет файл с CAS, публикация выполняется отдельно. Создание и дублирование создают настоящий draft-файл.
Slug — идентификатор файла/маршрута: показывается read-only. Переименование потребует отдельной операции с обновлением ссылок; скрытого rename при изменении поля нет. Схема коллекции доступна только для чтения и показывает серверную модель настоящего манифеста. Подписи полей берутся из `FieldDef.label`, при отсутствии — ключ.
В интерфейс не добавляются демонстрационные роли, +30 Demo, симуляция 409, mock Live, sessionStorage или localStorage с документами. Диалоги сохраняют композицию stage4-dialog из дизайна; системные alert/confirm/prompt/beforeunload запрещены.
+24 -4
View File
@@ -11,10 +11,10 @@
| 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` | Ожидает этап 3 |
| 5. Публикация и завершение | Композиция публикации/истории/отката, рабочие состояния и подтверждения; итоговая сверка всех экранов, входа, ошибок и пустых состояний | `publication-antirion.html`, `assets/publication.css`, `assets/publication.js` | Ожидает этап 4 |
| 4. Контент и записи | Выбор коллекции, список записей, редактор по схеме, превью, вкладки и режим Эксперт | `content-antirion.html`, `assets/content-editor.css`, `assets/content-editor.js` | Разрешён переход к этапу 5 пользователем |
| 5. Публикация и завершение | Композиция публикации/истории/отката, рабочие состояния и подтверждения; итоговая сверка всех экранов, входа, ошибок и пустых состояний | `publication-antirion.html`, `assets/publication.css`, `assets/publication.js` | Реализован; подготовлен к проверке пользователя |
Возможности следующей очереди (candidate/diff, RBAC, медиа и прочие) требуют отдельного действующего контракта; их ограничения фиксируются при переносе соответствующего экрана.
Для этапа 5 реализован настоящий candidate/diff и защищённое переключение Live; уточнение объёма — [publication-backend.md](publication-backend.md). RBAC, медиа, durable jobs, идемпотентные операции и интеграция с агентскими changeset остаются следующей очередью.
## Этап 1 — принят пользователем
@@ -46,7 +46,7 @@ python scripts/verify_package_001.py
Дополнительная регрессия: 239 тестов OK; прежний браузерный сценарий — 8 экранов/60 проверок ширины; установленный wheel без `design/` работает. Эти результаты подтверждают совместимость, но не закрывают визуальную приёмку остальных экранов.
Статус: этапы 1–2 приняты пользователем. Этап 3 подготовлен к проверке; этапы 4–5 ожидают её результата.
Текущий статус на 2026-11-17: пользователь разрешил этап 5 после Content; Publication реализован и подготовлен к его проверке. Общая пользовательская визуальная приёмка не закрывается автоматически.
## Этап 2 — принят пользователем
@@ -142,3 +142,23 @@ Chromium открывает оригинал отдельно от настоя
### Выбор секций и подтверждения
`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. Переход к следующей самостоятельной работе не считается разрешённым этой технической приёмкой.
File diff suppressed because it is too large Load Diff
+10 -2
View File
@@ -121,7 +121,7 @@ UI-роутеры, использующие AsyncClient, выполняются
| Релизы и текущая публикация | `GET /admin/api/v1/releases` |
| Текущие publish/rollback | `POST /admin/api/v1/publish`, `POST /admin/api/v1/rollback` |
Фигурная группа действий обозначает отдельный явный маршрут для каждого действия. Вложенные ID Page с `/` поддерживаются и проверяются по Registry; маршрут не принимает произвольный файловый путь. Списки принимают те же q/status/layout, что UI. Create возвращает 201 и DocumentSnapshot; чтение/transform/validate/save/preview — 200 с соответствующим DTO. Publish/rollback возвращают фактический результат действующих сервисов без нового candidate pipeline.
Фигурная группа действий обозначает отдельный явный маршрут для каждого действия. Вложенные ID Page с `/` поддерживаются и проверяются по Registry; маршрут не принимает произвольный файловый путь. Списки принимают те же q/status/layout, что UI. Create возвращает 201 и DocumentSnapshot; чтение/transform/validate/save/preview — 200 с соответствующим DTO. Старые Publish/rollback сохраняют прежний контракт действующих сервисов. Новый candidate workflow повторного этапа 5 описан в publication-backend.md.
DTO запросов буфера: `source`, `etag`, `revision`; transform дополнительно содержит дискриминированное типизированное `action`. `revision` — неотрицательное целое, возвращаемое без изменения, `etag` — прежний непрозрачный маркер версии. Схемы запрещают неизвестные служебные поля; пользовательские props проверяет действующая схема фрагмента/коллекции. В JSON не передаются csrf, Principal или произвольный путь записи.
@@ -265,10 +265,18 @@ HTTP/browser-проверки добавляются как воспроизво
| Номер | Направление | Доработка и результат приёмки |
|---|---|---|
| 002 | Релизы | Разделить build/publish; immutable candidate, manifest/hashes, diff, expected_live под общей блокировкой, безопасные повторы; сбой не меняет live, rollback не затирает workspace |
| — | Релизы — расширение | Надёжные фоновые jobs, реестр безопасных повторов, retention/recovery и связь с reviewed changeset. Build/publish, immutable candidate, hashes/diff и expected_live уже реализованы повторным этапом 5 в 001 |
| 003 | Медиа, структура, настройки | Безопасная загрузка, файловые metadata, where-used, changeset с recovery до rename, меню/redirect/site/data/theme; перенос каталога не теряет метаданные |
| 004 | Доступы и журнал | Пользователи, разрешения, миграции SQLite, сессии и audit UI; отказ прав проверяется сервисом, а не видимостью кнопки |
| 005 | Заявки и outbox | Версия формы, submission+outbox одной транзакцией, Telegram/retry, PII grants; сбой доставки не теряет заявку и rollback сохраняет совместимость |
| 006 | MCP | Те же сервисы и ошибки, узкие scopes, TTL/revoke, draft-only; отсутствие publish grant исключает публикацию |
Это очередность отдельных работ. Их контракты и задачи не считаются реализованными или полностью специфицированными пакетом 001.
## Уточнение плана: повторный перенос Content (2026-11-17)
Этап 4 опирается на исходный content-antirion и уже работающую очередь 003. Дополнение сервера: коллекции/зависимости, check, CAS duplicate/delete, entry manifest hashes/routes и настоящий Live/Page. Подробности и ограничения — [content-backend.md](content-backend.md), техническая приёмка — [verification-content.md](verification-content.md). После реализации требуется проверка пользователя до перехода к этапу 5. Новая схема хранения, Node frontend и серверное autosave для этого этапа не требуются.
## Уточнение плана: Publication (2026-11-17)
Пользователь разрешил этап 5. Для оригинального publication-antirion потребовалось настоящее разделение build/activate и частное происхождение релиза. Это уточнение прежнего отнесения всего candidate/diff к следующей очереди. Реализация: PublicationService под SiteLock; build_site(activate=False); отдельные API/HTML endpoints; source/render/output hash и expected_live; пассивный snapshot релиза; исходные диалоги и видимые ошибки. Старые CLI/API/обычные формы совместимы. Контракт — [publication-backend.md](publication-backend.md), приёмка — [verification-publication.md](verification-publication.md). Более широкий workflow релизов/агентских changeset не входит в этап.
@@ -0,0 +1,70 @@
# Этап 5: Publication и серверный контракт
Дата: 2026-11-17. Источники — `design/publication-antirion.html`, `design/assets/publication.css` и `publication.js`. Исходная композиция, таблица, инспектор, пять вкладок, карточки Workspace/Candidate/Live и диалоги перенесены в принятый shell. Mock-хранилище, выдуманные роли, симуляция сборок и ремонт демонстрационных данных исключены. Проверки — [verification-publication.md](verification-publication.md).
## Сценарий
1. Сохранить необходимые документы в редакторе. Несохранённые правки других вкладок не участвуют в сборке.
2. «Проверить» выполняет настоящие workspace/release-проверки. Исходники и Live не меняются; результат помечается устаревшим при изменении входных файлов или renderer.
3. «Собрать кандидата» строго проверяет и рендерит сайт в неизменяемый каталог релиза, сохраняя текущий Live. Отдельный предварительный запуск «Проверить» не обязателен: сборка сама выполняет строгую проверку.
4. Во вкладке «Кандидат» доступны настоящий снимок страницы, сравнение зафиксированных исходников с базовым Live и журнал сборок. Просмотр не пересобирает сайт.
5. «Опубликовать» открывает исходный диалог с комментарием. Подтверждение переключает `current` на выбранный снимок без повторного рендера. Комментарий обязателен, до 150 символов.
6. «История» показывает существующие каталоги релизов. Перед откатом доступны реальные изменённые публичные файлы, маршруты/формы и подтверждение. Откат переключает Live, сохраняя workspace.
Поиск, фильтры, выбор документа и вкладки работают локально. Сетевые операции выполняются через fetch в фоне; переключение вкладок остаётся доступным, повторные изменяющие действия блокируются на время запроса. Сборка на сервере синхронная: долговечной очереди заданий и отмены задачи нет.
## Один контракт FastAPI
Browser → `/admin/publication/*` (cookie, Origin, CSRF) → `AdminApi/httpx.ASGITransport` → `/admin/api/v1/publication*` → `PublicationService`. Браузер не получает внутренних credentials. Начальные данные передаются в скрытом textarea (`tojson`, чтение `.value`), который сохраняется при htmx swap с `allowScriptTags:false`; script-элементы для хранения этих данных не используются. Права и авторство берутся из проверенной сессии; отдельные API keys/scopes и RBAC пока не реализованы.
| JSON API относительно `/admin/api/v1` | Назначение |
|---|---|
| `GET /publication` | Реальное состояние, изменения, проверки, кандидат, история, сборки и журнал |
| `POST /publication/validate` | Проверить workspace/release без записи контента |
| `POST /publication/build` | Собрать кандидат без активации |
| `GET /publication/candidate-diff` | Сравнить неизменяемый кандидат с его базовым релизом |
| `GET /publication/compare?path=…` | Сравнить сохранённый файл workspace с частным снимком Live |
| `GET /publication/document-history?path=…` | Существующие версии `.engine/history`, максимум 20; восстановления здесь нет |
| `GET /publication/release?id=…` | Сравнить публичные файлы выбранного релиза и текущего Live перед откатом |
| `POST /publication/preview` | `{id, route}` → защищённый пассивный снимок настоящего релиза |
| `POST /publication/activate` | `{id, expected_live, comment}` → переключение проверенного кандидата |
| `POST /publication/rollback` | `{id, expected_live, comment}` → переключение существующего исторического релиза |
`expected_live` обязателен; до первой публикации передаётся `null`. HTML adapter читает состояние по `/admin/publication/state`; остальные названия операций совпадают. POST принимает FormData `csrf` и JSON-строку `payload`; ответ — JSON. Читающие операции — GET. Экран открыт по `/admin/publish`; без JavaScript доступна ссылка на обычную форму `/admin/publish/legacy`. Старые POST `/admin/publish`, API `/publish`, `/rollback` и CLI сохраняют прежний сценарий сборки с публикацией.
## Разделение состояния и файлов
`PublicationService` не редактирует файлы сайта. Изменения документов остаются ответственностью `ContentService` с CAS/history/audit. Проверки, сборка и переключение выполняются под общим `SiteLock`; в `build_site` добавлен параметр `activate=False`, обычное значение остаётся `True`. Внешние писатели должны соблюдать тот же lock.
Служебные данные находятся только в `SITE_STATE_DIR/publication/`:
- `candidate.json`: последний кандидат, базовый Live, хеш входных файлов и renderer, hash публичного output, время/автор/маршруты/диагностика;
- `releases/<build_id>.json`: частный снимок входных файлов и происхождение релиза, комментарий/автор и факт активации;
- `validation.json`: реальный результат последней проверки и fingerprint его входных данных;
- `builds.json`: последние 40 результатов/ошибок сборки с ID запроса и кратким журналом стадий.
Список исходников охватывает `pages`, `content`, `menus`, `assets`, `layouts`, `fragments`, `collections`, `display`, `data`, `forms`, root site/theme/redirect YAML и настроенный файл темы. Для UTF-8 текста известных расширений до 512 КиБ сохраняется исходник; для остальных файлов — hash/размер. Скрытые и служебные каталоги исключены, symlink в исходниках отклоняется. Полный hash workspace консервативно инвалидирует кандидата и при изменении иных файлов, включая README; fingerprint renderer учитывает ресурсы движка.
Частные исходники, включая draft, не копируются в публичный `dist` или manifest. В релиз рендерятся только `published`. Статус `published` в файле не означает, что сохранённая редакция уже находится в Live.
Старые/CLI-релизы без частного снимка продолжают работать: маршруты, preview и откат доступны, сравнение исходников/автор/комментарий неизвестны и обозначены явно. Ретроспективно придумывать их нельзя. После первой публикации новым workflow сравнение станет доступно для этого релиза.
Кандидат сравнивается со своей зафиксированной базой, а не с текущими изменениями workspace. Последующие правки требуют новой сборки. Откат сравнивает реальные байты публичных файлов, включая manifest/assets. Никогда не публиковавшиеся кандидаты с известным происхождением через откат выбрать нельзя.
## Конфликты, ошибки и безопасность
Перед активацией проверяются `expected_live`, актуальность ID кандидата, hash исходников/renderer/базового Live и неизменность собранных файлов. Нарушение актуальности — HTTP 409 `release_conflict`; повреждённый снимок/валидация — 422; отсутствующий релиз — 404. Отказ строгого рендера сохраняет прежние Live и кандидат.
JSON-ошибки: `error: {code, message, request_id, …}`. Непредвиденные ошибки и ошибки хранилища логируются со стеком и тем же ID. UI показывает сообщение, код и ID; 409 не закрывает подтверждение и не удаляет комментарий, автоматического повторного POST нет. Сеть и истёкшая сессия также видимы.
Если ошибка записи служебных данных/аудита произошла после сборки либо переключения, API отвечает 500 `candidate_after_build` или `release_after_commit` с `committed_build`. Сообщение различает «снимок создан, Live не переключён» и «Live уже переключён». UI перечитывает состояние перед повтором; указатель `current` остаётся источником истины. Переключение symlink атомарно, но несколько служебных JSON и audit не являются общей crash-atomic транзакцией.
Preview читает HTML/assets выбранного build ID, а не workspace, использует существующие TTL/epoch-токены и immutable snapshots. Скрипты удалены, `script-src 'none'` действует также на отдельном preview origin; iframe sandbox запрещает выполнение кода, формы и навигацию верхнего окна. Настроенный preview origin разрешён в frame-src всех страниц shell: CSP исходного документа сохраняется при htmx swap. Браузерные сценарии проверены с обеими конфигурациями origin.
Журнал показывает настоящие release-события из хвоста аудита: до 80 записей в последних 256 КиБ. Старый аудит не удаляется. Пароли, токены и тела запросов в журнал не добавляются.
## Границы этапа
Новый workflow не удаляет кандидаты/релизы автоматически. Прежняя CLI-сборка сохраняет своё `keep=5`; если каталог уже удалён, API сообщает отсутствие, кандидат становится неактуальным. Политика retention и очистка частных снимков требуют отдельной работы.
Не добавлены durable jobs, реестр идемпотентных операций, changeset/recovery нескольких документов, согласование агентских изменений, RBAC, приём заявок или MCP. Публичные формы по-прежнему отвечают HTTP 501. Исторический релиз без provenance нельзя проверить по исходным входным файлам; UI не выдаёт это за подтверждённое сравнение.
+16 -2
View File
@@ -2,7 +2,7 @@
## Редактор и файлы
Начальный режим — Конструктор. «Применить к буферу» меняет исходник в памяти открытой вкладки; «Сохранить документ» записывает его целиком. Проверка и превью не создают историю контента и не меняют `current`. Публикация отдельно собирает и переключает релиз. В Entry редактируются поля коллекции и Markdown; layout/display доступны для чтения.
Начальный режим — Конструктор. «Применить к буферу» меняет исходник в памяти открытой вкладки; «Сохранить документ» записывает его целиком. Проверка и превью не создают историю контента и не меняют `current`. Новый экран публикации отдельно собирает кандидат, затем переключает его в Live; старые формы/CLI сохраняют build+publish. В Entry редактируются поля коллекции и Markdown; layout/display доступны для чтения.
«Эксперт» хранит точный исходник. Переход между режимами без правок не пересобирает YAML; сохранение без изменений сохраняет в том числе CRLF и комментарии. Конструктор предупреждает о пересборке YAML перед первой операцией. До неё можно скачать исходник. Неприменимый YAML остаётся в «Эксперте», последнее корректное дерево доступно для просмотра. В localStorage попадают только тема и ширина навигации; HTML-кеш htmx отключён.
@@ -131,10 +131,24 @@ python scripts/verify_package_001.py
HTML-проекция содержит серверные шаблоны инспектора для всех блоков. Чистый выбор секции локально обновляет дерево/инспектор/выделение и прокрутку превью: без POST, изменения source/revision, нового снимка или замены iframe. Клик по секции превью выбирает её без дополнительной прокрутки. HTML `/select` остаётся для форм без JS и совместимости; он валидирует переданный исходник и строит инспектор, без записи файла.
Инспектор применяет поля к текущему source после паузы 650 мс; Save/выбор блока/смена режима сначала применяют ожидающую форму. Такой POST transform проверяет и преобразует переданный source, затем обновляет HTML-проекцию; это не сохранение черновика. До явного Save контент не записывается. «Текущая редакция» — память открытой вкладки, без серверного autosave/recovery; `status: draft` — статус файла, исключающий его из релиза. Ошибка формы сохраняет ввод и блокирует последующую запись до исправления. Переходы режимов сохраняют исходные байты. Структурные правки пересобирают YAML без отдельного подтверждения. Для исходника доступны сравнение/отмена, поиск, скачивание и явное форматирование через существующий metadata transform без записи.
После 003 инспектор отправляет один stateless POST update после паузы 200 мс; запрос объединяет изменения, проверку и preview. Save и смена режима дожидаются очереди. Чистый выбор секции остаётся локальным. Запрос не сохраняет черновик; контракт и очередь описаны в ../003-background-editor/runtime.md. До явного Save контент не записывается. «Текущая редакция» — память открытой вкладки, без серверного autosave/recovery; `status: draft` — статус файла, исключающий его из релиза. Ошибка формы сохраняет ввод и блокирует последующую запись до исправления. Переходы режимов сохраняют исходные байты. Структурные правки пересобирают YAML без отдельного подтверждения. Для исходника доступны сравнение/отмена, поиск, скачивание и явное форматирование через существующий metadata transform без записи.
Нативные `alert`/`confirm`/`prompt` и `beforeunload`-диалоги не вызываются. Удаление/отмена и внутренний переход с несохранёнными правками подтверждаются в окнах интерфейса; Escape отменяет действие, фокус возвращается к инициатору. При перезагрузке или закрытии вкладки системного подтверждения нет; несохранённая редакция теряется.
API `Add` принимает `props`, `BlockAction` — `type: duplicate`. Дублирование копирует поддерево, генерирует новые ID и снимает anchors копий. Ограничения регионов/слотов/циклов/типов остаются серверными. Schema передаёт manifest preview/defaults, choices и названия страниц; клиент не выдумывает значения. HTML-действия проходят прежний серверный API-клиент, credentials остаются на сервере.
Переключатель Live в редакторе пока отключён с объяснением. Рабочее превью остаётся настоящим временным снимком, а успешная проверка структуры не заменяет проверку релиза. Сохранение не выполняет publish. Компонентная и сквозная проверка: `PYTHONPATH=src python scripts/qa_builder_001.py` и `PYTHONPATH=src python scripts/qa_editor_001.py`.
## Content Editor после этапа 4
UI `/admin/content/{collection}/{id}` использует оригинальные Content templates/CSS и общую очередь 003. Состав backend-доработок и точные границы: [content-backend.md](content-backend.md); машиночитаемый контракт — [openapi.json](openapi.json). Начальный preview — настоящая карточка `entry_card`, переключатель Page рендерит display/layout. Live/Page читает immutable release; Live/Card показывает отсутствие такого артефакта. Старый manifest без Entry hashes/routes не выдаёт неизвестное сравнение за отсутствие изменений.
Дополнительная приёмка: `PYTHONPATH=src python -m unittest discover -s tests -p test_content_editor.py -v`, `PYTHONPATH=src python scripts/qa_content_001.py`, `python scripts/sync_content_design.py --check`, `python scripts/verify_package_001.py --site examples/site-studio`. Браузерный сценарий использует временный Site Studio и два режима preview; исходный дизайн открывается отдельно. Отчёт — [verification-content.md](verification-content.md).
## Publication — повторный этап 5
`GET /admin/publish` — оригинальный экран с реальными изменениями, проверками, кандидатом, историей и журналом. Проверить → собрать → preview/diff → опубликовать с комментарием; сборка и отмена подтверждения не переключают Live. При правке входных файлов/renderer/базового Live кандидат устаревает. Публикация требует `{id, expected_live, comment}`, откат — выбранный release и expected_live. Workspace при откате не меняется.
Browser fetch → `/admin/publication/*` → серверный AdminApi → `/admin/api/v1/publication*` → PublicationService. Локальные вкладки/поиск/выбор не делают POST. Несохранённые данные других вкладок не участвуют в сборке; состояние релизов в localStorage не хранится. История/сравнение берутся из настоящих файлов и частного `SITE_STATE_DIR/publication/`, старые релизы без provenance имеют неизвестное сравнение.
Все маршруты/ошибки/ограничения — [publication-backend.md](publication-backend.md), результаты — [verification-publication.md](verification-publication.md). На сервере нужен новый wheel/пересборка образа; `design/` для runtime не требуется. Дополнительных env или миграции БД нет, SITE_STATE_DIR должен оставаться приватным постоянным каталогом.
+3 -3
View File
@@ -81,7 +81,7 @@ JS прототипов описывает UX; его seed-данные, localSt
Вход/выход, обзор, список и создание страниц, формы страницы и блока, операции с блоками, коллекции, список/создание/редактирование записей, существующее превью, публикация, история релизов, откат, ошибки и пустые состояния.
Рабочие маршруты и обычные формы сохраняются. Пока новые редакторы не готовы, пользователь сохраняет изменения существующими кнопками форм. На этом этапе оформление публикации соответствует текущей операции «собрать и опубликовать».
Рабочие маршруты и обычные формы сохраняются. Пока новые редакторы не готовы, пользователь сохраняет изменения существующими кнопками форм. При первом переносе оформление публикации соответствовало операции «собрать и опубликовать». Повторный этап 5 уточняет этот контракт: проверка → сборка неизменяемого кандидата → просмотр/diff → отдельное переключение Live с CAS; см. [publication-backend.md](publication-backend.md).
### Этап B — редакторы
@@ -91,7 +91,7 @@ JS прототипов описывает UX; его seed-данные, localSt
### Следующая очередь
Отдельные кандидаты релиза, diff с live, медиабиблиотека и загрузки, changeset/rename, редактирование меню/настроек, пользователи/RBAC, заявки/outbox и MCP описываются следующими спецификациями. В 001 не добавляются Node-сборка, новая структура всего Python-пакета или миграция канонического контента в БД.
На повторном этапе 5 по разрешению пользователя в 001 включены реальные кандидаты релиза, diff с Live и проверка expected_live. Расширенный release workflow (durable jobs, безопасные повторы/реестр операций, retention и reviewed changeset), медиабиблиотека и загрузки, changeset/rename, редактирование меню/настроек, пользователи/RBAC, заявки/outbox и MCP остаются следующей очередью. В 001 не добавляются Node-сборка, новая структура всего Python-пакета или миграция канонического контента в БД.
### Контракт интерфейса
@@ -185,7 +185,7 @@ API задаёт единый контракт операций и данных.
| AC-05 | Две вкладки читают один ETag; первая сохраняет, вторая получает 409 с сохранённым вводом и текущей версией; после ручного объединения сохраняет с новым ETag. |
| AC-06 | Превью выбирает нужный вложенный/fixed-блок, соблюдает правила прокрутки и отображает последнюю версию буфера, включая ассеты workspace. |
| AC-07 | Неверный/истёкший/отозванный токен, чужой снимок, поддельные origin/source/сообщения и traversal отклоняются; приложение превью не открывает admin/login. |
| AC-08 | Успешная публикация переключает current; неудачная сохраняет live; откат сохраняет workspace. В UI отсутствует имитация ещё не реализованного кандидата. |
| AC-08 | Успешная публикация переключает current; неудачная сохраняет live; откат сохраняет workspace. Сборка кандидата не переключает Live; публикация проверяет его актуальность и expected_live без повторного рендера. |
| AC-09 | Основные экраны, ошибки, диалоги и редакторы проходят адаптивную и клавиатурную проверку на заданных размерах. |
| AC-10 | Wheel содержит runtime-ресурсы; обычная сборка сайта проходит и не содержит служебной разметки/скриптов preview-режима. |
| AC-11 | Реальный FastAPI проверяет запросы и ответы JSON API, единый формат ошибок и OpenAPI. HTML- и API-маршруты не смешивают форматы; UI вызывает API через ASGITransport с проверенным автором. Ошибки/отказ API отражаются в UI без обхода через прямую запись. |
+25 -4
View File
@@ -43,8 +43,8 @@
- Проверены q/status/layout, вложенные ID, пустая выдача, выбранный объект и неизвестный ID; представлены реальные file/layout/count/current.
- [ ] **T009** Перенести формы Page, Block и Entry и существующие операции блоков.
- Сохранены имена полей и URL, создание draft, слоты/привязки, добавление/порядок/видимость/удаление и семантика формы без изменений.
- [ ] **T010** Перенести существующие публикацию, историю и откат с подтверждениями.
- В UI отражены реальные build+publish и rollback; кандидат/diff не имитируются; ошибки сборки и отсутствие релизов отображаются.
- [x] **T010** Перенести существующие публикацию, историю и откат с подтверждениями.
- Исходный Publication, реальные build candidate/activate и rollback; настоящий diff/preview; CAS Live, видимые ошибки и пустые состояния. Техническая приёмка — verification-publication.md; визуальная проверка пользователя отдельно P006.
- [x] **T011** Исправить CSP iframe и защищённые ассеты workspace.
- Браузер загружает пассивное превью; изображения и зависимые ресурсы берутся из workspace; traversal/выход по symlink отклоняется; binary MIME корректен.
- [x] **T012** Сохранить пользовательские значения при 409/422 на существующих формах.
@@ -147,10 +147,31 @@
| NFR-03–NFR-04 | T004–T006, T021–T023, T029, T033 | AC-09 |
| NFR-05–NFR-06 | T011–T015, T020, T026, T031, T034–T036 | AC-03, AC-05, AC-08, AC-10 |
Релизы, медиа/настройки, доступы, заявки и MCP следующей очереди не входят в список выполнения 001. Их порядок и зависимости перечислены в конце `plan.md`.
Расширенный workflow релизов, медиа/настройки, доступы, заявки и MCP следующей очереди не входят в список выполнения 001; реальный candidate/diff включён уточнением этапа 5. Их порядок и зависимости перечислены в конце `plan.md`.
## Прежняя функциональная проверка (визуальная приёмка открыта повторно)
2026-11-12: 239 тестов; настоящий FastAPI/ASGITransport; 25 сценариев Chromium на двух origin; 8 экранов и 60 проверок ширины, обе темы, клавиатура и reduced motion; validate/build примеров stage7 — 0 ошибок/0 предупреждений, 7 страниц; wheel установлен вне checkout без design/. Подробная матрица требований, команды и ограничения — [verification.md](verification.md); машиночитаемые результаты — [qa-results.json](qa-results.json).
Этапы 1–2 приняты пользователем. Этап 3 (Конструктор/Эксперт Page) подготовлен к проверке: исходные компоненты builder-antirion, реальные дерево/инспектор/каталог/источники, автоматическое применение полей и явное сохранение, дублирование поддерева, перетаскивание, 422 без потери ввода, сравнение/отмена/форматирование исходника. 247 тестов; Chromium — 12 сравнений Конструктора и 6 «Эксперта», 11 групп сценариев; регрессия editor/shell/pages, CLI и установленного wheel — OK. Подробности — [design-transfer.md](design-transfer.md). Этапы 4–5 и общая визуальная приёмка T033/T036 остаются открытыми; переход — после проверки пользователя.
Этапы 1–2 приняты пользователем. Этап 3 (Конструктор/Эксперт Page) подготовлен к проверке: исходные компоненты builder-antirion, реальные дерево/инспектор/каталог/источники, автоматическое применение полей и явное сохранение, дублирование поддерева, перетаскивание, 422 без потери ввода, сравнение/отмена/форматирование исходника. 247 тестов; Chromium — 12 сравнений Конструктора и 6 «Эксперта», 11 групп сценариев; регрессия editor/shell/pages, CLI и установленного wheel — OK. Подробности — [design-transfer.md](design-transfer.md). На момент этой проверки этапы 4–5 оставались открытыми. Их текущий статус приведён ниже; общая пользовательская визуальная приёмка T033/T036 остаётся отдельной.
## Повторный перенос: этап 4 / Content (2026-11-17)
- [x] **C001** Перенести исходные четыре панели, формы, Expert, диалоги, CSS/SVG и responsive без самостоятельного дизайна.
- [x] **C002** Подключить настоящие коллекции, поля, связи, использования, схему и поиск/фильтры.
- [x] **C003** Дополнить API проверкой готовности, CAS-дублированием/удалением, сравнением и настоящим Workspace/Card/Page и Live/Page.
- [x] **C004** Подключить общую фоновую очередь 003, явное сохранение, видимые 409/422/500/сеть и исходные подтверждения.
- [x] **C005** Пользователь разрешил переход от Content к этапу 5.
Технические проверки и ограничения: [verification-content.md](verification-content.md); доработки: [content-backend.md](content-backend.md). Публикация/история/откат реализованы этапом 5 ниже; общая пользовательская визуальная приёмка остаётся отдельной.
## Повторный перенос: этап 5 / Publication (2026-11-17)
- [x] **P001** Перенести исходную композицию, CSS/SVG, пять вкладок, таблицу/инспектор и диалоги в принятый shell.
- [x] **P002** Реализовать private provenance, реальные изменения/историю, build без активации и неизменяемое сравнение кандидата.
- [x] **P003** Подключить preview готового релиза, подтверждение с комментарием, source/render/output hashes и expected_live под SiteLock.
- [x] **P004** Подключить действительные историю релизов/аудит, последствия отката и переключение без изменения workspace; видимые ошибки/сеть/конфликты, committed_build и traceback.
- [x] **P005** Проверить контракт, браузер/ширины/две темы/два preview origin, общий UI и установленный wheel; обновить OpenAPI и документацию.
- [ ] **P006** Пользовательская визуальная приёмка Publication и итоговых экранов.
Границы — [publication-backend.md](publication-backend.md); результаты и команды — [verification-publication.md](verification-publication.md). Общие T004–T009/T013/T033/T036 не закрываются автоматически технической проверкой этого экрана.
@@ -0,0 +1,59 @@
# Проверка этапа 4 — Content Editor
Дата: 2026-11-17. Реализация подготовлена к проверке пользователя. Источники — оригинальные `content-antirion.html`, `assets/content-editor.{css,js}` и общий `builder.css`. Декларации CSS и SVG переносятся воспроизводимым скриптом; принятый shell сохранён. Доработки и границы бэкенда — [content-backend.md](content-backend.md).
## Сервер и данные
`tests/test_content_editor.py`: 13 тестовых методов проверяют настоящий FastAPI/HTML adapter на временной копии текущего `examples/site-studio`:
- исходную композицию, статические ресурсы, пустую выключенную коллекцию;
- один Registry и внутренний API call на update, настоящий рендер карточки и отсутствие записи/history/publish;
- строгую проверку кандидата с required/link/asset и сохранение неполного draft отдельно;
- диагностику невалидного YAML без потери исходника;
- типизированные вложенные ref/link, обратные связи и query membership текущего кандидата;
- typed link/list/refs/boolean через общий парсер полей;
- копирование текущей редакции в draft, неизменность оригинала, CAS источника/цели и запрет traversal;
- запрет удаления published, необходимость сохранённого archive, CAS и историю;
- traceback/request_id и committed/deleted при отказе аудита после фактической операции;
- Live из HTML/assets релиза, отдельный защищённый snapshot/CSP, отсутствие смешивания с workspace;
- сравнение несохранённого source, неизвестное сравнение старого manifest и отсутствие Live/Card;
- пустой новый draft: slug как подпись только в представлении, без выдуманного title в файле;
- JSON-ошибки авторизации/CSRF/DTO.
13 тестов проходят. Вместе с 12 тестами общей очереди 003 — **25 тестов OK** после последних уточнений.
Полная регрессия — **384 unittest-теста OK**. Как и в 003, старые тесты требуют удалённый `examples/studio-site`: использовалась временная фикстура из коммита `231490b` с миграцией inline theme в файл schema 1 minimal@1; `tests/helpers.EXAMPLE` указывает на временную копию перед discovery. Примеры не возвращались в репозиторий. Ограничение и схема фикстуры описаны в [003 verification](../003-background-editor/verification.md). Старый тест заполнения `.env.example` исправлен: замена всей строки вместо конкатенации нового хеша с уже записанным пользователем. Сам `.env.example` и настройки входа не менялись.
## Chromium и оригинал
`scripts/qa_content_001.py` поднимает настоящий uvicorn на временном Site Studio и отдельно открывает дизайнерский оригинал. Сверяются **12 наборов**: 1440/1280/1024/768/390/360 px × light/dark. Проверяются шрифты/padding устойчивых компонентов, ширины колонок desktop и исходные светлые фоны; dark использует ранее принятую палитру Antirion. Снимки desktop/mobile/dark и реальный конфликт просмотрены визуально. Разные данные и настоящий рендер публичной карточки не сравниваются как попиксельно одинаковые изображения mock.
Проверяются поиск/фильтры/вкладки без POST, фокус, один update и сохранённые input/iframe, ввод и вкладки при задержанном POST, реальные asset/ref picker и boolean, добавление/удаление/перенумерация списка, Workspace/Card/Page и immutable Live/Page, явное пустое состояние Live/Card, review/Expert/diff/поиск/невалидный YAML/исправление, переход с несохранёнными правками, явный Save без publish, настоящий CAS/409, duplicate из текущей редакции, отмена и подтверждение удаления, guard published, пустая/OFF коллекция, создание draft, видимые HTTP500/сеть и восстановление.
Полный сценарий прошёл в обоих режимах preview: **13 групп** на пассивном административном origin и **12 групп** на bridge отдельного origin (сравнение геометрии общее). Все **12 визуальных наборов** проверены. Неожиданных JS/console/CSP-ошибок и native dialogs — **0**. В отчёте намеренные 409/422/500/сеть отделены от неожиданных ошибок; native dialogs запрещены. Артефакты: `/tmp/site-engine-content-001/report.json`, `content-{light,dark}-{width}.png`, `reference-{width}.png`, `review-{False,True}.png`, `conflict-{False,True}.png`.
Дополнительно `scripts/qa_editor_updates.py` прошёл **26 групп** в двух режимах preview: прежние сценарии конструктора, очереди, фокуса/caret, списков, сохранения/конфликта, JS-изоляции и Entry. **0 JS-ошибок, 0 native dialogs**. Подтверждён максимум один update одновременно. В Entry-сценарии явно выбирается Page: начальный вариант Content теперь Card, как в оригинале. Артефакты — `/tmp/site-engine-editor-updates/browser.json`.
## Сборка и упаковка
- CLI validate `examples/site-studio`: **0 ошибок, 0 предупреждений**.
- CLI build: **13 страниц**, релиз в `/tmp/site-studio-content-dist/current/`.
- `scripts/verify_package_001.py --site examples/site-studio`: wheel установлен вне checkout без `design/`; проверены Content templates/CSS/JS, настоящее чтение и карточка через HTML adapter/API, прежние Theme Manager/пресеты/сборка/preview/queue.
- `scripts/sync_content_design.py --check`: совпадают исходные декларации CSS и SVG.
- Ruff изменённых Python, `node --check` изменённых JS, `git diff --check`: проходят.
Основные команды:
```bash
PYTHONPATH=src python -m unittest discover -s tests -p test_content_editor.py -v
PYTHONPATH=src python scripts/qa_content_001.py
PYTHONPATH=src python scripts/qa_editor_updates.py
python scripts/sync_content_design.py --check
python scripts/verify_package_001.py --site examples/site-studio
PYTHONPATH=src python -m site_engine.cli validate examples/site-studio
PYTHONPATH=src python -m site_engine.cli build examples/site-studio --out /tmp/site-studio-content-dist
```
Коммит и развёртывание не выполнялись. Для пользовательской проверки требуется пересборка образа: ресурсы и код находятся в runtime-пакете. Следующий этап публикации UI ожидает проверки Content. Slug rename, редактор схем, RBAC, полноценный индекс ссылок в Markdown/Jinja/JS и отдельный сохранённый Live/Card не добавлены.
Повторная расширенная проверка перед коммитами — [verification-regression.md](verification-regression.md).
@@ -0,0 +1,76 @@
# Проверка этапа 5 — Publication
Дата: 2026-11-17. Этап реализован и подготовлен к проверке пользователя. Источник — оригинальный `publication-antirion.html` / `assets/publication.{css,js}`; адаптация сохраняет принятый Antirion shell. Контракт, данные и ограничения — [publication-backend.md](publication-backend.md).
## Проверки сервера
Полная регрессия: **397 unittest-тестов OK** (384 прежних и 13 Publication на момент запуска). После добавления проверок истории/реального output diff, отказа аудита после сборки и JSON 401 повторно выполнены все **16 Publication-тестов — OK**. На тот момент это соответствовало 400 методам; единый запуск всех 400 не заявлялся.
Новые тесты используют временный текущий `examples/site-studio`, настоящий FastAPI и HTML adapter. Проверены build без активации, публикация точных байтов без рендера, private/public разделение, source/renderer freshness, подмена output, CAS Live, замена кандидата, запрет отката неопубликованного кандидата, CLI без provenance, immutable diff, реальные версии документов и изменённые файлы релиза, неуспешный strict render, оба preview origin, CSRF/auth/session-expired/traversal/symlink, ошибки после совершённой операции и request_id/traceback.
Старым тестам нужен удалённый `examples/studio-site`. Для полной регрессии использована временная фикстура из `231490b` с уже мигрированными файловыми настройками темы; `tests/helpers.EXAMPLE` заменялся только в процессе до discovery. Файлы удалённых примеров в checkout не восстанавливались. Схема окружения — [003 verification](../003-background-editor/verification.md); подробный лог запуска — `/tmp/publication-regression.log`.
## Настоящий Chromium
`qa_publication_001.py` запускает uvicorn на временной копии Site Studio и оригинальный макет отдельно. Выполнены **12 наборов визуальной сверки**: 1440/1280/1024/768/390/360 px, светлая и тёмная тема. Измеряются шрифты/padding/цвета исходного экрана; runtime использует размеры принятого shell и его тёмную палитру. Это не побайтовое сравнение скриншотов: данные, число файлов и shell оригинала отличаются. Проверены отсутствие горизонтального переполнения и ручная сверка screenshot композиции, preview и отката.
**25 групп браузерных проверок** на двух конфигурациях preview (13 + 12):
- первый релиз и пустые состояния, реальные локальные фильтры/выбор/вкладки без POST;
- сравнение документа и существующая/пустая история в исходных диалогах;
- проверка без публикации, фоновая сборка без блокировки вкладок и без переключения Live;
- настоящий immutable diff/preview со стилями и без скриптов;
- отмена и подтверждённая публикация ровно выбранного кандидата;
- устаревший кандидат: видимый 409 и прежний Live;
- отмена/подтверждение отката, сохранение workspace, перечитывание истории/комментариев/аудита;
- намеренные 500/обрыв сети, видимая ошибка и восстановление;
- переходы на ранее перенесённые экраны, клавиатурные вкладки и выход.
Непредвиденных JS/console/CSP-ошибок и нативных alert/confirm/prompt — **0**. Намеренно вызванные HTTP 409/500 и сетевой отказ перечислены отдельно в отчёте.
Артефакты: `/tmp/site-engine-publication-001/report.json`, парные `publication-{light,dark}-*.png` / `reference-*.png`, `candidate-preview-{False,True}.png`, `rollback-{False,True}.png`. Они временные и не входят в репозиторий; сценарий воспроизводит их.
## Общая совместимость
- `qa_001.py`: **8 экранов / 60 проверок ширины — OK**, `/tmp/site-engine-publication-general/`.
- `qa_shell_001.py`: **12 наборов геометрии / 6 групп сценариев — OK**, включая Ctrl+K, htmx-переходы, мобильный фокус, профиль/выход и Live после настоящей публикации; `/tmp/site-engine-shell-001/report.json`.
- `qa_errors_001.py`: **6 групп — OK**, включая 500 публикации со стеком/ID, desktop/mobile уведомления, 500/сеть сохранения без потери ввода и последующее сохранение/публикацию; `/tmp/cms-errors-qa/report.json`.
- Установленный wheel вне checkout без `design/`: настоящие кандидат/preview/активация, API, шаблоны и новые статические ресурсы — OK; `/tmp/publication-package.log`.
Проверки генератора CSS/SVG, `node --check`, Ruff и `git diff --check` прошли. CLI: validate — 0 ошибок/0 предупреждений; build — 13 страниц в `/tmp/site-studio-publication-final`. OpenAPI экспортирован заново из приложения.
## Воспроизводимые команды
```bash
PYTHONPATH=src python -m unittest discover -s tests -p test_publication.py -v
PYTHONPATH=src python scripts/qa_publication_001.py
PYTHONPATH=src python scripts/qa_001.py --out /tmp/site-engine-publication-general
PYTHONPATH=src python scripts/qa_errors_001.py
PYTHONPATH=src python scripts/qa_shell_001.py
python scripts/verify_package_001.py
python scripts/sync_publication_design.py --check
node --check src/site_engine/web/admin/static/publication.js
PYTHONPATH=src python -m site_engine.cli export-openapi --out specs/001-antirion-admin/openapi.json
PYTHONPATH=src python -m site_engine.cli validate examples/site-studio
PYTHONPATH=src python -m site_engine.cli build examples/site-studio --out /tmp/site-studio-publication-final
```
В рабочем окружении использован Python `/tmp/flexly-cms-htmx-check/bin/python`, системный Chromium Playwright с `--no-proxy-server`. Проверки выполнялись на временных сайтах; live `data/`, `.env` и Docker не изменялись. Развёртывание контейнера, долгие нагрузочные испытания, отказ процесса во время нескольких служебных записей и пользовательская визуальная приёмка этим отчётом не подтверждаются.
## Исправление загрузки через меню (2026-11-17)
Пользователь обнаружил падение `null.textContent` при первом переходе в Publication. Первоначальный Publication QA открывал экран через `page.goto`, поэтому не покрывал этот сценарий. Утверждение об отсутствии ошибок относилось к фактически выполненным сценариям, а проверка загрузки через htmx была пропущена.
Причина воспроизведена в Chromium на временном сайте: при `allowScriptTags:false` htmx удаляет также `<script type="application/json">` с начальными данными. `initialize()` читал отсутствующий элемент. При полной загрузке браузер сохранял JSON-элемент, поэтому обновление страницы работало. Кэш браузера к этому отказу отношения не имеет.
Начальные данные перенесены в скрытый textarea с JSON, экранированным `tojson`, чтение выполняется через `.value`; политика `allowScriptTags:false` / `allowEval:false` сохранена. Ошибка разбора начальных данных отображается через общее уведомление. Основной `qa_publication_001.py` теперь входит в экран настоящим htmx-кликом и проверяет `HX-Boosted`, затем выполняет workflow публикации.
Добавлен `scripts/qa_publication_navigation_001.py`. До исправления он воспроизвёл точное исключение, отсутствие bootstrap и зависшую загрузку; после исправления прошли **14 групп проверок**: вход через меню из Pages, Entry и Page Editor; повторный вход; Back/Forward; полная перезагрузка на 1440/390 px. Проверка удостоверяется, что htmx-переходы сохраняют JS-контекст документа и запрет скриптов. Непредвиденных JS/console-ошибок и системных диалогов — 0. Публикация не запускалась.
Команда: `PYTHONPATH=src python scripts/qa_publication_navigation_001.py`. Артефакты — `/tmp/site-engine-publication-navigation-001/report.json` и `publication-navigation-{1440,390}.png`; журналы воспроизведения — `/tmp/publication-navigation-before.log` и `/tmp/publication-navigation-after.log`.
Настоящий вход через меню выявил и вторую проблему в конфигурации отдельного preview origin: после htmx swap браузер сохраняет CSP исходного документа. Разрешение iframe только в ответе `/admin/publish` не действовало при входе из Overview/Pages. Общая HTML-фабрика теперь добавляет ровно настроенный preview origin к frame-src для всех страниц shell; скриптовые разрешения и sandbox снимка сохранены. Отдельный тест проверяет исходные страницы и отсутствие лишних origin/скриптовых разрешений.
После обоих исправлений повторно прошли **17 целевых тестов**, **14 групп навигации** и полный `qa_publication_001.py`: **25 групп workflow / 12 визуальных наборов**, включая действительные htmx-переходы в обеих конфигурациях preview. Непредвиденных JS/console/CSP-ошибок — 0. Логи: `/tmp/publication-htmx-tests.log`, `/tmp/publication-navigation-after.log`, `/tmp/publication-htmx-workflow.log`. Ruff, `node --check`, проверка генератора дизайна и `git diff --check` — OK. Проверки выполнены в Chromium на временных сайтах; серверный контейнер не пересобирался.
Повторная расширенная проверка перед коммитами — [verification-regression.md](verification-regression.md).