Document CMS branching and external agent integration
This commit is contained in:
@@ -4,7 +4,9 @@
|
||||
|
||||
- Python 3.12+, пакет `site_engine` в `src/`. Публичный сайт — статический HTML из Markdown/YAML и Jinja2; FastAPI обслуживает админку, публикацию и статику.
|
||||
- Контент — файлы; сборка не зависит от SQLite. Конвейер: `core/registry.py` → `core/validate.py` → `core/render.py` → `build/pipeline.py`.
|
||||
- Ветки и состав коммитов: [docs/BRANCHING.md](docs/BRANCHING.md).
|
||||
- Контекст и архитектура: `README.md`, `docs/TZ-site-engine-decisions.md` (ADR-001…006). Часть ТЗ ещё не реализована; фактические возможности сверяй с кодом и тестами.
|
||||
- Внешний агент/MCP: `docs/extends/mcp-agent-integration.md` — архитектурное предложение и этапы для будущей спеки (общий слой, API keys/scopes, онбоардинг, changeset). Это не реализованный контракт.
|
||||
|
||||
## Куда подключать дизайн
|
||||
|
||||
@@ -19,6 +21,10 @@
|
||||
- Новый перенос — `specs/002-site-studio-theme/{spec,plan,tasks}.md`: этапы 1–5 реализованы, контракт — `runtime.md`, результаты проверок — `verification.md` и `verification-stages-2-3.md`. Отдельный `examples/site-studio/` перенесён на штатный renderer (13 опубликованных страниц); проверка — `scripts/qa_site_studio_002.py`, отчёт — `verification-stage-4.md`. Theme Manager реализован: `/admin/theme`, `/admin/setup/theme`, ThemeService/OnboardingService, snapshot/ETag/CAS и серверный preview overlay. Источники Theme Manager — `design/theme-studio-antirion.html` и `design/assets/theme-studio.css` / `theme-studio.js`; сохраняй исходную композицию и сценарии. Runtime заменяет mock-хранилище API: edits только в памяти вкладки, явный Save, никакого localStorage с палитрой. CSS экрана ограничен theme-content, sample и страница живут в immutable iframe. Workflow — SITE_STATE_DIR/theme-onboarding.json; существующий сайт не перенаправляется. Проверка — scripts/qa_theme_manager_002.py, отчёт — verification-stage-5.md. Первый Save создаёт файл темы и ссылку через ContentService.update_files под одной блокировкой; каждая запись atomic, обычный отказ второго файла откатывает первый, но это не crash-atomic транзакция нескольких файлов. При ошибке после commit API возвращает committed snapshot; не повторяй запись вслепую. Manifest релиза фиксирует документ/effective tokens темы; build fingerprint учитывает ресурсы движка. Исторический каталог релиза не перезаписывается, rollback не меняет workspace.
|
||||
- Фоновый редактор — `specs/003-background-editor/{spec,plan,tasks,runtime,verification}.md`. Рабочая редакция только в памяти вкладки; явный Save через CAS. Один stateless POST update передаёт source один раз и пакет операций; transform/validate/preview используют один Registry. HTML-адаптер вызывает AdminApi, добавляет компактную серверную проекцию. Не блокируй и не заменяй активные поля при обычных правках; очередь сохраняет новый ввод, preview обновляет существующий iframe/Document. При удалении строки списка учитывай более новые отложенные формы, чтобы не повторить удаление. Проверки — tests/test_editor_updates.py и scripts/qa_editor_updates.py (оба режима preview).
|
||||
|
||||
- Content Editor — `/admin/content/{collection}/{id}`, исходник `design/content-antirion.html` / `assets/content-editor.{css,js}`. CSS/SVG воспроизводятся `scripts/sync_content_design.py --check`, адаптеры отдельно. Общая очередь 003, schema-driven поля, настоящие relations/usages/check/duplicate/delete; CAS-записи через ContentService. Live/Page — immutable release; Live/Card не хранится. Контракт/границы — `specs/001-antirion-admin/content-backend.md`, QA — `scripts/qa_content_001.py`, отчёт — `verification-content.md`. Пользователь разрешил переход к этапу 5.
|
||||
|
||||
- Publication — `/admin/publish`, оригинал `design/publication-antirion.html` / `assets/publication.{css,js}`. CSS/SVG: `scripts/sync_publication_design.py --check`; адаптеры отдельно. PublicationService: private `SITE_STATE_DIR/publication`, build без activation, hashes source/renderer/output + expected_live под SiteLock, preview точного релиза, activate без рендера; rollback не меняет workspace. Старые релизы без provenance имеют неизвестное сравнение. Ошибки после commit передают committed_build; не повторять POST вслепую. Контракт/ограничения — `specs/001-antirion-admin/publication-backend.md`, QA — `scripts/qa_publication_001.py`, отчёт — `verification-publication.md`. Этап 5 подготовлен к проверке пользователя. Начальный JSON — hidden textarea, не script: htmx удаляет script при allowScriptTags:false. Вход через меню/повторные переходы/Back-Forward — `scripts/qa_publication_navigation_001.py`.
|
||||
|
||||
## Правила интеграции
|
||||
|
||||
- Админский дизайн переносить из выбранных `design/antirion-rework.html` и связанных editor/publication-макетов: сохранять разметку, CSS, иконки и сценарии, заменяя mock-данные API. Самостоятельное подобие макета недопустимо. Повторный перенос идёт по [этапам](specs/001-antirion-admin/design-transfer.md); после каждого этапа пользователь проверяет результат до перехода к следующему.
|
||||
@@ -43,14 +49,14 @@
|
||||
Из корня репозитория:
|
||||
|
||||
```bash
|
||||
PYTHONPATH=src python -m unittest discover -s tests -v
|
||||
PYTHONPATH=src python scripts/run_regression.py
|
||||
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-dist
|
||||
```
|
||||
|
||||
Дополнительная приёмка 001: `PYTHONPATH=src python scripts/qa_001.py`, `PYTHONPATH=src python scripts/qa_editor_001.py` (нужен Playwright Chromium), `PYTHONPATH=src python scripts/qa_selection_001.py` (выбор секций и диалоги в обоих режимах превью), `python scripts/verify_package_001.py`; сравнение с исходным дизайном — `scripts/qa_shell_001.py`, `scripts/qa_pages_001.py` и `scripts/qa_builder_001.py`; экспорт контракта — `site-engine export-openapi`.
|
||||
|
||||
Собранный сайт — `/tmp/site-studio-dist/current/`. Старые тесты и QA ещё ссылаются на удалённый examples/studio-site; для полной регрессии нужна временная базовая фикстура из истории с миграцией файловой темы (см. specs/003-background-editor/verification.md). Не восстанавливай удалённые примеры в рабочем дереве ради тестов. Целевые проверки 003 используют независимую фикстуру и текущий Site Studio.
|
||||
Собранный сайт — `/tmp/site-studio-dist/current/`. Старые тесты ещё ссылаются на удалённый examples/studio-site; scripts/run_regression.py автоматически извлекает временную базовую фикстуру из истории и мигрирует файловую тему, не меняя checkout. Нужны Git и коммит 231490b (в shallow clone следует получить историю). Обычный unittest discover без runner пока не готовит эту фикстуру. Не восстанавливай удалённые примеры в рабочем дереве ради тестов. Целевые проверки 003 используют независимую фикстуру и текущий Site Studio.
|
||||
|
||||
- Пример сайта используется как фикстура тестов: изменения контента и разметки сверяй с соответствующими проверками. Для изменений поведения обновляй целевые тесты; для чистого CSS проверяй сборку и внешний вид в браузере.
|
||||
- Черновики могут быть неполными; релиз содержит только `published`. Ошибка сборки не должна менять текущий релиз, публикация и откат переключают `current` атомарно.
|
||||
|
||||
Reference in New Issue
Block a user