Files
flexly-cms/specs/001-antirion-admin/verification-publication.md
T

77 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Проверка этапа 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).