Files
flexly-cms/specs/003-background-editor/verification.md
T

8.6 KiB
Raw Blame History

Проверка 003

Дата: 2026-11-13. Реализация подготовлена к пользовательской проверке после пересборки контейнера.

Результат

Один update заменяет последовательные transform и preview. Подтверждены один внутренний API-вызов и один Registry на пакет с рендером. Рабочая редакция остаётся в памяти вкладки, запись контента выполняется явным Save с прежним CAS. Ввод/переключение секций не блокируются; новые изменения продолжают очередь на принятой редакции. В обычном сценарии сохраняются активное поле, iframe и Document. Списки получают новую пустую строку; удаление корректно учитывается даже при более новом вводе во время ответа.

Сервер

371 unittest-тест прошёл в полной регрессии. В tests/test_editor_updates.py добавлено 12 тестов:

  • один AdminApi call и Registry для нескольких операций с preview, компактная проекция без скрытых повторов source;
  • отсутствие записи canonical content/history/live при update;
  • сохранение исходных комментариев/байтов Expert при пустом пакете;
  • общие типизированные поля, привязки, вложенные блоки и ширина;
  • отказ всего пакета при ошибке последующей операции;
  • сохранность исходника при ошибочных формах/YAML;
  • независимый отказ preview: принятый snapshot, traceable error, traceback без исходника;
  • HTTP 500 для неожиданного отказа сервиса;
  • HTTP 500 и журналирование ошибки серверной проекции вместо маскировки как невалидного ввода;
  • явный Save и реальный CAS/409;
  • JSON-ошибки auth/CSRF/DTO;
  • overlay записи и компактный HTML-адаптер записи; неоднозначное направление move отклоняется отдельной проверкой.

Счётчик 12 относится к методам тестов: некоторые проверяют несколько связанных условий. После финального удаления повторов source из проекций целевые 12 тестов запускались отдельно.

Существующие тесты используют удалённый examples/studio-site. Полная регрессия запускалась на временной базовой фикстуре из коммита 231490b, через подмену tests/helpers.EXAMPLE перед unittest discovery. В ней старый inline theme мигрирован в site.yaml:theme.file: theme.yaml и отдельный schema 1 minimal@1 с overrides.colors.primary: '#0b5fff', overrides.custom_colors.hero_dark: '#14213d'. Остальной контент архивной фикстуры сохранён. Это ограничение тестовой инфраструктуры: обычный discover без такой фикстуры пока не воспроизводит полный успешный прогон. Удалённые примеры не возвращались в репозиторий. Новые тесты имеют собственную фикстуру; браузер проверяет текущий Site Studio.

Chromium

scripts/qa_editor_updates.py: настоящий FastAPI, временная копия examples/site-studio, Chromium без proxy. 13 групп сценариев в каждом из двух режимов preview — 26 проверок:

  1. Один POST на свойство, тот же активный input, iframe и Document.
  2. Добавление строки списка без потери фокуса; удаление и перенумерация при более новом вводе во время задержки.
  3. Удаление scripts/nonce/onload из обновляемого HTML; bridge отклоняет чужой snapshot.
  4. Искусственная задержка 2 секунды: продолжение ввода, мгновенное переключение секций, изменения в нескольких инспекторах, максимум один update одновременно.
  5. Невалидное число не теряется, Save блокируется, исправление восстанавливает preview.
  6. Отказ preview сохраняет принятую редакцию и последнее успешное preview; последующее обновление работает.
  7. Обрыв транспорта сохраняет поля, повторное редактирование восстанавливает очередь.
  8. Save дожидается update; ввод во время задержанного Save остаётся несохранённым.
  9. Две реальные вкладки, CAS-конфликт и явное принятие основы.
  10. Expert → конструктор → невалидный YAML → восстановление той же корректной редакции.
  11. Каталог, добавление/дублирование/удаление блоков через диалог дизайна.
  12. Отмена правок, mobile 390 px без горизонтального переполнения, screenshots 390/1440 px.
  13. Фоновое изменение записи коллекции с настоящим preview.

0 JavaScript-ошибок, 0 native dialogs. Намеренно вызванные validation/409/preview/network errors проверяются отдельно; traceback QA preview failure в журнале ожидаем.

Desktop/mobile screenshots просмотрены визуально. Стили/композиция экрана сохраняют существующий перенос дизайна; CSS дизайна не менялся.

Артефакты: /tmp/site-engine-editor-updates/browser.json, builder-{passive,bridge}-{1440,390}.png; журналы — /tmp/editor-updates-{browser,regression,tests,package}.log. Время input → применение preview измеряется внутри браузера, включая debounce 200 мс. В контрольном прогоне: 513 мс passive, 547 мс bridge. Это локальные измерения на Site Studio, не гарантия задержки на рабочем сервере. Серверная часть transform+render при отдельном замере — медиана около 249 мс. Ранее отдельные transform/preview и дополнительные чтения суммарно занимали около секунды серверной работы.

Пакет и статические проверки

scripts/verify_package_001.py --site examples/site-studio: wheel собран и установлен вне checkout/design. Проверены сборка сайта, штатные пресеты, templates/static, новый preview-update.js, фоновый update с одним API call без записи контента и bridge на отдельном origin, существующий Theme Manager.

OpenAPI обновлён в specs/001-antirion-admin/openapi.json. Ruff для изменённых Python, синтаксис изменённых JS и git diff --check проходят. preview.js содержит серверный placeholder конфигурации; его реальное исполнение проверяет Chromium в отдельном origin.

Команды целевой приёмки — в runtime.md. Рабочие данные, .env, live, design/ не менялись. Развёртывание и коммит не выполнялись. После пересборки образа пользователь проверяет конструктор на своём сервере.