Integrate Content Editor and Publication workflow
This commit is contained in:
@@ -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 запрещены.
|
||||
@@ -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
@@ -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 не выдаёт это за подтверждённое сравнение.
|
||||
@@ -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 должен оставаться приватным постоянным каталогом.
|
||||
|
||||
@@ -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 без обхода через прямую запись. |
|
||||
|
||||
@@ -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).
|
||||
Reference in New Issue
Block a user