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

60 lines
8.6 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.
# Проверка этапа 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).