Integrate Content Editor and Publication workflow

This commit is contained in:
2026-11-17 11:43:53 +03:00
parent f18bc9a4fd
commit c3938f24d8
55 changed files with 6207 additions and 203 deletions
+16 -2
View File
@@ -2,7 +2,7 @@
## Редактор и файлы
Начальный режим — Конструктор. «Применить к буферу» меняет исходник в памяти открытой вкладки; «Сохранить документ» записывает его целиком. Проверка и превью не создают историю контента и не меняют `current`. Публикация отдельно собирает и переключает релиз. В Entry редактируются поля коллекции и Markdown; layout/display доступны для чтения.
Начальный режим — Конструктор. «Применить к буферу» меняет исходник в памяти открытой вкладки; «Сохранить документ» записывает его целиком. Проверка и превью не создают историю контента и не меняют `current`. Новый экран публикации отдельно собирает кандидат, затем переключает его в Live; старые формы/CLI сохраняют build+publish. В Entry редактируются поля коллекции и Markdown; layout/display доступны для чтения.
«Эксперт» хранит точный исходник. Переход между режимами без правок не пересобирает YAML; сохранение без изменений сохраняет в том числе CRLF и комментарии. Конструктор предупреждает о пересборке YAML перед первой операцией. До неё можно скачать исходник. Неприменимый YAML остаётся в «Эксперте», последнее корректное дерево доступно для просмотра. В localStorage попадают только тема и ширина навигации; HTML-кеш htmx отключён.
@@ -131,10 +131,24 @@ python scripts/verify_package_001.py
HTML-проекция содержит серверные шаблоны инспектора для всех блоков. Чистый выбор секции локально обновляет дерево/инспектор/выделение и прокрутку превью: без POST, изменения source/revision, нового снимка или замены iframe. Клик по секции превью выбирает её без дополнительной прокрутки. HTML `/select` остаётся для форм без JS и совместимости; он валидирует переданный исходник и строит инспектор, без записи файла.
Инспектор применяет поля к текущему source после паузы 650 мс; Save/выбор блока/смена режима сначала применяют ожидающую форму. Такой POST transform проверяет и преобразует переданный source, затем обновляет HTML-проекцию; это не сохранение черновика. До явного Save контент не записывается. «Текущая редакция» — память открытой вкладки, без серверного autosave/recovery; `status: draft` — статус файла, исключающий его из релиза. Ошибка формы сохраняет ввод и блокирует последующую запись до исправления. Переходы режимов сохраняют исходные байты. Структурные правки пересобирают YAML без отдельного подтверждения. Для исходника доступны сравнение/отмена, поиск, скачивание и явное форматирование через существующий metadata transform без записи.
После 003 инспектор отправляет один stateless POST update после паузы 200 мс; запрос объединяет изменения, проверку и preview. Save и смена режима дожидаются очереди. Чистый выбор секции остаётся локальным. Запрос не сохраняет черновик; контракт и очередь описаны в ../003-background-editor/runtime.md. До явного Save контент не записывается. «Текущая редакция» — память открытой вкладки, без серверного autosave/recovery; `status: draft` — статус файла, исключающий его из релиза. Ошибка формы сохраняет ввод и блокирует последующую запись до исправления. Переходы режимов сохраняют исходные байты. Структурные правки пересобирают YAML без отдельного подтверждения. Для исходника доступны сравнение/отмена, поиск, скачивание и явное форматирование через существующий metadata transform без записи.
Нативные `alert`/`confirm`/`prompt` и `beforeunload`-диалоги не вызываются. Удаление/отмена и внутренний переход с несохранёнными правками подтверждаются в окнах интерфейса; Escape отменяет действие, фокус возвращается к инициатору. При перезагрузке или закрытии вкладки системного подтверждения нет; несохранённая редакция теряется.
API `Add` принимает `props`, `BlockAction` — `type: duplicate`. Дублирование копирует поддерево, генерирует новые ID и снимает anchors копий. Ограничения регионов/слотов/циклов/типов остаются серверными. Schema передаёт manifest preview/defaults, choices и названия страниц; клиент не выдумывает значения. HTML-действия проходят прежний серверный API-клиент, credentials остаются на сервере.
Переключатель Live в редакторе пока отключён с объяснением. Рабочее превью остаётся настоящим временным снимком, а успешная проверка структуры не заменяет проверку релиза. Сохранение не выполняет publish. Компонентная и сквозная проверка: `PYTHONPATH=src python scripts/qa_builder_001.py` и `PYTHONPATH=src python scripts/qa_editor_001.py`.
## Content Editor после этапа 4
UI `/admin/content/{collection}/{id}` использует оригинальные Content templates/CSS и общую очередь 003. Состав backend-доработок и точные границы: [content-backend.md](content-backend.md); машиночитаемый контракт — [openapi.json](openapi.json). Начальный preview — настоящая карточка `entry_card`, переключатель Page рендерит display/layout. Live/Page читает immutable release; Live/Card показывает отсутствие такого артефакта. Старый manifest без Entry hashes/routes не выдаёт неизвестное сравнение за отсутствие изменений.
Дополнительная приёмка: `PYTHONPATH=src python -m unittest discover -s tests -p test_content_editor.py -v`, `PYTHONPATH=src python scripts/qa_content_001.py`, `python scripts/sync_content_design.py --check`, `python scripts/verify_package_001.py --site examples/site-studio`. Браузерный сценарий использует временный Site Studio и два режима preview; исходный дизайн открывается отдельно. Отчёт — [verification-content.md](verification-content.md).
## Publication — повторный этап 5
`GET /admin/publish` — оригинальный экран с реальными изменениями, проверками, кандидатом, историей и журналом. Проверить → собрать → preview/diff → опубликовать с комментарием; сборка и отмена подтверждения не переключают Live. При правке входных файлов/renderer/базового Live кандидат устаревает. Публикация требует `{id, expected_live, comment}`, откат — выбранный release и expected_live. Workspace при откате не меняется.
Browser fetch → `/admin/publication/*` → серверный AdminApi → `/admin/api/v1/publication*` → PublicationService. Локальные вкладки/поиск/выбор не делают POST. Несохранённые данные других вкладок не участвуют в сборке; состояние релизов в localStorage не хранится. История/сравнение берутся из настоящих файлов и частного `SITE_STATE_DIR/publication/`, старые релизы без provenance имеют неизвестное сравнение.
Все маршруты/ошибки/ограничения — [publication-backend.md](publication-backend.md), результаты — [verification-publication.md](verification-publication.md). На сервере нужен новый wheel/пересборка образа; `design/` для runtime не требуется. Дополнительных env или миграции БД нет, SITE_STATE_DIR должен оставаться приватным постоянным каталогом.