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

8.6 KiB
Raw Blame History

Проверка этапа 4 — Content Editor

Дата: 2026-11-17. Реализация подготовлена к проверке пользователя. Источники — оригинальные content-antirion.html, assets/content-editor.{css,js} и общий builder.css. Декларации CSS и SVG переносятся воспроизводимым скриптом; принятый shell сохранён. Доработки и границы бэкенда — 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. Старый тест заполнения .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: проходят.

Основные команды:

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.