12 KiB
Проверка этапа 5 — Publication
Дата: 2026-11-17. Этап реализован и подготовлен к проверке пользователя. Источник — оригинальный publication-antirion.html / assets/publication.{css,js}; адаптация сохраняет принятый Antirion shell. Контракт, данные и ограничения — 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; подробный лог запуска — /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 экспортирован заново из приложения.
Воспроизводимые команды
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.