Make editor updates asynchronous with unified preview API

This commit is contained in:
2026-11-13 15:18:56 +03:00
parent 0d171915d7
commit 3562194d92
30 changed files with 2445 additions and 748 deletions
@@ -0,0 +1,60 @@
# Проверка 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](runtime.md). Рабочие данные, .env, live, design/ не менялись. Развёртывание и коммит не выполнялись. После пересборки образа пользователь проверяет конструктор на своём сервере.