Return structured JSON errors with request IDs, log unexpected exceptions with tracebacks, and show HTTP and network failures in the admin UI without losing unsaved source. Preserve publication errors when release listing also fails, handle cancelled preview promises, and add regression tests, browser failure scenarios, and updated API documentation.
19 KiB
Приёмка 001 — 2026-11-12
Визуальная приёмка открыта повторно. Пользователь обнаружил расхождения с исходной вёрсткой и поведением дизайна. Прежние функциональные проверки ниже не доказывают корректность переноса макетов. Повторный перенос идёт по отдельным этапам с проверкой пользователя: каркас, обзор и страницы приняты пользователем; этап 3 (Конструктор/Эксперт Page) подготовлен к проверке. Контент/Entry и публикация ожидают этапов 4–5.
Текущая регрессия этапа 3: 248 тестов OK; после исправления CSS-совместимости Chromium и Firefox 142 — в каждом 12 наборов сверки Конструктора + 6 «Эксперта» с оригиналом, 12 групп реальных сценариев конструктора; Chromium — 25 сквозных сценариев редактора на двух origin. Shell/pages повторно проверены — 12/24 набора и 6/6 групп. Предыдущая общая проверка — 8 экранов/60 ширин; установленный wheel работает без design/, CLI validate/build на временной копии studio-site — 0 ошибок/предупреждений, 7 страниц. Подробности и границы сравнения — в разделе этапа 3 design-transfer.md. Ниже сохранены свидетельства предыдущей функциональной реализации, а не статус визуальной приёмки всех экранов.
Ниже сохранены результаты функциональной реализации A–F. Действующий контракт и инструкции запуска: runtime.md. Машиночитаемые результаты: qa-results.json, JSON-контракт: openapi.json.
Обработка ошибок — 13.11.2026
- Общая HTTP-граница возвращает JSON
error.code/message/request_idдля API, записывает неожиданные исключения со стеком вuvicorn.error. HTML-запрос и вложенные ASGI API-вызовы имеют один ID; тело запроса, cookies, Authorization и query string не добавляются в записи. Код и ID доступны в UI и заголовках ответа. - Проверена настоящая ошибка файловой системы при сборке (
distзанят файлом), а также инъекцииPermissionError/RuntimeError: JSON 500, HTML-страница публикации и traceback содержат согласованный ID. Если загрузка релизов после неудачной операции тоже падает, сохраняется исходная ошибка, а недоступный список не выдаётся за пустой. - 258 unit/integration-тестов — OK. Регрессия запущена на временной копии studio-site; недоступный для чтения рабочий
pages/index.mdзаменён версией из HEAD только во временной фикстуре. Пользовательские примеры и рабочие данные не изменены. - Chromium и Firefox: по 6 групп сценариев ошибок — OK: ошибка публикации видна в странице/уведомлении на 1440 и 390 px; стек содержит ID из UI; 500 Save и обрыв сети сохраняют точный исходник и доступность редактора; последующие Save и Publish успешны. Нативных диалогов и необработанных JS-исключений нет. Исправлен также необработанный Promise отменённого preview-запроса при уходе со страницы.
- Обычная браузерная регрессия ai-studio в Chromium: 18 групп, 14 страниц × 5 ширин — OK; проверены каталог, выбор секций, preview, сохранение, вход и выход.
- Ruff для изменённых Python-модулей/тестов/QA,
node --checkadmin/editor JS,git diff --check— OK. Экспорт OpenAPI совпадает с runtime; ErrorBody включает обязательныйrequest_id. - Повторяемый сценарий:
PYTHONPATH=src python scripts/qa_errors_001.py; отчёты и снимки —/tmp/cms-errors-qa/, Firefox —/tmp/cms-errors-qa-firefox/. Изменения на пользовательском сервере не разворачивались: для применения нужна пересборка образа и пересоздание контейнера. Причина исторической 500 на сервере по одной строке access log не установлена; новый обработчик сохраняет исходное исключение при повторении.
Выполненные проверки
| Проверка | Результат |
|---|---|
| Исходная точка | 206 тестов, validate/build чистого studio-site; 7 страниц |
| Полная регрессия | 239 тестов, OK, без пропусков |
| JSON API после объявления security scheme | Дополнительно 11 тестов test_api_001.py, OK |
| Настоящий Chromium, обычные экраны | 8 экранов, 60 проверок ширины, без JS-исключений и переполнения страницы |
| Настоящий Chromium, отдельные HTTP-origin admin/preview | 25 сквозных сценариев, без JS-исключений |
| Исправленные примеры stage7 | Page и Entry подставлены в изолированную копию: validate — 0 ошибок, 0 предупреждений, build — 7 страниц |
| Установленный wheel | Собран и установлен в отдельный каталог вне checkout; design/ отсутствует; реальные FastAPI, HTML, API, статика и отдельное preview-приложение работают |
| Статика и качество кода | node --check admin/editor/htmx; новые Python-модули/сценарии прошли Ruff; git diff --check |
| Публичная сборка | Сохранена семантика build/publish/rollback; нет data-preview-* и bridge в публичном HTML |
Все функциональные записи и публикации выполнялись на временных копиях. Рабочие .env, .engine, dist, права файлов и секреты примера не менялись. Проверка дефекта стилей дополнительно выполнена прямо на сервере пользователя без прокси: исправленные CSS/JS подменялись только в тестовой вкладке, серверная сборка и контент не обновлялись. В тестовом helper .engine исключён при копировании: рабочий audit.jsonl имеет ограниченные права. Зависимости server/dev и браузеры установлены в отдельном окружении.
Покрытие требований
| Требования | Реализация и свидетельство |
|---|---|
| FR-01, FR-02 | Runtime Antirion CSS/shell, реальные четыре раздела, будущие действия недоступны с объяснением; скриншоты 8 экранов |
| FR-03 | q/status/layout, поиск Page/Entry и свойства; действующие UI и API-фильтры, тесты редактора/API и пустая выдача в Chromium |
| FR-04, FR-05 | Старые URL/form fields поддерживаются адаптером к API; 409 сохраняет версии, 422 — источник/поля; реальные обычные формы и htmx |
| FR-06, FR-07 | PageService/EntryService, dataclass Snapshot/Context и Report; test_documents.py, типизированные Snapshot DTO |
| FR-08, FR-09 | Единый буфер и явный Save; отсутствие записи/истории до Save, один lock, CAS двух писателей, текущая схема, атомарная запись и однократный аудит |
| FR-10 | Регионы/слоты/ID, ссылки/привязки/query и Markdown сохраняются; вложенные слоты и отказ циклу проверены; layout/display доступны в read-only инспекторе |
| FR-11, FR-12 | Серверный YAML, вложенные дубли/aliases/лимиты отклоняются; ошибочный текст и последнее корректное дерево сохраняются; режимы и предупреждения dirty |
| FR-13 | Две вкладки: Save → 409 → сравнение → явное принятие основы → отдельный Save; история и чужие данные сохраняются |
| FR-14, FR-15 | Несохранённые props и новый SVG workspace отображаются до Save; preview→tree, tree→preview, скрытые блоки и восстановление viewport после загрузки ресурсов |
| FR-16 | Второй uvicorn и origin, nonce CSP, подписанный TTL/epoch token для каждого HTML/asset; проверки origin/source/snapshot/revision/owner/id |
| FR-17 | Preview-mode Renderer выключен по умолчанию; обычный build не получает маркеры и bridge, проверено тестом и браузерной публикацией |
| FR-18, FR-19 | JSON/Pydantic/OpenAPI, request-scoped ASGI-клиент; cookie/forged/expired/old epoch отвергаются; UI не обходит отказ API; credentials отсутствуют в HTML и browser requests |
| FR-20 | Настоящий локальный htmx, согласованные partials/revision, 409/422/401, сетевой отказ и устаревшее превью; текст сохраняется и скачивается |
| NFR-01, NFR-02 | Прежние 206 тестов, старые формы/CLI; autoescape, санитайзер, cookie/CSRF/CSP и пути сохранены; traversal и запись кода через symlink отвергаются |
| NFR-03 | 1440/1280/1024/768/390/360 px: 8 основных экранов + Constructor/Expert в тёмной теме; внутренний scroll таблиц, без overflow всей страницы |
| NFR-04 | Tab/Shift+Tab мобильного меню и диалога, Esc и возврат фокуса, подписи, iframe titles; браузер редактора запущен с reduced motion |
| NFR-05 | Реально установленный wheel запускает интерфейс и bridge без design/; package-data покрывает все runtime-файлы |
| NFR-06 | CAS/validation/history/save и preview snapshots разделены; неудачная сборка не меняет live, rollback не меняет workspace; ошибки без трассировок/секретов |
Критерии приёмки
| Критерий | Свидетельство |
|---|---|
| AC-01 | Вход, обзор, Page/Block/Entry, старые маршруты и новое оформление: regression + real HTTP + Chromium |
| AC-02 | Семантический round-trip существующих форм, вложенные слоты, режимы и точный Save CRLF без изменений |
| AC-03 | Байты canonical/история/current неизменны до Save; workspace-ассет и buffer preview проверены |
| AC-04 | Дубли/aliases/depth, неверные типы/фрагменты/регионы и fixed не сохраняются; исходник/инспектор остаются доступны |
| AC-05 | Настоящие две вкладки, сохранение ввода при 409, обе версии и явный rebase |
| AC-06 | Preview-select и read-only fixed, однозначные scope/owner/id и вложенные маркеры; tree scroll, viewport restore и последние unsaved props |
| AC-07 | Неверная подпись, expiry, epoch/logout, чужой snapshot, каждый asset, symlink/traversal, поддельные сообщения; preview app возвращает 404 для admin/login/API |
| AC-08 | Publish/rollback в настоящем браузере; отказ сборки сохраняет live по регрессионным тестам; candidate pipeline не имитируется |
| AC-09 | Responsive 60 проверок; обе темы, мобильная навигация, клавиатура, диалог/фокус и reduced motion |
| AC-10 | Wheel вне checkout без design/, CLI build и отсутствие служебной разметки в публичной сборке |
| AC-11 | Реальный FastAPI и ASGITransport, Pydantic DTO/actions, OpenAPI security schema, errors/201/401/403/404/409/422/413, доказательство прохождения UI через API |
| AC-12 | Настоящий htmx: partials, 409/422/401, source download при истечении сессии, отказ сети, stale preview; отдельная обычная форма Save без JS |
Воспроизведение
Из корня репозитория после установки .[server,dev] и python -m playwright install chromium:
python -m unittest discover -s tests -q
PYTHONPATH=src python scripts/qa_001.py
PYTHONPATH=src python scripts/qa_editor_001.py
PYTHONPATH=src python scripts/qa_selection_001.py
PYTHONPATH=src python scripts/qa_builder_001.py
python scripts/sync_builder_design.py --check
python scripts/verify_package_001.py
site-engine export-openapi --out /tmp/admin-api.json
В приёмке использовался /tmp/flexly-cms-htmx-check/bin/python; путь не является зависимостью проекта. QA-скрипты сами создают копию studio-site и закрывают тестовые серверы. Скриншоты и JSON-отчёты находятся в /tmp/site-engine-001-qa/ и /tmp/site-engine-001-editor-qa/; сводный JSON сохранён рядом со спецификацией. Визуально просмотрены рабочие списки и трёхколоночный редактор; reference-снимки Antirion сохранены отдельно от runtime.
Практические ограничения
- Docker-образ, reverse proxy и production HTTPS не разворачивались; проверены две настоящие локальные HTTP-origin и установленный пакет. Команды Docker/proxy приведены в runtime.md.
- Каркас, списки и полная регрессия редактора проверены в Chromium. Конструктор дополнительно проверен в Firefox 142: 12 наборов сверки конструктора, 6 «Эксперта» и 12 групп сценариев. Дефект из скриншота пользователя воспроизведён на сервере напрямую без прокси; исправленные ресурсы проверялись подменой в тестовой вкладке, без установки на сервер. Safari отдельно не проверялся.
- Без двух корректных origin доступно превью без scripts, с двусторонним выбором секций через родительскую админку. Отдельный preview-процесс требует корректную конфигурацию.
- Буфер живёт в открытой вкладке. Для переноса/долгого хранения используйте Save или скачивание исходника. Структурные правки нормализуют YAML без отдельного подтверждения. Нативные диалоги запрещены; при внутренних переходах используются окна интерфейса, а перезагрузка/закрытие вкладки теряют несохранённую редакцию без системного запроса.
- Просроченные preview-файлы очищаются при старте/следующем создании, доступ по TTL/epoch блокируется независимо от очистки. Preview assets ограничены 50 MiB.
- Спецификации 002–006 (candidate/diff, загрузки/rename/настройки, RBAC, заявки/outbox, MCP) остаются вне 001.
Исправления выбора секций и диалогов
Полная регрессия: 248 тестов OK; конструктор в Chromium: 12 сравнений + 6 «Эксперта», 12 групп сценариев; редактор: 25 сценариев. Дополнительный qa_selection_001.py прошёл в Chromium 158 и Firefox 142, в каждом — оба режима превью: локальный выбор без POST и замены iframe, выделение/прокрутку, клики по секциям, fixed-инспектор, повторные правки кешированных форм без записи файла, отмену/подтверждение переходов и выхода через модальные окна интерфейса, перезагрузку без нативного диалога. Артефакты — /tmp/site-engine-selection-001/, /tmp/site-engine-selection-firefox-001/.
Во время последнего прогона рабочий examples/studio-site/pages/index.md оказался недоступен для чтения (root, 0600). Проверки выполнены на временной копии примера с этим файлом из Git HEAD; остальные доступные файлы примера скопированы как обычно. Права и рабочий контент не менялись. Изменения выбора и диалогов на сервер пользователя не устанавливались.