Integrate Content Editor and Publication workflow
This commit is contained in:
@@ -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