diff --git a/.gitignore b/.gitignore index 3df0a97..2bbe7b9 100644 --- a/.gitignore +++ b/.gitignore @@ -2,6 +2,7 @@ __pycache__/ *.pyc .env .venv/ +/data/ /dist/ /build/ *.egg-info/ diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..26aaca3 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,53 @@ +# AGENTS.md + +## Проект + +- Python 3.12+, пакет `site_engine` в `src/`. Публичный сайт — статический HTML из Markdown/YAML и Jinja2; FastAPI обслуживает админку, публикацию и статику. +- Контент — файлы; сборка не зависит от SQLite. Конвейер: `core/registry.py` → `core/validate.py` → `core/render.py` → `build/pipeline.py`. +- Контекст и архитектура: `README.md`, `docs/TZ-site-engine-decisions.md` (ADR-001…006). Часть ТЗ ещё не реализована; фактические возможности сверяй с кодом и тестами. + +## Куда подключать дизайн + +- Публичный сайт-пример: `examples/studio-site/`. Каркас — `layouts//{layout.yaml,layout.html.j2}`, композиция страниц — `pages/*.md` (включая подкаталоги), страницы записей коллекций — `display/*.yaml`; схемы коллекций — `collections/`, записи — `content/`. +- `examples/ai-studio/` — расширенный кандидат на замену примера, схема остаётся 1: services/scenarios/cases, общие встроенные фрагменты и локальные `entry_cover`, `benefits`, `related`, `steps`. Списки записей используют `collection_list`, отдельного `catalog` нет. `columns` — контейнер со слотами, `steps` — отдельный компонент «Этапы» из дизайна; прежний `card_grid.variant: steps` поддерживается для совместимости. Локальные ID не должны дублировать встроенные. Контракт и отдельный запуск — его `README.md`; проверка — `PYTHONPATH=src python scripts/qa_ai_studio.py`. Базовую фикстуру и рабочий SITE_ROOT не переключать без задачи на перенос. +- Встроенные компоненты: `src/site_engine/builtin/fragments//` — `fragment.yaml` (поля/слоты), `template.html.j2`, `style.css`, необязательный `script.js`. Общие стили — `builtin/base.css`, токены — `site.yaml:theme.tokens` (например, `color.primary` → `--color-primary`). +- Компоненты конкретного сайта добавляй в его `fragments//`. ID плоские и уникальные: встроенные фрагменты нельзя затенять. Для особого дизайна используй новый ID и обновляй ссылки на него в блоках; изменения встроенных компонентов влияют на все сайты. +- Изображения, шрифты и прочие файлы сайта — `assets/`. Сборщик копирует их в релиз и объединяет CSS/JS использованных фрагментов в общие бандлы с хешами; порядок фрагментов в бандле — по ID, а не по расположению на странице. +- Админка — отдельный интерфейс: `src/site_engine/web/admin/templates/` и `static/`; runtime — `application.py`, серверный клиент — `api_client.py`, формы — `forms.py`, HTTP-адаптер — `routes.py`; `handlers.py` отвечает за вход/статику, `editor.py` сохраняется для совместимости. Работают HTML-формы с локальным htmx; версия, источник и хеш — `static/VENDOR.md`. +- Направление развития — `specs/001-antirion-admin/{spec,plan,tasks}.md`: браузер/htmx → HTML UI → серверный API-клиент → JSON FastAPI → сервисы. API `/admin/api/v1/` реализован в `web/api/` с Pydantic DTO; ядро сохраняет dataclass. Runtime UI не обходит API при ошибке. Контракт/запуск — `specs/001-antirion-admin/runtime.md`, результаты — `verification.md`. + +## Правила интеграции + +- Админский дизайн переносить из выбранных `design/antirion-rework.html` и связанных editor/publication-макетов: сохранять разметку, CSS, иконки и сценарии, заменяя mock-данные API. Самостоятельное подобие макета недопустимо. Повторный перенос идёт по [этапам](specs/001-antirion-admin/design-transfer.md); после каждого этапа пользователь проверяет результат до перехода к следующему. +- Не использовать нативные `alert`/`confirm`/`prompt` и `beforeunload`-диалоги. Подтверждения действий показывать в модальных окнах интерфейса из дизайна. Пересборка YAML не требует отдельного подтверждения. +- Сначала сопоставь секции макета с layouts, фрагментами и полями. Повторяющиеся секции выноси в компоненты, изменяемый контент оставляй в данных. Используй существующий стек; отдельную frontend-сборку вводи только под конкретную необходимость. +- В layout сохраняй `seo_head()`, `assets_head()`, `assets_body()` и вызовы `region(...)`; регионы объявляй в `layout.yaml`. Во фрагментах используй `props` и `slots`, ссылки выводи через `|href`, Markdown — через `|md` / `|md_inline`. +- Новые props и варианты объявляй в `fragment.yaml`: по этой схеме работают валидация и формы редактора. Сохраняй явные ID блоков, привязки `{bind: ...}`, типизированные ссылки `{page: ...}` / `{entry: ...}` / `{url: ...}` и запросы `{query: ...}`. Jinja-выражения в данных запрещены. +- Именования бери из `design/`: `hero_home`, `services_list`, `benefits_grid`, `process_steps`, `cta_home` — ID блоков, а `hero`, `collection_list`, `card_grid`, `cta_banner` — типы Fragment. При добавлении и дублировании генерируй ID как `_<5 случайных символов>`, например `richtext_81ay7`; существующие ID сохраняй. Сохраняй это разделение, не добавляй префиксы тематики сайта к общим компонентам; расширения с отличающимся контрактом получают собственный универсальный ID. +- В каталоге Fragment сохраняй `name`, `description` и категории из дизайна: «Список коллекций», «Текстовая секция», «Markdown body», «Карточки». Под названием показывай назначение из `fragment.yaml:description`, передаваемое через API; ID доступен для поиска и в title. `section` содержит свой текст и поддерживает слоты, `richtext` по умолчанию выводит `page.body`. Изменения builtin/API/шаблонов требуют пересборки Docker-образа; одного bind-mount сайта недостаточно. +- В админских формах сохраняй `action`, `method`, имена полей, `csrf`, `etag` (параметр сервиса — `if_match`) и передачу ошибок. Запись контента проходит через `ContentService`: блокировка, проверка версии, валидация, история, атомарная запись. +- Для нового UI HTML и JSON имеют отдельные маршруты. Серверный клиент вызывает API через `httpx.ASGITransport`; внутренние credentials не попадают в браузер, автор и эпоха проверяются на API-границе. Буфер/превью не сохраняют контент до явного Save. +- Сохраняй autoescape, санитайзер Markdown и CSP. JS для админки подключай внешним локальным файлом. Пассивное превью не исполняет скрипты. Интерактивное использует `web/preview_app.py` на отдельном origin, nonce bridge и защищённые immutable snapshots; JS сайта не запускается. Обычная сборка не получает служебную разметку. +- Приём публичных форм пока возвращает HTTP 501; MCP и changeset — заготовки. Не показывай успешную отправку без работающего обработчика. +- Проверяй мобильную и широкую версии, клавиатурную навигацию, фокус, подписи полей и контраст. Анимации учитывают `prefers-reduced-motion`. +- Правь исходники. `dist/`, `data/`, `.engine/` и `.env` — результат сборки, рабочие данные и секреты; не используй их как место для разработки дизайна. + +## Проверка + +Установка зависимостей: `python -m pip install -e '.[server,dev]'` (extra `mcp` нужен только для работы с MCP). + +Из корня репозитория: + +```bash +PYTHONPATH=src python -m unittest discover -s tests -v +PYTHONPATH=src python -m site_engine.cli validate examples/studio-site +PYTHONPATH=src python -m site_engine.cli build examples/studio-site --out /tmp/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`. + +Это команды `make test`, `make validate-example`, `make build-example` без зависимости от make. Собранный сайт — `/tmp/studio-dist/current/`. + +- Пример сайта используется как фикстура тестов: изменения контента и разметки сверяй с соответствующими проверками. Для изменений поведения обновляй целевые тесты; для чистого CSS проверяй сборку и внешний вид в браузере. +- Черновики могут быть неполными; релиз содержит только `published`. Ошибка сборки не должна менять текущий релиз, публикация и откат переключают `current` атомарно. +- В отчёте перечисляй выполненные проверки и ограничения окружения; успешные тесты обработчиков не заменяют запуск FastAPI и проверку браузером. diff --git a/Dockerfile b/Dockerfile index 461b534..7238ba7 100644 --- a/Dockerfile +++ b/Dockerfile @@ -2,9 +2,27 @@ # Статику в production лучше отдавать nginx из data/dist/current. FROM python:3.12-slim WORKDIR /app -COPY pyproject.toml README.md ./ +COPY pyproject.toml ./ +# Этот слой меняется только вместе с описанием зависимостей. +RUN --mount=type=cache,target=/root/.cache/pip python - <<'PY' +import subprocess +import sys +import tomllib + +with open("pyproject.toml", "rb") as source: + config = tomllib.load(source) +project = config["project"] +requirements = [*config["build-system"]["requires"], "wheel", *project["dependencies"]] +for extra in ("server", "mcp"): + requirements.extend(project["optional-dependencies"][extra]) +subprocess.check_call([sys.executable, "-m", "pip", "install", *requirements]) +PY +COPY README.md ./ COPY src ./src -RUN pip install --no-cache-dir ".[server,mcp]" && mkdir -p /data/site /data/dist /data/state +# Сборка локального пакета не обращается к индексу и не переустанавливает зависимости. +RUN --mount=type=cache,target=/root/.cache/pip \ + pip install --no-deps --no-build-isolation --no-index ".[server,mcp]" \ + && mkdir -p /data/site /data/dist /data/state ENV SITE_ROOT=/data/site SITE_DIST=/data/dist SITE_STATE_DIR=/data/state VOLUME ["/data"] EXPOSE 8000 diff --git a/README.md b/README.md index 5c41c49..e8cfadb 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,8 @@ make test # или: pytest Результат сборки: `OUT//` и симлинк `OUT/current`, который переключается атомарно. Неудачная сборка `current` не трогает. +Расширенный пример для проверки перед возможным переносом сайта — [examples/ai-studio](examples/ai-studio/README.md), также на схеме версии 1: услуги, сценарии, кейсы, обложки, связи и понятные схемы полей. Проверка: `site-engine validate examples/ai-studio`, сборка: `site-engine build examples/ai-studio --out /tmp/ai-studio-dist`, браузерная приёмка: `PYTHONPATH=src python scripts/qa_ai_studio.py`. `studio-site` остаётся базовой фикстурой; отдельный запуск нового примера описан в его README. + ## Структура проекта ``` @@ -145,29 +147,31 @@ SITE_COOKIE_SECURE=0 uvicorn site_engine.web.app:create_app --factory --env-file - **Без потерь.** Форма открывается из файла и отправляется обратно без изменений: у каждого блока примера, всех страниц и записей YAML остаётся тем же по смыслу. Неизвестные ключи не пропадают, привязки сохраняются. - **Конфликты.** Если файл изменили в другом окне, правка получит 409, а чужие изменения не будут перезаписаны. - **Проверка при сохранении.** Нельзя сохранить неизвестный фрагмент, несуществующий layout, блок в закреплённый регион, значение не того типа, `{{ }}` в данных, привязку к чужому корню. Пропуск обязательного поля не блокирует сохранение (ADR-003), но он виден в «Проверке страницы», и сборка релиза с ним не пройдёт; опубликованный сайт при этом не меняется. -- **Безопасность.** Каждый POST требует CSRF-токен и Origin своего хоста; id страниц, блоков и записей проверяются регулярным выражением и поиском в реестре, до пути на диске недоступны; предпросмотр отдаётся в `sandbox`-фрейме с CSP без скриптов; в аудит попадают id и тип действия, но не содержимое. +- **Безопасность.** Каждый POST требует CSRF-токен и Origin своего хоста; id страниц, блоков и записей проверяются регулярным выражением и поиском в реестре, до пути на диске недоступны; пассивное превью использует iframe без scripts, интерактивное — отдельный origin и только nonce bridge; в аудит попадают id и тип действия, но не содержимое. Что работает иначе, чем можно ожидать: -- **Без JS.** Порядок блоков меняется кнопками ↑/↓, элементы списков добавляются через «пустую строку» формы. Скачать htmx и SortableJS в окружении без сети было нельзя, поэтому редактор целиком работает на обычных формах. Если положить `htmx.min.js` в `src/site_engine/web/admin/static/`, админка включит `hx-boost` сама (проверено только разметкой, с настоящим htmx не запускалось). -- **Первая правка файла переформатирует его YAML** в блочный стиль: `{id: b_1, fragment: hero}` станет несколькими строками. Смысл и порядок ключей сохраняются. +- **Обычные формы и локальный htmx.** Порядок блоков меняется кнопками ↑/↓, элементы списков добавляются через «пустую строку» формы. htmx 2.0.11 поставляется в `src/site_engine/web/admin/static/` и включает существующий `hx-boost`; источник, лицензия и SHA-256 — в [VENDOR.md](src/site_engine/web/admin/static/VENDOR.md). Без JS сохраняются обычные формы. CDN и Node-сборка не нужны; SortableJS пока не подключён. Конфигурация запрещает eval, скрипты из ответов и сторонние запросы, отключает сохранение HTML в localStorage и разрешает показ HTML-ошибок 4xx. Новый редактор использует HTML-фрагменты htmx, общий буфер в памяти и явный Save; без JS доступна обычная форма исходника. + +Развитие админки описано в [001 — Antirion Rework](specs/001-antirion-admin/spec.md): htmx/Jinja → HTML UI → серверный API-клиент → типизированный JSON API FastAPI → сервисы. JSON API, общий буфер Конструктора/«Эксперта», ручной Save и интерактивное превью реализованы. Контракт, env и запуск второго процесса: [runtime.md](specs/001-antirion-admin/runtime.md); приёмка: [verification.md](specs/001-antirion-admin/verification.md). +- **Конструктор пересобирает YAML** после предупреждения: комментарии и форматирование могут измениться. «Эксперт» и переходы режимов без правок сохраняют точный исходник. «Применить к буферу» не пишет файл; «Сохранить документ» записывает весь документ с CAS, историей и аудитом. До Save исходник можно скачать. - **Ассеты** выбираются по пути из подсказки, загрузки файлов в редакторе пока нет. -- **Блоки не переносятся между регионами**, только внутри своего списка. +- **Блоки перемещаются** кнопками ↑/↓ или перед указанным ID. Между регионами/слотами действует проверка схемы; циклы и изменение fixed-блоков запрещены. - **Запись коллекции со «лишним» ключом**, которого нет в схеме, нельзя сохранить в статусе `published`, пока ключ не уберут из файла: так требует ADR-003. ## Что реализовано | Этап | Состояние | |---|---| -| M0 Контракт и прототип | Готово: формат файлов, модель блоков, load → validate → render, CLI, 15 фрагментов, сайт-пример | -| M1 Публикуемый движок | Частично: маршруты, ссылки, редиректы, sitemap, атомарная публикация, откат (`services/publish.py`), превью страницы через CLI. Нет: превью по токену, 404-страница из коробки, тема | -| M2 Коллекции, заявки, доступ | Частично: коллекции, display templates, запросы, формы (разметка, версия формы в релизе), **вход одного администратора с аудитом входов и обзорная страница админки**. Нет: роли, приём заявок, outbox, аудит правок | +| M0 Контракт и прототип | Готово: формат файлов, модель блоков, load → validate → render, CLI, 15 встроенных фрагментов, сайт-пример; отдельный steps поставляется с ai-studio | +| M1 Публикуемый движок | Частично: маршруты, ссылки, редиректы, sitemap, атомарная публикация, откат (`services/publish.py`), превью страницы через CLI. Превью по токену реализовано в 001; нет 404-страницы из коробки и системы публичных тем | +| M2 Коллекции, заявки, доступ | Частично: коллекции, display templates, запросы, формы (разметка, версия формы в релизе), **вход одного администратора с аудитом входов и обзорная страница админки**. Аудит Save/create/publish/rollback реализован; нет ролей, приёма заявок и outbox | | M3 MCP и редактор | Готово: редактор страниц, блоков и записей на `ContentService`, предпросмотр, публикация и откат из админки. Нет: `patch_page`, changeset (rename, delete), MCP-сервера, перетаскивания, загрузки файлов | | M4 | Не начат | ## Что проверено, а что нет -Тесты и сборка примера выполнялись в окружении без сети: ядро (`core/`, `build/`, `parsing/`, `storage/`, `services/`) и вся логика админки (`web/admin/handlers.py`, `editor.py`, `forms.py`, шаблоны, вход, CSRF, заголовки) запущены и покрыты 206 тестами, включая сквозные через HTML-формы. Тонкий FastAPI-адаптер `web/admin/routes.py` проверен на подставном модуле `fastapi`, а `web/app.py`, `db/`, `mcp/` и `Dockerfile` только компиляцией и чтением: FastAPI, SQLAlchemy и MCP SDK в окружении не было. Ядро намеренно не зависит от pydantic: ошибки должны нести путь к полю (`pages/index.md:regions.main[b_hero].props.title`), а валидация задаётся манифестами фрагментов. Pydantic нужен на границах API (web, mcp). +Приёмка 001 включает полную регрессию ядра/CLI/админки, настоящий FastAPI, JSON-контракт и ASGI-клиент, Chromium на двух origin, адаптивные экраны и установленный wheel без `design/`. Воспроизводимые команды, результаты и ограничения: [verification.md](specs/001-antirion-admin/verification.md). Docker/proxy deployment, БД и MCP-сервер не запускались. Ядро сохраняет dataclass; Pydantic используется на границе API. ## Соответствие журналу решений @@ -178,7 +182,7 @@ SITE_COOKIE_SECURE=0 uvicorn site_engine.web.app:create_app --factory --env-file | ADR-003: draft / release / live, версия формы в релизе | `validate_workspace` vs `validate_release`, `_forms/@<версия>.json`, `switch_current` | | ADR-004: `if_match`, блокировка сайта, история | `services/content.py`, `storage/locks.py`, `storage/history.py` | | ADR-005: границы доверия | `SandboxedEnvironment`, Markdown без raw HTML, `safe_join`, токены темы, YAML без алиасов | -| ADR-006: 15 фрагментов, `editorial`, `requires` только `feature.*` | `builtin/fragments/`, `models.Page.editorial`, `render._feature_on` | +| ADR-006: 15 встроенных фрагментов, локальный steps в ai-studio, `editorial`, `requires` только `feature.*` | `builtin/fragments/`, `examples/ai-studio/fragments/steps/`, `models.Page.editorial`, `render._feature_on` | ## Как расширять diff --git a/design/CHANGELOG.md b/design/CHANGELOG.md new file mode 100644 index 0000000..bf5cbf7 --- /dev/null +++ b/design/CHANGELOG.md @@ -0,0 +1,141 @@ +# Site Engine — Журнал изменений + +## 2026-11-12 — Этап 6: завершение HTML-админки (04/06) + +- Введены `modules-antirion.html` и `modules-rose-graphite.html`: единый shell + пять интерактивных разделов, согласованные темы Antirion Rework и Rose Graphite. +- **6.1 Медиа:** сетка/таблица, папки, локальная mock-загрузка, инспектор ассета, alt/caption, проверка missing, подтверждаемое удаление и «Где используется?». +- **6.2 Структура:** редактор меню, фиксированные Layout Regions и allow-фрагменты, каталог Fragment/Display, схематичный YAML и ограничения для разработчика. +- **6.3 Формы:** поля optional/required, mock-preview, список заявок, скрытие личных данных по ролям, статусы доставки, выгрузка синтетического CSV, предупреждения о версиях схемы при откате. +- **6.4 Настройки:** site.yaml, цвета сайта, общие данные, редиректы с проверкой циклов, роли, MCP-scopes без реальных токенов, параметры сборки. +- **6.5 Журнал:** события операций, чтение mock-аудита Stage 5, фильтры и экспорт, ролевой доступ, `Ctrl+K` и адаптивность. +- Переходы в новые разделы встроены в shell 04/06, редактор Page/Entry и публикационный экран; старые редакторы и все четыре зафиксированные концепции сохранены. +- Исправлена ширина сетки чекбоксов в компактном инспекторе форм; мобильная навигация проверяется после завершения CSS-анимации. +- Тесты на десяти экранах (5 разделов × 2 темы), на 1440×900 и 390×844, и шести ширинах для основного сценария: без ошибок JS и без общего горизонтального переполнения. +- **Ограничения:** клиентские роли не реализуют безопасность; данные Stage 6 и Stage 5 сохраняются в отдельных mock-store; реальная файловая и серверная интеграция не выполнена. + +--- + +## 2026-11-11 — Этап 4: Контент и коллекции + +- **Два новых интерактивных редактора** `content-antirion.html` и `content-rose-graphite.html` на базе утверждённых 04/06, без изменения shell и конструктора страниц. +- Каталог 5 коллекций, поиск/фильтры записей, create/edit/duplicate/delete (с подтверждением), пустые/выключенные коллекции и тестовый большой список. +- Схемный Конструктор полей Entry (`text`, `textarea`, `number`, `boolean`, `select`, `date`, `asset`, `refs`, `list`, `group`, `markdown`) с обязательными полями и ошибками. +- Связи Entry → Entry, выбор из UI, «Где используется?» и переходы в связанные записи; проверки ссылок и битого медиа. +- Два вида превью через mock Display template (карточка/полная страница); Workspace и Live снимок `build_00027` чётко разведены. +- Режим Эксперт YAML front matter + Markdown с общим state, подсветкой, номерами строк, diff, защитой от неверной структуры, резервной копией и mock 409. +- Сохранение локального workspace без публикации, подтверждение ухода с несохранёнными изменениями; `localStorage` при доступности. +- Раздел «Контент» в админках 04/06 связан с редактором; сохранённые записи читаются в обзоре коллекций, если доступен общий localStorage. +- Не менялись другие два утверждённых оформления (03, 05), страницы Конструктора 2–3 и правило скруглений в Rose Graphite. +- Восстановлены и проверены 6 ширин: 1440×900, 1280×800, 1024×768, 768×1024, 390×844, 360×740. Исправлен scroll/layout редактора на широком экране. +- Прототип без серверной интеграции. Дальше — Этап 5 «Публикация / История / Откат». + + +## 2026-11-11 — Исправление переключателя режима редактора (Этап 3) + +- Восстановлено явное состояние `mode: constructor` при первом открытии редактора страницы. +- Верхний переключатель теперь сразу выделяет «Конструктор», а при переходе в «Эксперт» и обратно показывает правильный выбранный режим. +- Добавлены `aria-pressed` для корректной доступности переключателя. +- Проверено в Chromium для 04 Antirion Rework и 06 Rose Graphite. Остальные варианты не изменены. + +# Site Engine Admin — история изменений + +## Этап 3 — Expert: YAML / Markdown, round-trip и конфликты (2026-11-11) + +- Новые UI «Эксперт» в `builder-antirion.html` и `builder-rose-graphite.html`: файловое дерево, редактор исходника с номерами строк, подсветкой, поиском, форматированием, Markdown и мини-превью. +- Подключён общий Page model: `Constructor → YAML/Markdown → Constructor`. `Page`, `regions.main`, `Block`, `props`, `bindings` и SEO не существуют в виде отдельной независимой модели в Expert. +- Офлайн-парсер YAML **ограниченного явно описанного подмножества**: mappings, lists, quoted strings, bool/number/null и multiline `|-`; неизвестные поля/Fragment ID, неподдерживаемый синтаксис, нарушения схемы, дубликаты ID блокируют применение. Эксперт не обходит публикационную валидацию. +- При ошибочном YAML raw-буфер остаётся доступен, превью и состояние Page не перезаписываются. Переключение в Конструктор или другой файл предлагает исправить/скопировать или сознательно отбросить исходник. +- Комментарии в YAML: предупреждение перед переходом в Конструктор и перед форматированием. Резервная копия исходника сохраняется, перед последующей пересериализацией требуется подтверждение; комментарии не теряются молча. +- Построчный source diff Workspace ↔ Saved Draft / Live, `line/path` ошибок, адаптивный режим и совместимость с предыдущими функциями 2.1–2.4. +- Mock optimistic concurrency: `if_match` как локальная ревизия; демонстрация `409 Conflict` с сравнением my/server, явное подтверждение перезаписи или принятие mock-server версии. Никакой реальной серверной записи и прав доступа нет. +- Проверены обе темы в Chromium на разрешениях 1440×900, 1280×800, 1024×768, 768×1024, 390×844 и 360×740; добавлены QA для round-trip, multiline YAML, конфликтов и защиты raw-источника. +- Согласованные 03 Antirion, 04 Antirion Rework, 05 Ember Graphite, 06 Rose Graphite сохранены; активные редакторы только 04/06. Нет вариантов 01/02 и Violet Night. + +--- + +# История изменений Site Engine Admin + +## Этап 2.4 — Draft / Validation / Diff (2026-11-11) + +- Новый статус workspace и последнего сохранения; live `build_00027` по-прежнему неизменяем в mock. +- Интерактивная публикационная mock-проверка с типами проблем, фильтрами и переходом прямо к проблемному полю. +- SEO title / description, счётчики длины, SERP-превью, упрощённый Markdown-просмотр и быстрый richtext. +- Сравнение с Saved draft и Live: структурные отличия + схематичное визуальное сопоставление. +- Подтверждаемое восстановление workspace, сохранение локального черновика с отметкой времени, обработка недоступного localStorage. +- Предыдущие операции конструктора и маппинга сохранены; стили 03–06 не менялись. +- QA: оба конструктора и шесть разрешений; пройдены проверки интерактивности/адаптивности. + +--- + +# CHANGELOG · Site Engine Admin + +## 2026-11-10 — Этап 2.3: source mapping / обратные зависимости + +- Общая модель Page/Block дополнена структурированным mock-каталогом `Collection`, `Entry`, `Asset`, `Data` и публичных маршрутов. +- В разделе «Связи данных» реализован маппинг каждого поля: блок, Fragment, тип источника, путь, состояние и отображаемое значение. +- В Inspector → «Связи» добавлена диагностика по полям и выбор источника без YAML. Поддерживаются literal, bind, collection query, ref, asset и page/entry link. +- Добавлен Fragment `entry_card` с конкретным Entry, query сортировка (`order`/`title`) и limit, каталог данных. +- Реализован «Где используется?» по всем демо-страницам, включая зависимость записи через collection_list, переход к использующему блоку. +- Ошибки: отсутствующие коллекции, ссылки и записи, неразрешённые bindings. Предупреждения: неопубликованные ссылки/entries, отсутствующие assets, пустая коллекция. +- Сохранены исходные сценарии этапа 2.1–2.2, в том числе iframe без перезагрузки, клики в дереве с прокруткой и клики в превью без скачка. +- Оба активных оформления 04 и 06 используют общий JS и собственные согласованные палитры. Варианты 03/05 остались без изменений. +- QA: 12 комбинаций двух тем и шести ширин (1440, 1280, 1024, 768, 390, 360), разметка без горизонтального переполнения, ошибок JS нет; отдельные сценарии binding, ref, where-used, asset и validate. + + +## 2026-11-10 — Навигация по блокам из дерева (Этап 2.2) + +- Клик по блоку в левом дереве или в разделе «Связи данных» теперь выделяет и прокручивает iframe-превью к выбранному блоку. Если блок уже полностью виден — прокрутки нет. +- При выборе фиксированного `site_header` выполняется переход к началу страницы, `site_footer` — к подвалу. +- При клике непосредственно по блоку в iframe выделение синхронизируется с деревом и инспектором **без прокрутки**; редактирование полей также не сбрасывает позицию. +- Добавление, дублирование, перестановка кнопками или drag & drop прокручивают к новой позиции блока после обновления превью. +- Поддержка системной настройки `prefers-reduced-motion`: анимация отключена для пользователей, ограничивающих движение. +- Выбор блока больше не сбрасывает прокрутку левого дерева. Обе темы используют единый JS. +- Регрессионные проверки в Chromium через Playwright на 1440×900, 1024×768, 390×844 и 360×740, а также тесты редактирования без скачков прокрутки. + +## 2026-11-10 — Исправление прокрутки при выборе блоков + +- Выбор блока внутри iframe и в дереве больше не пересоздаёт iframe и не сбрасывает прокрутку к началу. +- Подсветка выбранного блока синхронизируется между деревом, инспектором и превью через `postMessage`. +- При редактировании полей содержимое preview обновляется на месте; положение прокрутки сохраняется. +- Проверено для `builder-antirion.html` и `builder-rose-graphite.html` в Chromium: клики внутри preview, выбор из дерева, редактирование заголовка. Ошибок JavaScript нет. + +## 2026-11-10 — Этап 2: конструктор страниц (04 + 06) + +- Сохранены четыре согласованных базовых дизайна: **03 Antirion**, **04 Antirion Rework**, **05 Ember Graphite**, **06 Rose Graphite**. +- Название **06 YuE Studio → 06 Rose Graphite**. Переименованы основные HTML/CSS/JS, в галерее обновлены ссылки и описания. Палитра и частная правка коллекций сохранены. +- Добавлены `builder-antirion.html` и `builder-rose-graphite.html`. Редактор построен на общем JS/data-state и двух визуальных темах. +- Реализованы mock Page selection, layout/region tree, блоки с устойчивыми ID, schema-driven inspector, iframe preview + Desktop/Tablet/Mobile, режим отображения workspace/live. +- Реализованы каталог Fragment, добавление, перемещение (кнопки и drag-and-drop), дублирование, удаление с подтверждением, видимость, Anchor и Note. +- Добавлен переключатель `Дерево блоков / Связи данных`, простые literal/bind/query и визуальные маршруты источников; редактирование Markdown body и SEO на вкладке «Страница». +- Добавлены индикатор несохранённости, локальное сохранение в localStorage, проверка ошибок/предупреждений, локальный diff, кнопка «Эксперт» с объяснением границ следующего этапа. +- В вариантах 04 и 06 кнопка «Редактор» теперь открывает Конструктор с выбранной страницей. +- Проведён Playwright QA на шести размерах экранов для обеих тем. Бэкенд, реальные файлы, права доступа и публикации остаются вне этого этапа. + +## 2026-11-10 — Зафиксированный дизайн Этапа 1 + +- 03 Antirion — компактный графитово-бирюзовый. +- 04 Antirion Rework — строгий светлый/тёмный интерфейс. +- 05 Ember Graphite — медно-оранжевые градиенты. +- 06 Rose Graphite (ранее YuE Studio) — почти чёрный с розовыми акцентами, выбор коллекций без скруглений, остальные таблицы и панели со скруглениями. +- Исключены старые зелёные 01/02 и отвергнутый Violet Night. + +## 2026-11-12 — Этап 5: Публикация, история релизов, откат + +- Новые рабочие HTML-прототипы `publication-antirion.html` и `publication-rose-graphite.html` с общими CSS/JS и двумя темами; утверждённые дизайны 03 и 05 сохранены без изменений. +- Добавлен путь `workspace → validate → candidate → publish → live`, с разделением сохранённых черновиков, кандидата и публичного снимка. +- Показаны изменения файлов Page / Entry / Menu / Asset, фильтры, diff данных и схематичное visual diff; сохранённые данные старых редакторов подгружаются в демо-workspace. +- Строгая демо-проверка: ошибки блокируют кандидата, предупреждения не блокируют; можно исправить демо-привязку формы; отдельное предупреждение о совместимости версий формы при откате. +- Кандидат фиксирует копию всех файлов; кандидат со старым fingerprint или старым live не публикуется. Отдельный сценарий failed build не изменяет live. +- История неизменяемых снимков, детали релизов, журнал build/publish/rollback, подтверждаемый откат live без изменения workspace. История отдельного документа выделена в самостоятельный UX. +- Демо-роли owner/developer/editor/reviewer; publish, rollback и build ограничены в UI. Real RBAC остаётся серверной задачей. +- Переходы в публикационный workflow подключены в разделы 04/06, а также в редакторы Page и Entry; исправлены deep links из галереи. +- Проверены мобильные и десктопные разрешения, smoke-тесты в двух темах. Это только HTML/CSS/JS без backend. + +## 2026-11-12 — Этап 7: технический handoff FastAPI/Jinja2/htmx + +- Добавлен `docs/stage7/`: архитектура модульного монолита, карта Jinja partials/htmx, file-first DTO + сервисные контракты, CAS/409, RBAC/CSRF, preview isolation, immutable candidate/publish/rollback, форма/outbox, vertical slices V0–V7. +- Добавлен `docs/stage7/adr/ADR_REGISTER.md`: 6 предложенных (не утверждённых) ADR для ключевых системных решений. +- Добавлены примеры YAML/Markdown/JSON и готовое задание `IMPLEMENTATION_HANDOFF_PROMPT.md`. +- Приложены исходные ТЗ и архитектурное ревью в неизменённом виде; источник и рекомендация разграничены. +- Сохранены 4 утверждённых HTML-концепта и функциональные экраны Этапов 2–6 без изменений их JS/CSS. +- **Backend не реализован:** этап является проектированием интеграции. diff --git a/design/README.md b/design/README.md new file mode 100644 index 0000000..bcdad21 --- /dev/null +++ b/design/README.md @@ -0,0 +1,34 @@ +# Site Engine — полный HTML-проект + Этап 7: backend handoff + +**Статус:** Этапы 1–6 — интерактивный дизайн-прототип; Этап 7 — техническое проектирование переноса, **без реализации backend**. + +## Быстрое открытие + +- `index.html` — галерея четырёх утверждённых визуальных вариантов 03–06. +- `builder-antirion.html` / `builder-rose-graphite.html` — Конструктор и Эксперт. +- `content-antirion.html` / `content-rose-graphite.html` — коллекции и записи. +- `publication-antirion.html` / `publication-rose-graphite.html` — публикация, история, rollback (mock). +- `modules-antirion.html` / `modules-rose-graphite.html` — Медиа, Структура, Формы и заявки, Настройки, Журнал. + +## Этап 7 — документы + +**Начать с [`docs/stage7/README.md`](docs/stage7/README.md).** + +Далее: архитектура, Jinja/htmx map, file-first contracts и DTO, security/release, план срезов V0–V7, аудит прототипа, 6 предложенных ADR и готовый prompt для кодового агента. + +## Источники + +- Исходный `TZ-site-engine.md` и независимое `TZ-site-engine-architecture-review.md` приложены в `docs/stage7/reference_*.md` как неизменённые источники для согласования. +- Старый README Этапа 6 доступен в `docs/README_STAGE6.md`. + +## Важно + +**Новых API, БД, логина, реальной публикации или серверного сохранения в этом пакете нет.** HTML/CSS/JS старого проекта сохранены как UX-baseline. Нельзя переносить независимые `localStorage` seed-модели в production как систему хранения. + +Целевой стек: Python 3.12+, FastAPI, Jinja2, htmx, Pydantic v2, SQLAlchemy 2, SQLite WAL, Alembic. Основные активные оформления: 04 Antirion Rework и 06 Rose Graphite. В дизайне 06 без скруглений только выбор коллекции в разделе «Контент»; остальные таблицы остались с исходным оформлением. + +## Как использовать с кодовым агентом + +Передайте агенту весь ZIP, попросите прочитать `docs/stage7/IMPLEMENTATION_HANDOFF_PROMPT.md`. Согласуйте ADR-001/002/003/004/005/006, затем V0 и V1; не пытайтесь реализовать все модули одновременно. + +Для общего localStorage текущего mock между вкладками можно открыть прототип через `python -m http.server 8000`, но это не сервер CMS. diff --git a/design/antirion-rework.html b/design/antirion-rework.html new file mode 100644 index 0000000..ea98a68 --- /dev/null +++ b/design/antirion-rework.html @@ -0,0 +1 @@ +Site Engine — 04 Antirion Rework
diff --git a/design/antirion.html b/design/antirion.html new file mode 100644 index 0000000..59fe9cf --- /dev/null +++ b/design/antirion.html @@ -0,0 +1 @@ +Site Engine — Antirion / Admin concept 03
diff --git a/design/assets/admin.css b/design/assets/admin.css new file mode 100644 index 0000000..48eb5d1 --- /dev/null +++ b/design/assets/admin.css @@ -0,0 +1,45 @@ +/* Site Engine · Stage 1 interactive design concepts · no external dependencies */ +:root{font-family:Inter,-apple-system,BlinkMacSystemFont,"Segoe UI",Arial,sans-serif;font-synthesis:none;text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased} +*{box-sizing:border-box}html,body{margin:0;min-height:100%;width:100%}body{overflow-x:hidden}button,input,select,textarea{font:inherit}button{cursor:pointer}a{color:inherit;text-decoration:none}button:disabled{cursor:not-allowed;opacity:.5}button:focus-visible,a:focus-visible,input:focus-visible,select:focus-visible,[tabindex]:focus-visible{outline:2px solid var(--accent);outline-offset:2px}svg{display:block;flex-shrink:0}.ico{width:17px;height:17px;stroke:currentColor;stroke-width:1.7;fill:none;stroke-linecap:round;stroke-linejoin:round}.ico.sm{width:14px;height:14px}.ico.lg{width:20px;height:20px} +body[data-theme="dark"]{color-scheme:dark;--bg:#111311;--sidebar:#151715;--panel:#191c19;--panel2:#20231f;--raised:#232823;--hover:#282d28;--line:#30352f;--line-soft:#252a25;--text:#e8ece4;--text-2:#afb7aa;--muted:#798378;--accent:#b9dd88;--accent-ink:#1c2713;--accent-bg:#273525;--tag:#292d29;--good:#acd993;--warn:#e5b971;--bad:#ee8d86;--blue:#a1c5dc;--shadow:rgba(0,0,0,.31);--selected:#252f23;--input:#1a1e1a;--header:#171a17;--site-surface:#f4f1e9;--site-ink:#20251f} +body[data-theme="light"]{color-scheme:light;--bg:#f6f7f4;--sidebar:#fbfcf9;--panel:#fff;--panel2:#f7f9f5;--raised:#eef3eb;--hover:#eff2ec;--line:#e1e6de;--line-soft:#e9ede7;--text:#233027;--text-2:#657268;--muted:#879187;--accent:#236c52;--accent-ink:#fff;--accent-bg:#e7f3e9;--tag:#f0f3ed;--good:#247e56;--warn:#ac772a;--bad:#c7524c;--blue:#467f9b;--shadow:rgba(19,42,29,.09);--selected:#e9f3e9;--input:#fff;--header:#fff;--site-surface:#f4f1e9;--site-ink:#20251f} +body{background:var(--bg);color:var(--text);font-size:13px;line-height:1.45} +.app{height:100dvh;min-height:480px;display:grid;grid-template-columns:228px minmax(0,1fr);background:var(--bg);transition:grid-template-columns .18s ease;overflow:hidden} +.app.collapsed{grid-template-columns:61px minmax(0,1fr)} +.sidebar{background:var(--sidebar);border-right:1px solid var(--line);min-height:0;display:flex;flex-direction:column;z-index:40;overflow:hidden} +.brand-area{height:73px;padding:17px 16px 15px;display:flex;align-items:center;gap:10px;flex:none;border-bottom:1px solid var(--line-soft)} +.brand-mark{width:31px;height:31px;display:grid;place-items:center;background:var(--accent);color:var(--accent-ink);font-weight:900;font-family:ui-monospace,SFMono-Regular,Consolas,monospace;letter-spacing:-.1em;font-size:16px;border-radius:4px;flex:none} +.brand-copy{min-width:0}.brand-name{font-weight:750;font-size:14px;letter-spacing:-.035em;white-space:nowrap}.brand-sub{font-size:10px;color:var(--muted);letter-spacing:.09em;font-weight:650;margin-top:1px;text-transform:uppercase}.sidebar-inner{flex:1;overflow:auto;overflow-x:hidden;padding:14px 10px 18px;scrollbar-width:thin}.nav-heading{font-size:10px;letter-spacing:.11em;color:var(--muted);font-weight:750;padding:12px 12px 8px;text-transform:uppercase;white-space:nowrap}.nav-group+.nav-group{margin-top:18px}.nav-button{width:100%;border:0;background:transparent;color:var(--text-2);display:flex;align-items:center;gap:11px;min-height:36px;border-radius:4px;text-align:left;padding:8px 10px;margin:1px 0;white-space:nowrap;position:relative}.nav-button:hover{background:var(--hover);color:var(--text)}.nav-button.active{background:var(--selected);color:var(--text);font-weight:650}.nav-button.active:before{content:"";height:19px;width:2px;background:var(--accent);position:absolute;left:-10px;top:8px;border-radius:2px}.nav-button .ico{color:var(--muted)}.nav-button.active .ico{color:var(--accent)}.nav-label{flex:1;overflow:hidden;text-overflow:ellipsis}.nav-count{font-size:10px;padding:1px 6px;color:var(--muted);background:var(--tag);border:1px solid var(--line-soft);border-radius:3px;font-variant-numeric:tabular-nums}.nav-divider{height:1px;background:var(--line-soft);margin:14px 9px}.sidebar-bottom{border-top:1px solid var(--line-soft);padding:12px 10px 13px;display:grid;gap:6px}.site-chip{padding:10px;border:1px solid var(--line);background:var(--panel);display:flex;align-items:center;gap:9px;border-radius:4px}.site-chip .site-avatar{width:25px;height:25px;background:var(--accent-bg);color:var(--accent);display:grid;place-items:center;border-radius:3px}.site-chip-copy{min-width:0}.site-chip strong{display:block;font-size:11px;font-weight:700;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.site-chip small{color:var(--muted);font:11px ui-monospace,monospace}.side-bottom-actions{display:flex;gap:4px}.side-bottom-actions .icon-button{flex:1} +.app.collapsed .brand-area{padding:17px 14px}.app.collapsed .brand-copy,.app.collapsed .nav-heading,.app.collapsed .nav-label,.app.collapsed .nav-count,.app.collapsed .site-chip-copy,.app.collapsed .sidebar-note{display:none}.app.collapsed .nav-button{justify-content:center;padding:9px}.app.collapsed .nav-button.active:before{left:-10px}.app.collapsed .site-chip{padding:8px;justify-content:center}.app.collapsed .nav-group+.nav-group{margin-top:10px}.app.collapsed .sidebar-inner{padding:14px 10px}.app.collapsed .side-bottom-actions{flex-direction:column} +.main-shell{min-width:0;min-height:0;display:flex;flex-direction:column;background:var(--bg)}.topbar{height:55px;flex:none;background:var(--header);border-bottom:1px solid var(--line);display:flex;align-items:center;gap:15px;padding:0 22px;position:relative;z-index:10}.top-left{display:flex;align-items:center;gap:12px;min-width:0;flex:1}.top-breadcrumb{display:flex;align-items:center;gap:9px;min-width:0;color:var(--muted);font-size:12px;white-space:nowrap}.top-breadcrumb strong{color:var(--text);font-weight:650;overflow:hidden;text-overflow:ellipsis}.top-breadcrumb .slash{color:var(--muted);opacity:.55}.top-right{display:flex;align-items:center;gap:9px}.cmd-search{width:224px;height:31px;border:1px solid var(--line);background:var(--bg);display:flex;align-items:center;gap:8px;padding:0 10px;color:var(--muted);border-radius:4px;text-align:left;font-size:12px}.cmd-search .key{border:1px solid var(--line);border-radius:3px;padding:1px 4px;font-size:10px;margin-left:auto;color:var(--muted);font-family:ui-monospace,monospace}.cmd-search:hover{border-color:var(--accent)}.icon-button{height:31px;min-width:31px;padding:0 8px;display:inline-flex;align-items:center;justify-content:center;gap:6px;border:1px solid transparent;background:transparent;color:var(--text-2);border-radius:4px}.icon-button:hover{background:var(--hover);color:var(--text)}.icon-button.bordered{border-color:var(--line)}.icon-button .ico{width:16px;height:16px}.avatar-button{height:30px;width:30px;border-radius:50%;background:var(--accent-bg);color:var(--accent);border:1px solid var(--line);font-weight:750;font-size:11px}.sep{width:1px;height:22px;background:var(--line);margin:0 2px}.tiny-live{display:inline-flex;align-items:center;gap:6px;color:var(--text-2);white-space:nowrap;font-size:11px}.tiny-live:before{content:"";width:6px;height:6px;background:var(--good);border-radius:50%}.workspace{min-height:0;min-width:0;flex:1;overflow:auto;scrollbar-width:thin;scrollbar-color:var(--line) transparent}.page-wrap{max-width:1660px;margin:0 auto;padding:30px 32px 42px;min-width:0}.section-head{display:flex;align-items:flex-start;justify-content:space-between;gap:18px;margin-bottom:26px}.eyebrow{font-size:10px;font-weight:800;letter-spacing:.115em;color:var(--accent);text-transform:uppercase;margin-bottom:8px}.page-title{font-weight:700;font-size:25px;letter-spacing:-.055em;margin:0;line-height:1.16}.page-subtitle{margin:9px 0 0;color:var(--text-2);font-size:12px}.head-actions{display:flex;gap:8px;align-items:center;flex-wrap:wrap;justify-content:flex-end}.btn{min-height:32px;border:1px solid var(--line);background:var(--panel);color:var(--text);border-radius:4px;padding:7px 12px;display:inline-flex;align-items:center;justify-content:center;gap:7px;font-weight:600;font-size:11.5px;white-space:nowrap}.btn:hover{background:var(--hover);border-color:var(--text-2)}.btn-primary{background:var(--accent);border-color:var(--accent);color:var(--accent-ink)}.btn-primary:hover{filter:brightness(1.05);background:var(--accent);border-color:var(--accent)}.btn-subtle{background:transparent}.btn-danger{color:var(--bad);border-color:var(--bad)}.btn-sm{min-height:27px;font-size:11px;padding:4px 9px}.btn .ico{width:14px;height:14px}.meta{color:var(--muted);font-size:11px}.mono{font-family:ui-monospace,SFMono-Regular,Consolas,"Liberation Mono",monospace;font-size:.96em;letter-spacing:-.015em}.small-caps{text-transform:uppercase;letter-spacing:.09em;font-size:10px;font-weight:750}.divider{height:1px;background:var(--line-soft)}.tag{font-size:10px;display:inline-flex;align-items:center;gap:6px;padding:3px 7px;border:1px solid var(--line);background:var(--tag);border-radius:3px;color:var(--text-2);white-space:nowrap}.tag .dot{height:6px;width:6px;border-radius:50%;background:currentColor}.tag.green{background:var(--accent-bg);border-color:transparent;color:var(--good)}.tag.warn{color:var(--warn)}.tag.bad{color:var(--bad)}.tag.muted{color:var(--muted)}.tag.blue{color:var(--blue)}.status-dot{display:inline-block;width:7px;height:7px;border-radius:50%;background:var(--good);flex:none}.status-dot.warn{background:var(--warn)}.status-dot.bad{background:var(--bad)}.status-dot.muted{background:var(--muted)} +.panel{background:var(--panel);border:1px solid var(--line);border-radius:5px;min-width:0}.panel-head{padding:16px 18px;display:flex;justify-content:space-between;align-items:center;gap:12px;border-bottom:1px solid var(--line-soft)}.panel-title{font-size:12px;font-weight:750;letter-spacing:-.012em}.panel-sub{font-size:11px;color:var(--muted);margin-top:2px}.panel-body{padding:17px 18px}.strip{background:var(--panel);border:1px solid var(--line);border-radius:5px;display:flex;align-items:center;gap:16px;padding:17px 20px;margin-bottom:18px;position:relative;overflow:hidden}.strip:before{position:absolute;content:"";left:0;top:0;bottom:0;width:3px;background:var(--accent)}.strip-symbol{height:37px;width:37px;display:grid;place-items:center;background:var(--accent-bg);border:1px solid var(--line-soft);border-radius:4px;color:var(--accent)}.strip h2{margin:0;font-size:14px;font-weight:750;letter-spacing:-.02em}.strip p{font-size:11px;margin:4px 0 0;color:var(--text-2)}.strip-details{display:flex;gap:28px;align-items:center;margin-left:auto}.strip-details .value{font-weight:750;font-size:12px;margin-bottom:3px}.strip-details .caption{font-size:10px;color:var(--muted)}.strip-action{margin-left:8px} +.metric-row{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));gap:12px;margin-bottom:22px}.metric{min-height:105px;background:var(--panel);border:1px solid var(--line);padding:18px 18px 15px;border-radius:4px;position:relative}.metric-label{display:flex;justify-content:space-between;align-items:center;gap:4px;color:var(--text-2);font-size:11px}.metric-label .ico{color:var(--muted)}.metric-value{font-size:27px;letter-spacing:-.07em;font-weight:700;margin-top:9px;line-height:1.15}.metric-foot{color:var(--muted);font-size:10px;margin-top:5px}.metric-foot strong{color:var(--text-2);font-weight:650}.layout-2{display:grid;grid-template-columns:minmax(0,1.6fr) minmax(290px,.9fr);gap:17px}.stack{display:flex;flex-direction:column;gap:16px;min-width:0}.list-row{display:flex;align-items:center;gap:11px;padding:12px 18px;border-bottom:1px solid var(--line-soft);min-width:0}.list-row:last-child{border-bottom:0}.list-row:hover{background:var(--hover)}.list-row .row-symbol{width:30px;height:30px;background:var(--panel2);border:1px solid var(--line-soft);display:grid;place-items:center;color:var(--text-2);border-radius:4px;flex:none}.list-row-main{min-width:0;flex:1}.list-row-main strong{font-size:11.5px;font-weight:650;display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.list-row-main small{font-size:10.5px;color:var(--muted);display:block;margin-top:3px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.list-row-meta{text-align:right;white-space:nowrap;flex:none;font-size:10.5px;color:var(--text-2)}.list-row-meta small{font-size:10px;color:var(--muted);display:block;margin-top:4px}.text-link{border:0;background:none;color:var(--accent);font-size:11px;font-weight:700;padding:0;cursor:pointer}.text-link:hover{text-decoration:underline}.empty-panel{padding:34px 20px;text-align:center;color:var(--text-2)}.empty-panel .ico{margin:0 auto 10px;color:var(--muted)}.empty-panel strong{display:block;font-size:13px;color:var(--text);margin-bottom:5px}.empty-panel p{margin:0;font-size:11px;color:var(--muted)}.event{display:flex;align-items:flex-start;gap:10px;padding:11px 0;position:relative}.event+.event{border-top:1px solid var(--line-soft)}.event-mark{width:24px;height:24px;flex:none;display:grid;place-items:center;background:var(--tag);border:1px solid var(--line);border-radius:4px;color:var(--text-2)}.event strong{font-size:11px;font-weight:650;display:block}.event p{font-size:10.5px;color:var(--muted);margin:3px 0 0}.event time{margin-left:auto;white-space:nowrap;color:var(--muted);font-size:10px}.note{padding:12px 13px;background:var(--panel2);border:1px solid var(--line-soft);font-size:11px;color:var(--text-2);line-height:1.55;border-radius:4px}.note .ico{color:var(--warn);display:inline-block;vertical-align:middle;margin-right:6px}.note strong{color:var(--text);font-weight:650} +.toolbar{display:flex;align-items:center;gap:9px;margin-bottom:13px;flex-wrap:wrap}.search-field{display:flex;align-items:center;gap:7px;padding:0 10px;background:var(--input);border:1px solid var(--line);height:34px;min-width:180px;flex:1;border-radius:4px;color:var(--muted)}.search-field:focus-within{border-color:var(--accent)}.search-field input{width:100%;border:0;outline:none;background:transparent;color:var(--text);font-size:12px;min-width:0}.search-field input::placeholder{color:var(--muted)}.select{height:34px;border:1px solid var(--line);background:var(--input);border-radius:4px;color:var(--text-2);font-size:11.5px;padding:0 28px 0 11px;max-width:100%}.tabbar{display:flex;gap:17px;align-items:center;min-width:0;border-bottom:1px solid var(--line);overflow:auto;scrollbar-width:none;white-space:nowrap}.tabbar::-webkit-scrollbar{display:none}.tab{padding:12px 0 11px;color:var(--muted);background:none;border:0;border-bottom:2px solid transparent;font-size:11.5px;font-weight:600;white-space:nowrap;display:flex;align-items:center;gap:7px}.tab.active{color:var(--text);border-bottom-color:var(--accent)}.tab:hover{color:var(--text)}.tab span{font-size:10px;color:var(--muted);font-variant-numeric:tabular-nums}.pages-layout{display:grid;grid-template-columns:minmax(0,1fr) 298px;gap:14px;min-width:0}.table-panel{overflow:hidden;min-width:0}.table-scroll{max-width:100%;overflow:auto}.data-table{border-collapse:collapse;width:100%;table-layout:fixed;text-align:left}.data-table th{height:40px;background:var(--panel2);color:var(--muted);font-size:10px;letter-spacing:.02em;font-weight:650;white-space:nowrap;text-align:left;padding:0 14px;border-bottom:1px solid var(--line)}.data-table td{height:66px;padding:9px 14px;border-bottom:1px solid var(--line-soft);font-size:11px;vertical-align:middle;color:var(--text-2);min-width:0}.data-table tbody tr:last-child td{border-bottom:0}.data-table tbody tr{cursor:pointer}.data-table tbody tr:hover{background:var(--hover)}.data-table tbody tr.selected{background:var(--selected)}.data-table tbody tr.selected td:first-child{box-shadow:inset 2px 0 var(--accent)}.page-cell{display:flex;align-items:center;gap:10px;min-width:0}.file-icon{width:32px;height:36px;background:var(--panel2);border:1px solid var(--line);border-radius:4px;flex:none;display:grid;place-items:center;color:var(--muted)}.page-cell strong{display:block;color:var(--text);font-size:11.5px;font-weight:650;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.page-cell small{display:block;font-size:10px;color:var(--muted);margin-top:4px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.row-ellipsis{border:1px solid transparent;background:transparent;color:var(--muted);padding:5px;border-radius:3px}.row-ellipsis:hover{background:var(--hover);color:var(--text)}.table-foot{min-height:43px;padding:12px 15px;display:flex;justify-content:space-between;gap:8px;align-items:center;border-top:1px solid var(--line);font-size:10px;color:var(--muted)} +.inspector{align-self:start;position:sticky;top:14px;overflow:hidden}.inspector-top{display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1px solid var(--line)}.inspector-top .file-icon{width:32px;height:33px}.inspector-top h3{font-size:12px;margin:0;font-weight:750}.inspector-top p{font-size:10px;color:var(--muted);margin:3px 0 0}.inspector-header{font-size:10px;text-transform:uppercase;letter-spacing:.07em;font-weight:750;color:var(--muted);margin:0 0 10px}.inspector-sec{padding:14px 16px;border-bottom:1px solid var(--line-soft)}.inspector-sec:last-child{border-bottom:0}.preview-shell{border:1px solid var(--line);background:var(--bg);padding:9px;border-radius:4px}.preview-bar{height:17px;display:flex;gap:4px;align-items:center;padding:0 6px;background:var(--panel2);border:1px solid var(--line-soft);border-bottom:0}.preview-bar i{height:4px;width:4px;background:var(--muted);border-radius:50%}.mini-site{height:126px;background:var(--site-surface);color:var(--site-ink);overflow:hidden;position:relative;display:flex;flex-direction:column;align-items:flex-start;padding:14px 15px;transition:all .2s}.mini-site.mobile{width:50%;margin:0 auto;height:150px}.mini-site .mini-nav{width:100%;display:flex;justify-content:space-between;font-size:5px;font-weight:750;border-bottom:1px solid #dddcd4;padding-bottom:7px}.mini-site .mini-nav span:last-child{color:#8a9a70}.mini-site h4{max-width:150px;font-size:14px;letter-spacing:-.06em;line-height:1.1;margin:21px 0 4px}.mini-site p{font-size:6px;color:#6d726b;margin:0;max-width:160px}.mini-site button{pointer-events:none;background:#293a2c;color:white;border:none;font-size:5px;padding:4px 7px;margin-top:10px}.mini-site .mini-orb{position:absolute;right:-16px;bottom:-32px;height:112px;width:112px;border-radius:50%;background:radial-gradient(circle at 40% 40%,#a4bd83 0,#d2dcb3 38%,#e0dec8 62%,transparent 70%);opacity:.85}.mini-site.mobile h4{font-size:10px;margin-top:13px}.mini-site.mobile .mini-orb{height:80px;width:80px;right:-30px;bottom:-20px}.preview-actions{display:flex;gap:5px;margin-top:8px}.preview-actions button{border:1px solid var(--line);background:var(--panel);color:var(--muted);font-size:10px;display:flex;align-items:center;justify-content:center;gap:4px;padding:5px 6px;border-radius:3px;flex:1}.preview-actions button.active{color:var(--text);background:var(--selected);border-color:var(--accent)}.kv{display:grid;grid-template-columns:88px minmax(0,1fr);gap:9px;margin:0 0 10px;font-size:10.5px}.kv:last-child{margin-bottom:0}.kv dt{color:var(--muted)}.kv dd{margin:0;color:var(--text-2);min-width:0;overflow-wrap:anywhere}.kv dd strong{color:var(--text)}.inspector-actions{display:flex;gap:8px}.inspector-actions .btn{flex:1}.inspector-footnote{margin-top:10px;color:var(--muted);font-size:10px;line-height:1.5} +.collection-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:12px;margin-bottom:18px}.collection-card{padding:16px;min-height:119px;display:flex;flex-direction:column;gap:13px;text-align:left;color:inherit;background:var(--panel);border:1px solid var(--line);border-radius:4px;cursor:pointer}.collection-card:hover,.collection-card.selected{border-color:var(--accent);background:var(--selected)}.collection-card .cc-top{display:flex;justify-content:space-between;align-items:center;color:var(--text-2)}.collection-card .cc-top .ico{color:var(--accent)}.collection-card strong{font-size:12px;display:block}.collection-card small{color:var(--muted);font-size:10px;display:block;margin-top:3px}.collection-card .cc-bottom{margin-top:auto;color:var(--muted);font-size:10.5px}.entries-grid{display:grid;grid-template-columns:minmax(0,1.35fr) minmax(270px,.7fr);gap:16px}.entry-list{padding:0}.entry-list .list-row{cursor:pointer}.entry-list .list-row.selected{background:var(--selected)} +.pipeline{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:0;margin-bottom:18px}.pipeline-step{border:1px solid var(--line);padding:17px 19px;background:var(--panel);min-width:0}.pipeline-step+.pipeline-step{border-left:0}.pipeline-step:first-child{border-radius:4px 0 0 4px}.pipeline-step:last-child{border-radius:0 4px 4px 0}.pipeline-step .step-num{font-size:10px;letter-spacing:.1em;color:var(--muted);font-weight:700;display:flex;gap:8px;align-items:center}.pipeline-step .step-num .ico{color:var(--accent)}.pipeline-step h3{font-size:15px;letter-spacing:-.03em;margin:9px 0 4px}.pipeline-step p{color:var(--muted);font-size:11px;line-height:1.5;margin:0}.pipeline-step .tag{margin-top:12px}.publish-grid{display:grid;grid-template-columns:minmax(0,1.45fr) minmax(290px,.8fr);gap:16px}.check-row{display:flex;gap:10px;align-items:center;padding:12px 16px;border-bottom:1px solid var(--line-soft);font-size:11px}.check-row:last-child{border-bottom:0}.check-row .ico{color:var(--good)}.check-row.warn .ico{color:var(--warn)}.check-row .check-copy{flex:1;min-width:0}.check-row .check-copy strong{display:block;color:var(--text);font-weight:650}.check-row .check-copy small{display:block;color:var(--muted);margin-top:3px;font-size:10px}.release-row{display:flex;align-items:center;gap:10px;padding:12px 17px;border-bottom:1px solid var(--line-soft)}.release-row:last-child{border-bottom:0}.release-row .release-line{flex:1;min-width:0}.release-row strong{font-size:11px;font-weight:700;display:block}.release-row small{font-size:10px;color:var(--muted);display:block;margin-top:3px} +.feature-layout{display:grid;grid-template-columns:minmax(0,1.15fr) minmax(270px,.85fr);gap:16px}.feature-main{padding:24px}.feature-mark{height:43px;width:43px;display:grid;place-items:center;background:var(--accent-bg);color:var(--accent);border-radius:4px;border:1px solid var(--line)}.feature-main h2{font-size:18px;letter-spacing:-.04em;margin:15px 0 7px}.feature-main p{color:var(--text-2);max-width:510px;line-height:1.7;font-size:12px}.feature-items{padding:0;margin:18px 0;list-style:none;display:grid;gap:9px}.feature-items li{display:flex;gap:9px;align-items:center;color:var(--text-2);font-size:11.5px}.feature-items .ico{color:var(--good)} +.footer-line{color:var(--muted);margin-top:26px;display:flex;gap:9px;align-items:center;font-size:10px}.footer-line .icon-button{height:24px;min-width:24px;padding:0} +/* Dialogs, command palette, toast, mobile menu */ +.overlay{position:fixed;inset:0;background:rgba(0,0,0,.57);z-index:100;display:flex;align-items:center;justify-content:center;padding:20px}.overlay[hidden]{display:none}.modal{width:100%;max-width:470px;max-height:min(680px,90dvh);overflow:auto;background:var(--panel);border:1px solid var(--line);border-radius:7px;box-shadow:0 18px 80px var(--shadow)}.modal-head{display:flex;align-items:flex-start;justify-content:space-between;padding:20px 20px 12px;gap:16px}.modal-head h3{font-size:16px;letter-spacing:-.035em;margin:0}.modal-head p{color:var(--muted);font-size:11px;margin:5px 0 0}.modal-content{padding:7px 20px 20px}.form-field{display:block;margin:14px 0}.form-field>span{display:block;color:var(--text-2);font-size:11px;font-weight:650;margin:0 0 6px}.text-input{width:100%;height:37px;border:1px solid var(--line);border-radius:4px;background:var(--input);padding:8px 10px;color:var(--text);outline:none;font-size:12px}.text-input:focus{border-color:var(--accent)}.form-hint{font-size:10px;color:var(--muted);margin-top:5px}.modal-actions{display:flex;align-items:center;justify-content:flex-end;gap:8px;padding-top:15px}.modal-error{font-size:11px;color:var(--bad);margin-top:7px}.command-modal{max-width:565px;align-self:flex-start;margin-top:14vh}.command-input-wrap{height:56px;display:flex;align-items:center;gap:12px;padding:0 16px;border-bottom:1px solid var(--line);color:var(--muted)}.command-input-wrap input{height:100%;border:0;outline:0;background:transparent;color:var(--text);font-size:14px;flex:1;min-width:0}.command-results{padding:8px;max-height:390px;overflow:auto}.command-option{width:100%;display:flex;align-items:center;gap:12px;padding:12px;border:0;background:none;color:var(--text-2);text-align:left;border-radius:4px}.command-option:hover,.command-option:focus-visible{background:var(--hover)}.command-option span{flex:1}.command-option small{font-size:10px;color:var(--muted)}.command-hint{padding:10px 16px;border-top:1px solid var(--line);color:var(--muted);font-size:10px}.toast-stack{position:fixed;bottom:20px;right:22px;z-index:160;display:grid;gap:8px;max-width:min(370px,calc(100vw - 32px))}.toast{background:var(--raised);border:1px solid var(--line);box-shadow:0 12px 30px var(--shadow);color:var(--text);font-size:11.5px;padding:13px 15px;display:flex;gap:9px;align-items:flex-start;border-radius:4px}.toast .ico{color:var(--good)}.toast.warn .ico{color:var(--warn)}.toast strong{display:block;font-weight:700;margin-bottom:3px}.toast p{color:var(--text-2);margin:0;line-height:1.45}.toast .toast-close{border:0;background:none;color:var(--muted);padding:0 0 0 8px;margin-left:auto}.mobile-scrim{position:fixed;inset:0;background:rgba(0,0,0,.55);z-index:30;display:none}.mobile-scrim[hidden]{display:none}.mobile-menu{display:none} +/* Intro chooser */ +.chooser{min-height:100dvh;padding:55px max(24px,calc((100vw - 1180px)/2));background:#101410;color:#eaeee8}.chooser-head{max-width:680px}.chooser .eyebrow{color:#badf8d}.chooser h1{font-size:clamp(30px,4vw,50px);line-height:1.1;letter-spacing:-.065em;margin:7px 0 14px}.chooser p{color:#9aa99b;font-size:13px;line-height:1.7}.chooser-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:20px;margin:38px 0}.chooser-card{border:1px solid #394039;background:#181d18;padding:14px;border-radius:7px;display:block;transition:transform .2s,border .2s}.chooser-card:hover{border-color:#b9dd88;transform:translateY(-3px)}.chooser-shot{height:270px;border:1px solid #333;display:grid;grid-template-columns:25% 1fr;overflow:hidden;background:#131513;border-radius:3px}.chooser-shot aside{background:#1b1f1b;border-right:1px solid #363b35;padding:12px 10px}.chooser-shot .s-brand{width:49%;height:9px;background:#b9dd88;border-radius:1px;margin:3px 0 23px}.chooser-shot aside i{height:6px;width:85%;background:#4d554d;display:block;margin:0 0 15px;border-radius:1px}.chooser-shot aside i:nth-child(4){background:#90a684}.chooser-shot section{padding:19px}.chooser-shot .s-head{height:12px;width:38%;background:#a6b2a5;margin-bottom:23px}.chooser-shot .s-strip{height:43px;background:#252c25;border:1px solid #394439;margin-bottom:15px}.chooser-shot .s-metrics{display:grid;grid-template-columns:repeat(3,1fr);gap:9px;margin-bottom:17px}.chooser-shot .s-metrics i{height:53px;background:#242924;border:1px solid #343b34}.chooser-shot .s-table{height:13px;background:#2e352e;margin-bottom:8px}.chooser-shot .s-table:nth-last-child(-n+2){background:#242a24}.chooser-shot.light{background:#f6f7f4;border-color:#e1e6de}.chooser-shot.light aside{background:#fcfcfa;border-color:#e1e6de}.chooser-shot.light .s-brand{background:#267457}.chooser-shot.light aside i{background:#c4d0c4}.chooser-shot.light aside i:nth-child(4){background:#80a68a}.chooser-shot.light .s-head{background:#455849}.chooser-shot.light .s-strip{background:#fff;border-color:#e1e6de}.chooser-shot.light .s-metrics i{background:white;border-color:#e1e6de}.chooser-shot.light .s-table{background:#edf0e9}.chooser-shot.light .s-table:nth-last-child(-n+2){background:#f6f6f2}.chooser-card-footer{padding:17px 3px 2px;display:flex;justify-content:space-between;gap:12px;align-items:center}.chooser-card-footer strong{font-size:16px;letter-spacing:-.02em}.chooser-card-footer span{font-size:11px;color:#aab9a9}.chooser-card .arrow{color:#bddf91;font-size:22px}.chooser-foot{font-size:11px;color:#889789;border-top:1px solid #313a31;padding-top:21px} +@media(max-width:1300px){.page-wrap{padding:25px 22px 38px}.pages-layout{grid-template-columns:minmax(0,1fr) 274px}.strip-details{gap:16px}.cmd-search{width:188px}.data-table th,.data-table td{padding-left:10px;padding-right:10px}.layout-2{grid-template-columns:minmax(0,1.35fr) minmax(270px,.8fr)}} +@media(max-width:1150px){.pages-layout{grid-template-columns:minmax(0,1fr)}.inspector{position:static;display:grid;grid-template-columns:1fr 1fr}.inspector-top{grid-column:1/-1}.inspector-sec{border-right:1px solid var(--line-soft)}.inspector-sec:last-child{grid-column:1/-1;border-right:0}.strip-details>div:last-child{display:none}.cmd-search{width:165px}.data-table{min-width:640px}} +@media(max-width:960px){.app,.app.collapsed{grid-template-columns:minmax(0,1fr)}.sidebar{position:fixed;top:0;bottom:0;left:0;width:240px;transform:translateX(-100%);transition:transform .2s ease;box-shadow:15px 0 50px var(--shadow)}.app.mobile-open .sidebar{transform:translateX(0)}.app.mobile-open .mobile-scrim{display:block}.app.collapsed .brand-copy,.app.collapsed .nav-heading,.app.collapsed .nav-label,.app.collapsed .nav-count,.app.collapsed .site-chip-copy,.app.collapsed .sidebar-note{display:initial}.app.collapsed .nav-button{justify-content:flex-start;padding:8px 10px}.app.collapsed .nav-group+.nav-group{margin-top:18px}.app.collapsed .side-bottom-actions{flex-direction:row}.app.collapsed .sidebar-inner{padding:14px 10px}.app.collapsed .site-chip{justify-content:flex-start}.mobile-menu{display:inline-flex}.topbar{padding:0 18px}.strip-details{gap:20px}.layout-2{grid-template-columns:minmax(0,1.4fr) minmax(260px,.85fr)}} +@media(max-width:740px){.topbar{height:52px;padding:0 14px;gap:7px}.cmd-search{width:32px;justify-content:center;padding:0}.cmd-search span,.cmd-search .key{display:none}.top-breadcrumb{gap:6px}.top-breadcrumb .crumb-site{display:none}.top-breadcrumb .slash:first-of-type{display:none}.top-right{gap:3px}.top-right .tiny-live{display:none}.top-right .sep{display:none}.page-wrap{padding:20px 14px 30px}.section-head{flex-wrap:wrap;gap:14px;margin-bottom:20px}.page-title{font-size:23px}.head-actions{justify-content:flex-start;width:100%}.strip{padding:13px 15px;flex-wrap:wrap}.strip-details{width:100%;margin-left:0;padding-left:52px}.strip-details>div:last-child{display:block}.strip-action{margin-left:auto}.metric-row{grid-template-columns:repeat(2,minmax(0,1fr));gap:9px}.metric{min-height:94px;padding:14px}.metric-value{font-size:23px}.layout-2,.publish-grid,.entries-grid,.feature-layout{grid-template-columns:minmax(0,1fr)}.collection-grid{grid-template-columns:repeat(2,minmax(0,1fr))}.inspector{grid-template-columns:1fr}.inspector-top,.inspector-sec:last-child{grid-column:1}.inspector-sec{border-right:0}.pipeline{grid-template-columns:1fr}.pipeline-step+.pipeline-step{border-left:1px solid var(--line);border-top:0}.pipeline-step:first-child{border-radius:4px 4px 0 0}.pipeline-step:last-child{border-radius:0 0 4px 4px}.pipeline-step{padding:13px 16px}.pipeline-step h3{margin:6px 0 3px}.pipeline-step .tag{margin-top:7px}.chooser-grid{grid-template-columns:1fr}.chooser-shot{height:220px}} +@media(max-width:480px){.page-subtitle{font-size:11px}.head-actions .btn{flex:1}.strip-symbol{display:none}.strip-details{padding-left:0;gap:12px;justify-content:space-between}.strip-action{margin-left:0}.strip h2{font-size:13px}.metric-label{font-size:10px}.metric{padding:13px 11px}.toolbar{display:grid;grid-template-columns:minmax(0,1fr) minmax(115px,.55fr);gap:8px}.toolbar .search-field{grid-column:1/-1}.toolbar .select{width:100%}.toolbar .btn{width:100%}.data-table{min-width:0}.data-table th,.data-table td{padding:9px 9px}.data-table th:nth-child(2),.data-table td:nth-child(2),.data-table th:nth-child(3),.data-table td:nth-child(3),.data-table th:nth-child(5),.data-table td:nth-child(5){display:none}.data-table td{height:67px}.data-table th:first-child{width:60%}.data-table th:nth-child(4){width:30%}.data-table th:last-child{width:10%}.file-icon{width:26px;height:31px}.page-cell{gap:7px}.page-cell strong{font-size:11px}.page-cell small{font-size:9px}.list-row{padding:11px 12px}.panel-head{padding:13px 12px}.panel-body{padding:13px 12px}.collection-grid{grid-template-columns:1fr 1fr;gap:8px}.collection-card{padding:13px;min-height:115px}.footer-line{flex-wrap:wrap}.chooser{padding:36px 18px}.chooser .chooser-shot{height:180px}} +@media(max-height:650px){.brand-area{height:57px;padding-top:11px;padding-bottom:9px}.sidebar-inner{padding-top:5px}.nav-group+.nav-group{margin-top:5px}.nav-heading{padding-top:8px}.nav-button{min-height:31px;padding:6px 10px}.sidebar-bottom{padding-top:7px;padding-bottom:7px}.page-wrap{padding-top:20px}} +@media(prefers-reduced-motion:reduce){*,*:before,*:after{transition:none!important;animation:none!important}} +/* Polishing pass: prevent hotkey and search labels from wrapping */ +.cmd-search>span:not(.key){min-width:0;display:block;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.cmd-search .key{white-space:nowrap;flex:none} +@media(max-width:480px){ + .data-table colgroup col:nth-child(2),.data-table colgroup col:nth-child(3),.data-table colgroup col:nth-child(5){display:none} + .data-table colgroup col:first-child{width:52%!important} + .data-table colgroup col:nth-child(4){width:34%!important} + .data-table colgroup col:nth-child(6){width:14%!important} + .data-table th:first-child{width:52%}.data-table th:nth-child(4){width:34%}.data-table th:last-child{width:14%} +} +@media(max-width:740px){.cmd-search>span:not(.key){display:none}} +@media(max-width:480px){.data-table th:last-child{font-size:0}.data-table th:last-child:after{content:"···";font-size:13px}} +.sr-only{position:absolute!important;width:1px!important;height:1px!important;padding:0!important;margin:-1px!important;overflow:hidden!important;clip:rect(0,0,0,0)!important;white-space:nowrap!important;border:0!important} diff --git a/design/assets/admin.js b/design/assets/admin.js new file mode 100644 index 0000000..9111042 --- /dev/null +++ b/design/assets/admin.js @@ -0,0 +1,283 @@ +/* Site Engine · stage 1 · interactive, local-only UI prototype */ +(() => { + 'use strict'; + const $ = (sel, root=document) => root.querySelector(sel); + const $$ = (sel, root=document) => Array.from(root.querySelectorAll(sel)); + const esc = x => String(x ?? '').replace(/[&<>"']/g, ch => ({'&':'&','<':'<','>':'>','"':'"',"'":'''}[ch])); + const art = { + grid:'', + pages:'', + layers:'', + deploy:'', + image:'', + structure:'', + form:'', + settings:'', + journal:'', + search:'', + chevron:'', + bell:'', + globe:'', + plus:'', + arrow:'', + up:'', + filter:'', + panel:'', + menu:'', + external:'', + check:'', + warning:'', + file:'', + clock:'', + activity:'', + inbox:'', + close:'', + monitor:'', + smartphone:'', + dots:'', + copy:'', + trash:'', + spark:'', + link:'', + code:'', + book:'', + shield:'', + rotate:'', + moon:'', + sun:'', + slash:'', + sliders:'', + layout:'', + }; + const icon = (name, cls='') => ``; + + const SEED_PAGES = [ + {id:'home',title:'Главная',url:'/',path:'pages/index.md',layout:'landing',status:'published',changed:true,date:'сегодня, 15:42',blocks:7,warning:null,description:'Главная страница студии: AI, Telegram-боты и автоматизация.'}, + {id:'services',title:'Услуги',url:'/services/',path:'pages/services/index.md',layout:'default',status:'published',changed:true,date:'сегодня, 14:18',blocks:5,warning:null,description:'Каталог направлений с привязкой к коллекции services.'}, + {id:'about',title:'О компании',url:'/about/',path:'pages/about.md',layout:'default',status:'published',changed:false,date:'8 ноя, 12:26',blocks:4,warning:null,description:'О команде и процессе работы.'}, + {id:'contact',title:'Контакты',url:'/contacts/',path:'pages/contacts.md',layout:'default',status:'published',changed:false,date:'7 ноя, 17:01',blocks:3,warning:null,description:'Контакты и форма обратной связи.'}, + {id:'request',title:'Заявка на проект',url:'/request/',path:'pages/request.md',layout:'form-page',status:'draft',changed:true,date:'сегодня, 11:04',blocks:3,warning:'Не задано назначение формы',description:'Страница создания заявки на разработку.'}, + {id:'policy',title:'Политика персональных данных',url:'/privacy/',path:'pages/privacy.md',layout:'legal',status:'published',changed:false,date:'5 ноя, 16:24',blocks:2,warning:null,description:'Юридические положения и обработка данных.'}, + {id:'thanks',title:'Спасибо за заявку',url:'/thank-you/',path:'pages/thank-you.md',layout:'minimal',status:'draft',changed:false,date:'4 ноя, 10:17',blocks:2,warning:null,description:'Страница подтверждения отправленной формы.'} + ]; + const COLLECTIONS = [ + {id:'services',name:'Услуги',description:'Направления студии',count:3,enabled:true}, + {id:'scenarios',name:'Сценарии',description:'Отраслевые решения',count:3,enabled:true}, + {id:'cases',name:'Кейсы',description:'Портфолио проектов',count:2,enabled:true}, + {id:'courses',name:'Курсы',description:'Обучающие программы',count:0,enabled:false}, + {id:'posts',name:'Публикации',description:'Статьи и обновления',count:0,enabled:false} + ]; + const ENTRIES = { + services:[{id:'bots',title:'Telegram-боты',slug:'bots',status:'published',date:'сегодня, 12:34',rel:'tech · Python, aiogram'},{id:'ai',title:'AI-ассистенты',slug:'ai',status:'published',date:'8 ноя, 11:25',rel:'tech · LLM, RAG'},{id:'automation',title:'Бизнес-автоматизация',slug:'automation',status:'draft',date:'7 ноя, 09:47',rel:'tech · Python, API'}], + scenarios:[{id:'legal',title:'Для юридических компаний',slug:'legal',status:'published',date:'8 ноя, 13:10',rel:'services · ai, bots'},{id:'real-estate',title:'Для недвижимости',slug:'real-estate',status:'draft',date:'6 ноя, 15:11',rel:'services · bots'},{id:'services-scenario',title:'Для сферы услуг',slug:'services',status:'draft',date:'5 ноя, 16:00',rel:'services · automation'}], + cases:[{id:'reception',title:'AI-приёмная для сервиса',slug:'ai-reception',status:'published',date:'5 ноя, 12:21',rel:'services · ai'},{id:'booking',title:'Бот для онлайн-записи',slug:'booking',status:'draft',date:'4 ноя, 17:01',rel:'services · bots'}], + courses:[],posts:[] + }; + const RELEASES = [ + {id:'build_00027',date:'9 ноя · 18:40',author:'Admin',comment:'Обновление главной и услуг',pages:7,live:true}, + {id:'build_00026',date:'6 ноя · 12:15',author:'Admin',comment:'Контактная форма и страницы',pages:7,live:false}, + {id:'build_00025',date:'3 ноя · 16:52',author:'Editor',comment:'Первый публичный релиз',pages:6,live:false} + ]; + const NAV = [ + {label:'РАБОЧАЯ ОБЛАСТЬ',items:[['overview','Обзор','grid'],['pages','Страницы','pages'],['content','Контент','layers'],['publish','Публикация','deploy'],['media','Медиа','image']]}, + {label:'КОНФИГУРАЦИЯ',items:[['structure','Структура','structure'],['forms','Формы и заявки','form'],['settings','Настройки','settings'],['journal','Журнал','journal']]} + ]; + const params = new URLSearchParams(location.search); + const state = { + route:params.get('view') || 'overview', + pages:SEED_PAGES.map(p=>({...p})), + pageFilter:'all', pageSearch:'', pageLayout:'all', + selectedPage:'home', collection:'services',selectedEntry:'bots', + preview:'desktop', collapsed:false, mobileOpen:false, + role:'owner', + }; + if (!NAV.flatMap(x=>x.items).some(([id])=>id===state.route)) state.route='overview'; + const app = $('#app'); + const navName = id => NAV.flatMap(g=>g.items).find(i=>i[0]===id)?.[1] || 'Обзор'; + const changes = () => state.pages.filter(p=>p.changed); + const draftCount = () => state.pages.filter(p=>p.status==='draft').length; + const statusLabel = s => ({published:'В каталоге',draft:'Черновик',archived:'Архив'}[s]||s); + const statusTag = s => `${statusLabel(s)}`; + const permission = () => ['owner','developer','editor'].includes(state.role); + const future = title => showDialog(``); + + function renderSidebar(){ + $('#sidebar').innerHTML = `
S/
Site Engine
ADMIN CONSOLE · ${document.body.classList.contains('theme-antirion')?'03':'01'}
`; + } + function renderTopbar(){ + $('#topbar').innerHTML=`
studio.example/${esc(navName(state.route))}
LIVE #00027
`; + } + function header(kicker,title,subtitle,actions=''){return `
${kicker}

${title}

${subtitle}

${actions}
`;} + function viewOverview(){ + return `${header('WORKSPACE / 01','Рабочая область','Состояние сайта, незавершённые изменения и последние действия.',``)} +
${icon('globe','lg')}

Студия автоматизации

studio.example / Основной сайт / production

Сайт доступен
Опубликованная версия
build_00027
9 ноября, 18:40
+
Страницы ${icon('pages','sm')}
${state.pages.length.toString().padStart(2,'0')}
${state.pages.filter(p=>p.status==='published').length} в каталоге сайта
Изменения workspace ${icon('activity','sm')}
${changes().length.toString().padStart(2,'0')}
Не опубликованы в live
Черновики ${icon('file','sm')}
${draftCount().toString().padStart(2,'0')}
Отдельно от текущего релиза
Ошибки / предупреждения ${icon('warning','sm')}
01 / 02
Требуется проверка перед сборкой
+
Изменения после live-релиза
Файлы рабочего пространства, ещё не вошедшие в build_00027
${changes().length?changes().slice(0,4).map(p=>`
${icon('file')}
${esc(p.title)}${esc(p.path)}
${p.status==='draft'?'Черновик':'Изменено'}${esc(p.date)}
`).join(''):`
Нет неопубликованных изменений
`}
+
Структура проекта
File-first контент · Markdown + YAML
PAGES
${state.pages.length} файлов
COLLECTIONS
5 схем
LAYOUTS
4 шаблона
+
Перед публикацией
Сводка проверок · mock
Нужно внимание
${icon('warning','lg')}
1 ошибка блокирует сборку
pages/request.md
Не задано назначение формы в блоке form_contact.
2 предупреждения по ссылкам
+
Недавняя активность
DEMO
${icon('file','sm')}
Изменён заголовок главной

pages/index.md · editor

${icon('link','sm')}
Обновлена коллекция services

3 связанных записи

${icon('deploy','sm')}
Опубликован build_00027

Production · 9 ноября

`; + } + function filteredPages(){ + const q=state.pageSearch.toLocaleLowerCase('ru').trim(); + return state.pages.filter(p=>(state.pageFilter==='all'||(state.pageFilter==='changed'?p.changed:state.pageFilter==='draft'?p.status==='draft':p.status==='published'))&&(state.pageLayout==='all'||p.layout===state.pageLayout)&&(!q||[p.title,p.url,p.path,p.layout].some(v=>v.toLocaleLowerCase('ru').includes(q)))); + } + function pageInspector(){ + const p=state.pages.find(p=>p.id===state.selectedPage); + if(!p)return ``; + return ``; + } + function viewPages(){ + const all=state.pages.length,changed=changes().length,drafts=draftCount(),published=state.pages.filter(p=>p.status==='published').length; + const tabs=[['all','Все',all],['changed','Изменения',changed],['draft','Черновики',drafts],['published','В каталоге',published]]; + return `${header('SITE / PAGES','Страницы',`Управление ручными страницами · pages/**/*.md`,``)} +
+
${tabs.map(([id,name,num])=>``).join('')}
+
${pageRows()}
Название / ФайлURLLayoutСтатусИзмененияДействия
${filteredPages().length} из ${state.pages.length} страницКликните по строке для просмотра свойств ${icon('arrow','sm')}
${pageInspector()}
`; + } + function pageRows(){return filteredPages().length?filteredPages().map(p=>`
${icon('file','sm')}${esc(p.title)}${esc(p.path)}
${esc(p.url)}${esc(p.layout)}${statusTag(p.status)}${p.changed?`Изменено`:`—`}`).join(''):`
${icon('search','lg')}Ничего не найдено

Измените запрос или сбросьте фильтры.

`;} + function viewContent(){ + const c=COLLECTIONS.find(x=>x.id===state.collection),items=ENTRIES[c.id]||[],selected=items.find(x=>x.id===state.selectedEntry)||items[0]; + return `${header('SITE / COLLECTIONS','Контент','Типизированные записи и связи · content/<collection>/*.md',``)} +
${COLLECTIONS.map(x=>``).join('')}
+
Записи · ${c.id}
${c.name} · ${items.length} ${items.length===1?'запись':'записей'}
Entry ≠ Page
${items.length?items.map(e=>`
${icon('file')}
${esc(e.title)}content/${c.id}/${esc(e.slug)}.md
${statusTag(e.status)}${esc(e.date)}
${icon('chevron','sm')}
`).join(''):`
${icon('inbox','lg')}В коллекции пока нет записей

${c.enabled?'Создайте первую запись.':'Коллекция выключена в демо-конфигурации.'}

`}
+
Карточка записи
READ ONLY · ЭТАП 1
${selected?`
${c.id} / ${selected.slug}

${esc(selected.title)}

Статус
${statusTag(selected.status)}
Источник
content/${c.id}/${esc(selected.slug)}.md
Связи
${esc(selected.rel)}
Рендер
display/${c.id}.yaml
Карточка показывает модель Entry и связь с display template. Редактор появится на Этапе 4.
`:`
Нет выбранной записи

Пустая коллекция.

`}
`; + } + function viewPublish(){ + return `${header('RELEASES / PRODUCTION','Публикация','Файловый workspace и неизменяемые релизы сайта — разные состояния.',``)} +
01 / WORKSPACE ${icon('file','sm')}

Черновики и правки

${changes().length} изменённых страницы · рабочие файлы

Могут быть неполными
02 / CANDIDATE ${icon('shield','sm')}

Кандидат релиза

Сборка после строгой валидации.

Ожидает исправлений
03 / LIVE ${icon('globe','sm')}

build_00027

Опубликован 9 ноября в 18:40.

Активный релиз
+
Проверки перед релизом
Демонстрационный результат validate · без серверной проверки
${icon('check')}
Структура YAML и Markdown7 page-документов, обязательные поля доступны
OK
${icon('warning')}
Назначение формы: form_contactpages/request.md · regions.main[2].props.form
Ошибка
${icon('warning')}
Ссылки и медиа2 предупреждения, не блокируют сборку
Warning
+
Изменённые страницы
Отличаются от активного снимка сайта
${changes().length}
${changes().map(p=>`
${icon('file')}
${esc(p.title)}${esc(p.path)}
`).join('')}
+
Текущий релиз
LIVE
build_00027

9 ноября 2026 · 18:40

Автор
Алексей
Страниц
7
Примечание
Обновление главной и услуг
История публикаций
${RELEASES.map(r=>`
${icon('deploy','sm')}
${r.id}${r.date}
${r.live?'LIVE':''}
`).join('')}
`; + } + const FEATURES={ + media:{title:'Медиатека',kicker:'SITE / ASSETS',icon:'image',desc:'Файлы, метаданные изображений и понятная связь «где используется».',items:['Поиск ассетов и контроль отсутствующих файлов','Alt-текст, подписи, размеры и версии','Использование в Page / Block / Entry'],path:'assets/',next:'Этап 6'}, + structure:{title:'Структура сайта',kicker:'SITE / STRUCTURE',icon:'structure',desc:'Layouts, Fragments, Display templates и меню — отдельные контракты файлового движка.',items:['Регионы Layout, фиксированные header и footer','Каталог Fragment и схема props','Display templates, меню и навигация'],path:'layouts/ · fragments/ · display/',next:'Этап 6'}, + forms:{title:'Формы и заявки',kicker:'SITE / FORMS',icon:'form',desc:'Схемы форм и журнал отправок без смешивания с контентом страниц.',items:['Версии схем форм и совместимость с релизами','Состояние доставки и обработка ошибок','RBAC для персональных данных заявок'],path:'forms/ · SQLite (service data)',next:'Этап 6'}, + settings:{title:'Настройки',kicker:'SYSTEM / CONFIG',icon:'settings',desc:'Конфигурация одного сайта, правила доступа и параметры сборки.',items:['site.yaml и дизайн-токены темы','Общие данные и redirects.yaml','Роли, MCP scopes, аудируемые операции'],path:'site.yaml · data/ · redirects.yaml',next:'Этап 6'}, + journal:{title:'Журнал действий',kicker:'SYSTEM / AUDIT',icon:'journal',desc:'Хронология изменений, валидаций, сборок и конфликтов.',items:['Аудит изменений Page и Entry','История build и результат проверок','Конфликты редактирования (409 / if_match)'],path:'SQLite · audit_log',next:'Этап 6'} + }; + function viewFeature(route){ + const f=FEATURES[route];return `${header(f.kicker,f.title,'Запланированный раздел · навигационный экран первого этапа',`${f.next}`)}
${icon(f.icon,'lg')}

${f.desc}

В этом концепте мы проверяем расположение раздела в информационной архитектуре. Полный интерактивный интерфейс будет разрабатываться после утверждения основных экранов.

    ${f.items.map(t=>`
  • ${icon('check','sm')}${esc(t)}
  • `).join('')}
Источник данных: ${esc(f.path)}. В текущем HTML нет API и реальных файлов сайта.
Этапность реализации
PROJECT MAP
${icon('check','sm')}
Этап 1 · Shell, навигация и страницы

Текущий рабочий HTML-прототип.

${icon('layout','sm')}
Этап 2–3 · Редактор

Конструктор, маппинг, Эксперт.

${icon('layers','sm')}
Этап 4–5 · Контент и релизы

Единые документы, история и откат.

${icon('settings','sm')}
Этап 6 · Остальные разделы

Включая текущий экран.

`; + } + function render(){ + renderSidebar();renderTopbar(); + const views={overview:viewOverview,pages:viewPages,content:viewContent,publish:viewPublish}; + $('#content').innerHTML=(views[state.route]||(()=>viewFeature(state.route)))()+``; + app.classList.toggle('collapsed',state.collapsed); + app.classList.toggle('mobile-open',state.mobileOpen); + $('#mobileScrim').hidden=!state.mobileOpen; + } + function navigate(route){ + if(!NAV.flatMap(g=>g.items).some(x=>x[0]===route))return; + state.route=route;state.mobileOpen=false; + try{history.replaceState(null,'',location.pathname+'?view='+encodeURIComponent(route));}catch(_){/* file:// navigation still works */} + render();$('#workspace').scrollTop=0; + } + function showDialog(markup){$('#modal-root').innerHTML=``; const focusable=$('[autofocus]', $('#modal-root')) || $('.modal .icon-button', $('#modal-root')) || $('.modal button', $('#modal-root'));focusable?.focus();} + function closeDialog(){$('#modal-root').innerHTML='';} + function toast(title,body,warning=false){ + const root=$('#toast'); const item=document.createElement('div');item.className='toast'+(warning?' warn':'');item.innerHTML=`${icon(warning?'warning':'check')}
${esc(title)}

${esc(body)}

`;root.appendChild(item); + $('.toast-close',item).onclick=()=>item.remove();setTimeout(()=>item.remove(),5500); + } + function details(p){showDialog(``);} + function createPageModal(){ + if(!permission()){toast('Только чтение','Текущая demo-роль не может создавать страницы.',true);return;} + showDialog(``); + } + function createPage(form){ + const fd=new FormData(form),title=String(fd.get('title')||'').trim(),url=String(fd.get('slug')||'').trim(),layout=String(fd.get('layout')||'default');const err=$('#create-error'); + if(!title){err.textContent='Введите название.';return;} + if(!/^\/(?:[a-z0-9-]+\/)*$/.test(url)){err.textContent='URL должен начинаться и заканчиваться «/», используйте только a–z, 0–9 и дефисы.';return;} + if(state.pages.some(p=>p.url===url)){err.textContent='Страница с таким URL уже существует.';return;} + const slug=url.split('/').filter(Boolean).join('/');const id='new-'+Math.random().toString(36).slice(2,9);const path=`pages/${slug?slug+'/index':'index'}.md`; + state.pages.unshift({id,title,url,path,layout,status:'draft',changed:true,date:'только что',blocks:0,warning:null,description:'Новая страница: пока не заполнена.'});state.selectedPage=id;state.pageFilter='all';state.pageLayout='all';state.pageSearch='';closeDialog();navigate('pages');toast('Черновик создан','Добавлена demo-страница '+title+'. Файл на диск не записан.'); + } + function pageActions(id){ + const p=state.pages.find(p=>p.id===id);if(!p)return;state.selectedPage=id;render();showDialog(``); + } + function duplicatePage(){ + if(!permission()){toast('Недостаточно прав','Роль только для просмотра.',true);return;} + const p=state.pages.find(x=>x.id===state.selectedPage);if(!p)return;let url=p.url==='/'?'/home-copy/':p.url.replace(/\/$/,'-copy/');while(state.pages.some(x=>x.url===url))url=url.replace(/\/$/,'-copy/');const slug=url.slice(1,-1);const id='copy-'+Math.random().toString(36).slice(2,9); + state.pages.unshift({...p,id,title:p.title+' (копия)',url,path:`pages/${slug}/index.md`,status:'draft',changed:true,date:'только что'});state.selectedPage=id;closeDialog();navigate('pages');toast('Копия создана','Добавлен отдельный demo-черновик.'); + } + function deletePage(){ + if(!permission()){toast('Недостаточно прав','Роль только для просмотра.',true);return;} + const p=state.pages.find(x=>x.id===state.selectedPage);if(!p)return; + showDialog(``); + } + function releaseDetails(id){ + const r=RELEASES.find(x=>x.id===id)||RELEASES[0];showDialog(``); + } + function historyModal(){showDialog(``);} + function checkModal(){showDialog(``);} + function profileModal(){showDialog(``);} + function commandModal(){ + showDialog(`
${icon('search','lg')}
Enter · выбрать первое / Esc · закрыть / Ctrl K · открыть
`); + updateCommand(''); + } + function updateCommand(q){ + const el=$('#command-results');if(!el)return;const query=q.trim().toLowerCase(); + const nav= NAV.flatMap(g=>g.items).filter(x=>!query||x[1].toLowerCase().includes(query)).map(([id,name,glyph])=>({id,name,glyph,type:'Раздел'})); + const pp=state.pages.filter(p=>!query||[p.title,p.path,p.url].some(s=>s.toLowerCase().includes(query))).map(p=>({id:p.id,name:p.title,glyph:'file',type:p.url,isPage:true})); + const choices=[...nav,...pp].slice(0,13); + el.innerHTML=choices.length?choices.map(x=>``).join(''):`
Ничего не найдено

Попробуйте другое название или URL.

`; + } + function doAction(action){ + switch(action){ + case 'mobile-menu':state.mobileOpen=!state.mobileOpen;render();break; + case 'collapse':state.collapsed=!state.collapsed;render();break; + case 'switch-theme':{if(document.body.classList.contains('theme-antirion')){document.body.dataset.theme=document.body.dataset.theme==='dark'?'light':'dark';render();}else{const target=document.body.dataset.theme==='dark'?'light.html':'dark.html';location.href=target+'?view='+encodeURIComponent(state.route);}break;} + case 'command':commandModal();break; + case 'notifications':toast('Уведомления · DEMO','3 изменения в workspace, 1 ошибка и 2 предупреждения.');break; + case 'profile':profileModal();break; + case 'about':showDialog(``);break; + case 'live-details':releaseDetails('build_00027');break; + case 'release-history':historyModal();break; + case 'check-details':checkModal();break; + case 'future-publish':future('Сборка, публикация и откат');break; + case 'future-editor':future('Редактор: Конструктор / Эксперт');break; + case 'future-content':future('Редактор коллекций и записей');break; + case 'pages-info':showDialog(``);break; + case 'collections-info':showDialog(``);break; + case 'page-information':closeDialog();details(state.pages.find(p=>p.id===state.selectedPage));break; + case 'create-page':createPageModal();break; + case 'reset-filters':state.pageFilter='all';state.pageSearch='';state.pageLayout='all';render();break; + case 'duplicate-page':closeDialog();duplicatePage();break; + case 'delete-page':deletePage();break; + case 'confirm-delete':{const p=state.pages.find(p=>p.id===state.selectedPage);if(!p)return;state.pages=state.pages.filter(x=>x.id!==p.id);state.selectedPage=state.pages[0]?.id||'';closeDialog();render();toast('Страница убрана из демо','Список обновлён. Live-релиз не изменился.');break;} + case 'close-modal':closeDialog();break; + } + } + document.addEventListener('click',ev=>{ + const scrim=ev.target.closest('#mobileScrim');if(scrim){state.mobileOpen=false;render();return;} + if(ev.target.id==='dialog-layer'){closeDialog();return;} + const filter=ev.target.closest('[data-page-filter]');if(filter){state.pageFilter=filter.dataset.pageFilter;render();return;} + const preview=ev.target.closest('[data-preview]');if(preview){state.preview=preview.dataset.preview;render();return;} + const coll=ev.target.closest('[data-collection]');if(coll){state.collection=coll.dataset.collection;state.selectedEntry=(ENTRIES[state.collection]||[])[0]?.id||'';render();return;} + const entry=ev.target.closest('[data-entry]');if(entry){state.selectedEntry=entry.dataset.entry;render();return;} + const rel=ev.target.closest('[data-release]');if(rel){releaseDetails(rel.dataset.release);return;} + const pageAct=ev.target.closest('[data-page-actions]');if(pageAct){pageActions(pageAct.dataset.pageActions);return;} + const page=ev.target.closest('[data-open-page]');if(page){closeDialog();state.selectedPage=page.dataset.openPage;navigate('pages');return;} + const nav=ev.target.closest('[data-nav]');if(nav){closeDialog();navigate(nav.dataset.nav);return;} + const action=ev.target.closest('[data-action]');if(action){doAction(action.dataset.action);return;} + const row=ev.target.closest('[data-row-page]');if(row){state.selectedPage=row.dataset.rowPage;render();return;} + }); + document.addEventListener('input',ev=>{ + if(ev.target.id==='page-search'){const v=ev.target.value,cursor=ev.target.selectionStart;state.pageSearch=v;const tbody=$('#page-table-body');if(tbody)tbody.innerHTML=pageRows();const count=$('#result-count');if(count)count.textContent=`${filteredPages().length} из ${state.pages.length} страниц`; /* keep focus without rerender */} + if(ev.target.id==='command-input')updateCommand(ev.target.value); + }); + document.addEventListener('change',ev=>{ + if(ev.target.id==='layout-filter'){state.pageLayout=ev.target.value;render();} + if(ev.target.id==='role-select'){state.role=ev.target.value;render();toast('Роль переключена','Действия записи в demo-UI теперь '+(permission()?'доступны.':'недоступны.'));} + }); + document.addEventListener('submit',ev=>{if(ev.target.id==='create-page-form'){ev.preventDefault();createPage(ev.target);}}); + document.addEventListener('keydown',ev=>{ + if((ev.ctrlKey||ev.metaKey)&&ev.key.toLowerCase()==='k'){ev.preventDefault();commandModal();return;} + if(ev.key==='Escape'){closeDialog();if(state.mobileOpen){state.mobileOpen=false;render();}} + if((ev.key==='Enter'||ev.key===' ')&&ev.target.matches('[data-row-page],[data-entry]')){ev.preventDefault();ev.target.click();} + if(ev.key==='Enter'&&ev.target.id==='command-input'){const item=$('.command-option');if(item){ev.preventDefault();item.click();}} + }); + render(); +})(); diff --git a/design/assets/antirion-rework.css b/design/assets/antirion-rework.css new file mode 100644 index 0000000..a8b8361 --- /dev/null +++ b/design/assets/antirion-rework.css @@ -0,0 +1,25 @@ +/* Site Engine — 04 / Antirion Rework. An original design inspired by Antirion's flat, hairline-driven console grammar. */ +:root{font-synthesis:none} +*{box-sizing:border-box}html,body{margin:0;min-height:100%;font-family:Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Arial,sans-serif;font-size:13px}button,input,select,textarea{font:inherit}button{cursor:pointer}button:disabled{cursor:not-allowed;opacity:.45}button:focus-visible,input:focus-visible,select:focus-visible{outline:2px solid var(--focus);outline-offset:2px} +body[data-skin="light"]{color-scheme:light;--shell:#151719;--shell2:#1e2023;--nav-text:#b3b4b8;--paper:#f8f8f6;--paper2:#f2f2ef;--paper3:#eaeae6;--ink:#222426;--secondary:#6c6e70;--dim:#9a9c9b;--stroke:#d9dad6;--stroke2:#e5e6e2;--accent:#6558d4;--accent2:#edeafe;--focus:#8f83ef;--good:#347f69;--goodbg:#e8f3ee;--warn:#ac6c32;--warnbg:#fff2e2;--error:#ae4953;--errorbg:#fcebed;--site:#f4f1e9;--siteink:#1f2326;--sider:#fff} +body[data-skin="dark"]{color-scheme:dark;--shell:#101113;--shell2:#1e2022;--nav-text:#a9aaad;--paper:#151719;--paper2:#1b1d20;--paper3:#25272a;--ink:#eeeeed;--secondary:#b0b1b3;--dim:#777a7d;--stroke:#383b3f;--stroke2:#292c30;--accent:#aba2ff;--accent2:#2c293d;--focus:#b9b2ff;--good:#8dd4ad;--goodbg:#1d352d;--warn:#e7b57a;--warnbg:#35291f;--error:#ff9eab;--errorbg:#3c252c;--site:#ebe9e0;--siteink:#1f2326;--sider:#1a1b1e} +body{background:var(--paper);color:var(--ink)}.app{display:grid;grid-template-columns:222px minmax(0,1fr);min-height:100vh}.app.narrow{grid-template-columns:66px minmax(0,1fr)}.sidebar{height:100vh;position:sticky;top:0;background:var(--shell);color:var(--nav-text);display:flex;flex-direction:column;min-width:0;z-index:40}.brand{height:98px;border-bottom:1px solid #333639;display:flex;align-items:center;gap:11px;padding:22px 17px}.brand-logo{width:37px;height:37px;display:grid;place-items:center;flex:none;background:#eeeeea;color:#171819;font-size:22px;font-weight:790;letter-spacing:-.12em;clip-path:polygon(0 0,100% 0,100% 75%,76% 100%,0 100%)}.brand h1{margin:0;color:#f2f2ef;font-size:14px;letter-spacing:-.035em;font-weight:720}.brand p{margin:5px 0 0;color:#777c80;font-size:9px;letter-spacing:.14em;font-weight:700}.nav-title{font-size:9px;letter-spacing:.12em;font-weight:760;color:#707478;margin:27px 17px 10px}.sidebar-nav{padding:0 8px;flex:1;overflow:auto}.nav-item{width:100%;display:flex;gap:12px;align-items:center;height:39px;background:none;border:0;color:#b6b8bc;text-align:left;padding:0 12px;border-radius:0;font-size:12px;position:relative;white-space:nowrap}.nav-item:hover{background:#242629;color:#fff}.nav-item.active{color:#fff;background:#292b2f;font-weight:670}.nav-item.active:before{content:"";position:absolute;inset:0 auto 0 0;width:2px;background:#d5d1ff}.nav-item svg{width:16px;height:16px;flex:none}.nav-item .count{margin-left:auto;border:1px solid #494a4d;font-size:10px;padding:0px 5px;color:#aeb0b4}.sidebar-bottom{border-top:1px solid #36383b;padding:14px}.sitelabel{border:1px solid #3b3d40;padding:10px 9px;display:flex;align-items:center;gap:9px;color:#e8e8ea}.sitelabel svg{width:15px;height:15px}.sitelabel b{font-size:11px}.sitelabel small{display:block;font-size:10px;color:#8e9296;margin-top:4px}.side-footer{display:flex;align-items:center;justify-content:space-between;margin-top:13px}.side-footer button{border:0;background:none;color:#a2a4a8;padding:7px}.side-footer button:hover{color:white}.sidebar .mini-brand{display:none} +.narrow .brand{padding:15px;justify-content:center}.narrow .brand-copy,.narrow .nav-title,.narrow .nav-item span,.narrow .sitelabel,.narrow .side-footer .hide-when-narrow{display:none}.narrow .nav-item{justify-content:center;padding:0}.narrow .sidebar-nav{padding:12px 5px}.narrow .sidebar-bottom{padding:10px 0}.narrow .side-footer{justify-content:center}.narrow .brand-logo{width:33px;height:33px} +.main{min-width:0;min-height:100vh;display:flex;flex-direction:column}.topbar{height:62px;border-bottom:1px solid var(--stroke);display:flex;align-items:center;padding:0 34px;gap:12px;background:var(--paper);flex:none}.crumb{display:flex;align-items:center;gap:10px;color:var(--secondary);font-size:11px;white-space:nowrap;min-width:0}.crumb strong{color:var(--ink);font-weight:620}.cmd{border:1px solid var(--stroke);background:transparent;color:var(--secondary);height:32px;min-width:230px;text-align:left;display:flex;align-items:center;gap:10px;padding:0 10px;white-space:nowrap}.cmd kbd{margin-left:auto;font-size:10px;color:var(--secondary);border:1px solid var(--stroke);padding:2px 5px}.cmd svg{width:14px;height:14px}.header-spacer{flex:1}.live-pip{display:flex;align-items:center;gap:8px;font-size:11px;font-weight:650;white-space:nowrap;color:var(--secondary)}.live-pip:before{content:"";width:7px;height:7px;border-radius:50%;background:var(--good)}.header-btn{display:grid;place-items:center;background:none;border:1px solid transparent;color:var(--secondary);width:32px;height:32px}.header-btn:hover{border-color:var(--stroke);color:var(--ink)}.header-btn svg{width:17px;height:17px}.user-chip{background:var(--ink);color:var(--paper);border:0;width:28px;height:28px;border-radius:50%;font-size:10px;font-weight:800}.workspace{flex:1;min-width:0}.content{width:100%;padding:35px 34px 60px}.kicker{font:700 10px/1.2 ui-monospace,SFMono-Regular,Consolas,monospace;text-transform:uppercase;letter-spacing:.095em;color:var(--secondary)}.headline{display:flex;justify-content:space-between;align-items:end;gap:16px;padding-bottom:25px}.headline h2{font-size:38px;line-height:1.1;font-weight:620;letter-spacing:-.06em;margin:12px 0 9px}.headline p{margin:0;color:var(--secondary);font-size:12px;line-height:1.5}.head-actions{display:flex;gap:8px;align-items:center}.btn{height:34px;border:1px solid var(--stroke);background:transparent;color:var(--ink);display:inline-flex;align-items:center;justify-content:center;gap:7px;padding:0 13px;white-space:nowrap;font-weight:600;font-size:11px}.btn:hover{background:var(--paper3)}.btn.primary{color:var(--paper);background:var(--ink);border-color:var(--ink)}.btn.primary:hover{filter:contrast(.78)}.btn.ghost{border:0}.btn.small{height:28px;padding:0 9px;font-size:10px}.btn svg{width:14px;height:14px}.btn.danger{border-color:var(--error);color:var(--error)}.mono{font-family:ui-monospace,SFMono-Regular,Consolas,monospace}.muted{color:var(--secondary)}.label{color:var(--secondary);text-transform:uppercase;font-size:9px;font-weight:730;letter-spacing:.1em}.label + .label{margin-top:4px}.status{display:inline-flex;align-items:center;gap:6px;font-size:10px;font-weight:600;padding:4px 7px;white-space:nowrap}.status:before{content:"";width:5px;height:5px;border-radius:50%;background:currentColor}.status.live{background:var(--goodbg);color:var(--good)}.status.draft{background:var(--paper3);color:var(--secondary)}.status.changed{background:var(--accent2);color:var(--accent)}.status.error{background:var(--errorbg);color:var(--error)}.status.warn{background:var(--warnbg);color:var(--warn)} +/* Signature Antirion-inspired design move: full-bleed ruled sections instead of cards. */ +.rule{border-top:1px solid var(--stroke)}.ribbon{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));border-top:1px solid var(--stroke);border-bottom:1px solid var(--stroke);min-height:92px;margin-bottom:28px}.ribbon-item{padding:17px 18px;border-right:1px solid var(--stroke);min-width:0}.ribbon-item:first-child{padding-left:0}.ribbon-item:last-child{border-right:0}.ribbon-item .number{font-size:30px;letter-spacing:-.055em;font-weight:650;line-height:1.15;margin:8px 0 0}.ribbon-item .sub{font-size:10px;color:var(--secondary);margin-top:4px}.ribbon-item .number small{font-size:12px;font-weight:550;color:var(--secondary)} +.section-title{display:flex;justify-content:space-between;align-items:center;gap:10px;padding:13px 0;border-bottom:1px solid var(--stroke)}.section-title h3{font-size:13px;margin:0;font-weight:700;letter-spacing:-.01em}.section-title p{font-size:10px;margin:3px 0 0;color:var(--secondary)}.section-grid{display:grid;grid-template-columns:minmax(0,1.5fr) minmax(290px,.75fr);gap:32px}.section-grid > *{min-width:0}.activity{display:flex;align-items:center;gap:12px;border-bottom:1px solid var(--stroke2);padding:12px 0;text-align:left;width:100%;background:none;color:inherit;border-left:0;border-right:0;border-top:0}.activity:hover{background:var(--paper2)}.activity .activity-symbol{flex:none;background:var(--paper3);display:grid;place-items:center;width:30px;height:30px;color:var(--ink)}.activity .activity-symbol svg{width:15px;height:15px}.activity b{font-size:11px;font-weight:650}.activity small{display:block;margin-top:4px;color:var(--secondary);font-size:10px}.activity time{margin-left:auto;color:var(--secondary);font-family:monospace;font-size:10px;white-space:nowrap}.overview-stage{display:grid;grid-template-columns:minmax(0,1.2fr) minmax(300px,.8fr);border-top:1px solid var(--stroke);border-bottom:1px solid var(--stroke);margin-bottom:30px}.overview-lead{padding:27px 25px 29px 0}.overview-lead .giant{font-size:clamp(40px,5vw,77px);font-weight:640;line-height:1.05;letter-spacing:-.085em;margin:18px 0 16px}.overview-lead .giant em{font-style:normal;color:var(--secondary)}.overview-lead p{font-size:12px;color:var(--secondary);max-width:470px;line-height:1.65}.overview-live{border-left:1px solid var(--stroke);padding:25px 0 25px 28px;display:flex;flex-direction:column;justify-content:space-between;gap:20px}.overview-live .buildid{font-size:21px;letter-spacing:-.05em;margin:12px 0 6px}.overview-live .meta{font-size:11px;line-height:1.7;color:var(--secondary)}.overview-live button{align-self:flex-start} +.toolbar{display:flex;gap:8px;align-items:center;margin-bottom:14px;min-width:0}.search{display:flex;align-items:center;gap:9px;border:1px solid var(--stroke);height:35px;flex:1;min-width:0;padding:0 11px;background:var(--paper)}.search svg{width:14px;height:14px;flex:none;color:var(--secondary)}.search input{background:none;border:0;outline:none;color:var(--ink);min-width:0;width:100%;font-size:11px}.search input:focus{outline:0}.select{height:35px;background:var(--paper);border:1px solid var(--stroke);color:var(--ink);padding:0 10px;font-size:11px;min-width:140px}.tabs{display:flex;border-bottom:1px solid var(--stroke);gap:23px;white-space:nowrap;overflow-x:auto;scrollbar-width:none}.tabs button{border:0;background:transparent;padding:12px 0;color:var(--secondary);font-size:11px;position:relative}.tabs button[aria-selected="true"]{color:var(--ink);font-weight:710}.tabs button[aria-selected="true"]:after{content:"";position:absolute;bottom:0;left:0;right:0;height:2px;background:var(--ink)}.tabs .num{font-family:monospace;font-size:10px;color:var(--dim);margin-left:5px} +.workbench{display:grid;grid-template-columns:minmax(0,1fr) 325px;gap:27px;min-width:0}.workbench > *{min-width:0}.data-table{border-collapse:collapse;width:100%;table-layout:fixed}.data-table th{text-align:left;font-size:9px;letter-spacing:.075em;color:var(--secondary);text-transform:uppercase;font-weight:700;border-bottom:1px solid var(--stroke);padding:13px 11px}.data-table td{font-size:11px;padding:11px;border-bottom:1px solid var(--stroke2);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.data-table tr{transition:background .08s}.data-table tbody tr{cursor:pointer}.data-table tbody tr:hover{background:var(--paper2)}.data-table tbody tr.selected{background:var(--accent2)}.data-table tbody tr.selected td:first-child{box-shadow:inset 3px 0 var(--accent)}.data-table td .name{display:flex;align-items:center;gap:10px;min-width:0}.name .file{display:grid;place-items:center;width:27px;height:31px;background:var(--paper3);color:var(--secondary);flex:none}.name .file svg{width:14px;height:14px}.name .labelname{min-width:0}.name b{display:block;font-weight:660;overflow:hidden;text-overflow:ellipsis}.name small{display:block;font-size:10px;color:var(--secondary);margin-top:4px;overflow:hidden;text-overflow:ellipsis}.table-foot{display:flex;justify-content:space-between;gap:10px;align-items:center;font-size:10px;color:var(--secondary);padding:13px 11px}.table-foot span:last-child{cursor:default} +.inspector{border-left:1px solid var(--stroke);padding-left:26px;min-width:0}.inspect-heading{display:flex;align-items:start;justify-content:space-between;gap:8px;padding:12px 0 18px}.inspect-heading h3{font-size:18px;font-weight:680;margin:5px 0;letter-spacing:-.04em}.preview{border:1px solid var(--stroke);padding:9px;background:var(--paper2)}.browser{background:var(--site);color:var(--siteink);height:175px;overflow:hidden}.browserbar{height:21px;background:#e2e1db;border-bottom:1px solid #d4d2cb;display:flex;align-items:center;gap:3px;padding:0 9px}.browserbar i{width:4px;height:4px;border-radius:100%;background:#b0aea6}.browserbar span{font-size:8px;color:#928f87;margin-left:auto}.sitehero{padding:17px 14px}.sitehero .site-header{font-size:7px;letter-spacing:.08em;font-weight:800;border-bottom:1px solid #c5c4bd;padding-bottom:9px;margin-bottom:20px}.sitehero h3{font-size:19px;letter-spacing:-.06em;line-height:1.03;max-width:190px;margin:0 0 8px}.sitehero p{font-size:8px;max-width:210px;color:#777671}.device-toggle{display:flex;border-bottom:1px solid var(--stroke);padding:10px 0;gap:8px}.device-toggle button{flex:1;border:0;background:transparent;color:var(--secondary);padding:6px;font-size:10px}.device-toggle button.active{background:var(--ink);color:var(--paper)}.inspector dl{margin:0}.inspector .kv{display:grid;grid-template-columns:95px minmax(0,1fr);gap:10px;border-bottom:1px solid var(--stroke2);padding:11px 0;font-size:10px}.kv dt{color:var(--secondary)}.kv dd{margin:0;min-width:0;overflow-wrap:anywhere}.inspector-actions{display:flex;gap:7px;padding:17px 0}.inspector-actions .btn{flex:1}.note{background:var(--paper2);border-left:2px solid var(--stroke);padding:11px 12px;color:var(--secondary);font-size:10px;line-height:1.5}.empty{padding:50px 20px;text-align:center;color:var(--secondary);font-size:12px}.empty h3{color:var(--ink);font-size:15px}.empty .btn{margin-top:10px} +.collection-row{display:grid;grid-template-columns:1.2fr 1.2fr .6fr .6fr 30px;align-items:center;gap:10px;border-bottom:1px solid var(--stroke2);padding:15px 12px;cursor:pointer}.collection-row:hover,.collection-row.selected{background:var(--accent2)}.collection-row .collection-name{font-weight:690;font-size:12px}.collection-row .collection-desc{color:var(--secondary);font-size:11px}.collection-row svg{width:14px;height:14px}.collection-row .mono{font-size:11px}.collections-split{display:grid;grid-template-columns:minmax(0,1.3fr) minmax(0,.7fr);gap:33px}.entries-list{margin:0}.entry{width:100%;display:flex;text-align:left;gap:12px;align-items:center;padding:13px 0;border:0;border-bottom:1px solid var(--stroke2);background:transparent;color:var(--ink)}.entry:hover{background:var(--paper2)}.entry b{font-size:11px}.entry small{display:block;margin-top:4px;color:var(--secondary);font-size:10px}.entry .status{margin-left:auto}.leadbar{display:flex;gap:12px;padding:16px 0;border-top:1px solid var(--stroke);border-bottom:1px solid var(--stroke);align-items:center}.leadbar strong{font-size:12px}.leadbar small{font-size:10px;color:var(--secondary);display:block;margin-top:4px}.leadbar .status{margin-left:auto}.release-stages{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));border-bottom:1px solid var(--stroke);margin:15px 0 28px}.stage{padding:25px 23px 25px 0;border-right:1px solid var(--stroke);margin-right:23px}.stage:last-child{border:0;margin-right:0}.stage .step-index{font-size:10px;font-family:monospace;color:var(--secondary)}.stage h3{font-size:18px;letter-spacing:-.035em;margin:14px 0 10px}.stage p{font-size:11px;color:var(--secondary);line-height:1.5;min-height:34px}.release-line{display:grid;grid-template-columns:130px minmax(0,1fr) 100px 76px;gap:12px;align-items:center;border-bottom:1px solid var(--stroke2);padding:13px 0;font-size:11px}.release-line > span{min-width:0;overflow:hidden;text-overflow:ellipsis}.release-line button{justify-self:end}.checks{padding:13px 0;border-bottom:1px solid var(--stroke2);display:flex;align-items:center;gap:12px}.checks .check-icon{width:27px;height:27px;display:grid;place-items:center;background:var(--paper3)}.checks svg{width:14px;height:14px}.checks b{font-size:11px}.checks small{display:block;margin-top:4px;font-size:10px;color:var(--secondary)}.checks .status{margin-left:auto} +.dialog-backdrop{position:fixed;inset:0;z-index:100;background:rgba(10,10,14,.58);display:grid;place-items:center;padding:16px}.dialog{width:min(510px,100%);background:var(--paper);color:var(--ink);border:1px solid var(--stroke);box-shadow:0 20px 70px rgba(0,0,0,.18);max-height:min(90vh,840px);display:flex;flex-direction:column;overflow:auto}.dialog header{display:flex;align-items:start;justify-content:space-between;border-bottom:1px solid var(--stroke);padding:20px}.dialog h3{margin:0;font-size:20px;letter-spacing:-.05em}.dialog header p{color:var(--secondary);font-size:11px;margin:6px 0 0}.dialog .dialog-body{padding:19px 20px}.dialog .dialog-actions{display:flex;justify-content:end;gap:8px;padding:15px 20px;border-top:1px solid var(--stroke)}.field{display:block;margin-bottom:14px;font-size:11px;font-weight:650}.field input,.field select{width:100%;height:36px;border:1px solid var(--stroke);background:var(--paper);color:var(--ink);padding:0 9px;margin-top:7px;font-size:11px}.field small{font-weight:400;color:var(--secondary)}.toast{position:fixed;right:25px;bottom:25px;z-index:200;background:var(--ink);color:var(--paper);border:1px solid var(--stroke);padding:13px 16px;max-width:340px;font-size:11px;box-shadow:0 6px 30px #0002}.command-pop{width:min(570px,100%)}.cmd-list button{width:100%;display:flex;gap:12px;align-items:center;text-align:left;height:39px;background:none;border:0;border-bottom:1px solid var(--stroke2);color:var(--ink);padding:0 7px;font-size:11px}.cmd-list button:hover{background:var(--paper3)}.cmd-list button small{color:var(--secondary);margin-left:auto}.subtle{color:var(--secondary)}.mobile-only{display:none}.cover{display:none}.mobile-menu{display:none}.copyline{display:flex;justify-content:space-between;align-items:center;gap:10px;border-bottom:1px solid var(--stroke2);padding:10px 0;font-size:11px} +@media(max-width:1250px){.content{padding:27px 25px 50px}.topbar{padding:0 25px}.workbench{grid-template-columns:minmax(0,1fr) 285px;gap:20px}.inspector{padding-left:20px}.data-table th,.data-table td{padding-left:8px;padding-right:8px}} +@media(max-width:1050px){.app{grid-template-columns:66px minmax(0,1fr)}.sidebar .brand-copy,.sidebar .nav-title,.sidebar .nav-item span,.sidebar .sitelabel,.sidebar .side-footer .hide-when-narrow{display:none}.sidebar .brand{padding:15px;justify-content:center}.sidebar .brand-logo{width:33px;height:33px}.sidebar .nav-item{justify-content:center;padding:0}.sidebar .sidebar-nav{padding:12px 5px}.sidebar .sidebar-bottom{padding:10px 0}.sidebar .side-footer{justify-content:center}.app.narrow{grid-template-columns:222px minmax(0,1fr)}.app.narrow .sidebar .brand-copy,.app.narrow .sidebar .nav-title,.app.narrow .sidebar .nav-item span,.app.narrow .sidebar .sitelabel,.app.narrow .sidebar .side-footer .hide-when-narrow{display:block}.app.narrow .sidebar .brand{justify-content:start}.app.narrow .sidebar .sidebar-nav{padding:0 8px}.app.narrow .sidebar .nav-item{justify-content:start;padding:0 12px}.workbench{grid-template-columns:minmax(0,1fr)}.inspector{border-left:0;border-top:1px solid var(--stroke);padding:18px 0 0;display:grid;grid-template-columns:220px minmax(0,1fr);gap:0 20px}.inspect-heading{grid-column:1/-1}.inspector .inspect-details{min-width:0}.inspector-actions{grid-column:1/-1}.inspector .note{grid-column:1/-1}} +@media(max-width:760px){.app,.app.narrow{display:block}.sidebar,.app.narrow .sidebar{width:250px;position:fixed;inset:0 auto 0 0;transform:translateX(-102%);transition:transform .16s;box-shadow:15px 0 50px #0004}.sidebar.open{transform:translateX(0)}.sidebar .brand-copy,.sidebar .nav-title,.sidebar .nav-item span,.sidebar .sitelabel,.sidebar .side-footer .hide-when-narrow,.app.narrow .sidebar .brand-copy,.app.narrow .sidebar .nav-title,.app.narrow .sidebar .nav-item span,.app.narrow .sidebar .sitelabel,.app.narrow .sidebar .side-footer .hide-when-narrow{display:block}.sidebar .brand,.app.narrow .sidebar .brand{justify-content:start;padding:22px 17px}.sidebar .sidebar-nav,.app.narrow .sidebar .sidebar-nav{padding:0 8px}.sidebar .nav-item,.app.narrow .sidebar .nav-item{justify-content:start;padding:0 12px}.sidebar .sidebar-bottom{padding:14px}.cover.show{display:block;position:fixed;inset:0;z-index:39;background:#0007}.mobile-menu{display:grid}.topbar{height:53px;padding:0 16px}.crumb{font-size:10px}.cmd{margin-left:auto;min-width:0;width:32px;padding:0;justify-content:center;border:0}.cmd span,.cmd kbd{display:none}.header-spacer{display:none}.content{padding:22px 16px 42px}.headline{align-items:start}.headline h2{font-size:31px}.head-actions{gap:4px}.head-actions .btn{padding:0 9px}.ribbon{grid-template-columns:repeat(2,minmax(0,1fr))}.ribbon-item:nth-child(2){border-right:0}.ribbon-item:nth-child(-n+2){border-bottom:1px solid var(--stroke)}.ribbon-item:nth-child(3){padding-left:0}.ribbon-item .number{font-size:24px}.overview-stage,.section-grid,.collections-split{grid-template-columns:minmax(0,1fr)}.overview-live{border-left:0;border-top:1px solid var(--stroke);padding:20px 0}.overview-lead{padding:20px 0}.overview-lead .giant{font-size:47px}.section-grid{gap:24px}.toolbar{flex-wrap:wrap}.toolbar .search{flex-basis:100%}.toolbar .select{flex:1}.workbench{display:block}.inspector{display:block;margin-top:20px}.inspector .preview{max-width:360px}.release-stages{display:block}.stage{border-right:0;border-bottom:1px solid var(--stroke);margin-right:0;padding:17px 0}.stage:last-child{border:0}.stage p{min-height:0}.release-line{grid-template-columns:90px minmax(0,1fr) 70px}.release-line .datecell{display:none}.mobile-hide{display:none}.collection-row{grid-template-columns:1.3fr .7fr .4fr 25px}.collection-desc{display:none}.inspector .kv{grid-template-columns:110px minmax(0,1fr)}} +@media(max-width:420px){.headline{display:block}.headline .head-actions{margin-top:18px}.headline .btn{min-width:0}.topbar{gap:7px}.topbar .live-pip{font-size:0}.topbar .live-pip:before{width:7px;height:7px}.table-foot span:last-child{display:none}.data-table th,.data-table td{font-size:10px;padding:10px 5px}.data-table .col-layout,.data-table .col-updates{display:none}.data-table col.col-name{width:56%}.data-table col.col-url{width:25%}.data-table col.col-status{width:19%}.data-table .name .file{display:none}.data-table .name b{font-size:10px}.data-table .name small{font-size:8px}.status{font-size:9px;padding:3px 4px}.ribbon-item{padding:14px 10px}.cmd{width:25px}.header-btn{width:24px}.crumb span:first-child{display:none}} +/* Icon geometry is explicitly bounded; standalone inline SVG must never expand its flex/grid cell. */ +.app svg, .dialog svg {width:16px;height:16px;flex:0 0 16px;vertical-align:middle} +.btn svg,.header-btn svg,.cmd svg,.activity svg,.table-foot svg,.device-toggle svg {width:14px;height:14px;flex-basis:14px} +.device-toggle svg{margin-right:4px} +.table-foot svg{width:12px;height:12px;flex-basis:12px} diff --git a/design/assets/antirion-rework.js b/design/assets/antirion-rework.js new file mode 100644 index 0000000..b97f777 --- /dev/null +++ b/design/assets/antirion-rework.js @@ -0,0 +1,100 @@ +/* Site Engine — concept 04. Local-state UX prototype. No backend, no actual publication. */ +(()=>{'use strict'; +const $=(s,r=document)=>r.querySelector(s), $$=(s,r=document)=>Array.from(r.querySelectorAll(s)); +const esc=s=>String(s??'').replace(/[&<>"']/g,c=>({'&':'&','<':'<','>':'>','"':'"',"'":'''}[c])); +const paths={overview:'M3 3h7v7H3zM14 3h7v7h-7zM3 14h7v7H3zM14 14h7v7h-7z',pages:'M7 3h10l4 4v14H7z M17 3v5h4 M11 13h6 M11 17h6 M3 7v14',content:'M12 2 3 7l9 5 9-5-9-5z M3 12l9 5 9-5 M3 17l9 5 9-5',publish:'M12 3v13m-5-5 5 5 5-5 M4 17v4h16v-4',media:'M3 3h18v18H3z M8 10a2 2 0 1 0 0-4a2 2 0 0 0 0 4z M3 19l7-7 4 4 3-3 4 4',structure:'M9 2h6v5H9z M2 17h6v5H2z M16 17h6v5h-6z M12 7v5 M5 17v-5h14v5',forms:'M4 3h16v18H4z M8 9h8 M8 13h8 M8 17h5',settings:'M4 6h16 M4 12h16 M4 18h16 M9 4v4 M15 10v4 M11 16v4',journal:'M4 3h16v18H4z M9 8h7 M9 12h7 M9 16h7',search:'M11 3a8 8 0 1 0 0 16a8 8 0 0 0 0-16z M17 17l4 4',theme:'M20 14.5A8.5 8.5 0 0 1 9.5 4a8.5 8.5 0 1 0 10.5 10.5z',arrow:'M4 12h16m-6-6 6 6-6 6',chevron:'M9 5l7 7-7 7',plus:'M12 4v16 M4 12h16',file:'M6 2h9l5 5v15H6z M15 2v5h5 M10 13h7 M10 17h7',globe:'M12 2a10 10 0 1 0 0 20a10 10 0 0 0 0-20z M2 12h20 M12 2c-4 4-4 16 0 20 M12 2c4 4 4 16 0 20',clock:'M12 2a10 10 0 1 0 0 20a10 10 0 0 0 0-20z M12 7v6l4 2',menu:'M3 6h18 M3 12h18 M3 18h18',close:'M5 5l14 14 M19 5 5 19',monitor:'M3 4h18v13H3z M8 21h8m-4-4v4',phone:'M7 2h10v20H7z M11 19h2',check:'M4 12l5 5L20 6',alert:'M12 2 2 21h20L12 2z M12 9v5 M12 17v1',copy:'M8 8h13v13H8z M3 3h13v4 M3 3v13h4',trash:'M4 7h16 M8 7V4h8v3 M6 7l1 14h10l1-14 M10 11v7m4-7v7',layers:'M3 7l9-4 9 4-9 5-9-5 M3 13l9 5 9-5',dots:'M4 12h2 M11 12h2 M18 12h2',code:'M8 7l-5 5 5 5 M16 7l5 5-5 5',filter:'M3 4h18l-7 9v7l-4 2v-9L3 4',pause:'M7 4v16 M17 4v16',help:'M9 9a3 3 0 1 1 5 2c-2 1-2 3-2 3 M12 18v1'}; +const ico=(name)=>``; +const PAGES=[ +{id:'home',title:'Главная',url:'/',file:'pages/index.md',layout:'landing',status:'published',changed:true,blocks:7,updated:'10.11 · 15:42',description:'Главная страница студии AI-разработки и автоматизаций.'}, +{id:'services',title:'Услуги',url:'/services/',file:'pages/services/index.md',layout:'default',status:'published',changed:true,blocks:5,updated:'10.11 · 14:18',description:'Коллекция услуг и направления разработки.'}, +{id:'about',title:'О компании',url:'/about/',file:'pages/about.md',layout:'default',status:'published',changed:false,blocks:4,updated:'08.11 · 12:26',description:'Команда, процесс и подход к разработке.'}, +{id:'contacts',title:'Контакты',url:'/contacts/',file:'pages/contacts.md',layout:'default',status:'published',changed:false,blocks:3,updated:'07.11 · 17:01',description:'Контактные данные и форма обратной связи.'}, +{id:'request',title:'Заявка на проект',url:'/request/',file:'pages/request.md',layout:'form-page',status:'draft',changed:true,blocks:3,updated:'10.11 · 11:04',error:'Не задано назначение формы',description:'Получение заявок от будущих клиентов.'}, +{id:'privacy',title:'Политика персональных данных',url:'/privacy/',file:'pages/privacy.md',layout:'legal',status:'published',changed:false,blocks:2,updated:'05.11 · 16:24',description:'Юридические положения и обработка данных.'}, +{id:'thanks',title:'Спасибо за заявку',url:'/thank-you/',file:'pages/thank-you.md',layout:'minimal',status:'draft',changed:false,blocks:2,updated:'04.11 · 10:17',description:'Подтверждение отправленной заявки.'}]; +const COLLS=[{id:'services',title:'Услуги',desc:'Направления студии',enabled:true,entries:[['bots','Telegram-боты','published'],['ai','AI-ассистенты','published'],['automation','Бизнес-автоматизация','draft']]},{id:'scenarios',title:'Сценарии',desc:'Отраслевые решения',enabled:true,entries:[['legal','Для юридических компаний','published'],['real-estate','Для недвижимости','draft'],['services','Для сферы услуг','draft']]},{id:'cases',title:'Кейсы',desc:'Реализованные проекты',enabled:true,entries:[['ai-reception','AI-приёмная для сервиса','published'],['booking','Бот для онлайн-записи','draft']]},{id:'courses',title:'Курсы',desc:'Обучающие программы',enabled:false,entries:[]},{id:'posts',title:'Публикации',desc:'Статьи и обновления',enabled:false,entries:[]}]; +const REL=[{id:'build_00027',date:'09.11 · 18:40',comment:'Главная и услуги',author:'Owner'}, {id:'build_00026',date:'06.11 · 12:15',comment:'Контактная форма',author:'Owner'}, {id:'build_00025',date:'03.11 · 16:52',comment:'Первый публичный релиз',author:'Editor'}]; +const nav=[{title:'WORKSPACE',items:[['overview','Обзор'],['pages','Страницы'],['content','Контент'],['publish','Публикация'],['media','Медиа']]},{title:'CONFIGURATION',items:[['structure','Структура'],['forms','Формы и заявки'],['settings','Настройки'],['journal','Журнал']]}]; +const s={route:new URLSearchParams(location.search).get('section')==='content'?'content':new URLSearchParams(location.search).get('section')==='publish'?'publish':'pages',pages:PAGES.map(x=>({...x})),selected:'home',selectedCollection:'services',selectedEntry:'bots',filter:'all',query:'',layout:'all',device:'desktop',skin:'light',mobile:false,narrow:false,role:'owner',candidate:null,live:'build_00027',notes:[],validation:'idle'}; +const page=()=>s.pages.find(p=>p.id===s.selected)||s.pages[0]; +const filtered=()=>s.pages.filter(p=>(s.filter==='all'||(s.filter==='changed'&&p.changed)||(s.filter==='draft'&&p.status==='draft')||(s.filter==='published'&&p.status==='published'))&&(s.layout==='all'||p.layout===s.layout)&&[p.title,p.url,p.file].some(t=>t.toLowerCase().includes(s.query.toLowerCase()))); +const cnt=()=>s.pages.filter(p=>p.changed).length; +const badge=(label,cls='draft')=>`${esc(label)}`; +const status=p=>p.status==='published'?badge('В каталоге','live'):badge(p.status==='archived'?'Архив':'Черновик','draft'); +const roleCanEdit=()=>s.role!=='reviewer'; +let currentDialog=null,toastTimer; +function sidebar(){ + const list=nav.map(g=>`${g.items.map(([id,n])=>``).join('')}`).join(''); + $('#sidebar').innerHTML=`

Site Engine

CONTROL / CMS

`; + $('#sidebar').classList.toggle('open',s.mobile);$('#app').classList.toggle('narrow',s.narrow);$('#cover').classList.toggle('show',s.mobile); +} +function topbar(){const name=nav.flatMap(n=>n.items).find(x=>x[0]===s.route)?.[1]||'Обзор'; + $('#topbar').innerHTML=`
studio.example/${name}
LIVE ${s.live.replace('build_','r')}`; +} +function head(kicker,title,desc,actions=''){return `
${kicker}

${title}

${desc}

${actions?`
${actions}
`:''}
`;} +function counts(){return `
Страницы
${String(s.pages.length).padStart(2,'0')}
Всего в workspace
Правки
${String(cnt()).padStart(2,'0')}
Отличаются от live
Черновики
${String(s.pages.filter(p=>p.status==='draft').length).padStart(2,'0')}
Пока не готовы
Активный релиз
${s.live.replace('build_','#')}
Неизменяемый снимок
`;} +function overview(){return `${head('01 / CONTROL CENTER','Состояние сайта','Главное о текущем workspace и опубликованной версии.',``)}
STATUS / LIVE SITE
Сайт работает.

Публичная версия доступна. Изменения в рабочей области ещё не опубликованы — текущий релиз остаётся неизменным.

LIVE BUILD
${s.live}
Релиз от 09.11.2026 · 18:40
Владелец: Owner
7 страниц в снимке
${badge('Публичная версия активна','live')}
${counts()}

Последние изменения

Рабочие файлы отличаются от активного релиза

${s.pages.filter(p=>p.changed).map(p=>``).join('')||'
Нет изменений
'}

Проверки

Предварительные состояния • демо

Макеты отображают состояния. Серверной валидации, сборки и реальной публикации пока нет.
`;} +function rows(){let arr=filtered();return arr.map(p=>`${ico('file')}${esc(p.title)}${esc(p.file)}${esc(p.url)}${esc(p.layout)}${status(p)}${p.error?badge('Ошибка','error'):p.changed?badge('Изменено','changed'):'—'}`).join('')||`

Ничего не найдено

Уточните запрос или сбросьте фильтры

`;} +function inspector(){let p=page();if(!p)return '';const ds=s.device==='mobile'?'max-width:155px;margin:auto;min-height:170px;':'';return ``;} +function pages(){return `${head('02 / CONTENT OPERATIONS','Страницы','Управление URL, файловыми страницами и состояниями публикации.',``)}${counts()}
${[['all','Все',s.pages.length],['changed','Изменённые',cnt()],['draft','Черновики',s.pages.filter(p=>p.status==='draft').length],['published','В каталоге',s.pages.filter(p=>p.status==='published').length]].map(([f,t,c])=>``).join('')}
${rows()}
Название / файлURLLayoutСтатусИзменения
${filtered().length} из ${s.pages.length} страницВыберите строку для просмотра свойств ${ico('arrow')}
${inspector()}
`;} +function activeColls(){let stored=null;try{const d=JSON.parse(localStorage.getItem('site-engine-stage4-content-v1')||'null');if(d&&d.version===1&&Array.isArray(d.entries))stored=d.entries;}catch(_){/* localStorage optional */}return COLLS.map(c=>({...c,entries:stored?stored.filter(e=>e.collection===c.id).map(e=>[e.id,e.title||'(без названия)',e.status]):c.entries}));} +function collections(){const allColls=activeColls();const c=allColls.find(c=>c.id===s.selectedCollection)||allColls[0];return `${head('03 / DATA MODEL','Контент','Коллекции и структурированные записи — отдельные сущности Entry.',``)}

Коллекции

collections/*.yaml → content/<collection>/*.md

${allColls.length} collections
Выберите коллекцию
${allColls.map(c=>`
${c.id}${esc(c.title)}${esc(c.desc)}${c.entries.length} записей${c.enabled?badge('Активна','live'):badge('Отключена','draft')}${ico('chevron')}
`).join('')}

Записи / ${c.id}

Список выбранной коллекции

${c.entries.length?c.entries.map(([id,title,status])=>``).join(''):`

Записей пока нет

${c.enabled?'Добавьте первую запись':'Коллекция отключена в демо-настройках'}

`}

Контракт данных

Page ≠ Entry

Collection${c.id}
Schemacollections/${c.id}.yaml
Displaydisplay/${c.id}.yaml
Записей${c.entries.length}
Схемный редактор, связи, превью и режим Эксперт доступны в редакторе записей. Изменения сохраняются только в демо-workspace.
`;} +function publish(){const errs=s.pages.filter(p=>p.error);return `${head('04 / RELEASE PIPELINE','Публикация','Рабочие черновики, кандидат и live-релиз — разные состояния.',``)}
${ico('globe')}
Активный публичный релиз ${s.live}Завершён 09.11.2026 · 18:40 • переключение live в демо не влияет на настоящий сайт
${badge('LIVE / MOCK','live')}
01 / WORKSPACE

Рабочие файлы

${cnt()} страниц изменено после последней публикации.

${badge('Есть изменения','changed')}
02 / CANDIDATE

${s.candidate?s.candidate:'Кандидат'}

${s.candidate?'Подготовленный снимок демо-сайта.':'Создаётся только после успешных проверок.'}

${badge(s.candidate?'Готов к публикации':'Не сформирован',s.candidate?'live':'draft')}
03 / LIVE

${s.live}

Текущий неизменяемый снимок сайта.

${badge('Активный релиз','live')}

Предпубликационные проверки

Валидация демонстрационная; ошибки блокируют кандидата

${s.validation!=='idle'?badge(errs.length?'Проверка: ошибка':'Проверка: OK',errs.length?'error':'live'):''}
${ico('check')}Структура YAML / MarkdownДокументы валидны на уровне демо${badge('OK','live')}
${errs.map(p=>`
${ico('alert')}${esc(p.error)}${esc(p.file)} · props.form${badge('ERROR','error')}
`).join('')||`
${ico('check')}Критические связиБлокирующих ошибок нет${badge('OK','live')}
`}
${ico('alert')}Ссылки и медиа2 предупреждения — не блокируют${badge('WARN','warn')}

Изменения workspace

Отличия от опубликованного снимка

${cnt()} files
${s.pages.filter(p=>p.changed).map(p=>``).join('')||'
Нет изменений
'}
Сохранить черновик ≠ опубликовать. Публикация в прототипе лишь изменяет локальное состояние.

История релизов

${REL.map(r=>`
${r.id}${r.comment}${r.date}
`).join('')}`;} +const OTHER={media:['Медиа','Файлы сайта и точки использования','assets/','Поиск, альтернативный текст и контроль отсутствующих ассетов'],structure:['Структура','Layout, Fragment, Display, Menu','layouts/ · fragments/ · display/','Регионы и ограничения редактирования фрагментов'],forms:['Формы и заявки','Конфигурация форм и журнал отправок','forms/','Версионирование схем и RBAC доступа к заявкам'],settings:['Настройки','Конфигурация сайта, роли и доступы','site.yaml','Токены темы, редиректы и параметры сборки'],journal:['Журнал','История действий и ошибок','SQLite / audit_log','Audit, optimistic concurrency, ошибки сборок']}; +function other(id){let [title,desc,path,detail]=OTHER[id];return `${head('CONFIG / FUTURE WORK',title,desc)}
UI SHELL / ЭТАП 1
${title}.

${detail}. Этот раздел включён в навигацию, но рабочие операции будут добавлены после утверждения визуального каркаса.

PATH / SITE ENGINE
${path}
Только демонстрационный экран. Нет API и серверной записи файлов.
${badge('Запланировано','draft')}
`;} +function content(){const el=$('#content');el.innerHTML=s.route==='overview'?overview():s.route==='pages'?pages():s.route==='content'?collections():s.route==='publish'?publish():other(s.route);} +function render(){document.body.dataset.skin=s.skin;sidebar();topbar();content();} +function go(route){if(['media','structure','forms','settings','journal'].includes(route)){window.location.href='modules-antirion.html?section='+route;return;}s.route=route;s.mobile=false;s.query='';s.layout='all';s.filter='all';render();const ws=$('#workspace');ws.scrollTop=0;scrollTo({top:0,behavior:'instant'});} +function openPage(id){s.selected=id;s.filter='all';s.query='';s.layout='all';s.route='pages';s.mobile=false;render();} +function toast(t){$('#notice')?.remove();let n=document.createElement('div');n.className='toast';n.id='notice';n.textContent=t;document.body.append(n);clearTimeout(toastTimer);toastTimer=setTimeout(()=>n.remove(),3500);} +function dialog(title,subtitle,body,buttons=''){const portal=$('#portal');portal.innerHTML=`
`;currentDialog=title;$('.dialog button, .dialog input')?.focus();} +function close(){ $('#portal').innerHTML='';currentDialog=null; } +function action(a){switch(a){ +case 'mobile':s.mobile=!s.mobile;sidebar();break; +case 'collapse':s.narrow=!s.narrow;sidebar();break; +case 'theme':s.skin=s.skin==='light'?'dark':'light';render();break; +case 'reset':s.filter='all';s.query='';s.layout='all';content();break; +case 'command':command();break; +case 'profile':dialog('Демо-роли','Только UI-симуляция без реальных прав',`
RBAC, CSRF, ACL и серверные ограничения на этом этапе отсутствуют.
`,``);break; +case 'set-role':s.role=$('#role').value;close();render();toast('Демо-роль изменена: '+s.role);break; +case 'new':if(!roleCanEdit())return toast('У роли нет прав на изменение');dialog('Новая страница','Локальная симуляция, без записи файлов',`
Создаст новую страницу в состоянии черновика только в открытом прототипе.
`,``);break; +case 'create':{let t=$('#new-title').value.trim(),slug=$('#new-slug').value.trim().toLowerCase().replace(/\s+/g,'-');if(!t||!/^[a-z0-9-]+$/.test(slug)){toast('Укажите название и slug из латинских букв, цифр или дефисов');return;}if(s.pages.some(p=>p.url==='/'+slug+'/')){toast('Такой URL уже существует');return;}let id='new_'+Date.now();s.pages.unshift({id,title:t,url:'/'+slug+'/',file:'pages/'+slug+'.md',layout:$('#new-layout').value,status:'draft',changed:true,blocks:0,updated:'только что',description:'Новая страница'});s.selected=id;s.candidate=null;close();go('pages');toast('Демо-черновик создан');break;} +case 'edit':if(!roleCanEdit())return toast('Недостаточно прав');window.location.href='builder-antirion.html?page='+encodeURIComponent(s.selected);break; +case 'save':{let v=$('#edit-title').value.trim();if(!v){toast('Название обязательно');return;}Object.assign(page(),{title:v,status:$('#edit-status').value,changed:true,updated:'только что'});s.candidate=null;close();render();toast('Сохранено в workspace, НЕ опубликовано');break;} +case 'details':{const p=page();dialog('Свойства страницы','Маппинг и метаданные',`
Page${esc(p.id)}
File${esc(p.file)}
Layout${esc(p.layout)}
blocks in main${p.blocks}
Workspace${p.changed?'изменён':'без изменений'}
Live${s.live}
${p.error?`
${esc(p.error)}
`:''}`,``);break;} +case 'duplicate':{if(!roleCanEdit())return;let p=page();let id='clone_'+Date.now();let clone={...p,id,title:p.title+' (копия)',url:'/copy-'+id.slice(-5)+'/',file:'pages/copy-'+id.slice(-5)+'.md',status:'draft',changed:true,error:null,updated:'только что'};s.pages.unshift(clone);s.selected=id;s.candidate=null;close();go('pages');toast('Копия создана в демо-workspace');break;} +case 'info':dialog('Pages и Entries','Одинаковые интерфейсы, разные файловые сущности',`
Страницаpages/**/*.md
Записьcontent/<collection>/*.md
Layoutlayouts/*.html
Fragmentfragments/*
Workspace, кандидат релиза и live не совпадают. Настройка Layout и кода Fragment требует отдельной роли developer.
`,``);break; +case 'open-content':window.location.href='content-antirion.html?collection='+encodeURIComponent(s.selectedCollection);break; +case 'schema':window.location.href='content-antirion.html?collection='+encodeURIComponent(s.selectedCollection)+'&tab=schema';break; +case 'new-entry':window.location.href='content-antirion.html?collection='+encodeURIComponent(s.selectedCollection)+'&create=1';break; +case 'check':case 'validate':s.validation='done';go('publish');toast(s.pages.some(p=>p.error)?'Демо-проверка: 1 блокирующая ошибка':'Демо-проверка: критических ошибок нет');break; +case 'candidate':if(s.pages.some(p=>p.error))return toast('Сначала устраните блокирующие ошибки');s.candidate='build_00028';render();toast('Демо-кандидат '+s.candidate+' сформирован');break; +case 'publish':if(!s.candidate)return;dialog('Опубликовать кандидат?','В прототипе публикация меняет только локальный UI',`
Новый build_id${s.candidate}
Текущий live${s.live}
В реальной CMS будет атомарное переключение проверенного build_id. Здесь backend отсутствует, поэтому посетители не увидят никаких изменений.
`,``);break; +case 'confirm-publish':s.live=s.candidate;REL.unshift({id:s.live,date:'10.11 · сейчас',comment:'Демо-публикация черновиков',author:s.role});s.candidate=null;s.pages.forEach(p=>p.changed=false);close();go('publish');toast('Демо-live переключён на '+s.live);break; +case 'repair':dialog('Исправить демо-привязку?','Это только изменение данных в текущем браузере',`
Будет задано условное назначение формы form_contact для pages/request.md. Реальных YAML-файлов не меняем.
`,``);break; +case 'repair-confirm':s.pages.find(p=>p.id==='request').error=null;s.candidate=null;close();go('publish');toast('Демо-связь формы исправлена');break; +case 'history':dialog('История релизов','Фиксированные демо-снимки',`${REL.map(r=>``).join('')}`,``);break; +case 'close':close();break; +}} +function release(id){const r=REL.find(x=>x.id===id);if(!r)return;dialog('Релиз '+r.id,`${r.date} · ${r.author}`,`
ID${r.id}
Комментарий${r.comment}
Статус${badge(s.live===r.id?'LIVE':'Исторический',s.live===r.id?'live':'draft')}
Откат изменит только выбранный live-id в текущем браузере. Черновики workspace останутся без изменений.
`,`${s.live!==r.id?``:''}`);} +function rollback(id){close();dialog('Подтвердить демо-откат',`Выбран ${id}`,`
Реального переключения файлов или удаления workspace не будет. В live-области прототипа станет активен ${id}. Текущие черновики не затронуты.
`,``);} +function command(){dialog('Быстрый переход','Раздел или страница',`
`);searchCommand('');$('#cmd-input').focus();} +function searchCommand(q){let e=$('#cmd-results');if(!e)return;let v=q.trim().toLowerCase();let ns=nav.flatMap(g=>g.items).filter(([id,t])=>t.toLowerCase().includes(v)).map(([id,t])=>``);let ps=s.pages.filter(p=>[p.title,p.file,p.url].some(x=>x.toLowerCase().includes(v))).map(p=>``);e.innerHTML=(ns.concat(ps).slice(0,12).join(''))||'
Не найдено
';} +document.addEventListener('click',e=>{let b=e.target.closest('[data-route], [data-page], [data-filter], [data-device], [data-coll], [data-entry], [data-release], [data-rollback], [data-rollback-confirm], [data-action]');if(b){if(b.hasAttribute('data-route')){close();go(b.dataset.route)}else if(b.hasAttribute('data-page')){close();openPage(b.dataset.page)}else if(b.hasAttribute('data-filter')){s.filter=b.dataset.filter;content()}else if(b.hasAttribute('data-device')){s.device=b.dataset.device;content()}else if(b.hasAttribute('data-coll')){s.selectedCollection=b.dataset.coll;content()}else if(b.hasAttribute('data-entry')){window.location.href='content-antirion.html?collection='+encodeURIComponent(s.selectedCollection)+'&entry='+encodeURIComponent(b.dataset.entry);}else if(b.hasAttribute('data-release'))release(b.dataset.release);else if(b.hasAttribute('data-rollback'))rollback(b.dataset.rollback);else if(b.hasAttribute('data-rollback-confirm')){s.live=b.dataset.rollbackConfirm;close();go('publish');toast('Демо-live откатан на '+s.live)}else action(b.dataset.action)}else if(e.target.id==='cover') {s.mobile=false;sidebar()}else if(e.target.id==='modalback')close();}); +document.addEventListener('input',e=>{if(e.target.id==='pageSearch'){const start=e.target.selectionStart;s.query=e.target.value;const table=$('#pageRows');if(table)table.innerHTML=rows();const f=$('.table-foot span');if(f)f.textContent=`${filtered().length} из ${s.pages.length} страниц`;const tabCounts=$$('.tabs .num');if(tabCounts.length)tabCounts[0].textContent=s.pages.length;try{e.target.setSelectionRange(start,start)}catch(_){};}if(e.target.id==='cmd-input')searchCommand(e.target.value);}); +document.addEventListener('change',e=>{if(e.target.id==='layoutFilter'){s.layout=e.target.value;content()}}); +document.addEventListener('keydown',e=>{if((e.ctrlKey||e.metaKey)&&e.key.toLowerCase()==='k'){e.preventDefault();command()}if(e.key==='Escape'&¤tDialog){close()}if(e.key==='Enter'&&e.target.matches('tbody tr[data-page]'))openPage(e.target.dataset.page)}); +window.addEventListener('beforeunload',e=>{if(s.pages.some(p=>p.id.startsWith('new_')||p.id.startsWith('clone_'))) {e.preventDefault();e.returnValue='';}}); +// initial view: pages to emphasize obvious visual difference from concept 03 +render(); + +if(['media','structure','forms','settings','journal'].includes(new URLSearchParams(location.search).get('section')))window.location.replace('modules-antirion.html?section='+new URLSearchParams(location.search).get('section')); +if(new URLSearchParams(location.search).get('section')==='publish')window.location.replace('publication-antirion.html'); +// Stage 5: publication is a dedicated first-class workflow, shared across admin and editors. +document.addEventListener('click',event=>{ + const link=event.target.closest('[data-route="publish"], [data-action="check"], [data-action="validate"], [data-action="publish"], [data-action="history"]'); + if(!link)return;event.preventDefault();event.stopImmediatePropagation(); + const tab=link.dataset.action==='check'||link.dataset.action==='validate'?'?tab=checks':link.dataset.action==='history'?'?tab=history':''; + window.location.href='publication-antirion.html'+tab; +},true); +})(); diff --git a/design/assets/antirion.css b/design/assets/antirion.css new file mode 100644 index 0000000..e1e9b1f --- /dev/null +++ b/design/assets/antirion.css @@ -0,0 +1,143 @@ +/* Site Engine / 03 · Antirion-inspired visual treatment. + Independent original CSS. Design cues: antirion.ai official console screenshots + (flat surfaces, dense tables, teal functional accent, hairline separators). + Retains the exact Stage 1 IA and client-side behaviors. */ +body.theme-antirion[data-theme="dark"] { + color-scheme:dark; + --bg:#111415; --sidebar:#151819; --panel:#141718; --panel2:#191d1e; + --raised:#202526; --hover:#1c2525; --line:#2a3031; --line-soft:#252b2c; + --text:#e8ebeb; --text-2:#a9b0b1; --muted:#778182; + --accent:#00c5c1; --accent-ink:#021a1a; --accent-bg:#103536; + --tag:#222829; --good:#21c6b8; --warn:#e4b35c; --bad:#ee786f; + --blue:#89b7c6; --shadow:rgba(0,0,0,.44); --selected:#113d3d; + --input:#101314; --header:#131617; --site-surface:#f4f1e9; --site-ink:#20251f; +} +body.theme-antirion[data-theme="light"] { + color-scheme:light; + --bg:#f5f7f6; --sidebar:#eef2f0; --panel:#fff; --panel2:#f7f9f8; + --raised:#e8eeee; --hover:#e6f0ef; --line:#dbe2e1; --line-soft:#e5eae8; + --text:#1b2b2d; --text-2:#526467; --muted:#748385; + --accent:#008f8b; --accent-ink:#fff; --accent-bg:#e2f5f2; + --tag:#edf2f0; --good:#008b80; --warn:#a87920; --bad:#b34a4b; + --blue:#477e90; --shadow:rgba(6,30,32,.12); --selected:#e3f3f0; + --input:#fff; --header:#f9fbfa; --site-surface:#f4f1e9; --site-ink:#20251f; +} +body.theme-antirion {font-size:12px; line-height:1.42;letter-spacing:.003em} +body.theme-antirion .app{grid-template-columns:207px minmax(0,1fr)} +body.theme-antirion .app.collapsed{grid-template-columns:56px minmax(0,1fr)} +body.theme-antirion .sidebar{background:var(--sidebar)} +body.theme-antirion .brand-area{height:57px;padding:11px 13px 10px;border-bottom:1px solid var(--line)} +body.theme-antirion .brand-mark{height:26px;width:26px;border-radius:1px;font-size:13px;letter-spacing:-.12em} +body.theme-antirion .brand-name{font-size:12px;letter-spacing:-.025em} +body.theme-antirion .brand-sub{font-size:9px;letter-spacing:.075em} +body.theme-antirion .sidebar-inner{padding:9px 8px 14px} +body.theme-antirion .nav-heading{font-size:9px;letter-spacing:.075em;padding:13px 9px 6px;font-weight:650;color:var(--muted)} +body.theme-antirion .nav-group+.nav-group{margin-top:16px} +body.theme-antirion .nav-button{min-height:31px;padding:6px 9px;gap:9px;border-radius:2px;font-size:11.5px;margin:0} +body.theme-antirion .nav-button .ico{width:14px;height:14px} +body.theme-antirion .nav-button.active{background:var(--selected);color:var(--text);font-weight:640} +body.theme-antirion .nav-button.active:before{width:2px;height:100%;left:-8px;top:0;border-radius:0} +body.theme-antirion .nav-count{border:0;background:transparent;font-size:10px} +body.theme-antirion .sidebar-bottom{padding:9px 9px 10px} +body.theme-antirion .site-chip{padding:7px 8px;border-color:var(--line-soft);background:transparent;border-radius:2px} +body.theme-antirion .site-chip .site-avatar{border-radius:2px;width:21px;height:21px} +body.theme-antirion .site-chip strong{font-size:10px} +body.theme-antirion .site-chip small{font-size:10px} +body.theme-antirion .topbar{height:45px;gap:11px;padding:0 19px} +body.theme-antirion .top-breadcrumb{font-size:11px;gap:7px} +body.theme-antirion .cmd-search{width:245px;height:27px;border-radius:2px;background:var(--input);font-size:11px} +body.theme-antirion .cmd-search .key{border-color:var(--line-soft);border-radius:2px} +body.theme-antirion .tiny-live{font-size:10px} +body.theme-antirion .tiny-live:before{background:var(--accent);box-shadow:0 0 0 2px var(--accent-bg)} +body.theme-antirion .avatar-button{width:27px;height:27px;border-radius:50%;background:#48402f;color:#e9ca83;font-size:10px} +body.theme-antirion .icon-button{height:28px;min-width:28px;border-radius:2px} +body.theme-antirion .page-wrap{max-width:none;padding:25px 25px 35px} +body.theme-antirion .section-head{margin-bottom:19px;gap:10px} +body.theme-antirion .eyebrow{color:var(--muted);letter-spacing:.1em;font-weight:600;margin-bottom:6px;font-size:9.5px} +body.theme-antirion .page-title{font-size:23px;letter-spacing:-.043em;font-weight:640} +body.theme-antirion .page-subtitle{margin-top:6px;font-size:11px} +body.theme-antirion .head-actions{gap:6px} +body.theme-antirion .btn{min-height:28px;padding:5px 10px;border-radius:2px;font-weight:550;font-size:11px;background:transparent} +body.theme-antirion .btn-primary{background:var(--accent);color:var(--accent-ink);border-color:var(--accent);font-weight:670} +body.theme-antirion .btn-primary:hover{background:var(--accent);filter:brightness(1.08)} +body.theme-antirion .btn-sm{min-height:26px;padding:4px 8px} +body.theme-antirion .tag{border-radius:2px;font-size:9.5px;padding:2px 6px;background:transparent;border-color:var(--line-soft)} +body.theme-antirion .tag.green{background:var(--accent-bg);color:var(--good);border-color:transparent} +body.theme-antirion .tag .dot{width:5px;height:5px} +body.theme-antirion .panel{border-radius:0;background:transparent;border-color:var(--line)} +body.theme-antirion .panel-head{padding:11px 13px;border-color:var(--line-soft)} +body.theme-antirion .panel-title{font-size:11.5px;font-weight:650} +body.theme-antirion .panel-sub{font-size:10px} +body.theme-antirion .panel-body{padding:11px 13px} +body.theme-antirion .strip{border-radius:0;border-left:0;border-right:0;background:transparent;padding:12px 4px 13px;gap:12px;margin-bottom:16px} +body.theme-antirion .strip:before{display:none} +body.theme-antirion .strip-symbol{height:28px;width:28px;border-radius:2px} +body.theme-antirion .strip h2{font-weight:640;font-size:13px} +body.theme-antirion .strip p{font-size:10.5px} +body.theme-antirion .strip-details{gap:19px} +body.theme-antirion .strip-details .value{font-size:11px} +body.theme-antirion .metric-row{gap:0;border:1px solid var(--line);margin-bottom:15px} +body.theme-antirion .metric{border:0;border-right:1px solid var(--line);border-radius:0;min-height:98px;padding:13px 15px;background:transparent} +body.theme-antirion .metric:last-child{border-right:0} +body.theme-antirion .metric-label{font-size:10px} +body.theme-antirion .metric-value{font-size:25px;font-weight:650;letter-spacing:-.06em;margin-top:9px} +body.theme-antirion .metric-foot{font-size:9.5px;margin-top:5px} +body.theme-antirion .metric:nth-child(1) .metric-value{color:var(--accent)} +body.theme-antirion .layout-2,.theme-antirion .stack{gap:14px} +body.theme-antirion .list-row{min-height:49px} +body.theme-antirion .list-row .row-symbol{border-radius:1px} +body.theme-antirion .list-row-main strong{font-weight:580} +body.theme-antirion .event+.event{margin-top:0} +body.theme-antirion .note{border-radius:0} +body.theme-antirion .toolbar{gap:7px;margin-bottom:11px} +body.theme-antirion .search-field{height:29px;border-radius:2px;background:var(--input);font-size:11px} +body.theme-antirion .search-field input{font-size:11px} +body.theme-antirion .select{height:29px;border-radius:2px;font-size:10.5px} +body.theme-antirion .tabbar{border-bottom:1px solid var(--line);gap:12px;margin-bottom:14px} +body.theme-antirion .tab{font-size:10.5px;padding:9px 0} +body.theme-antirion .tab.active{color:var(--accent)} +body.theme-antirion .pages-layout{gap:13px} +body.theme-antirion .table-panel{border-radius:0} +body.theme-antirion .data-table th{background:var(--panel);font-size:9.5px;color:var(--muted);text-transform:none;font-weight:600;padding:11px 12px} +body.theme-antirion .data-table td{padding:10px 12px;border-color:var(--line-soft);font-size:10.5px} +body.theme-antirion .data-table tbody tr.selected{background:var(--selected)} +body.theme-antirion .data-table tbody tr.selected td:first-child{box-shadow:inset 2px 0 var(--accent)} +body.theme-antirion .page-cell{gap:8px} +body.theme-antirion .page-cell strong{font-weight:600;font-size:11px} +body.theme-antirion .page-cell small{font-size:9.5px} +body.theme-antirion .file-icon{height:25px;width:25px;border-radius:2px} +body.theme-antirion .table-foot{min-height:33px;padding:8px 12px;font-size:10px} +body.theme-antirion .inspector{background:transparent;border-radius:0} +body.theme-antirion .inspector-top{padding:13px} +body.theme-antirion .inspector-top h3{font-size:12px;font-weight:670} +body.theme-antirion .inspector-sec{padding:12px 13px} +body.theme-antirion .inspector-header{font-size:9.5px} +body.theme-antirion .preview-shell{border-radius:0} +body.theme-antirion .preview-actions button{border-radius:2px;font-size:10px} +body.theme-antirion .preview-actions button.active{color:var(--accent);border-color:var(--accent)} +body.theme-antirion .kv{padding:6px 0} +body.theme-antirion .inspector-actions{padding:12px} +body.theme-antirion .collection-grid{gap:9px} +body.theme-antirion .collection-card{border-radius:0;background:transparent} +body.theme-antirion .collection-card.selected{background:var(--selected)} +body.theme-antirion .pipeline-step,.theme-antirion .feature-main{border-radius:0} +body.theme-antirion .pipeline-step .step-num{border-radius:2px} +body.theme-antirion .release-row,.theme-antirion .check-row{border-color:var(--line-soft)} +body.theme-antirion .footer-line{color:var(--muted);font-size:9.5px;border-color:var(--line)} +body.theme-antirion .modal{border-radius:3px} +body.theme-antirion .text-input{border-radius:2px} +body.theme-antirion .toast{border-radius:2px} +body.theme-antirion .command-dialog{border-radius:3px} +/* Thin accent traces like the reference charts; avoid decorative gradients. */ +body.theme-antirion .metric:after{content:"";position:absolute;left:14px;right:14px;bottom:0;height:1px;background:linear-gradient(90deg,transparent 0%,var(--accent) 62%,transparent 100%);opacity:.13} +body.theme-antirion .metric:first-child:after{opacity:.9} +/* Palette chip in header identifies the additional design concept. */ +body.theme-antirion .brand-mark{background:var(--accent)} +body.theme-antirion .brand-copy .brand-sub{color:var(--muted)} +@media(max-width:1150px){body.theme-antirion .pages-layout{grid-template-columns:minmax(0,1fr)}body.theme-antirion .metric-row{grid-template-columns:repeat(2,minmax(0,1fr))}body.theme-antirion .metric:nth-child(2){border-right:0}body.theme-antirion .metric:nth-child(-n+2){border-bottom:1px solid var(--line)}} +@media(max-width:960px){body.theme-antirion .app,body.theme-antirion .app.collapsed{grid-template-columns:minmax(0,1fr)}body.theme-antirion .sidebar{width:223px}body.theme-antirion .topbar{padding:0 13px}} +@media(max-width:740px){body.theme-antirion .page-wrap{padding:17px 14px 26px}body.theme-antirion .topbar{height:48px}body.theme-antirion .section-head{margin-bottom:13px}body.theme-antirion .metric-row{margin-bottom:12px}body.theme-antirion .metric{min-height:80px;padding:11px}body.theme-antirion .metric-value{font-size:22px}body.theme-antirion .strip{padding:12px 4px}body.theme-antirion .brand-area{height:56px}} +@media(max-width:480px){body.theme-antirion .topbar{padding:0 11px}body.theme-antirion .metric-row{gap:0}body.theme-antirion .page-title{font-size:21px}body.theme-antirion .data-table td{padding:9px 8px}body.theme-antirion .strip-details{padding-left:0}} +/* Neutral illustration inside the sample site preview, not the admin accent. */ +body.theme-antirion .mini-site .mini-orb{background:radial-gradient(circle at 42% 35%,#c6cdd0 0%,#dfdcd3 42%,#e8e2d6 63%,transparent 71%)} +body.theme-antirion .mini-site .mini-nav span:last-child{color:#797c7a} diff --git a/design/assets/builder.css b/design/assets/builder.css new file mode 100644 index 0000000..011a6e3 --- /dev/null +++ b/design/assets/builder.css @@ -0,0 +1,189 @@ +/* Site Engine / Stage 2.1–2.2. Shared layout, two approved visual skins. Vanilla CSS. */ +:root{font-synthesis:none}*{box-sizing:border-box}html,body{margin:0;min-height:100%;font:12px/1.5 Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Arial,sans-serif}button,input,textarea,select{font:inherit}button{cursor:pointer}button:disabled{opacity:.38;cursor:not-allowed}button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible,a:focus-visible{outline:2px solid var(--focus);outline-offset:2px}a{color:inherit;text-decoration:none}svg{width:16px;height:16px;flex:none;stroke:currentColor}button svg{width:15px;height:15px}h1,h2,h3,p{margin:0}body{background:var(--bg);color:var(--text)}body[data-theme="antirion"]{color-scheme:light;--nav:#151719;--navhover:#26282b;--navtext:#bbc0c4;--navborder:#343639;--navactive:#ececf2;--bg:#f5f5f3;--surface:#fff;--surface2:#f0f1ee;--surface3:#e9eae7;--text:#222529;--muted:#72777c;--dim:#94999b;--border:#dcdedb;--border2:#e8e9e5;--accent:#665ad8;--accentSoft:#eeebff;--focus:#8173ed;--accentText:#fff;--positive:#2e856d;--positiveBg:#e6f4eb;--warning:#a8742a;--warningBg:#fff2e1;--danger:#b14e60;--dangerBg:#fae9ef;--previewOuter:#e9e9e5;--shadow:0 10px 30px #21282b12;--radius:3px;--pill:3px}body[data-theme="rose"]{color-scheme:dark;--nav:#060607;--navhover:#1b1b20;--navtext:#a5a4b1;--navborder:#29292f;--navactive:#f7f3f8;--bg:#0a0a0d;--surface:#121216;--surface2:#19191e;--surface3:#222229;--text:#f5f2f7;--muted:#a19da8;--dim:#797581;--border:#2e2c33;--border2:#26242b;--accent:#ff4f99;--accentSoft:#321824;--focus:#ff78b5;--accentText:#fff;--positive:#39d6a0;--positiveBg:#132b22;--warning:#ffc786;--warningBg:#332719;--danger:#ff829e;--dangerBg:#3b1a26;--previewOuter:#19191e;--shadow:0 12px 40px #0004;--radius:11px;--pill:7px} +.layout{display:grid;grid-template-columns:220px minmax(0,1fr);min-height:100vh}.side{position:sticky;top:0;height:100dvh;min-width:0;background:var(--nav);border-right:1px solid var(--navborder);color:var(--navtext);display:flex;flex-direction:column;z-index:12}.side-brand{height:78px;display:flex;align-items:center;gap:11px;padding:16px 15px}.brand-logo{height:38px;width:38px;display:grid;place-items:center;background:#e7e7e5;color:#161718;font-size:19px;font-weight:750;letter-spacing:-.1em;clip-path:polygon(0 0,100% 0,100% 77%,78% 100%,0 100%)}[data-theme="rose"] .brand-logo{clip-path:none;border-radius:12px;background:linear-gradient(138deg,#fa9b5c,#ff4c87 70%,#de318c);color:#fff}.brand-copy b{display:block;color:#f5f5f5;font-size:13px}.brand-copy small{display:block;color:#80818b;margin-top:3px;letter-spacing:.12em;font-size:9px}.side-section{margin:21px 17px 8px;text-transform:uppercase;font-size:9px;letter-spacing:.12em;color:#777b80;font-weight:750}.side-nav{padding:0 8px;flex:1;overflow:auto}.side-link{display:flex;align-items:center;gap:11px;min-height:37px;padding:0 11px;color:var(--navtext);margin:2px 0;position:relative;white-space:nowrap}.side-link:hover{background:var(--navhover);color:#fff}.side-link.active{background:#292a2d;color:#fff;font-weight:700}.side-link.active:before{content:"";position:absolute;inset:0 auto 0 0;width:3px;background:#bcb5ff}[data-theme="rose"] .side-link{border-radius:10px}[data-theme="rose"] .side-link.active{background:#1b1b20}[data-theme="rose"] .side-link.active:before{top:7px;bottom:7px;border-radius:4px;background:var(--accent)}.side-link em{margin-left:auto;font:10px ui-monospace,Consolas,monospace;color:#868993;font-style:normal}.side-bottom{padding:14px;border-top:1px solid var(--navborder)}.side-site{padding:11px;border:1px solid #34383c;display:flex;gap:9px;align-items:center;color:#e8e8e8}.side-site b{font-size:10px}.side-site small{display:block;font-size:10px;color:#9397a0;margin-top:3px}[data-theme="rose"] .side-site{border-radius:11px;background:#121216}.side-footer{display:flex;justify-content:space-between;align-items:center;margin-top:12px;font-size:9px;letter-spacing:.09em;color:#777d83}.side-footer a{padding:5px;color:#b1b3bd}.main{min-width:0;min-height:100vh;display:flex;flex-direction:column}.top{height:60px;display:flex;align-items:center;gap:11px;padding:0 22px;background:var(--surface);border-bottom:1px solid var(--border);flex:none}.breadcrumbs{display:flex;gap:9px;align-items:center;color:var(--muted);font-size:11px;min-width:0;white-space:nowrap}.breadcrumbs strong{color:var(--text)}.breadcrumbs .sep{color:var(--dim)}.spacer{flex:1}.top-live{display:flex;align-items:center;gap:7px;color:var(--muted);font-size:10px;white-space:nowrap}.dot{display:inline-block;background:var(--positive);width:7px;height:7px;border-radius:50%;flex:none}.user-pill{height:29px;width:29px;display:grid;place-items:center;border:0;background:var(--text);color:var(--surface);border-radius:50%;font-size:10px;font-weight:700}[data-theme="rose"] .user-pill{background:linear-gradient(135deg,#f56790,#ac54d9);color:white}.top-icon{border:1px solid transparent;background:transparent;color:var(--muted);height:30px;width:30px;display:grid;place-items:center}.top-icon:hover{border-color:var(--border);background:var(--surface2)}.mobile-menu{display:none}.head{min-width:0;display:flex;align-items:center;gap:15px;justify-content:space-between;padding:18px 22px 16px;border-bottom:1px solid var(--border)}.head-main{min-width:0}.eyebrow{font:700 9px ui-monospace,Consolas,monospace;letter-spacing:.10em;color:var(--accent);text-transform:uppercase}.head h1{font-size:22px;font-weight:690;letter-spacing:-.05em;line-height:1.3;margin:3px 0}.head-meta{font-size:10px;color:var(--muted);display:flex;align-items:center;gap:10px;flex-wrap:wrap}.head-meta code{font-size:10px}.head-actions{display:flex;gap:8px;align-items:center;justify-content:flex-end;flex-wrap:wrap}.button{height:32px;border:1px solid var(--border);border-radius:var(--radius);display:inline-flex;align-items:center;justify-content:center;gap:7px;padding:0 12px;background:var(--surface);color:var(--text);font-size:11px;font-weight:650;white-space:nowrap}.button:hover{background:var(--surface2);border-color:var(--accent)}.button.primary{background:var(--accent);color:var(--accentText);border-color:var(--accent)}.button.primary:hover{filter:brightness(1.09)}.button.ghost{background:transparent}.button.small{height:27px;padding:0 8px;font-size:10px}.button.icon{width:30px;padding:0}.button.danger{color:var(--danger);border-color:var(--danger)}.toggle{display:flex;gap:2px;background:var(--surface2);border:1px solid var(--border);padding:3px;border-radius:var(--radius)}.toggle button{height:27px;border:0;color:var(--muted);background:transparent;padding:0 10px;font-size:10px;white-space:nowrap;border-radius:calc(var(--radius) - 2px)}.toggle button.active{background:var(--surface);color:var(--text);box-shadow:0 1px 5px #0001;font-weight:700}[data-theme="rose"] .toggle button.active{background:#2c202a;color:#ff82b6}.status{font-size:10px;display:inline-flex;align-items:center;gap:6px;padding:3px 7px;background:var(--surface3);color:var(--muted);border-radius:var(--pill);white-space:nowrap;font-weight:650}.status.changed{background:var(--accentSoft);color:var(--accent)}.status.good{background:var(--positiveBg);color:var(--positive)}.status.warn{background:var(--warningBg);color:var(--warning)}.status.error{background:var(--dangerBg);color:var(--danger)}.builder{display:grid;grid-template-columns:252px minmax(0,1fr) 302px;min-height:calc(100dvh - 165px);max-height:calc(100dvh - 165px);min-width:0}.pane{min-width:0;display:flex;flex-direction:column;overflow:hidden;background:var(--surface)}.treepane{border-right:1px solid var(--border)}.stagepane{background:var(--previewOuter)}.inspectpane{border-left:1px solid var(--border)}.pane-head{padding:13px 13px 10px;border-bottom:1px solid var(--border);display:flex;align-items:center;justify-content:space-between;gap:7px;flex:none}.pane-head b{font-size:12px;letter-spacing:-.01em}.pane-head small{font-size:10px;color:var(--muted)}.pane-scroll{overflow:auto;min-height:0;flex:1}.pane-foot{border-top:1px solid var(--border);padding:10px 13px;display:flex;align-items:center;gap:7px;justify-content:space-between;flex:none;color:var(--muted);font-size:10px}.tree-tabs{display:grid;grid-template-columns:1fr 1fr;padding:6px;gap:5px;border-bottom:1px solid var(--border)}.tree-tabs button{padding:8px 5px;border:0;color:var(--muted);background:transparent;font-size:10px;border-radius:var(--radius)}.tree-tabs button.active{background:var(--accentSoft);color:var(--accent);font-weight:720}.tree-group{padding:15px 11px 7px}.tree-caption{color:var(--muted);text-transform:uppercase;letter-spacing:.11em;font-size:9px;font-weight:700;margin:0 5px 8px}.tree-layout{padding:10px;background:var(--surface2);border:1px solid var(--border);display:flex;align-items:center;gap:9px;border-radius:var(--radius);margin-bottom:10px}.tree-layout b{font-size:11px}.tree-layout small{font-size:9px;display:block;color:var(--muted)}.tree-region{display:flex;align-items:center;justify-content:space-between;padding:7px 7px;color:var(--muted);font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.06em}.tree-region .plus{border:0;background:transparent;color:var(--accent);font-size:18px;height:22px;width:24px}.tree-item{width:100%;display:flex;align-items:center;gap:7px;background:transparent;border:1px solid transparent;color:var(--text);padding:9px 7px;text-align:left;min-width:0;position:relative;border-radius:var(--radius);margin:1px 0;cursor:pointer}.tree-item:hover{background:var(--surface2)}.tree-item.selected{border-color:var(--accent);background:var(--accentSoft)}.tree-item .node-icon{display:grid;place-items:center;height:25px;width:25px;flex:none;background:var(--surface3);border-radius:var(--radius);color:var(--muted)}.tree-item.selected .node-icon{color:var(--accent)}.tree-item .node-label{min-width:0;flex:1}.tree-item .node-label b{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-size:10px}.tree-item .node-label small{display:block;color:var(--muted);font:9px ui-monospace,Consolas,monospace;margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.tree-item .node-badges{display:flex;gap:3px}.mini-dot{width:6px;height:6px;background:var(--accent);border-radius:50%;display:inline-block}.tree-item.fixed{opacity:.76}.tree-item.hidden{opacity:.47}.tree-item[draggable="true"]{cursor:grab}.tree-item.drag-over{border:1px dashed var(--accent)}.mapping-card{padding:11px;border-bottom:1px solid var(--border2)}.mapping-card button{width:100%;text-align:left;border:0;background:none;color:var(--text);font-weight:680;padding:2px 0}.mapping-card small{color:var(--muted);font-size:10px;display:block;margin:3px 0 6px}.map-route{display:flex;align-items:center;gap:4px;flex-wrap:wrap;color:var(--muted);font:9px ui-monospace,Consolas,monospace}.map-route span{padding:3px 5px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius)}.mapping-note{font-size:10px;color:var(--muted);padding:12px;line-height:1.6}.stage-toolbar{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:11px 13px;border-bottom:1px solid var(--border);background:var(--surface);flex:none}.stage-toolbar .meta{color:var(--muted);font-size:10px;display:flex;align-items:center;gap:7px}.stage-scroller{flex:1;overflow:auto;padding:22px 20px 40px;display:flex;align-items:start;justify-content:center;min-width:0}.preview-frame{width:100%;max-width:100%;height:720px;border:1px solid var(--border);background:white;box-shadow:var(--shadow);border-radius:var(--radius);display:block;transition:width .18s}.preview-frame.tablet{width:768px}.preview-frame.mobile{width:390px;height:740px}.stage-caption{font:9px ui-monospace,Consolas,monospace;color:var(--muted)}.notice{padding:11px;border-bottom:1px solid var(--border);color:var(--muted);font-size:10px;background:var(--surface2)}.notice strong{color:var(--text)}.panel-tabs{padding:9px 12px;display:flex;gap:5px;border-bottom:1px solid var(--border);flex:none}.panel-tabs button{border:0;background:transparent;color:var(--muted);padding:7px 10px;font-size:10px;border-radius:var(--radius)}.panel-tabs button.active{background:var(--accentSoft);color:var(--accent);font-weight:750}.inspect-scroll{padding:15px 14px 30px;overflow:auto;min-height:0;flex:1}.inspect-title{display:flex;justify-content:space-between;align-items:start;margin-bottom:15px;gap:8px}.inspect-title h3{font-size:15px;letter-spacing:-.025em;line-height:1.35}.inspect-title code{display:block;font-size:10px;color:var(--muted);margin-top:5px;overflow-wrap:anywhere}.field{display:block;margin:0 0 15px}.field > span{display:flex;align-items:center;justify-content:space-between;font-size:10px;color:var(--muted);font-weight:680;margin-bottom:6px}.field input,.field textarea,.field select{width:100%;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);color:var(--text);padding:8px 9px;outline:0;min-width:0}.field input,.field select{height:34px}.field textarea{resize:vertical;min-height:64px;line-height:1.5}.field input:focus,.field select:focus,.field textarea:focus{border-color:var(--focus);box-shadow:0 0 0 2px color-mix(in srgb,var(--accent) 12%,transparent)}.field small{display:block;margin-top:5px;color:var(--dim);font-size:10px;line-height:1.4}.field .inline-source{display:flex;gap:5px}.field .inline-source select{flex:0 0 104px;width:104px;font-size:10px}.field .inline-source input{min-width:0;flex:1}.field input[disabled],.field textarea[disabled]{opacity:.64;cursor:not-allowed}.field input[type="checkbox"]{height:15px;width:15px;accent-color:var(--accent)}.field .checkrow{display:flex;align-items:center;gap:9px;color:var(--text);font-size:11px}.divider{height:1px;background:var(--border);margin:14px 0}.actionrow{display:flex;gap:6px;flex-wrap:wrap;margin:12px 0 5px}.actionrow .button{flex:1}.helper{font-size:10px;color:var(--muted);line-height:1.6}.helper code{color:var(--accent)}.source-line{display:flex;gap:5px;flex-wrap:wrap;margin:7px 0}.source-line span{font:9px ui-monospace,Consolas,monospace;background:var(--surface2);border:1px solid var(--border);padding:5px;border-radius:var(--radius)}.inline-alert{margin:9px 0;padding:10px 11px;background:var(--warningBg);color:var(--warning);font-size:10px;border-left:2px solid currentColor}.inline-alert.error{color:var(--danger);background:var(--dangerBg)}.small-title{font-size:10px;text-transform:uppercase;letter-spacing:.10em;color:var(--muted);font-weight:750;margin:18px 0 9px}.codebox{font:10px/1.7 ui-monospace,Consolas,monospace;white-space:pre-wrap;overflow-wrap:anywhere;padding:12px;background:var(--surface2);border:1px solid var(--border);color:var(--text);border-radius:var(--radius)}.mobilebar{display:none}.modal-back{position:fixed;inset:0;z-index:100;background:#08080bb2;display:flex;align-items:center;justify-content:center;padding:16px}.modal{width:min(560px,100%);max-height:90dvh;overflow:auto;background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);box-shadow:0 28px 80px #0005}.modal-head{padding:18px 19px;border-bottom:1px solid var(--border)}.modal-head h2{font-size:18px;letter-spacing:-.03em}.modal-head p{font-size:11px;color:var(--muted);margin-top:5px}.modal-body{padding:17px 19px;max-height:55dvh;overflow:auto}.modal-foot{border-top:1px solid var(--border);padding:12px 19px;display:flex;justify-content:flex-end;gap:8px;flex-wrap:wrap}.modal .field{margin:0 0 13px}.catalog-search{width:100%;padding:10px;background:var(--surface2);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);margin-bottom:10px}.catalog-list{display:grid;gap:6px}.catalog-item{display:flex;align-items:center;gap:12px;width:100%;background:var(--surface2);border:1px solid var(--border);text-align:left;border-radius:var(--radius);padding:11px;color:var(--text)}.catalog-item:hover{border-color:var(--accent)}.catalog-item b{display:block;font-size:11px}.catalog-item small{font-size:10px;display:block;color:var(--muted);margin-top:2px}.catalog-item svg{color:var(--accent);width:18px;height:18px}.catalog-item span{flex:1}.catalog-group{display:flex;gap:5px;margin-bottom:10px;flex-wrap:wrap}.catalog-group button{font-size:10px;border:1px solid var(--border);background:var(--surface2);color:var(--muted);border-radius:var(--radius);padding:5px 9px}.catalog-group button.active{background:var(--accentSoft);color:var(--accent);border-color:var(--accent)}#toast{position:fixed;right:18px;bottom:17px;z-index:130;background:var(--surface);border:1px solid var(--accent);border-radius:var(--radius);padding:12px 15px;color:var(--text);max-width:360px;box-shadow:var(--shadow);display:none;font-size:11px}.mobile-cover{display:none}.muted{color:var(--muted)}.mono{font-family:ui-monospace,Consolas,monospace}.empty{padding:26px 15px;text-align:center;color:var(--muted);font-size:11px}.empty b{display:block;color:var(--text);margin-bottom:4px} +@media(max-width:1380px){.layout{grid-template-columns:205px minmax(0,1fr)}.builder{grid-template-columns:233px minmax(0,1fr) 283px}.head,.top{padding-left:16px;padding-right:16px}.head h1{font-size:20px}} +@media(max-width:1160px){.layout{grid-template-columns:64px minmax(0,1fr)}.side-brand{justify-content:center;padding:10px}.brand-logo{width:34px;height:34px}.brand-copy,.side-section,.side-link span,.side-link em,.side-bottom .side-site,.side-footer small{display:none}.side-nav{padding:0 6px}.side-link{justify-content:center;padding:0}.side-footer{justify-content:center}.builder{grid-template-columns:226px minmax(0,1fr) 277px}} +@media(max-width:960px){.builder{grid-template-columns:218px minmax(0,1fr);max-height:none;min-height:calc(100vh - 165px);grid-template-areas:"tree stage" "inspect inspect"}.treepane{grid-area:tree;min-height:650px;max-height:820px}.stagepane{grid-area:stage;min-height:650px;max-height:820px}.inspectpane{grid-area:inspect;min-height:0;overflow:visible;max-height:none;border:0;border-top:1px solid var(--border)}.inspect-scroll{max-width:750px;width:100%;padding:15px 20px}.pane-scroll{max-height:760px}.stage-scroller{min-height:0}.preview-frame{height:610px}.head{align-items:flex-start}.head-actions{max-width:400px}.inspectpane .pane-foot{display:none}} +@media(max-width:700px){.layout{display:block}.side{position:fixed;left:0;top:0;bottom:0;width:230px;transform:translateX(-110%);transition:transform .2s;box-shadow:18px 0 55px #0006}.side.open{transform:translateX(0)}.mobile-cover.show{position:fixed;inset:0;background:#0009;display:block;z-index:11}.side .brand-copy,.side .side-section,.side .side-link span,.side .side-link em,.side .side-bottom .side-site,.side .side-footer small{display:block}.side .side-link{justify-content:flex-start;padding:0 11px}.mobile-menu{display:grid}.top{height:49px;padding:0 12px}.head{padding:13px 13px 14px;display:block}.head h1{font-size:21px}.head-actions{margin-top:12px;max-width:none;justify-content:flex-start}.head-actions .button{height:30px}.builder{display:flex;flex-direction:column;max-height:none;min-height:0}.pane{overflow:visible;border-left:0;border-right:0}.stagepane{order:0;min-height:0;max-height:none}.treepane{order:1;min-height:0;max-height:none;border-bottom:1px solid var(--border)}.inspectpane{order:2;min-height:0}.stage-scroller{min-height:0;overflow:auto;padding:14px 14px 20px;display:block}.preview-frame{height:440px;width:100%!important;max-width:100%;margin:auto}.preview-frame.mobile{width:390px!important;max-width:100%;height:480px}.stage-toolbar{flex-wrap:wrap;gap:5px}.treepane .pane-scroll,.inspectpane .pane-scroll,.inspect-scroll{overflow:visible;max-height:none}.tree-group{padding-bottom:15px}.tree-item{padding:12px 9px}.pane-head{padding:13px}.inspect-scroll{max-width:100%}.mobilebar{display:flex;padding:7px 12px;gap:6px;border-bottom:1px solid var(--border);background:var(--surface2)}.mobilebar button{flex:1;min-height:31px;border:1px solid var(--border);background:var(--surface);color:var(--text);border-radius:var(--radius)}.top-live{display:none}.breadcrumbs{overflow:hidden;text-overflow:ellipsis}.breadcrumbs .truncate{display:none}} +@media(max-width:390px){.head-actions .toggle{width:100%}.head-actions .button{flex:1}.stage-toolbar .meta{width:100%}.toggle button{padding:0 7px}.head-meta code{overflow:hidden;text-overflow:ellipsis;max-width:225px}.pane-head b{font-size:11px}} +/* Stage 2.3 — source mapping, data explorer and reverse dependencies. */ +.mapping-metrics{display:flex;gap:5px;flex-wrap:wrap;margin:11px 0} +.mapping-metrics span{display:inline-flex;padding:4px 7px;border:1px solid var(--border);background:var(--surface2);font:10px ui-monospace,Consolas,monospace;color:var(--muted);border-radius:var(--pill)} +.mapping-metrics .has-issues{color:var(--warning);background:var(--warningBg);border-color:color-mix(in srgb,var(--warning) 30%,var(--border))} +.mapping-card{padding:11px 10px 13px;margin:0 5px 7px;border:1px solid var(--border);background:var(--surface);border-radius:var(--radius)} +.mapping-card.map-selected{border-color:var(--accent);background:color-mix(in srgb,var(--accentSoft) 34%,var(--surface))} +.mapping-card .map-block-title{display:flex;align-items:flex-start;gap:7px;text-align:left;color:var(--text);padding-bottom:8px;min-width:0} +.mapping-card .map-block-title > svg{width:14px;height:14px;color:var(--accent);flex:none;margin-top:2px} +.mapping-card .map-block-title span{min-width:0} +.mapping-card .map-block-title b{display:block;overflow-wrap:anywhere} +.mapping-card .map-block-title small{font:9px/1.5 ui-monospace,Consolas,monospace;color:var(--muted);overflow-wrap:anywhere} +.map-edge{display:grid;grid-template-columns:minmax(0,65px) auto minmax(0,1fr) 19px;align-items:center;gap:5px;font-size:10px;padding:7px 0;border-top:1px solid var(--border2)} +.map-edge .mono{color:var(--muted);overflow:hidden;text-overflow:ellipsis} +.map-edge .edge-type{font-size:9px;font-weight:700;color:var(--accent);padding:1px 5px;border-radius:var(--pill);background:var(--accentSoft)} +.map-edge .edge-type.error{color:var(--danger);background:var(--dangerBg)} +.map-edge .edge-value{color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-family:ui-monospace,Consolas,monospace;font-size:9px} +.map-edge button{border:0;background:none;color:var(--accent);padding:0;width:19px;height:20px} +.map-issue{color:var(--danger);font-size:9px;line-height:1.45;display:flex;align-items:start;gap:5px;padding-top:5px;overflow-wrap:anywhere} +.map-issue svg{width:11px;height:11px;flex:none} +.tree-error-dot{display:grid;place-items:center;font-size:9px;font-weight:900;height:16px;width:16px;background:var(--dangerBg);color:var(--danger);border-radius:50%} +.picker-current{display:flex;align-items:center;gap:5px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);padding:5px 5px 5px 9px;min-width:0} +.picker-current .mono{font-size:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;flex:1} +.mini-action{border:1px solid var(--border);background:var(--surface2);border-radius:var(--pill);color:var(--muted);display:inline-flex;align-items:center;justify-content:center;gap:5px;padding:6px 8px;font-size:10px;font-weight:600;min-height:27px;white-space:nowrap} +.mini-action svg{height:12px;width:12px} +.mini-action:hover{color:var(--accent);border-color:var(--accent);background:var(--accentSoft)} +.mini-action.primary-action{background:var(--accentSoft);color:var(--accent);border-color:color-mix(in srgb,var(--accent) 32%,var(--border))} +.tiny-source{display:inline-flex;align-items:center;gap:4px;background:var(--surface2);color:var(--muted);border:1px solid var(--border);border-radius:var(--pill);font-size:9px;max-width:158px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;padding:3px 5px} +.tiny-source.bound{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 33%,var(--border));background:var(--accentSoft)} +.tiny-source svg{width:10px;height:10px} +.field-issue{padding:7px 8px;display:flex;gap:5px;align-items:flex-start;font:10px/1.5 ui-monospace,Consolas,monospace;color:var(--warning);background:var(--warningBg);margin-top:7px;border-left:2px solid currentColor;overflow-wrap:anywhere} +.field-issue svg{width:13px;height:13px;flex:none} +.field-issue.error{color:var(--danger);background:var(--dangerBg)} +.binding-entry{border:1px solid var(--border);background:var(--surface2);border-radius:var(--radius);padding:11px;margin:0 0 10px} +.binding-top,.binding-actions{display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap} +.binding-top b{font-size:11px} +.source-type{font:9px ui-monospace,Consolas,monospace;padding:3px 6px;color:var(--accent);background:var(--accentSoft);border:1px solid var(--border);border-radius:var(--pill)} +.source-type.error{color:var(--danger);background:var(--dangerBg)} +.source-type.warn{color:var(--warning);background:var(--warningBg)} +.binding-key{margin:8px 0;color:var(--muted);font:9px/1.5 ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +.binding-result{color:var(--text);display:flex;align-items:flex-start;gap:7px;font-size:11px;line-height:1.45;overflow-wrap:anywhere;margin:8px 0} +.binding-result svg{color:var(--accent);width:13px;height:13px;flex:none;margin-top:2px} +.binding-actions{justify-content:flex-start;gap:5px;margin-top:10px} +.path-strip{display:flex;align-items:center;gap:3px;flex-wrap:wrap;font:9px ui-monospace,Consolas,monospace;color:var(--muted);padding:9px 7px;background:var(--surface2);border:1px solid var(--border);margin:0 0 16px;border-radius:var(--radius)} +.path-strip span{overflow-wrap:anywhere} +.picker-summary{padding:11px;display:flex;gap:7px;flex-wrap:wrap;align-items:center;border:1px solid var(--border);background:var(--surface2);border-radius:var(--radius);font:10px/1.5 ui-monospace,Consolas,monospace;margin-bottom:12px;overflow-wrap:anywhere} +.picker-summary svg{width:15px;height:15px;color:var(--accent)} +.choice-group{margin:14px 0 18px} +.choice-label{font-size:10px;font-weight:750;color:var(--muted);display:flex;justify-content:space-between;text-transform:uppercase;letter-spacing:.06em;margin:10px 0 7px} +.choice-item{width:100%;display:flex;align-items:center;gap:9px;text-align:left;color:var(--text);background:var(--surface2);border:1px solid var(--border);border-bottom:0;padding:10px;min-width:0} +.choice-item:last-child{border-bottom:1px solid var(--border)} +.choice-item:first-of-type{border-radius:var(--radius) var(--radius) 0 0} +.choice-item:last-child{border-radius:0 0 var(--radius) var(--radius)} +.choice-item:hover{background:var(--accentSoft);border-color:var(--accent)} +.choice-item .choice-glyph{color:var(--accent);display:grid;place-items:center;flex:none;width:19px} +.choice-item .choice-glyph svg{width:15px;height:15px} +.choice-info{min-width:0;flex:1} +.choice-info b{display:block;font-size:11px} +.choice-info small{font-size:9px;color:var(--muted);display:block;overflow-wrap:anywhere} +.choice-flag{border-radius:var(--pill);font-size:9px;color:var(--muted);border:1px solid var(--border);padding:3px 5px;flex:none} +.choice-flag.bad{color:var(--danger);background:var(--dangerBg)} +.choice-flag.warning{color:var(--warning);background:var(--warningBg)} +.usage-summary{display:flex;gap:9px;align-items:center;margin-bottom:13px;overflow-wrap:anywhere} +.usage-summary code{font-size:10px;color:var(--muted);overflow-wrap:anywhere} +.usage-item{display:flex;align-items:center;gap:12px;justify-content:space-between;width:100%;background:var(--surface2);color:var(--text);border:1px solid var(--border);border-bottom:0;text-align:left;padding:10px;border-radius:0} +.usage-item:last-of-type{border-bottom:1px solid var(--border)} +.usage-item:hover{background:var(--accentSoft);color:var(--accent)} +.usage-item span{min-width:0} +.usage-item b{display:block;font-size:11px} +.usage-item small{font:9px ui-monospace,Consolas,monospace;display:block;color:var(--muted);overflow-wrap:anywhere;margin-top:5px} +.library-grid{display:grid;gap:0} +.library-head{font-size:10px;font-weight:800;text-transform:uppercase;letter-spacing:.08em;color:var(--accent);margin:15px 0 4px} +.library-row{display:flex;align-items:center;justify-content:space-between;gap:9px;padding:9px 0;border-bottom:1px solid var(--border2)} +.library-row b{font-size:10px;display:block} +.library-row small{font-size:9px;display:block;color:var(--muted);overflow-wrap:anywhere} +.library-row span{min-width:0} +.library-row .mini-action{flex:none} +@media(max-width:700px){.mapping-card{margin:0 10px 9px}.choice-item{padding:9px}.binding-entry{padding:12px}} +.usage-entry{border:1px solid var(--border);border-bottom:0;background:var(--surface2);padding:9px 10px} +.usage-entry:last-of-type{border-bottom:1px solid var(--border)} +.usage-entry b{display:block;font-size:11px} +.usage-entry small{display:block;margin-top:4px;color:var(--muted);font:9px ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +/* Stage 2.4 — live/workspace clarity, per-field QA, version comparisons. */ +.draft-hint{font:10px ui-monospace,Consolas,monospace;color:var(--muted)} +.head-meta{display:flex;align-items:center;gap:8px;flex-wrap:wrap} +.tag-muted{font:9px ui-monospace,Consolas,monospace;color:var(--dim);text-transform:none;letter-spacing:0;margin-left:auto} +.inspector-callout{font-size:10px;line-height:1.6;padding:10px 11px;background:var(--accentSoft);border-left:2px solid var(--accent);margin-bottom:13px;color:var(--text)} +.serp-preview{margin:10px 0 18px;padding:13px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);font-size:11px;overflow-wrap:anywhere} +.serp-url{color:var(--positive);font-size:10px;margin-bottom:4px} +.serp-title{color:var(--accent);font-size:15px;font-weight:650;line-height:1.35;margin-bottom:5px} +.serp-desc{color:var(--muted);font-size:11px} +.markdown-preview{border:1px solid var(--border);background:var(--surface2);margin-top:10px;border-radius:var(--radius)} +.markdown-preview summary{padding:10px 11px;cursor:pointer;color:var(--text);font-weight:650;font-size:10px} +.markdown-render{padding:10px 12px;border-top:1px solid var(--border);font-size:11px;overflow-wrap:anywhere} +.markdown-render h1{font-size:17px;margin-bottom:7px}.markdown-render h2{font-size:15px;margin-bottom:7px}.markdown-render h3{font-size:13px;margin-bottom:6px}.markdown-render p{margin:7px 0}.markdown-render ul{padding-left:20px}.markdown-render a{color:var(--accent);text-decoration:underline} +.review-dialog,.compare-dialog{width:min(1020px,calc(100vw - 32px));max-width:100%;} +.review-summary{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px;margin-bottom:13px} +.review-count{border:1px solid var(--border);background:var(--surface2);padding:12px;display:flex;flex-direction:column;gap:3px;border-radius:var(--radius)} +.review-count b{font-size:24px;line-height:1.2;letter-spacing:-.04em}.review-count span{font-size:10px;color:var(--muted)} +.review-count:first-child b{color:var(--danger)}.review-count:nth-child(2) b{color:var(--warning)}.review-count:nth-child(3) b{color:var(--accent)} +.review-banner{padding:10px 12px;border-left:3px solid var(--positive);background:var(--positiveBg);font-size:11px;margin:8px 0 13px} +.review-banner.danger{background:var(--dangerBg);border-color:var(--danger)} +.review-filters{display:flex;gap:4px;flex-wrap:wrap;padding:4px;background:var(--surface2);border-radius:var(--radius);margin:12px 0} +.review-filters button{border:1px solid transparent;background:transparent;color:var(--muted);padding:8px 10px;font-size:10px;border-radius:var(--pill);font-weight:650} +.review-filters button.active{background:var(--surface);border-color:var(--border);color:var(--text)} +.review-list{max-height:300px;overflow:auto;border:1px solid var(--border);border-radius:var(--radius)} +.review-item{display:flex;align-items:center;width:100%;text-align:left;gap:10px;background:var(--surface);color:var(--text);padding:12px;border:0;border-bottom:1px solid var(--border2)} +.review-item:last-child{border-bottom:0}.review-item:hover{background:var(--accentSoft)} +.issue-label{font-size:9px;font-weight:800;padding:4px 6px;color:var(--warning);background:var(--warningBg);flex:none} +.review-item.error .issue-label{color:var(--danger);background:var(--dangerBg)} +.review-item span:nth-child(2){flex:1;min-width:0} +.review-item b{font-size:11px;display:block;font-weight:600} +.review-item small{display:block;color:var(--muted);margin-top:5px;font:9px/1.4 ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +.review-item svg{color:var(--accent)} +.compare-meta{display:flex;gap:8px;flex-wrap:wrap;align-items:center;font-size:10px;color:var(--muted)} +.compare-meta span{background:var(--surface2);border:1px solid var(--border);padding:6px 8px} +.compare-meta b{color:var(--text)} +.compare-table{border:1px solid var(--border);border-radius:var(--radius);max-height:350px;overflow:auto} +.compare-label-head,.compare-line{display:grid;grid-template-columns:minmax(100px,.7fr) minmax(0,1fr) minmax(0,1fr);gap:8px;padding:10px;border-bottom:1px solid var(--border2);font-size:10px} +.compare-label-head{background:var(--surface2);color:var(--muted);position:sticky;top:0;z-index:1} +.compare-line:last-child{border-bottom:0}.compare-line code{font:10px ui-monospace,Consolas,monospace;color:var(--accent);overflow-wrap:anywhere}.compare-line span{line-height:1.5;overflow-wrap:anywhere;white-space:pre-wrap}.compare-line span:nth-child(2){color:var(--danger)}.compare-line span:nth-child(3){color:var(--positive)} +.visual-compare{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:10px 0} +.visual-compare>div{min-width:0}.visual-compare h3{font-size:11px;margin-bottom:8px;color:var(--muted)} +.compare-mini{background:#f5f5f4;color:#20252d;border:1px solid #d8d9dc;font-family:ui-sans-serif,Arial,sans-serif;min-height:230px;overflow:hidden} +.mini-header{display:flex;justify-content:space-between;background:white;border-bottom:1px solid #e2e3e5;padding:12px;font-weight:800;font-size:13px}.mini-header span{color:#c069a9}.mini-header small{font-size:9px;color:#848896} +.mini-hero{background:#edf0f7;padding:22px 18px;min-height:100px}.mini-hero small{font-size:9px;color:#827aa0}.mini-hero strong{display:block;font-size:17px;line-height:1.2;max-width:300px;margin:8px 0;letter-spacing:-.04em}.mini-hero p{font-size:10px;line-height:1.5;color:#636b7c;max-width:310px} +.mini-section{padding:14px 18px;border-bottom:1px solid #e2e3e5}.mini-section small{color:#898d99;display:block;font-size:9px}.mini-section b{display:block;font-size:13px;margin-top:5px;overflow-wrap:anywhere} +@media(max-width:700px){.review-summary{grid-template-columns:repeat(2,minmax(0,1fr))}.visual-compare{grid-template-columns:1fr}.compare-label-head,.compare-line{grid-template-columns:minmax(0,.7fr) minmax(0,1fr) minmax(0,1fr);gap:5px;padding:8px 6px;font-size:9px}.review-item{padding:9px 7px;gap:6px}.issue-label{font-size:8px}.compare-mini{min-height:180px}.draft-hint{width:100%}} + +/* ━━━━━━━━━━━━━━━ Site Engine / Stage 3 · Expert ━━━━━━━━━━━━━━━ */ +.builder.expert-layout{grid-template-columns:218px minmax(0,1fr) 315px;min-height:calc(100dvh - 165px);max-height:calc(100dvh - 165px)} +.expert-layout .treepane{background:var(--surface2)} +.expert-layout .stagepane{min-height:0;background:var(--surface)} +.expert-layout .inspectpane{background:var(--surface)} +.expert-files{padding:9px 7px;overflow-y:auto} +.expert-folder{display:flex;align-items:center;gap:7px;padding:16px 10px 9px;font:700 10px ui-monospace,Consolas,monospace;color:var(--muted)} +.expert-folder svg{width:13px;height:13px;color:var(--accent)} +.expert-folder small{margin-left:auto;font-size:9px;opacity:.75} +.expert-file{display:flex;width:100%;border:1px solid transparent;align-items:center;gap:9px;min-height:40px;padding:7px 9px;text-align:left;color:var(--text);background:transparent;border-radius:var(--radius)} +.expert-file svg{color:var(--muted);width:14px;height:14px} +.expert-file span{min-width:0;display:block}.expert-file span b{font-size:10px;font-weight:700;display:block}.expert-file span small{font-size:9px;color:var(--muted);display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis} +.expert-file:hover{background:var(--surface3)}.expert-file.selected{background:var(--accentSoft);color:var(--accent);border-color:color-mix(in srgb,var(--accent) 40%,var(--border))}.expert-file.selected svg{color:var(--accent)} +.expert-file.disabled-file{cursor:default;color:var(--dim);font-size:10px;opacity:.8}.expert-file.disabled-file:hover{background:transparent}.expert-tree-note{font-size:10px;line-height:1.65;color:var(--muted);padding:11px;margin:21px 5px;border:1px solid var(--border);background:var(--surface)} +.expert-tree-note b{color:var(--text)} +.expert-editor-header{height:40px;display:flex;align-items:center;justify-content:space-between;gap:10px;border-bottom:1px solid var(--border);padding:0 12px;background:var(--surface2);font-size:10px;color:var(--muted);flex:none} +.expert-editor-header .filetab{align-items:center;display:flex;gap:8px;max-width:100%;min-width:0;padding:0 10px;height:100%;border-bottom:2px solid var(--accent);background:var(--surface)} +.expert-editor-header .filetab svg{color:var(--accent);height:14px;width:14px}.expert-editor-header .filetab b{color:var(--text);font:650 10px ui-monospace,Consolas,monospace;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.file-edited{color:var(--warning);font-size:13px}.expert-editor-header .muted{white-space:nowrap;font-size:9px;color:var(--muted)} +.expert-tools{display:flex;align-items:center;flex-wrap:wrap;gap:7px;padding:9px 11px;border-bottom:1px solid var(--border);background:var(--surface);flex:none;min-height:45px} +.expert-tools>.mono{font-size:9px;color:var(--dim);margin-right:auto}.expert-find{display:flex;gap:3px}.expert-find input{width:118px;min-width:0;height:28px;padding:0 7px;border:1px solid var(--border);color:var(--text);background:var(--surface2);border-radius:var(--radius);font-size:10px} +.expert-codebox{min-height:300px;flex:1;display:flex;overflow:hidden;position:relative;background:var(--surface)} +.expert-codebox:focus-within{box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--accent) 32%,transparent)} +.expert-gutter{flex:none;margin:0;width:44px;overflow:hidden;padding:13px 9px 40px 7px;border-right:1px solid var(--border);background:var(--surface2);color:var(--dim);font:11.5px/19px ui-monospace,SFMono-Regular,Consolas,monospace;text-align:right;white-space:pre;user-select:none;tab-size:2} +.expert-codewrap{min-width:0;min-height:0;flex:1;position:relative;overflow:hidden} +.expert-highlighter,.expert-textarea{position:absolute;inset:0;margin:0;border:0;border-radius:0;padding:13px 14px 40px;width:100%;height:100%;overflow:auto;white-space:pre;word-wrap:normal;overflow-wrap:normal;tab-size:2;letter-spacing:0;font:11.5px/19px ui-monospace,SFMono-Regular,Consolas,Monaco,monospace} +.expert-highlighter{z-index:0;pointer-events:none;scrollbar-width:none;color:var(--text);background:transparent;white-space:pre} +.expert-highlighter::-webkit-scrollbar{display:none} +.expert-textarea{z-index:1;resize:none;background:transparent;color:transparent;caret-color:var(--text);-webkit-text-fill-color:transparent;outline:none;scrollbar-color:var(--border) transparent} +.expert-textarea::selection{background:color-mix(in srgb,var(--accent) 30%,transparent);-webkit-text-fill-color:transparent} +.expert-textarea:focus-visible{outline:none} +.tok-key{color:var(--accent);font-weight:650}.tok-punct{color:var(--muted)}.tok-value{color:var(--text)}.tok-atom{color:var(--positive)}.tok-rule{color:var(--warning)}.tok-comment{color:var(--dim);font-style:italic}.tok-md{color:var(--text)} +.expert-statusbar{height:29px;display:flex;align-items:center;justify-content:space-between;gap:12px;padding:0 13px;color:var(--muted);background:var(--surface2);border-top:1px solid var(--border);flex:none;font:9px ui-monospace,Consolas,monospace;white-space:nowrap} +.expert-statusbar #expert-source-state{overflow:hidden;text-overflow:ellipsis}.expert-status-invalid{color:var(--danger)}.expert-status-unapplied{color:var(--warning)}.expert-status-good{color:var(--positive)} +.expert-side-scroll{overflow-y:auto;overflow-x:hidden;min-height:0;flex:1;padding:11px;display:flex;flex-direction:column;gap:11px} +.expert-side-top{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:6px} +.expert-mini-preview{height:205px;border:1px solid var(--border);background:var(--previewOuter);border-radius:var(--radius);overflow:hidden;flex:none} +.expert-mini-preview iframe{display:block;height:100%;width:100%;border:0;background:#fff} +.expert-summary{display:flex;align-items:center;justify-content:space-between;gap:8px;border-bottom:1px solid var(--border);padding:6px 0 10px;font-size:11px} +.expert-summary #expert-validation-pip{font-size:9px;color:var(--positive)}.expert-summary #expert-validation-pip.alert{color:var(--danger)} +.expert-issue{min-height:40px}.expert-ok{padding:10px;border-left:2px solid var(--positive);background:var(--positiveBg);font-size:10px;color:var(--positive);line-height:1.5} +.expert-error{padding:10px;border-left:2px solid var(--danger);background:var(--dangerBg);color:var(--danger);font-size:10px;display:flex;flex-direction:column;align-items:start;gap:5px;line-height:1.4} +.expert-error code{overflow-wrap:anywhere}.expert-error .mini-action{margin-top:5px} +.expert-info{display:grid;gap:0;background:var(--surface2);padding:3px 10px;border:1px solid var(--border)}.expert-info>div{display:flex;justify-content:space-between;gap:8px;flex-wrap:wrap;padding:8px 0;border-bottom:1px solid var(--border2);color:var(--muted);font-size:10px}.expert-info>div:last-child{border:0}.expert-info code{color:var(--text);overflow-wrap:anywhere} +.expert-side-actions{display:flex;flex-wrap:wrap;gap:6px}.expert-note{border:1px solid var(--border);background:var(--surface2);padding:11px}.expert-note b{font-size:10px}.expert-note p{margin-top:6px;font-size:10px;line-height:1.65;color:var(--muted)} +.expert-publish-issues{font-size:10px;color:var(--muted)}.expert-publish-issues>b{color:var(--text)}.expert-publish-issues p{margin-top:10px}.expert-publish-line{display:flex;gap:7px;padding:7px 0;border-bottom:1px solid var(--border2);line-height:1.4}.expert-publish-line svg{width:12px;height:12px;flex:none;color:var(--warning)}.expert-publish-line.error svg{color:var(--danger)} +.expert-diff-dialog{width:min(940px,100%)}.expert-diff{overflow:auto;max-height:min(60dvh,650px);border:1px solid var(--border);background:var(--surface2);margin-top:10px} +.diff-line{display:grid;grid-template-columns:35px 35px minmax(0,1fr);min-width:510px;font:10px/1.55 ui-monospace,Consolas,monospace}.diff-line>span{color:var(--dim);border-right:1px solid var(--border);padding:1px 7px;text-align:right;user-select:none}.diff-line code{white-space:pre;min-width:0;overflow:visible;padding:1px 8px;color:var(--text)}.diff-line.add{background:var(--positiveBg)}.diff-line.remove{background:var(--dangerBg)}.diff-line.add code{color:var(--positive)}.diff-line.remove code{color:var(--danger)} +.expert-conflict-dialog{width:min(760px,100%)}.expert-conflict-meta{display:flex;gap:12px;flex-wrap:wrap;justify-content:space-between;border:1px solid var(--border);background:var(--surface2);padding:10px;margin-bottom:13px;font-size:11px}.expert-conflict-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-bottom:14px}.expert-conflict-grid section{padding:13px;border:1px solid var(--border);background:var(--surface2);min-width:0;display:flex;flex-direction:column;gap:8px}.expert-conflict-grid section:first-child{border-top:3px solid var(--accent)}.expert-conflict-grid section:last-child{border-top:3px solid var(--warning)}.expert-conflict-grid h3{font-size:12px}.expert-conflict-grid p{font-size:10px}.expert-conflict-grid code,.expert-conflict-grid small{font-size:10px;color:var(--muted);overflow-wrap:anywhere} +@media(max-width:1380px){.builder.expert-layout{grid-template-columns:195px minmax(0,1fr) 282px}.expert-tools>.mono{display:none}} +@media(max-width:1050px){.builder.expert-layout{grid-template-columns:190px minmax(0,1fr);grid-template-areas:"tree stage" "inspect inspect";max-height:none;min-height:calc(100dvh - 165px)}.expert-layout .treepane{grid-area:tree;min-height:620px;max-height:830px}.expert-layout .stagepane{grid-area:stage;min-height:620px;max-height:830px}.expert-layout .inspectpane{grid-area:inspect;min-height:0;max-height:none}.expert-layout .expert-side-scroll{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));align-items:start}.expert-layout .expert-mini-preview{height:250px}} +@media(max-width:700px){.builder.expert-layout{display:flex;flex-direction:column;max-height:none;min-height:0}.expert-layout .stagepane{order:0;min-height:680px;max-height:none}.expert-layout .treepane{order:1;min-height:190px;max-height:none}.expert-layout .inspectpane{order:2}.expert-codebox{height:480px;flex:none;min-height:480px}.expert-tools{flex-wrap:wrap}.expert-layout .expert-side-scroll{display:flex}.expert-editor-header .muted{display:none}.expert-conflict-grid{grid-template-columns:1fr}.expert-diff{max-height:55dvh}} +@media(max-width:390px){.expert-find input{width:88px}.expert-tools{gap:5px;padding:7px}.expert-gutter{width:34px;padding-left:4px;padding-right:6px}.expert-textarea,.expert-highlighter{font-size:10.5px;line-height:19px;padding-left:9px;padding-right:8px}.expert-statusbar>span:last-child{display:none}} diff --git a/design/assets/builder.js b/design/assets/builder.js new file mode 100644 index 0000000..2d8cff6 --- /dev/null +++ b/design/assets/builder.js @@ -0,0 +1,565 @@ +/* Site Engine — stage 3 / Constructor + Expert from one Page model. Offline design prototype. */ +(()=>{'use strict'; +const $=(q,r=document)=>r.querySelector(q),$$=(q,r=document)=>Array.from(r.querySelectorAll(q)); +const esc=s=>String(s??'').replace(/[&<>"']/g,c=>({'&':'&','<':'<','>':'>','"':'"',"'":'''}[c])); +const clone=x=>JSON.parse(JSON.stringify(x)); +const rose=document.body.dataset.theme==='rose', theme=rose?'rose':'antirion', suffix=rose?'rose-graphite':'antirion-rework'; +const I={pages:'M7 3h10l4 4v14H7z M17 3v5h4 M11 13h6 M11 17h6',home:'M3 10 12 3l9 7v11H3z M9 21v-8h6v8',content:'M12 3 2 8l10 5 10-5-10-5 M2 13l10 5 10-5',publish:'M12 3v13 M7 11l5 5 5-5 M4 18v3h16v-3',image:'M3 3h18v18H3z M7 16l4-4 4 4 2-2 4 4 M8 8h.1',layers:'M3 7l9-4 9 4-9 5-9-5 M3 13l9 5 9-5',setting:'M4 7h16 M4 12h16 M4 17h16',clock:'M12 3a9 9 0 1 0 0 18a9 9 0 0 0 0-18z M12 7v5l3 2',code:'M9 7l-5 5 5 5 M15 7l5 5-5 5',blocks:'M3 3h7v7H3z M14 3h7v7h-7z M3 14h7v7H3z M14 14h7v7h-7z',plus:'M12 4v16 M4 12h16',chevron:'M9 5l7 7-7 7',up:'M12 20V4 M5 11l7-7 7 7',down:'M12 4v16 M5 13l7 7 7-7',trash:'M5 7h14 M8 7V4h8v3 M7 7l1 14h8l1-14',copy:'M8 8h12v12H8z M4 16H3V3h13v1',eye:'M2 12s3.5-6 10-6 10 6 10 6-3.5 6-10 6-10-6-10-6z M12 9a3 3 0 1 0 0 6a3 3 0 0 0 0-6z',hide:'M3 3l18 18 M2 12s3.5-6 10-6c6.5 0 10 6 10 6a17 17 0 0 1-3 3.7 M6.2 6.8C3.5 8.4 2 12 2 12s3.5 6 10 6c1.9 0 3.5-.5 4.8-1.2',check:'M4 12l5 5L20 6',alert:'M12 3 2 21h20z M12 9v5 M12 17v1',monitor:'M3 4h18v14H3z M8 21h8',tablet:'M6 2h12v20H6z',phone:'M8 2h8v20H8z',menu:'M3 7h18 M3 12h18 M3 17h18',link:'M10 13a5 5 0 0 0 7 0l3-3a5 5 0 0 0-7-7l-2 2 M14 11a5 5 0 0 0-7 0l-3 3a5 5 0 0 0 7 7l2-2',save:'M4 3h14l3 3v15H3V3z M7 3v7h10V3 M7 21v-8h10v8',filter:'M3 4h18l-7 9v7l-4 2v-9z',search:'M10 3a7 7 0 1 0 0 14a7 7 0 0 0 0-14z M15.5 15.5 21 21',arrow:'M4 12h16m-6-6 6 6-6 6',close:'M5 5l14 14 M19 5 5 19',lock:'M6 10V7a6 6 0 0 1 12 0v3 M5 10h14v11H5z',refresh:'M20 7V3h-4 M4 17v4h4 M20 11a8 8 0 0 0-14-5l-2 2 M4 13a8 8 0 0 0 14 5l2-2',more:'M4 12h2 M11 12h2 M18 12h2'}; +const icon=(name)=>``; +const sources=['literal','page.title','data.company.name','entry.title']; +const collections={services:[{title:'Telegram-боты',desc:'Автоматизируем диалоги',icon:'01'},{title:'AI-ассистенты',desc:'Интеллектуальные агенты',icon:'02'},{title:'Интеграции',desc:'Связываем процессы',icon:'03'}],scenarios:[{title:'Юридические услуги',desc:'Заявки и документы'},{title:'Недвижимость',desc:'Квалификация лидов'}],cases:[{title:'Сервисная компания',desc:'AI-квалификация обращений'}]}; +const F={ + hero:{name:'Hero',category:'Первый экран',desc:'Заголовок, подзаголовок и действие',fields:[['title','Заголовок','text'],['subtitle','Описание','textarea'],['button','Текст кнопки','text'],['buttonUrl','Ссылка','link']],defaults:{title:'Новая секция',subtitle:'Описание вашего предложения',button:'Обсудить проект',buttonUrl:'/request/'}}, + collection_list:{name:'Список коллекции',category:'Данные',desc:'Карточки, получаемые из collection',fields:[['heading','Заголовок','text'],['collection','Коллекция','collection'],['limit','Максимум записей','number'],['sort','Сортировка','sort']],defaults:{heading:'Направления работы',collection:'services',limit:3,sort:'order'}}, + section:{name:'Текстовая секция',category:'Контент',desc:'Заголовок и содержимое секции',fields:[['heading','Заголовок','text'],['text','Текст','textarea']],defaults:{heading:'Почему мы',text:'Разрабатываем решения под конкретные задачи бизнеса.'}}, + steps:{name:'Этапы',category:'Контент',desc:'Три этапа реализации',fields:[['heading','Заголовок','text'],['step1','Шаг 1','text'],['step2','Шаг 2','text'],['step3','Шаг 3','text']],defaults:{heading:'Как мы работаем',step1:'Исследование',step2:'Разработка',step3:'Внедрение'}}, + cta_banner:{name:'CTA-баннер',category:'Конверсия',desc:'Контрастный призыв к действию',fields:[['title','Заголовок','text'],['text','Подпись','textarea'],['button','Кнопка','text'],['buttonUrl','Ссылка','link']],defaults:{title:'Запустим ваш проект?',text:'Расскажите о задаче — подскажем решение.',button:'Оставить заявку',buttonUrl:'/request/'}}, + richtext:{name:'Markdown body',category:'Контент',desc:'Выводит Markdown из файла страницы',fields:[['heading','Заголовок блока','text']],defaults:{heading:'О проекте'}}, + faq:{name:'FAQ',category:'Контент',desc:'Частые вопросы',fields:[['heading','Заголовок','text'],['question','Вопрос','text'],['answer','Ответ','textarea']],defaults:{heading:'Вопросы и ответы',question:'Как начать работу?',answer:'Опишите задачу и мы подготовим план.'}}, + image:{name:'Изображение',category:'Медиа',desc:'Asset из медиатеки с подписью',fields:[['asset','Медиафайл','asset'],['alt','Alt-текст','text']],defaults:{asset:'assets/team.webp',alt:'Команда разработки'}}, + entry_card:{name:'Запись коллекции',category:'Данные',desc:'Карточка конкретной записи через ref',fields:[['heading','Заголовок','text'],['entry','Запись','ref']],defaults:{heading:'Рекомендуемая услуга',entry:'services/bots'}}, + card_grid:{name:'Карточки',category:'Контент',desc:'Сетка преимуществ',fields:[['heading','Заголовок','text'],['card1','Карточка 1','text'],['card2','Карточка 2','text'],['card3','Карточка 3','text']],defaults:{heading:'Наши преимущества',card1:'Чёткие сроки',card2:'Прозрачность',card3:'Поддержка'}} +}; +const block=(id,fragment,props={},bindings={},extra={})=>({id,fragment,props:{...F[fragment].defaults,...props},bindings,visible:true,anchor:'',note:'',...extra}); +const seed=[ + {id:'home',title:'Главная',url:'/',layout:'landing',status:'published',seo:{title:'Разработка Telegram-ботов и AI-систем',description:'Автоматизация бизнес-процессов и создание AI-решений.'},body:'Мы проектируем и внедряем Telegram-ботов, AI-ассистентов и автоматизации для бизнеса.',blocks:[ + block('hero_home','hero',{title:'Автоматизируем бизнес с помощью AI',subtitle:'Telegram-боты, AI-ассистенты и интеграции, которые решают задачи, а не просто отвечают на сообщения.',button:'Обсудить проект'},{title:{kind:'literal'}}), + block('services_list','collection_list',{heading:'Наши направления',collection:'services',limit:3},{collection:{kind:'query',collection:'services'}}), + block('benefits_grid','card_grid',{heading:'Почему нам доверяют',card1:'Под задачу, а не по шаблону',card2:'Интеграции с вашим стеком',card3:'Сопровождение после запуска'}), + block('process_steps','steps'),block('cta_home','cta_banner',{title:'Обсудим вашу задачу?'})]}, + {id:'services',title:'Услуги',url:'/services/',layout:'standard',status:'published',seo:{title:'Наши услуги',description:'Telegram-боты, AI и автоматизация.'},body:'Все услуги по разработке автоматизаций и AI-инструментов.',blocks:[block('services_head','hero',{title:'Сервисы и решения',subtitle:'Подберём стек и формат под процессы вашей команды.'}),block('services_query','collection_list',{collection:'services',heading:'Каталог услуг',limit:6},{collection:{kind:'query',collection:'services'}}),block('services_faq','faq')]}, + {id:'about',title:'О компании',url:'/about/',layout:'standard',status:'published',seo:{title:'О студии',description:'Команда и подход.'},body:'Мы небольшая инженерная команда, ориентированная на измеримые результаты.',blocks:[block('about_intro','hero',{title:'Команда, которая делает AI полезным',subtitle:'От идеи до работающего продукта.'}),block('body_about','richtext'),block('team_asset','image',{asset:'assets/team.webp',alt:'Команда студии'})]}, + {id:'contacts',title:'Контакты',url:'/contacts/',layout:'standard',status:'draft',seo:{title:'Контакты студии',description:'Свяжитесь с нами.'},body:'Оставьте заявку, чтобы обсудить проект.',blocks:[block('contacts_head','hero',{title:'Давайте знакомиться',subtitle:'Расскажите нам о вашей задаче.'}),block('contacts_cta','cta_banner',{buttonUrl:'/request/'})]}, + {id:'request',title:'Заявка',url:'/request/',layout:'standard',status:'draft',seo:{title:'Обсудить проект',description:''},body:'Заполните форму на сайте.',blocks:[block('request_head','hero',{title:'Расскажите о задаче',subtitle:'Мы свяжемся с вами после уточнения деталей.'}),block('request_body','richtext')]} +]; + +const COLLECTION_META={services:{name:'Услуги',path:'collections/services.yaml'},scenarios:{name:'Сценарии',path:'collections/scenarios.yaml'},cases:{name:'Кейсы',path:'collections/cases.yaml'},courses:{name:'Курсы',path:'collections/courses.yaml'},posts:{name:'Публикации',path:'collections/posts.yaml'}}; +const ENTRIES=[ + {id:'services/bots',title:'Telegram-боты',slug:'bots',collection:'services',status:'published',order:1,desc:'Автоматизируем диалоги и заявки',asset:'assets/bots.webp',url:'/services/bots/'}, + {id:'services/ai',title:'AI-ассистенты',slug:'ai',collection:'services',status:'published',order:2,desc:'Интеллектуальные агенты для бизнеса',asset:'assets/ai.webp',url:'/services/ai/'}, + {id:'services/automation',title:'Интеграции',slug:'automation',collection:'services',status:'draft',order:3,desc:'Связываем процессы и системы',asset:'assets/automation.webp',url:'/services/automation/'}, + {id:'scenarios/legal',title:'Юридические услуги',slug:'legal',collection:'scenarios',status:'published',order:1,desc:'Заявки и документы',asset:'assets/legal.webp',url:'/scenarios/legal/'}, + {id:'scenarios/real-estate',title:'Недвижимость',slug:'real-estate',collection:'scenarios',status:'draft',order:2,desc:'Квалификация лидов',asset:'assets/houses.webp',url:'/scenarios/real-estate/'}, + {id:'cases/support',title:'Поддержка клиентов',slug:'support',collection:'cases',status:'published',order:1,desc:'AI-квалификация обращений',asset:'assets/case.webp',url:'/cases/support/'} +]; +const ASSETS=[{path:'assets/team.webp',name:'Команда студии',type:'image/webp',status:'ready'}, {path:'assets/hero.webp',name:'Фон главной страницы',type:'image/webp',status:'ready'}, {path:'assets/bots.webp',name:'Иконка ботов',type:'image/webp',status:'ready'}, {path:'assets/ai.webp',name:'AI-ассистенты',type:'image/webp',status:'ready'}, {path:'assets/missing.webp',name:'Удалённый файл',type:'image/webp',status:'missing'}]; +const DATA={company:{name:'Flexly Studio',tagline:'AI, Telegram и автоматизация',email:'hello@studio.example'}}; +const entryById=id=>ENTRIES.find(e=>e.id===id),assetByPath=path=>ASSETS.find(a=>a.path===path&&a.status==='ready'); +const visibleEntries=(collection,sort='order',limit=6)=>{ + let items=ENTRIES.filter(e=>e.collection===collection&&e.status!=='archived'); + if(sort==='title')items.sort((a,b)=>a.title.localeCompare(b.title,'ru'));else items.sort((a,b)=>a.order-b.order); + return items.slice(0,Math.max(1,Math.min(12,Number(limit)||6))); +}; +const urlKnown=value=>!value||/^(https?:\/\/|mailto:|tel:|#)/i.test(value)||s.pages.some(p=>p.url===value)||ENTRIES.some(e=>e.url===value&&e.status==='published'); +const resolveValue=(b,key,p=page())=>{ + const val=b?.props?.[key]??''; + const binding=b?.bindings?.[key]; + if(binding?.kind==='bind'){ + const path=binding.path; + if(path==='page.title')return {kind:'bind',source:path,value:p.title,valid:!!p.title}; + if(path==='page.url')return {kind:'bind',source:path,value:p.url,valid:!!p.url}; + if(path==='page.seo.title')return {kind:'bind',source:path,value:p.seo?.title||'',valid:!!p.seo?.title}; + if(path.startsWith('data.company.')){const key=path.split('.')[2];return {kind:'bind',source:path,value:DATA.company[key]??'',valid:key in DATA.company};} + if(path==='entry.title'){const e=entryById(b.props?.entry);return {kind:'bind',source:path,value:e?.title||'⚠ запись не найдена',valid:!!e};} + return {kind:'bind',source:path,value:'⚠ источник не найден',valid:false}; + } + if(key==='collection')return {kind:'query',source:val,value:`${val} · ${visibleEntries(val,b.props?.sort,b.props?.limit).length} записей`,valid:val in COLLECTION_META}; + if(key==='entry')return {kind:'ref',source:val,value:entryById(val)?.title||'⚠ запись не найдена',valid:!!entryById(val)}; + if(key==='asset')return {kind:'asset',source:val,value:assetByPath(val)?.name||'⚠ медиафайл не найден',valid:!!assetByPath(val)}; + if(/Url$/.test(key))return {kind:'link',source:val,value:val||'Не задано',valid:urlKnown(val)}; + return {kind:'literal',source:'props.'+key,value:String(val),valid:true}; +}; +const bindingIssue=(b,key,p=page())=>{ + const v=resolveValue(b,key,p); + if(!v.valid)return {level:v.kind==='asset'?'warn':'error',text:`${b.id}.props.${key}: ${v.kind==='asset'?'медиафайл':'источник'} ${v.source||'—'} недоступен`}; + if(key==='entry'){const e=entryById(b.props.entry);if(e?.status==='draft')return {level:'warn',text:`${b.id}.props.entry: ${e.id} ещё не опубликована`};} + if(/Url$/.test(key)&&b.props[key]){const target=s.pages.find(p=>p.url===b.props[key])||ENTRIES.find(e=>e.url===b.props[key]);if(target&&target.status!=='published')return {level:'warn',text:`${b.id}.props.${key}: ссылка ${b.props[key]} ведёт на неопубликованный материал`};} + if(key==='collection'&&visibleEntries(b.props.collection,b.props.sort,b.props.limit).length===0)return {level:'warn',text:`${b.id}.props.collection: коллекция ${b.props.collection} пуста`}; + return null; +}; +function whereUsed(type,id){const usages=[]; + for(const p of s.pages)for(const b of p.blocks){ + const matching=[]; + for(const [key,val] of Object.entries(b.props||{})){ + if(type==='collection'&&key==='collection'&&val===id)matching.push({key,mode:'query'}); + if(type==='entry'&&key==='entry'&&val===id)matching.push({key,mode:'ref'}); + if(type==='asset'&&key==='asset'&&val===id)matching.push({key,mode:'asset'}); + if(type==='page'&&/Url$/.test(key)&&val===id)matching.push({key,mode:'link'}); + } + for(const [key,bind] of Object.entries(b.bindings||{})){ + if(type==='data'&&bind?.kind==='bind'&&bind.path===id)matching.push({key,mode:'bind'}); + if(type==='entry'&&bind?.path==='entry.title'&&b.props.entry===id&&!matching.some(x=>x.key==='entry'))matching.push({key,mode:'bind'}); + } + if(type==='entry'&&b.fragment==='collection_list'&&b.props.collection===id.split('/')[0])matching.push({key:'collection',mode:'query (динамически)'}); + for(const m of matching)usages.push({page:p.id,title:p.title,block:b.id,fragment:b.fragment,...m}); + } + return usages; +} +function usageButton(type,id,label='Где используется?'){return ``;} +function targetKind(b,key){const f=F[b.fragment]?.fields.find(x=>x[0]===key);return f?.[2]||'text';} +function fieldSourceChoices(b,key){const typ=targetKind(b,key); + if(typ==='collection')return [{kind:'collection',title:'Коллекция',items:Object.entries(COLLECTION_META).map(([id,item])=>({id,title:item.name,detail:item.path,count:ENTRIES.filter(e=>e.collection===id).length}))},{kind:'collection',title:'Ошибочный источник (демо)',items:[{id:'missing_collection',title:'missing_collection',detail:'Нет файла collections/missing_collection.yaml',invalid:true}]}]; + if(typ==='asset')return [{kind:'asset',title:'Медиатека',items:ASSETS.map(a=>({id:a.path,title:a.name,detail:a.path,invalid:a.status==='missing'}))}]; + if(typ==='ref')return [{kind:'entry',title:'Записи коллекций',items:ENTRIES.map(e=>({id:e.id,title:e.title,detail:`${e.collection} · ${e.status}`,warning:e.status==='draft'})).concat([{id:'services/ghost',title:'Удалённая запись',detail:'Отсутствует content/services/ghost.md',invalid:true}])}]; + if(typ==='link')return [{kind:'page',title:'Страницы сайта',items:s.pages.map(p=>({id:p.url,title:p.title,detail:`pages/${p.id}.md · ${p.status}`})).concat([{id:'/missing/',title:'Несуществующая страница',detail:'Нет подходящего route',invalid:true}])},{kind:'page',title:'Публичные записи',items:ENTRIES.map(e=>({id:e.url,title:e.title,detail:e.collection,warning:e.status!=='published'}))}]; + return [{kind:'literal',title:'Значение из блока',items:[{id:'literal',title:'Literal',detail:'props.'+key+' — ручное значение'}]}, {kind:'bind',title:'Поля страницы',items:[{id:'page.title',title:'Название страницы',detail:'{bind: page.title}'},{id:'page.url',title:'URL страницы',detail:'{bind: page.url}'},{id:'page.seo.title',title:'SEO-заголовок',detail:'{bind: page.seo.title}'}]}, {kind:'bind',title:'Общие данные · data/company.yaml',items:[{id:'data.company.name',title:'Название студии',detail:'{bind: data.company.name}'},{id:'data.company.tagline',title:'Слоган',detail:'{bind: data.company.tagline}'},{id:'data.company.email',title:'Email',detail:'{bind: data.company.email}'}]}, {kind:'bind',title:'Запись (контекст)',items:[{id:'entry.title',title:'Заголовок записи',detail:'{bind: entry.title} · только при выбранной entry'}]}]; +} +function pickerModal(key){const b=current();if(!b)return;s.picker={key}; + const groups=fieldSourceChoices(b,key); + modal('Выбрать источник данных',`${b.id} / props.${key} · без ручного YAML`, + `
${icon('layers')} ${esc(page().id)} → ${esc(page().layout)} → main → ${esc(b.id)} → ${esc(b.fragment)} → props.${esc(key)}
+ +
${renderChoices(groups,'')}
`,button('Отмена','close')); +} +function renderChoices(groups,term){const q=term.toLowerCase().trim();return groups.map(g=>{ + const items=g.items.filter(i=>(i.id+' '+i.title+' '+i.detail).toLowerCase().includes(q)); + if(!items.length)return ''; + return `
${esc(g.title)} ${items.length}
${items.map(i=>``).join('')}
`; + }).join('')||'
Ничего не найденоПопробуйте другой запрос
'; +} +function applyPicked(kind,value){const b=current(),key=s.picker?.key;if(!b||!key)return; + if(kind==='bind'){b.bindings[key]={kind:'bind',path:value};} + else if(kind==='literal'){delete b.bindings[key];} + else if(kind==='collection'){b.props[key]=value;b.bindings[key]={kind:'query',collection:value};} + else {b.props[key]=value;delete b.bindings[key];} + const wasLive=s.view==='live';close();s.tab='bindings';s.treeView='mapping';s.view='draft';renderHead();renderTree();renderInspector();if(wasLive)renderStage();else renderPreview();toast(`${b.id}.props.${key} · источник обновлён в workspace`); +} +function usageModal(type,id){const refs=whereUsed(type,id), relatedEntries=type==='asset'?ENTRIES.filter(e=>e.asset===id):[], human={collection:'Collection',entry:'Entry',asset:'Asset',page:'Page / URL',data:'Data'}; + modal('Где используется?',`${human[type]||type}: ${id} · поиск по демо-workspace`, + `
${refs.length+relatedEntries.length} использований${esc(id)}
+ ${refs.length?refs.map(r=>``).join(''):'
Прямых зависимостей не найденоВ демо-workspace нет блоков, использующих этот источник.
'} + ${relatedEntries.length?`
Использование в записях
${relatedEntries.map(e=>`
${esc(e.title)}content/${esc(e.id)}.md → asset: ${esc(id)}
`).join('')}`:''} +
Динамическое использование записи через collection_list показано отдельно. Реальные зависимости определит сервис индексации Site Engine.
`,button('Закрыть','close')); +} +function jumpToUsage(pageId,blockId){close();if(!s.pages.some(p=>p.id===pageId))return;s.selectedPage=pageId;s.selected=blockId;s.treeView='mapping';s.tab='bindings';s.view='draft';pendingPreviewNavigate=blockId;renderAll();toast(`Найдено использование: ${pageId} / ${blockId}`);} +function mappingDataChip(type,id){return `${esc(id)}${usageButton(type,id,'Связи')}`;} +function libraryModal(){modal('Каталог данных','Демо-источники Site Engine · один сайт', + `
Коллекции
${Object.entries(COLLECTION_META).map(([id,item])=>`
${esc(item.name)}${esc(item.path)} · ${ENTRIES.filter(e=>e.collection===id).length} записей${usageButton('collection',id)}
`).join('')} +
Записи
${ENTRIES.map(e=>`
${esc(e.title)}content/${esc(e.id)}.md · ${e.status}${usageButton('entry',e.id)}
`).join('')} +
Ассеты
${ASSETS.map(a=>`
${esc(a.name)}${esc(a.path)} · ${a.status}${usageButton('asset',a.path)}
`).join('')} +
Общие данные
${Object.keys(DATA.company).map(k=>`
${esc(k)}data.company.${k}${usageButton('data','data.company.'+k)}
`).join('')}
`,button('Закрыть','close'));} +function blockIssues(b,p=page()){const fields=F[b.fragment]?.fields||[];return fields.map(([key])=>bindingIssue(b,key,p)).filter(Boolean);} + +const STORAGE='site-engine-stage2-constructor-v1',savedPayload=(()=>{try{return JSON.parse(localStorage.getItem(STORAGE))}catch{return null}})(); +let s={pages:seed,selectedPage:'home',selected:'hero_home',mode:'constructor',treeView:'tree',tab:'props',device:'desktop',view:'draft',layoutSidebar:false,mobileNav:false,catalog:false,catalogGroup:'Все',catalogQuery:'',modal:null,toastTimer:null,savedPages:clone(seed),livePages:clone(seed),dirty:false,savedAt:savedPayload?.savedAt||null,reviewFilter:'all',compareMode:'live',compareTab:'changes'}; +if(savedPayload?.pages?.length){s.pages=savedPayload.pages;s.savedPages=clone(savedPayload.pages);s.selectedPage=s.pages[0].id;s.selected=s.pages[0].blocks[0]?.id||'header';} +const page=()=>s.pages.find(x=>x.id===s.selectedPage),livePage=()=>s.livePages.find(x=>x.id===s.selectedPage)||page(); +const current=()=>page().blocks.find(b=>b.id===s.selected),isFixed=()=>s.selected==='site_header'||s.selected==='site_footer',anyDirty=()=>JSON.stringify(s.pages)!==JSON.stringify(s.savedPages); +const effective=(b,k,p=page())=>resolveValue(b,k,p).value; +let pendingPreviewNavigate=null; // target after iframe remount (add/move) +const requestedPage=new URL(location.href).searchParams.get('page'); +if(requestedPage&&s.pages.some(p=>p.id===requestedPage)){s.selectedPage=requestedPage;s.selected=page().blocks[0]?.id||'site_header';} +const newID=type=>`${type}_${Math.random().toString(36).slice(2,8)}`; +function button(text,action,kind='',more=''){return ``} +function toast(message){const box=$('#toast');box.textContent=message;box.style.display='block';clearTimeout(s.toastTimer);s.toastTimer=setTimeout(()=>box.style.display='none',3200)} +function changedCount(){return s.pages.reduce((sum,p)=>{const base=s.savedPages.find(x=>x.id===p.id);return sum+(JSON.stringify(p)!==JSON.stringify(base)?1:0)},0)} +function markDirty(){s.dirty=anyDirty();const l=$('[data-statusbar]');if(l)l.innerHTML=s.dirty?'● Не сохранено':'✓ Черновик сохранён';const title=$('[data-pagehead]');if(title)title.textContent=page().title;const hint=$('[data-savehint]');if(hint)hint.textContent=s.dirty?`${changedCount()} стр. с несохранёнными правками`:s.savedAt?`Локально сохранено · ${s.savedAt}`:'Исходный mock workspace';const counters=$('[data-checksummary]');if(counters){const report=validateDetailed(),errs=report.filter(x=>x.level==='error').length;const warns=report.length-errs;counters.innerHTML=`${errs} ошибок${warns} предупреждений`;}} +function shell(){const active='pages';$('#app').innerHTML=`
LIVE build_00027${icon('layers')} ${rose?'04 Antirion':'06 Rose Graphite'}
OW
`;renderAll();} +function renderHead(){const p=page();const modeLabel=$('.breadcrumbs strong');if(modeLabel)modeLabel.textContent=s.mode==='expert'?'Эксперт':'Конструктор';$('#head').innerHTML=`
Page editor / Stage 3 · Конструктор ↔ Эксперт · mock

${esc(p.title)}

${esc(p.url)} · pages/${p.id==='home'?'index':p.id}.md${esc(p.status)}
${button(icon('check')+' Проверить','validate')}${button(icon('code')+' Сравнить','diff')}${button(icon('refresh')+' Отменить','reset','')}${button(icon('save')+' Сохранить черновик','save','primary')}
`;markDirty();} +function renderTree(){const oldScroll=$('#treepane .pane-scroll')?.scrollTop||0;let p=page();const all=p.blocks;const menu=[['tree','Дерево блоков'],['mapping','Связи данных']].map(([key,label])=>``).join('');const fixed=(id,label)=>``; +const items=all.map(b=>``).join(''); +$('#treepane').innerHTML=`
Структура страницы
${p.blocks.length} блоков · ${esc(p.layout)}
${menu}
${s.treeView==='tree'?`
Layout / ${esc(p.layout)}
${icon('layers')}${esc(p.layout)}.htmlРегионы: header / main / footer
header Fixed
${fixed('site_header','Шапка сайта')}
main
${items}
${button(icon('plus')+' Добавить блок','catalog','small')}
footer Fixed
${fixed('site_footer','Подвал сайта')}
`:mappingHTML()}
Блоки с фиксированным статусом защищены${icon('lock')}
`;const currentScroll=$('#treepane .pane-scroll');if(currentScroll)currentScroll.scrollTop=oldScroll;} +function mappingHTML(){const p=page(),issues=p.blocks.flatMap(b=>blockIssues(b,p));const total=p.blocks.reduce((sum,b)=>sum+F[b.fragment].fields.length,0); +return `
Карта источников
Page → Layout → Region → Block → Fragment → props → Источник → Вывод.
${total} полей${p.blocks.length} блоков${issues.length} проблем
${p.blocks.map(b=>{const edges=F[b.fragment].fields.map(([key])=>{const res=resolveValue(b,key,p),issue=bindingIssue(b,key,p);return `
${esc(key)}${esc(res.kind)}${esc(res.kind==='literal'?String(res.value).slice(0,38):res.source||res.value)}
`}).join('');const problems=blockIssues(b,p);return `
${edges}${problems.map(q=>`
${icon('alert')} ${esc(q.text)}
`).join('')}
`}).join('')}`} +function stageToolbar(){return `
${icon('eye')}Предпросмотр· iframe
${[['desktop','monitor','Desktop'],['tablet','tablet','Tablet'],['mobile','phone','Mobile']].map(([v,i,label])=>``).join('')}
${esc(page().url)} · ${s.view==='live'?'build_00027 · неизменяемый mock':'workspace · не опубликовано'}
`} +function renderStage(){let el=$('#stagepane');el.innerHTML=stageToolbar()+`
Клик по секции выбирает блок · публикация из этого экрана не выполняется${s.view==='live'?'LIVE':'WORKSPACE'}
`;renderPreview();} +function sourceOf(b,key){let binding=b.bindings?.[key];return binding?.kind==='bind'?binding.path:'literal'} +function bindingControl(b,key){let source=sourceOf(b,key);return ``} +function fieldHTML(b,[key,name,type]){ + const res=resolveValue(b,key),bound=res.kind==='bind';const issue=bindingIssue(b,key); + const textArea=type==='textarea';let input=''; + if(type==='collection')input=``; + else if(type==='sort')input=``; + else if(type==='asset'||type==='ref'||type==='link')input=`
${esc(res.source||'не задано')}
`; + else if(textArea)input=``; + else input=``; + const isBindable=['text','textarea'].includes(type); + const sourceControl=isBindable?``:''; + const status=issue?`
${icon('alert')} ${esc(issue.text)}
`:`${res.kind==='literal'?'Хранится в props блока':res.kind==='query'?`Запрос: ${esc(res.source)} · sort: ${esc(b.props.sort||'order')} · limit: ${esc(b.props.limit)}`:`${esc(res.kind)} → ${esc(String(res.value).slice(0,80))}`}`; + return ``; +} +function fixedInspector(){let header=s.selected==='site_header';return `

${header?'Шапка сайта':'Подвал сайта'}

${header?'site_header':'site_footer'}
${icon('lock')} Fixed
Этот блок закреплён за регионом ${header?'header':'footer'} в layout. В MVP его нельзя переместить или удалить.
Откуда берутся данные
site.yamldata/company.yamlmenus/main.yaml

Шаблон и его код доступны пользователю с ролью developer. Здесь показана только связь.

`} +function blockProps(b){return `

${esc(F[b.fragment].name)}

${esc(b.id)} / ${esc(b.fragment)}
${b.visible?'Виден':'Скрыт'}
${F[b.fragment].fields.map(field=>fieldHTML(b,field)).join('')}${b.fragment==='richtext'?'
Внимание: содержимое выводится из Markdown body текущей страницы. Изменить его можно во вкладке «Страница».
':''}${b.fragment==='image'&&b.props.asset==='assets/missing.webp'?'
Asset не найден: assets/missing.webp. Проверьте ссылку.
':''}${b.fragment==='collection_list'&&b.props.collection==='missing_collection'?'
Коллекция не найдена: missing_collection.
':''}
Управление блоком
${button(icon('up')+' Выше','move-up','small')}${button(icon('down')+' Ниже','move-down','small')}
${button(icon('copy')+' Дублировать','duplicate','small')}${button(icon(b.visible?'hide':'eye')+' '+(b.visible?'Скрыть':'Показать'),'visibility','small')}${button(icon('trash')+' Удалить','delete','small danger')}
`} +function blockBindings(b){const p=page(),fields=F[b.fragment].fields; + const edges=fields.map(([key,label])=>{const res=resolveValue(b,key,p),issue=bindingIssue(b,key,p);let usage=''; + if(res.kind==='query')usage=usageButton('collection',b.props.collection); + else if(res.kind==='ref')usage=usageButton('entry',b.props.entry); + else if(res.kind==='asset')usage=usageButton('asset',b.props.asset); + else if(res.kind==='link')usage=usageButton('page',b.props[key]); + else if(res.kind==='bind')usage=usageButton(res.source==='entry.title'?'entry':'data',res.source==='entry.title'?b.props.entry:res.source); + return `
${esc(label)}${esc(res.kind)}
props.${esc(key)} → ${esc(res.source)}
${icon(issue?'alert':'check')} ${esc(String(res.value).slice(0,120))}
${issue?`
${esc(issue.text)}
`:''}
${usage}
`; + }).join(''); + return `

Маппинг источников

${esc(b.id)}
${blockIssues(b,p).length?'Есть проблемы':'Связи корректны'}
${esc(p.id)}→ ${esc(p.layout)}→ main→ ${esc(b.id)}→ ${esc(b.fragment)}
${edges}

Источник выбирается из UI и сохраняется в props/bindings документа. Query DSL ограничен collection, sort и limit. Реальная проверка и права — за сервером.

`; +} +function pageDiagnostics(p){const list=[];const push=(key,text,level='warn')=>list.push({key,text,level});if(!p.title.trim())push('title','Название страницы обязательно','error');if(!p.url.startsWith('/')||p.url.includes(' '))push('url','URL должен начинаться с / и не содержать пробелов','error');if(s.pages.some(x=>x.id!==p.id&&x.url===p.url))push('url','Такой URL уже используется другой страницей','error');if(!p.seo.title.trim())push('seo.title','SEO title не задан');if(p.seo.title.length>70)push('seo.title','SEO title длиннее 70 символов');if(!p.seo.description.trim())push('seo.description','SEO description не задан');if(p.seo.description.length>160)push('seo.description','SEO description длиннее 160 символов');if(p.body.trim()&&!p.blocks.some(b=>b.fragment==='richtext'&&b.visible))push('body','Markdown body заполнен, но не выводится видимым richtext');return list;} +function fieldDiagnostic(p,key){const found=pageDiagnostics(p).filter(x=>x.key===key);return found.map(x=>`
${icon('alert')} ${esc(x.text)}
`).join('')} +function markdownHTML(raw){const inline=x=>esc(x).replace(/\*\*(.+?)\*\*/g,'$1').replace(/`([^`]+)`/g,'$1').replace(/\*([^*]+)\*/g,'$1').replace(/\[([^\]]+)\]\((https?:\/\/[^\s)]+)\)/g,'$1');let inList=false;return String(raw||'').split(/\r?\n/).map(line=>{const t=line.trim();if(!t){if(inList){inList=false;return ''}return '';}if(/^#{1,3}\s/.test(t)){const n=t.match(/^#+/)[0].length;return `${inList?'':''}${inline(t.slice(n).trim())}`;}if(/^[-*]\s/.test(t)){const first=inList?'':'
    ';inList=true;return `${first}
  • ${inline(t.slice(2))}
  • `;}const close=inList?'
':'';inList=false;return close+`

${inline(t)}

`;}).join('')+(inList?'':'');} +function pageTab(){let p=page(),diags=pageDiagnostics(p),hasBody=p.blocks.some(b=>b.fragment==='richtext'&&b.visible);return `

Свойства страницы

pages/${p.id==='home'?'index':p.id}.md
${diags.length?diags.length+' замечаний':'Проверено'}
+
Изменения — в workspace. Save draft ≠ Publish. Для публикации понадобится проверенный release candidate.
+ + + + +
SEO Search preview
+ + +
studio.example${esc(p.url)}
${esc(p.seo.title||p.title||'Название страницы')}
${esc(p.seo.description||'Описание страницы пока не заполнено.')}
+
Markdown body pages/*.md
+ +
Markdown → preview (упрощённый, безопасный)
${markdownHTML(p.body)}
+ ${!hasBody?button(icon('plus')+' Добавить richtext для body','add-richtext','small'):''}`;} +function renderInspector(){let blockSel=isFixed(),b=current();const tabs=[['props','Свойства'],['bindings','Связи'],['page','Страница']];$('#inspectpane').innerHTML=`
Инспектор
Схема полей Fragment
${icon('setting')}
${tabs.map(([id,label])=>``).join('')}
${s.tab==='page'?pageTab():blockSel?fixedInspector():b?(s.tab==='props'?blockProps(b):blockBindings(b)):'
Выберите блок в дереве
'}
Изменения только в mock workspaceschema v1
`;} +function renderAll(){if(s.mode==='expert'){renderExpert();return;}$('#builder')?.classList.remove('expert-layout');renderHead();renderTree();renderStage();renderInspector()} +const previewCss=`*{box-sizing:border-box}body{margin:0;background:#fbfaf7;color:#191e23;font:14px/1.6 Inter,Arial,sans-serif}a{color:inherit;text-decoration:none}.inner{max-width:1080px;padding:0 36px;margin:auto}.site-header{border-bottom:1px solid #e5e4e0;background:#fff;position:sticky;top:0;z-index:1}.site-header .inner{display:flex;align-items:center;height:62px;gap:24px;justify-content:space-between}.site-header b{font-size:15px;letter-spacing:-.05em}.brandmark{display:inline-grid;place-items:center;width:26px;height:26px;background:#141b25;color:white;margin-right:8px;border-radius:5px}.site-header nav{display:flex;gap:19px;color:#6f747c;font-size:12px}.site-header nav span{white-space:nowrap}.site-header .smallbtn{background:#1e2938;color:white;border-radius:5px;padding:6px 12px;font-size:11px}.hero{background:radial-gradient(circle at 90% 7%,#d9d2ff 0%,transparent 33%),linear-gradient(145deg,#1e2735 0%,#15202d 55%,#31344a 100%);color:white;padding:84px 0 90px;min-height:330px}.hero .tag{font-size:10px;color:#c5d1e8;letter-spacing:.13em;text-transform:uppercase}.hero h1{font-size:clamp(30px,4.2vw,54px);line-height:1.14;letter-spacing:-.065em;max-width:700px;margin:17px 0}.hero p{font-size:14px;color:#bbc6d6;max-width:560px}.hero a,.cta a{display:inline-block;background:#d4beff;color:#212438;font-weight:750;font-size:12px;padding:11px 18px;border-radius:5px;margin-top:21px}.section{padding:58px 0}.section.alt{background:#f0f1ef}.section h2{font-size:30px;letter-spacing:-.055em;margin:0 0 13px}.section p{max-width:720px;color:#5a6670;margin:0}.cards{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:15px;margin:25px 0 0}.card{border:1px solid #e0e1de;border-radius:7px;background:white;padding:22px 20px;min-height:122px}.card small{color:#9d92cf;font-weight:800}.card strong{font-size:16px;display:block;margin:14px 0 5px;line-height:1.3}.card p{font-size:12px}.steps{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:25px;margin-top:23px}.steps div{border-top:1px solid #ccd0d8;padding-top:13px}.steps span{display:block;color:#8e7cc9;font-size:11px;font-weight:700}.steps b{font-size:17px}.cta{padding:54px 0;background:#dfe3f2}.cta h2{font-size:35px;letter-spacing:-.06em;margin:0 0 8px}.cta a{background:#1d2432;color:white}.site-footer{background:#18202b;color:#bfc7d1;padding:25px 0;font-size:11px}.site-footer .inner{display:flex;justify-content:space-between}.section[data-bid],.hero[data-bid],.cta[data-bid]{position:relative;cursor:pointer;outline-offset:-3px}.section[data-bid]:hover,.hero[data-bid]:hover,.cta[data-bid]:hover{outline:2px dashed #a085ed}.sel{outline:3px solid #9a6cfa!important;outline-offset:-3px}.sel::after{content:'SELECTED';position:absolute;top:0;right:0;background:#925de0;color:white;font:10px monospace;padding:4px 8px;z-index:2}.hiddenblock{opacity:.48;filter:grayscale(.5)}.hiddenblock::before{content:'СКРЫТ — только в Конструкторе';position:absolute;inset:0 auto auto 0;background:#ad6b2c;color:white;font-size:10px;padding:2px 7px;z-index:2}.imgbox{background:linear-gradient(135deg,#d0d5e0,#a7aed1);height:180px;display:grid;place-items:center;color:#525f87;margin:20px 0;border-radius:7px}.markdown-content h1,.markdown-content h2,.markdown-content h3{font-size:22px;margin:13px 0 9px}.markdown-content p{margin:6px 0 10px;max-width:720px}.markdown-content ul{padding-left:21px;color:#566070}.markdown-content a{color:#5d52b6;text-decoration:underline}.faqcard{padding:15px 0;border-bottom:1px solid #d6d8dc}.faqcard b{display:block;font-size:15px;margin-bottom:5px}@media(max-width:600px){.inner{padding:0 20px}.site-header nav{display:none}.site-header .smallbtn{display:none}.hero{padding:57px 0}.hero h1{font-size:33px}.section{padding:38px 0}.section h2{font-size:25px}.cards,.steps{grid-template-columns:1fr}.card{min-height:0}.cta h2{font-size:29px}.site-footer .inner{display:block}}`; +function previewSection(b,p){const v=k=>esc(effective(b,k,p));const sel=b.id===s.selected?'sel':'';const hidden=!b.visible?'hiddenblock':'';const att=`data-bid="${esc(b.id)}" class="${b.fragment==='hero'?'hero':b.fragment==='cta_banner'?'cta':'section'} ${sel} ${hidden}"`;let content=''; +switch(b.fragment){ +case'hero':content=`
● DIGITAL / AI ENGINEERING

${v('title')}

${v('subtitle')}

${v('button')} →
`;break; +case'collection_list':{let records=visibleEntries(b.props.collection,b.props.sort||'order',b.props.limit); + content=`

${v('heading')}

Технологические решения для ваших процессов.

${records.map((r,i)=>`
0${i+1} / ${esc(r.collection.toUpperCase())}${r.status==='draft'?' · DRAFT':''}${esc(r.title)}

${esc(r.desc)}

`).join('')||'

Коллекция не найдена / пустой результат.

'}
`;break;} +case'entry_card':{const r=entryById(b.props.entry);content=`

${v('heading')}

${r?`
${esc(r.collection.toUpperCase())} / ${esc(r.status)}${esc(r.title)}

${esc(r.desc)}

`:'

⚠ Связанная запись отсутствует

'}
`;break;} +case'section':content=`

${v('heading')}

${v('text')}

`;break; +case'steps':content=`

${v('heading')}

${['step1','step2','step3'].map((k,i)=>`
0${i+1}${v(k)}
`).join('')}
`;break; +case'cta_banner':content=`

${v('title')}

${v('text')}

${v('button')} →
`;break; +case'richtext':content=`

${v('heading')}

${markdownHTML(p.body)}
`;break; +case'faq':content=`

${v('heading')}

${v('question')}

${v('answer')}

`;break; +case'image':content=`
${!assetByPath(b.props.asset)?'⚠ Asset не найден':'◈ '+v('alt')}
`;break; +case'card_grid':content=`

${v('heading')}

${['card1','card2','card3'].map((k,i)=>`
0${i+1} / VALUE${v(k)}

Практичный подход к реализации проекта.

`).join('')}
`;break; +}return content;} +function renderPreview(){const frame=$('#preview');if(!frame)return;const p=s.view==='live'?livePage():page();const mainHtml=p.blocks.filter(b=>b.visible||s.view==='draft').map(b=>previewSection(b,p)).join('');const html=`Preview
${mainHtml}
studio. © 2026AI · Telegram · Автоматизация
diff --git a/design/builder-rose-graphite.html b/design/builder-rose-graphite.html new file mode 100644 index 0000000..9a754d4 --- /dev/null +++ b/design/builder-rose-graphite.html @@ -0,0 +1 @@ +Page Editor · Конструктор и Эксперт · Rose Graphite · Site Engine
diff --git a/design/content-antirion.html b/design/content-antirion.html new file mode 100644 index 0000000..ae229cb --- /dev/null +++ b/design/content-antirion.html @@ -0,0 +1 @@ +Контент и коллекции · Antirion Rework · Site Engine
diff --git a/design/content-rose-graphite.html b/design/content-rose-graphite.html new file mode 100644 index 0000000..48bddea --- /dev/null +++ b/design/content-rose-graphite.html @@ -0,0 +1 @@ +Контент и коллекции · Rose Graphite · Site Engine
diff --git a/design/docs/README_STAGE5.md b/design/docs/README_STAGE5.md new file mode 100644 index 0000000..9525d00 --- /dev/null +++ b/design/docs/README_STAGE5.md @@ -0,0 +1,81 @@ +# Site Engine — Этап 5: Публикация, история и откат + +**Design prototype.** HTML / CSS / JavaScript, без Node.js, CDN и серверной интеграции. + +Откройте `index.html` и выберите публикацию в одном из двух активных оформлений. Остальные ранее согласованные экраны и редакторы сохранены. + +## Актуальные варианты дизайна + +| № | Название | Статус | Ключевой файл | +|---|---|---|---| +| 03 | Antirion | Сохранённый концепт | `antirion.html` | +| **04** | **Antirion Rework** | Активно развивается | `antirion-rework.html`, `publication-antirion.html` | +| 05 | Ember Graphite | Сохранённый концепт | `ember-graphite.html` | +| **06** | **Rose Graphite** | Активно развивается | `rose-graphite.html`, `publication-rose-graphite.html` | + +В Rose Graphite единственный элемент без скруглений — выбор коллекции в разделе Контент. Остальные таблицы, панели и карточки сохранили утверждённый стиль. + +## Что работает в Этапе 5 + +- **Workspace:** изменённые / новые / удалённые файлы и их статусы, поиск и фильтры, сравнение с live. Демонстрационные данные поддерживают Page, Entry, Menu, Asset. Сохранённые черновики Этапов 3–4 читаются из `localStorage` при возможности. +- **Validation:** ошибки и предупреждения, переход к объекту, тестовое исправление отсутствующей формы и повторная проверка. Ошибки блокируют сборку кандидата. +- **Candidate:** зафиксированный снимок файлов и diff относительно live; повторная сборка после новой проверки, инвалидация старого кандидата при изменении workspace или live. Сценарий failed build с логом не меняет live. +- **Publish:** подтверждение с комментарием и смена только mock-live ID, хранение релиза в истории и запись действия в демо-аудит. +- **История:** список неизменяемых релизов, детали, файлы, отличия и предыдущие версии. История документа представлена отдельно от истории сайта и обозначена зависимостью от Git / revisions. +- **Rollback:** сравнение последствий, проверка версии форм, подтверждение и изменение live без потери workspace. Успешный rollback отражается в демо-аудите. +- **Роли:** Owner/Developer могут создавать кандидатов, публиковать и откатывать; Editor/Reviewer — просматривать и проверять. +- **Интеграция с UI:** из навигации «Публикация» в 04/06 и из редакторов Page/Entry выполняется переход к новому экрану. При открытии `?section=publish` также выполняется переход. + +## Главный сценарий (в двух темах) + +1. Откройте `publication-rose-graphite.html`. +2. Нажмите **Проверить** — появится ошибка привязки `form_contact`. +3. На вкладке **Проверки** нажмите **Исправить → Применить**. Повторите **Запустить validate**. +4. На вкладке **Кандидат** нажмите **Сформировать кандидата**; при нулевом числе ошибок появится готовый `build_id`. +5. Нажмите **Опубликовать**, добавьте комментарий и подтвердите. +6. На вкладке **История** выберите старый релиз → **Откат** → проверьте последствия → подтвердите. Публичный снимок изменится только внутри браузерной демо-модели. +7. На вкладке **Журнал** проверьте события. На вкладке **Кандидат** можно отдельно проверить failed build. + +## Архитектура и ограничения + +Нельзя считать demo-publish реальной публикацией. Все операции выполняются в JS и `localStorage`; записи меняют лишь состояние прототипа. Отсутствуют атомарная файловая публикация, реальные сборки и серверный RBAC. В реальном Site Engine операции должны идти через **единый сервисный слой** для API, CLI и MCP, с `if_match`, структурной и публикационной валидацией, staging/snapshot и проверенным атомарным переключением live. + +Уже существующие редакторы Page/Entry используют отдельные фиксированные демо-live данные (`build_00027`), поэтому live-специфичный рендер на их экранах пока **не синхронизируется** с клиентской моделью Этапа 5. Это задача интеграции с backend. Сохранённые `Page`/`Entry` данные (при доступности `localStorage`) подхватываются; несохранённые изменения в другой вкладке — нет. + +История контентных ревизий может быть реализована через Git или revisions; источник пока не утверждён. Схема формы при rollback проверяется отдельно от immutable HTML-снимка. + +Для полного локального поведения кросс-страничного `localStorage` предпочтительно открыть каталог через простой локальный HTTP-сервер (например, `python -m http.server 8000`) и перейти на `http://localhost:8000`. Одиночные HTML-прототипы можно посмотреть как файлы, однако ограничения `file://` различаются по браузерам. + +## Структура + +```text +index.html галерея этапов и тем +publication-antirion.html 04 — публикация +publication-rose-graphite.html 06 — публикация +assets/publication.css общий styling / темы +assets/publication.js mock release state / actions +builder-antirion.html 04 — Конструктор + Эксперт Page +builder-rose-graphite.html 06 — Конструктор + Эксперт Page +content-antirion.html 04 — Конструктор + Эксперт Entry +content-rose-graphite.html 06 — Конструктор + Эксперт Entry +antirion.html, antirion-rework.html, +ember-graphite.html, rose-graphite.html четыре согласованных концепта +assets/* ассеты и скрипты предыдущих этапов +previews/* screenshots / acceptance +CHANGELOG.md полный журнал изменений +docs/STAGE5_QA.md QA и ограничения +``` + +## Будущий перенос на FastAPI / Jinja2 / htmx + +| UI | Jinja partial | Сервис / контракт | +|---|---|---| +| Workspace | `publication/_changes.html` | `workspace.diff(live_build_id)` | +| Check / validate | `publication/_validation.html` | `release.validate(workspace_hash)` | +| Candidate | `publication/_candidate.html` | `release.build(snapshot_id, if_match)` | +| Publish | `publication/_publish_dialog.html` | `release.publish(build_id, if_match)` | +| History / details | `publication/_history.html`, `_details.html` | `release.list`, `release.get`, `release.files` | +| Rollback preview + confirm | `publication/_rollback.html` | `release.rollback_preview`, `release.rollback(build_id)` | +| Audit | `publication/_audit.html` | `audit.list`, `audit.append` | + +**Контрольная точка:** пройти цикл публикации и отката, оценить читаемость статусов и возможность быстро исправлять ошибки. Следом — Этап 6: Медиа, Структура, Формы, Настройки, Журнал, RBAC и финальный UX/адаптивность. diff --git a/design/docs/README_STAGE6.md b/design/docs/README_STAGE6.md new file mode 100644 index 0000000..d83ae1d --- /dev/null +++ b/design/docs/README_STAGE6.md @@ -0,0 +1,91 @@ +# Site Engine — Этап 6: полный HTML-прототип админки + +**Два активных оформления:** `04 Antirion Rework` и `06 Rose Graphite` (ранее YuE Studio). **Четыре зафиксированных концепта 03–06 сохранены.** Пакет работает локально, без обязательных CDN, Node.js и backend. + +Откройте `index.html`, затем новый экран Этапа 6 нужной темы. Переходы в разделы 6.1–6.5 встроены в боковое меню прежних экранов 04/06. Для надёжного общего localStorage при многовкладочной работе используйте локальный HTTP-сервер, например `python -m http.server 8000`; URL: `http://localhost:8000`. + +## Активные новые экраны + +| Тема | HTML | Внутренние разделы | +|---|---|---| +| 04 Antirion Rework | `modules-antirion.html` | `?section=media`, `structure`, `forms`, `settings`, `journal` | +| 06 Rose Graphite | `modules-rose-graphite.html` | те же пять разделов | + +Два новых файла используют **общую** логику `assets/stage6.js` и слой стилей `assets/stage6.css`, опирающийся на уже утверждённый дизайн Stage 5. При переключении между темами сохраняется одна локальная демо-модель данных Stage 6. Файлы 03 и 05 не расширялись. + +## 6.1 — Медиабиблиотека + +- Сетка / таблица, поиск по имени/пути/alt, типы и папки; создание папки. +- Выбор ассета, инспектор: файл, тип, размер, `alt`, `caption`, статус и список «Где используется?». +- Локальная загрузка PNG/JPEG/WEBP/SVG/PDF/ZIP до 2 МБ (по одному). Превью малых растровых изображений до 300 КБ сохраняется в browser `localStorage`, остальные файлы **только регистрируются как демо-метаданные**, не создавая физического файла. SVG в HTML не встраивается. +- Подтверждение удаления; ассет с известными зависимостями превращается в `missing`, не затирая привязки. Состояния `missing` и незаполненный `alt` видны в UI. +- Ограничение: автоматическое построение карты зависимостей — пример на фиксированных данных; динамическая индексация при backend-интеграции. + +## 6.2 — Структура + +- Меню: выбор, добавление пунктов, изменение названия/URL, скрытие/показ, порядок вверх/вниз, создание нового меню, предпросмотр, YAML-контракт. +- Каталог Layouts с регионами `header`/`main`/`footer`, fixed/allow; каталог Fragment с декларативными полями; Display templates с маршрутом коллекций. +- «Где используется?» для схемных объектов и переходы к редакторам. +- Код Jinja/CSS/JS — только контекст и просмотр демо-шаблона; редактирование кода через прототип **не поддерживается**, а в будущем требует роли `developer`. + +## 6.3 — Формы и заявки + +- `form_contact`, `form_brief`: включение/отключение полей, required, сообщение после отправки, статус, уведомления Telegram/email (статус доставки — только mock). +- Предпросмотр схемы и тестовая неотправляемая кнопка «Отправить (симуляция)». +- Таблица заявок, фильтр статуса, просмотр, «В работу», «Закрыть», mock-повтор доставки, CSV с **вымышленными** контактами. +- Owner видит тестовые персональные данные. Developer, Editor, Reviewer и Agent **не видят** контактные поля. Это демонстрация UX; реальную защиту обеспечивает только серверный RBAC. +- Версия схемы связана с релизом: UI предупреждает о необходимости сохранения совместимости при rollback. Live-схема автоматически не переключается. + +## 6.4 — Настройки и доступы + +- `site.yaml`: название, домен, описание, контактная почта, язык. +- Тема сайта: цвета и радиус, интерактивный sample; не изменяет палитру самой админки. +- `data/*.yaml`: создание, изменение и удаление глобальных пар `key → value`. +- `redirects.yaml`: CRUD, проверка URL и простейших циклических редиректов. +- Демонстрационные пользователи, роли, табличный статус доступа; переключение роли для UX-проверки. +- MCP-агенты: имитация создания с `read` или `draft-only` scopes и отключения. **Токены и секреты не создаются**, не показываются и не передаются куда-либо. +- Build: параметры preview, minify и удержания релизов; кнопка ведёт в Stage 5. + +## 6.5 — Журнал и финальный UX + +- Единый демо-журнал операций Stage 6; отображает также доступную историю Stage 5, если сохранена в localStorage текущего origin. +- Поиск, фильтры, детали, экспорт CSV, подтверждение сброса локального журнала (Owner). +- Видимый focus, Esc/Tab, Ctrl/Cmd+K (быстрый переход), мобильное боковое меню, адаптивные таблицы с внутренним скроллом. +- Проверены размеры 1440×900, 1280×800, 1024×768, 768×1024, 390×844, 360×740, а также отдельные 390px-превью **всех пяти разделов в обеих темах**. + +## Сохранившиеся этапы и концепции + +| Файл | Назначение | +|---|---| +| `antirion.html` | 03 Antirion, фиксированный концепт | +| `antirion-rework.html` | 04 Antirion Rework, shell | +| `ember-graphite.html` | 05 Ember Graphite, фиксированный концепт | +| `rose-graphite.html` | 06 Rose Graphite, shell; без скруглений **только выбор коллекции** в Контенте | +| `builder-antirion.html`, `builder-rose-graphite.html` | Этапы 2–3: Конструктор и Эксперт Page | +| `content-antirion.html`, `content-rose-graphite.html` | Этап 4: коллекции и записи Entry | +| `publication-antirion.html`, `publication-rose-graphite.html` | Этап 5: кандидат, publish, история, rollback | +| `modules-antirion.html`, `modules-rose-graphite.html` | Этап 6: пять дополнительных разделов | + +## Ограничения и следующий этап + +Это **не production CMS**. Здесь нет настоящего сохранения файлов, серверных прав, безопасных сессий, CSRF, обработки реальных заявок, SMTP/Telegram, MCP-ключей, загрузки на сервер, настоящих release build и атомарного переключения live. Данные преимущественно синтетические, операции Stage 6 сохраняются в `localStorage` при его доступности. Состояние ранее разработанных редакторов и Stage 5 *не унифицировано полностью* в одном клиентском store: это предмет service/API-интеграции. + +**Этап 7 (следующий):** техническая карта переноса на FastAPI + Jinja2 + htmx, единый сервисный слой, схема file-first документов, серверный RBAC, конкуренция `if_match`, аудит, обработка заявок и release pipeline. Реализация backend — отдельная задача после утверждения технического дизайна. + +## Проверки + +- `docs/test_stage6.py` — сценарии интерактивности обеих тем, 6 разрешений. +- `docs/test_stage6_views.py` — все 5 экранов × 2 темы, desktop/mobile + отсутствие горизонтального переполнения. +- `docs/STAGE6_QA_TEST_OUTPUT.txt` и `docs/STAGE6_VISUAL_QA.json` — машинные результаты, `previews/stage6-*` — скриншоты. + +### План для Jinja partials + +| Экран | Partial | Основные сервисы | +|---|---|---| +| Медиа | `media/_grid.html`, `_asset_detail.html`, `_picker.html` | `asset.list/get/upload/edit/delete`, `dependency.references` | +| Структура | `structure/_menu_editor.html`, `_layout_detail.html`, `_fragments.html` | `menu.*`, `layout.list/get`, `fragment.list/get`, `display.*` | +| Формы | `forms/_schema.html`, `_submissions.html` | `form.*`, `submission.list/get/update`, `delivery.retry` | +| Настройки | `settings/_site.html`, `_theme.html`, `_access.html`, `_mcp.html` | `site.settings`, `theme.*`, `users.*`, `agents.*`, `redirects.*` | +| Журнал | `audit/_events.html` | `audit.list/get/export` | + +Все модификации проходят единые серверные permissions/validation/audit, независимо от входа через UI/CLI/MCP. Никакое действие клиента не считается проверкой прав. diff --git a/design/docs/STAGE3_README.md b/design/docs/STAGE3_README.md new file mode 100644 index 0000000..8b64363 --- /dev/null +++ b/design/docs/STAGE3_README.md @@ -0,0 +1,177 @@ +# Site Engine — Этап 3: Конструктор и Эксперт (интерактивный HTML) + +**Актуальные активные варианты:** `04 Antirion Rework` и `06 Rose Graphite`. Остальные утверждённые оформления `03 Antirion` и `05 Ember Graphite` сохранены неизменёнными в архиве. Откройте `index.html` и выберите редактор. Все HTML работают без серверного API, npm или внешних CDN. + +## Исправление верхнего переключателя режима (2026-11-11) + +При открытии страницы в редакторе по умолчанию активен и визуально выделен **«Конструктор»**. При выборе **«Эксперт»** активная кнопка и заголовок меняются вместе с редактором; обратное переключение восстанавливает выделение «Конструктор». Проверено в обеих активных темах. + +## Реализовано в Этапе 3 + +- Переключатель «Конструктор / Эксперт» работает с **одним объектом Page**. Блоки, поля, SEO, bindings и Markdown синхронизируются в обоих направлениях. Корректные изменения в исходнике автоматически применяются примерно через 650 мс или по кнопке **Применить**. +- Файловое дерево слева, YAML front matter + Markdown по центру (подсветка, номера строк, поиск, Tab = два пробела), превью и диагностика справа. На мобильных экранах редактор и остальные панели располагаются вертикально. +- Структура документа: `schema`, `title`, `route`, `layout`, `status`, `seo`, `regions.main[]`, `id`, `fragment`, `visible`, `anchor`, `note`, `props`, `bindings` и Markdown body. Фиксированные `site_header / site_footer` принадлежат layout, не могут быть удалены правкой Page. +- **Валидатор разделён:** ошибки синтаксиса/схемы *останавливают применение к общему состоянию*; публикационные ошибки (невалидные ссылки, отсутствующие ресурсы и т. п.) *допускают локальное сохранение черновика*, но помечаются отдельно. В Expert нет обхода общих правил Page. +- **Безопасное переключение:** неверный YAML не уничтожает исходный текст, не меняет последний корректный Page и не позволяет уйти в Конструктор без выбора. Буфер сырого исходника сохраняется отдельно в памяти (и в `localStorage`, где разрешено). Неподдерживаемые ключи блокируются, а не отбрасываются. +- **Source diff** в модальном окне: построчное сравнение YAML/Markdown с последним сохранённым draft или неизменяемым mock-live `build_00027`. Предпросмотр Live остаётся прежним. +- **Конфликт версий:** кнопка «Симулировать 409 Conflict» изменяет локальный mock-server revision. Следующее сохранение предложит сравнить my/server и явно выбрать действие. В реальной CMS механизм будет опираться на серверный ETag / `if_match` и RBAC. +- Комментарии YAML сохраняются в исходном буфере. Для перехода к Конструктору, который может пересоздать YAML без комментариев после редактирования, показывается предупреждение и хранится резервная копия. Форматирование с комментариями также запрашивает подтверждение. + +## Проверка за 5 минут + +1. `builder-rose-graphite.html` → **Эксперт**. Измените `regions.main[0].props.title` и нажмите «Применить». Вернитесь в Конструктор: заголовок Hero в инспекторе должен совпасть. +2. В Конструкторе поменяйте описание Hero или добавьте FAQ. Вернитесь в Эксперт: YAML содержит эти изменения. Добавьте в Markdown body новый текст; проверьте его во вкладке «Страница» конструктора. +3. Измените `schema: "page/v1"` на `schema: [wrong]`, попробуйте вернуться в Конструктор. Должно появиться сообщение со строкой и безопасными вариантами. После исправления переход работает. +4. Нажмите **Сравнить** в режиме Expert. Выберите «С live» или «С сохранённым» и просмотрите добавленные/удалённые строки. +5. Нажмите «Симулировать 409 Conflict», затем «Сохранить черновик»: сравните мою и mock-серверную версии. Выберите оставить свои правки или явно подтвердите перезапись. Live не меняется. + +## Границы прототипа / будущая реализация + +- YAML реализован **не полностью**: поддерживается ограниченное подмножество, достаточное для показанной схемы. Не поддерживаются anchors/aliases, произвольные теги, flow collections, сложные ключи или сохранение позиции комментариев после правки в Конструкторе. Неподдерживаемые конструкции дают ошибку, не приводят к незаметной потере данных. В настоящем backend понадобится полноценный YAML 1.2 парсер, schema validation и round-trip механика. +- Это **design prototype**, не код реальной CMS. Файлы `pages/*.md` не редактируются на диске, `localStorage` не годится как production storage. Нет FastAPI, SQL, настоящих Jinja permissions, CSRF, Git revision history, атомарной публикации и реального 409/ETag. Ввод исходника не даёт прав на layouts/fragments, CSS, JS, схемы и секреты. +- Реальная публикация, история релизов и откат будут в Этапе 5. В Этапе 4 следующим шагом проработаем типизированные записи `Entry`, коллекции и Display templates. + +## QA + +Playwright + системный Chromium: оба редактора на `1440×900`, `1280×800`, `1024×768`, `768×1024`, `390×844`, `360×740` — без ошибок JS/горизонтального переполнения. Пройдены проверки корректного и ошибочного YAML, multiline string `|-`, Markdown, неизвестных ключей, комментариев, source diff, mock-конфликтов и синхронизации Constructor↔Expert. Изображения в `previews/stage3-*.png`. Старые утверждённые скриншоты сохранены. + +## Карта для FastAPI + Jinja2 + htmx (после согласования UX) + +| Интерфейс | Будущий partial | Контракт | +|---|---|---| +| Конструктор / Эксперт | `editor/_mode_tabs.html` | `page.get`, `permissions`, `if_match` | +| YAML / Markdown | `editor/_source_editor.html` | `document.read`, `document.validate`, `document.save` | +| Проверки + diff | `editor/_diagnostics.html`, `_source_diff.html` | `validate.schema`, `validate.publish`, `revision.diff` | +| Конфликт 409 | `editor/_conflict_dialog.html` | `if_match`, `revision.get`, `revision.compare`, `document.save` | +| Preview | `editor/_preview.html` | `preview.render` | + +--- + +## История: предыдущие этапы + +# Site Engine · Этап 2.4 — завершение Конструктора страниц + +**Развиваем две темы:** `04 Antirion Rework` (`builder-antirion.html`) и `06 Rose Graphite` (`builder-rose-graphite.html`). В архиве сохранены и **два других утверждённых shell-варианта**: `03 Antirion` и `05 Ember Graphite`; в них новых экранов конструктора нет. Запуск: откройте `index.html` или HTML-файл редактора локально. Node, CDN и сервер не нужны. + +## Новое в 2.4 + +- **Три явно разделённых состояния:** несохранённые правки workspace, сохранённый локальный draft, неизменяемый демонстрационный `LIVE build_00027`. Статус `published` в файле не означает, что текущая редакция уже видна на live. +- **Сохранение черновика:** `Сохранить черновик` или `Ctrl+S` записывает рабочие Page/Block в `localStorage` (если разрешено браузером). После сохранения показывается индикатор и локальное время. Сохранять можно даже неполную страницу; публикация здесь не производится. +- **Отмена правок:** кнопка «Отменить» с подтверждением восстанавливает *весь текущий workspace* из последнего локального сохранения. Live не изменяется. Действие применяется ко всем страницам, о чём интерфейс явно предупреждает. +- **Проверка перед публикацией:** отдельный интерактивный список *ошибок* и *предупреждений* по всем Page в workspace. Ошибки трактуются как блокирующие mock-публикацию; предупреждения — нет. Нажатие на проблему открывает нужную страницу, блок и поле инспектора. Проверяются отсутствующие привязки/ассеты, неопубликованные ссылки, title/route/SEO, повторяющиеся anchors и отсутствие видимого `richtext` для Markdown body. Это **клиентский mock-валидатор**, серверную проверку он не заменяет. +- **Раздел «Страница»:** SEO title / description с счётчиками длины и условным поисковым превью, поля route/layout/status, Markdown body и безопасный упрощённый Markdown-просмотр (`#`, `##`, `###`, акценты, ссылки, списки). При отсутствии видимого richtext предлагается добавить его. +- **Сравнение с двумя базами:** данные/поля и схематичная визуальная сверка **Workspace ↔ Saved draft** и **Workspace ↔ Live**. Показываются изменения Page, SEO, props, bindings, видимости и порядка блоков. Для полноразмерного сравнения используйте превью «Черновик / Live». Схематичная сверка — **не pixel-perfect diff**. +- **Исправления:** при выборе поля через маппинг, редактировании и сохранении корректно обновляются статусы; URL вводится как есть и проверяется (без скрытой автоматической нормализации). Доработаны состояния и адаптивность диалогов на телефонах. + +## Сценарии проверки + +1. Открыть Конструктор → «Страница» → изменить SEO title/description и Markdown body. Проверить поисковое и Markdown-превью, затем статус «Не сохранено». +2. Нажать «Проверить». Переключить фильтры «Ошибки»/«Предупреждения», нажать на предупреждение о `body` или неопубликованной ссылке. Инспектор должен открыть соответствующее поле. +3. Ввести route без начального `/` и запустить проверку. В списке появится **блокирующая ошибка**, по нажатию на которую откроется поле URL. +4. Нажать «Сравнить» → выбрать Live / Saved draft; переключить «Данные и поля» / «Визуально (схема)». После правки отличия должны отображаться; после сохранения отличия с Saved draft исчезнут, а с Live останутся. +5. Выбрать «Live» в центральном превью: оно продолжает показывать исходный mock-релиз. Изменения в workspace и сохранение не публикуются. Попробовать отменить несохранённые изменения с подтверждением. + +## QA + +Playwright + Chromium: обе темы, размеры `1440×900`, `1280×800`, `1024×768`, `768×1024`, `390×844`, `360×740`: без горизонтального переполнения и ошибок JavaScript. Сценарии включали SEO/Markdown, переход к ошибке, сохранение, оба режима сравнения и проверку битого ассета. Актуальные скриншоты: `previews/stage24-*.png`. + +## Ограничения + +Это **design prototype с локальными mock-данными**, а не реализация файлового движка. Реальные `pages/*.md` и `site.yaml` не меняются; нет backend/API, Git revisions, атомарной публикации, реальных прав доступа, серверной проверки и отката. Клиентское `localStorage` не является надёжным хранилищем черновиков или реальной revision history. Если браузер запрещает storage для локальных `file://`, сохранение останется только в памяти вкладки. В Этапе 3 появится режим «Эксперт» с YAML + Markdown и безопасным переключением; полноценные публикация, история и rollback — Этап 5. + +--- + +# Site Engine · Этап 2.3 — Маппинг данных + +**Интерактивные HTML-редакторы:** `builder-antirion.html` (04 Antirion Rework) и `builder-rose-graphite.html` (06 Rose Graphite). В архиве также сохранены утверждённые админки 03 и 05 — без изменений. Откройте `index.html` или любой HTML локально, без Node/CDN/backend. + +## Новое в 2.3 + +- **Карта источников:** левый переключатель **«Связи данных»** разворачивает цепочку `Page → Layout → Region → Block ID → Fragment → props → источник → результат` по каждому полю. Отображаются типы `literal / bind / query / ref / asset / link`, а также количество проблемных привязок. +- **Инспектор → «Связи»:** тип источника, конкретный путь и вычисленное демо-значение, предупреждение/ошибка у проблемного поля и действие **«Сменить источник»**. +- **Выбор источника без YAML:** поиск по полям Page, `data.company.*`, коллекциям, записям, ассетам и URL. Есть специальные несуществующие источники для тестирования ошибок. Изменения обновляют общее состояние Page/Block и iframe-превью без сброса прокрутки. +- **Collection query:** `collection`, `sort: order/title`, `limit: 1–12`. `services`, `scenarios`, `cases`, пустые `courses/posts`. Демо-entries имеют статус `published/draft`. +- **Прямые refs:** новый Fragment `entry_card` с привязкой к конкретной записи, публичным URL и демонстрацией отсутствующей записи. Медиафайл блока `image` выбирается из медиатеки. Ссылки кнопок — из существующих Page/Entry. +- **«Где используется?»**: поиск упоминаний коллекции, записи (включая динамические collection_list), ассета, маршрута или data-поля во всех демо-страницах. Список результатов ведёт прямо к Page → Block в редакторе. +- **Валидация:** несуществующие Collection/Entry/Binding/URL дают ошибки, отсутствующий Asset, ссылка на draft и пустая Collection дают предупреждения. Сохранение черновика доступно даже при ошибках публикации; это локальный mock, не deploy. + +## Что проверить + +1. Откройте `builder-rose-graphite.html`, нажмите **«Связи данных»** слева, выберите `services_list`. Справа откройте **«Связи»** → у `collection` нажмите **«Сменить источник»**, выберите `cases`. Проверьте превью и индикатор изменений. +2. Нажмите **«Где используется?»** у выбранной коллекции — в появившемся списке выберите использование, чтобы перейти к нужному блоку. Откройте **«Каталог данных»**, посмотрите записи и медиа. +3. В каталоге Fragment добавьте `Запись коллекции`, выберите `services/ai`, затем через «Где используется?» посмотрите прямые и динамические ссылки на запись. +4. На странице «О компании» выберите `team_asset` и `assets/missing.webp`, затем **«Проверить»**. Проверьте предупреждение и верните существующий ассет. +5. Поставьте для коллекции `missing_collection`, запустите проверку, затем исправьте выбор. Проверьте сохранение черновика, Live/Workspace и отсутствие скачка прокрутки при выборе блока. + +**Границы прототипа:** каталоги, ресурсы, связи и build ID демонстрационные. Исходные Markdown/YAML-файлы не изменяются. Обратные зависимости рассчитываются в браузере; в production они должны обрабатываться сервисом Site Engine. 2.4 продолжит работу над состояниями, 3 добавит реальный Expert UX; миграция к FastAPI/Jinja2/htmx — только после утверждения дизайна. + +--- + +# Site Engine · Admin Design Lab · Этап 2 (Конструктор страниц) + +**Направления в активной разработке:** `04 Antirion Rework` и `06 Rose Graphite`. **Rose Graphite** — новое собственное название ранее утверждённого **YuE Studio**, не новая палитра. В тёмном 06 **только выбор коллекции** в разделе «Контент» остаётся без скруглений, как согласовано. Весь остальной визуальный стиль старых четырёх вариантов сохранён. + +## Быстрый старт + +Откройте `index.html` локально без сервера, Node.js, CDN и каких-либо установок. Вверху находятся два интерактивных редактора. + +- **`builder-antirion.html`** — Конструктор в светлой рабочей стилистике Antirion Rework. +- **`builder-rose-graphite.html`** — тот же Конструктор в тёмной стилистике Rose Graphite. +- На прежних экранах `antirion-rework.html` и `rose-graphite.html` можно выбрать страницу и нажать **«Редактор»** — откроется новый Конструктор с выбранной страницей. +- Вновь утверждённые стили 03 и 05 сохранены как `antirion.html` и `ember-graphite.html`, но Конструктор для них не разрабатывался. + +## Что работает в Конструкторе + +| Возможность | Сценарий | Статус | +|---|---|---| +| Page selection | Смена страницы в верхнем селекте; несколько демонстрационных Page | Работает локально | +| Layout + регионы | Дерево `header / main / footer`, фиксированные шапка и подвал | Работает локально | +| Выбор блоков | Клик в дереве прокручивает iframe к блоку (если он не целиком виден); клик по секции внутри iframe не прокручивает | Работает | +| Каталог Fragment | Кнопка `+`, поиск и фильтр по категории, добавление в `main` с переходом к новому блоку; `hero` ограничен одним экземпляром | Работает | +| Изменение порядка | Кнопки «Выше / Ниже», drag & drop между блоками одного региона; переход к новой позиции в preview | Работает | +| Действия | Дублирование, скрытие/показ, удаление с подтверждением | Работает | +| Inspector | Поля по типу Fragment, Anchor, заметка, видимость | Работает | +| Binding | Для отдельных текстовых полей переключение literal / page.title / data.company.name / entry.title | Работает (упрощённо) | +| Collection query | Выбор `services/scenarios/cases`, limit, карта источников | Работает (упрощённо) | +| Preview | Desktop / Tablet / Mobile, черновик / исходный mock-live, props; обновление полей без перезагрузки iframe | Работает | +| Page fields | Статус файла, route, layout, SEO, Markdown body | Работает | +| Валидация | Проверка обязательных значений, отсутствующей коллекции, отсутствующего asset, потерянного Markdown body | Работает локально | +| Черновик | Индикатор изменений, сохранение в `localStorage`, `Ctrl+S` | Работает локально | +| Diff | Сравнение текущего workspace с последним локальным сохранением | Работает локально | +| Expert | Экран-предупреждение + пример YAML/Markdown структуры | **Этап 3** | + +**Это прототип, не настоящий backend.** Никаких изменений файлов `pages/*.md`, FastAPI, SQL, Git, Jinja, проверок прав, CSRF, реальной публикации или серверного предпросмотра нет. Модель страницы в браузере создана на основе тех же сущностей: `Page`, `Layout`, `Region`, `Block`, `Fragment`, `props`, `bindings` и `collection`. Упрощённые моковые query/bind не заменяют финальный контракт схем. `Live` — фиксированная демонстрационная исходная версия; даже после сохранения Workspace она не меняется. Сохранения между разными локальными HTML-файлами могут быть изолированы политиками `file://` браузера. + +## Что проверить (за 5 минут) + +1. `index.html → 06 Rose Graphite → Открыть Конструктор`. Убедиться, что рабочая область — три панели, интерфейс компактный. +2. Выбрать `Hero`, заменить заголовок; изменение появится в iframe и в статусе **«Не сохранено»**. Затем выбрать `page.title` как источник заголовка — preview покажет название Page. +3. Открыть `Связи данных`, выбрать `services_list` и проверить `Page → Layout → Region → Block → collection`. Изменить `collection` или `limit` в Inspector. +4. Добавить `FAQ`, переместить его вверх, скрыть, включить, дублировать и удалить с подтверждением. +5. Открыть вкладку **«Страница»**, изменить Markdown body / SEO. Сохранить черновик, нажать **«Проверить»** и переключить превью **«Черновик / Live»**. Live не должен изменяться. + +## Карта будущих Jinja / htmx фрагментов + +| HTML-компонент | Jinja2 partial | Сервисный контракт | +|---|---|---| +| `.side`, `.top`, `.head` | `admin/_shell.html` / `_page_bar.html` | `page.list`, permissions | +| `.treepane`, `.tree-item` | `editor/_block_tree.html` | `page.get`, `block.move`, `block.add` | +| `.stagepane`, `#preview` | `editor/_preview.html` | `preview.render` | +| `.inspectpane`, `.field` | `editor/_inspector.html`, `_field.html` | `fragment.schema`, `block.update` | +| `.mapping-card` | `editor/_bindings.html` | `binding.resolve`, `usage.where` | +| `.modal` | `admin/_modal.html` | permission/CSRF/if_match | +| `validate`, `save`, `diff` | `editor/_validation.html` | `page.validate`, `page.save`, `page.diff` | + +## Следующие согласуемые этапы + +1. **2.3 выполнен** — источники, обратные связи и UX «Где используется?» (в локальном mock). +2. **2.4** — публикационные состояния и снимки; дополнительные настройки и адаптивная полировка. +3. **3** — Эксперт (YAML front matter + Markdown, diff, сохранение одного состояния и конфликты `409`). +4. **4–7** — Content, publication/rollback, прочие разделы, затем план интеграции FastAPI + Jinja2 + htmx. + +## QA + +**Навигация по блокам:** в обеих темах выбор из дерева (включая «Связи данных») прокручивает iframe до блока, только если он не помещается в видимой области. При выборе `site_header` прокрутка возвращается к началу; при клике по секции внутри iframe или изменении свойств текущая позиция сохраняется. Добавление, дублирование и перемещение блока ведут к его новой позиции. Для `prefers-reduced-motion: reduce` прокрутка мгновенная, иначе плавная. Дополнительно сохраняется положение прокрутки левого дерева при выборе. Проверено в Playwright/Chromium для двух тем на 1440×900, 1024×768, 390×844 и 360×740: нет горизонтального переполнения или ошибок JS. + + +Playwright + Chromium: `1440×900`, `1280×800`, `1024×768`, `768×1024`, `390×844`, `360×740` на обоих вариантах; проверена ширина документа, отсутствие JS-ошибок и цепочка добавления / редактирования / перемещения / скрытия / сохранения / валидации. Скриншоты расположены в `previews/`. diff --git a/design/docs/STAGE4_QA.md b/design/docs/STAGE4_QA.md new file mode 100644 index 0000000..b5c7a80 --- /dev/null +++ b/design/docs/STAGE4_QA.md @@ -0,0 +1,40 @@ +# Site Engine / Stage 4 — QA + +**Проверено в Chromium (headless) на HTML + локально внедрённых CSS/JS ассетах.** Браузерная политика этой среды блокирует навигацию к `file://` как URL, поэтому сквозные переходы по файловым ссылкам проверены статически (наличие targets, корректные `href`) и на уровне клиентских обработчиков. Это не тест настоящего backend. + +## Пройденные функциональные проверки, обе темы 04 и 06 + +- Начальное состояние: открыта коллекция `services`, запись `bots`, селектор «Конструктор» активен. +- Изменение Title меняет карточку превью и показывает несохранённое состояние. +- «Сохранить черновик» меняет workspace, не переключает Live. +- Вкладки: «Связи», «Где используется?», «Схема (READ ONLY)». +- Переключение в «Эксперт» создаёт YAML front matter + Markdown body. Редактирование Title, применение исходника, переключение в Конструктор — изменения синхронизируются. +- Некорректный YAML остаётся в редакторе. При попытке переключиться видна блокирующая модалка, резервный исходник можно сохранить. +- Комментарий YAML сохраняется после применения и возврата из Конструктора в Эксперт. +- Конфликт `409 Demo` блокирует сохранение и показывает отдельные варианты разрешения. +- Выбор/замена медиа через UI, Live/workspace preview, карточка/полная страница. +- Создание, сохранение, дублирование и подтверждённое удаление draft-записи. +- +30 демо-записей для большого списка, поиск и фильтры. +- В коллекции `cases`, запись `booking`: проверка обнаруживает отсутствующее изображение и направляет к проблемному полю. +- В `courses`/`posts` пустые выключенные списки не создают фиктивный контент. +- JavaScript-ошибок в указанных сценариях не выявлено. + +## Адаптивность + +| Viewport | Antirion Rework | Rose Graphite | +|---|---|---| +| 1440×900 | PASS | PASS | +| 1280×800 | PASS | PASS | +| 1024×768 | PASS | PASS | +| 768×1024 | PASS | PASS | +| 390×844 | PASS | PASS | +| 360×740 | PASS | PASS | + +Проверено отсутствие горизонтального скролла всего документа; на широких экранах независимая прокрутка панелей; на телефоне вертикальный поток. + +## Дополнительные проверки для backend-этапа + +- Работа с настоящими YAML 1.2 и Markdown-файлами, атомарная запись, version/hash, права и CSRF. +- Сквозной сценарий сохранённой записи → реальный display render → статическая сборка. +- Конкурентное редактирование с реальными 409 ответами сервера и аудиторским журналом. +- Полная клавиатурная доступность и screen reader review вне текущего автоматического smoke QA. diff --git a/design/docs/STAGE5_QA.json b/design/docs/STAGE5_QA.json new file mode 100644 index 0000000..7d96254 --- /dev/null +++ b/design/docs/STAGE5_QA.json @@ -0,0 +1,98 @@ +[ + { + "theme": "antirion", + "width": 1440, + "height": 900, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 1280, + "height": 800, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 1024, + "height": 768, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 768, + "height": 1024, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 390, + "height": 844, + "overflow": false, + "errors": [], + "mobile-menu": true + }, + { + "theme": "antirion", + "width": 360, + "height": 740, + "overflow": false, + "errors": [], + "mobile-menu": true + }, + { + "theme": "rose-graphite", + "width": 1440, + "height": 900, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 1280, + "height": 800, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 1024, + "height": 768, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 768, + "height": 1024, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 390, + "height": 844, + "overflow": false, + "errors": [], + "mobile-menu": true + }, + { + "theme": "rose-graphite", + "width": 360, + "height": 740, + "overflow": false, + "errors": [], + "mobile-menu": true + } +] \ No newline at end of file diff --git a/design/docs/STAGE5_QA.md b/design/docs/STAGE5_QA.md new file mode 100644 index 0000000..e67b8f3 --- /dev/null +++ b/design/docs/STAGE5_QA.md @@ -0,0 +1,40 @@ +# Этап 5 — QA и проверяемые сценарии + +Проверка выполнялась в Chromium headless через Playwright. Из-за ограничений браузерной среды исходники HTML/CSS/JS загружались в тестовую вкладку напрямую (без сетевого или файлового URL). Это позволяет проверить сценарии JS, DOM и CSS, но не является полной проверкой локального file://-режима. + +## Сценарий 1 — Публикация + +1. `index.html` → `publication-antirion.html` / `publication-rose-graphite.html`. +2. `Проверить`: обнаруживается ошибка `BIND-001` для `pages/request.md`. +3. `Исправить` → `Применить` → `Запустить validate`: блокирующих ошибок 0. +4. `Кандидат` → `Сформировать кандидата`: сохраняется полноценный снимок workspace и список изменённых файлов. +5. `Опубликовать` → ввести комментарий → `Симулировать публикацию`: live ID становится новым build ID, событие записывается в журнал. + +## Сценарий 2 — История и откат + +1. В `Истории` открыть ранее опубликованный `build_00027`. +2. Выбрать `Откат`, посмотреть последствия (количество файлов, версия формы). +3. Подтвердить. Live переключается на исторический снимок, workspace не изменяется; запись попадает в аудит. +4. Новый кандидат, если был, инвалидируется. + +## Сценарий 3 — Неуспешная сборка и неактуальный кандидат + +1. Нажать `Симулировать сбой` на вкладке «Кандидат». +2. Записан failed build, подробности доступны в логе; live ID остаётся неизменным. +3. При изменении сохранённых файлов из редактора и последующем обновлении публикации fingerprint перестаёт совпадать с кандидатом; создание свежего кандидата требует повторной проверки. + +## Сценарий 4 — Роли + +Нажать профиль OW/DEV/ED/RV: Owner и Developer могут создать кандидата и публиковать/откатывать; Editor и Reviewer могут проверять, но не создавать и публиковать релизы. Это только клиентская имитация RBAC. + +## Адаптивность + +Проверены 1440×900, 1280×800, 1024×768, 768×1024, 390×844, 360×740 в двух активных темах. Внешнего горизонтального переполнения и ошибок JavaScript в проверенных сценариях нет. На телефоне таблица прокручивается внутри своего контейнера, боковое меню выдвигается по кнопке. + +## Архитектурные ограничения демо + +- Нет FastAPI, атомарного переключения каталогов, сборщика, сервера RBAC, блокировки записи, надежного аудита. +- Содержимое редакторов Page/Entry считывается только из **сохранённых** локальных данных; unsaved изменения в других вкладках не видны. +- Публикационный снимок в Этапе 5 — отдельная клиентская модель; существующие превью Page/Entry из Этапов 3–4 имеют собственную фиксированную демо-версию live. Полная синхронизация этих моделей требует общего серверного сервиса релизов. +- Проверки поддерживают демо-набор ошибок (отсутствующая форма, меню и предупреждения медиа/статусов), а не весь набор Pydantic-схем. +- Для обработки форм при rollback требуется проверять контракт версии: старая форма должна поддерживаться текущим обработчиком. diff --git a/design/docs/STAGE5_QA_results.txt b/design/docs/STAGE5_QA_results.txt new file mode 100644 index 0000000..bfc3a35 --- /dev/null +++ b/design/docs/STAGE5_QA_results.txt @@ -0,0 +1,98 @@ +[ + { + "theme": "antirion", + "width": 1440, + "height": 900, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 1280, + "height": 800, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 1024, + "height": 768, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 768, + "height": 1024, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "antirion", + "width": 390, + "height": 844, + "overflow": false, + "errors": [], + "mobile-menu": true + }, + { + "theme": "antirion", + "width": 360, + "height": 740, + "overflow": false, + "errors": [], + "mobile-menu": true + }, + { + "theme": "rose-graphite", + "width": 1440, + "height": 900, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 1280, + "height": 800, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 1024, + "height": 768, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 768, + "height": 1024, + "overflow": false, + "errors": [], + "mobile-menu": false + }, + { + "theme": "rose-graphite", + "width": 390, + "height": 844, + "overflow": false, + "errors": [], + "mobile-menu": true + }, + { + "theme": "rose-graphite", + "width": 360, + "height": 740, + "overflow": false, + "errors": [], + "mobile-menu": true + } +] diff --git a/design/docs/STAGE6_QA.md b/design/docs/STAGE6_QA.md new file mode 100644 index 0000000..be34a09 --- /dev/null +++ b/design/docs/STAGE6_QA.md @@ -0,0 +1,33 @@ +# Этап 6 — отчёт визуального и функционального QA + +**Продукт:** Site Engine · Admin UI (HTML design prototype). 12 ноября 2026. + +## Проверенные функции + +| Сценарий | 04 Antirion Rework | 06 Rose Graphite | +|---|---|---| +| Медиатека: сетка, выбор, alt и сохранение | PASS | PASS | +| Структура: меню, добавление пункта, Fragment usage | PASS | PASS | +| Формы: optional/required и предпросмотр | PASS | PASS | +| Заявки: скрытие персональных данных для Reviewer | PASS | PASS | +| Настройки: новый редирект | PASS | PASS | +| Журнал: события, просмотр подробностей | PASS | PASS | +| Ctrl+K, быстрый переход к разделу | PASS | PASS | +| Основная навигация между пятью разделами | PASS | PASS | + +## Проверка ширины + +Для каждой темы проверены **1440×900, 1280×800, 1024×768, 768×1024, 390×844, 360×740** по основному рабочему экрану. Для каждого из 5 разделов дополнительно проверены desktop 1440 и mobile 390 (в сумме 20 скриншотов, включая обе темы и оба размера). Результаты находятся в `STAGE6_VISUAL_QA.json` и `STAGE6_QA_TEST_OUTPUT.txt`. Ни один проверенный раздел не вызвал горизонтального переполнения документа или незакрытой ошибки JavaScript. Таблицы могут иметь **внутренний** горизонтальный скролл на узком экране — это ожидаемое поведение. + +Тесты выполнялись в Chromium со встроенным `page.set_content` и локальным JS/CSS, поскольку окружение блокирует переходы на localhost. Для фактической локальной проверки готового архива рекомендуется открыть `index.html` или `python -m http.server` в обычном браузере пользователя. Скриншоты делают снимок рабочего макета; не являются подтверждением работы backend. + +## Ограничения / будущая работа + +1. Сохраняемые данные Stage 6 и Stage 5 находятся в отдельных клиентских mock-хранилищах; переход к одному серверному контракту откладывается до backend-интеграции. +2. Кнопки «загрузка», «уведомления», «публикация», «MCP scopes» в данном пакете демонстрируют UX, а не соответствующие рабочие системы. +3. Состояние безопасности *симулируется*. Требуются серверные RBAC, CSRF, безопасные сессии, аудит и защита PII. +4. Код Layout/Fragment и полноценные серверные схемы Form недоступны для изменения из этого этапа; в интерфейсе показан контракт и граница полномочий. +5. Ассеты/ссылки используют демонстрационную карту зависимостей, реальный `dependency.references` должен работать в сервисном слое. +6. Accessibility: протестированы видимые состояния фокуса и базовые keyboard-сценарии, но полноценный аудит WCAG, screen-reader и кросс-браузерное QA ещё требуется. + +**Статус:** Этап 6 design prototype завершён; следующий этап — техническое планирование интеграции с backend, затем отдельная реализация. diff --git a/design/docs/STAGE6_QA_TEST_OUTPUT.txt b/design/docs/STAGE6_QA_TEST_OUTPUT.txt new file mode 100644 index 0000000..fb806f1 --- /dev/null +++ b/design/docs/STAGE6_QA_TEST_OUTPUT.txt @@ -0,0 +1,4 @@ +{ + "errors": [], + "status": "pass" +} \ No newline at end of file diff --git a/design/docs/STAGE6_VISUAL_QA.json b/design/docs/STAGE6_VISUAL_QA.json new file mode 100644 index 0000000..c8d2233 --- /dev/null +++ b/design/docs/STAGE6_VISUAL_QA.json @@ -0,0 +1,75 @@ +{ + "checks": [ + { + "theme": "rose-graphite", + "section": "media", + "title": "Медиабиблиотека", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "rose-graphite", + "section": "structure", + "title": "Структура сайта", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "rose-graphite", + "section": "forms", + "title": "Формы и заявки", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "rose-graphite", + "section": "settings", + "title": "Настройки и доступы", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "rose-graphite", + "section": "journal", + "title": "Журнал действий", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "antirion", + "section": "media", + "title": "Медиабиблиотека", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "antirion", + "section": "structure", + "title": "Структура сайта", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "antirion", + "section": "forms", + "title": "Формы и заявки", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "antirion", + "section": "settings", + "title": "Настройки и доступы", + "desktopOverflow": 0, + "mobileOverflow": 0 + }, + { + "theme": "antirion", + "section": "journal", + "title": "Журнал действий", + "desktopOverflow": 0, + "mobileOverflow": 0 + } + ], + "errors": [] +} \ No newline at end of file diff --git a/design/docs/qa-playwright-log.txt b/design/docs/qa-playwright-log.txt new file mode 100644 index 0000000..980c6e0 --- /dev/null +++ b/design/docs/qa-playwright-log.txt @@ -0,0 +1,32 @@ +started content-antirion.html Telegram-боты {'collection': 'services', 'id': 'bots', 'mode': 'constructor', 'tab': 'fields', 'dirty': False, 'sourceDirty': False, 'issues': [{'severity': 'warning', 'field': 'related_scenarios', 'message': 'Связанная запись services пока не опубликована'}], 'live': 'build_00027', 'records': 8} +save msg Сохранено в workspace; live-релиз не изменён +source len 518 --- +schema: 1 +collection: "services" +id: "bots" +status: "published" +title: "Tele +PASS content-antirion.html errors [] +started content-rose-graphite.html Telegram-боты {'collection': 'services', 'id': 'bots', 'mode': 'constructor', 'tab': 'fields', 'dirty': False, 'sourceDirty': False, 'issues': [{'severity': 'warning', 'field': 'related_scenarios', 'message': 'Связанная запись services пока не опубликована'}], 'live': 'build_00027', 'records': 8} +save msg Сохранено в workspace; live-релиз не изменён +source len 518 --- +schema: 1 +collection: "services" +id: "bots" +status: "published" +title: "Tele +PASS content-rose-graphite.html errors [] +VIEW content-antirion.html 1440 900 {'sw': 1440, 'iw': 1440, 'sh': 900, 'ih': 900} errors [] +VIEW content-rose-graphite.html 1440 900 {'sw': 1440, 'iw': 1440, 'sh': 900, 'ih': 900} errors [] +VIEW content-antirion.html 1280 800 {'sw': 1280, 'iw': 1280, 'sh': 800, 'ih': 800} errors [] +VIEW content-rose-graphite.html 1280 800 {'sw': 1280, 'iw': 1280, 'sh': 800, 'ih': 800} errors [] +VIEW content-antirion.html 1024 768 {'sw': 1024, 'iw': 1024, 'sh': 2421, 'ih': 768} errors [] +VIEW content-rose-graphite.html 1024 768 {'sw': 1024, 'iw': 1024, 'sh': 2421, 'ih': 768} errors [] +VIEW content-antirion.html 768 1024 {'sw': 768, 'iw': 768, 'sh': 2788, 'ih': 1024} errors [] +VIEW content-rose-graphite.html 768 1024 {'sw': 768, 'iw': 768, 'sh': 2788, 'ih': 1024} errors [] +VIEW content-antirion.html 390 844 {'sw': 390, 'iw': 390, 'sh': 3085, 'ih': 844} errors [] +VIEW content-rose-graphite.html 390 844 {'sw': 390, 'iw': 390, 'sh': 3085, 'ih': 844} errors [] +VIEW content-antirion.html 360 740 {'sw': 360, 'iw': 360, 'sh': 3144, 'ih': 740} errors [] +VIEW content-rose-graphite.html 360 740 {'sw': 360, 'iw': 360, 'sh': 3144, 'ih': 740} errors [] +PASS extras content-antirion.html errors [] +PASS extras content-rose-graphite.html errors [] diff --git a/design/docs/qa-scripts/qa_stage5.py b/design/docs/qa-scripts/qa_stage5.py new file mode 100644 index 0000000..57a867a --- /dev/null +++ b/design/docs/qa-scripts/qa_stage5.py @@ -0,0 +1,40 @@ +from playwright.sync_api import sync_playwright +from pathlib import Path +import json +base=Path('/mnt/data/site-engine-admin-stage5') +with sync_playwright() as pw: + b=pw.chromium.launch(headless=True, executable_path='/usr/bin/chromium',args=['--no-sandbox','--disable-gpu','--disable-dev-shm-usage']) + for mode in ('antirion','rose-graphite'): + file=f'publication-{mode}.html' + page=b.new_page(viewport={'width':1440,'height':900},device_scale_factor=1) + logs=[] + page.on('pageerror', lambda e: logs.append(str(e))) + print('\nTEST',file) + try: + html=(base/file).read_text();css=(base/'assets/publication.css').read_text();js=(base/'assets/publication.js').read_text();html=html.replace('','').replace('','');page.set_content(html,wait_until='load',timeout=20000) + print('title',page.title(),'tabs',page.locator('.tabs .tab').count(),'deltas',page.locator('.table tbody tr').count()) + page.screenshot(path=str(base/'previews'/f'stage5-{mode}-changes-1440.png'),full_page=True) + page.get_by_role('button',name='Проверить',exact=False).first.click() + print('checks',page.locator('.check.bad').count(),page.locator('.check.warn').count()) + page.get_by_role('button',name='Исправить').first.click() + page.get_by_role('button',name='Применить').click() + page.get_by_role('button',name='Запустить validate').click() + print('validation',page.locator('.check.bad').count()) + page.get_by_role('button',name='Кандидат').first.click() + print('candidate tab',page.locator('.tab.active').inner_text()) + page.get_by_role('button',name='Сформировать кандидата').click() + print('after candidate',page.locator('.panel-body .mono').all_inner_texts()[:3]) + page.get_by_role('button',name='Опубликовать',exact=True).click() + print('modal',page.locator('.dialog h2').inner_text()) + page.get_by_role('button',name='Симулировать публикацию').click() + print('newlive',page.locator('.live-indicator').inner_text()) + page.get_by_role('button',name='Откат',exact=True).first.click() + print('rollback dialog',page.locator('.dialog h2').inner_text()) + page.get_by_role('button',name='Подтвердить демо-откат').click() + print('after rollback',page.locator('.live-indicator').inner_text()) + page.screenshot(path=str(base/'previews'/f'stage5-{mode}-history-1440.png'),full_page=True) + print('pageerrors',logs) + except Exception as e: + print('FAILED',repr(e));page.screenshot(path=str(base/'previews'/f'stage5-{mode}-failed.png'),full_page=True) + page.close() + b.close() diff --git a/design/docs/qa-scripts/qa_stress.py b/design/docs/qa-scripts/qa_stress.py new file mode 100644 index 0000000..a4bdfdf --- /dev/null +++ b/design/docs/qa-scripts/qa_stress.py @@ -0,0 +1,31 @@ +from pathlib import Path +from playwright.sync_api import sync_playwright +import json +base=Path('/mnt/data/site-engine-admin-stage5') +def inline(file): + html=(base/file).read_text();css=(base/'assets/publication.css').read_text();js=(base/'assets/publication.js').read_text();return html.replace('','').replace('','') +checks=[] +with sync_playwright() as pw: + br=pw.chromium.launch(headless=True,executable_path='/usr/bin/chromium',args=['--no-sandbox','--disable-gpu','--disable-dev-shm-usage']) + for kind in ('antirion','rose-graphite'): + for w,h in [(1440,900),(1280,800),(1024,768),(768,1024),(390,844),(360,740)]: + pg=br.new_page(viewport={'width':w,'height':h},device_scale_factor=1) + errors=[];pg.on('pageerror',lambda ex:errors.append(str(ex))) + pg.set_content(inline(f'publication-{kind}.html'),wait_until='load') + overflow=pg.evaluate('document.documentElement.scrollWidth > window.innerWidth') + menu=pg.locator('.mobile-menu').is_visible() + checks.append({'theme':kind,'width':w,'height':h,'overflow':overflow,'errors':errors,'mobile-menu':menu}) + if w==390: + pg.locator('.mobile-menu').click();assert 'menu-open' in pg.locator('.layout').get_attribute('class') + pg.locator('.mobile-cover').click();assert 'menu-open' not in pg.locator('.layout').get_attribute('class') + pg.screenshot(path=str(base/'previews'/f'stage5-{kind}-390.png'),full_page=True) + if w==1440: + pg.locator('[data-tab="checks"]').click() + pg.screenshot(path=str(base/'previews'/f'stage5-{kind}-checks-1440.png'),full_page=True) + pg.locator('[data-tab="history"]').click() + pg.screenshot(path=str(base/'previews'/f'stage5-{kind}-history-initial.png'),full_page=True) + pg.close() + br.close() +print(json.dumps(checks,ensure_ascii=False,indent=2)) +assert all(not x['overflow'] and not x['errors'] for x in checks) +(base/'docs'/'STAGE5_QA.json').write_text(json.dumps(checks,ensure_ascii=False,indent=2)) diff --git a/design/docs/stage7/001_ALIGNMENT.md b/design/docs/stage7/001_ALIGNMENT.md new file mode 100644 index 0000000..0fbdb22 --- /dev/null +++ b/design/docs/stage7/001_ALIGNMENT.md @@ -0,0 +1,21 @@ +# Stage7 и реализация 001 + +Приоритет и границы задаёт [specs/001-antirion-admin](../../../specs/001-antirion-admin/spec.md). Реализованный контракт и запуск: [runtime.md](../../../specs/001-antirion-admin/runtime.md); проверки: [verification.md](../../../specs/001-antirion-admin/verification.md). Stage7 сохраняется как история предложений, исходные reference-документы не переписываются. + +| Область | Состояние и контракт | +|---|---| +| Файлы и композиция | Реализованы dataclass, Page/Entry/Layout/Fragment, regions/slots, bind/link/query. Не переносить модель в БД/Pydantic-ядро. | +| YAML | Использовать query wrapper, richtext.content, hidden/requires; visibility не существует. Примеры исправлены под default и коллекцию services. | +| HTTP UI | Существующие URL сохраняются, публикация /admin/publish, поля csrf/etag. | +| 001 API | JSON /admin/api/v1/ + Pydantic DTO; htmx получает HTML от UI, серверный клиент использует ASGITransport. | +| Обзор и Pages, повторный перенос | Общий каркас принят; этап 2 подготовлен к проверке: оригинальные overview/pages, HTML-фильтры и выбор инспектора, создание draft. `PageRow.changed` сравнивает файл с активным релизом; новые manifests содержат SHA-256 опубликованных Page в `page_sources`, для старых без индекса сравнение неизвестно. Это не dependency diff/candidate из 002. Подробности и проверки — [design-transfer.md](../../../specs/001-antirion-admin/design-transfer.md). | +| Запись | ETag — SHA-256 байтов, один SiteLock, CAS/проверка/история/атомарная запись. Буфер меняется без записи, Save явный. | +| Превью | 001: отдельный origin, scoped token, epoch, CSP и проверенный postMessage. | +| Релизы | Существующий build сразу публикует. Immutable candidate/expected_live относятся к 002. | +| Медиа/структура | Загрузки, where-used, changeset/rename и настройки относятся к 003. | +| Доступ | Один env-admin в 001; пользователи/RBAC/audit UI — 004. | +| Формы/MCP | HTTP 501 и заготовки не являются готовыми возможностями; 005/006. | + +Номера ADR stage7 обозначают локальные предложения, а не замену [действующего журнала](../../../docs/TZ-site-engine-decisions.md). Stage7 ADR-001/002/004/005 пересекаются с действующими решениями о файлах, композиции, CAS и безопасности; уточнения 001 задаются её спецификацией. Stage7 ADR-003 про кандидаты относится к 002, ADR-006 — дорожная карта. Статус PROPOSED в исходном реестре сохранён; новые решения не объявляются принятыми задним числом. + +Примеры `examples/page-home.md` и `examples/entry-bots.md` подставлены вместо Page/Entry в изолированную копию studio-site: validate — 0 ошибок/0 предупреждений, build — 7 страниц. diff --git a/design/docs/stage7/01_ARCHITECTURE.md b/design/docs/stage7/01_ARCHITECTURE.md new file mode 100644 index 0000000..ab55a05 --- /dev/null +++ b/design/docs/stage7/01_ARCHITECTURE.md @@ -0,0 +1,146 @@ +# 01. Целевая архитектура Site Engine + +## 1. Принятый архитектурный ориентир + +**Модульный монолит Python, один сайт на инстанс.** Данный раздел — проект реализации в рамках исходного ТЗ, не описание уже готового backend. + +```mermaid +flowchart TD + U[Browser / htmx] --> H[FastAPI HTML routes] + AP[REST clients] --> A[FastAPI API routes] + MCP[MCP tools] --> S[Application services] + CLI[CLI] --> S + H --> S + A --> S + S --> P[Policies + validation + CAS + audit] + P --> R[File repositories / changesets] + P --> Q[Service repositories] + R --> F[(Canonical Site Files)] + Q --> D[(SQLite WAL)] + S --> B[Preview / Build / Release pipeline] + B --> F + B --> I[(Immutable build snapshots)] + I --> L[Live pointer / static server] +``` + +**Логические слои:** + +- `web/admin`: Jinja HTML, htmx partials, формы, обработка 409/422, UX навигация. +- `web/api`: контракт для технических клиентов, тот же application service, не HTTP loopback из admin. +- `mcp` и `cli`: адаптеры поверх сервисов, со своей аутентификацией/контекстом actor. +- `application`: use cases, транзакционные границы, права, валидаторы, аудит, idempotency. +- `domain`: модели Page/Entry/Layout/Fragment/Block/Release; разрешение привязок и маршрутов, инварианты. +- `infrastructure`: работа с файлами, SQLite, render/build, preview, уведомления, индекс зависимостей. + +## 2. Предлагаемая структура Python-пакета + +```text +site_engine/ + app.py # FastAPI app factory + config.py # только env/path/runtime-секреты + web/ + admin/ + routes.py # shell, pages, content, media, publication, ... + templates/ # Jinja pages + partials + static/ # согласованные CSS/JS, htmx локально + api/v1/ # machine-readable endpoints + public/ # формы, служебные endpoints, dev static + application/ + pages.py # get/patch/rename, read/write conflicts + entries.py # типизированный контент + dependencies.py # где используется? + media.py + structure.py + forms.py + settings.py + releases.py # validate/candidate/publish/rollback + auth.py + audit.py + domain/ + models.py # Pydantic models + typed refs + bindings.py + validators.py + routing.py + errors.py + infrastructure/ + files.py # safe paths, atomic write, changeset + sqlite.py # SQLAlchemy models & sessions + index.py # reindex, dependency index + renderer.py # Jinja/layout/fragment, markdown + builder.py # snapshot → dist/build-id + preview.py + notifications.py # SQLite outbox worker + storage.py # asset ingest, MIME & quotas + mcp/ + cli/ + migrations/ # Alembic для SQLite service data + tests/ +site/ # file-first content root; вне Python package + site.yaml + redirects.yaml + pages/ + content/ + collections/ + display/ + layouts/ + fragments/ + menus/ + data/ + forms/ + assets/ +var/ # не переносимый публичный контент + db/site-engine.sqlite + work/changesets/ + builds// + live-pointer +``` + +Это **предлагаемая** организация, а не подтверждённые имена импортов. Отделение `site/` и `var/` принципиально: `reindex` не требует старой DB для восстановления страниц, маршрутов и редиректов. + +## 3. Владение данными + +| Данные | Канонический источник | SQLite | +|---|---|---| +| Page + Markdown body | `site/pages/**/*.md` | только индекс и внешние ключи на стабильные ID | +| Entry | `site/content//*.md` | индекс и поиск по полям | +| Collection, Display | `site/collections/*.yaml`, `site/display/*.yaml` | перестраиваемые записи | +| Layout/Fragment/Menu/Data/Form/Site/Redirect | соответствующие YAML и шаблоны в `site/` | кэш, индекс зависимостей | +| Asset | `site/assets/*`, sidecar manifest если утверждён | хеш, metadata cache, usage index | +| User, session, token hash, roles/grants | SQLite | источник истины служебных данных | +| Submission, outbox, audit event | SQLite | источник истины служебных данных | +| Release metadata, publish events | SQLite + immutable snapshot manifest | синхронизированный служебный индекс; live определяется валидным pointer | + +**Важно:** `slug_history` как скрытый SQLite-источник публичных редиректов недопустим по принципу file-first; при переименовании URI обновляется `redirects.yaml` тем же changeset. Это предложение ревью P0-01, фиксируется ADR-001. + +## 4. Единый запрос без дублирования логики + +```text +Browser POST /admin/pages/{id}/blocks/patch + -> auth/session + CSRF + -> PageService.patch(actor, id, operations, if_match) + -> authorize(actor, "pages.write", target) + -> open document lock; verify hash; parse + schema validate + -> build next document; atomic changeset commit + -> update index; audit event + -> return PageSnapshot {document, etag, validation} + -> Jinja partials: tree, inspector, preview target, status + +MCP patch_page -> same PageService.patch(...) +CLI page patch -> same PageService.patch(...) +``` + +Права и валидация не зависят от выбранной темы и интерфейса. + +## 5. Источники изменений UI + +Для FastAPI/htmx **нет необходимости копировать большой JS-state** из прототипа. Сервер является источником общего состояния Page/Entry. Клиент хранит только кратковременный UI-state: выбранный блок, вкладку инспектора, открытое дерево, размер iframe и неотправленный текст Expert. После успешной операции сервер возвращает новые фрагменты интерфейса и `ETag`. + +Обе темы используют одни Jinja partials с небольшим классом корневой темы (`theme-antirion` / `theme-rose`) и CSS-токенами. 03 и 05 на этом шаге сохраняются как отдельные дизайн-концепты, не обязаны иметь новые backend-маршруты. + +## 6. Важные ограничения первой версии + +- Одна инсталляция — один сайт; мультисайтовости и e-commerce нет. +- Контент редактируется декларативно; свободный JS/Jinja/Python в режиме Expert запрещён, нужен отдельный developer workflow. +- Сначала детерминированная **полная сборка**; сложная инкрементальная сборка и широкий query DSL — только после реальных метрик и ADR. +- Сохранение синтаксически корректного, но неполного черновика допускается; публикация всегда со строгой валидацией. +- Реализация публичных форм и MCP возможна только после базовых auth/RBAC/CSRF/audit/обработки файлов. diff --git a/design/docs/stage7/02_UI_HTMX_MAP.md b/design/docs/stage7/02_UI_HTMX_MAP.md new file mode 100644 index 0000000..82d5093 --- /dev/null +++ b/design/docs/stage7/02_UI_HTMX_MAP.md @@ -0,0 +1,110 @@ +# 02. Карта UI → Jinja partials → htmx → application services + +**Статус:** предлагаемый HTTP-контракт для будущей реализации. Прототипы работают в браузере и НЕ имеют этих endpoints. URL-имена согласовать при первом вертикальном срезе. + +## 1. Экранный маршрут + +| Навигация | HTML route (GET) | Jinja page | Ключевые partials | Сервисы | +|---|---|---|---|---| +| Обзор | `/admin` | `overview/index.html` | `_status`, `_changes`, `_recent_activity` | `SiteStatus`, `ReleaseService`, `AuditService` | +| Страницы | `/admin/pages` | `pages/list.html` | `_table`, `_filters`, `_summary` | `PageService.list/get` | +| Page: Конструктор | `/admin/pages/{id}/edit?mode=constructor` | `pages/editor.html` | `_block_tree`, `_canvas`, `_inspector`, `_mapping`, `_toolbar` | `PageService`, `FragmentCatalog`, `PreviewService`, `DependencyService` | +| Page: Эксперт | `/admin/pages/{id}/edit?mode=expert` | тот же `pages/editor.html` | `_source_editor`, `_lint`, `_diff`, `_preview`, `_toolbar` | `PageService`, `SourceService`, `ValidationService` | +| Контент | `/admin/content` | `content/index.html` | `_collections`, `_entries`, `_filter`, `_empty` | `CollectionService`, `EntryService` | +| Entry: редактор | `/admin/content/{collection}/{slug}/edit?mode=constructor\|expert` | `content/editor.html` | `_schema_fields`, `_source`, `_relations`, `_display_preview` | `EntryService`, `CollectionService`, `PreviewService` | +| Публикация | `/admin/publication` | `publication/index.html` | `_workspace_changes`, `_validation`, `_candidate`, `_history`, `_release_detail`, `_audit` | `ReleaseService`, `BuildService`, `AuditService` | +| Медиа | `/admin/media` | `media/index.html` | `_grid`, `_table`, `_picker`, `_asset_detail`, `_usage` | `AssetService`, `DependencyService` | +| Структура | `/admin/structure` | `structure/index.html` | `_menus`, `_menu_editor`, `_layouts`, `_fragments`, `_display` | `MenuService`, `LayoutService`, `FragmentService`, `DisplayService` | +| Формы и заявки | `/admin/forms` | `forms/index.html` | `_form_fields`, `_schema`, `_submissions`, `_delivery` | `FormService`, `SubmissionService`, `OutboxService` | +| Настройки | `/admin/settings` | `settings/index.html` | `_site`, `_theme`, `_data`, `_redirects`, `_users`, `_agents`, `_build` | `SettingsService`, `AccessService`, `RedirectService` | +| Журнал | `/admin/audit` | `audit/index.html` | `_filter`, `_events`, `_details` | `AuditService` | + +Нормальный вход в редактор — `mode=constructor`; верхний селектор должен показывать **«Конструктор»**. Переход в Expert не создаёт второй документ. Этим устраняется ранее найденная UI-регрессия. + +## 2. Общая схема htmx взаимодействий + +Все HTML-запросы рендерятся FastAPI + Jinja. `hx-post`/`hx-patch` → **application service** → partial/redirect. Не создавать второй внутренний REST-вызов с того же сервера. + +| Сценарий | htmx request (рекомендация) | Фрагменты для обновления | +|---|---|---| +| Фильтр страниц | `GET /admin/partials/pages?query=&status=` | `#page-table`, `#page-count` | +| Выбор блока в дереве | `GET /admin/partials/pages/{id}/blocks/{block_id}/inspector` | `#block-inspector`, selection state | +| Изменение props | `PATCH /admin/pages/{id}/blocks/{block_id}` + `if_match`, CSRF | `#block-inspector`, `#tree`, `#dirty-status`, preview target | +| Добавление/движение | `POST /admin/pages/{id}/operations` с типизированными ops | `#block-tree`, `#preview`, `#inspector` | +| Выбор привязки | `POST /admin/pages/{id}/operations` | `#mapping`, `#inspector`, `#preview` | +| Проверка | `POST /admin/validate?scope=workspace` (не меняет файл) | `#validation-panel`, summary | +| Режим Expert | `GET /admin/partials/pages/{id}/source` | редактор + code status | +| Применить Expert | `PUT /admin/pages/{id}/source` + `if_match` | source diagnostics, tree, preview, dirty status | +| Сохранить черновик | `POST /admin/pages/{id}/save` или `PATCH ...` | статус и новый ETag | +| Данные записи | `GET /admin/partials/content/{collection}/{slug}` | editor/relations/preview | +| Выбор медиа | `GET /admin/partials/media/picker?kind=image` | modal contents | +| Сборка кандидата | `POST /admin/publication/candidates` | candidate panel + build log | +| Подтвердить publish | `POST /admin/publication/{build_id}/publish` | live status, history, audit | +| Подтвердить rollback | `POST /admin/publication/{build_id}/rollback` | live status, history, audit | + +Пример *эскиза* Jinja/htmx (не готовая реализация): + +```html +
+ + + + +
+``` + +Нельзя вставлять `page.id`/`block.id` из непроверенного URL в произвольный файловый путь. Не доверять `if_match` и CSRF как доказательству прав: нужен server-side RBAC. + +## 3. Переключение Constructor ↔ Expert + +1. GET страницы с `?mode=constructor` (явно активен селектор «Конструктор»). +2. В Constructor любое сохранённое изменение меняет канонический файл через PageService. В UI виден актуальный `ETag`. +3. Выбор `Expert` открывает исходник **той же ревизии**, в том числе Markdown body; не дублирует состояние в другой таблице. +4. При синтаксической ошибке YAML Expert остаётся на экране, показывает line/path, сохранение отклоняет; необработанный текст сохраняется **в UI buffer**, не попадает в канонический документ. +5. При switch back с неопубликованным исходником: `Применить и перейти` / `Остаться` / `Сохранить резервную копию текста` (с оповещением). Никаких тихих автопереписываний комментариев. +6. При `409` от сервера: отдельная панель `Моя версия / Текущая версия на сервере`; повторная отправка только на новом `if_match` после осознанного разрешения. + +**Конструктор и Эксперт должны сериализовать одно структурное дерево**. Прототипный `expert-codec.js` — образец UX, не полноценный YAML runtime; серверный парсер должен поддерживать принятую схему и запрещать/обрабатывать дополнительные конструкции явно. + +## 4. Preview ↔ дерево и инспектор + +Это уже утверждённый UX и его необходимо сохранить при переводе на серверный рендер: + +- Клик в iframe по блоку → подсветка, синхронизация дерева/инспектора, **без прокрутки**. +- Клик по блоку в дереве → preview scroll к блоку **только если он за пределами видимости**; если в пределах видимости, только выделение. +- Добавление/перестановка → переход к новому положению; изменение поля → не сбрасывать позицию iframe. +- Верх/фиксированный `site_header` → переход к началу. +- Учёт `prefers-reduced-motion`. + +Для preview использовать отдельный защищённый endpoint (в идеале отдельный origin), односторонний минимальный `postMessage` протокол с проверкой `origin`, `source` и `event.kind`; не использовать production-`'*'` из mock. При обновлении preview после PATCH лучше targeted refresh/DOM morph, сохраняющий scroll, либо явное сохранение+восстановление позиции. + +## 5. Представление ошибок/статусов и кодов + +| HTTP status | UI-состояние | +|---|---| +| `200` | Обновить нужный Jinja partial; вернуть новый ETag | +| `201` | Новый объект; открыть редактор или строку списка | +| `303` | После create/save полной формы перенаправить на GET | +| `400` | Ошибка контракта запроса, показать generic form error | +| `401` | Логин/истекшая сессия, безопасное перенаправление | +| `403` | Явное «Нет доступа», без утечки данных | +| `404` | Не найден объект (или скрытый по политике ресурс) | +| `409` | Конфликт `if_match`, сохранить локальный buffer, показать сравнение | +| `413` | Превышен лимит upload | +| `422` | Схемная/публикационная валидация с `field_path` | +| `429` | Rate-limit с понятной подсказкой | +| `500` | Не показывать трассировку/секреты; корреляционный ID и ссылка на журнал (если есть право) | + +**HTMX ошибки не заменять пустым контентом.** Для `409/422` используется custom `HX-Trigger`/обработчик `htmx:responseError` для соответствующей модалки; JSON API отдаёт Problem Details или согласованный JSON error DTO. Семантика одинаковая, формат ответа различается. + +## 6. Две темы без раздвоения функциональности + +- `base.html` и одинаковые partials; темы отличаются токенами и классом темы. +- Утверждённые стили 04/06 — визуальный baseline; нельзя «случайно» заменить все таблицы 06 на прямоугольные. +- `HX-Push-Url`/`hx-boost` для навигации, история и клавиатура доступны без SPA. +- Тесты компонентов: состав данных, ошибки, mobile, focus и screenshot на 1440×900 / 390×844. + +## 7. Рекомендуемые точки локальной интеграции JS + +Небольшой JS остаётся для Monaco/EasyMDE (после отдельного решения), iframe bridge, drag-sort, viewport selector, toast, focus-management. Не требуется переписывать весь Python backend в браузер и поддерживать параллельный store. htmx и Jinja — основной канал рендера и обновлений. diff --git a/design/docs/stage7/03_DOCUMENTS_AND_SERVICES.md b/design/docs/stage7/03_DOCUMENTS_AND_SERVICES.md new file mode 100644 index 0000000..9c6304b --- /dev/null +++ b/design/docs/stage7/03_DOCUMENTS_AND_SERVICES.md @@ -0,0 +1,144 @@ +# 03. Контракты документов, application services и API + +## 1. Canonical file model + +Содержимое сайта переносится вместе с `site/`: Page (`pages/**/*.md`), Entry (`content//*.md`), `collections/*.yaml`, `display/*.yaml`, layouts/fragments, `menus/*.yaml`, `forms/*.yaml`, `data/*.yaml`, `assets/`, `redirects.yaml`, `site.yaml`. Схема каталога описана в первичном ТЗ §4. + +### Page + +YAML front matter + Markdown body. Общие поля: `schema`, `title`, `layout`, `status`, `seo`, `regions`. Список `regions.main[]` содержит блоки со стабильным `id`, `fragment`, `props`, опциональными `slots`, `anchor`, `visibility`, `note`. Фиксированные header/footer принадлежат Layout, не копируются на каждую страницу. + +**Сохраняемый формат привязок:** в черновике ТЗ встречаются `{bind: page.title}`, `{page: contacts}`, `{entry: services/bots}`, `{collection: services, sort: order, limit: 6}`, а в JS-прототипе отдельное поле `bindings[key]={kind,...}`. Это **не равнозначные контракты**. Предлагается нормализованная типизированная внутренняя модель, сериализация — после ADR-002. Не сохранять слепо JS-поле `bindings` отдельно от `props`. + +См. полноценный образец `examples/page-home.md` с корректными маркерами YAML front matter `---` и Markdown body. Это иллюстрация **предлагаемого** формата: окончательную сериализацию привязок фиксируем в ADR-002. + +### Entry + +Типизированная запись `content//.md`; схема полей — в `collections/.yaml`; вывод через `display/.yaml`. Одна Entry не равна Page. В прототипе есть `fields`, `relations`, `body`, `slug`, `status` — это UI DTO, он не должен стать второй файловой моделью. + +### Layout / Fragment / Menu / Asset + +- Layout объявляет регионы, fixed блоки и `allow`. +- Fragment имеет декларативные fields и слоты, серверное разрешение типов и constraints. +- Menu и Redirect — YAML; `rename_page` атомарно переносит Page, правит связи/меню/redirects через changeset (не обязательно автоматически переписывать каждую внешнюю ссылку). +- Asset path — относительный и нормализованный; metadata/alt/caption — нужен отдельный ADR по размещению sidecar (файловый canonical) vs индекс DB; пользовательские тексты не должны исчезать после `reindex`. + +## 2. Два уровня валидации + +| Уровень | Условия | Итог | +|---|---|---| +| `draft` | Валиден YAML/Markdown front matter, базовые типы, путь/ID, безопасность | Сохранить неполный документ; выдать предупреждения о required/ссылках | +| `release` | Полные обязательные поля, версия фрагмента, allowed region/slots, uniqueness routes, все публичные references/media/forms, безопасность | Блокирующие errors запрещают кандидат; warnings допускаются | + +Ошибочный синтаксис Expert остаётся клиентским буфером (возможно отдельным серверным draft-source хранилищем **по ADR**), не перезаписывает canonical doc. + +## 3. DTO и результат сервиса + +Псевдосхема сервисных DTO (для обсуждения, не реализованные Pydantic классы): + +```text +PageSnapshot: + id: stable logical id + path: site-relative path + etag: sha256(canonical bytes + model schema version) + document: PageDocument + source_text: text (для Expert по доступу) + diagnostics: Diagnostic[] + workspace_revision: string + +Diagnostic: + severity: error | warning + code: e.g. REF_MISSING, ROUTE_COLLISION, FIELD_REQUIRED + file: pages/index.md + path: regions.main[1].props.source + block_id: services_list (optional) + line: integer (optional) + message: localized human-readable text + hint: optional + +ActionContext: + actor_id, actor_type, roles, scopes, request_id, expected_etag +``` + +Стабильные ID блоков полезны для ссылок/операций, но **сами по себе не обеспечивают конкурентную безопасность**. + +## 4. Основные application service операции + +| Сервис | Use cases (предлагаемые имена) | Важные инварианты | +|---|---|---| +| `PageService` | `list/get/create/patch/move_block/delete/rename/get_source/save_source` | if_match, typed ops, safe path, fixed region protected | +| `EntryService` | `list/get/create/patch/save_source/delete` | collection schema + display route, distinct Page/Entry | +| `CollectionService` | `list/get_schema` | content role читает; developer меняет schema/code | +| `DependencyService` | `where_used/resolve_binding/validate_refs` | работает по индексу + full validation, без клиентских seed | +| `StructureService` | `menu.list/patch`, `layout.list/get`, `fragment.list/get`, `display.list/get` | редактор контента не меняет Jinja код | +| `AssetService` | `list/get/upload/update_metadata/delete/where_used` | безопасный MIME, size limits, запрет path traversal | +| `FormService` | `list/get_schema/update_schema`, `submission.list/get/update`, `delivery.retry` | RBAC для ПД, версионированная схема, outbox | +| `SettingsService` | `site.get/patch`, `theme.get/patch`, `data.*`, `redirects.*` | site root canonical, секрета нет в site.yaml | +| `ReleaseService` | `changes/validate/create_candidate/get_candidate/publish/list_releases/rollback/diff` | snapshot hash, immutable, optimistic compare-and-swap live | +| `AuthService` | `login/logout/users/grants/tokens/scopes` | safe sessions, token hash, revocation | +| `AuditService` | `list/get/export/append` | immutable append, masking sensitive metadata | + +## 5. Patch / CAS + +Пример запроса на изменение одного документа: + +```json +{ + "if_match": "sha256:old-document-hash", + "operations": [ + { + "op": "replace_block_prop", + "block_id": "hero_home", + "field": "title", + "value": "Наш новый заголовок" + }, + { + "op": "move_block", + "block_id": "services_list", + "target_region": "main", + "after_id": "hero_home" + } + ], + "dry_run": false +} +``` + +**Последовательность:** validate request → RBAC → lock affected document/changeset → re-read bytes → compare `if_match` → apply all ops in memory → draft validation → atomic commit of all affected files → update index/audit → return new ETag. При mismatch ответ `409`, никакой потери изменений. `move_block` использует `before_id`/`after_id`, а не позиционный индекс. + +Для rename и изменений нескольких файлов нужна **стейджинговая директория, журнал changeset и восстановление после crash**. `os.replace` атомарен для одного пути на поддерживаемой FS, но несколько файлов и SQLite одной атомарной операцией не становятся. Порядок recovery, index rebuild и lock scope — в ADR-004. + +## 6. Proposed machine API `/api/v1` + +Это **пример маршрутов**, не требование полного REST слоя в MVP. Admin и MCP используют application services напрямую. + +| Endpoint | Метод | Результат | +|---|---|---| +| `/api/v1/pages` | GET/POST | list/create | +| `/api/v1/pages/{id}` | GET/PATCH | snapshot/typed patch | +| `/api/v1/pages/{id}/source` | GET/PUT | source + editor save | +| `/api/v1/pages/{id}/validate` | POST | draft diagnostics | +| `/api/v1/entries/{collection}` | GET/POST | list/create | +| `/api/v1/entries/{collection}/{slug}` | GET/PATCH | get/update | +| `/api/v1/dependencies?type=&id=` | GET | reverse refs | +| `/api/v1/assets` | GET/POST | list/upload | +| `/api/v1/validate` | POST | release strict report | +| `/api/v1/releases/candidates` | POST | immutable candidate manifest, build id | +| `/api/v1/releases/{build_id}/publish` | POST | live switch with expected_live | +| `/api/v1/releases/{build_id}/rollback` | POST | rollback with expected_live | +| `/api/v1/releases` | GET | release history | + +В каждом мутирующем вызове: actor/scopes, `if_match` или `expected_live`, idempotency key для значимых ретраев, `request_id` для аудита. Пагинация для списков. Имена URL пока рекомендованы, не утверждены API v1. + +## 7. MCP / CLI + +MCP MVP: `get_site_info`, `get_content_schema`, `list_pages`, `get_page`, `list_entries`, `get_entry`, `list_fragments`, `create_page`, `patch_page`, `create_entry`, `update_entry`, `validate`, `get_preview_url`, `get_diff`. MCP изменение по умолчанию **draft-only**, publish/rollback выключены; narrow scopes по путям/коллекциям. CLI использует те же сервисы и validation, предоставляет `reindex`, `validate`, `build`, `release list`, `rollback` с проверенной локальной identity/policy. + +API/CLI/MCP не могут «подделать» роль лишь потому, что передали `actor_id` как строку: адаптер создаёт ActionContext из проверенной сессии/токена/админского локального контекста. + +## 8. Расхождения прототипа с файловыми контрактами + +- `builder.js`: плоский `page.blocks[]`; canonical должен иметь `regions` и `slots` (прототип отображает фиксированные header/footer отдельно). +- `builder.js`: `props` + `bindings` отдельно; принять единый wire format после ADR-002. +- `content-editor.js`: `entries[]` сериализуются как браузерное состояние; реальная Entry — самостоятельный markdown-файл и collection schema. +- `publication.js`: localStorage overlays и synthetic `build_id`; production snapshots формируются файловым snapshot+manifest и проверяются hash. +- `stage6.js`: локальная медиатека, настроечные формы и аудит; canonical данные, безопасные files и server RBAC требуют отдельной реализации. diff --git a/design/docs/stage7/04_SECURITY_RELEASES.md b/design/docs/stage7/04_SECURITY_RELEASES.md new file mode 100644 index 0000000..0118d59 --- /dev/null +++ b/design/docs/stage7/04_SECURITY_RELEASES.md @@ -0,0 +1,118 @@ +# 04. Безопасность, публикация, откат и динамические формы + +## 1. Auth / permissions / audit — обязательные предусловия + +Production не имеет права доверять клиентскому переключению роли из HTML-прототипа. Минимум: локальные аккаунты, session-cookie `Secure`, `HttpOnly`, `SameSite`, защита CSRF для state-changing admin requests, session expiration/rotation, защита от brute-force/rate-limit, серверный audit trail. Конкретные реализации и policy на approval — ADR-005. + +| Capability | Owner | Developer | Editor | Reviewer | Agent | +|---|---|---|---|---|---| +| Просмотр Page/Entry | да | да | да | да | по scopes | +| Сохранение черновика Page/Entry | да | да | да | нет | только scoped draft | +| Редактирование Layout/Fragment **кода** | policy да | да | нет | нет | нет | +| Изменение меню/контентных схем | да | да/policy | menu-only по политике | нет | по узким scopes, без кода | +| Validate / preview | да | да | да | да | по scopes | +| Создание кандидата | да | да | если разрешено | нет | нет по умолчанию | +| Publish / rollback | да | да, по разрешению | только явный grant | нет | **нет** | +| Заявки / ПД / export | да (специальное разрешение) | **не автоматически** | не автоматически | нет | нет | +| Пользователи, роли, MCP scopes | да | нет по умолчанию | нет | нет | нет | + +Матрица — проект политики на основе ТЗ и UX. Отдельные scoped grants решают исключения, роли не заменяют permissions. При отказе в UI — понятная причина; сервер отдаёт 403/404 по конфиденциальности. Секреты и токены при создании показываются один раз только уполномоченному пользователю; хранить хеш/шифрованное значение по назначению, не показывать исходный токен повторно. + +## 2. Trust boundaries + +- **File paths:** root-jail, allowlisted directories, проверка realpath и symlink, обработка `..`, `NUL`, Unicode normalization, MIME sniffing. К загрузкам применяются квоты, ограничения на обработку изображений, карантин для сложных форматов. Нельзя считать клиентскую проверку MIME достаточной. +- **Markdown:** raw HTML отключён по умолчанию; output sanitization + автоэкранирование Jinja. +- **Jinja/layout/fragment/script.js:** не считать произвольный пользовательский код безопасным из-за sandbox. Только доверенный developer workflow с ревью; запрещены динамические Python-миграции из непроверенного сайта. +- **Preview iframe:** желательно отдельный origin и cookie-free isolation; если тот же origin — усиленные CSP/sandbox, отдельные endpoints, `noindex`, TTL токена, без доступа к admin API. `postMessage` только с проверкой origin/source. Не использовать `'*'` как production targetOrigin. +- **MCP:** токен с ограниченным TTL, revocation, per-resource scopes, rate-limit, default draft-only; логировать caller и correlation ID. +- **Forms / PII:** data minimization, отдельные permissions, redaction в audit/logs, CSV formula injection protection, retention/delete/backup policy; запрет утечек ПД в preview и обезличенные скриншоты. + +## 3. Состояния релиза + +```mermaid +stateDiagram-v2 + [*] --> Workspace + Workspace --> Validation : validate snapshot + Validation --> Workspace : blocking errors + Validation --> Candidate : strict pass + immutable build + Candidate --> Workspace : workspace changes / candidate stale + Candidate --> Live : authorization + explicit confirmation + Live --> Historic : later publish + Historic --> Live : rollback pointer with CAS +``` + +**Workspace:** редактируемые канонические файлы; допускается валидный синтаксис и незавершённый `draft`. Изменение файлов НЕ меняет live. + +**Release candidate:** изолированный, неизменяемый snapshot из рабочей версии, прошедший строгую валидацию и успешный build. `manifest` содержит `build_id`, content hashes, route map, assets, theme bundle hashes, form schema versions, actor, timestamp, validation summary, build logs. Кандидат «устаревает» после новых изменений в workspace только с точки зрения выбранной версии: запрещаем публиковать без сверки актуальности/policy (это решение фиксируется ADR-003). + +**Live:** конкретный `build_id` и доступный статический набор. Значение `status: published` у Page НЕ означает, что её новая версия уже попала на сайт. + +## 4. Pipeline и switch + +```text +snapshot(workspace_revision) + → load + syntax/schema validation + → strict reference/route/asset/form compatibility validation + → rebuild index from snapshot or read snapshot-local index + → resolve bindings and bounded queries + → render trusted layouts/fragments + sanitized Markdown + → bundle assets + hash + manifest + → build in isolated dist/.tmp + → fsync/verify & finalize immutable dist/ + → release_candidate(build_id, snapshot_hash) + → confirm publish (RBAC, CSRF, expected_live, candidate validation) + → atomic replace live pointer / commit publish event +``` + +Сначала поддерживать *детерминированную полную сборку*; инкрементальная оптимизация — отдельно после измерений. Не класть candidate в `dist/current` до подтверждения. На неуспешной сборке/валидации текущий pointer не меняется. Повтор publish с тем же idempotency key не создаёт второй релиз. + +Для POSIX `symlink + atomic rename` на одном FS — возможная реализация; для Windows и чужих mount/FS нужны другой pointer protocol/atomicity contract. Дизайн хранения `var/builds` и serve static должен быть проверен в окружении развертывания (ADR-003). + +## 5. Rollback + +1. Выбрать исторический build ID и показать manifest, состояние форм/ассетов и diff с текущим live. +2. Validate, что snapshot существует, целостен, поддерживается текущими runtime-сервисами; проверить form schema compatibility. +3. Подтвердить явно и с `expected_live` (CAS). Нельзя откатывать слепо поверх чужой публикации. +4. Переключить только указатель live, записать audit event и release history. Не удалять workspace и не «возвращать» рабочие файлы к предыдущим версиям скрытно. +5. Сохранить все публичные assets, нужные предыдущему релизу, до окончания retention и пока релиз потенциально доступен для rollback. + +## 6. Динамические формы и outbox + +Публичный HTML должен отправлять `form_id` и **версию схемы**, с которой был собран релиз (`form_schema_hash` и/или build ID). После отката сервер обязан поддерживать обработку заявок по старой схеме или явно блокировать неподдерживаемую публикацию. + +```text +POST /forms/{id} + -> rate limit, CSRF/anti-abuse по публичной политике, size/type check + -> lookup pinned schema from release manifest / compatible versions + -> validate consent metadata + payload + -> SQLite transaction: + INSERT submission (schema version, retained data) + INSERT outbox notification event + -> commit -> 202/303 OK +worker: + -> claim outbox + -> send Telegram (MVP) with retry/backoff + -> record attempt, delivery status, idempotency +``` + +Успех отправки формы относится к сохранению заявки, **не** к успеху Telegram. Раздел «Заявки» показывает статусы уведомления, права на ПД проверяются на сервере. Восстановление после crash не должно терять события outbox; повторная отправка допустима только с idempotency strategy (at-least-once delivery и dedup key). + +## 7. Audit и recovery + +Audit append события: `actor`, `source` (UI/CLI/MCP), `capability`, `object`, `request_id`, `operation`, `old_etag/new_etag`, `result`, timestamp; не хранить plaintext пароли, токены, payload заявок или лишние данные. Логи build и audit должны иметь retention policy. + +Recovery rehearsal: +- Crash между temp write и commit не оставляет битого YAML в `site/`. +- Crash между snapshot build и pointer switch оставляет прежний live. +- Crash после pointer switch до записи DB требует reconciliation live pointer ↔ release metadata. +- Crash после commit заявки, но до Telegram — outbox повторяет доставку. + +## 8. Где нужна отдельная договорённость + +- Политика publish grant редактору, возможность reviewer approval (`review`/`scheduled` — не MVP по умолчанию). +- Независимый preview origin и модель токенов. +- Поддержка SVG, versioned asset metadata/sidecar. +- Формат release manifest и atomic pointer на выбранной OS/FS. +- Сроки хранения релизов, аудита, заявок, backup policy и удаление ПД. + +Без утверждения этих пунктов нельзя честно заявлять production-ready безопасность или publish pipeline. diff --git a/design/docs/stage7/05_IMPLEMENTATION_PLAN.md b/design/docs/stage7/05_IMPLEMENTATION_PLAN.md new file mode 100644 index 0000000..78366f3 --- /dev/null +++ b/design/docs/stage7/05_IMPLEMENTATION_PLAN.md @@ -0,0 +1,85 @@ +# 05. Реализация по вертикальным срезам: задачи, тесты, контрольные точки + +Этапы **V0–V7** ниже — предлагаемая последовательность **последующей разработки backend**, не переименование уже завершённых дизайн-этапов 1–7. Время, стоимость и назначение исполнителей не утверждены. Выполнять один вертикальный срез и проходить приёмку, затем следующий. + +## V0 — Зафиксировать контракты и тестовый сайт + +**Делать:** согласовать ADR-001–006, финальную форму Page/Entry/Binding/Query, layout regions, path mapping, status semantics; собрать reference site с `pages/index.md`, `services`, `forms`, fixtures, ZIP-демо как baseline UI. Настроить тесты parse → serialize → parse. + +**Приёмка:** единая модель файлов не зависит от браузерного localStorage; `reindex` из чистого сайта воспроизводит маршруты/редиректы; не существует неоднозначного определения `source/bind`. + +## V1 — Каркас FastAPI/Jinja/htmx + безопасный Page save + +**Делать:** session auth, RBAC+CSRF, `/admin`, `/admin/pages`, `GET editor`, `_block_tree`, `_inspector`; PageService read/patch + `if_match`; simple preview с 1 Layout/2 Fragment; error/409 UI. Разделить CSS темы 04 и 06 от данных. + +**Приёмка:** открыть существующую Page → выбрать блок → изменить поле → получить новый hash → перезагрузить страницу → изменение сохранено в YAML/MD. Два одновременных редактора: один получил 409, ни одна версия не потеряна. Неполный синтаксически корректный черновик сохраняется, но не публикуется. + +## V2 — Constructor/Expert, data bindings и Content + +**Делать:** safe YAML parse/source editor, round-trip preservation policy, unified Page DTO, page-to-block mapping, typed refs (MVP subset), `where_used`, EntryService + collection schemas + display template, preview refresh preserving scroll and selection. + +**Приёмка:** edit Constructor → Expert → Constructor не меняет ID блоков, связи и Markdown; плохой YAML не перезаписывает документ; выбор блока в дереве скроллит к нему, клик по preview не сдвигает scroll; битый asset/entry выделен на точном поле. Entry и Page имеют разные contracts. + +## V3 — Build, кандидат, публикация, история, откат + +**Делать:** загрузка и валидация snapshot, full static build, manifest, `build_id`, candidate, live pointer с CAS, publish rights, history, rollback и build logs; HTML раздел Публикация на htmx. + +**Приёмка:** workspace → validate → candidate → publish → live, immutable snapshot, без частично опубликованных результатов; ошибка сборки не переключает live, rollback не затирает workspace, повтор publish idempotent. Список изменений и diff относятся к конкретным hashes, а не fake seed. + +## V4 — Media / Structure / Settings + +**Делать:** asset ingest (MIME/size/quotas), metadata и usage links, меню/redirect changesets, layouts/fragments catalog, site.yaml/data/theme/settings. Developer edit шаблонов — отдельный policy gate и review. + +**Приёмка:** загрузка файла → использование в блоке → where_used → запрет/явное последствие удаления, весь маршрут стабильно рендерится после reindex; изменение URL создает redirect и не оставляет half-committed files; Editor не может менять Jinja/JS. + +## V5 — Публичные формы, заявки, outbox + +**Делать:** versioned schema формы, публичный POST с валидацией, SQLite submissions/outbox, worker Telegram, UI форм и заявок, access control на ПД, retry/audit/retention. Не подключать дополнительные провайдеры уведомлений до надёжной доставки одного. + +**Приёмка:** заявка сохраняется при недоступности Telegram, retry восстанавливает уведомление; rollback старого релиза сохраняет работоспособность формы; Developer без PII grant не может прочитать контакты ни через UI, ни через API. + +## V6 — MCP/CLI/операционный контур + +**Делать:** MCP read/write draft-only, объектные scopes, TTL/revoke, CLI reindex/build/validate; audit, conflict, rate limit, backup/restore. Не дублировать логику в MCP handlers. + +**Приёмка:** MCP и Browser с одним и тем же page hash получают одинаковые validation errors; два одновременных автора → 409; MCP без publish grant не публикует; reindex rebuild не зависит от старой DB cache. + +## V7 — Регрессии, стабильность и deploy handoff + +**Делать:** полный browser QA desktop/mobile, keyboard/focus, visual snapshots 04/06, perf benchmark cold/warm builds, backup recovery drill, security tests, production deploy contract (Nginx + FastAPI/worker + SQLite WAL), docs/runbooks. + +**Приёмка:** все матричные тесты ниже зелёные, нет расхождения дизайна/данных после перезагрузки или между темами; rollback после отказа восстанавливает сайт; deploy документ воспроизводим с чистой БД и исходной папкой сайта. + +## Сквозная матрица автоматических тестов + +| Test ID | Уровень | Что доказывает | +|---|---|---| +| `PARSER-01` | unit/property | Page/Entry parse-serialize round trip с сохранением ID и Markdown | +| `BIND-01` | unit | literal/bind/ref/query нормализуются, обязательная отсутствующая ссылка → structured error | +| `LAYOUT-01` | unit | `allow`, fixed region, slots, max depth; Editor не обходит ограничения в Expert | +| `CAS-01` | integration | два writers, один `409`; atomic patch не создаёт частичный файл | +| `CHANGESET-01` | integration | rename page + redirects + menu, crash/recovery, no partial state | +| `DRAFT-01` | integration | можно сохранить неполный draft, strict release validation его исключает или блокирует по принятой policy | +| `REINDEX-01` | integration | clone+reindex rebuilds routes/redirects без старой SQLite | +| `REF-01` | integration | удалённая Entry/Asset, неопубликованная ссылка, route collision — точные diagnostics | +| `BUILD-01` | integration | build failure/current pointer не меняется | +| `RELEASE-01` | integration | immutable manifest, publish/rollback CAS, workspace survives | +| `FORM-01` | integration | форма старого релиза работает после rollback, outbox retry | +| `SEC-01` | security | Editor/Agent не исполняют шаблон/JS, не читают ПД, нет file traversal | +| `PREVIEW-01` | security | preview token не открывает admin/чужой draft | +| `UI-01` | browser | Constructor selected by default; переключение Expert, предупреждения, 409 modal | +| `UI-02` | browser | выбор дерева → scroll; клик в iframe → no scroll; edit props → preserve viewport | +| `UI-03` | screenshot | 04/06 1440×900, 1280×800, 1024×768, 768×1024, 390×844, 360×740 | +| `UI-04` | browser | Rose Graphite: без скруглений **только** выбор коллекции; остальные таблицы как в baseline | +| `OPS-01` | chaos | crash mid-build / mid-outbox / mid-commit и recovery | + +**Не обещать соответствие SLA:** исходное ТЗ задаёт ориентиры до 500 страниц / 10 секунд, single page / 1 секунда. Это гипотезы для benchmark; принимать реальные performance SLO после измерений на целевом железе. + +## Definition of Done на каждый срез + +- Код + тесты + документация DTO и возвращаемых ошибок. +- Auth/CSRF/RBAC/audit для всех новых мутаций. +- Доказано, что база не стала вторым каноническим источником файлов контента. +- Две активные темы отображают одинаковые данные. +- Утверждённый UX сохранён (включая `mode=constructor` по умолчанию и scroll semantics). +- Прототип Stage 6 остаётся отдельным design baseline, без ложных заявлений об интеграции. diff --git a/design/docs/stage7/06_PROTO_AUDIT_AND_GAPS.md b/design/docs/stage7/06_PROTO_AUDIT_AND_GAPS.md new file mode 100644 index 0000000..328c268 --- /dev/null +++ b/design/docs/stage7/06_PROTO_AUDIT_AND_GAPS.md @@ -0,0 +1,69 @@ +# 06. Аудит текущих HTML-прототипов и разрывы до production + +Проверено по исходным файлам архива Этапа 6. Это **наблюдения о прототипе**, а не заявление, что backend уже существует. Целевая схема из документов 01–05 — предложение реализации. + +## 1. Фактическая карта интерфейса + +| Реальный файл | Клиентский модуль | Что покрывает | Куда переносить | +|---|---|---|---| +| `antirion-rework.html` | `assets/antirion-rework.js` | 04 shell, обзор, страницы, legacy summary экраны | `admin/base`, overview, pages list | +| `rose-graphite.html` | `assets/rose-graphite.js` | 06 shell с утверждёнными style rules | те же Jinja partials + Rose tokens | +| `builder-antirion.html`, `builder-rose-graphite.html` | `assets/builder.js`, `assets/expert-codec.js` | Page Constructor, Expert, mappings, preview, validation, draft | PageService, Fragment/BindingService, source adapter | +| `content-antirion.html`, `content-rose-graphite.html` | `assets/content-editor.js`, `assets/expert-codec.js` | Entry edit, Collection schema, preview | Entry/Collection/Display services | +| `publication-antirion.html`, `publication-rose-graphite.html` | `assets/publication.js` | changes, validate, candidate, publish, history, rollback | ReleaseService + BuildService + audit | +| `modules-antirion.html`, `modules-rose-graphite.html` | `assets/stage6.js` | media, structure, forms, settings, journal | соответствующие application services | +| `antirion.html`, `ember-graphite.html` | `assets/admin.js`, `assets/ember-graphite.js` | 03/05 утверждённые концепты | не расширять автоматически; сохранять design baseline | + +## 2. Несогласованные источники данных в демо + +| JS store | В каком коде | Реальное поведение в прототипе | Production замена | +|---|---|---|---| +| `site-engine-stage2-constructor-v1` | `builder.js` | страницы/blocks сохраняются в localStorage | canonical `pages/**/*.md`, PageService + ETag | +| `site-engine-stage3-source-buffers-v1` | `builder.js` | незавершённые исходники Expert в браузере | client-side transient buffer, server autosave — только отдельное решение | +| `site-engine-stage4-content-v1` | `content-editor.js` | записи и sourceCache | `content/**/*.md` + CollectionService | +| `site-engine-stage5-release-v1` | `publication.js` | build ID, live, overlays, activity | immutable snapshot + DB metadata + live pointer | +| `site-engine-stage6-ui-v1` | `stage6.js` | медиа, настройки, заявки и журнал в одной browser-модели | файловые config + DB service data + public forms/outbox | + +В Stage 5 `publication.js` читает сохранённые Stage 2/4 данные из browser storage и смешивает их с demo overlays. В Stage 6 `stage6.js` объединяет свой журнал с Stage 5, если storage доступен. Это полезная **демонстрация UX**, но не транзакционная консистентность и не подходящая архитектура для production. + +## 3. Расхождения schema / serialization + +- `builder.js` хранит `page.blocks` плоско, а YAML-сущность из ТЗ — `regions`, `slots`, `fixed` в Layout. Нельзя терять вложенность в серверной модели. +- `builder.js` хранит `bindings` отдельно от `props`; в ТЗ bindings чаще встроены в значения props. Требуется ADR-002 и единая сериализация. +- Mock Query поддерживает ограниченные `collection/limit/sort` и фиксированные `ENTRIES`; коллекции из Content Editor живут в другом store. В production query читает canonical entries и индекс. +- `content-editor.js` моделирует schemas прямо в JS, а production schemas читаются из `collections/*.yaml`. +- Preview в Page Builder формирует `srcdoc` и передаёт `postMessage('*')`. Для сервера нужен защищённый preview и безопасная межокенная коммуникация. +- В Stage 6 `role` меняется в JS, а contacts/permissions лишь скрываются клиентом; настоящая защита возможна только на сервере. +- Media upload Stage 6 для части форматов записывает метаданные, а не файлы на диск, и существует ограничение размера 2 MiB — это демо-поведение, не production quota policy. +- `publication.js` синтезирует релизы из seed/overlays, поэтому `build_id` и published state не соответствуют реальному snapshot. +- Даже при совпадении экрана в 04/06 логика UI может дублироваться; целевая реализация должна использовать единую модульную схему шаблонов. + +## 4. Зафиксированные UX-решения из совместных итераций + +1. При открытии редактирования Page сверху **по умолчанию выбран «Конструктор»**, селектор синхронизирован с режимом. +2. Клик по блоку в preview **не прокручивает страницу**. +3. Выбор блока в дереве прокручивает preview к нему, **если блок не виден**; редактирование поля не сбрасывает scroll. +4. Статусы `Workspace draft`, `Saved draft`, `Live release` не смешиваются. +5. Все четыре дизайн-концепта 03–06 сохраняются в упаковке; 04 и 06 — активно реализуемые. +6. В Rose Graphite **прямоугольный только выбор коллекции** раздела Контент; остальные таблицы и панели не менять без отдельного решения. +7. Нет зависимости от сторонних CDN, исходный HTML открывается локально, производственная реализация не требует React/Vue/Next ради прототипа. + +## 5. QA исходного прототипа + +Этап 6 содержит `docs/test_stage6.py`, `docs/test_stage6_views.py`, `docs/STAGE6_QA.md`, JSON и preview screenshots. Это подтверждения тестирования **конкретного mock**, а не автоматическая готовность сервиса. В Этапе 7 HTML не менялся, поэтому повторное визуальное QA нужно при первых server-rendered partials, когда появятся новые data states и network errors. + +## 6. Priority gap list (порядок решения) + +| Gap | Приоритет | Почему | +|---|---|---| +| Формальное canonical Page/Entry/Binding/Query DTO | P0 | без него Constructor/Expert будут иметь расходящиеся serializers | +| CAS + атомарная файловая запись + recovery | P0 | конкурентная правка/агенты могут терять изменения | +| Auth, RBAC, CSRF, audit на уровне services | P0 | нельзя подключать UI/CLI/MCP с записью иначе | +| Snapshot/manifest/pointer semantics | P0 | нельзя считать publish/rollback безопасными | +| Версионирование публичных форм | P0 | rollback может сломать заявки | +| Preview isolation и sanitation | P0 | iframe/фрагменты/Markdown недоверенные поверхности | +| Sidecar metadata Asset | P1 | file-first теряет alt/caption без явного формата | +| Реальный where-used индекс и reference validation | P1 | без него изменение/удаление создаст битые связи | +| Multi-file changeset | P1/P0 для rename | одной SQLite-транзакцией не закрыть файловые изменения | +| CSS/htmx Jinja partial design tokens | P1 | сохранить UX/стили без двойной серверной логики | +| Incremental build, full query DSL, advanced review workflow | Later | не нужны для базового end-to-end сайта | diff --git a/design/docs/stage7/IMPLEMENTATION_HANDOFF_PROMPT.md b/design/docs/stage7/IMPLEMENTATION_HANDOFF_PROMPT.md new file mode 100644 index 0000000..4b04f78 --- /dev/null +++ b/design/docs/stage7/IMPLEMENTATION_HANDOFF_PROMPT.md @@ -0,0 +1,37 @@ +# Задание для следующего чата / Codex-агента: начать backend Site Engine + +Ты — Senior Python Engineer + System Architect, работаешь в Spec-Driven Workflow. Цель — **реализовать первый вертикальный срез** переноса согласованной админки Site Engine на FastAPI + Jinja2 + htmx, без переписывания интерфейса на SPA. + +## Источники (прочитать прежде чем кодить) + +- `docs/stage7/README.md` +- `docs/stage7/01_ARCHITECTURE.md` +- `docs/stage7/02_UI_HTMX_MAP.md` +- `docs/stage7/03_DOCUMENTS_AND_SERVICES.md` +- `docs/stage7/04_SECURITY_RELEASES.md` +- `docs/stage7/05_IMPLEMENTATION_PLAN.md` +- `docs/stage7/06_PROTO_AUDIT_AND_GAPS.md` +- `docs/stage7/adr/ADR_REGISTER.md` +- `docs/stage7/reference_TZ-site-engine.md` +- `docs/stage7/reference_TZ-site-engine-architecture-review.md` +- Утверждённые HTML-прототипы: `index.html`, `antirion-rework.html`, `rose-graphite.html`, `builder-*.html`, `content-*.html`, `publication-*.html`, `modules-*.html`, `assets/*`. + +## Правила + +1. Site Engine — самостоятельный продукт, не Flexly AI Core. +2. Файлы сайта (YAML/Markdown) — каноническая модель. SQLite — cache/index/service data, не дублировать контент. +3. App services едины для admin/API/CLI/MCP. Все writes проходят RBAC, CAS, validation, audit. +4. Опубликованный релиз — immutable snapshot; draft save не меняет live. +5. Различать принятые UX-решения и **предложения ADR**; сомнительные пункты сначала ADR и тесты. +6. Не начинать реализацию всей CMS одновременно; делать вертикальные срезы по `05_IMPLEMENTATION_PLAN.md`. +7. Базовые темы: **04 Antirion Rework** и **06 Rose Graphite**. Не менять согласованную сетку/цвета; 03 и 05 хранить как сохранённые концепты. +8. Технический стек: Python 3.12+, FastAPI, Jinja2, htmx, Pydantic v2, SQLAlchemy 2, SQLite WAL/Alembic. Не добавлять Node только ради сборки. +9. Запускать тесты; приложить результат и ссылки на изменённые файлы. Не выдавать mock publish, role switch или localStorage за реальную интеграцию. + +## Первый запрос (V0) + +Сделай ревью технического пакета и составь минимальный implementation plan для файловой модели Page/Layout/Fragment/Block, typed bindings MVP, `reindex`, draft validation и safe serialization. Обозначь решения ADR-001/002/004, требующие утверждения. Затем реализуй только по принятому согласованному срезу; не подключай MCP или публичные формы раньше auth/RBAC/audit. + +## Следующий срез (V1), после утверждения V0 + +FastAPI app, безопасная сессия, PageService с `if_match`, Jinja shell + htmx list/editor/inspector, один рабочий шаблон и preview. Критерий: изменить title Hero → save → reload → увидеть изменение из canonical YAML; одновременно открытые сессии обнаруживают 409. diff --git a/design/docs/stage7/README.md b/design/docs/stage7/README.md new file mode 100644 index 0000000..1ed91bb --- /dev/null +++ b/design/docs/stage7/README.md @@ -0,0 +1,54 @@ +# Site Engine — Этап 7: handoff технической реализации + +Актуальные границы работ и поправки: [сопоставление с 001](001_ALIGNMENT.md). При расхождении применять спецификацию 001 и действующие файловые контракты. + +**Статус:** проект архитектуры для согласования и реализации. **Не является работающим backend.** +**Дата:** 12.11.2026. **Продукт:** Site Engine, отдельно от Flexly AI Core. +**Целевая платформа:** Python 3.12+, FastAPI, Jinja2, htmx, Pydantic v2, SQLAlchemy 2, SQLite WAL, Alembic; Node.js/SPA не обязательны. + +## Итог Этапа 7 + +Завершён технический **план переноса** утверждённых HTML-прототипов Этапов 1–6 на файловый движок и серверную админку. План охватывает URL/partials, модель документов и сервисов, права, безопасность, совместное редактирование, превью, сборку, публикацию, rollback, формы, MCP/CLI и интеграционные тесты. Реальная интеграция **не выполнялась**. + +**Зафиксированные дизайны:** 03 Antirion, 04 Antirion Rework, 05 Ember Graphite, 06 Rose Graphite (ранее YuE Studio). Функционально развиваем **04 и 06**; 03 и 05 остаются неизменёнными концепциями. У Rose Graphite без скруглений только выбор коллекции в разделе «Контент» — не все таблицы. + +## Навигация по документам + +| Файл | Для чего нужен | +|---|---| +| `01_ARCHITECTURE.md` | Общие слои, дерево проекта, модули, владение данными | +| `02_UI_HTMX_MAP.md` | Каждый экран → Jinja partial, HTTP route, событие htmx, доступ | +| `03_DOCUMENTS_AND_SERVICES.md` | File-first контракты, операции приложения, DTO, REST/MCP/CLI, concurrency | +| `04_SECURITY_RELEASES.md` | RBAC, CSRF, preview isolation, build/release/rollback, формы/outbox | +| `05_IMPLEMENTATION_PLAN.md` | Вертикальные срезы, зависимости, критерии приемки и тест-план | +| `06_PROTO_AUDIT_AND_GAPS.md` | Точная привязка к исходным HTML/JS и выявленные разрывы между демо и production | +| `adr/ADR_REGISTER.md` | Решения, утверждение которых необходимо до старта реализации | +| `IMPLEMENTATION_HANDOFF_PROMPT.md` | Готовое задание для нового чата/кодового агента | +| `examples/` | Примеры контрактов и ответов API; **не канонический окончательный формат** | + +## Основные границы + +1. **Источник истины — сайт как папка файлов:** `pages/`, `content/`, `collections/`, `display/`, `layouts/`, `fragments/`, `menus/`, `forms/`, `assets/`, `data/`, `site.yaml`, `redirects.yaml`. +2. **SQLite не содержит второй канонической копии контента:** в БД — перестраиваемые индексы и служебные сущности (пользователи, сессии, агенты, аудит, заявки, outbox, метаданные сборок). +3. **Один сервисный слой** для админки, CLI и MCP; никаких обособленных проверок прав только в htmx или JS. +4. **Workspace ≠ Release candidate ≠ Live release.** Сохранённый документ не означает, что посетитель увидел изменения. +5. Конструктор и Эксперт — **два способа работы с одним документом**. Ошибочный исходник не перезаписывает последнюю валидную модель. +6. Публикация — только валидированный, неизменяемый снимок. Откат переключает live, **не затирает workspace**. +7. Дальнейшие решения из архитектурного ревью — **рекомендации, не автоматически утверждённые требования**. Они явно вынесены в ADR. + +## Источники и приоритет + +- `reference_TZ-site-engine.md` — первичное ТЗ от 06.11.2026 (черновик), описание системы и форматов. +- `reference_TZ-site-engine-architecture-review.md` — архитектурное ревью, предложения с P0/P1. +- `site-engine-admin-design-prompt.md` в исходном обсуждении — требования к дизайну, этапам и поведению UI. +- Реально собранный `index.html`, `assets/*.js`, `assets/*.css` и HTML Этапа 6 — **эталон UX**, но **не** production-контракт данных или правил безопасности. + +**Правило для реализации:** если прототип противоречит ТЗ, не копировать случайную структуру JS-state в серверный контракт. Если ревью противоречит черновику ТЗ, оформить ADR и согласовать; в документах этого этапа предложен конкретный стартовый вариант. + +## Что делать дальше + +Согласовать ADR P0, затем начать вертикальный срез `V0` из `05_IMPLEMENTATION_PLAN.md`: один сайт, одна файловая Page, один Fragment, полный цикл **read → edit → validate → atomic save → preview**. Остальные подсистемы подключать к тем же сервисам по мере роста, не создавать отдельный «backend для прототипа». + +### Примечание об объёме + +Пакет содержит весь исходный интерактивный проект Этапа 6 без изменения его поведения. Этап 7 добавляет документы и схемы взаимодействия. **Исходный HTML-проект не требует установки и по-прежнему открывается из `index.html`.** Для общего localStorage в нескольких вкладках рекомендован локальный HTTP-сервер. diff --git a/design/docs/stage7/adr/ADR_REGISTER.md b/design/docs/stage7/adr/ADR_REGISTER.md new file mode 100644 index 0000000..5f493cb --- /dev/null +++ b/design/docs/stage7/adr/ADR_REGISTER.md @@ -0,0 +1,65 @@ +# ADR Register — решения до написания production-кода + +**Статус всех перечисленных ниже ADR: PROPOSED / НЕ УТВЕРЖДЕНО.** Первичное ТЗ — описание требований; архитектурное ревью предлагает их уточнить. Реализация не должна выдавать предлагаемую позицию за принятую пользователем. + +## ADR-001 — File-first и границы SQLite + +**Контекст:** публичная маршрутизация и редиректы должны переживать перенос каталога сайта без БД. В ТЗ предусмотрена SQLite `slug_history` — потенциальный второй источник маршрутов. + +**Рекомендация:** хранить Page/Entry/Redirect/Menu/Asset metadata как файлы `site/` (asset metadata sidecar отдельно уточнить). SQLite хранит перестраиваемые индексы и служебные сущности. Изменение URL — changeset, обновляющий `redirects.yaml`. + +**Альтернатива:** SQLite как канонический storage — нарушает выбранную file-first модель. + +**Решение требуется:** подтвердить форматы sidecar для ассетов и источник пользовательских метаданных. + +## ADR-002 — Typed Composition / Bindings / Query MVP + +**Контекст:** ТЗ содержит `{bind: ...}`, `{page: ...}`, `{entry: ...}`, `source: body` и коллекционные запросы; прототип имеет независимое `bindings`. + +**Рекомендация:** внутреннее `Literal | Binding | LinkRef | Query`, path roots `site/page/entry/data/params`, canonical YAML как в ТЗ, query MVP `collection/ids/where.eq/in/sort/limit`. Unsupported expressions — явный error. `source: body` нормализовать в `bind: page.body`. Строковые Jinja-like выражения в YAML SEO — запретить в MVP либо разрешить строго ограниченную подстановку после отдельного решения. + +**Альтернатива:** полный DSL и произвольные шаблоны повышают сложность и риски. + +**Решение требуется:** окончательная сериализация, совместимость при round-trip комментариев, media refs, nesting/slots. + +## ADR-003 — Immutable Releases / Live pointer / Form compatibility + +**Контекст:** сохранение не равно публикации. Откат статического сайта может вернуть старую форму. + +**Рекомендация:** `workspace → immutable candidate(snapshot_hash, manifest) → atomic live pointer`, publish & rollback с `expected_live`, retention assets+form schemas, worker принимает schema version текущего отправляемого HTML. + +**Альтернатива:** публикация файлов поодиночке — неподдерживаемая половинчатая live-версия. + +**Решение требуется:** OS/FS (POSIX symlink vs portable pointer), TTL кандидата, правила актуальности, release retention. + +## ADR-004 — CAS / Typed Patch / Multi-file Changesets + +**Контекст:** стабильный block ID не предотвращает потерю изменений при двух writers. + +**Рекомендация:** SHA-256 ETag + `if_match`; lock → verify → apply → validate → atomic file write; rename/menu/redirect через staging+crash recovery, machine-readable `409` diff. Typed `move_block` с `before_id/after_id`, а не только index. + +**Решение требуется:** granularity locks, multi-file transaction journal, recovery/reconciliation, hash canonicalization. + +## ADR-005 — Security / Trusted code / Preview / Agent scopes + +**Контекст:** Jinja sandbox не даёт изоляции произвольному JS/Python; публичная форма и MCP требуют надёжной авторизации. + +**Рекомендация:** editor/agent — только data, developer code через reviewed workflow; cookie session + CSRF, server RBAC, limited preview token/origin/CSP, scoped MCP draft-only, PII grant отдельно. SVG либо запрещён на MVP, либо безопасно преобразуется. + +**Решение требуется:** concrete preview origin, RBAC scopes/grants, TTL токена, retention/PII policy, доверенные расширения. + +## ADR-006 — Scope, milestones и форматы релизов MVP + +**Контекст:** ТЗ охватывает большой универсальный движок и advanced редакционные workflows. Для первого полноценного сайта слишком много расширений. + +**Рекомендация:** 1 сайт/инстанс, 5–15 фрагментов, full build, минимальные query, без scheduled/review approval, поиска FTS, мультисайтовости, сложных таксономий, инкрементальной сборки; эти возможности вернуться по use case и benchmark. Реализовать по V0–V7 из `05_IMPLEMENTATION_PLAN.md`. + +**Решение требуется:** точный MVP fragment list, поддерживаемые формы/уведомления, приоритеты UI modules. + +## Process + +1. Архитектор фиксирует альтернативы и аргументы; reviewer оценивает безопасность/сложность. +2. Пользователь утверждает или меняет рекомендацию. +3. Только после явного решения ADR получает `Accepted` и дату. +4. При изменении решения новая ADR `Supersedes` старую, не удаляя историю. +5. Specs и tests ссылаются на ID соответствующей ADR. diff --git a/design/docs/stage7/examples/README.md b/design/docs/stage7/examples/README.md new file mode 100644 index 0000000..b847558 --- /dev/null +++ b/design/docs/stage7/examples/README.md @@ -0,0 +1,8 @@ +# Examples — только иллюстративные DTO и YAML + +Эти файлы предназначены для обсуждения контрактов и тестовых фикстур. Их нельзя принимать за автоматически утверждённую схему без ADR-002/003/004. Все ID, ETag и временные значения в JSON фиктивные. + +- `page-home.md`, `entry-bots.md`: примеры file-first документов. +- `patch-block.json`: типизированный patch с optimistic concurrency. +- `conflict-409.json`: структурированная ошибка при несоответствии версии. +- `release-manifest.json`: пример неизменяемого снимка релиза. diff --git a/design/docs/stage7/examples/conflict-409.json b/design/docs/stage7/examples/conflict-409.json new file mode 100644 index 0000000..342d339 --- /dev/null +++ b/design/docs/stage7/examples/conflict-409.json @@ -0,0 +1,12 @@ +{ + "error": { + "code": "DOCUMENT_VERSION_CONFLICT", + "message": "Документ изменён другим редактором", + "document_id": "home", + "path": "pages/index.md", + "expected_etag": "sha256:EXAMPLE-OLD-HASH", + "current_etag": "sha256:EXAMPLE-NEW-HASH", + "server_version_url": "/api/v1/pages/home/source", + "request_id": "req_example_001" + } +} diff --git a/design/docs/stage7/examples/entry-bots.md b/design/docs/stage7/examples/entry-bots.md new file mode 100644 index 0000000..586495e --- /dev/null +++ b/design/docs/stage7/examples/entry-bots.md @@ -0,0 +1,11 @@ +--- +title: Telegram-боты +slug: bots +status: published +summary: Автоматизируем диалоги и обращения +tagline: Диалоги и автоматизация +order: 10 +--- +Создаём Telegram-ботов под процессы команды. + +Пример. Список допустимых полей задаёт `collections/services.yaml`, а публичный маршрут — его `route`. diff --git a/design/docs/stage7/examples/page-home.md b/design/docs/stage7/examples/page-home.md new file mode 100644 index 0000000..b53411a --- /dev/null +++ b/design/docs/stage7/examples/page-home.md @@ -0,0 +1,33 @@ +--- +schema: 1 +title: Главная +layout: default +status: published +seo: + title: Разработка Telegram-ботов и AI-систем + description: AI-ассистенты и автоматизация бизнес-процессов. +regions: + main: + - id: hero_home + fragment: hero + props: + title: + bind: page.title + subtitle: AI-ассистенты и Telegram-боты + - id: services_list + fragment: collection_list + props: + source: + query: + collection: services + sort: order + limit: 6 + - id: body_home + fragment: richtext + props: + content: + bind: page.body +--- +Наша студия разрабатывает Telegram-ботов, AI-системы и автоматизацию. + +Пример действующей сериализации Page, проверяемый относительно examples/studio-site. diff --git a/design/docs/stage7/examples/patch-block.json b/design/docs/stage7/examples/patch-block.json new file mode 100644 index 0000000..733b439 --- /dev/null +++ b/design/docs/stage7/examples/patch-block.json @@ -0,0 +1,18 @@ +{ + "if_match": "sha256:EXAMPLE-OLD-HASH", + "dry_run": false, + "operations": [ + { + "op": "replace_block_prop", + "block_id": "hero_home", + "field": "title", + "value": "Новый заголовок" + }, + { + "op": "move_block", + "block_id": "services_list", + "target_region": "main", + "after_id": "hero_home" + } + ] +} diff --git a/design/docs/stage7/examples/release-manifest.json b/design/docs/stage7/examples/release-manifest.json new file mode 100644 index 0000000..e2161e8 --- /dev/null +++ b/design/docs/stage7/examples/release-manifest.json @@ -0,0 +1,13 @@ +{ + "schema_version": 1, + "build_id": "build_example_001", + "workspace_revision": "rev_example_37", + "snapshot_sha256": "EXAMPLE-SNAPSHOT-SHA256", + "created_at": "2026-11-12T13:00:00+03:00", + "created_by": "owner_demo", + "validation": {"errors": 0, "warnings": 1}, + "routes": ["/", "/services/", "/services/bots/"], + "files": [{"path": "index.html", "sha256": "EXAMPLE-FILE-SHA256"}], + "form_schema_versions": {"form_contact": "schema_example_v2"}, + "notes": "Пример структуры, не утверждённый формат manifest" +} diff --git a/design/docs/stage7/reference_TZ-site-engine-architecture-review.md b/design/docs/stage7/reference_TZ-site-engine-architecture-review.md new file mode 100644 index 0000000..d376990 --- /dev/null +++ b/design/docs/stage7/reference_TZ-site-engine-architecture-review.md @@ -0,0 +1,317 @@ +# Архитектурное ревью ТЗ Site Engine v0.1 + +**Исходный документ:** `TZ-site-engine.md`, редакция от 06.11.2026 +**Тип ревью:** архитектура, модель данных, границы MVP, безопасность, MCP, эксплуатация +**Вердикт:** концепцию сохранить; до начала реализации уточнить контракты и пересобрать этапы. + +> Это ревью **того, что написано в ТЗ**. Предлагаемые изменения — архитектурные рекомендации, а не утверждение, что в существующей реализации уже есть ошибки. + +## 1. Резюме + +Направление удачное: файловый источник контента, типизированные фрагменты, статический результат, единый сервисный слой, CLI/MCP/админка и контролируемая публикация. Но текущий документ пытается одновременно определить универсальную CMS, контентную платформу, агентский редактор и редакционный workflow. Из-за этого первоначальная версия получается значительно сложнее, чем нужно для первого работающего сайта. + +### Исправить до старта (P0) + +1. **Граница файлов и SQLite:** `slug_history` сейчас хранит не восстанавливаемые из файлов правила редиректов. Это противоречит принципу переносимого сайта. Уточнить файловый источник и исключения. +2. **Контракт данных:** формально определить структуру страницы, ссылки, привязки, запросы, разрешение типов и поведение при отсутствующих значениях. Сейчас несколько разных синтаксисов описывают близкие операции. +3. **Редактирование и релизы:** разделить сохранение рабочего черновика, валидацию для публикации и собственно опубликованный релиз. Неполный черновик не должен быть запрещён только потому, что у него пока нет всех обязательных полей. +4. **Параллельные изменения:** ID блока не гарантирует отсутствие конфликтов. Нужны атомарные `if_match`-операции, версия файла, блокировка/транзакционная граница и пакетные изменения. +5. **Доверенная и недоверенная среда:** отдельно описать границы Python-миграций, Jinja, JS, превью, публичного доступа к файловым ассетам. Jinja sandbox — не полноценная песочница для произвольного кода. +6. **Последовательность этапов:** нельзя запускать пишущий MCP и формы без минимального контура auth/RBAC, аудита, безопасной публикации и надёжной очереди уведомлений. + +### Самое полезное упрощение + +Для первого сайта достаточно около **15 базовых фрагментов**, небольшого набора операций с коллекциями и одного способа публикации. Инкрементальные сборки, произвольный DSL запросов, сложные правила редакционной готовности, Python-миграции схем фрагментов и мощную CMS-аналитику стоит отложить до появления реальных случаев использования. + +## 2. Что оставить без фундаментальных изменений + +| Решение | Оценка | Уточнение | +|---|---|---| +| Файлы Markdown + YAML как канонический контент | Оставить | Фиксировать схему, стабильные ID и формат сериализации | +| FastAPI + Jinja + htmx | Оставить | Достаточно для первой версии без frontend SPA | +| Layout / Fragment / Block | Оставить | Чётче определить роли и наследование | +| Единый сервисный слой для CLI, MCP, UI | Обязательно оставить | Блокировка, проверка прав и аудит тоже должны быть там | +| Рендер в статический `dist` | Оставить | Чёткое разделение рабочего состояния и опубликованного | +| Строгая проверка на публикации | Оставить | Ослабить запрет на сохранение *незавершённых* черновиков | +| MCP с ограниченными правами | Оставить | По умолчанию только рабочее пространство/черновики | +| SQLite для заявок, сессий, аудита | Оставить | Для одиночного сайта нагрузка разумная | + +## 3. Архитектурные проблемы и решения + +### P0-01. File-first не полностью соблюдается + +**Где:** §2, §5.1, §13. +**Проблема:** при изменении `slug` старый URL попадает в историю, а `slug_history` по таблице раздела 13 не восстанавливается из файлов. После переноса каталога сайта и пересоздания БД история редиректов может исчезнуть. Значит, маршрутизация фактически зависит от скрытого состояния базы. + +**Решение:** редиректы — в `redirects.yaml`; автоматическая смена URL атомарно меняет маршрут и добавляет запись в этот файл. БД может индексировать редиректы. У пользователей, токенов, заявок, аудита и служебных логов иной жизненный цикл — это честно оговорённые исключения, не «контент сайта». + +**Критерий приёмки:** чистый `git clone` + `build` порождает ту же карту публичных маршрутов и редиректов без старой SQLite. + +### P0-02. Нужно выбрать формальную модель входных данных + +**Где:** §3.1, §4.4–4.8, §5.4. +В документе одновременно встречаются `source: body`, `source: entry.body`, `{bind: entry.title}`, `{page: contacts}`, `{collection: ...}`, `{children: current}`, `{{ entry.title }}` внутри SEO. Не описано, какие конструкции разрешены в каких полях, что является значением, ссылкой или вычисляемым выражением. + +**Предложение:** + +- Внутренняя модель: `Literal | Binding | LinkRef | Query` с явной нормализацией в конкретный тип поля. +- Унифицированные корни контекста: `site`, `page`, `entry`, `data`, `params` (для сборки лишь заранее известных статических параметров). +- Отсутствующая привязка: структурированная ошибка для обязательного поля, `null` для необязательного; никаких тихих подстановок пустых строк в обязательные поля. +- Ссылка на маршрут: типизированный объект, а не произвольный текст, с проверкой наличия *опубликованной* целевой страницы. +- Строковые выражения в YAML (например `seo.title: '{{ entry.title }}'`) либо запретить на старте, либо разрешить только безопасную ограниченную подстановку, без второго полноценного шаблонизатора. +- Для `source` использовать тот же `bind`, а не отдельный неформальный язык. + +В запросах для MVP разрешить только: `collection`, `ids`, `where.eq/in`, `sort`, `limit`. `offset`, произвольные `contains/gte/lte/not`, `related_to/by` и гибридные фильтры добавить после реального сценария. + +**Критерий приёмки:** схемы сериализуются/десериализуются обратно, типы проверяются до Jinja, неправильная привязка имеет точный путь к полю. + +### P0-03. Публикация не равна сохранению документа + +**Где:** §2.3, §4.5, §6.3–6.5, §10.2. +Фраза «невалидное не сохраняется» делает создание незавершённых страниц неудобным. А `status: published` не означает, что текущий файл уже присутствует в `dist/current`. + +**Предложение:** разделить три состояния: + +1. **Workspace** — редактируемые файлы (валидный синтаксис, допустимы неполные обязательные бизнес-поля у черновиков). +2. **Release candidate** — моментальный снимок файлов, прошедший *строгую* проверку всех публичных страниц, ссылок и ассетов. +3. **Live release** — конкретный `build_id`, на который указывает публикация. + +Статусы `draft`, `review`, `published`, `scheduled`, `archived` описывают включение контента в сборку, а не факт публикации конкретного изменённого файла. Добавить `publish_at` с таймзоной и scheduler только если отложенная публикация реально нужна. До этого `scheduled` можно убрать. + +**Критерий приёмки:** можно сохранить незавершённый черновик; валидная публикация не зависит от текущих незавершённых черновиков; неуспешная сборка не меняет `live`. + +### P0-04. ID блоков ≠ бесконфликтная запись + +**Где:** §2.4, §3.1, §10.2, §12.2. +Стабильный ID позволяет адресовать фрагмент, но два пользователя могут менять разные поля *одного YAML-файла*, и без контроля версий последняя запись перетрёт первую. Хеш в ТЗ есть, но не описана атомарность проверки+записи и работа с несколькими файлами при переносе/смене URL. + +**Предложение:** + +- Каждая запись требует `if_match: `; чтение возвращает этот хеш. +- Проверка хеша и атомарная запись выполняются под блокировкой конкретного документа, а не отдельными незащищёнными операциями. +- Конфликт — `409 Conflict` с текущей версией и машинно-читаемым diff. +- `move_block` принимает `target_region`, `target_slot`, `before_id` или `after_id`, а не позиционный индекс. +- Добавить `patch_page` для пакетного атомарного редактирования нескольких блоков одной страницы. +- Операции между файлами (`rename_page`, редирект, обновление меню) делать через транзакционный changeset/стейджинг с валидацией всего набора и безопасным коммитом. SQLite-транзакция сама по себе не охватывает файловую систему. + +**Критерий приёмки:** два параллельных писателя не теряют обновления; конфликт не оставляет частично записанных файлов. + +### P0-05. Безопасность шаблонов и привилегий + +**Где:** §4.4, §4.4 «Версии», §8.2 `embed_html`, §11.2. +Декларация «шаблоны сайта рендерятся в sandbox» создаёт впечатление, что сторонние шаблоны/JS/Python-миграции безопасно исполнять. Это неверная граница доверия: файл `script.js` исполняется в браузере посетителя, Python-файл миграции — в серверном процессе; Jinja sandbox не заменяет отдельную изоляцию недоверенного кода. + +**Предложение:** + +- **Контентные роли** меняют только данные, не исполняемый код. +- **Developer** добавляет Jinja/CSS/JS как проверяемый код сайта. Такие расширения считаются доверенными после ревью. +- По умолчанию не исполнять Python-миграции, поставленные вместе с произвольным сайтом; в MVP — декларативные миграции или отдельный процесс ручного обновления версии фрагмента. +- Превью — отдельный путь/желательно origin с жёсткими cookies, CSP, `noindex`, сроками действия и ограничением прав токена. Внешняя превью-ссылка не должна случайно открывать админку или чужие черновики. +- Сборка/рендер имеют лимиты на размер файлов, глубину рекурсии, число блоков и запросов, длительность выполнения. +- SVG в начальном MVP проще запретить или конвертировать в безопасный растровый формат, чем обещать универсальную санитизацию. + +**Критерий приёмки:** editor/agent не может добавить исполняемый шаблон, JS, миграционный скрипт или прочитать серверные секреты из шаблона. + +### P0-06. Структура публикации должна учитывать динамические формы + +**Где:** §6.1, §9.2, §13. +После отката статического `dist` HTML формы может ссылаться на прежнюю схему, в то время как `POST /forms/{id}` обрабатывает новую версию `forms/*.yaml`. При несовместимых изменениях старый опубликованный сайт перестанет отправлять заявки. + +**Предложение:** версионировать публичную схему формы или привязать форму к `build_id`, поддерживая переходные версии. Сначала сохранить заявку и событие уведомления в одной DB-транзакции; уведомления доставлять отдельным worker из SQLite outbox. Нужны `attempts`, backoff, `next_attempt_at`, idempotency key и зафиксированная политика повторов. + +**Критерий приёмки:** rollback восстанавливает не только внешний вид формы, но и её рабочую отправку; падение Telegram/email не теряет заявку. + +### P0-07. Переставить security раньше пишущего MCP + +**Где:** §11, §12, §15. +Сейчас MCP с записью включён в M1, а роли/токены/аудит — только в M2. Это небезопасный порядок релизов. В M1 также появляются формы, у которых уже есть персональные данные. + +**Предложение:** встроить в первый сетевой релиз минимальные `auth`, scopes, аудит мутаций, ограничения экспорта, политику секретов и data retention. Полноценный UI управления ролями может появиться позже; сам контроль доступа — нет. + +### P0-08. Статусы review/approval и MCP-согласование неполны + +**Где:** §4.5, §6.4, §11.1, §12.1. +Пример статусов в §4.5 пропускает `review`; указана команда `submit_for_review`, но не описаны `approve`, `request_changes` или привязка согласования к конкретной ревизии. Editor может публиковать и одновременно согласовывать, так что обязательное approval фактически отсутствует. + +**Предложение:** в MVP выбрать простой режим: `draft` → ручная публикация владельцем/редактором, без формального approval. Если review необходим, описать переходы, кто утверждает, кто публикует и что любое изменение после согласования аннулирует approval. + +## 4. Ошибки контракта и неоднозначности (P1) + +| ID | Место | Что уточнить | Предложение | +|---|---|---|---| +| P1-01 | §4.3, §4.7 | В `fixed`-блоках layout и блоках display template отсутствуют ID | Стабильный детерминированный ID из пути шаблона/ключа, который нельзя переименовать бесследно; отдельное пространство имён | +| P1-02 | §3.1, §4.7 | `overrides: allow` и `regions_mode` не определяют точную семантику замены | `append/prepend/replace` только для *региона*, а точечные overrides блоков — отдельный механизм позже | +| P1-03 | §4.4 | `id: hero` не уникален между категориями фрагментов | Канонический ID `marketing/hero` или иная явно заданная система namespace | +| P1-04 | §4.4, §4.6 | Мигрируют только схемы фрагментов, не схемы коллекций | Версионирование `collection.schema` и команда `migrate --dry-run` для обоих типов | +| P1-05 | §4.8 | `paginate` + `filters` конфликтует со статикой | Только заранее определённые маршруты/таксономии; произвольная фильтрация параметрами — client-side или динамический режим позже | +| P1-06 | §4.8, §6.1 | Запросы и зависимости через SQLite требуют синхронного индекса | Для MVP собирать нормализованный in-memory registry из файлов; SQLite использовать как восстанавливаемый кэш и БД сервиса | +| P1-07 | §5.1 | Роутинг не описывает нормализацию и collisions | Зафиксировать trailing slash, регистр, Unicode, percent encoding, reserved routes, конфликты редиректов/автомаршрутов | +| P1-08 | §5.5 | `hreflang` в v1 без полноценной реализации локалей | До появления переводов не генерировать `hreflang` для несуществующих версий; определить стратегию URL локалей | +| P1-09 | §7.4–7.5 | `requires`, `hidden`, `visibility`, `enabled`, `status` частично дублируют друг друга | Описать порядок применения, публикацию зависимых меню/ссылок и значения `null/false/0/[]` | +| P1-10 | §7.5 | `verified: true` не подтверждает реальную достоверность цифр | Ввести необязательную ссылку `evidence` и ручной статус проверки; валидатор может проверить наличие, но не истинность | +| P1-11 | §8.2 | Заявлено 22 MVP-фрагмента, перечислено 23 имени | Исправить количество и отделить семейства/варианты от самостоятельных фрагментов | +| P1-12 | §9.3, §13 | Аудит `before/after` может дублировать персональные данные удалённых заявок | Не сохранять значения ПД в аудите по умолчанию, логировать ID и тип операции; определить сроки хранения бэкапов/логов | +| P1-13 | §9.4 | CSV-экспорт заявок без политики безопасности | Экранировать формулы CSV, фиксировать факт экспорта в аудит, разграничить доступ и хранение | +| P1-14 | §12.1 | Есть `create_page`, но нет `delete_page`, `rename_page`, `delete_entry`; нет batch-патча | Уточнить минимальные жизненные операции и `patch_page` вместо расширения десятками однотипных команд | +| P1-15 | §6.2, §14 | 500 страниц за 10 с, страница за 1 с без определения нагрузки | Сначала базовый benchmark: конфигурация CPU/RAM, cold/warm, обработка изображений, полный/инкрементальный build | + +## 5. Где переусложнён MVP + +### 5.1. Слишком много специализированных фрагментов + +В §8.2 фактически **23 самостоятельных имени фрагментов в MVP** (если `site_header` и `site_footer` считать отдельно), хотя в тексте указано 22. И это не полный объём: помимо них нужны библиотека CSS/JS, конфигурации, рендер, схемы, превью и тесты. + +**Предлагаемое минимальное ядро: 15 фрагментов:** + +1. `site_header` +2. `site_footer` +3. `hero` +4. `page_header` +5. `section` +6. `richtext` +7. `image` +8. `card_grid` (варианты: features, steps, links) +9. `collection_list` +10. `entry_header` +11. `cta_banner` (варианты: контакт, внешняя ссылка, форма) +12. `form` +13. `faq` +14. `disclaimer` +15. `steps` — только если вариант `card_grid` семантически/стилистически недостаточен; иначе заменить на `contact_block`. + +В таком наборе `breadcrumbs` — встроенная функция `page_header`, `pagination` — часть `collection_list`, `requisites` — часть `site_footer` или обычных данных, `legal_text` — шаблон страницы с `richtext`. `feature_grid` обычно вариант `card_grid`; `contact_block` на старте может быть вариантом CTA/контента. `columns` вводить, когда доказано, что `section` со схемой сетки недостаточен. + +**Важно:** если цель именно собирать большой спектр лендингов, `columns` полезнее `steps`. Тогда берём `columns` вместо `steps`. Набор из 15 — ориентир для пилота, не догма. + +### 5.2. Универсальная политика готовности контента — не задача ядра + +**Где:** §7.1, §7.4, §7.5. +`plan.priority`, `plan.state`, `goal`, `next`, `data_ready`, `verified`, `features` образуют отдельную редакционную/проектную подсистему, вытекшую из одного примера сайта. + +**Предложение:** оставить в ядре `status`, `hidden`, `visibility` (последнее — возможно позже), обычные ссылки и строгие схемы. Всё планирование перенести в необязательный namespace `editorial` или `x-*`, доступный для проекта и MCP. Правила типа `scenario-disclaimer` — подключаемый набор валидаторов конкретного сайта, а не универсальная логика ядра. `requires` в MVP только явные `feature.` с чёткой булевой семантикой; `data.*` — позже. + +### 5.3. Упростить структуру файлов страниц + +Сейчас разрешены и `pages/*.md`, и `pages/*.yaml`. Для MVP можно поддержать **только Markdown с YAML front matter**, включая пустое тело. Это уменьшит число ветвей парсера, схем и миграций, сохранив читаемость Git. Добавление чисто YAML-страниц не является блокирующей функцией. + +Отдельно определить, что сложные структуры `regions` сериализуются стабильно, а пустой Markdown body допустим. + +### 5.4. Инкрементальность не должна определять первую архитектуру + +Собирать 500 небольших страниц из файлов и кешировать изображения может оказаться достаточно быстро без зависимостного графа. Предложение: сперва чистая детерминированная полная сборка, реальные профили времени и только потом граф `refs` и инкрементальные invalidation-правила. Граф полезен, но дорого тестируется: меню, шаблоны, тема и данные способны влиять на сотни страниц сразу. + +### 5.5. История Git и ревизии БД дублируют функции + +В ТЗ есть «каждое сохранение — Git-коммит» либо отдельный механизм `revisions`. На старте это две схемы работы, конфликтующие по UX и откатам. + +**Предложение:** Git рекомендован для разработки и агентских изменений; внутренние публикации сохраняют immutable release snapshot вне зависимости от Git; полноценный UI истории/undo — после MVP. Коммитить лучше *логическое изменение* / changeset, а не каждый клик автосохранения. + +## 6. MCP: меньший набор, более сильные контракты + +В спецификации большой список атомарных команд, но мало сказано о композиции, ревизиях и размерах результатов. + +**MVP API для агента:** + +| Назначение | Методы | +|---|---| +| Узнать возможности | `get_site_info`, `get_content_schema`, `list_pages`, `get_page`, `list_entries`, `get_entry`, `list_fragments` | +| Изменить | `create_page`, `patch_page`, `create_entry`, `update_entry`, `upload_asset` | +| Проверить | `validate`, `get_preview_url`, `get_diff` | +| Завершить | `submit_for_review` — лишь если в MVP реально есть review workflow | + +`patch_page` принимает список типизированных операций с `if_match` и `dry_run`; изменение URL — отдельная высокоуровневая операция `rename_page`, одновременно обновляющая редиректы. `publish` и `rollback` в MCP по умолчанию отключены. Доступ агенту — минимальные scopes, позволяющие работать с конкретными страницами или коллекциями, без чтения заявок. + +**Дополнительные обязательные контракты:** ограничения на размер ответа, пагинация `list_*`, размер/способ загрузки asset, срок жизни токена, structured error codes, max-op count, audit correlation ID, запрет широкого `update_data` вне явно разрешённых путей. + +Если требуется совместная работа с редактором, безопаснее по умолчанию модель **draft + optimistic concurrency + ручной publish**. Git-ветки `agent/*` опциональны для команд, которым они действительно нужны. + +## 7. Формы, приватность, обработка заявок + +**Технический контур:** + +1. Сохранить заявку и запись в outbox атомарно в SQLite. +2. Выдать успех после фиксации данных, независимо от Telegram/email. +3. Worker отправляет уведомления с backoff и видимым статусом доставки. +4. Ограничить size/число полей, проверять типы данных, экранировать сообщения в Telegram/email и CSV. +5. Согласие хранить как `policy_id`, `policy_version`/hash, `accepted_at`, язык и проверенную сервером отметку; не рассчитывать, что одна галочка универсально покрывает все правовые основания обработки. +6. Логи и аудит не должны оставлять вечные копии удалённых персональных данных. Для бэкапов указать срок и процедуру восстановления/удаления. +7. В публикации хранить версию формы; сервер принимает версию, с которой посетитель реально отправляет заявку. + +**Рекомендация для первой версии:** один канал (Telegram, поскольку он важен для сайта-примера), опциональный email/webhook — через интерфейс провайдера позднее. Не делать много каналов раньше гарантированной доставки одного. + +## 8. Границы безопасности, которые надо зафиксировать + +| Поверхность | Минимальный контроль | +|---|---| +| Markdown и text props | Autoescape + отдельная санитизация HTML после Markdown, без raw HTML по умолчанию | +| Jinja-фрагменты | Только подтверждённый developer-код, ограниченный контекст и лимиты рендера | +| `script.js` | Только developer, CSP, запрет inline handlers, версионный review | +| Python-миграции сайта | Не запускать автоматом из непроверенного сайта | +| Публичное превью | Токенизированный доступ, отдельная зона cookie/origin, `noindex`, ограниченный срок | +| Админка | Secure/HttpOnly/SameSite cookies, CSRF, rate-limit, аудит мутаций | +| MCP | Scope на объект/раздел, короткие токены, rate-limit, audit trail, `if_match` | +| Медиа | MIME sniffing, разрешённые форматы, лимиты, нормализация пути, карантин/обработка SVG | +| Файловая система | Нет записи вне site root, нет следования symlink наружу, контроль прав и путей | +| Заявки | RBAC, минимизация и сроки хранения ПД, защищённый экспорт, безопасные бэкапы | + +## 9. Обновлённые этапы реализации + +Предлагаю планировать не по списку подсистем, а по **вертикальным цепочкам, которые можно целиком проверить**. + +| Этап | Что реализовать | Готовность к выходу | +|---|---|---| +| **M0 — Контракт и статический прототип** | Форматы, модель Block/Layout/Fragment, 5–7 фрагментов, `load → validate → render`, один сайт, CLI | Чистая сборка сайта из Git без заранее подготовленной БД | +| **M1 — Публикуемый движок** | Маршруты, ссылки, базовая тема, превью, атомарная публикация/rollback, 404/SEO, draft vs live | Можно безопасно опубликовать и откатить полноценный небольшой сайт | +| **M2 — Коллекции и заявки** | Минимальные коллекции/display, query MVP, формы, SQLite outbox, минимальная админка заявок, аутентификация | Работает сайт услуг + отправка заявок, в том числе после отката | +| **M3 — MCP и редактор** | RBAC+аудит (базовые правила безопасности должны появиться до внешнего доступа), CAS/patch, MCP read/write, простая админка htmx | Человек и агент могут менять черновики без потери данных; публикация под контролем человека | +| **M4 — Расширение** | Остальные фрагменты, медиа-варианты, Git-workflow, поиск, инкрементальная сборка только по benchmark | Реальные потребности нескольких сайтов закрыты без усложнения ядра | +| **Позже** | Мультиязычная админка, сложные таксономии, визуальный editor-in-page, scheduled publication, extensions marketplace | Есть конкретные use cases и автоматические регрессионные тесты | + +**Замечание:** минимальную auth/authorization модель следует разработать уже на M1, если там появляется любой публичный API редактирования; в схеме выше внешние изменения подключаются на M3. + +## 10. Решения по открытым вопросам (§16) + +| Вопрос | Решение для MVP | Почему | +|---|---|---| +| Git обязателен? | **Не обязателен для runtime**, но рекомендован для разработки; релизы всегда immutable | Развёртывание проще, нет двух обязательных механизмов версионности | +| Поиск | **Отложить**; при необходимости статический JSON с клиентским поиском | Небольшие сайты не требуют серверного FTS | +| Мультиязычность | Только schema-ready; **не генерировать фиктивные hreflang** | Половинчатая поддержка создаёт ошибки SEO | +| Кто отдаёт статику | Nginx в production, FastAPI в dev | Ясное разделение нагрузки и обязанностей | +| Уведомления | Telegram + SQLite outbox сначала; дополнительные адаптеры потом | Надёжность важнее числа интеграций | +| Курсы и оплата | Внешний URL / форма заявки, без собственной кассы | Соответствует границам v1 | +| JS во фрагментах | Только доверенный developer-код, контентным ролям нельзя | Чёткая граница безопасности | +| Auth | Локальные аккаунты на старте, SSO позже | Минимум дополнительных зависимостей | +| Агент | Правка draft + `if_match`; публикация человеком; Git-ветки необязательны | Контроль и простота на первом этапе | +| Название | Не является блокирующим архитектурным решением | Не влияет на контракты | + +## 11. Набор обязательных тестов, которого не хватает в ТЗ + +- **Fresh clone test:** без старой SQLite работают маршруты, редиректы, сборка. +- **Round trip:** parse → serialize → parse не меняет дерево блоков и их ID. +- **Conflict test:** две одновременные операции на одной странице; одна получает 409, данные не теряются. +- **Invalid draft test:** черновик сохраняется, но неподготовленная страница не попадает в публичный релиз. +- **Broken reference test:** опубликованная страница не может ссылаться на неопубликованную/удалённую запись. +- **Route collision test:** обычные, сгенерированные, taxonomies, redirects и reserved paths не пересекаются. +- **Full rollback test:** HTML, ассеты, ссылки и формы продолжают работать после отката. +- **Partial failure test:** ошибка генерации изображений/Telegram/DB не портит `dist/current`. +- **Privilege escalation test:** agent/editor не может править фрагмент, читать ПД или публиковать без scope. +- **Preview isolation test:** токен превью не открывает админку и чужие черновики. +- **Performance test:** сравнить cold/warm build на фиксированном оборудовании до введения графа зависимостей. +- **Visual baseline:** помимо snapshot HTML — browser screenshots для 3 ширин экрана; особенно hero/header/footer и mobile navigation. + +## 12. Предлагаемые ADR + +Зафиксировать короткие ADR **до реализации** спорных системных решений: + +1. **ADR-001: file-first, SQLite only for service data/cache, redirect persistence in YAML.** +2. **ADR-002: composition model, typed bindings and query DSL subset.** +3. **ADR-003: workspace vs release vs live, rollback and dynamic form compatibility.** +4. **ADR-004: optimistic concurrency and atomic changesets.** +5. **ADR-005: trust model for templates, JS, agent and preview.** +6. **ADR-006: MVP scope and release milestones.** + +## 13. Итоговая рекомендация + +**Не перерабатывать концепцию целиком.** Сохранить файловый движок, FastAPI + htmx, композицию layout/fragment/block, минимальные коллекции и MCP. Основные усилия направить на определения контрактов, безопасность изменения контента и релизный процесс. Урезать первые версии до работающего сайта, где агент способен создавать/менять страницу, пользователь — смотреть превью, а публикация и rollback не теряют данные и не ломают формы. + +Главная опасность ТЗ — не выбор стека, а сложность, скрытая в сочетании **динамических привязок, схем, агентов, редакционных статусов и инкрементальной публикации**. Если эти подсистемы разрабатывать сразу как универсальную CMS, объём резко вырастет. Вертикальные срезы и строгие контракты позволят сохранить достоинства архитектуры и избежать ненужных затрат. diff --git a/design/docs/stage7/reference_TZ-site-engine.md b/design/docs/stage7/reference_TZ-site-engine.md new file mode 100644 index 0000000..131a9e9 --- /dev/null +++ b/design/docs/stage7/reference_TZ-site-engine.md @@ -0,0 +1,769 @@ +# ТЗ: движок сайтов на Markdown + YAML и фрагментах + +*Черновик v0.1 · 6 ноября 2026 · на ревью · рабочее название проекта пока не задано* + +## Что просим проверить на ревью + +1. Источник истины: файлы (md + yaml), SQLite только как индекс и служебные данные (разделы 2, 13). +2. Модель Layout / Fragment / Block, привязки и запросы (разделы 3–4). +3. Расширения модели по итогам карты сайта-примера (раздел 7.4) и правила контента (7.5). +4. Состав MVP-набора фрагментов (раздел 8.2). +5. Права агента и набор MCP-инструментов (разделы 11–12). +6. Этапы и открытые вопросы (разделы 15–16). + +## Содержание + +1. Цели и границы +2. Принципы архитектуры +3. Модель сущностей +4. Форматы файлов +5. Структура сайта и маршрутизация +6. Сборка, превью и публикация +7. Опорный пример: студия ботов, AI-систем и автоматизаций +8. Базовый набор фрагментов +9. Формы и заявки +10. Админка (FastAPI + htmx) +11. Роли, права и безопасность +12. MCP-сервер +13. Данные в SQLite (SQLAlchemy) +14. Нефункциональные требования +15. Этапы +16. Открытые вопросы + +## 1. Цели и границы + +Самохостимый движок, в котором сайт — это каталог файлов (Markdown + YAML), а страницы собираются из **layouts** и **fragments** (строительных блоков в духе Liferay). С движком одинаково удобно работать человеку (админка), агенту (MCP) и разработчику (git, CLI). + +**Задачи v1** + +- Контент, структура и шаблоны хранятся в файлах (md + yaml); SQLite хранит индекс и служебные данные. +- Страница = layout + дерево блоков; блок = экземпляр фрагмента со схемой полей. +- Типизированные коллекции контента (кейсы, продукты, услуги и т.д.) со списками, страницами записей, связями и таксономиями. +- Многостраничные сайты: разделы, меню, хлебные крошки, пагинация, редиректы, заготовка под мультиязычность. +- Статическая сборка и динамическое превью, публикация атомарной заменой каталога. +- Админка на FastAPI + htmx; MCP-сервер для агентов с правами и валидацией. +- Новые фрагменты и коллекции добавляются файлами, без правки ядра. + +**Вне v1:** визуальный drag-and-drop прямо по странице, мультитенантность, e-commerce и платежи, личные кабинеты посетителей, комментарии. + +**Стек:** Python 3.12+, FastAPI, SQLAlchemy 2 + SQLite (WAL), Alembic, Jinja2, pydantic v2, YAML (только safe load), markdown-it-py, Pillow, MCP Python SDK; в админке htmx (+ SortableJS, EasyMDE). Node-сборки нет. + +## 2. Принципы архитектуры + +1. **Файлы — источник истины.** БД перестраивается командой `reindex`; исключение — служебные таблицы (пользователи, токены, аудит, заявки с форм). +2. **Один сервисный слой.** Админка, MCP и CLI вызывают одни и те же сервисы, поэтому права, валидация и аудит едины. +3. **Всё, что пишется, проходит схему.** Фрагменты и коллекции описаны схемами; невалидное не сохраняется и не публикуется. +4. **Стабильные ID блоков.** Блок адресуется по `id`, а не по индексу, поэтому страницу безопасно патчить параллельно (человек и агент). +5. **Статика по умолчанию.** Динамика только там, где без неё нельзя: формы, поиск, превью. +6. **Безопасность по умолчанию.** Шаблоны сайта рендерятся в sandbox, права разделены по ролям (раздел 11). +7. **Детерминированная сериализация.** Порядок ключей и форматирование YAML фиксированы, чтобы диффы в git были читаемыми. +8. **Расширение файлами.** Фрагмент, layout или коллекция — это папка или файл, а не код ядра. + +## 3. Модель сущностей + +| Сущность | Что это | Где хранится | +|---|---|---| +| Site | Настройки сайта: домены, локали, тема, умолчания | `site.yaml` | +| Page | Страница, собранная вручную из блоков | `pages/**/*.md` или `*.yaml` | +| Layout | Каркас страницы: HTML-оболочка + регионы | `layouts//` | +| Fragment | Блок: шаблон + схема полей + стили/скрипты | `fragments/<категория>//` | +| Block | Экземпляр фрагмента на странице | внутри page или display template | +| Collection | Тип контента со схемой (cases, products...) | `collections/.yaml` | +| Entry | Запись коллекции | `content//.md` | +| Display template | Как запись коллекции превращается в страницу | `display/.yaml` | +| Taxonomy | Словарь терминов (технологии, отрасли, теги) | коллекция с `kind: taxonomy` | +| Menu | Навигация | `menus/.yaml` | +| Data | Произвольные данные (цены, команда, реквизиты) | `data/*.yaml` | +| Form | Определение формы обратной связи | `forms/.yaml` | +| Asset | Изображения и файлы | `assets/` | + +### 3.1 Блок и дерево композиции + +Поля блока: `id` (короткий стабильный, например `b_7k2m`), `fragment`, `props`, `slots` (именованные списки вложенных блоков), опционально `hidden`, `anchor`, `visibility` (по локали и датам). + +Layout объявляет **регионы**, фрагмент объявляет **слоты**; и то и другое — упорядоченные списки блоков. Фрагмент может ограничивать допустимых детей (`allow`), максимальную глубину вложенности задаёт ядро (по умолчанию 4). + +Значения `props` бывают четырёх видов: литерал; привязка `{bind: путь}`; ссылка на страницу или запись `{page: slug}` / `{entry: коллекция/slug}`; запрос к коллекции `{collection: ...}` (см. 4.8). + +## 4. Форматы файлов + +### 4.1 Структура каталога сайта + +``` +site/ + site.yaml + redirects.yaml + pages/ # ручные страницы; путь файла = URL + index.md + about.md + services/ + _section.yaml # настройки раздела: layout, меню, сортировка + index.md + content/ # записи коллекций + cases/clinic-crm.md + products/ + collections/ # схемы коллекций + display/ # шаблоны отображения записей + layouts/ + fragments/ + menus/ forms/ data/ assets/ +``` + +### 4.2 site.yaml + +```yaml +schema: 1 +name: Acme Dev +base_url: https://acme.example +default_locale: ru +locales: [ru, en] +theme: + tokens: + color.primary: '#0b5fff' + font.body: 'Inter, system-ui, sans-serif' + space.section: 4rem +defaults: + layout: default + seo: {title_suffix: ' — Acme Dev'} +menus: {main: main, footer: footer} +``` + +Фрагменты используют токены темы как CSS-переменные (`var(--color-primary)`), а не зашитые значения: смена оформления не требует правки фрагментов. + +### 4.3 Layout + +```yaml +# layouts/default/layout.yaml +id: default +name: Основной +extends: base # необязательно: наследование оболочки +regions: + - {id: header, fixed: [{fragment: site_header}]} # закреплённые блоки + - {id: main, allow: [section, hero, richtext, 'collection_*']} + - {id: footer, fixed: [{fragment: site_footer}]} +``` + +```jinja +{# layouts/default/layout.html.j2 #} + + +{{ seo_head() }}{{ assets_head() }} + + {{ region('header') }} +
{{ region('main') }}
+ {{ region('footer') }} + {{ assets_body() }} + + +``` + +`fixed`-блоки принадлежат layout и не редактируются на странице; регион с `allow` ограничивает набор фрагментов, которые можно туда ставить. + +### 4.4 Фрагмент + +```yaml +# fragments/marketing/hero/fragment.yaml +id: hero +name: Hero-баннер +category: marketing +version: 1 +fields: + - {key: title, type: text, required: true, max: 120} + - {key: subtitle, type: markdown, inline: true} + - {key: image, type: asset, accept: [image]} + - {key: cta, type: link} + - {key: variant, type: select, options: [light, dark, split], default: light} +slots: {} +preview: {title: Заголовок страницы, variant: dark} +``` + +```jinja +{# fragments/marketing/hero/template.html.j2 #} +
+

{{ props.title }}

+ {% if props.subtitle %}
{{ props.subtitle|md_inline }}
{% endif %} + {% if props.cta %}{{ props.cta.label }}{% endif %} +
+``` + +**Состав папки фрагмента:** `fragment.yaml` (манифест), `template.html.j2`, необязательные `style.css` и `script.js`, `preview.yaml` (данные для превью в админке). + +**Типы полей:** `text`, `textarea`, `markdown`, `number`, `boolean`, `select`, `multiselect`, `date`, `datetime`, `color`, `icon`, `slug`, `link` (страница, запись или URL + подпись + target), `asset` (изображение или файл), `ref` и `refs` (ссылки на записи коллекций), `group` (вложенный объект), `list` (повторяемая группа полей), `query` (запрос к коллекции), `json` (только для разработчиков). + +**Контекст шаблона:** `props`, `slots`, `page`, `site`, `entry` (на страницах записей), `block` (id, anchor), хелперы `href`, `md`, `md_inline`, `asset_url`, `image` (адаптивные варианты), `t` (строки интерфейса). + +**CSS и JS:** подключаются на страницу один раз на фрагмент (дедупликация), CSS изолируется префиксом `.f-`; при сборке всё собирается в хешированные бандлы. Фрагменты не должны зависеть от внешних CDN. + +**Версии:** при несовместимом изменении схемы фрагмента увеличивается `version`, рядом кладётся миграция `migrations/1_to_2.py` (или декларативная карта переименований полей); `validate` и админка показывают блоки, требующие миграции. + +### 4.5 Страница + +```markdown +--- +schema: 1 +title: Заказная разработка +layout: default +status: published # draft | published | scheduled | archived +seo: + description: Разработка ПО под ключ + og_image: assets/og/services.png +regions: + main: + - id: b_7k2m + fragment: hero + props: + title: Заказная разработка ПО + variant: dark + cta: {page: contacts, label: Обсудить проект} + - id: b_9xq1 + fragment: collection_list + props: + source: {collection: services, sort: order, limit: 6} + card: service_card + - id: b_3d8f + fragment: richtext + props: {source: body} +--- +Основной текст страницы в Markdown. Он доступен как `page.body` +и выводится фрагментом `richtext` с `source: body`. +``` + +Если у страницы есть тело, но ни один блок его не использует, `validate` выдаёт предупреждение. Страницы без текста могут быть чистыми `.yaml`-файлами с теми же полями. + +### 4.6 Коллекция и запись + +```yaml +# collections/cases.yaml +id: cases +name: Кейсы +route: /cases/{slug}/ +list_page: /cases/ +display: cases # display/cases.yaml +sort: -date +body: markdown # тело записи — Markdown +fields: + - {key: title, type: text, required: true} + - {key: summary, type: textarea} + - key: client + type: group + fields: + - {key: name, type: text} + - {key: industry, type: ref, to: industries} + - {key: confidential, type: boolean} + - {key: services, type: refs, to: services} + - {key: products, type: refs, to: products} + - {key: tech, type: refs, to: technologies} + - key: metrics + type: list + fields: [{key: label, type: text}, {key: value, type: text}] + - {key: cover, type: asset} + - {key: date, type: date} +``` + +```markdown +--- +title: CRM для сети клиник +slug: clinic-crm +status: published +client: {name: Клиника+, industry: healthcare} +services: [web-development, integrations] +tech: [python, postgresql, react] +metrics: + - {label: Сокращение времени записи, value: '−40%'} +cover: assets/cases/clinic.webp +date: 2026-03-12 +--- +## Задача +Текст кейса в Markdown... +``` + +Коллекции с `kind: taxonomy` (технологии, отрасли, теги) — это те же коллекции, но их записи обычно без тела; для них движок сам строит страницы терминов (`/cases/tag/python/`) по настройке `taxonomy_pages`. + +### 4.7 Display template: запись → страница + +```yaml +# display/cases.yaml +layout: default +seo: + title: '{{ entry.title }}' + description: '{{ entry.summary }}' +regions: + main: + - fragment: entry_header + props: {title: {bind: entry.title}, meta: [{bind: entry.client.name}, {bind: entry.date}]} + - fragment: entry_facts + props: {items: {bind: entry.metrics}} + - fragment: richtext + props: {source: entry.body} + - fragment: related_entries + props: + source: {collection: cases, related_to: entry, by: [services, tech], limit: 3} + - fragment: cta_banner + props: {title: Обсудим ваш проект?, cta: {page: contacts, label: Связаться}} +overrides: allow # запись может дополнять или заменять блоки своим regions +``` + +Когда у записи в front matter есть собственный `regions`, он объединяется с шаблоном по id региона в режиме `append`, `prepend` или `replace` (`regions_mode`, по умолчанию `append`). Так типовая страница остаётся типовой, а особый случай получает уникальные блоки без отдельного шаблона. + +### 4.8 Привязки и запросы + +**Привязка** `{bind: путь}` читает значение из контекста: `entry`, `page`, `site`, `data.<файл>`, `params` (параметры пагинации и фильтров). Ссылки `{page: slug}` и `{entry: коллекция/слаг}` при сборке превращаются в URL с учётом локали; битая ссылка — ошибка сборки. + +**Запрос** (`type: query` или `source:`): + +| Ключ | Назначение | +|---|---| +| `collection` | коллекция-источник | +| `where` | условия: `eq`, `in`, `contains`, `gte`, `lte`, `not` по полям записи, в том числе по `refs` | +| `sort`, `limit`, `offset` | порядок и срез (`-date` — убывание) | +| `paginate` | размер страницы; движок генерирует `/page/2/` и т.д. | +| `ids` | ручной выбор записей в нужном порядке | +| `related_to`, `by` | похожие записи по общим значениям связей | +| `locale` | локаль выборки (по умолчанию текущая) | + +Запросы выполняются при сборке по индексу в SQLite. Зависимости (какая страница читает какие записи) пишутся в граф, чтобы инкрементальная сборка пересобирала только затронутое. + +## 5. Структура сайта и маршрутизация + +### 5.1 Маршруты + +- URL = путь файла в `pages/`: `pages/about.md` → `/about/`, `index.md` → корень раздела. Если имя файла не совпадает с нужным URL (`pages/scenario-legal.md` → `/scenarios/legal/`), адрес задаётся полем `route:` в front matter. +- Записи коллекций получают URL из `route` в схеме коллекции, список — из `list_page`. +- Служебные маршруты генерирует движок: `/sitemap.xml`, `/robots.txt`, `/404.html`, страницы пагинации, страницы терминов таксономий, `/feed.xml` (по настройке). +- Два источника на один URL — ошибка сборки. Слаги латиницей; кириллица в slug автоматически транслитерируется. +- Смена slug записывает старый адрес в историю, и редирект создаётся автоматически; ручные правила лежат в `redirects.yaml`. + +### 5.2 Разделы + +Папка с файлом `_section.yaml` — раздел. Он задаёт значения по умолчанию для вложенных страниц и порядок детей: + +```yaml +# pages/services/_section.yaml +title: Услуги +layout: default +nav: {menu: main, label: Услуги, order: 10} +children_sort: order +defaults: + seo: {title_suffix: ' — Acme'} + plan: {priority: P1} +``` + +Хлебные крошки строятся из дерева разделов и переопределяются полем `breadcrumb:` страницы. + +### 5.3 Меню + +Меню — файлы `menus/*.yaml` плюс пункты, которые страницы объявляют сами (`nav: {menu: footer, label: ..., order: ...}`). Пункт может быть ссылкой на страницу, запись или внешний URL и поддерживает поля `enabled`, `requires` (условия показа, см. 7.4) и `note`. Выключенный пункт остаётся в файле, но не попадает в HTML: это удобно, когда раздел временно исключён. + +### 5.4 Типовые структуры + +| Структура | Как реализуется | +|---|---| +| Лендинг из секций | Страница из блоков `section`, якоря через `anchor`, меню по якорям | +| Обзор + дочерние страницы | Раздел, а в обзоре `collection_list` с `source: {children: current}` или коллекция | +| Каталог: список → карточка | Коллекция + display template, пагинация и фильтры по таксономиям | +| Запись с подстраницами | Подмаршруты записи (`/academy/<курс>/program/`), каждый со своим display template | +| Юридические документы | Layout `legal`: оглавление, дата и версия редакции | +| Служебные страницы | 404, «спасибо» после формы, страница превью, печатная версия | +| Несколько языков | Поле `locales`, переводы рядом (`about.en.md`), связь через `translations`, `hreflang` | + +### 5.5 Границы v1 + +Один запуск движка обслуживает один сайт (каталог `site/`). Каталог `sites/<имя>/` для нескольких сайтов закладываем в структуру путей, но не реализуем. Мультиязычность в v1 ограничена моделью данных (`locale` у страниц и записей) и генерацией `hreflang`; интерфейс переводов в админке откладываем. + +## 6. Сборка, превью и публикация + +### 6.1 Конвейер сборки + +1. **load** — чтение файлов, парсинг YAML и Markdown, нормализация. +2. **validate** — схемы, ссылки, ассеты, уникальность маршрутов, правила сайта (см. 6.5). +3. **index** — запись страниц, записей и графа ссылок в SQLite. +4. **resolve** — выполнение запросов и привязок, сборка меню и хлебных крошек. +5. **render** — Jinja в sandbox, HTML каждой страницы. +6. **postprocess** — бандлы CSS/JS с хешами, варианты изображений (webp, srcset), `sitemap.xml`, поисковый индекс. +7. **publish** — запись в `dist//` и атомарное переключение символической ссылки `current`; последние N сборок хранятся для отката. + +### 6.2 Инкрементальность и скорость + +Граф зависимостей (какая страница читает какие записи, фрагменты и данные) позволяет пересобирать только затронутое. Ориентир для v1: полная сборка сайта до 500 страниц менее 10 секунд, правка одной страницы менее 1 секунды. + +### 6.3 Превью + +Динамический рендер одной страницы из рабочего каталога без записи в `dist`. Показывает черновики и использует те же CSS и JS, что и сборка. В админке открывается во фрейме; для внешних согласований выдаётся ссылка с токеном и сроком жизни. + +### 6.4 Статусы и история + +`status`: `draft` → `review` → `published` (плюс `scheduled` с датой и `archived`). В публикуемую сборку попадают только `published` и `scheduled`, чей срок наступил (проверка по расписанию). История изменений: если каталог сайта — git-репозиторий, каждое сохранение коммитится с автором (человек или агент); изменения агента могут идти в отдельную ветку `agent/*` и вливаться человеком. Без git используются ревизии в таблице `revisions`. + +### 6.5 Проверки `validate` + +Ошибки блокируют публикацию, предупреждения — нет. + +- **Ошибки:** невалидный YAML; поля не по схеме; неизвестный фрагмент или версия; фрагмент не разрешён в регионе; дубли `id` блоков; битые ссылки на страницы, записи и ассеты; конфликты маршрутов; нарушение правил сайта (см. 7.5). +- **Предупреждения:** тело страницы не использовано блоком; нет `seo.description`; у изображения нет `alt`; ассеты без ссылок; блоки на устаревшей версии фрагмента; страницы без входящих ссылок. + +### 6.6 Поиск + +Варианты: статический JSON-индекс с клиентским поиском (без сервера) либо серверный поиск на SQLite FTS5. Решение вынесено в открытые вопросы. + +## 7. Опорный пример: студия ботов, AI-систем и автоматизаций + +Пример взят из карты сайта `SiteMap.md` (черновик v0.1): студия Telegram-ботов, AI-систем и автоматизаций с Академией курсов. Раздел показывает, как реальная карта раскладывается по модели ТЗ и что в модели пришлось дополнить. + +### 7.1 Что ложится в модель как есть + +- Дерево страниц → `pages/` и `_section.yaml`; приоритеты P1/P2 переносятся в поле `plan`. +- Шапка и футер → `menus/main.yaml`, `menus/footer.yaml` и фрагменты `site_header`, `site_footer`. +- Каркас главной из восьми блоков → `pages/index.md` с блоками в регионе `main`. +- Колонки «Задача страницы» и «Куда ведёт дальше» → поля страницы `goal` и `next` (видны в админке, на сайт не выводятся; агент использует их для проверки текстов). + +### 7.2 Коллекции + +| Коллекция | Записи | Маршрут | Заметки | +|---|---|---|---| +| `services` | bots, ai, automation | `/services/{slug}/` | Три записи, общий display template, у каждой свои блоки через `overrides` | +| `scenarios` | legal, real-estate, services | `/scenarios/{slug}/` | Типовые сценарии, а не кейсы: схема без `metrics`, обязательный блок-дисклеймер | +| `courses` | по мере появления | `/academy/{slug}/` | Пустая коллекция допустима, поля в 7.6 | +| `cases` | — | `/cases/{slug}/` | Схема есть, раздел выключен: `features.cases: false` | +| `posts` | — | `/blog/{slug}/` | Схема есть, раздел выключен: `features.blog: false` | + +Ручные страницы: главная, о компании, безопасность и данные, контакты, заявка, политика ПД, оферта, страница «спасибо». + +### 7.3 Каркас главной + +| № | Блок карты | Фрагмент | Особенности | +|---|---|---|---| +| 1 | Hero | `hero` | CTA: Telegram и заявка | +| 2 | Три направления | `collection_list` (`services`, карточка `direction_card`) | Данные из коллекции, дублей нет | +| 3 | Живые примеры | `live_examples` | `hidden`, `requires: [feature.demo]` | +| 4 | Что уже работает | `feature_grid` | Плашки со сроками, данные `verified` | +| 5 | Цифры | `stats` | `hidden`, `requires: [data.stats]` | +| 6 | Как идёт работа | `steps` | 5 шагов | +| 7 | О нас | `about_teaser` | Ссылка на `/about/` | +| 8 | Финальный CTA | `cta_banner` | Telegram и форма | + +Исключённые блоки остаются в файле с прежней нумерацией (`id` стабильны), чтобы вернуть их одной правкой: + +```yaml +- id: b_demo + fragment: live_examples + hidden: true + note: Исключён на старте — нет демо + requires: [feature.demo] +- id: b_stats + fragment: stats + hidden: true + note: Исключён на старте — нет подтверждённых цифр + requires: [data.stats] +``` + +### 7.4 Что добавляем в модель по итогам карты + +| Что в карте | Что добавляем | +|---|---| +| Приоритеты P1/P2, пометки ➕ и ⛔ | Поле страницы `plan: {priority, state: planned/added/excluded/done, note, data_ready}`. Движок строит отчёт готовности сайта, он же доступен агенту через MCP | +| «Исключено на старте, можно вернуть» | Флаги `features` в `site.yaml`; у блока `hidden` и `note`; у пункта меню `enabled`. Возврат — одна правка | +| «Включаем, только если есть чем подтвердить» | `requires:` у блока: список ссылок на `feature.*` и `data.*`; блок рендерится, только если все они не пусты | +| Имя файла не равно URL | `route:` в front matter (см. 5.1) | +| «Сценарий, не кейс», без выдуманных результатов | Отдельная коллекция без `metrics`, обязательный фрагмент `disclaimer` и правило сайта (7.5) | +| «Заявка → Благодарность» | У формы `success.page`; страница «спасибо» добавляется в карту | +| «Оплата / запись» на курс | CTA-тип `enroll`: внешняя платёжная страница или форма записи; своя оплата вне v1 | +| 152-ФЗ и политика ПД | Тип поля формы `consent` (чекбокс, ссылка на политику, версия редакции); факт согласия хранится вместе с заявкой | +| «Ждёт данных о курсах» | Пустое состояние `collection_list` (`empty: hide` или `message`); страница `status: draft` с `plan.data_ready: false` | +| Telegram как основной канал | Секция `contacts` в `site.yaml` и CTA-тип `contact`; смена ника правится в одном месте; уведомления о заявках уходят в Telegram | +| Реквизиты, год и название в футере | `data/company.yaml` и фрагмент `requisites`; год подставляет сборка | + +### 7.5 Правила контента сайта + +Договорённости из карты (без выдуманных результатов, согласие на обработку ПД) превращаются в проверяемые правила в `site.yaml`: + +```yaml +rules: + - {id: scenario-disclaimer, collection: scenarios, require_fragment: disclaimer, level: error} + - {id: verified-numbers, fragments: [stats, feature_grid], require: verified, level: warning} + - {id: form-consent, forms: all, require_field: consent, level: error} +``` + +Правила выполняет `validate`; агент получает их через MCP до правки текстов и не нарушает по неведению. + +### 7.6 Коллекция courses (набросок) + +```yaml +id: courses +name: Курсы +route: /academy/{slug}/ +list_page: /academy/ +display: courses +body: markdown +fields: + - {key: title, type: text, required: true} + - {key: summary, type: textarea} + - {key: audience, type: text} + - {key: format, type: select, options: [self-paced, cohort, live]} + - {key: duration, type: text} + - {key: starts, type: date} + - {key: outcomes, type: list, fields: [{key: item, type: text}]} + - key: program + type: list + fields: [{key: module, type: text}, {key: lessons, type: textarea}] + - key: price + type: group + fields: [{key: amount, type: number}, {key: currency, type: text}, {key: note, type: text}] + - key: enroll + type: group + fields: [{key: kind, type: select, options: [link, form]}, {key: url, type: text}] +``` + +Display template курса: `entry_header` → `feature_grid` (чему научится) → `course_program` → `richtext` → `enroll_block` (цена и запись) → `faq` → ссылка на оферту. Точный состав согласуем, когда появятся данные о курсах. + +### 7.7 Что стоит уточнить в самой карте + +- Нет страницы «спасибо», хотя в таблице задач заявка ведёт на «Благодарность». +- Страница курса отсылает к «шаблону ниже», но в файле его нет. +- «Сценарии» отмечены P1, но пункта в шапке нет: решить, откуда на них ведут ссылки (главная и страницы услуг?). +- «Типовые сроки» в блоке «Что уже работает» — тоже числа: нужен источник или пометка «ориентировочно». + +## 8. Базовый набор фрагментов + +### 8.1 Общие свойства блока + +Эти поля есть у любого блока независимо от фрагмента, во фрагментах их дублировать не нужно: `id`, `anchor`, `hidden`, `note`, `requires`, `visibility` (локали, даты) и `style` (отступы, фон из токенов темы, ширина контейнера). + +### 8.2 Каталог (этап: MVP — первая версия, v1 — следом, позже — по потребности) + +**Структура и заголовки** + +| Фрагмент | Назначение | Ключевые поля | Этап | +|---|---|---|---| +| `section` | Контейнер секции со слотом `content` | фон, ширина, отступы | MVP | +| `columns` | 2–4 колонки, слот на колонку | число колонок, пропорции, выравнивание | MVP | +| `hero` | Первый экран | title, subtitle, image, actions, variant | MVP | +| `page_header` | Заголовок внутренней страницы | title, lead, breadcrumbs | MVP | +| `divider` | Разделитель или отступ | тип, высота | v1 | + +**Контент** + +| Фрагмент | Назначение | Ключевые поля | Этап | +|---|---|---|---| +| `richtext` | Текст в Markdown | source (`body`, `entry.body` или текст) | MVP | +| `image` | Изображение | asset, alt, caption | MVP | +| `disclaimer` | Пометка или оговорка | variant (info, warning), text | MVP | +| `legal_text` | Юридический текст | оглавление, дата и версия редакции | MVP | +| `chat_demo` | Пример диалога в мессенджере (статичный) | messages (from: user или bot), buttons | v1 | +| `gallery`, `video_embed`, `quote`, `code_block`, `table` | Типовые контентные блоки | по назначению | v1 | + +**Карточки и списки** + +| Фрагмент | Назначение | Ключевые поля | Этап | +|---|---|---|---| +| `card_grid` | Сетка карточек | items: title, text, link, icon, badge | MVP | +| `feature_grid` | Преимущества или возможности | items: title, text, icon, badge, verified | MVP | +| `steps` | Этапы работы | items: title, text | MVP | +| `faq` | Вопросы и ответы (разметка FAQ для поиска) | items: q, a | MVP | +| `stats` | Цифры | items: value, label, verified | v1 | +| `logo_cloud`, `team_grid`, `testimonials`, `pricing_table` | Клиенты, команда, отзывы, тарифы | по назначению | v1 | +| `timeline`, `comparison_table` | История и сравнение | по назначению | позже | + +**Коллекции** + +| Фрагмент | Назначение | Ключевые поля | Этап | +|---|---|---|---| +| `collection_list` | Список записей | source, card, layout, paginate, filters, empty | MVP | +| `entry_header` | Шапка страницы записи | title, meta, tags | MVP | +| `related_entries` | Похожие записи | source (`related_to`, `by`), limit | v1 | +| `collection_featured` | Ручная подборка записей | ids, card | v1 | +| `entry_facts` | Ключевые факты записи | items: label, value | v1 | +| `entry_nav` | Предыдущая и следующая запись | collection | v1 | +| `course_program` | Программа курса | modules | v1 | +| `enroll_block` | Цена и запись на курс | price, enroll | v1 | + +**Конверсия и контакты** + +| Фрагмент | Назначение | Ключевые поля | Этап | +|---|---|---|---| +| `cta_banner` | Призыв к действию | title, text, actions (тип: link, contact, form, enroll) | MVP | +| `form` | Форма из `forms/.yaml` | form | MVP | +| `contact_block` | Способы связи | берёт `site.contacts` | MVP | +| `requisites` | Реквизиты компании | берёт `data.company` | MVP | + +**Навигация и глобальное** + +| Фрагмент | Назначение | Ключевые поля | Этап | +|---|---|---|---| +| `site_header`, `site_footer` | Шапка и футер | menu, action, источники данных | MVP | +| `nav_menu` | Меню по id | menu, orientation | MVP | +| `breadcrumbs` | Хлебные крошки | — | MVP | +| `pagination` | Постраничная навигация | используется списками | MVP | +| `toc`, `announcement_bar`, `cookie_notice` | Оглавление, плашка, уведомление о cookie | по назначению | v1 | +| `search_box`, `language_switcher` | Поиск и язык | по назначению | позже | +| `embed_html` | Произвольный HTML в sandbox-iframe | code | позже, только роль developer | + +Итого MVP — 22 фрагмента: хватает на сайт-пример (раздел 7) без ручного HTML. Часть сайта-примера (`direction_card`, `about_teaser`, `live_examples`) — это варианты карточек и тематические обёртки поверх базовых; их добавляем как фрагменты сайта, а не ядра. + +### 8.3 Требования к любому фрагменту + +1. Манифест со схемой полей, `preview.yaml` с тестовыми данными, версия. +2. Семантическая разметка, `alt` у изображений, управляемый фокус, контраст из токенов темы. +3. Только токены темы и классы `.f-`, без внешних CDN и без инлайновых обработчиков. +4. Пустые и граничные данные не ломают вёрстку (`hidden_if_empty`, значения по умолчанию). +5. Автоматический snapshot-тест рендера на `preview.yaml`. + +## 9. Формы и заявки + +### 9.1 Определение формы + +```yaml +# forms/consultation.yaml +id: consultation +title: Заявка на разговор +fields: + - {key: name, type: text, label: Имя, required: true} + - {key: contact, type: text, label: Telegram или телефон, required: true} + - {key: task, type: textarea, label: Расскажите о задаче, hint: Свободная форма, ТЗ не нужно} + - {key: consent, type: consent, policy: privacy} +success: {page: consultation/thanks} +notify: + - {kind: telegram, chat: '${TG_CHAT_ID}'} + - {kind: email, to: ['${LEADS_EMAIL}']} +antispam: {honeypot: true, rate_limit: '5/hour'} +store: {retention_days: 365} +``` + +Секреты (токен бота, адреса) берутся из переменных окружения, в файлах сайта их нет. + +### 9.2 Обработка + +- Форма — единственная динамическая часть статического сайта: `POST /forms/{id}` в FastAPI. Без JS это обычный POST с редиректом на `success.page`; htmx или небольшой скрипт делает отправку без перезагрузки. +- Валидация по схеме формы, запись в таблицу `form_submissions` вместе со снимком согласия (время, версия политики), уведомления через очередь с повторными попытками. +- Защита: honeypot, лимит запросов, проверка размера, экранирование при показе в админке. + +### 9.3 Персональные данные + +Заявки содержат ПД, поэтому: доступ к ним только у ролей с правом `submissions:read`, срок хранения и автоматическое удаление, экспорт и удаление по запросу, аудит просмотров. Требования закона к хранению и размещению сервера определяет владелец сайта вместе с юристом; движок даёт технические средства (согласие с версией, срок хранения, удаление, журнал). + +### 9.4 Админка заявок + +Список со статусами (`new`, `processed`, `spam`), поиск, заметки, экспорт в CSV. + +## 10. Админка (FastAPI + htmx) + +### 10.1 Экраны + +| Экран | Что делает | +|---|---| +| Обзор | Отчёт готовности по `plan`: что готово, что ждёт данных, что исключено; ошибки и предупреждения `validate`; последние сборки | +| Страницы | Дерево разделов, статусы, фильтры, создание и перенос страниц | +| Редактор страницы | Регионы и блоки: добавить, удалить, переместить; форма блока строится из схемы фрагмента; превью во фрейме | +| Коллекции | Таблица записей с фильтрами; форма записи; Markdown-редактор | +| Фрагменты и layouts | Каталог с превью и схемой полей; правка кода только у роли developer | +| Меню и данные | Редактирование `menus/*.yaml` и `data/*.yaml` формами по схемам | +| Медиа | Загрузка, подписи (`alt`), поиск неиспользуемых файлов | +| Формы и заявки | Список заявок, статусы, экспорт | +| Доступ | Пользователи, роли, токены агентов | +| Журнал и сборки | Аудит, история публикаций, откат | + +### 10.2 Технические решения + +- Серверный рендер Jinja-партиалами; htmx заменяет регион страницы или форму блока, JS-сборки нет. SortableJS — перенос блоков, EasyMDE — Markdown. +- Формы блоков генерируются из схемы фрагмента макросами по типам полей; ошибки валидации возвращаются в ту же форму. +- Конфликты редактирования: при открытии запоминается хеш файла, при сохранении он сверяется; при расхождении показывается diff и выбор действия (так человек и агент не затирают друг друга). +- Сессионная cookie, CSRF-токен через `hx-headers`, лимит попыток входа. +- Два окружения Jinja: админское и сайтовое (sandbox). Шаблоны сайта не получают доступа к объектам админки. + +## 11. Роли, права и безопасность + +### 11.1 Роли + +| Действие | owner | developer | editor | reviewer | agent | +|---|---|---|---|---|---| +| Страницы, записи, данные, меню | да | да | да | нет | по scope | +| Фрагменты, layouts, схемы коллекций | да | да | нет | нет | нет | +| Публикация и откат | да | да | да | нет | только если разрешено владельцем | +| Согласование и комментарии | да | да | да | да | нет | +| Заявки (ПД) | да | нет | по праву `submissions:read` | нет | нет | +| Пользователи, токены, настройки | да | нет | нет | нет | нет | + +Токен агента несёт scope (например `read`, `content:write`, `publish`), срок жизни и ограничение по разделам сайта. По умолчанию агент пишет в `draft` или в ветку `agent/*`, публикует человек. + +### 11.2 Меры безопасности + +- Шаблоны сайта рендерятся в Jinja `SandboxedEnvironment`, доступны только разрешённые фильтры и функции; шаблоны читаются только из каталога сайта. +- Raw HTML в Markdown выключен по умолчанию; допустимые теги — allowlist, вывод проходит санитизацию. `embed_html` и произвольные скрипты — только роль developer. +- YAML читается только безопасным загрузчиком, с лимитами размера, глубины и числа алиасов. +- Загрузки: проверка типа по содержимому, лимит размера, санитизация SVG, запрет исполняемых типов; защита от выхода за каталог (path traversal). +- Заголовки: CSP, `X-Content-Type-Options`, `Referrer-Policy`; CSRF для админки; лимиты на вход, формы и MCP. +- Токены хранятся только в виде хеша; секреты — в переменных окружения; все записи и просмотр заявок попадают в `audit_log` с актором (человек или агент). +- Резервные копии: каталог сайта (git или архив) и файл SQLite с проверкой восстановления. + +## 12. MCP-сервер + +Транспорт: Streamable HTTP внутри того же FastAPI-приложения; авторизация Bearer-токеном со scope. Инструменты вызывают сервисный слой, поэтому права и валидация такие же, как в админке. + +### 12.1 Инструменты + +| Группа | Инструменты | +|---|---| +| Чтение | `get_site_plan`, `get_rules`, `list_pages`, `get_page`, `list_collections`, `list_entries`, `get_entry`, `list_fragments`, `get_fragment_schema`, `list_layouts`, `list_menus`, `list_assets`, `search` | +| Запись | `create_page`, `update_page_meta`, `add_block`, `update_block`, `move_block`, `remove_block`, `set_block_visibility`, `create_entry`, `update_entry`, `update_menu`, `update_data`, `upload_asset` | +| Контроль | `validate`, `render_preview` (HTML или скриншот), `diff`, `submit_for_review`, `publish`, `list_builds`, `rollback` | + +### 12.2 Принципы + +- Блоки адресуются по `id`, поля — по пути (`regions.main[b_7k2m].props.cta.label`); индексы позиций не используются. +- Все записи принимают `dry_run` и `if_match` (хеш версии файла); при конфликте возвращается актуальная версия. +- Ошибки валидации приходят структурой: путь к полю, правило, ожидаемое значение, подсказка, как исправить. +- Схемы и правила сайта публикуются как MCP-ресурсы; типовые задачи («страница по брифу», «перевод страницы», «проверка текста по карте») — как MCP-промпты. +- Агент не может менять фрагменты, layouts и схемы без роли developer. + +## 13. Данные в SQLite (SQLAlchemy) + +Индексные таблицы восстанавливаются командой `reindex`; остальные хранят то, чего нет в файлах. + +| Таблица | Содержимое | Восстанавливается из файлов | +|---|---|---| +| `pages_index` | путь, маршрут, локаль, статус, layout, `plan`, front matter (JSON), хеш | да | +| `entries_index` | коллекция, slug, маршрут, статус, данные (JSON), хеш | да | +| `refs` | граф ссылок и зависимостей страниц от записей, фрагментов и данных | да | +| `fragments_index`, `assets_index` | фрагменты (версия, схема), ассеты (размер, тип, хеш) | да | +| `search_fts` | полнотекстовый индекс FTS5 | да | +| `slug_history` | старые адреса для редиректов | нет | +| `revisions` | ревизии, если сайт не в git | нет | +| `users`, `roles`, `sessions`, `api_tokens` | доступ; токены только в виде хеша | нет | +| `audit_log` | действия с актором, объектом, до и после | нет | +| `form_submissions` | заявки, согласия, статусы | нет | +| `build_runs` | сборки: статус, время, лог, кто запустил | нет | +| `locks` | блокировки записи страниц | нет | + +SQLite в режиме WAL, миграции Alembic, синхронный доступ в threadpool. + +## 14. Нефункциональные требования + +- **Производительность:** см. 6.2; отдача сайта — статика, нагрузка на FastAPI только от админки, форм и MCP. +- **Надёжность:** атомарная запись файлов (временный файл и rename), атомарная публикация сборки, откат на предыдущую. +- **Развёртывание:** один Docker-образ, тома `site/`, `data/` (SQLite), `dist/`; конфигурация через переменные окружения; статику отдаёт nginx или сам FastAPI. +- **Доступность и SEO:** базовые фрагменты соответствуют WCAG 2.1 AA; canonical, Open Graph, `sitemap.xml`, разметка schema.org там, где применимо. +- **Тестирование:** unit-тесты парсеров и схем; snapshot-тесты рендера каждого фрагмента; сквозной тест сборки сайта-примера; контрактные тесты MCP-инструментов. +- **Наблюдаемость:** структурированные логи, журнал сборок, метрики времени сборки и ошибок валидации. + +## 15. Этапы + +| Этап | Состав | +|---|---| +| M0. Ядро | Парсер md + yaml, схемы (pydantic из манифестов), индекс, рендер, CLI (`build`, `validate`, `serve`, `reindex`), 10 базовых фрагментов; сайт-пример как тестовый набор | +| M1. Коллекции и MCP | Коллекции, display templates, запросы, меню, привязки; MCP: чтение и запись, `validate`, превью; формы и заявки | +| M2. Админка | Экраны раздела 10, роли, токены, аудит, конфликты редактирования | +| M3. Полный MVP-набор | Все 22 фрагмента, тема, инкрементальная сборка, публикация и откат, интеграция с git | +| M4. Расширение | Поиск, мультиязычность, медиа-варианты, фрагменты v1 | +| Позже | Визуальный редактор на самой странице | + +## 16. Открытые вопросы + +1. История изменений: git обязателен или допускаем только таблицу `revisions`? +2. Поиск: статический индекс на клиенте или FTS5 на сервере? +3. Мультиязычность: нужна в первой версии или только заложить модель? +4. Публикация: кто отдаёт `dist` (nginx или FastAPI) и где живёт сервер? +5. Формы: какие каналы уведомлений нужны сразу (Telegram, почта, webhook)? +6. Оплата курсов: внешний провайдер ссылкой или форма записи без оплаты? +7. Политика JS во фрагментах: разрешён ли собственный JS у фрагментов сайта или только из набора ядра? +8. Аутентификация админки: локальные аккаунты или внешний провайдер (SSO)? +9. Режим работы агента: прямая запись в `draft` или обязательно через ветку и согласование? +10. Название проекта. diff --git a/design/docs/test_stage6.py b/design/docs/test_stage6.py new file mode 100644 index 0000000..5c08c0d --- /dev/null +++ b/design/docs/test_stage6.py @@ -0,0 +1,80 @@ +from playwright.sync_api import sync_playwright +from pathlib import Path +import json +BASE=Path('/mnt/data/site-engine-admin-stage6') +CSS=(BASE/'assets/publication.css').read_text()+'\n'+(BASE/'assets/stage6.css').read_text().replace("@import url('publication.css');",'') +JS=(BASE/'assets/stage6.js').read_text() +def load(page,theme): + markup=(BASE/f'modules-{theme}.html').read_text().replace('','').replace('','') + page.set_content(markup,wait_until='load') + page.add_script_tag(content=JS) + +errs=[] +with sync_playwright() as p: + browser=p.chromium.launch(headless=True,executable_path='/usr/bin/chromium',args=['--no-sandbox','--disable-gpu']) + for theme in ['rose-graphite','antirion']: + page=browser.new_page(viewport={'width':1440,'height':900}) + page.on('pageerror',lambda e:errs.append(str(e))) + load(page,theme) + print(theme,'MEDIA',page.locator('h1').inner_text(),page.locator('.asset-card').count()) + assert page.locator('.asset-card').count()==8 + page.locator('[data-action="asset-edit"]').first.click() + page.locator('#asset-form input[name="alt"]').fill('Проверочное описание медиафайла') + page.locator('#asset-form button[type="submit"]').count() # external button through form attr + page.locator('button[form="asset-form"]').click() + assert 'Проверочное описание' in page.locator('.module-shell').inner_text() + page.locator('[data-nav="structure"]').first.click() + assert 'Структура сайта' in page.locator('h1').inner_text() + page.locator('[data-action="menu-add"]').first.click() + page.locator('#menu-edit-form input[name="title"]').fill('Блог') + page.locator('#menu-edit-form input[name="url"]').fill('/blog/') + page.locator('button[form="menu-edit-form"]').click() + assert 'Блог' in page.locator('.node-rows').inner_text() + page.locator('[data-action="structure-tab"][data-id="fragments"]').click() + page.locator('[data-action="structure-usage"]').click() + assert 'Где используется' in page.locator('#modal-title').inner_text() + page.locator('[data-action="close-modal"]').first.click() + page.locator('[data-nav="forms"]').first.click() + assert page.locator('h1').inner_text()=='Формы и заявки' + page.locator('[data-field-enabled="telegram"]').uncheck() + page.locator('[data-field-enabled="telegram"]').check() + assert 'Telegram' in page.locator('.form-preview').inner_text() + page.locator('[data-action="forms-tab"][data-id="leads"]').click() + assert 'Мария К.' in page.locator('.module-shell').inner_text() + page.locator('[data-action="role-picker"]').click() + page.locator('[data-action="role-change"][data-id="reviewer"]').click() + assert 'Контакт скрыт' in page.locator('.module-shell').inner_text() + assert 'Мария К.' not in page.locator('.module-shell').inner_text() + page.locator('[data-action="role-picker"]').click() + page.locator('[data-action="role-change"][data-id="owner"]').click() + page.locator('[data-nav="settings"]').click() + page.locator('[data-action="settings-tab"][data-id="redirects"]').click() + page.locator('[data-action="redirect-add"]').click() + page.locator('#kv-form input[name="from"]').fill('/old-test/') + page.locator('#kv-form input[name="to"]').fill('/test-new/') + page.locator('button[form="kv-form"]').click() + assert '/old-test/' in page.locator('.table').inner_text() + page.locator('[data-nav="journal"]').click() + assert 'Журнал действий' in page.locator('h1').inner_text() + assert page.locator('[data-action="audit-view"]').count()>0 + page.locator('[data-action="audit-view"]').first.click() + assert 'Событие' in page.locator('#modal-title').inner_text() + page.locator('[data-action="close-modal"]').first.click() + page.keyboard.press('Control+k') + assert 'Быстрый переход' in page.locator('#modal-title').inner_text() + page.locator('#command-search').fill('Медиа') + page.locator('[data-action="command-nav"][data-id="media"]').click() + assert 'Медиабиблиотека' in page.locator('h1').inner_text() + page.screenshot(path=str(BASE/'previews'/f'stage6-{theme}-media-1440.png'),full_page=True) + for width,height in [(1440,900),(1280,800),(1024,768),(768,1024),(390,844),(360,740)]: + page.set_viewport_size({'width':width,'height':height}) + over=page.evaluate('document.documentElement.scrollWidth - document.documentElement.clientWidth') + if over>1:errs.append(f'{theme} {width} overflow {over}') + if width==390: + page.screenshot(path=str(BASE/'previews'/f'stage6-{theme}-media-390.png'),full_page=True) + print('VIEW',theme,width,over) + page.close() + browser.close() +print('ERRORS',errs) +(BASE/'docs/STAGE6_QA_TEST_OUTPUT.txt').write_text(json.dumps({'errors':errs,'status':'pass' if not errs else 'fail'},ensure_ascii=False,indent=2)) +if errs:raise SystemExit(1) diff --git a/design/docs/test_stage6_views.py b/design/docs/test_stage6_views.py new file mode 100644 index 0000000..be4a9c0 --- /dev/null +++ b/design/docs/test_stage6_views.py @@ -0,0 +1,30 @@ +from pathlib import Path +from playwright.sync_api import sync_playwright +import json +BASE=Path('/mnt/data/site-engine-admin-stage6');CSS=(BASE/'assets/publication.css').read_text()+'\n'+(BASE/'assets/stage6.css').read_text().replace("@import url('publication.css');",'');JS=(BASE/'assets/stage6.js').read_text() +results=[];errors=[] +with sync_playwright() as pw: + b=pw.chromium.launch(executable_path='/usr/bin/chromium',headless=True,args=['--no-sandbox']) + for theme in ['rose-graphite','antirion']: + raw=(BASE/f'modules-{theme}.html').read_text().replace('','').replace('','') + for section in ['media','structure','forms','settings','journal']: + page=b.new_page(viewport={'width':1440,'height':900});page.on('pageerror',lambda e:errors.append(str(e))) + page.set_content(raw);page.add_script_tag(content=JS) + if section!='media':page.locator(f'[data-nav="{section}"]').first.click() + page.wait_for_timeout(220) + title=page.locator('h1').inner_text() + overflow=page.evaluate('document.documentElement.scrollWidth-document.documentElement.clientWidth') + if overflow>1:errors.append(f'{theme} {section} desktop overflow {overflow}') + page.screenshot(path=str(BASE/'previews'/f'stage6-{theme}-{section}-1440.png'),full_page=True) + page.set_viewport_size({'width':390,'height':844});page.wait_for_timeout(390) + overflow=page.evaluate('document.documentElement.scrollWidth-document.documentElement.clientWidth') + if overflow>1:errors.append(f'{theme} {section} mobile overflow {overflow}') + left=page.evaluate('document.querySelector(".side").getBoundingClientRect().right') + if left>0:errors.append(f'{theme} {section} sidebar not hidden when mobile: {left}') + page.screenshot(path=str(BASE/'previews'/f'stage6-{theme}-{section}-390.png'),full_page=True) + results.append(dict(theme=theme,section=section,title=title,desktopOverflow=0,mobileOverflow=overflow)) + page.close() + b.close() +report={'checks':results,'errors':errors};(BASE/'docs/STAGE6_VISUAL_QA.json').write_text(json.dumps(report,ensure_ascii=False,indent=2)) +print('screens',len(results),'errors',errors) +if errors:raise SystemExit(1) diff --git a/design/ember-graphite.html b/design/ember-graphite.html new file mode 100644 index 0000000..e3524ec --- /dev/null +++ b/design/ember-graphite.html @@ -0,0 +1 @@ +Site Engine — 05 Ember / Graphite
diff --git a/design/gradients-ember.html b/design/gradients-ember.html new file mode 100644 index 0000000..42f56be --- /dev/null +++ b/design/gradients-ember.html @@ -0,0 +1,9 @@ +05 / Ember Graphite — gradients
05 / SITE ENGINE / COLOR SYSTEM
← Админка

EMBER GRAPHITE.

Семь градиентов, перенесённых из палитры Flexly AI 04-ember-graphite. Тёплый copper / rust / ember + холодная графитово-бирюзовая глубина.

GRAPHITE #0D1418DEEP TEAL #1B2E33CORAL #F47A42RUST #C3563ECOPPER #F9B17BEMBER #B43D2B
01 / 07

EMBER SIGNAL

CTA / активное действие

+
02 / 07

AMBIENT COPPER

Мягкая подсветка

+
03 / 07

TEAL MIDNIGHT

Фон боковой навигации

+
04 / 07

SALMON HALO

Подсветка обзора

+
05 / 07

CHARCOAL GLASS

Графитовые панели

+
06 / 07

RUST TO TEAL

Тёплый переход к холодному

+
07 / 07

DARK NETWORK

Холодная фоновая подсветка

\ No newline at end of file diff --git a/design/index.html b/design/index.html new file mode 100644 index 0000000..7a71511 --- /dev/null +++ b/design/index.html @@ -0,0 +1,33 @@ +Site Engine · Admin Design Lab · Этап 6
+
SITE ENGINE / ADMIN DESIGN LAB / ЭТАП 6
+

Админка Site Engine.
Функциональный прототип.

Этап 6 завершает интерфейс: медиабиблиотека, структура сайта, формы и заявки, настройки и доступы, MCP-агенты и журнал. Этапы 2–5, включая релизы и откат, остаются доступными без потери функциональности. Развиваем два согласованных оформления: 04 Antirion Rework и 06 Rose Graphite (ранее YuE Studio). Стили 03 и 05 сохранены без расширения редактора. Ранее утверждённый редактор страниц с Этапа 3 сохранён. Работа остаётся локальным HTML-прототипом без backend и реальной публикации.

СТАТУСStage 6 · Complete UIMedia · Structure · Forms · Settings · Audit
+ +
+ + +
+ +
+
Светлый Antirion Rework — изменения и публикация

04 / Antirion Rework — Публикация

Светлая рабочая зона, список изменённых файлов, предупреждения, сборка, сравнение снимков, история и откат.

+ +
+ +
+
Контент и коллекции в Antirion Rework

04 / Antirion Rework — Контент

Светлая рабочая зона: выбор коллекций и записей, формы по схеме, связи, Markdown и рендер превью. Два режима редактирования с общими данными.

+ +
+ +
+ + +
+ + +
diff --git a/design/modules-antirion.html b/design/modules-antirion.html new file mode 100644 index 0000000..603d572 --- /dev/null +++ b/design/modules-antirion.html @@ -0,0 +1 @@ +Site Engine — Этап 6 · Antirion Rework
diff --git a/design/modules-rose-graphite.html b/design/modules-rose-graphite.html new file mode 100644 index 0000000..f1c5000 --- /dev/null +++ b/design/modules-rose-graphite.html @@ -0,0 +1 @@ +Site Engine — Этап 6 · Rose Graphite
diff --git a/design/previews/antirion-overview-1440.png b/design/previews/antirion-overview-1440.png new file mode 100644 index 0000000..c627c0e Binary files /dev/null and b/design/previews/antirion-overview-1440.png differ diff --git a/design/previews/antirion-pages-1440.png b/design/previews/antirion-pages-1440.png new file mode 100644 index 0000000..b64c922 Binary files /dev/null and b/design/previews/antirion-pages-1440.png differ diff --git a/design/previews/antirion-rework-1440-pages-dark.png b/design/previews/antirion-rework-1440-pages-dark.png new file mode 100644 index 0000000..a108dc1 Binary files /dev/null and b/design/previews/antirion-rework-1440-pages-dark.png differ diff --git a/design/previews/antirion-rework-1440-pages-light.png b/design/previews/antirion-rework-1440-pages-light.png new file mode 100644 index 0000000..e4697ce Binary files /dev/null and b/design/previews/antirion-rework-1440-pages-light.png differ diff --git a/design/previews/builder-antirion-1440.png b/design/previews/builder-antirion-1440.png new file mode 100644 index 0000000..31b2432 Binary files /dev/null and b/design/previews/builder-antirion-1440.png differ diff --git a/design/previews/builder-rose-graphite-1440.png b/design/previews/builder-rose-graphite-1440.png new file mode 100644 index 0000000..04e7ffe Binary files /dev/null and b/design/previews/builder-rose-graphite-1440.png differ diff --git a/design/previews/ember-graphite-1440-pages-dark.png b/design/previews/ember-graphite-1440-pages-dark.png new file mode 100644 index 0000000..cd4ec55 Binary files /dev/null and b/design/previews/ember-graphite-1440-pages-dark.png differ diff --git a/design/previews/ember-graphite-1440-pages-light.png b/design/previews/ember-graphite-1440-pages-light.png new file mode 100644 index 0000000..7ba6311 Binary files /dev/null and b/design/previews/ember-graphite-1440-pages-light.png differ diff --git a/design/previews/rose-pages-1440.png b/design/previews/rose-pages-1440.png new file mode 100644 index 0000000..688b80c Binary files /dev/null and b/design/previews/rose-pages-1440.png differ diff --git a/design/previews/stage23-antirion-1440.png b/design/previews/stage23-antirion-1440.png new file mode 100644 index 0000000..0adfb87 Binary files /dev/null and b/design/previews/stage23-antirion-1440.png differ diff --git a/design/previews/stage23-antirion-picker.png b/design/previews/stage23-antirion-picker.png new file mode 100644 index 0000000..adcf3d6 Binary files /dev/null and b/design/previews/stage23-antirion-picker.png differ diff --git a/design/previews/stage23-rose-graphite-1440.png b/design/previews/stage23-rose-graphite-1440.png new file mode 100644 index 0000000..1e26c28 Binary files /dev/null and b/design/previews/stage23-rose-graphite-1440.png differ diff --git a/design/previews/stage23-rose-graphite-picker.png b/design/previews/stage23-rose-graphite-picker.png new file mode 100644 index 0000000..e077cae Binary files /dev/null and b/design/previews/stage23-rose-graphite-picker.png differ diff --git a/design/previews/stage24-antirion-compare.png b/design/previews/stage24-antirion-compare.png new file mode 100644 index 0000000..0d9800f Binary files /dev/null and b/design/previews/stage24-antirion-compare.png differ diff --git a/design/previews/stage24-antirion-page-1440.png b/design/previews/stage24-antirion-page-1440.png new file mode 100644 index 0000000..fe867bd Binary files /dev/null and b/design/previews/stage24-antirion-page-1440.png differ diff --git a/design/previews/stage24-antirion-seo-markdown.png b/design/previews/stage24-antirion-seo-markdown.png new file mode 100644 index 0000000..9d19f0a Binary files /dev/null and b/design/previews/stage24-antirion-seo-markdown.png differ diff --git a/design/previews/stage24-antirion-validation.png b/design/previews/stage24-antirion-validation.png new file mode 100644 index 0000000..9d3aa42 Binary files /dev/null and b/design/previews/stage24-antirion-validation.png differ diff --git a/design/previews/stage24-rose-compare.png b/design/previews/stage24-rose-compare.png new file mode 100644 index 0000000..b61e860 Binary files /dev/null and b/design/previews/stage24-rose-compare.png differ diff --git a/design/previews/stage24-rose-page-1440.png b/design/previews/stage24-rose-page-1440.png new file mode 100644 index 0000000..eba7fb1 Binary files /dev/null and b/design/previews/stage24-rose-page-1440.png differ diff --git a/design/previews/stage24-rose-seo-markdown.png b/design/previews/stage24-rose-seo-markdown.png new file mode 100644 index 0000000..69f65a1 Binary files /dev/null and b/design/previews/stage24-rose-seo-markdown.png differ diff --git a/design/previews/stage24-rose-validation.png b/design/previews/stage24-rose-validation.png new file mode 100644 index 0000000..310ba23 Binary files /dev/null and b/design/previews/stage24-rose-validation.png differ diff --git a/design/previews/stage3-antirion-expert-1440.png b/design/previews/stage3-antirion-expert-1440.png new file mode 100644 index 0000000..747971e Binary files /dev/null and b/design/previews/stage3-antirion-expert-1440.png differ diff --git a/design/previews/stage3-browser-smoke.txt b/design/previews/stage3-browser-smoke.txt new file mode 100644 index 0000000..f0e9e58 --- /dev/null +++ b/design/previews/stage3-browser-smoke.txt @@ -0,0 +1,6 @@ +START builder-antirion.html page Page Editor · Конструктор и Эксперт · Antirion Rework · Site Engine head 1 errors [] +EXPERT 1 issue ✓ Синтаксис и структура страницы корректны. Публикационные проверки остаются отдельными. errors [] +SOURCE ---·schema: "page/v1"·title: "Главная"·route: "/"·layout: "landing"·status: "published"·seo:· title: "Разработка Telegram-ботов и AI-систем"· description: "Автоматизация бизнес-процессов и создание AI-решений."·regions:· main:· - id: "hero_home"· fragment: "hero"· visible: length 1906 +START builder-rose-graphite.html page Page Editor · Конструктор и Эксперт · Rose Graphite · Site Engine head 1 errors [] +EXPERT 1 issue ✓ Синтаксис и структура страницы корректны. Публикационные проверки остаются отдельными. errors [] +SOURCE ---·schema: "page/v1"·title: "Главная"·route: "/"·layout: "landing"·status: "published"·seo:· title: "Разработка Telegram-ботов и AI-систем"· description: "Автоматизация бизнес-процессов и создание AI-решений."·regions:· main:· - id: "hero_home"· fragment: "hero"· visible: length 1906 diff --git a/design/previews/stage3-rose-expert-1440.png b/design/previews/stage3-rose-expert-1440.png new file mode 100644 index 0000000..23c8d79 Binary files /dev/null and b/design/previews/stage3-rose-expert-1440.png differ diff --git a/design/previews/stage3-rose-expert-390.png b/design/previews/stage3-rose-expert-390.png new file mode 100644 index 0000000..2f7388f Binary files /dev/null and b/design/previews/stage3-rose-expert-390.png differ diff --git a/design/previews/stage4-antirion-1440.png b/design/previews/stage4-antirion-1440.png new file mode 100644 index 0000000..ee51184 Binary files /dev/null and b/design/previews/stage4-antirion-1440.png differ diff --git a/design/previews/stage4-antirion-390.png b/design/previews/stage4-antirion-390.png new file mode 100644 index 0000000..247971c Binary files /dev/null and b/design/previews/stage4-antirion-390.png differ diff --git a/design/previews/stage4-antirion-expert.png b/design/previews/stage4-antirion-expert.png new file mode 100644 index 0000000..f73a5db Binary files /dev/null and b/design/previews/stage4-antirion-expert.png differ diff --git a/design/previews/stage4-rose-1440.png b/design/previews/stage4-rose-1440.png new file mode 100644 index 0000000..8d7420e Binary files /dev/null and b/design/previews/stage4-rose-1440.png differ diff --git a/design/previews/stage4-rose-390.png b/design/previews/stage4-rose-390.png new file mode 100644 index 0000000..c1789fe Binary files /dev/null and b/design/previews/stage4-rose-390.png differ diff --git a/design/previews/stage4-rose-expert.png b/design/previews/stage4-rose-expert.png new file mode 100644 index 0000000..f6eda91 Binary files /dev/null and b/design/previews/stage4-rose-expert.png differ diff --git a/design/previews/stage5-antirion-390.png b/design/previews/stage5-antirion-390.png new file mode 100644 index 0000000..9086f73 Binary files /dev/null and b/design/previews/stage5-antirion-390.png differ diff --git a/design/previews/stage5-antirion-changes-1440.png b/design/previews/stage5-antirion-changes-1440.png new file mode 100644 index 0000000..bbb1db4 Binary files /dev/null and b/design/previews/stage5-antirion-changes-1440.png differ diff --git a/design/previews/stage5-antirion-checks-1440.png b/design/previews/stage5-antirion-checks-1440.png new file mode 100644 index 0000000..c227afa Binary files /dev/null and b/design/previews/stage5-antirion-checks-1440.png differ diff --git a/design/previews/stage5-antirion-history-1440.png b/design/previews/stage5-antirion-history-1440.png new file mode 100644 index 0000000..e7d7aed Binary files /dev/null and b/design/previews/stage5-antirion-history-1440.png differ diff --git a/design/previews/stage5-antirion-history-initial.png b/design/previews/stage5-antirion-history-initial.png new file mode 100644 index 0000000..17fbfbd Binary files /dev/null and b/design/previews/stage5-antirion-history-initial.png differ diff --git a/design/previews/stage5-rose-graphite-390.png b/design/previews/stage5-rose-graphite-390.png new file mode 100644 index 0000000..1849107 Binary files /dev/null and b/design/previews/stage5-rose-graphite-390.png differ diff --git a/design/previews/stage5-rose-graphite-changes-1440.png b/design/previews/stage5-rose-graphite-changes-1440.png new file mode 100644 index 0000000..92ce51c Binary files /dev/null and b/design/previews/stage5-rose-graphite-changes-1440.png differ diff --git a/design/previews/stage5-rose-graphite-checks-1440.png b/design/previews/stage5-rose-graphite-checks-1440.png new file mode 100644 index 0000000..cf2eb78 Binary files /dev/null and b/design/previews/stage5-rose-graphite-checks-1440.png differ diff --git a/design/previews/stage5-rose-graphite-history-1440.png b/design/previews/stage5-rose-graphite-history-1440.png new file mode 100644 index 0000000..8c70eda Binary files /dev/null and b/design/previews/stage5-rose-graphite-history-1440.png differ diff --git a/design/previews/stage5-rose-graphite-history-initial.png b/design/previews/stage5-rose-graphite-history-initial.png new file mode 100644 index 0000000..e896429 Binary files /dev/null and b/design/previews/stage5-rose-graphite-history-initial.png differ diff --git a/design/previews/stage6-antirion-forms-1440.png b/design/previews/stage6-antirion-forms-1440.png new file mode 100644 index 0000000..4384e21 Binary files /dev/null and b/design/previews/stage6-antirion-forms-1440.png differ diff --git a/design/previews/stage6-antirion-forms-390.png b/design/previews/stage6-antirion-forms-390.png new file mode 100644 index 0000000..493ea77 Binary files /dev/null and b/design/previews/stage6-antirion-forms-390.png differ diff --git a/design/previews/stage6-antirion-journal-1440.png b/design/previews/stage6-antirion-journal-1440.png new file mode 100644 index 0000000..f1cebc4 Binary files /dev/null and b/design/previews/stage6-antirion-journal-1440.png differ diff --git a/design/previews/stage6-antirion-journal-390.png b/design/previews/stage6-antirion-journal-390.png new file mode 100644 index 0000000..4016079 Binary files /dev/null and b/design/previews/stage6-antirion-journal-390.png differ diff --git a/design/previews/stage6-antirion-media-1440.png b/design/previews/stage6-antirion-media-1440.png new file mode 100644 index 0000000..0ba18fe Binary files /dev/null and b/design/previews/stage6-antirion-media-1440.png differ diff --git a/design/previews/stage6-antirion-media-390.png b/design/previews/stage6-antirion-media-390.png new file mode 100644 index 0000000..6f6b2ba Binary files /dev/null and b/design/previews/stage6-antirion-media-390.png differ diff --git a/design/previews/stage6-antirion-settings-1440.png b/design/previews/stage6-antirion-settings-1440.png new file mode 100644 index 0000000..ed09a88 Binary files /dev/null and b/design/previews/stage6-antirion-settings-1440.png differ diff --git a/design/previews/stage6-antirion-settings-390.png b/design/previews/stage6-antirion-settings-390.png new file mode 100644 index 0000000..c61526d Binary files /dev/null and b/design/previews/stage6-antirion-settings-390.png differ diff --git a/design/previews/stage6-antirion-structure-1440.png b/design/previews/stage6-antirion-structure-1440.png new file mode 100644 index 0000000..481c012 Binary files /dev/null and b/design/previews/stage6-antirion-structure-1440.png differ diff --git a/design/previews/stage6-antirion-structure-390.png b/design/previews/stage6-antirion-structure-390.png new file mode 100644 index 0000000..c659bd6 Binary files /dev/null and b/design/previews/stage6-antirion-structure-390.png differ diff --git a/design/previews/stage6-rose-graphite-forms-1440.png b/design/previews/stage6-rose-graphite-forms-1440.png new file mode 100644 index 0000000..ba53082 Binary files /dev/null and b/design/previews/stage6-rose-graphite-forms-1440.png differ diff --git a/design/previews/stage6-rose-graphite-forms-390.png b/design/previews/stage6-rose-graphite-forms-390.png new file mode 100644 index 0000000..929934a Binary files /dev/null and b/design/previews/stage6-rose-graphite-forms-390.png differ diff --git a/design/previews/stage6-rose-graphite-journal-1440.png b/design/previews/stage6-rose-graphite-journal-1440.png new file mode 100644 index 0000000..fb7971f Binary files /dev/null and b/design/previews/stage6-rose-graphite-journal-1440.png differ diff --git a/design/previews/stage6-rose-graphite-journal-390.png b/design/previews/stage6-rose-graphite-journal-390.png new file mode 100644 index 0000000..b44c289 Binary files /dev/null and b/design/previews/stage6-rose-graphite-journal-390.png differ diff --git a/design/previews/stage6-rose-graphite-media-1440.png b/design/previews/stage6-rose-graphite-media-1440.png new file mode 100644 index 0000000..8e43c54 Binary files /dev/null and b/design/previews/stage6-rose-graphite-media-1440.png differ diff --git a/design/previews/stage6-rose-graphite-media-390.png b/design/previews/stage6-rose-graphite-media-390.png new file mode 100644 index 0000000..1ed2011 Binary files /dev/null and b/design/previews/stage6-rose-graphite-media-390.png differ diff --git a/design/previews/stage6-rose-graphite-settings-1440.png b/design/previews/stage6-rose-graphite-settings-1440.png new file mode 100644 index 0000000..5f2ed71 Binary files /dev/null and b/design/previews/stage6-rose-graphite-settings-1440.png differ diff --git a/design/previews/stage6-rose-graphite-settings-390.png b/design/previews/stage6-rose-graphite-settings-390.png new file mode 100644 index 0000000..d435d94 Binary files /dev/null and b/design/previews/stage6-rose-graphite-settings-390.png differ diff --git a/design/previews/stage6-rose-graphite-structure-1440.png b/design/previews/stage6-rose-graphite-structure-1440.png new file mode 100644 index 0000000..8922df6 Binary files /dev/null and b/design/previews/stage6-rose-graphite-structure-1440.png differ diff --git a/design/previews/stage6-rose-graphite-structure-390.png b/design/previews/stage6-rose-graphite-structure-390.png new file mode 100644 index 0000000..b21fd0e Binary files /dev/null and b/design/previews/stage6-rose-graphite-structure-390.png differ diff --git a/design/previews/stage6-rose-media-1440.png b/design/previews/stage6-rose-media-1440.png new file mode 100644 index 0000000..aef10ed Binary files /dev/null and b/design/previews/stage6-rose-media-1440.png differ diff --git a/design/previews/yue-content-1440.png b/design/previews/yue-content-1440.png new file mode 100644 index 0000000..9daf056 Binary files /dev/null and b/design/previews/yue-content-1440.png differ diff --git a/design/previews/yue-mobile-menu-390.png b/design/previews/yue-mobile-menu-390.png new file mode 100644 index 0000000..a4e4b18 Binary files /dev/null and b/design/previews/yue-mobile-menu-390.png differ diff --git a/design/previews/yue-overview-1440.png b/design/previews/yue-overview-1440.png new file mode 100644 index 0000000..91fec64 Binary files /dev/null and b/design/previews/yue-overview-1440.png differ diff --git a/design/previews/yue-pages-1024.png b/design/previews/yue-pages-1024.png new file mode 100644 index 0000000..e6c8640 Binary files /dev/null and b/design/previews/yue-pages-1024.png differ diff --git a/design/previews/yue-pages-1280.png b/design/previews/yue-pages-1280.png new file mode 100644 index 0000000..96f1bbc Binary files /dev/null and b/design/previews/yue-pages-1280.png differ diff --git a/design/previews/yue-pages-1440.png b/design/previews/yue-pages-1440.png new file mode 100644 index 0000000..688b80c Binary files /dev/null and b/design/previews/yue-pages-1440.png differ diff --git a/design/previews/yue-pages-360.png b/design/previews/yue-pages-360.png new file mode 100644 index 0000000..8c736b9 Binary files /dev/null and b/design/previews/yue-pages-360.png differ diff --git a/design/previews/yue-pages-390.png b/design/previews/yue-pages-390.png new file mode 100644 index 0000000..0a2d775 Binary files /dev/null and b/design/previews/yue-pages-390.png differ diff --git a/design/previews/yue-pages-768.png b/design/previews/yue-pages-768.png new file mode 100644 index 0000000..f476d0f Binary files /dev/null and b/design/previews/yue-pages-768.png differ diff --git a/design/previews/yue-pages-light-1440.png b/design/previews/yue-pages-light-1440.png new file mode 100644 index 0000000..5b63214 Binary files /dev/null and b/design/previews/yue-pages-light-1440.png differ diff --git a/design/previews/yue-publish-1440.png b/design/previews/yue-publish-1440.png new file mode 100644 index 0000000..6e15c85 Binary files /dev/null and b/design/previews/yue-publish-1440.png differ diff --git a/design/publication-antirion.html b/design/publication-antirion.html new file mode 100644 index 0000000..fe1d58b --- /dev/null +++ b/design/publication-antirion.html @@ -0,0 +1 @@ +Site Engine — Публикация · 04 Antirion Rework
diff --git a/design/publication-rose-graphite.html b/design/publication-rose-graphite.html new file mode 100644 index 0000000..f02ef1b --- /dev/null +++ b/design/publication-rose-graphite.html @@ -0,0 +1 @@ +Site Engine — Публикация · 06 Rose Graphite
diff --git a/design/references/en-06-lora.png b/design/references/en-06-lora.png new file mode 100644 index 0000000..273865d Binary files /dev/null and b/design/references/en-06-lora.png differ diff --git a/design/rose-graphite.html b/design/rose-graphite.html new file mode 100644 index 0000000..011792d --- /dev/null +++ b/design/rose-graphite.html @@ -0,0 +1 @@ +Site Engine — 06 Rose Graphite
\ No newline at end of file diff --git a/docker-build.sh b/docker-build.sh new file mode 100644 index 0000000..a2bb7c1 --- /dev/null +++ b/docker-build.sh @@ -0,0 +1,2 @@ + +docker build -t flexly-cms . \ No newline at end of file diff --git a/docker-run.sh b/docker-run.sh new file mode 100644 index 0000000..3804e2b --- /dev/null +++ b/docker-run.sh @@ -0,0 +1,14 @@ + +docker rm --force flexly-cms + +docker run -d --name flexly-cms \ + -p 8181:8000 \ + --env-file .env \ + --user 1001:1001 \ + -v "$PWD/examples/ai-studio:/app/examples/studio-site" \ + -v "$PWD/dist:/data/dist" \ + -v "$PWD/data:/data" \ + flexly-cms + +#docker exec -it flexly-cms site-engine hash-password +#docker exec -it flexly-cms site-engine gen-secret diff --git a/docs/TZ-site-engine-decisions.md b/docs/TZ-site-engine-decisions.md index c14a688..58c208a 100644 --- a/docs/TZ-site-engine-decisions.md +++ b/docs/TZ-site-engine-decisions.md @@ -2,6 +2,8 @@ *Версия 0.1 · 6 ноября 2026 · основание: `TZ-site-engine-architecture-review.md` к ТЗ v0.1 · статус: проект решений, ждёт подтверждения (раздел 5)* +**Уточнение от 12 ноября 2026.** По решению владельца проекта отдельный `steps` («Этапы») возвращён из `design/`, одновременно с `columns`. Он поставляется локально в `examples/ai-studio/fragments/steps/`: схема, шаблон и стили доступны установленному движку вместе с файлами сайта, без пересборки Docker. Встроенный набор содержит 15 фрагментов; схема сайта и версия фрагментов остаются 1. `card_grid.variant: steps` сохранён для совместимости. Историческое «columns вместо steps» ниже описывает первоначальное сокращение MVP; в отношении steps действует это уточнение. + ## 1. Итог Концепцию сохраняем: файловый источник контента, Layout / Fragment / Block, единый сервисный слой, статический результат, FastAPI + Jinja + htmx. Принимаем все восемь замечаний P0 и 15 замечаний P1, упрощение MVP, новый порядок этапов и список обязательных тестов. По итогам этого документа ТЗ переиздаётся как v0.2 (раздел 4). @@ -128,11 +130,11 @@ items: # Query ### ADR-006. Границы MVP и этапы -**Ядро: 15 фрагментов.** `site_header`, `site_footer`, `hero`, `page_header`, `section`, `columns`, `richtext`, `image`, `card_grid`, `collection_list`, `entry_header`, `cta_banner`, `form`, `faq`, `disclaimer`. +**Ядро: 15 встроенных фрагментов.** `site_header`, `site_footer`, `hero`, `page_header`, `section`, `columns`, `richtext`, `image`, `card_grid`, `collection_list`, `entry_header`, `cta_banner`, `form`, `faq`, `disclaimer`. По уточнению от 12 ноября 2026 отдельный `steps` доступен как локальный компонент ai-studio. Остальное — варианты и свойства этих фрагментов, а не отдельные фрагменты: -- `card_grid` покрывает преимущества (`features`), этапы (`steps`) и ссылки (`links`); +- `card_grid` покрывает преимущества (`features`) и ссылки (`links`); прежний вариант `steps` поддерживается для совместимости. Для новых последовательностей этапов используется отдельный `steps`: `title` и список `items` (`title`, необязательный Markdown `text`), с оформлением из дизайна; - `cta_banner` покрывает контакт, внешнюю ссылку и переход к форме; контакты берутся из `site.contacts`; - `site_header` и `site_footer` сами выводят меню; реквизиты берутся из `data/company.yaml`; - `page_header` выводит хлебные крошки; `legal_text` — layout `legal` с `richtext`; diff --git a/pyproject.toml b/pyproject.toml index e4e1080..116e1bd 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -24,10 +24,11 @@ server = [ # M2+: админка, формы, превью "sqlalchemy>=2.0", "alembic>=1.13", "python-multipart>=0.0.9", + "httpx>=0.27", # серверный клиент HTML UI → JSON API ] mcp = ["mcp>=1.2"] # M3 images = ["Pillow>=10"] # M4: варианты изображений -dev = ["pytest>=8", "ruff>=0.6", "httpx>=0.27"] +dev = ["pytest>=8", "ruff>=0.6", "httpx>=0.27", "playwright>=1.49"] [project.scripts] site-engine = "site_engine.cli:main" diff --git a/scripts/css_scope.py b/scripts/css_scope.py new file mode 100644 index 0000000..ae5239b --- /dev/null +++ b/scripts/css_scope.py @@ -0,0 +1,62 @@ +"""Prefix the designer's flat CSS rules without requiring browser @scope support.""" + +import re + +TOKENS = re.compile(r'''/\*[\s\S]*?\*/|"(?:\\.|[^"\\])*"|'(?:\\.|[^'\\])*'|[{}]''') + + +def selectors(value): + """Split a selector list while preserving commas inside :is(), :has(), etc.""" + start = depth = 0 + for i, char in enumerate(value): + if char in "([": + depth += 1 + elif char in ")]": + depth -= 1 + elif char == "," and depth == 0: + yield value[start:i] + start = i + 1 + yield value[start:] + + +def scope_css(source, scope, root=None): + """Keep declarations/media queries; isolate selectors with zero-weight :where. + + The source contains ordinary style rules and @media only. Fail on other + at-rules so a designer addition cannot silently produce invalid CSS. + `root` replaces :scope with the same specificity as that pseudo-class. + """ + result, start, opening, depth = [], 0, None, 0 + for token in TOKENS.finditer(source): + if token[0] == "{": + if depth == 0: + opening = token.start() + depth += 1 + elif token[0] == "}": + depth -= 1 + if depth < 0: + raise ValueError("Unbalanced CSS braces") + if depth: + continue + header = source[start:opening] + # Comments/whitespace remain verbatim outside the selector. + prefix = re.match(r"(?:\s|/\*[\s\S]*?\*/)*", header)[0] + header = header[len(prefix):] + body = source[opening + 1:token.start()] + if header.startswith("@media"): + body = scope_css(body, scope, root) + elif header.startswith("@"): + raise ValueError(f"Unsupported CSS rule: {header}") + else: + header = ",".join( + selector.replace(":scope", root or scope) + if ":scope" in selector + else f":where({scope}) {selector.strip()}" + for selector in selectors(header) + ) + result.append(prefix + header + "{" + body + "}") + start = token.end() + if depth: + raise ValueError("Unbalanced CSS braces") + result.append(source[start:]) + return "".join(result) diff --git a/scripts/qa_001.py b/scripts/qa_001.py new file mode 100644 index 0000000..b1507b2 --- /dev/null +++ b/scripts/qa_001.py @@ -0,0 +1,180 @@ +"""Real browser QA on an isolated example; writes screenshots and a JSON report to /tmp.""" + +from __future__ import annotations + +import argparse +import contextlib +import json +import os +import shutil +import socket +import tempfile +import threading +import time +from pathlib import Path +from unittest.mock import patch + +import uvicorn +from playwright.sync_api import sync_playwright + +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app + +ROOT = Path(__file__).resolve().parents[1] +PASSWORD = "temporary browser password" + + +@contextlib.contextmanager +def serve(app, sock=None): + if sock is None: + sock = socket.socket() + sock.bind(("127.0.0.1", 0)) + port = sock.getsockname()[1] + server = uvicorn.Server(uvicorn.Config(app, log_level="error", access_log=False)) + thread = threading.Thread(target=server.run, kwargs={"sockets": [sock]}, daemon=True) + thread.start() + for _ in range(1000): + if server.started: + break + if not thread.is_alive(): + raise RuntimeError("QA server did not start") + time.sleep(0.01) + try: + yield f"http://127.0.0.1:{port}" + finally: + server.should_exit = True + thread.join(timeout=10) + sock.close() + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument("--out", type=Path, default=Path("/tmp/site-engine-001-qa")) + args = parser.parse_args() + args.out.mkdir(parents=True, exist_ok=True) + results = {"widths": [], "screens": [], "console_errors": []} + with tempfile.TemporaryDirectory(prefix="cms-browser-") as temp: + work = Path(temp) + site = work / "site" + shutil.copytree( + ROOT / "examples/studio-site", site, ignore=shutil.ignore_patterns(".engine") + ) + env = { + "SITE_ROOT": str(site), + "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(work / "state"), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "temporary-browser-qa-secret-" * 2, + "SITE_COOKIE_SECURE": "0", + } + with patch.dict(os.environ, env), serve(create_app()) as origin, sync_playwright() as pw: + browser = pw.chromium.launch(headless=True, args=["--no-sandbox"]) + page = browser.new_page(viewport={"width": 1440, "height": 960}) + page.on("pageerror", lambda exc: results["console_errors"].append(str(exc))) + page.goto(origin + "/admin/login") + page.screenshot(path=str(args.out / "login.png")) + page.locator('[name="login"]').fill("admin") + page.locator('[name="password"]').fill(PASSWORD) + page.get_by_role("button", name="Войти", exact=True).click() + page.wait_for_url(origin + "/admin/") + for path, name in [ + ("/admin/", "overview"), + ("/admin/pages", "pages"), + ("/admin/pages/index", "page"), + ("/admin/pages/index/blocks/b_hero", "block"), + ("/admin/content", "collections"), + ("/admin/content/services", "entries"), + ("/admin/content/services/bots", "entry"), + ("/admin/publish", "publish"), + ]: + response = page.goto(origin + path) + assert response.status == 200, path + page.screenshot(path=str(args.out / (name + ".png")), full_page=True) + results["screens"].append(name) + for width in [1440, 1280, 1024, 768, 390, 360]: + page.set_viewport_size({"width": width, "height": 960}) + overflow = page.evaluate( + "document.documentElement.scrollWidth > innerWidth + 1" + ) + assert not overflow, (name, width, "horizontal overflow") + results["widths"].append([name, width]) + page.set_viewport_size({"width": 1440, "height": 960}) + page.goto(origin + "/admin/pages?q=no-such-page") + assert page.get_by_text("Страниц по этим фильтрам нет").is_visible() + page.set_viewport_size({"width": 390, "height": 844}) + page.get_by_role("button", name="Открыть меню").click() + assert page.locator(".sidebar.open").count() == 1 + page.keyboard.press("Shift+Tab") + assert page.locator(".sidebar").evaluate("(e)=>e.contains(document.activeElement)") + page.keyboard.press("Tab") + expect_focus = page.locator(".sidebar a").first + assert expect_focus.evaluate("(e)=>e===document.activeElement") + page.keyboard.press("Escape") + assert page.locator(".sidebar.open").count() == 0 + assert page.get_by_role("button", name="Открыть меню").evaluate( + "(e)=>e===document.activeElement" + ) + page.screenshot(path=str(args.out / "mobile.png")) + page.goto(origin + "/admin/pages/index") + page.locator("#preview-result iframe").wait_for() + page.frame_locator("#preview-result iframe").get_by_role("heading").first.wait_for() + assert ( + page.frame_locator("#preview-result iframe") + .locator(".f-hero") + .evaluate("(e)=>getComputedStyle(e).backgroundColor") + != "rgba(0, 0, 0, 0)" + ) + page.locator(".topbar [data-action=theme]").click() + assert page.locator("body").get_attribute("data-skin") == "dark" + for mode in ["constructor", "expert"]: + page.get_by_role( + "button", name="Эксперт" if mode == "expert" else "Конструктор", exact=True + ).click() + for width in [1440, 1280, 1024, 768, 390, 360]: + page.set_viewport_size({"width": width, "height": 960}) + assert not page.evaluate("document.documentElement.scrollWidth>innerWidth+1"), ( + mode, + width, + ) + results["widths"].append([mode + "-dark", width]) + page.screenshot(path=str(args.out / "expert-dark-mobile.png")) + page.goto(origin + "/admin/publish") + invoker = page.get_by_role( + "button", name="Опубликовать текущий черновик сайта", exact=True + ) + invoker.click() + page.locator("#confirm-dialog").wait_for(state="visible") + for _ in range(4): + page.keyboard.press("Tab") + assert page.locator("#confirm-dialog").evaluate( + "(e)=>e.contains(document.activeElement)" + ) + page.keyboard.press("Escape") + assert not page.locator("#confirm-dialog").is_visible() + assert invoker.evaluate("(e)=>e===document.activeElement") + assert not results["console_errors"], results["console_errors"] + browser.close() + # Reference is rendered from its own assets, independent of the runtime package. + with sync_playwright() as pw: + browser = pw.chromium.launch(headless=True, args=["--no-sandbox"]) + page = browser.new_page(viewport={"width": 1440, "height": 960}) + page.goto((ROOT / "design/antirion-rework.html").as_uri()) + page.screenshot(path=str(args.out / "reference-antirion.png"), full_page=True) + page.set_viewport_size({"width": 390, "height": 844}) + page.screenshot(path=str(args.out / "reference-mobile.png"), full_page=True) + browser.close() + (args.out / "report.json").write_text(json.dumps(results, ensure_ascii=False, indent=2)) + print( + json.dumps( + { + "screens": len(results["screens"]), + "width_checks": len(results["widths"]), + "artifacts": str(args.out), + } + ) + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_ai_studio.py b/scripts/qa_ai_studio.py new file mode 100644 index 0000000..e1c4781 --- /dev/null +++ b/scripts/qa_ai_studio.py @@ -0,0 +1,409 @@ +"""Exercise the schema-1 example, public build and real admin on an isolated copy.""" + +from __future__ import annotations + +import argparse +import datetime as dt +import hashlib +import json +import os +import re +import shutil +import tempfile +from html.parser import HTMLParser +from pathlib import Path +from unittest.mock import patch +from urllib.parse import urljoin, urlsplit + +from playwright.sync_api import expect, sync_playwright +from qa_001 import PASSWORD, ROOT, serve + +from site_engine.build.pipeline import build_site +from site_engine.core.registry import load_site +from site_engine.core.routes import build_route_table +from site_engine.core.validate import validate_release, validate_workspace +from site_engine.errors import EngineError, Report +from site_engine.parsing.frontmatter import parse +from site_engine.parsing.yamlio import load_yaml +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app + +EXAMPLE = ROOT / "examples/ai-studio" +NOW = dt.datetime(2026, 11, 12, 12, tzinfo=dt.UTC) + + +class LocalURLs(HTMLParser): + def __init__(self): + super().__init__() + self.urls = set() + + def handle_starttag(self, tag, attrs): + values = dict(attrs) + if tag == "link" and values.get("rel") not in ("stylesheet", "icon"): + return + if tag not in ("a", "img", "link", "script"): + return + value = values.get("href") or values.get("src") or "" + if value and not value.startswith("#") and not urlsplit(value).scheme: + self.urls.add(value) + + +def files(root): + return { + p.relative_to(root).as_posix(): hashlib.sha256(p.read_bytes()).hexdigest() + for p in root.rglob("*") + if p.is_file() and ".engine" not in p.relative_to(root).parts + } + + +def main(): + parser = argparse.ArgumentParser() + parser.add_argument("--out", type=Path, default=Path("/tmp/ai-studio-qa")) + args = parser.parse_args() + args.out.mkdir(parents=True, exist_ok=True) + baseline = files(EXAMPLE) + report = {"schema": 1, "checks": [], "browser_errors": [], "native_dialogs": []} + checks = report["checks"] + with tempfile.TemporaryDirectory(prefix="ai-studio-qa-") as tmp: + work = Path(tmp) + site, dist = work / "site", work / "dist" + shutil.copytree(EXAMPLE, site, ignore=shutil.ignore_patterns(".engine")) + reg = load_site(site) + issues = Report() + table = build_route_table(reg, issues) + issues.extend(validate_workspace(reg, table)) + issues.extend(validate_release(reg, table)) + assert not issues.issues, [str(i) for i in issues.issues] + assert load_yaml((site / "site.yaml").read_text())["schema"] == 1 + for page_file in (site / "pages").rglob("*.md"): + assert parse(page_file.read_text())[0]["schema"] == 1 + local_fragments = [f for f in reg.fragments.values() if not f.builtin] + assert all(f.version == 1 for f in local_fragments) + assert {f.id for f in local_fragments} == { + "entry_cover", + "benefits", + "related", + "steps", + } + assert not any(fid.startswith("ai_") for fid in reg.fragments) + assert all( + reg.fragments[fid].builtin + for fid in ( + "hero", + "page_header", + "richtext", + "card_grid", + "faq", + "cta_banner", + "section", + "columns", + "collection_list", + ) + ) + assert set(reg.collections) == {"services", "scenarios", "cases"} + home_blocks = {b.id: b for b in reg.pages["index"].regions["main"]} + assert home_blocks["hero_home"].fragment == "hero" + assert home_blocks["services_list"].fragment == "collection_list" + assert home_blocks["benefits_grid"].fragment == "card_grid" + assert home_blocks["benefits_grid"].props["variant"] == "features" + assert home_blocks["process_steps"].fragment == "steps" + assert "variant" not in home_blocks["process_steps"].props + assert home_blocks["cta_home"].fragment == "cta_banner" + checks.append("schema_1_and_clean_workspace_release_validation") + checks.append("universal_fragment_ids_and_shared_builtins_without_duplicates") + checks.append("design_block_ids_and_fragment_types_kept_separate") + build = build_site(site, dist, now=NOW) + assert not build.report.issues, [str(i) for i in build.report.issues] + assert build.pages == 14, build.pages + repeated = build_site(site, work / "second-dist", now=NOW) + assert repeated.build_id == build.build_id + assert files(repeated.output_dir) == files(build.output_dir) + checks.append("14_pages_and_deterministic_build_without_database") + public = dist / "current" + home = (public / "index.html").read_text() + assert "Telegram-боты" in home and "AI-ассистенты" in home + assert "Почему нам доверяют" in home and "Под задачу, а не по шаблону" in home + for hidden in ("Исследовательские прототипы", "Академия", "Автоматизация процессов"): + assert hidden not in home, hidden + assert not (public / "services/research").exists() + assert not (public / "drafts").exists() + sitemap = (public / "sitemap.xml").read_text() + assert "research" not in sitemap and "academy" not in sitemap + assert "Автоматизация процессов" in (public / "services/index.html").read_text() + checks.append("featured_queries_and_draft_exclusion") + service_html = (public / "services/bots/index.html").read_text() + for text in ( + "/assets/bot.svg", + "Интеграция с CRM и расписанием", + "/scenarios/support/", + "/cases/support-assistant/", + "/contacts/", + "Обсудим похожую задачу?", + ): + assert text in service_html, text + assert "Поддержка клиентов" in (public / "scenarios/support/index.html").read_text() + case_html = (public / "cases/support-assistant/index.html").read_text() + assert "Демонстрационный кейс" in case_html and "Учебная служба поддержки" in case_html + assert "Корректность источников" in case_html + assert "data-preview-id" not in service_html + assert "e.naturalWidth>0"), route + page.evaluate("window.scrollTo(0,0)") + links = LocalURLs() + links.feed(page.content()) + linked_urls.update(urljoin(origin + route, url) for url in links.urls) + for width in (1440, 1024, 768, 390, 360): + page.set_viewport_size({"width": width, "height": 960}) + assert page.evaluate("document.documentElement.scrollWidth<=innerWidth+1"), ( + route, + width, + ) + responsive.append([route, width]) + if route in ( + "/", + "/about/", + "/services/bots/", + "/cases/support-assistant/", + ) and width in ( + 1440, + 390, + ): + name = route.strip("/").replace("/", "-") or "home" + page.screenshot(path=str(args.out / f"{name}-{width}.png"), full_page=True) + for url in sorted(linked_urls): + if urlsplit(url).netloc == urlsplit(origin).netloc: + assert context.request.get(url).status == 200, url + report["responsive"] = responsive + report["local_urls_checked"] = len(linked_urls) + checks.append("public_pages_images_links_and_70_responsive_checks") + page.set_viewport_size({"width": 1440, "height": 960}) + page.goto(origin + "/admin/login") + page.locator("[name=login]").fill("admin") + page.locator("[name=password]").fill(PASSWORD) + page.get_by_role("button", name="Войти", exact=True).click() + page.wait_for_url(origin + "/admin/") + for collection in ("services", "scenarios", "cases"): + assert page.goto(origin + "/admin/content/" + collection).status == 200 + page.goto(origin + "/admin/pages/about") + about_source = page.locator("#document-source").input_value() + frame = page.frame_locator("#preview-result iframe") + page.locator("[data-tree-id=about_columns]").click() + expect(page.locator("#inspectpane")).to_contain_text("Количество колонок") + expect(frame.locator("[data-preview-id=about_columns]")).to_have_attribute( + "data-preview-selected", "true" + ) + page.locator("[data-tree-id=body_about]").click() + expect(frame.locator("[data-preview-id=body_about]")).to_have_attribute( + "data-preview-selected", "true" + ) + frame.locator("[data-preview-id=about_image] img").click() + expect(page.locator("[data-tree-id=about_image]")).to_have_class(re.compile("selected")) + expect(frame.locator("[data-preview-id=about_image]")).to_have_attribute( + "data-preview-selected", "true" + ) + expect(page.locator("#inspectpane")).to_contain_text("Описание изображения") + page.locator("[data-editor-mode=expert]").click() + page.locator("[data-editor-mode=constructor]").click() + assert page.locator("#document-source").input_value() == about_source + checks.append("nested_columns_bidirectional_selection_and_mode_roundtrip") + page.goto(origin + "/admin/pages/index") + page.locator("[data-catalog-open]").first.click() + dialog = page.locator("#builder-catalog-dialog") + for fid, name, description in ( + ("collection_list", "Список коллекций", "Карточки, получаемые из collection"), + ("section", "Текстовая секция", "Заголовок и содержимое секции"), + ("richtext", "Markdown body", "Выводит Markdown из файла страницы"), + ("card_grid", "Карточки", "Сетка преимуществ"), + ("steps", "Этапы", "Три этапа реализации"), + ): + item = dialog.locator(f"[data-fragment='{fid}']") + expect(item).to_be_visible() + expect(item.locator("b")).to_have_text(name) + expect(item.locator("small")).to_have_text(description) + expect(dialog.locator("[data-fragment=catalog]")).to_have_count(0) + page.screenshot(path=str(args.out / "fragment-catalog.png")) + dialog.locator("[data-catalog-search]").fill("получаемые") + expect(dialog.locator("[data-fragment=collection_list]")).to_be_visible() + expect(dialog.locator("[data-fragment=section]")).to_be_hidden() + dialog.locator("[data-catalog-search]").fill("card_grid") + expect(dialog.locator("[data-fragment=card_grid]")).to_be_visible() + expect(dialog.locator("[data-fragment=collection_list]")).to_be_hidden() + dialog.locator("[data-catalog-search]").fill("") + dialog.get_by_role("button", name="Данные", exact=True).click() + expect(dialog.locator("[data-fragment=collection_list]")).to_be_visible() + expect(dialog.locator("[data-fragment=card_grid]")).to_be_hidden() + dialog.get_by_role("button", name="Все", exact=True).click() + dialog.get_by_role("button", name="Отмена", exact=True).click() + checks.append("design_catalog_names_descriptions_search_and_categories") + frame = page.frame_locator("#preview-result iframe") + expect(frame.locator("[data-preview-id=hero_home]")).to_have_attribute( + "data-preview-selected", "true" + ) + page.locator("[data-tree-id=services_list]").click() + expect(frame.locator("[data-preview-id=services_list]")).to_have_attribute( + "data-preview-selected", "true" + ) + expect(page.locator("#inspectpane")).to_contain_text("Какие записи показать") + page.locator("[data-tree-id=benefits_grid]").click() + expect(frame.locator("[data-preview-id=benefits_grid]")).to_have_attribute( + "data-preview-selected", "true" + ) + expect(page.locator("#inspectpane")).to_contain_text("Вариант оформления") + page.locator("[data-tree-id=process_steps]").click() + expect(frame.locator("[data-preview-id=process_steps] .f-steps__item")).to_have_count(3) + expect(page.locator("#inspectpane")).to_contain_text("Название этапа") + expect(page.locator('[data-inspector] [name="p.variant"]')).to_have_count(0) + page.locator('[data-inspector] [name="p.items.0.title"]').fill("QA первый этап") + expect(frame.locator("[data-preview-id=process_steps] h3").first).to_have_text( + "QA первый этап" + ) + page.locator('[data-inspector] [name="p.items.0.title"]').fill("Разбираемся в задаче") + expect(frame.locator("[data-preview-id=process_steps] h3").first).to_have_text( + "Разбираемся в задаче" + ) + checks.append("dedicated_steps_inspector_and_list_edit_reach_preview") + page.locator("[data-tree-id=hero_home]").click() + source = page.locator("#document-source").input_value() + page.locator("[data-editor-mode=expert]").click() + page.locator("[data-editor-mode=constructor]").click() + assert page.locator("#document-source").input_value() == source + page.screenshot(path=str(args.out / "admin-constructor.png")) + checks.append("three_collections_and_localized_constructor_preview_mode_roundtrip") + page_source = (site / "pages/index.md").read_bytes() + page.locator('[data-inspector] [name="p.image_alt"]').fill("QA описание обложки") + expect(page.locator("#document-source")).to_have_value( + re.compile("QA описание обложки") + ) + assert (site / "pages/index.md").read_bytes() == page_source + page.locator("[data-save-document]").click() + expect(page.locator("#editor-result")).to_have_attribute("data-saved", "1") + page_meta, _ = parse((site / "pages/index.md").read_text()) + assert page_meta["schema"] == 1 + assert page_meta["regions"]["main"][0]["props"]["title"] == {"bind": "page.title"} + assert (public / "index.html").read_text() == home + checks.append("page_edit_explicit_save_schema_bindings_preserved_no_publish") + page.wait_for_load_state("networkidle") + page.goto(origin + "/admin/content/services/bots") + entry_original = (site / "content/services/bots.md").read_bytes() + expect(page.locator("[data-inspector]")).to_contain_text("Краткое описание") + expect(page.locator("[data-inspector]")).to_contain_text("Призыв к действию") + page.locator('[data-inspector] [name="p.summary"]').fill("QA новое описание услуги") + page.locator('[data-inspector] [name="p.cta.title"]').fill("QA новый CTA") + page.locator('[data-inspector] [name="p.cta.actions.0.label"]').fill("QA связаться") + page.locator("[data-inspector]").get_by_role( + "button", name="Применить к буферу", exact=True + ).click() + expect(page.locator("#document-source")).to_have_value(re.compile("QA новый CTA")) + assert (site / "content/services/bots.md").read_bytes() == entry_original + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-result")).to_have_attribute("data-saved", "1") + meta, _ = parse((site / "content/services/bots.md").read_text()) + assert meta["summary"] == "QA новое описание услуги" + assert meta["cta"]["title"] == "QA новый CTA" + assert meta["cta"]["actions"][0] == {"page": "contacts", "label": "QA связаться"} + assert meta["related_scenarios"] == ["support"] + assert (public / "services/bots/index.html").read_text() == service_html + page.wait_for_load_state("networkidle") + checks.append("entry_group_list_link_refs_edit_explicit_save_no_publish") + updated = build_site(site, dist, now=NOW + dt.timedelta(minutes=2)) + assert not updated.report.issues + updated_html = (public / "services/bots/index.html").read_text() + assert "QA новое описание услуги" in updated_html and "QA новый CTA" in updated_html + assert "QA связаться" in updated_html + checks.append("saved_content_reaches_public_site_after_build") + csrf = page.locator('form[action="/admin/logout"] [name=csrf]').first.input_value() + response = context.request.post( + origin + "/admin/logout", form={"csrf": csrf}, headers={"Origin": origin} + ) + assert response.status == 200 and response.url.endswith("/admin/login") + page.goto(origin + "/admin/pages/index") + page.wait_for_url(origin + "/admin/login") + checks.append("login_preview_and_logout_complete_without_http_500") + assert not report["browser_errors"], report["browser_errors"] + assert not report["native_dialogs"], report["native_dialogs"] + browser.close() + assert files(EXAMPLE) == baseline, "QA modified the example" + checks.append("source_example_unchanged") + (args.out / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2) + "\n") + print( + json.dumps( + { + "checks": len(checks), + "pages": 14, + "responsive": len(report["responsive"]), + "out": str(args.out), + }, + ensure_ascii=False, + ) + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_builder_001.py b/scripts/qa_builder_001.py new file mode 100644 index 0000000..cc31887 --- /dev/null +++ b/scripts/qa_builder_001.py @@ -0,0 +1,379 @@ +"""Chromium against designer original + real FastAPI on disposable content.""" + +import json +import os +import shutil +import tempfile +from pathlib import Path +from unittest.mock import patch + +from playwright.sync_api import expect, sync_playwright +from qa_001 import PASSWORD, ROOT, serve +from qa_editor_001 import reserve + +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app +from site_engine.web.preview_app import create_preview_app + +OUT = Path(os.environ.get("QA_BUILDER_OUT", "/tmp/site-engine-builder-001")) + + +def idle(page): + page.wait_for_function("() => !window.siteDocument.state.busy") + page.wait_for_timeout(60) + + +def metrics(page, selectors): + return page.evaluate( + """selectors=>Object.fromEntries(selectors.map(s=>{ + const e=document.querySelector(s),c=getComputedStyle(e),r=e.getBoundingClientRect(); + return [s,{x:r.x,y:r.y,width:r.width,height:r.height,font:c.fontSize,padding:c.padding,color:c.color,background:c.backgroundColor}]; + }))""", + selectors, + ) + + +def main(): + OUT.mkdir(exist_ok=True) + report = {"comparisons": [], "flows": [], "errors": []} + with tempfile.TemporaryDirectory(prefix="cms-builder-") as tmp: + work = Path(tmp) + site = work / "site" + shutil.copytree( + ROOT / "examples/studio-site", site, ignore=shutil.ignore_patterns(".engine") + ) + a, p = reserve(), reserve() + admin = f"http://127.0.0.1:{a.getsockname()[1]}" + preview = f"http://127.0.0.1:{p.getsockname()[1]}" + env = { + "SITE_ROOT": str(site), + "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(work / "state"), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "builder-browser-qa-secret-" * 3, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": admin, + "SITE_PREVIEW_ORIGIN": preview, + } + with ( + patch.dict(os.environ, env), + serve(create_app(), a), + serve(create_preview_app(), p), + sync_playwright() as pw, + ): + browser_type = getattr(pw, os.environ.get("QA_BROWSER", "chromium")) + launch_options = {"headless": True} + if browser_type.name == "chromium": + launch_options["args"] = ["--no-sandbox", "--no-proxy-server"] + elif browser_type.name == "firefox": + launch_options["firefox_user_prefs"] = {"network.proxy.type": 0} + if os.environ.get("QA_BROWSER_EXECUTABLE"): + launch_options["executable_path"] = os.environ["QA_BROWSER_EXECUTABLE"] + browser = browser_type.launch(**launch_options) + report["browser"] = {"name": browser_type.name, "version": browser.version} + context = browser.new_context( + viewport={"width": 1440, "height": 960}, reduced_motion="reduce" + ) + page = context.new_page() + page.set_default_timeout(10000) + page.on("pageerror", lambda e: report["errors"].append(str(e))) + page.on( + "console", + lambda m: ( + report["errors"].append(m.text) + if m.type == "error" and "422" not in m.text + else None + ), + ) + page.on("dialog", lambda d: d.accept()) + page.goto(admin + "/admin/login") + page.locator("[name=login]").fill("admin") + page.locator("[name=password]").fill(PASSWORD) + page.get_by_role("button", name="Войти", exact=True).click() + page.wait_for_url(admin + "/admin/") + page.goto(admin + "/admin/pages/index") + page.locator("#preview-result iframe").wait_for() + page.wait_for_load_state("networkidle") + # Switch before any server transform can incidentally repair layout. + for _ in range(2): + page.locator("[data-editor-mode=expert]").click() + expect(page.locator(".builder")).to_have_class("builder expert-layout") + expect(page.locator("#inspectpane #preview-result iframe")).to_be_visible() + page.locator("[data-editor-mode=constructor]").click() + expect(page.locator("#builder > #stagepane")).to_be_visible() + expect(page.locator("#stagepane > .stage-toolbar").first).to_be_visible() + expect(page.locator("#stagepane .pane-foot button")).to_be_visible() + report["flows"].append("pristine_mode_roundtrip_restores_preview_and_toolbar") + reference = browser.new_page( + viewport={"width": 1440, "height": 960}, reduced_motion="reduce" + ) + reference.goto((ROOT / "design/builder-antirion.html").as_uri()) + reference.locator(".tree-item").first.wait_for() + selectors = [ + ".treepane", + ".inspectpane", + ".pane-head", + ".tree-layout", + ".tree-item", + ".stage-toolbar", + ".panel-tabs", + ".inspect-title h3", + ".field input", + ".head .button", + ] + for theme in ["light", "dark"]: + if theme == "dark": + page.locator(".topbar [data-action=theme]").click() + for width in [1440, 1280, 1024, 768, 390, 360]: + page.set_viewport_size({"width": width, "height": 960}) + reference.set_viewport_size({"width": width, "height": 960}) + page.wait_for_timeout(80) + live = metrics(page, selectors) + original = metrics(reference, selectors) + if width > 960: + assert page.evaluate( + "Math.abs(document.querySelector('.builder').getBoundingClientRect().bottom-innerHeight)<1" + ) + assert page.evaluate("document.documentElement.scrollHeight<=innerHeight+1") + for selector in [ + ".pane-head", + ".tree-layout", + ".stage-toolbar", + ".panel-tabs", + ".inspect-title h3", + ".field input", + ".head .button", + ]: + assert live[selector]["font"] == original[selector]["font"], ( + width, + selector, + live[selector], + original[selector], + ) + if selector not in [".field input", ".head .button"]: + assert live[selector]["padding"] == original[selector]["padding"], ( + width, + selector, + live[selector], + original[selector], + ) + # Shared shell is already approved separately; constructor columns retain designer widths. + if width > 960: + for selector in [".treepane", ".inspectpane"]: + assert abs(live[selector]["width"] - original[selector]["width"]) < 1, ( + width, + selector, + live[selector], + original[selector], + ) + assert not page.evaluate("document.documentElement.scrollWidth>innerWidth+1"), ( + width + ) + if theme == "light": + for selector in [ + ".treepane", + ".inspectpane", + ".tree-layout", + ".stage-toolbar", + ".field input", + ]: + assert ( + live[selector]["background"] == original[selector]["background"] + ), (width, selector, live[selector], original[selector]) + page.screenshot(path=str(OUT / f"constructor-{theme}-{width}.png")) + reference.screenshot(path=str(OUT / f"reference-{width}.png")) + report["comparisons"].append( + {"theme": theme, "width": width, "runtime": live, "reference": original} + ) + page.set_viewport_size({"width": 1440, "height": 960}) + original = (site / "pages/index.md").read_text() + # Field edits apply automatically. Save and tree selection flush immediately pending changes. + title = page.locator('[data-inspector] [name="p.title"]').first + title.fill("Auto applied builder") + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Auto applied builder") + ) + expect( + page.frame_locator("#preview-result iframe").get_by_role( + "heading", name="Auto applied builder", exact=True + ) + ).to_be_visible() + assert (site / "pages/index.md").read_text() == original + expect(title).to_be_focused() + assert title.evaluate("(e)=>e.selectionStart") == len("Auto applied builder") + title.fill("{{ invalid }}") + expect(page.locator(".issues")).to_be_visible() + expect(title).to_have_value("{{ invalid }}") + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-notice")).to_contain_text("Изменения не применены") + assert (site / "pages/index.md").read_text() == original + idle(page) + title.fill("Corrected builder") + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Corrected builder") + ) + expect(page.locator(".issues")).to_have_count(0) + page.locator('[data-inspector] [data-value-picker="p.image"]').click() + page.locator("[data-value-search]").fill("hero") + page.locator('[data-value-choice="assets/hero.svg"]').click() + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("image: assets/hero.svg") + ) + expect( + page.frame_locator("#preview-result iframe").locator('img[src*="hero.svg"]') + ).to_be_visible() + report["flows"].append( + "invalid_fields_retained_save_stopped_correction_and_real_asset_picker" + ) + title.fill("Flush on selection") + page.locator("button[data-tree-id=b_cta]").click() + expect(page.locator(".tree-node.selected")).to_have_attribute("data-tree-id", "b_cta") + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Flush on selection") + ) + report["flows"].append("auto_apply_focus_caret_preview_and_selection_flush") + idle(page) + page.locator("[data-viewport=mobile]").click() + page.get_by_role("button", name="Обновить превью", exact=True).click() + expect(page.locator("#preview-result iframe")).to_have_class( + __import__("re").compile("mobile-viewport") + ) + page.locator("[data-viewport=desktop]").click() + report["flows"].append("device_retained_after_preview_refresh") + # Real source picker -> API bind object, not flattened resolved text. + page.locator('[data-source-picker="p.title"]').first.click() + page.locator("[data-binding-kind]").select_option("bind") + page.locator("[data-binding-path]").fill("page.title") + page.locator("[data-apply-binding]").click() + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("bind: page.title") + ) + report["flows"].append("binding_picker_preserves_typed_source") + idle(page) + page.get_by_role("button", name="Дублировать", exact=True).click() + expect(page.locator(".tree-node")).to_have_count(6) + duplicate = page.locator(".tree-node.selected").get_attribute("data-tree-id") + assert duplicate != "b_cta" + page.get_by_role("button", name="Удалить", exact=True).click() + page.keyboard.press("Escape") + expect(page.locator(".tree-node")).to_have_count(6) + page.get_by_role("button", name="Удалить", exact=True).click() + page.locator("[data-builder-confirm]").click() + expect(page.locator(".tree-node")).to_have_count(5) + expect(page.locator(".tree-node.selected")).to_have_attribute("data-tree-id", "b_cta") + report["flows"].append("duplicate_selects_new_id_delete_is_memory_only") + idle(page) + # Original catalog: search/category/allowed target; a click inserts with actual manifest preview/defaults. + page.locator(".pane-head [data-catalog-open]").click() + expect(page.locator("#builder-catalog-dialog")).to_be_visible() + page.locator("[data-catalog-search]").fill("no-such-fragment") + expect(page.locator("[data-catalog-empty]")).to_be_visible() + page.locator("[data-catalog-search]").fill("hero") + page.locator('[data-catalog-form=hero] [name="p.title"]').evaluate( + "e=>e.value='{{ invalid }}'" + ) + page.locator("[data-fragment=hero]").click() + expect(page.locator("#builder-catalog-dialog .catalog-errors")).to_be_visible() + expect(page.locator('[data-catalog-form=hero] [name="p.title"]')).to_have_value( + "{{ invalid }}" + ) + page.locator('[data-catalog-form=hero] [name="p.title"]').fill("Заголовок страницы") + page.locator("[data-catalog-form=hero]").get_by_role( + "button", name="Добавить блок", exact=True + ).click() + expect(page.locator(".tree-node")).to_have_count(6) + expect(page.locator('[data-inspector] [name="p.title"]').first).to_have_value( + "Заголовок страницы" + ) + assert (site / "pages/index.md").read_text() == original + report["flows"].append("catalog_filters_click_inserts_schema_defaults_no_file_write") + idle(page) + # Actual drag event sequence exercises the same HTML transform as keyboard movement. + last = page.locator(".tree-node.selected").get_attribute("data-tree-id") + page.locator(f"button[data-tree-id={last}]").drag_to( + page.locator("button[data-tree-id=b_hero]") + ) + expect(page.locator(".tree-node").first).to_have_attribute("data-tree-id", last) + report["flows"].append("drag_drop_real_reordering") + idle(page) + page.locator('[data-inspector] [name="p.title"]').first.fill("Saved pending edit") + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-result .success")).to_be_visible() + assert "Saved pending edit" in (site / "pages/index.md").read_text() + assert not (work / "dist/current").exists() + report["flows"].append("save_flushes_pending_fields_without_publish") + # Source mode preserves bytes; live source validation, diff and reset are real. + idle(page) + page.get_by_role("button", name="Эксперт", exact=True).click() + expect(page.locator("#document-source")).to_be_visible() + before = page.locator("#document-source").input_value() + page.locator("#document-source").fill( + before.replace("title:", "# formatter-check\ntitle:", 1) + ) + page.locator("[data-format-source]").click() + expect(page.locator("#document-source")).not_to_have_value( + __import__("re").compile("formatter-check") + ) + assert (site / "pages/index.md").read_text() == before + report["flows"].append("explicit_server_format_does_not_save_file") + page.locator("#document-source").fill(before + "\nExpert text") + expect(page.locator("#buffer-status")).to_contain_text("Есть несохранённые") + page.locator("[data-builder-diff]").click() + expect(page.locator(".diff-line.add")).to_contain_text("Expert text") + page.keyboard.press("Escape") + expect(page.locator("[data-builder-diff]")).to_be_focused() + page.locator("[data-builder-reset]").click() + page.locator("[data-builder-confirm]").click() + expect(page.locator("#document-source")).to_have_value(before) + report["flows"].append("expert_source_diff_reset_dialog_focus") + idle(page) + reference.get_by_role("button", name="Эксперт", exact=True).click() + report["expert_comparisons"] = [] + for width in [1440, 1280, 1024, 768, 390, 360]: + page.set_viewport_size({"width": width, "height": 960}) + reference.set_viewport_size({"width": width, "height": 960}) + live = metrics(page, [".treepane", ".inspectpane", ".expert-textarea"]) + source = metrics(reference, [".treepane", ".inspectpane", ".expert-textarea"]) + expect(page.locator("#inspectpane #preview-result iframe")).to_be_visible() + assert live[".expert-textarea"]["font"] == source[".expert-textarea"]["font"] + assert live[".expert-textarea"]["padding"] == source[".expert-textarea"]["padding"] + if width > 1050: + for selector in [".treepane", ".inspectpane"]: + assert abs(live[selector]["width"] - source[selector]["width"]) < 1 + elif width > 700: + assert ( + page.locator(".inspectpane").bounding_box()["width"] + == page.locator("#builder").bounding_box()["width"] + ) + assert not page.evaluate("document.documentElement.scrollWidth>innerWidth+1") + page.evaluate("scrollTo(0,0)") + page.screenshot(path=str(OUT / f"expert-dark-{width}.png")) + reference.screenshot(path=str(OUT / f"reference-expert-{width}.png")) + report["expert_comparisons"].append( + {"width": width, "runtime": live, "reference": source} + ) + page.set_viewport_size({"width": 1440, "height": 960}) + page.get_by_role("button", name="Конструктор", exact=True).click() + page.locator("[data-tree-tab=mapping]").click() + expect(page.locator(".mapping-card").first).to_be_visible() + page.locator("[data-focus-bind]").first.click() + expect(page.locator("[data-inspector-panel=bindings]")).to_be_visible() + report["flows"].append("data_map_and_binding_inspector") + assert not report["errors"], report["errors"] + reference.close() + browser.close() + (OUT / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2)) + print( + json.dumps( + { + "comparisons": len(report["comparisons"]), + "flows": len(report["flows"]), + "artifacts": str(OUT), + } + ) + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_editor_001.py b/scripts/qa_editor_001.py new file mode 100644 index 0000000..f8ba97f --- /dev/null +++ b/scripts/qa_editor_001.py @@ -0,0 +1,341 @@ +"""Two real HTTP origins and Chromium: buffers, CAS, preview bridge, assets, auth, release.""" + +from __future__ import annotations + +import json +import os +import shutil +import socket +import tempfile +from pathlib import Path +from unittest.mock import patch + +from playwright.sync_api import expect, sync_playwright +from qa_001 import PASSWORD, ROOT, serve + +from site_engine.parsing import frontmatter +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app +from site_engine.web.preview_app import create_preview_app + + +def reserve(): + sock = socket.socket() + sock.bind(("127.0.0.1", 0)) + return sock + + +def main(): + artifacts = Path("/tmp/site-engine-001-editor-qa") + artifacts.mkdir(exist_ok=True) + checks = [] + with tempfile.TemporaryDirectory(prefix="cms-editor-qa-") as tmp: + work = Path(tmp) + site = work / "site" + shutil.copytree( + ROOT / "examples/studio-site", site, ignore=shutil.ignore_patterns(".engine") + ) + probe = site / "fragments/qa_probe" + probe.mkdir(parents=True) + (probe / "fragment.yaml").write_text( + "id: qa_probe\nname: Probe\ncategory: test\nfields: []\nslots: {}\n" + ) + (probe / "template.html.j2").write_text( + "

Script probe

" + ) + (probe / "script.js").write_text("window.__site_bundle_ran=1;") + meta, body = frontmatter.parse((site / "pages/index.md").read_text()) + meta["regions"]["main"].append({"id": "b_probe", "fragment": "qa_probe"}) + (site / "pages/index.md").write_text(frontmatter.dumps(meta, body)) + (site / "pages/crlf.md").write_bytes( + b"---\r\ntitle: Exact\r\nstatus: draft\r\n---\r\nBody\r\n" + ) + (site / "assets/new.svg").parent.mkdir(exist_ok=True) + (site / "assets/new.svg").write_text( + '' + ) + a, p = reserve(), reserve() + admin = f"http://127.0.0.1:{a.getsockname()[1]}" + preview = f"http://127.0.0.1:{p.getsockname()[1]}" + env = { + "SITE_ROOT": str(site), + "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(work / "state"), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "temporary-editor-browser-secret-" * 2, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": admin, + "SITE_PREVIEW_ORIGIN": preview, + } + with ( + patch.dict(os.environ, env), + serve(create_app(), a), + serve(create_preview_app(), p), + sync_playwright() as pw, + ): + browser = pw.chromium.launch(headless=True, args=["--no-sandbox"]) + context = browser.new_context( + viewport={"width": 1440, "height": 1000}, reduced_motion="reduce" + ) + page = context.new_page() + errors = [] + browser_api_requests = [] + page.on("pageerror", lambda e: errors.append(str(e))) + page.on( + "request", + lambda r: ( + browser_api_requests.append(r.url) + if "/admin/api/v1/" in r.url or "authorization" in r.headers + else None + ), + ) + page.on("dialog", lambda d: d.accept()) + page.goto(admin + "/admin/login") + page.locator("[name=login]").fill("admin") + page.locator("[name=password]").fill(PASSWORD) + page.get_by_role("button", name="Войти", exact=True).click() + page.wait_for_url(admin + "/admin/") + page.goto(admin + "/admin/pages/index") + source = page.locator("#document-source") + original = (site / "pages/index.md").read_text() + page.locator("#preview-result iframe").wait_for() + frame = page.frame_locator("#preview-result iframe") + expect(frame.locator("[data-preview-id=b_hero]")).to_be_visible() + assert frame.locator("body").evaluate( + "()=>window.__site_script_ran===undefined&&window.__site_bundle_ran===undefined" + ) + assert frame.locator("[data-preview-id=b_demo]").count() == 0 + checks.extend(["site_scripts_blocked", "feature_hidden_not_rendered"]) + assert page.locator("#preview-result iframe").get_attribute("src").startswith(preview) + checks.append("separate_origin_preview") + frame.locator("[data-preview-id=lh_header]").click(position={"x": 10, "y": 10}) + expect(page.locator("[data-readonly-inspector]")).to_be_visible() + expect(page.locator("[data-readonly-inspector]")).to_contain_text("layout / default") + checks.append("fixed_readonly_inspector") + tab = context.new_page() + tab.on("dialog", lambda d: d.accept()) + tab.goto(admin + "/admin/pages/index") + tab.locator("#preview-result iframe").wait_for() + # Select via the preview bridge; then apply typed values to memory only. + frame.locator("[data-preview-id=b_hero]").click(position={"x": 20, "y": 20}) + expect(page.locator(".tree-node.selected")).to_have_attribute("data-tree-id", "b_hero") + expect(page.locator('[data-inspector] [name="p.title"]')).to_be_visible() + page.locator('[data-inspector] [name="p.title"]').fill("Browser buffer hero") + page.locator('[data-inspector] [name="p.image"]').fill("assets/new.svg") + with page.expect_response(lambda r: r.url.endswith("/transform")) as response: + page.get_by_role("button", name=__import__("re").compile("^Применить (к буферу|изменения)$")).click() + assert response.value.status == 200, response.value.text() + expect(source).to_have_value(__import__("re").compile("Browser buffer hero")) + assert (site / "pages/index.md").read_text() == original + expect( + page.frame_locator("#preview-result iframe").get_by_role( + "heading", name="Browser buffer hero", exact=True + ) + ).to_be_visible() + img = page.frame_locator("#preview-result iframe").locator('img[src*="new.svg"]') + expect(img).to_be_visible() + assert img.evaluate("(e)=>e.complete&&e.naturalWidth>0") + checks.extend( + ["preview_to_tree", "constructor_no_write", "unsaved_preview", "workspace_asset"] + ) + # Tree navigation scrolls only when needed; the next preview restores that viewport. + page.locator("button[data-tree-id=b_cta]").click() + expect(page.locator(".tree-node.selected")).to_have_attribute("data-tree-id", "b_cta") + expect( + page.frame_locator("#preview-result iframe").locator("[data-preview-id=b_cta]") + ).to_have_css("outline-style", "solid") + page.wait_for_timeout(180) + scroll = ( + page.frame_locator("#preview-result iframe").locator("body").evaluate("()=>scrollY") + ) + assert scroll > 0 + page.locator('[data-inspector] [name="p.title"]').fill("Расскажите о сайте") + page.get_by_role("button", name=__import__("re").compile("^Применить (к буферу|изменения)$")).click() + expect( + page.frame_locator("#preview-result iframe").get_by_role( + "heading", name="Расскажите о сайте", exact=True + ) + ).to_be_visible() + page.wait_for_timeout(180) + restored = ( + page.frame_locator("#preview-result iframe").locator("body").evaluate("()=>scrollY") + ) + assert abs(scroll - restored) < 4, (scroll, restored) + checks.append("tree_scroll_and_viewport_restore") + # Mode switch changes no serialization; Save commits the exact common buffer. + before = source.input_value() + page.get_by_role("button", name="Эксперт", exact=True).click() + expect(source).to_be_visible() + page.get_by_role("button", name="Конструктор", exact=True).click() + assert source.input_value() == before + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-result .success")).to_be_visible() + assert (site / "pages/index.md").read_text() == before + checks.extend(["mode_roundtrip", "explicit_save"]) + # Stale second tab must retain its own text and receive both versions. + tab.get_by_role("button", name="Эксперт", exact=True).click() + stale = ( + tab.locator("#document-source") + .input_value() + .replace("title: Главная", "title: Second tab") + ) + tab.locator("#document-source").fill(stale) + with tab.expect_response(lambda r: r.url.endswith("/save")) as response: + tab.get_by_role("button", name="Сохранить документ", exact=True).click() + assert response.value.status == 409 + expect(tab.locator(".conflict-panel")).to_be_visible() + assert tab.locator("#document-source").input_value() == stale + tab.locator("[name=confirm_rebase]").check() + tab.locator("[data-rebase]").click() + assert (site / "pages/index.md").read_text() == before + tab.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(tab.locator("#editor-result .success")).to_be_visible() + checks.append("two_tab_conflict_explicit_rebase") + tab.close() + # Invalid expert text and rejected stale response never destroy the buffer. + page.get_by_role("button", name="Эксперт", exact=True).click() + bad = "---\ntitle: A\ntitle: B\n---\nkeep invalid body" + source.fill(bad) + page.get_by_role("button", name="Проверить", exact=True).click() + expect(page.locator("#editor-result")).to_have_attribute("data-valid", "0") + assert source.input_value() == bad + checks.append("invalid_expert_preserved") + page.screenshot(path=str(artifacts / "invalid-expert.png"), full_page=True) + # Reload (explicitly discard dirty) and check normal entry fields and saving. + page.goto(admin + "/admin/content/services/bots") + page.locator('[data-inspector] [name="p.title"]').fill("Browser entry") + page.get_by_role("button", name=__import__("re").compile("^Применить (к буферу|изменения)$")).click() + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Browser entry") + ) + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-result .success")).to_be_visible() + assert "Browser entry" in (site / "content/services/bots.md").read_text() + checks.append("entry_buffer_save") + page.screenshot(path=str(artifacts / "entry.png"), full_page=True) + # Exact original CRLF bytes survive mode changes and an unmodified Save. + page.goto(admin + "/admin/pages/crlf") + page.get_by_role("button", name="Эксперт", exact=True).click() + page.get_by_role("button", name="Конструктор", exact=True).click() + exact = (site / "pages/crlf.md").read_bytes() + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-result .success")).to_be_visible() + assert (site / "pages/crlf.md").read_bytes() == exact + checks.append("exact_crlf_source") + # A delayed old preview response cannot replace a newer expert buffer. + page.wait_for_load_state("networkidle") + held = [] + page.route("**/admin/editor/pages/crlf/preview", lambda route: held.append(route)) + with page.expect_request(lambda r: r.url.endswith("/admin/editor/pages/crlf/preview")): + page.get_by_role("button", name="Обновить превью", exact=True).click() + page.wait_for_timeout(150) + assert held + page.get_by_role("button", name="Эксперт", exact=True).click() + page.locator("#document-source").fill( + "---\ntitle: New buffer\nstatus: draft\n---\nNewer" + ) + held.pop().continue_() + page.wait_for_timeout(300) + assert page.locator("#document-source").input_value().endswith("Newer") + page.unroute("**/admin/editor/pages/crlf/preview") + checks.append("stale_preview_rejected") + # Network failures leave text and download available. + page.route("**/admin/editor/pages/crlf/save", lambda route: route.abort()) + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-notice")).to_contain_text("Нет связи") + assert page.locator("#document-source").input_value().endswith("Newer") + page.unroute("**/admin/editor/pages/crlf/save") + checks.append("network_error_preserves_buffer") + page.goto(admin + "/admin/pages/index") + page.locator("#preview-result iframe").wait_for() + page.screenshot(path=str(artifacts / "constructor.png"), full_page=True) + # Reject each boundary independently: origin, source, snapshot, revision and unknown block. + page.evaluate("""() => { + const root=document.querySelector('#document-editor'),p=document.querySelector('#preview-result'),f=p.querySelector('iframe'); + const data={type:'preview:select',snapshot:p.dataset.snapshot,revision:Number(p.dataset.revision),block:{scope:'page',owner:'index',id:'b_dirs'}}; + for(const variant of [ + {origin:'https://evil.example',source:f.contentWindow,data}, + {origin:root.dataset.previewOrigin,source:window,data}, + {origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,snapshot:'wrong'}}, + {origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,revision:999999}}, + {origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,block:{scope:'page',owner:'index',id:'unknown'}}}, + {origin:root.dataset.previewOrigin,source:f.contentWindow,data:{...data,block:{scope:'page',owner:'wrong',id:'b_dirs'}}} + ]) window.dispatchEvent(new MessageEvent('message',variant)); + }""") + page.wait_for_timeout(120) + assert page.locator(".tree-node.selected").get_attribute("data-tree-id") == "b_hero" + checks.append("message_boundaries_checked") + # Forged messages are rejected, and document content never enters localStorage. + page.evaluate( + "window.dispatchEvent(new MessageEvent('message',{origin:'https://evil.example',source:window,data:{type:'preview:select',snapshot:'wrong',revision:0,block:{scope:'page',owner:'index',id:'b_hero'}}}))" + ) + storage = page.evaluate("Object.keys(localStorage)") + assert all(k in ["site-admin-theme", "site-admin-narrow"] for k in storage), storage + checks.extend(["forged_messages_rejected", "no_content_storage"]) + page.goto(admin + "/admin/publish") + page.get_by_role( + "button", name="Опубликовать текущий черновик сайта", exact=True + ).click() + page.get_by_role("button", name="Продолжить", exact=True).click() + expect(page.locator(".status-published")).to_have_count(1) + assert (work / "dist/current/index.html").exists() + public = (work / "dist/current/index.html").read_text() + assert "data-preview-" not in public and "preview:ready" not in public + checks.append("publish_public_html") + first = (work / "dist/current").resolve().name + (site / "pages/crlf.md").write_text("---\ntitle: Updated draft\nstatus: draft\n---\n") + # A different workspace hash creates a second release, then rollback only switches current. + page.get_by_role( + "button", name="Опубликовать текущий черновик сайта", exact=True + ).click() + page.get_by_role("button", name="Продолжить", exact=True).click() + expect(page.get_by_role("button", name="Вернуть этот релиз", exact=True)).to_have_count( + 1 + ) + page.get_by_role("button", name="Вернуть этот релиз", exact=True).click() + with page.expect_response(lambda r: "/admin/publish/rollback/" in r.url): + page.get_by_role("button", name="Продолжить", exact=True).click() + expect(page.locator(".status-published")).to_have_count(1) + assert (work / "dist/current").resolve().name == first + assert "Updated draft" in (site / "pages/crlf.md").read_text() + checks.append("rollback_preserves_workspace") + # Ordinary Save also works with JavaScript disabled. + fallback = browser.new_context( + java_script_enabled=False, storage_state=context.storage_state() + ) + plain = fallback.new_page() + plain.goto(admin + "/admin/pages/crlf?mode=expert") + plain.locator("#document-source").fill( + "---\ntitle: Full form save\nstatus: draft\n---\nNo JS" + ) + plain.get_by_role("button", name="Сохранить документ", exact=True).click() + assert (site / "pages/crlf.md").read_text().endswith("No JS") + assert plain.locator("#editor-result .success").count() == 1 + fallback.close() + checks.append("ordinary_form_without_js") + # Epoch revocation keeps open editor source available for download. + page.goto(admin + "/admin/pages/index") + page.get_by_role("button", name="Эксперт", exact=True).click() + before = page.locator("#document-source").input_value() + page.locator("#document-source").fill(before + "\nunsaved after expiry") + (work / "state/auth_epoch").write_text("1") + page.get_by_role("button", name="Сохранить документ", exact=True).click() + expect(page.locator("#editor-notice")).to_contain_text("Сессия истекла") + assert "unsaved after expiry" in page.locator("#document-source").input_value() + with page.expect_download() as download: + page.get_by_role("button", name="Скачать исходник", exact=True).click() + assert download.value.suggested_filename == "index.md" + checks.append("session_expiry_download") + assert not errors, errors + assert not browser_api_requests, browser_api_requests + checks.append("internal_credentials_never_in_browser") + browser.close() + (artifacts / "report.json").write_text( + json.dumps({"checks": checks, "js_errors": errors}, ensure_ascii=False, indent=2) + ) + print(json.dumps({"checks": len(checks), "artifacts": str(artifacts)})) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_pages_001.py b/scripts/qa_pages_001.py new file mode 100644 index 0000000..c65193c --- /dev/null +++ b/scripts/qa_pages_001.py @@ -0,0 +1,363 @@ +"""Stage 2: original/runtime visual measurements and real browser interactions.""" + +import json +import os +import shutil +import tempfile +from pathlib import Path +from unittest.mock import patch + +from playwright.sync_api import expect, sync_playwright +from qa_001 import PASSWORD, ROOT, serve + +from site_engine.build.pipeline import build_site +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app + +OUT = Path("/tmp/site-engine-pages-001") +MEASURE = """names => Object.fromEntries(names.map(name => { + const e=document.querySelector(name), r=e.getBoundingClientRect(), s=getComputedStyle(e); + return [name,{x:r.x,y:r.y,width:r.width,height:r.height,fontSize:s.fontSize, + fontFamily:s.fontFamily,fontWeight:s.fontWeight,lineHeight:s.lineHeight, + padding:s.padding,color:s.color,background:s.backgroundColor}]; +}))""" + + +def settled(page): + page.wait_for_function("() => !document.querySelector('.htmx-request,.htmx-swapping,.htmx-settling')") + + +def main(): + OUT.mkdir(exist_ok=True) + report = {"visual": [], "flows": [], "errors": []} + with tempfile.TemporaryDirectory(prefix="cms-pages-") as temp: + work = Path(temp) + site = work / "site" + shutil.copytree( + ROOT / "examples/studio-site", site, ignore=shutil.ignore_patterns(".engine") + ) + env = { + "SITE_ROOT": str(site), + "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(work / "state"), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "temporary-pages-qa-secret-" * 2, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": "", + "SITE_PREVIEW_ORIGIN": "", + "SITE_PUBLIC_HOST": "", + } + with patch.dict(os.environ, env), serve(create_app()) as origin, sync_playwright() as pw: + browser = pw.chromium.launch(headless=True, args=["--no-sandbox"]) + context = browser.new_context( + viewport={"width": 1440, "height": 960}, reduced_motion="reduce" + ) + page = context.new_page() + page.on("pageerror", lambda e: report["errors"].append(str(e))) + page.on( + "console", lambda m: report["errors"].append(m.text) if m.type == "error" else None + ) + page.on( + "response", + lambda r: ( + report["errors"].append(f"{r.status} {r.url}") if r.status >= 400 else None + ), + ) + page.goto(origin + "/admin/login") + page.locator('[name="login"]').fill("admin") + page.locator('[name="password"]').fill(PASSWORD) + page.get_by_role("button", name="Войти", exact=True).click() + page.wait_for_url(origin + "/admin/") + reference = browser.new_page( + viewport={"width": 1440, "height": 960}, reduced_motion="reduce" + ) + reference.goto((ROOT / "design/antirion-rework.html").as_uri()) + for screen in ["pages", "overview"]: + for p in [page, reference]: + p.set_viewport_size({"width": 1440, "height": 960}) + page.goto(origin + ("/admin/pages" if screen == "pages" else "/admin/")) + if screen == "overview": + reference.locator('[data-route="overview"]').first.click() + # Compare original component geometry with identical text/data. + # Only original text and row count change; its markup/CSS/layout stay intact. + reference.evaluate( + """html => { + const source=new DOMParser().parseFromString(html,'text/html'); + for(const selector of ['.headline','.ribbon']) { + const a=document.querySelector(selector), b=source.querySelector(selector); + const ta=document.createTreeWalker(a,NodeFilter.SHOW_TEXT), tb=document.createTreeWalker(b,NodeFilter.SHOW_TEXT); + const texts=[]; while(tb.nextNode())if(tb.currentNode.textContent.trim())texts.push(tb.currentNode.textContent); + let i=0;while(ta.nextNode())if(ta.currentNode.textContent.trim() && ir.remove()); + originals.slice(0,rows.length).forEach((r,i)=>{ + const originalCells=r.querySelectorAll('td'), cells=rows[i].querySelectorAll('td'); + originalCells.forEach((c,j)=>{ + if(j===0){c.querySelector('b').textContent=cells[j].querySelector('b').textContent;c.querySelector('small').textContent=cells[j].querySelector('small').textContent;} + else c.innerHTML=cells[j].innerHTML; + }); + }); + } + }""", + page.content(), + ) + selectors = [ + ".headline", + ".headline h2", + ".headline p", + ".ribbon", + ".ribbon-item .number", + ] + if screen == "pages": + selectors += [ + ".toolbar", + ".search", + ".select", + ".tabs", + ".workbench", + ".data-table", + ".data-table thead", + "#pageRows tr", + ".inspect-heading", + ".preview", + ".device-toggle", + ] + else: + selectors += [ + ".overview-stage", + ".overview-lead", + ".giant", + ".overview-live", + ".section-grid", + ".section-title", + ] + for theme in ["light", "dark"]: + for p in [page, reference]: + p.evaluate("theme=>document.body.dataset.skin=theme", theme) + for width in [1440, 1280, 1024, 768, 390, 360]: + for p in [page, reference]: + p.set_viewport_size({"width": width, "height": 960}) + reference.wait_for_timeout(200) + actual, expected = ( + page.evaluate(MEASURE, selectors), + reference.evaluate(MEASURE, selectors), + ) + # Different inspector text/overview state changes vertical content height. + # Compare stable structure and every visual style, record other coordinates. + for selector in selectors: + props = [ + "fontSize", + "fontFamily", + "fontWeight", + "lineHeight", + "padding", + "color", + "background", + "x", + "width", + ] + if selector in [ + ".headline", + ".headline h2", + ".headline p", + ".toolbar", + ".search", + ".select", + ".tabs", + ".data-table thead", + "#pageRows tr", + ] or (selector == ".ribbon" and screen == "pages"): + props += ["y", "height"] + for prop in props: + a, b = actual[selector][prop], expected[selector][prop] + assert ( + abs(a - b) < 0.6 if isinstance(a, (float, int)) else a == b + ), (screen, theme, width, selector, prop, a, b) + assert not page.evaluate( + "document.documentElement.scrollWidth>innerWidth+1" + ), (screen, theme, width) + report["visual"].append( + { + "screen": screen, + "theme": theme, + "width": width, + "runtime": actual, + "reference": expected, + } + ) + if width in [1440, 390]: + page.screenshot( + path=str(OUT / f"{screen}-{theme}-{width}.png"), full_page=True + ) + reference.screenshot( + path=str(OUT / f"reference-{screen}-{theme}-{width}.png"), + full_page=True, + ) + page.set_viewport_size({"width": 1440, "height": 960}) + page.goto(origin + "/admin/pages") + expect(page.locator("#pageRows tr.selected")).to_have_attribute("data-page", "index") + page.locator('#pageRows tr[data-page="contacts"] td').nth(1).click() + expect(page.locator(".inspect-heading h3")).to_have_text("Контакты") + assert "/admin/pages?" in page.url + page.locator('#pageRows tr[data-page="index"]').focus() + page.keyboard.press("Enter") + expect(page.locator(".inspect-heading h3")).to_have_text("Главная") + page.locator('[data-page-device="mobile"]').click() + page.locator("#pageSearch").fill("contacts") + expect(page.locator("#pageRows tr[data-page]")).to_have_count(1) + assert page.locator("#pageSearch").evaluate("e=>e===document.activeElement") + page.locator('#pageRows tr[data-page="contacts"]').click() + expect(page.locator(".inspect-heading h3")).to_have_text("Контакты") + expect(page.locator("[data-page-browser]")).to_have_class("browser mobile") + page.locator("[data-reset-pages]").click() + expect(page.locator("#pageRows tr[data-page]")).to_have_count(5) + expect(page.locator("#pageSearch")).to_have_value("") + settled(page) + expect(page.locator(".inspect-heading h3")).to_have_text("Контакты") + page.get_by_role("tab", name="Черновики").click() + expect(page.locator("#pageRows tr[data-page]")).to_have_count(1) + page.go_back() + expect(page.locator("#pageRows tr[data-page]")).to_have_count(5) + settled(page) + page.go_forward() + expect(page.locator("#pageRows tr[data-page]")).to_have_count(1) + settled(page) + page.locator("[data-reset-pages]").click() + expect(page.locator("#pageRows tr[data-page]")).to_have_count(5) + settled(page) + page.locator("#layoutFilter").select_option("default") + page.wait_for_url("**/*layout=default*") + page.get_by_role("tab", name="В каталоге").click() + expect(page.locator("#pageRows tr[data-page]")).to_have_count(4) + assert "layout=default" in page.url and "status=published" in page.url + report["flows"].append( + "row click/keyboard, inspector, mobile miniature, live search/focus, filters, reset, Back/Forward" + ) + page.locator("#pageSearch").fill("no-such-document") + expect(page.locator(".empty h3")).to_have_text("Ничего не найдено") + page.get_by_role("link", name="Сбросить фильтры", exact=True).click() + expect(page.locator("#pageRows tr[data-page]")).to_have_count(5) + settled(page) + for opener, dialog in [ + ("pages-info-dialog", "pages-info-dialog"), + ("page-details-dialog", "page-details-dialog"), + ("new-page-dialog", "new-page-dialog"), + ]: + trigger = page.locator(f'[data-open-modal="{opener}"]') + before = list(site.glob("pages/**/*.md")) + trigger.click() + expect(page.locator("#" + dialog)).to_be_visible() + page.keyboard.press("Tab") + assert page.locator("#" + dialog).evaluate("e=>e.contains(document.activeElement)") + page.screenshot(path=str(OUT / (dialog + ".png"))) + if dialog == "new-page-dialog": + page.set_viewport_size({"width": 390, "height": 844}) + assert not page.evaluate("document.documentElement.scrollWidth>innerWidth+1") + page.screenshot(path=str(OUT / "new-page-mobile.png")) + page.set_viewport_size({"width": 1440, "height": 960}) + page.keyboard.press("Escape") + expect(page.locator("#" + dialog)).not_to_be_visible() + assert trigger.evaluate("e=>e===document.activeElement") + assert list(site.glob("pages/**/*.md")) == before + report["flows"].append( + "info/details/create dialogs: focus, Escape, no writes on open/cancel" + ) + page.locator('[data-open-modal="new-page-dialog"]').click() + page.locator('#new-page-dialog [name="title"]').fill("Новая вложенная страница") + page.locator('#new-page-dialog [name="page_id"]').fill("nested/browser") + page.get_by_role("button", name="Создать черновик", exact=True).click() + page.wait_for_url("**/*msg=created*") + expect(page.locator(".inspect-heading h3")).to_have_text("Новая вложенная страница") + settled(page) + assert (site / "pages/nested/browser.md").exists() + assert not (work / "dist/current").exists() + page.locator('[data-open-modal="new-page-dialog"]').click() + page.locator('#new-page-dialog [name="title"]').fill("Duplicate preserved") + page.locator('#new-page-dialog [name="page_id"]').fill("nested/browser") + page.get_by_role("button", name="Создать черновик", exact=True).click() + expect(page.locator('#new-page-dialog [role="alert"]')).to_be_visible() + expect(page.locator('#new-page-dialog [name="title"]')).to_have_value( + "Duplicate preserved" + ) + expect(page.locator("#new-page-dialog")).to_be_visible() + settled(page) + page.locator('#new-page-dialog [name="page_id"]').fill("new") + with page.expect_response(lambda response: response.url.endswith('/admin/pages/new') and response.status == 422): + page.get_by_role("button", name="Создать черновик", exact=True).click() + settled(page) + expect(page.locator('#new-page-dialog [name="page_id"]')).to_have_value("new") + expect(page.locator('#new-page-dialog [role="alert"]')).to_be_visible() + assert not (site / "pages/new.md").exists() + # Duplicate/reserved ID intentionally return 409/422. + report["errors"] = [ + e + for e in report["errors"] + if not ( + any(code in e for code in ["409", "422"]) + and ("/admin/pages/new" in e or "Failed to load resource" in e) + ) + ] + page.keyboard.press("Escape") + report["flows"].append( + "real nested draft creation, list selection, 409/422 with values retained, no publication" + ) + build_site(site, work / "dist") + page.goto(origin + "/admin/pages") + expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("02") + source = site / "pages/index.md" + original = source.read_bytes() + source.write_bytes(original + b"\n") + page.reload() + expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("03") + source.write_bytes(original) + page.reload() + expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("02") + page.screenshot(path=str(OUT / "pages-live.png"), full_page=True) + report["flows"].append("real release counts, modified/reverted source, long build ID") + manifest_path = work / "dist/current/manifest.json" + manifest_source = manifest_path.read_bytes() + manifest = json.loads(manifest_source) + del manifest["page_sources"] + manifest_path.write_text(json.dumps(manifest)) + page.reload() + expect(page.locator(".ribbon-item").nth(1).locator(".number")).to_have_text("—") + expect( + page.get_by_text( + "Для этого релиза нет данных сравнения. Они появятся после следующей публикации." + ) + ).to_be_visible() + manifest_path.write_bytes(manifest_source) + report["flows"].append("legacy release comparison is unknown, not a false zero") + nojs = browser.new_context( + java_script_enabled=False, storage_state=context.storage_state() + ) + fallback = nojs.new_page() + fallback.goto(origin + "/admin/pages") + fallback.locator("#pageSearch").fill("contacts") + fallback.get_by_role("button", name="Найти", exact=True).click() + expect(fallback.locator("#pageRows tr[data-page]")).to_have_count(1) + fallback.locator('[data-open-modal="new-page-dialog"]').click() + expect(fallback.locator("#new-page-dialog")).to_be_visible() + fallback.locator('#new-page-dialog [name="title"]').fill("Без JavaScript") + fallback.locator('#new-page-dialog [name="page_id"]').fill("no-js") + fallback.get_by_role("button", name="Создать черновик", exact=True).click() + expect(fallback.locator(".inspect-heading h3")).to_have_text("Без JavaScript") + report["flows"].append("no-JavaScript filter and real draft creation") + nojs.close() + assert not report["errors"], report["errors"] + browser.close() + (OUT / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2)) + print( + json.dumps( + {"visual": len(report["visual"]), "flows": report["flows"], "artifacts": str(OUT)}, + ensure_ascii=False, + ) + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_selection_001.py b/scripts/qa_selection_001.py new file mode 100644 index 0000000..1b01d14 --- /dev/null +++ b/scripts/qa_selection_001.py @@ -0,0 +1,230 @@ +"""Bidirectional selection without POST, including scriptless same-origin preview.""" + +import json +import os +import shutil +import tempfile +from contextlib import ExitStack +from pathlib import Path +from unittest.mock import patch + +from playwright.sync_api import expect, sync_playwright +from qa_001 import PASSWORD, ROOT, serve +from qa_editor_001 import reserve + +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app +from site_engine.web.preview_app import create_preview_app + + +def main(): + out = Path(os.environ.get("QA_SELECTION_OUT", "/tmp/site-engine-selection-001")) + out.mkdir(exist_ok=True) + report = {"runs": []} + with sync_playwright() as pw: + kind = getattr(pw, os.environ.get("QA_BROWSER", "chromium")) + options = {"headless": True} + if kind.name == "chromium": + options["args"] = ["--no-sandbox", "--no-proxy-server"] + elif kind.name == "firefox": + options["firefox_user_prefs"] = {"network.proxy.type": 0} + if os.environ.get("QA_BROWSER_EXECUTABLE"): + options["executable_path"] = os.environ["QA_BROWSER_EXECUTABLE"] + browser = kind.launch(**options) + report["browser"] = {"name": kind.name, "version": browser.version} + for interactive in (False, True): + with tempfile.TemporaryDirectory(prefix="cms-selection-") as tmp, ExitStack() as stack: + work = Path(tmp) + site = work / "site" + shutil.copytree( + ROOT / "examples/studio-site", site, ignore=shutil.ignore_patterns(".engine") + ) + original = (site / "pages/index.md").read_bytes() + admin_socket, preview_socket = reserve(), reserve() + admin = f"http://127.0.0.1:{admin_socket.getsockname()[1]}" + preview = f"http://127.0.0.1:{preview_socket.getsockname()[1]}" + stack.enter_context( + patch.dict( + os.environ, + { + "SITE_ROOT": str(site), + "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(work / "state"), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "selection-browser-secret-" * 3, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": admin if interactive else "", + "SITE_PREVIEW_ORIGIN": preview if interactive else "", + }, + ) + ) + stack.enter_context(serve(create_app(), admin_socket)) + if interactive: + stack.enter_context(serve(create_preview_app(), preview_socket)) + else: + preview_socket.close() + page = browser.new_page(viewport={"width": 1440, "height": 960}) + stack.callback(page.close) + errors, posts, native_dialogs = [], [], [] + page.on("pageerror", lambda e, errors=errors: errors.append(str(e))) + page.on( + "console", + lambda m, errors=errors: errors.append(m.text) if m.type == "error" else None, + ) + page.on( + "request", + lambda r, posts=posts: posts.append(r.url) if r.method == "POST" else None, + ) + + def reject_native(dialog, native_dialogs=native_dialogs): + native_dialogs.append({"type": dialog.type, "message": dialog.message}) + dialog.dismiss() + + page.on("dialog", reject_native) + page.goto(admin + "/admin/login") + page.locator("[name=login]").fill("admin") + page.locator("[name=password]").fill(PASSWORD) + page.get_by_role("button", name="Войти", exact=True).click() + page.wait_for_url(admin + "/admin/") + page.goto(admin + "/admin/pages/index") + frame = page.frame_locator("#preview-result iframe") + expect(frame.locator("[data-preview-id=b_hero]")).to_have_attribute( + "data-preview-selected", "true" + ) + page.wait_for_load_state("networkidle") + source = page.locator("#document-source").input_value() + snapshot = page.locator("#preview-result").get_attribute("data-snapshot") + page.locator("#preview-result iframe").evaluate("e=>e.__qaSelectionFrame=true") + posts.clear() + # Even offline selection is immediate: neither inspector nor preview needs a POST. + page.route("**/admin/editor/**/select", lambda route: route.abort()) + for identity in ("b_steps", "b_dirs", "b_hero", "b_cta"): + page.locator(f"[data-tree-id='{identity}']").click() + expect(frame.locator(f"[data-preview-id='{identity}']")).to_have_attribute( + "data-preview-selected", "true" + ) + expect(page.locator("#inspectpane [name=block_id]").first).to_have_value( + identity + ) + assert not page.locator("[data-constructor]").evaluate("e=>e.inert") + page.screenshot( + path=str(out / f"{'bridge' if interactive else 'scriptless'}-tree.png") + ) + # Click the actual rendered section; inspector/tree follow without replacing iframe. + frame.locator("[data-preview-id=b_dirs] h2").click() + expect(page.locator("[data-tree-id=b_dirs]")).to_have_class( + __import__("re").compile("selected") + ) + expect(page.locator("#inspectpane [name=block_id]").first).to_have_value("b_dirs") + # Fixed layout roots select the read-only inspector in both directions. + page.locator("[data-tree-scope=layout]").last.click() + expect(page.locator("[data-readonly-inspector]")).to_be_visible() + expect(frame.locator("[data-preview-scope=layout]").last).to_have_attribute( + "data-preview-selected", "true" + ) + assert not posts, posts + assert page.locator("#document-source").input_value() == source + assert page.locator("#preview-result").get_attribute("data-snapshot") == snapshot + assert page.locator("#preview-result iframe").evaluate("e=>e.__qaSelectionFrame") + assert (site / "pages/index.md").read_bytes() == original + assert not (work / "dist/current").exists() + assert page.locator("#preview-result iframe").get_attribute("sandbox") == ( + "allow-scripts allow-same-origin" if interactive else "allow-same-origin" + ) + if not interactive: + assert ( + frame.locator("body").evaluate("()=>typeof window.siteDocument") + == "undefined" + ) + # Changes still flush before switching, without an extra /select request. + page.locator("[data-tree-id=b_hero]").click() + page.locator('[data-inspector] [name="p.title"]').fill("Pending selection edit") + page.locator("[data-tree-id=b_dirs]").click() + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Pending selection edit") + ) + expect(page.locator("#inspectpane [name=block_id]").first).to_have_value("b_dirs") + assert not any(url.endswith(("/select", "/save")) for url in posts) + assert (site / "pages/index.md").read_bytes() == original + page.wait_for_load_state("networkidle") + # A second cached inspector still submits the live source, not its cached copy. + page.locator("[data-tree-id=b_hero]").click() + expect(page.locator('[data-inspector] [name="p.title"]')).to_have_value( + "Pending selection edit" + ) + page.locator('[data-inspector] [name="p.title"]').fill("Second cached edit") + page.locator("[data-tree-id=b_dirs]").click() + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Second cached edit") + ) + # Internal navigation uses the designer modal; Escape keeps all unsaved edits. + picker = page.locator("#page-picker") + other = picker.locator("option").evaluate_all( + "options=>options.find(o=>o.value!=='index').value" + ) + picker.select_option(other) + confirm = page.locator("#builder-confirm-dialog") + expect(confirm).to_be_visible() + page.keyboard.press("Escape") + expect(picker).to_have_value("index") + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Second cached edit") + ) + page.locator('.sidebar a[href="/admin/pages"]').click() + expect(confirm).to_be_visible() + confirm.locator("[data-close-dialog]").click() + assert page.url == admin + "/admin/pages/index" + page.locator('[data-action="profile"]').click() + page.locator('#profile-dialog button[type="submit"]').click() + expect(confirm).to_be_visible() + page.keyboard.press("Escape") + expect(page.locator("#profile-dialog")).to_be_visible() + page.locator("#profile-dialog [data-close-dialog]").first.click() + picker.select_option(other) + confirm.locator("[data-builder-confirm]").click() + page.wait_for_url(admin + "/admin/pages/" + other + "?mode=constructor") + assert (site / "pages/index.md").read_bytes() == original + # Reloading a dirty tab must not produce a native beforeunload dialog either. + page.goto(admin + "/admin/pages/index?mode=expert") + page.locator("#document-source").fill(source + "\nUnsaved reload probe") + page.locator(".expert-file.selected").click() + expect(page.locator("#builder-confirm-dialog")).to_be_visible() + page.keyboard.press("Escape") + expect(page.locator("#document-source")).to_have_value( + __import__("re").compile("Unsaved reload probe") + ) + page.reload() + expect(page.locator("#document-source")).to_have_value(source) + # Entry uses the shared in-product modal and replays confirmed form submission. + page.goto(admin + "/admin/content/services/bots?mode=expert") + entry_source = page.locator("#document-source") + entry_source.fill(entry_source.input_value() + "\nUnsaved entry probe") + page.locator('[data-action="profile"]').click() + page.locator('#profile-dialog button[type="submit"]').click() + shared_confirm = page.locator("#confirm-dialog") + expect(shared_confirm).to_be_visible() + page.keyboard.press("Escape") + expect(entry_source).to_have_value(__import__("re").compile("Unsaved entry probe")) + page.locator('#profile-dialog button[type="submit"]').click() + shared_confirm.locator("[value=confirm]").click() + page.wait_for_url(admin + "/admin/login") + assert not native_dialogs, native_dialogs + assert not errors, errors + report["runs"].append( + { + "interactive_bridge": interactive, + "selection_posts": 0, + "no_file_write": True, + "navigation_modals": True, + "native_dialogs": native_dialogs, + "errors": errors, + } + ) + browser.close() + (out / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2)) + print(json.dumps(report, ensure_ascii=False)) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_shell_001.py b/scripts/qa_shell_001.py new file mode 100644 index 0000000..d452780 --- /dev/null +++ b/scripts/qa_shell_001.py @@ -0,0 +1,171 @@ +"""Compare the shared runtime shell with the original Antirion in real Chromium. + +All application data and auth state live in a disposable copy of studio-site. +Screenshots/measurements are written outside the checkout. +""" + +from __future__ import annotations + +import json +import os +import shutil +import tempfile +from pathlib import Path +from unittest.mock import patch + +from playwright.sync_api import sync_playwright +from qa_001 import PASSWORD, ROOT, serve + +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app + +OUT = Path("/tmp/site-engine-shell-001") +MEASURE = """() => { + const names = ['.sidebar','.brand','.brand-logo','.sidebar-nav','.sidebar-bottom', + '.topbar','.cmd','.header-btn[data-action=theme]','.user-chip', + '.sidebar .nav-item.active','.sidebar .nav-item.active svg']; + return Object.fromEntries(names.map(name => { + const e=document.querySelector(name), r=e.getBoundingClientRect(), s=getComputedStyle(e); + return [name,{x:r.x,y:r.y,width:r.width,height:r.height,fontSize:s.fontSize, + color:s.color,background:s.backgroundColor,padding:s.padding}]; + })); +}""" + + +def main(): + OUT.mkdir(exist_ok=True) + report = {"geometry": [], "flows": [], "errors": []} + with tempfile.TemporaryDirectory(prefix="cms-shell-") as temp: + work = Path(temp) + shutil.copytree(ROOT / "examples/studio-site", work / "site", ignore=shutil.ignore_patterns(".engine")) + env = { + "SITE_ROOT": str(work / "site"), "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(work / "state"), "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "temporary-shell-qa-secret-" * 2, "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": "", "SITE_PREVIEW_ORIGIN": "", "SITE_PUBLIC_HOST": "", + } + with patch.dict(os.environ, env), serve(create_app()) as origin, sync_playwright() as pw: + browser = pw.chromium.launch(headless=True, args=["--no-sandbox"]) + page = browser.new_page(viewport={"width": 1440, "height": 960}, reduced_motion="reduce") + page.on("pageerror", lambda error: report["errors"].append(str(error))) + page.on("console", lambda message: report["errors"].append(message.text) if message.type == "error" else None) + page.on("response", lambda response: report["errors"].append(f"{response.status} {response.url}") if response.status >= 400 else None) + page.goto(origin + "/admin/login") + page.locator('[name="login"]').fill("admin") + page.locator('[name="password"]').fill(PASSWORD) + page.get_by_role("button", name="Войти", exact=True).click() + page.wait_for_url(origin + "/admin/") + page.goto(origin + "/admin/pages") + page.locator("#topbar .cmd").wait_for() + reference = browser.new_page(viewport={"width": 1440, "height": 960}) + reference.goto((ROOT / "design/antirion-rework.html").as_uri()) + reference.locator("#topbar .cmd").wait_for() + # Compare the same content. Only fixture labels/status/counts differ from the mock. + labels = page.evaluate("""() => ({site:document.querySelector('.sitelabel b').textContent, + host:document.querySelector('.crumb span').textContent, + small:document.querySelector('.sitelabel small').textContent, + count:document.querySelector('.nav-item .count').textContent})""") + reference.evaluate("""labels => { + document.querySelector('.sitelabel b').textContent=labels.site; + document.querySelector('.sitelabel small').textContent=labels.small; + document.querySelector('.crumb span').textContent=labels.host; + document.querySelector('.nav-item .count').textContent=labels.count; + document.querySelectorAll('.nav-item .count').forEach((e,i)=>{if(i)e.remove()}); + document.querySelector('.live-pip').classList.add('no-release'); + document.querySelector('.live-pip').textContent='НЕТ РЕЛИЗА'; + document.querySelector('.user-chip').textContent='AD'; + }""", labels) + for theme in ["light", "dark"]: + if theme == "dark": + page.locator(".topbar [data-action=theme]").click() + reference.locator(".topbar [data-action=theme]").click() + # The prototype rebuilds its shell on theme changes. + reference.evaluate("""labels => { + document.querySelector('.sitelabel b').textContent=labels.site; + document.querySelector('.sitelabel small').textContent=labels.small; + document.querySelector('.crumb span').textContent=labels.host; + document.querySelector('.nav-item .count').textContent=labels.count; + document.querySelectorAll('.nav-item .count').forEach((e,i)=>{if(i)e.remove()}); + document.querySelector('.live-pip').textContent='НЕТ РЕЛИЗА'; + document.querySelector('.user-chip').textContent='AD'; + }""", labels) + for width in [1440, 1280, 1024, 768, 390, 360]: + for p in [page, reference]: + p.set_viewport_size({"width": width, "height": 960}) + reference.wait_for_timeout(180) + actual, expected = page.evaluate(MEASURE), reference.evaluate(MEASURE) + for selector in actual: + for prop in ["x", "y", "width", "height", "fontSize", "padding", "color", "background"]: + assert actual[selector][prop] == expected[selector][prop], (theme,width,selector,prop,actual[selector],expected[selector]) + assert not page.evaluate("document.documentElement.scrollWidth > innerWidth+1") + report["geometry"].append({"theme":theme,"width":width,"runtime":actual,"reference":expected}) + if width in [1440, 390]: + page.screenshot(path=str(OUT / f"runtime-{theme}-{width}.png")) + reference.screenshot(path=str(OUT / f"reference-{theme}-{width}.png")) + page.set_viewport_size({"width": 1440, "height": 960}) + page.locator(".topbar [data-action=theme]").click() + page.locator('[data-action="collapse"]').click() + assert page.locator(".sidebar").bounding_box()["width"] == 66 + page.screenshot(path=str(OUT / "collapsed.png")) + page.reload() + assert page.locator(".sidebar").bounding_box()["width"] == 66 + page.locator('[data-action="collapse"]').click() + report["flows"].append("collapse and persisted preference") + page.keyboard.press("Control+k") + assert page.locator("#cmd-input").evaluate("e=>e===document.activeElement") + page.locator("#cmd-input").fill("contacts") + assert page.locator("[data-command-result]:visible").count() == 1 + page.screenshot(path=str(OUT / "command.png")) + page.locator("#cmd-input").fill("does-not-exist") + assert page.locator("[data-command-empty]").is_visible() + page.locator("#cmd-input").fill("Контент") + page.locator("[data-command-result]:visible").click() + page.wait_for_url(origin + "/admin/content") + assert page.locator(".nav-item.active").inner_text() == "Контент" + report["flows"].append("Ctrl+K, real pages/sections, empty search, htmx navigation") + page.locator('[data-action="profile"]').click() + assert page.locator("#profile-dialog").is_visible() + page.keyboard.press("Escape") + assert page.locator('[data-action="profile"]').evaluate("e=>e===document.activeElement") + report["flows"].append("profile, Escape and return focus") + page.set_viewport_size({"width": 390, "height": 844}) + page.get_by_role("button", name="Открыть меню").click() + page.screenshot(path=str(OUT / "mobile-menu.png")) + page.keyboard.press("Shift+Tab") + assert page.locator(".sidebar").evaluate("e=>e.contains(document.activeElement)") + page.keyboard.press("Escape") + assert page.get_by_role("button", name="Открыть меню").evaluate("e=>e===document.activeElement") + assert page.locator(".main").evaluate("e=>!e.inert") + report["flows"].append("mobile menu, focus trap, Escape, return focus") + page.locator('[data-action="command"]').click() + page.screenshot(path=str(OUT / "command-mobile.png")) + page.keyboard.press("Escape") + page.get_by_role("button", name="Открыть меню").click() + page.locator("#cover").click(position={"x":350,"y":300}) + assert page.locator(".sidebar.open").count() == 0 + page.set_viewport_size({"width": 1440, "height": 960}) + page.goto(origin + "/admin/publish") + page.get_by_role("button", name="Опубликовать текущий черновик сайта", exact=True).click() + page.locator("#confirm-dialog button[value=confirm]").click() + page.locator(".live-pip:not(.no-release) .mono").wait_for() + page.goto(origin + "/admin/pages") + assert page.locator(".live-pip .mono").inner_text().strip() + page.screenshot(path=str(OUT / "live-release.png")) + for width in [1440, 1280, 1024, 768, 600, 430, 421, 390, 360]: + page.set_viewport_size({"width":width,"height":960}) + assert not page.evaluate("document.documentElement.scrollWidth > innerWidth+1"), ("live",width) + page.set_viewport_size({"width":1440,"height":960}) + report["flows"].append("actual live build after publication and navigation") + page.locator('[data-action="profile"]').click() + page.get_by_role("button", name="Выйти", exact=True).click() + page.wait_for_url(origin + "/admin/login") + report["flows"].append("profile logout through real CSRF form") + assert not report["errors"], report["errors"] + browser.close() + (OUT / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2)) + print(json.dumps({"geometry":len(report["geometry"]),"flows":report["flows"],"artifacts":str(OUT)},ensure_ascii=False)) + + +if __name__ == "__main__": + main() diff --git a/scripts/sync_builder_design.py b/scripts/sync_builder_design.py new file mode 100644 index 0000000..07eed34 --- /dev/null +++ b/scripts/sync_builder_design.py @@ -0,0 +1,44 @@ +"""Transfer designer CSS/SVG verbatim, isolating its document reset from the shared shell.""" + +import json +import re +import sys +from pathlib import Path + +from css_scope import scope_css + +ROOT = Path(__file__).resolve().parents[1] + + +def main(): + def emit(path, content): + if "--check" in sys.argv: + if not path.exists() or path.read_text() != content: + raise SystemExit(f"Designer transfer out of date: {path}") + else: + path.write_text(content) + + static = ROOT / "src/site_engine/web/admin/static" + source = (ROOT / "design/assets/builder.css").read_text() + emit(static / "builder-design.css", source) + # All component declarations and media queries remain designer-owned. Only the + # document root becomes the embedded editor root. Ordinary prefixed selectors + # isolate the shell, including in browsers that do not implement CSS @scope. + embedded = re.sub(r"(?{%- endmacro %}\n" + emit(static.parent / "templates/_builder_icons.html.j2", macro) + + +if __name__ == "__main__": + main() diff --git a/scripts/verify_package_001.py b/scripts/verify_package_001.py new file mode 100644 index 0000000..1727f03 --- /dev/null +++ b/scripts/verify_package_001.py @@ -0,0 +1,109 @@ +"""Install a wheel and smoke real FastAPI outside the checkout, without design/.""" + +import os +import shutil +import subprocess +import sys +import tempfile +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] + + +def main(): + with tempfile.TemporaryDirectory(prefix="cms-installed-001-") as tmp: + work = Path(tmp) + project = work / "project" + project.mkdir() + for name in ("pyproject.toml", "README.md"): + shutil.copyfile(ROOT / name, project / name) + shutil.copytree( + ROOT / "src", + project / "src", + ignore=shutil.ignore_patterns("*.egg-info", "__pycache__"), + ) + subprocess.run( + [ + sys.executable, + "-m", + "pip", + "wheel", + str(project), + "--no-deps", + "--no-build-isolation", + "-q", + "-w", + str(work / "wheels"), + ], + check=True, + ) + wheel = next((work / "wheels").glob("*.whl")) + target = work / "installed" + subprocess.run( + [ + sys.executable, + "-m", + "pip", + "install", + "--no-deps", + "--target", + str(target), + str(wheel), + "-q", + ], + check=True, + ) + shutil.copytree( + ROOT / "examples/studio-site", work / "site", ignore=shutil.ignore_patterns(".engine") + ) + env = dict( + os.environ, + PYTHONPATH=str(target), + SITE_ROOT=str(work / "site"), + SITE_DIST=str(work / "dist"), + SITE_STATE_DIR=str(work / "state"), + SITE_COOKIE_SECURE="0", + SITE_SECRET_KEY="installed-test-secret-" * 3, + SITE_ADMIN_ORIGIN="http://127.0.0.1:9100", + SITE_PREVIEW_ORIGIN="http://127.0.0.1:9101", + ) + program = """ +import html, os, re +from pathlib import Path +from fastapi.testclient import TestClient +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app +from site_engine.web.preview_app import create_preview_app +import site_engine +assert str(Path(site_engine.__file__).resolve()).startswith(os.environ['PYTHONPATH']) +os.environ['SITE_ADMIN_PASSWORD_HASH']=hash_password('installed wheel password',n=2**10) +os.environ['SITE_ADMIN_LOGIN']='admin' +app=create_app() +with TestClient(app) as client: + response=client.post('/admin/login',data={'login':'admin','password':'installed wheel password'},headers={'Origin':'http://testserver'}) + assert response.status_code==200 + response=client.get('/admin/pages/index') + assert response.status_code==200 and 'document-editor' in response.text + for name in ('antirion-rework.css','shell.css','pages.css','pages.js','admin.css','admin.js','editor.js','builder.css','builder-adapter.css','builder.js','htmx.min.js'): + assert client.get('/admin/static/'+name).status_code==200,name + assert 'pages-screen' in client.get('/admin/pages').text + cookie=client.cookies.get('se_session') + principal=app.state.auth.authenticate(cookie) + csrf=app.state.auth.csrf_token(principal) + source=(Path(os.environ['SITE_ROOT'])/'pages/index.md').read_text() + from site_engine.storage.fs import etag_of + result=client.post('/admin/editor/pages/index/preview',data={'source':source,'etag':etag_of(source.encode()),'csrf':csrf},headers={'Origin':'http://testserver','HX-Request':'true'}) + assert result.status_code==200,result.text + url=html.unescape(re.search(r"src='([^']+)'",result.text)[1]) + with TestClient(create_preview_app()) as preview: + result=preview.get(url) + assert result.status_code==200,result.text + assert 'preview:ready' in result.text and 'data-preview-id' in result.text + assert app.state.api_calls>0 +print('installed wheel: static, templates, API, bridge, separate preview OK; design/ absent') +""" + subprocess.run([sys.executable, "-c", program], cwd=work, env=env, check=True) + + +if __name__ == "__main__": + main() diff --git a/specs/001-antirion-admin/design-transfer.md b/specs/001-antirion-admin/design-transfer.md new file mode 100644 index 0000000..c9df89b --- /dev/null +++ b/specs/001-antirion-admin/design-transfer.md @@ -0,0 +1,144 @@ +# Повторный перенос дизайна 001 + +Дата: 2026-11-12. Основание — замечания пользователя о несоответствии оформления и поведения оригинальной вёрстке. Функциональные проверки прежней реализации не подтверждали точность переноса дизайна; визуальная приёмка 001 открыта повторно. + +## Порядок работы и проверки + +Каждый этап передаётся пользователю на проверку. Следующий этап начинается после его проверки. Во всех этапах исходные HTML/CSS/JS из `design/` задают композицию, размеры, иконки и поведение; адаптация подключает реальные данные и действия через существующий FastAPI-контракт. Демонстрационные роли, проверки и публикации не переносятся как фиктивные рабочие функции. + +| Этап | Что переносим | Источник | Проверка пользователя | +|---|---|---|---| +| 1. Общий каркас | Sidebar, группы и пункты навигации, логотип, верхняя панель, быстрый поиск, профиль, темы, сворачивание, мобильное меню | `antirion-rework.html`, `assets/antirion-rework.css`, `assets/antirion-rework.js`: sidebar/topbar/command | Принят пользователем; разрешён этап 2 | +| 2. Обзор и страницы | Композиция обзора, счётчики, поиск/фильтры, выбор строки, правый инспектор, создание страницы в модальном окне | Те же исходники: overview/pages/rows/inspector/new | Принят пользователем; разрешён этап 3 | +| 3. Редактор страниц | Заголовок с действиями, дерево слева, превью в центре, инспектор справа, Конструктор/Эксперт, каталог блоков, поля и переключения | `builder-antirion.html`, `assets/builder.css`, `assets/builder.js` | Подготовлен к проверке пользователя | +| 4. Контент и записи | Выбор коллекции, список записей, редактор по схеме, превью, вкладки и режим Эксперт | `content-antirion.html`, `assets/content-editor.css`, `assets/content-editor.js` | Ожидает этап 3 | +| 5. Публикация и завершение | Композиция публикации/истории/отката, рабочие состояния и подтверждения; итоговая сверка всех экранов, входа, ошибок и пустых состояний | `publication-antirion.html`, `assets/publication.css`, `assets/publication.js` | Ожидает этап 4 | + +Возможности следующей очереди (candidate/diff, RBAC, медиа и прочие) требуют отдельного действующего контракта; их ограничения фиксируются при переносе соответствующего экрана. + +## Этап 1 — принят пользователем + +- Оригинальный `antirion-rework.css` включён в runtime побайтово; его SHA-256 и происхождение SVG записаны в `static/VENDOR.md`. Рабочий пакет не зависит от наличия `design/`. +- Shell использует оригинальные классы и композицию, SVG paths и параметры штриха. Старые общие стили кнопок/полей/ссылок вынесены из области каркаса; адаптация native dialog/ссылок находится отдельно в `shell.css`. +- Sidebar сохраняет группы WORKSPACE/CONFIGURATION и исходный порядок пунктов, включая положение «Медиа». Счётчик страниц получен через API. Будущие разделы недоступны и подписаны в title. +- Topbar показывает реальный host, текущий раздел, быстрый поиск, статус публикации, тему и профиль. Несуществующий релиз не показан как LIVE. Полный реальный ID доступен в title; длинный timestamp/hash сокращается визуально, чтобы сохранить мобильную компоновку. +- Поиск открывается кнопкой и Ctrl/Cmd+K; фильтрует разделы и реальные страницы по названию/URL/файлу. Переход на страницу выбирает её в списке, как в оригинале. Закрытие — кнопкой, Esc или фоном; фокус возвращается вызывающему элементу. +- Окно профиля показывает действующего администратора и настоящую POST-форму выхода с CSRF. Демо-переключателя ролей нет: в текущем бэкенде один администратор. +- Сворачивание, адаптивная узкая панель, темы и мобильное меню сохраняют исходные breakpoints/классы. Настройки хранятся локально; документы и credentials туда не попадают. Мобильное меню удерживает клавиатурный фокус и блокирует фон. +- CSS/JS имеют URL с хешем содержимого. htmx не переносит inline `style` при settle: CSP остаётся строгой. + +Содержимое экранов (таблицы, формы, редакторы, публикация) ещё требует переноса на следующих этапах. Их предыдущий внешний вид не считается принятым вместе с каркасом. + +## Свидетельства проверки этапа 1 + +```bash +PYTHONPATH=src python scripts/qa_shell_001.py +PYTHONPATH=src python scripts/qa_001.py --out /tmp/site-engine-shell-general +PYTHONPATH=src python -m unittest discover -s tests -q +python scripts/verify_package_001.py +``` + +`qa_shell_001.py` поднимает настоящий uvicorn на временной копии сайта и открывает оригинал отдельно в Chromium. Для сравнения каркаса в оригинале подставляются только те же подписи сайта/host/счётчика/профиля/статуса. Контент страницы, CSS и layout оригинала не заменяются. + +Сопоставляются координаты, размеры, шрифт, padding, цвет и фон 11 элементов каркаса на 1440/1280/1024/768/390/360 px в обеих темах (12 наборов сравнения). Дополнительно проверяются реальные переходы htmx, поиск и пустая выдача, сохранение сворачивания, профиль/выход, мобильный фокус/закрытие и индикатор настоящего опубликованного релиза. С длинным build ID проверяются также 600/430/421 px. В журнал попадают JS-исключения, ошибки console/CSP и HTTP ≥400. + +Артефакты: `/tmp/site-engine-shell-001/` — `report.json`, парные `runtime-*.png`/`reference-*.png`, `collapsed.png`, `command.png`, `command-mobile.png`, `mobile-menu.png`, `live-release.png`. + +Дополнительная регрессия: 239 тестов OK; прежний браузерный сценарий — 8 экранов/60 проверок ширины; установленный wheel без `design/` работает. Эти результаты подтверждают совместимость, но не закрывают визуальную приёмку остальных экранов. + +Статус: этапы 1–2 приняты пользователем. Этап 3 подготовлен к проверке; этапы 4–5 ожидают её результата. + +## Этап 2 — принят пользователем + +- Обзор сохраняет оригинальные headline, overview-stage, live-панель, ribbon и две колонки изменений/проверок. Статус релиза, время сборки, ошибки и предупреждения получены из API. До первой публикации отображается отдельное состояние. Последние изменения показывают время файлов, без выдуманного автора. +- Список сохраняет исходные toolbar, tabs, workbench, размеры колонок, выделение строки, правый инспектор, миниатюру и действия. Поиск работает по названию/URL/файлу; layout и вкладки пересекаются с запросом. Выбор строки меняет инспектор, кнопка «Редактор» отдельно открывает существующий редактор. Выбор сохраняется при фильтрации и сбросе, URL поддерживает Back/Forward. +- Поиск обновляет только результаты и сохраняет фокус ввода. Выбор Desktop/Mobile миниатюры сохраняется при переключении строки. Информация, детали и создание используют исходные `.dialog`, `.field`, `.copyline`, `.dialog-actions` с native dialog, Escape/фоном и возвратом фокуса. +- Создание вызывает настоящий API: новая страница — draft, допускается вложенный ID, после успеха остаёмся в списке с выбранной новой страницей. Открытие/отмена ничего не записывают. При 409/422 окно остаётся открытым с ошибкой и введёнными значениями. Обычные GET/POST работают без JavaScript. +- Оригинальный CSS по-прежнему побайтово совпадает с `design/assets/antirion-rework.css`. `pages.css` адаптирует семантические ссылки и переносит исходные inline-размеры под CSP; старые общие стили изолированы от перенесённых экранов. + +### Данные и ограничения + +`PageRow` дополнен `changed`, `description`, `updated_at`, `issues`, `on_live`; `Workspace` — типизированным `release` и `comparison_available`. JSON-фильтр `/pages?changed=true` и HTML-вкладка используют одну проекцию. Credentials остаются на сервере. + +Для настоящего сравнения файлов Page новые `manifest.json` сохраняют `page_sources`: SHA-256 только опубликованных файлов страниц. Черновые пути и исходники в публичный manifest не попадают. После редактирования/возврата исходных байтов и отката сравнение следует активному релизу. В существующих релизах без индекса сравнение неизвестно: UI показывает «—» и объяснение; перепубликовывать автоматически не нужно. Это сравнение файлов Page, а не полный dependency diff сайта: изменения layout, fragment, коллекций или assets отдельно этим счётчиком не охватываются. + +Миниатюра сохраняет композицию исходного mock и показывает настоящий заголовок/литеральное SEO-описание; полный рендер страницы доступен в редакторе. Дублирование в деталях отключено с пояснением: такого действия в API пока нет. Новые действия редактора и публикации относятся к этапам 3–5. + +### Проверки этапа 2 + +```bash +PYTHONPATH=src python scripts/qa_pages_001.py +PYTHONPATH=src python scripts/qa_shell_001.py +PYTHONPATH=src python scripts/qa_editor_001.py +PYTHONPATH=src python -m unittest discover -s tests -q +python scripts/verify_package_001.py +``` + +`qa_pages_001.py` поднимает настоящий uvicorn на временной копии и открывает оригинал отдельно в Chromium. В оригинале для сравнения заменяются подписи headline/ribbon и данные/число строк таблицы; исходные компоненты и CSS не заменяются. Проверяются 24 набора: overview/pages × light/dark × 1440/1280/1024/768/390/360 px. Сверяются шрифты, padding, цвета, ширины и положение устойчивых компонентов; вертикальные размеры зависимых от реальных текстов областей записываются в отчёт. Это компонентная сверка и скриншоты, а не утверждение о побайтовом совпадении изображений с разными данными. + +Браузер проверяет выбор мышью/клавиатурой, фильтры/сброс/пустую выдачу/историю, фокус поиска, миниатюру, диалоги, настоящие draft и 409/422, отсутствие публикации при создании, значения после publish/edit/revert и неизвестное сравнение старого релиза, GET/POST без JS. Неожиданных JS/console/CSP/HTTP-ошибок нет. Артефакты: `/tmp/site-engine-pages-001/` — `report.json`, парные скриншоты overview/pages, окна и `pages-live.png`. + +Регрессия: 244 теста OK; каркас — 12 наборов сравнения/6 сценариев; редактор — 25 сквозных сценариев. Wheel установлен вне checkout без `design/`; новые CSS/JS и страницы доступны. Общая проверка экранов — 8 экранов/60 проверок ширины. + + +## Этап 3 — результат для проверки + +Источник — `builder-antirion.html` и `assets/builder.{css,js}`. Сохранены исходные классы, SVG paths/stroke, три панели, toolbar превью, вкладки дерева/карты источников, инспектора, каталог и редактор исходника. Принятый shell остаётся общим. `builder-design.css` — побайтовая копия исходника; `builder.css` автоматически добавляет ограничивающие редактором обычные селекторы через `:where`, сохраняя декларации, media queries и специфичность document root. Зависимости от браузерного `@scope` нет. Семантические HTML/htmx/CSP-адаптации находятся отдельно в `builder-adapter.css` и `builder.js`. Проверяемое воспроизведение: `python scripts/sync_builder_design.py --check`; хеши — `static/VENDOR.md`. + +### Поведение + +- Дерево показывает настоящие регионы, вложенные блоки/слоты, ID, скрытие и условия. Layout-блоки выбираются в read-only инспектор; изменять/перемещать/дублировать их нельзя. Карта источников показывает реальные literal/bind/query/типизированные ссылки из props. +- Поля строятся по схемам фрагментов. Простые поля сохраняют исходные `.field`/`.tiny-source`, списки, группы, link и query используют существующий типизированный парсер. Сложные поля не заменены плоским mock-эквивалентом. Файлы и ref выбираются из реальных choices, literal/bind сохраняются различимыми значениями. +- Чистый выбор секции локально переключает дерево и серверную HTML-проекцию инспектора; POST и блокировки интерфейса нет. Как в оригинале, дерево выделяет и прокручивает секцию в основном окне, клик по самой секции выбирает её в дереве и инспекторе. Снимок и iframe при выборе сохраняются. Это работает и без отдельного preview-origin: родительская админка управляет служебными маркерами в iframe без scripts; CSP остаётся `script-src 'none'`. Bridge другого origin сохраняет проверки origin/source/snapshot/revision/адреса блока. +- Правки инспектора применяются к текущей редакции после паузы 650 мс и обновляют настоящее превью. Кнопки Save, выбор другого блока и смена режима сначала применяют ожидающие поля. Фокус, caret и прокрутка инспектора/дерева восстанавливаются. Кнопка «Применить изменения» доступна отдельно. +- При 422 сохраняются актуальные значения input/textarea/select/checkbox, а не старые HTML-атрибуты. Ошибка останавливает следующий Save/переход; исправленные значения можно отправить повторно. 401/сетевая ошибка не очищают исходник. +- Каталог сохраняет поиск/категории и фильтрует реально допустимые фрагменты для региона/слота с учётом allow-паттернов. Клик вставляет блок с `preview`/default из настоящего manifest и выбирает новый ID. Ошибка оставляет окно с введёнными полями. Отдельного обязательного шага настройки перед каждой вставкой нет. +- Выше/ниже, drag-and-drop, скрытие, удаление и дублирование вызывают API transform. Дублируется всё поддерево с новыми ID; anchor копий снимаются, чтобы не получить повтор. После удаления выбирается соседний блок. Подтверждения удаления/отмены используют исходную модальную композицию; Escape отменяет действие. +- Desktop/Tablet/Mobile сохраняются при обновлении iframe. Клик настоящего превью выбирает блок, дерево прокручивает превью, обновление сохраняет viewport. Один iframe переносится между панелями Конструктора/Эксперта; перед htmx-заменой инспектора он сохраняется вне заменяемой области. Публичный HTML и JS сайта не получают служебных изменений. +- В «Эксперте» перенесены файлы слева, codebox/гаттер/подсветка/статусная строка по центру, превью и проверки справа; responsive использует исходный `.expert-layout`. Есть поиск, Ctrl/Cmd+F, Ctrl/Cmd+Enter, Ctrl/Cmd+S, скачивание, реальное сравнение с последней загруженной/сохранённой версией, отмена и явное серверное форматирование. Обычное переключение режимов не сериализует исходник; CRLF сохраняется до содержательной правки. + +### Архитектура и границы + +«Текущая редакция» в переключателе превью — изменения в памяти вкладки. Transform/validate/preview обрабатывают переданный source без записи контента; файл записывается только по «Сохранить документ», с прежними CAS/ETag, валидацией, историей и аудитом. Серверное автосохранение и восстанавливаемые draft-сессии не добавлены. `status: draft` остаётся статусом файла/участия в релизе. Продуктовые подписи используют «Нет несохранённых изменений», «Применить изменения», «Предпросмотр». + +Контракт дополнен `BlockAction.type: duplicate`, `Add.props`; schema включает настоящие manifest preview/defaults и названия страниц. Сохранение неполного документа по-прежнему допускается по ADR-003; готовность к публикации проверяет release validation. Успешная проверка структуры не выдаётся за проверку полного релиза. Сохранение не публикует сайт. + +Отдельного предупреждения о пересборке YAML при правках нет; пояснение остаётся рядом с исходником. Нативные `alert`/`confirm`/`prompt` и `beforeunload`-диалоги запрещены. Подтверждения удаления, отмены правок и внутренних переходов используют окна интерфейса, Escape отменяет действие и возвращает фокус. Перезагрузка/закрытие вкладки не вызывает системного подтверждения; несохранённая редакция при этом теряется. + +Тёмный режим использует утверждённые токены `antirion-rework.css`; палитра Rose не перенесена. Live-переключатель недоступен с объяснением: контракт просмотра опубликованного снимка в редакторе ещё отсутствует. Обратный поиск usages, developer/RBAC, demo server и симуляция 409 из прототипа не показаны как работающие возможности. Настоящий 409 обрабатывается через сравнение двух исходников, явное принятие ETag основы и отдельное сохранение. + +### Проверки этапа 3 + +```bash +python scripts/sync_builder_design.py --check +PYTHONPATH=src python scripts/qa_builder_001.py +PYTHONPATH=src python scripts/qa_selection_001.py +PYTHONPATH=src python scripts/qa_editor_001.py +PYTHONPATH=src python scripts/qa_shell_001.py +PYTHONPATH=src python scripts/qa_pages_001.py +PYTHONPATH=src python scripts/qa_001.py +PYTHONPATH=src python -m unittest discover -s tests -q +python scripts/verify_package_001.py +``` + +Chromium открывает оригинал отдельно от настоящего приложения на временной копии сайта. Конструктор: 12 наборов сравнения (2 темы × 6 ширин 1440/1280/1024/768/390/360), сверяются ширины колонок, шрифты/отступы компонентов, исходные светлые фоны. Для тёмной темы используется утверждённая палитра shell; это не сравнение с Rose. Эксперт: 6 сравнений шрифта/padding исходника, колонок на desktop и переноса инспектора на tablet; парные скриншоты оригинала. Это компонентная сверка при разных настоящих данных, не заявление о попиксельном совпадении всего экрана. + +12 браузерных групп проверяют переключение режимов до первой операции сервера с восстановлением превью/toolbar, автообновление/фокус/caret, немедленное применение перед выбором/Save, 422 с сохранённым вводом и остановкой Save, исправление и выбор настоящего изображения, viewport, binding, дублирование/отмену удаления/выбор соседа, каталог/вставку, drag-and-drop, явную запись без publish, форматирование без записи, Expert/diff/reset/фокус и карту источников. Проверяется и нижняя граница панелей на desktop: перенос кнопок не увеличивает документ за пределы viewport. Сквозная регрессия редактора — 25 сценариев, включая два origin, запрет JS сайта, границы сообщений, CRLF, две вкладки/409, сессию, сеть и Save без JS. + +Полная регрессия — 248 тестов OK. Прежние shell/pages — 12/24 набора и 6/6 групп; общая проверка — 8 экранов/60 ширин. Установленный wheel работает без `design/`, включая новые CSS/JS/шаблоны; CLI validate/build на изолированной копии — 0 ошибок/предупреждений, 7 страниц. Артефакты: `/tmp/site-engine-builder-001/` (`report.json`, `constructor-*.png`, `expert-dark-*.png`, `reference-*.png`), `/tmp/site-engine-builder-general/`, `/tmp/site-engine-001-editor-qa/`. + +Этап 3 передаётся пользователю на проверку. Этапы 4–5 в этой итерации не переносились. + +### Исправление по скриншоту пользователя + +На `http://10.10.0.44:8181` выполнена проверка напрямую без прокси, с настоящим входом. В Chromium исходные CSS загружались и применялись; в Firefox 142.0.1 воспроизведён распавшийся интерфейс из `data/Screenshot_198.png`: `CSSScopeRule` отсутствует, `.builder` имеет `grid-template-columns: none`, одновременно видны оба режима. Причина — игнорирование браузером всего `@scope`, а не HTTP-ошибка загрузки CSS. + +`builder.css`, `builder-adapter.css` и изоляция старого редактора в `admin.css` используют обычные селекторы с `:where`. Генератор сохраняет исходные декларации и media queries, новые at-rules требуют явной поддержки генератором. Дополнительно исправлены всплытие `document:state`, порядок переноса iframe относительно изменения классов и расчёт оставшейся высоты под фактической шапкой. При fallback-переносе iframe отправка bridge-команд ждёт проверенное `preview:ready`, чтобы не писать во временный `about:blank` до загрузки другого origin. + +Исправленные ресурсы проверены на настоящем сервере подменой файлов только в тестовой вкладке: 42 комбинации переключений/тем/ширин в Chromium и Firefox, переходы htmx и каталог; отдельно — страница «Услуги» при 1673 × 948 из скриншота. Серверная сборка и рабочий контент при этом не менялись. Артефакты: `/tmp/cms-live-inspect/` — `firefox-constructor.png` до исправления, `services-firefox-fixed.png` после, `fixed-report.json` / `firefox-fixed-report.json`. + +Для постоянного прогона другого браузера `qa_builder_001.py` поддерживает `QA_BROWSER=firefox`, необязательный `QA_BROWSER_EXECUTABLE` и отдельный `QA_BUILDER_OUT`. Нужны совместимые версия Playwright, браузер и его системные библиотеки. + +### Выбор секций и подтверждения + +`scripts/qa_selection_001.py` прошёл в Chromium 158 и Firefox 142; проверяет два режима превью — административный origin без scripts и bridge отдельного origin: дерево → выделение/прокрутка/инспектор, превью → дерево/инспектор, фиксированные блоки только для чтения, ноль POST при чистом выборе, неизменный iframe/снимок/source, отсутствие записи файла и публикации. Повторные правки после локального выбора передают текущий source. Проверяются отмена перехода через селектор/ссылку/выход, подтверждённый переход/выход из Entry, Escape, перезагрузка без системного диалога. Любой нативный диалог проваливает прогон. Артефакты: `/tmp/site-engine-selection-001/` и `/tmp/site-engine-selection-firefox-001/`. diff --git a/specs/001-antirion-admin/openapi.json b/specs/001-antirion-admin/openapi.json new file mode 100644 index 0000000..d6a7cd0 --- /dev/null +++ b/specs/001-antirion-admin/openapi.json @@ -0,0 +1,4556 @@ +{ + "components": { + "schemas": { + "Add": { + "additionalProperties": false, + "properties": { + "fragment": { + "title": "Fragment", + "type": "string" + }, + "parent": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Parent" + }, + "props": { + "additionalProperties": true, + "title": "Props", + "type": "object" + }, + "region": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Region" + }, + "slot": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Slot" + }, + "type": { + "const": "add", + "title": "Type", + "type": "string" + } + }, + "required": [ + "type", + "fragment" + ], + "title": "Add", + "type": "object" + }, + "BlockAction": { + "additionalProperties": false, + "properties": { + "block_id": { + "title": "Block Id", + "type": "string" + }, + "type": { + "enum": [ + "block", + "delete", + "toggle", + "duplicate" + ], + "title": "Type", + "type": "string" + }, + "values": { + "additionalProperties": true, + "title": "Values", + "type": "object" + } + }, + "required": [ + "type", + "block_id" + ], + "title": "BlockAction", + "type": "object" + }, + "Buffer": { + "additionalProperties": false, + "properties": { + "etag": { + "maxLength": 80, + "minLength": 1, + "title": "Etag", + "type": "string" + }, + "revision": { + "default": 0, + "minimum": 0.0, + "title": "Revision", + "type": "integer" + }, + "source": { + "maxLength": 524288, + "title": "Source", + "type": "string" + } + }, + "required": [ + "source", + "etag" + ], + "title": "Buffer", + "type": "object" + }, + "CollectionRow": { + "additionalProperties": false, + "properties": { + "id": { + "title": "Id", + "type": "string" + }, + "name": { + "title": "Name", + "type": "string" + }, + "published": { + "title": "Published", + "type": "integer" + }, + "total": { + "title": "Total", + "type": "integer" + } + }, + "required": [ + "id", + "name", + "total", + "published" + ], + "title": "CollectionRow", + "type": "object" + }, + "Create": { + "additionalProperties": false, + "properties": { + "id": { + "maxLength": 200, + "minLength": 1, + "title": "Id", + "type": "string" + }, + "layout": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Layout" + }, + "title": { + "default": "", + "title": "Title", + "type": "string" + } + }, + "required": [ + "id" + ], + "title": "Create", + "type": "object" + }, + "Entries": { + "additionalProperties": false, + "properties": { + "collection": { + "$ref": "#/components/schemas/CollectionRow" + }, + "entries": { + "items": { + "$ref": "#/components/schemas/EntryRow" + }, + "title": "Entries", + "type": "array" + } + }, + "required": [ + "collection", + "entries" + ], + "title": "Entries", + "type": "object" + }, + "EntryFields": { + "additionalProperties": false, + "properties": { + "body": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Body" + }, + "status": { + "anyOf": [ + { + "enum": [ + "draft", + "published", + "archived" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Status" + }, + "type": { + "const": "entry_fields", + "title": "Type", + "type": "string" + }, + "unset": { + "items": { + "type": "string" + }, + "title": "Unset", + "type": "array" + }, + "values": { + "additionalProperties": true, + "title": "Values", + "type": "object" + } + }, + "required": [ + "type" + ], + "title": "EntryFields", + "type": "object" + }, + "EntryRow": { + "additionalProperties": false, + "properties": { + "file": { + "title": "File", + "type": "string" + }, + "route": { + "title": "Route", + "type": "string" + }, + "slug": { + "title": "Slug", + "type": "string" + }, + "status": { + "title": "Status", + "type": "string" + }, + "title": { + "title": "Title", + "type": "string" + } + }, + "required": [ + "slug", + "title", + "status", + "route", + "file" + ], + "title": "EntryRow", + "type": "object" + }, + "ErrorBody": { + "additionalProperties": false, + "properties": { + "base_etag": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Base Etag" + }, + "buffer": { + "anyOf": [ + { + "$ref": "#/components/schemas/Snapshot" + }, + { + "type": "null" + } + ] + }, + "code": { + "title": "Code", + "type": "string" + }, + "committed": { + "anyOf": [ + { + "$ref": "#/components/schemas/Snapshot" + }, + { + "type": "null" + } + ] + }, + "current": { + "anyOf": [ + { + "$ref": "#/components/schemas/Snapshot" + }, + { + "type": "null" + } + ] + }, + "issues": { + "items": { + "$ref": "#/components/schemas/IssueDTO" + }, + "title": "Issues", + "type": "array" + }, + "message": { + "title": "Message", + "type": "string" + }, + "revision": { + "anyOf": [ + { + "type": "integer" + }, + { + "type": "null" + } + ], + "title": "Revision" + }, + "submitted": { + "anyOf": [ + { + "$ref": "#/components/schemas/Buffer" + }, + { + "type": "null" + } + ] + }, + "submitted_source": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Submitted Source" + } + }, + "required": [ + "code", + "message" + ], + "title": "ErrorBody", + "type": "object" + }, + "ErrorEnvelope": { + "additionalProperties": false, + "properties": { + "error": { + "$ref": "#/components/schemas/ErrorBody" + } + }, + "required": [ + "error" + ], + "title": "ErrorEnvelope", + "type": "object" + }, + "IssueDTO": { + "additionalProperties": false, + "properties": { + "code": { + "title": "Code", + "type": "string" + }, + "hint": { + "default": "", + "title": "Hint", + "type": "string" + }, + "message": { + "title": "Message", + "type": "string" + }, + "path": { + "default": "", + "title": "Path", + "type": "string" + }, + "severity": { + "default": "error", + "title": "Severity", + "type": "string" + } + }, + "required": [ + "code", + "message" + ], + "title": "IssueDTO", + "type": "object" + }, + "Metadata": { + "additionalProperties": false, + "properties": { + "body": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Body" + }, + "type": { + "const": "metadata", + "title": "Type", + "type": "string" + }, + "values": { + "additionalProperties": true, + "title": "Values", + "type": "object" + } + }, + "required": [ + "type" + ], + "title": "Metadata", + "type": "object" + }, + "Move": { + "additionalProperties": false, + "properties": { + "after": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "After" + }, + "before": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Before" + }, + "block_id": { + "title": "Block Id", + "type": "string" + }, + "direction": { + "anyOf": [ + { + "enum": [ + "up", + "down" + ], + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Direction" + }, + "type": { + "const": "move", + "title": "Type", + "type": "string" + } + }, + "required": [ + "type", + "block_id" + ], + "title": "Move", + "type": "object" + }, + "PageRow": { + "additionalProperties": false, + "properties": { + "changed": { + "anyOf": [ + { + "type": "boolean" + }, + { + "type": "null" + } + ], + "title": "Changed" + }, + "count": { + "title": "Count", + "type": "integer" + }, + "description": { + "default": "", + "title": "Description", + "type": "string" + }, + "file": { + "title": "File", + "type": "string" + }, + "id": { + "title": "Id", + "type": "string" + }, + "issues": { + "items": { + "$ref": "#/components/schemas/IssueDTO" + }, + "title": "Issues", + "type": "array" + }, + "layout": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Layout" + }, + "on_live": { + "default": false, + "title": "On Live", + "type": "boolean" + }, + "route": { + "title": "Route", + "type": "string" + }, + "status": { + "title": "Status", + "type": "string" + }, + "title": { + "title": "Title", + "type": "string" + }, + "updated_at": { + "default": "", + "title": "Updated At", + "type": "string" + } + }, + "required": [ + "id", + "title", + "status", + "route", + "file", + "layout", + "count" + ], + "title": "PageRow", + "type": "object" + }, + "Preview": { + "additionalProperties": false, + "properties": { + "expires_at": { + "title": "Expires At", + "type": "number" + }, + "html": { + "default": "", + "title": "Html", + "type": "string" + }, + "interactive": { + "title": "Interactive", + "type": "boolean" + }, + "message": { + "default": "", + "title": "Message", + "type": "string" + }, + "revision": { + "title": "Revision", + "type": "integer" + }, + "snapshot": { + "default": "", + "title": "Snapshot", + "type": "string" + }, + "url": { + "default": "", + "title": "Url", + "type": "string" + } + }, + "required": [ + "revision", + "interactive", + "expires_at" + ], + "title": "Preview", + "type": "object" + }, + "Release": { + "additionalProperties": false, + "properties": { + "current": { + "title": "Current", + "type": "boolean" + }, + "id": { + "title": "Id", + "type": "string" + } + }, + "required": [ + "id", + "current" + ], + "title": "Release", + "type": "object" + }, + "Releases": { + "additionalProperties": false, + "properties": { + "builds": { + "items": { + "$ref": "#/components/schemas/Release" + }, + "title": "Builds", + "type": "array" + }, + "current": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Current" + } + }, + "required": [ + "current", + "builds" + ], + "title": "Releases", + "type": "object" + }, + "Rollback": { + "additionalProperties": false, + "properties": { + "build_id": { + "pattern": "^\\d{8}T\\d{6}-[0-9a-f]{8}$", + "title": "Build Id", + "type": "string" + } + }, + "required": [ + "build_id" + ], + "title": "Rollback", + "type": "object" + }, + "Snapshot": { + "additionalProperties": false, + "properties": { + "etag": { + "title": "Etag", + "type": "string" + }, + "id": { + "title": "Id", + "type": "string" + }, + "issues": { + "items": { + "$ref": "#/components/schemas/IssueDTO" + }, + "title": "Issues", + "type": "array" + }, + "kind": { + "enum": [ + "page", + "entry" + ], + "title": "Kind", + "type": "string" + }, + "model": { + "anyOf": [ + { + "additionalProperties": true, + "type": "object" + }, + { + "type": "null" + } + ], + "title": "Model" + }, + "path": { + "title": "Path", + "type": "string" + }, + "revision": { + "default": 0, + "title": "Revision", + "type": "integer" + }, + "schema": { + "additionalProperties": true, + "title": "Schema", + "type": "object" + }, + "source": { + "title": "Source", + "type": "string" + } + }, + "required": [ + "kind", + "id", + "path", + "source", + "etag", + "model", + "issues", + "schema" + ], + "title": "Snapshot", + "type": "object" + }, + "Transform": { + "additionalProperties": false, + "properties": { + "action": { + "discriminator": { + "mapping": { + "add": "#/components/schemas/Add", + "block": "#/components/schemas/BlockAction", + "delete": "#/components/schemas/BlockAction", + "duplicate": "#/components/schemas/BlockAction", + "entry_fields": "#/components/schemas/EntryFields", + "metadata": "#/components/schemas/Metadata", + "move": "#/components/schemas/Move", + "toggle": "#/components/schemas/BlockAction" + }, + "propertyName": "type" + }, + "oneOf": [ + { + "$ref": "#/components/schemas/Metadata" + }, + { + "$ref": "#/components/schemas/EntryFields" + }, + { + "$ref": "#/components/schemas/BlockAction" + }, + { + "$ref": "#/components/schemas/Add" + }, + { + "$ref": "#/components/schemas/Move" + } + ], + "title": "Action" + }, + "etag": { + "maxLength": 80, + "minLength": 1, + "title": "Etag", + "type": "string" + }, + "revision": { + "default": 0, + "minimum": 0.0, + "title": "Revision", + "type": "integer" + }, + "source": { + "maxLength": 524288, + "title": "Source", + "type": "string" + } + }, + "required": [ + "source", + "etag", + "action" + ], + "title": "Transform", + "type": "object" + }, + "Workspace": { + "additionalProperties": false, + "properties": { + "collections": { + "items": { + "$ref": "#/components/schemas/CollectionRow" + }, + "title": "Collections", + "type": "array" + }, + "comparison_available": { + "default": false, + "title": "Comparison Available", + "type": "boolean" + }, + "issues": { + "items": { + "$ref": "#/components/schemas/IssueDTO" + }, + "title": "Issues", + "type": "array" + }, + "layouts": { + "items": { + "type": "string" + }, + "title": "Layouts", + "type": "array" + }, + "pages": { + "items": { + "$ref": "#/components/schemas/PageRow" + }, + "title": "Pages", + "type": "array" + }, + "paths": { + "additionalProperties": { + "type": "string" + }, + "title": "Paths", + "type": "object" + }, + "release": { + "$ref": "#/components/schemas/WorkspaceRelease" + }, + "site_name": { + "title": "Site Name", + "type": "string" + } + }, + "required": [ + "site_name", + "pages", + "collections", + "layouts", + "issues", + "paths" + ], + "title": "Workspace", + "type": "object" + }, + "WorkspaceRelease": { + "additionalProperties": false, + "properties": { + "built_at": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Built At" + }, + "current": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Current" + }, + "routes": { + "items": { + "type": "string" + }, + "title": "Routes", + "type": "array" + } + }, + "title": "WorkspaceRelease", + "type": "object" + } + }, + "securitySchemes": { + "InternalUiSession": { + "description": "Request-scoped server credential; never sent to the browser", + "scheme": "bearer", + "type": "http" + } + } + }, + "info": { + "title": "Site Engine Admin API", + "version": "1.0.0" + }, + "openapi": "3.1.0", + "paths": { + "/admin/api/v1/assets/{asset}": { + "get": { + "operationId": "asset_admin_api_v1_assets__asset__get", + "parameters": [ + { + "in": "path", + "name": "asset", + "required": true, + "schema": { + "title": "Asset", + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Asset" + } + }, + "/admin/api/v1/collections": { + "get": { + "operationId": "collections_admin_api_v1_collections_get", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "items": { + "$ref": "#/components/schemas/CollectionRow" + }, + "title": "Response Collections Admin Api V1 Collections Get", + "type": "array" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Collections" + } + }, + "/admin/api/v1/collections/{collection}/entries": { + "get": { + "operationId": "entry_list_admin_api_v1_collections__collection__entries_get", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "query", + "name": "q", + "required": false, + "schema": { + "default": "", + "title": "Q", + "type": "string" + } + }, + { + "in": "query", + "name": "status", + "required": false, + "schema": { + "default": "", + "title": "Status", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Entries" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry List" + }, + "post": { + "operationId": "entry_create_admin_api_v1_collections__collection__entries_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Create" + } + } + }, + "required": true + }, + "responses": { + "201": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Create" + } + }, + "/admin/api/v1/collections/{collection}/entries/{identity}/preview": { + "post": { + "operationId": "entry_preview_admin_api_v1_collections__collection__entries__identity__preview_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Preview" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Preview" + } + }, + "/admin/api/v1/collections/{collection}/entries/{identity}/save": { + "post": { + "operationId": "entry_save_admin_api_v1_collections__collection__entries__identity__save_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Save" + } + }, + "/admin/api/v1/collections/{collection}/entries/{identity}/source": { + "get": { + "operationId": "entry_source_admin_api_v1_collections__collection__entries__identity__source_get", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Source" + } + }, + "/admin/api/v1/collections/{collection}/entries/{identity}/transform": { + "post": { + "operationId": "entry_transform_admin_api_v1_collections__collection__entries__identity__transform_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Transform" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Transform" + } + }, + "/admin/api/v1/collections/{collection}/entries/{identity}/validate": { + "post": { + "operationId": "entry_validate_admin_api_v1_collections__collection__entries__identity__validate_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Validate" + } + }, + "/admin/api/v1/editor/entries/{collection}/{identity}/preview": { + "post": { + "operationId": "entry_preview_admin_api_v1_editor_entries__collection___identity__preview_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Preview" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Preview" + } + }, + "/admin/api/v1/editor/entries/{collection}/{identity}/save": { + "post": { + "operationId": "entry_save_admin_api_v1_editor_entries__collection___identity__save_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Save" + } + }, + "/admin/api/v1/editor/entries/{collection}/{identity}/source": { + "get": { + "operationId": "entry_source_admin_api_v1_editor_entries__collection___identity__source_get", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Source" + } + }, + "/admin/api/v1/editor/entries/{collection}/{identity}/transform": { + "post": { + "operationId": "entry_transform_admin_api_v1_editor_entries__collection___identity__transform_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Transform" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Transform" + } + }, + "/admin/api/v1/editor/entries/{collection}/{identity}/validate": { + "post": { + "operationId": "entry_validate_admin_api_v1_editor_entries__collection___identity__validate_post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Validate" + } + }, + "/admin/api/v1/editor/pages/{identity}/preview": { + "post": { + "operationId": "page_preview_admin_api_v1_editor_pages__identity__preview_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Preview" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Preview" + } + }, + "/admin/api/v1/editor/pages/{identity}/save": { + "post": { + "operationId": "page_save_admin_api_v1_editor_pages__identity__save_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Save" + } + }, + "/admin/api/v1/editor/pages/{identity}/source": { + "get": { + "operationId": "page_source_admin_api_v1_editor_pages__identity__source_get", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Source" + } + }, + "/admin/api/v1/editor/pages/{identity}/transform": { + "post": { + "operationId": "page_transform_admin_api_v1_editor_pages__identity__transform_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Transform" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Transform" + } + }, + "/admin/api/v1/editor/pages/{identity}/validate": { + "post": { + "operationId": "page_validate_admin_api_v1_editor_pages__identity__validate_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Validate" + } + }, + "/admin/api/v1/entries/{collection}": { + "get": { + "operationId": "entry_list_admin_api_v1_entries__collection__get", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + }, + { + "in": "query", + "name": "q", + "required": false, + "schema": { + "default": "", + "title": "Q", + "type": "string" + } + }, + { + "in": "query", + "name": "status", + "required": false, + "schema": { + "default": "", + "title": "Status", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Entries" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry List" + }, + "post": { + "operationId": "entry_create_admin_api_v1_entries__collection__post", + "parameters": [ + { + "in": "path", + "name": "collection", + "required": true, + "schema": { + "title": "Collection", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Create" + } + } + }, + "required": true + }, + "responses": { + "201": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Entry Create" + } + }, + "/admin/api/v1/pages": { + "get": { + "operationId": "page_list_admin_api_v1_pages_get", + "parameters": [ + { + "in": "query", + "name": "q", + "required": false, + "schema": { + "default": "", + "title": "Q", + "type": "string" + } + }, + { + "in": "query", + "name": "status", + "required": false, + "schema": { + "default": "", + "title": "Status", + "type": "string" + } + }, + { + "in": "query", + "name": "layout", + "required": false, + "schema": { + "default": "", + "title": "Layout", + "type": "string" + } + }, + { + "in": "query", + "name": "changed", + "required": false, + "schema": { + "default": false, + "title": "Changed", + "type": "boolean" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "items": { + "$ref": "#/components/schemas/PageRow" + }, + "title": "Response Page List Admin Api V1 Pages Get", + "type": "array" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page List" + }, + "post": { + "operationId": "page_create_admin_api_v1_pages_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Create" + } + } + }, + "required": true + }, + "responses": { + "201": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Create" + } + }, + "/admin/api/v1/pages/{identity}/preview": { + "post": { + "operationId": "page_preview_admin_api_v1_pages__identity__preview_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Preview" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Preview" + } + }, + "/admin/api/v1/pages/{identity}/save": { + "post": { + "operationId": "page_save_admin_api_v1_pages__identity__save_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Save" + } + }, + "/admin/api/v1/pages/{identity}/source": { + "get": { + "operationId": "page_source_admin_api_v1_pages__identity__source_get", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Source" + } + }, + "/admin/api/v1/pages/{identity}/transform": { + "post": { + "operationId": "page_transform_admin_api_v1_pages__identity__transform_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Transform" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Transform" + } + }, + "/admin/api/v1/pages/{identity}/validate": { + "post": { + "operationId": "page_validate_admin_api_v1_pages__identity__validate_post", + "parameters": [ + { + "in": "path", + "name": "identity", + "required": true, + "schema": { + "title": "Identity", + "type": "string" + } + } + ], + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Buffer" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Snapshot" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Page Validate" + } + }, + "/admin/api/v1/preview/{snapshot}/assets/{asset}": { + "get": { + "operationId": "preview_asset_admin_api_v1_preview__snapshot__assets__asset__get", + "parameters": [ + { + "in": "path", + "name": "snapshot", + "required": true, + "schema": { + "title": "Snapshot", + "type": "string" + } + }, + { + "in": "path", + "name": "asset", + "required": true, + "schema": { + "title": "Asset", + "type": "string" + } + }, + { + "in": "query", + "name": "token", + "required": false, + "schema": { + "default": "", + "title": "Token", + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Preview Asset" + } + }, + "/admin/api/v1/preview/{snapshot}/html": { + "get": { + "operationId": "preview_html_admin_api_v1_preview__snapshot__html_get", + "parameters": [ + { + "in": "path", + "name": "snapshot", + "required": true, + "schema": { + "title": "Snapshot", + "type": "string" + } + }, + { + "in": "query", + "name": "token", + "required": false, + "schema": { + "default": "", + "title": "Token", + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Preview Html" + } + }, + "/admin/api/v1/publish": { + "post": { + "operationId": "publish_site_admin_api_v1_publish_post", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Releases" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Publish Site" + } + }, + "/admin/api/v1/releases": { + "get": { + "operationId": "release_list_admin_api_v1_releases_get", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Releases" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Release List" + } + }, + "/admin/api/v1/rollback": { + "post": { + "operationId": "rollback_body_admin_api_v1_rollback_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Rollback" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Releases" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Rollback Body" + } + }, + "/admin/api/v1/rollback/{build_id}": { + "post": { + "operationId": "rollback_site_admin_api_v1_rollback__build_id__post", + "parameters": [ + { + "in": "path", + "name": "build_id", + "required": true, + "schema": { + "title": "Build Id", + "type": "string" + } + } + ], + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Releases" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Rollback Site" + } + }, + "/admin/api/v1/site": { + "get": { + "operationId": "site_admin_api_v1_site_get", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Workspace" + } + } + }, + "description": "Successful Response" + }, + "401": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unauthorized" + }, + "403": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Forbidden" + }, + "404": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Not Found" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "422": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Unprocessable Entity" + }, + "500": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Internal Server Error" + } + }, + "security": [ + { + "InternalUiSession": [] + } + ], + "summary": "Site" + } + } + } +} diff --git a/specs/001-antirion-admin/plan.md b/specs/001-antirion-admin/plan.md new file mode 100644 index 0000000..d02b0c0 --- /dev/null +++ b/specs/001-antirion-admin/plan.md @@ -0,0 +1,274 @@ +# Технический план 001 — Antirion Rework + +Дата: 2026-11-12. Статус: функциональная реализация проверена, визуальная приёмка открыта повторно. [Порядок переноса оригинальной вёрстки с проверкой пользователя](design-transfer.md). Действующие маршруты и запуск — [runtime.md](runtime.md); этот документ сохраняет этапы и обоснование архитектуры. + +Основание: [спецификация](spec.md). Учёт выполнения: [задачи](tasks.md). + +## 1. Подход и границы + +Выполнить два последовательных результата: сначала новое оформление существующей админки, затем сервисы и общий буфер редакторов с интерактивным превью. Контрольные точки обязательны перед переходом к следующему результату. + +Сохранить `core/`, `parsing/`, `storage/`, `services/`, `web/`, dataclass-модели и файловые контракты. Развивать существующие модули без переименования всего пакета в слои из предложенной структуры stage7. + +Один администратор остаётся в `AuthService`; контекст автора создаётся на сервере. SQLite/RBAC, новый release pipeline и MCP не являются зависимостями 001. + +Принять подход flexly-estimator: браузер/htmx → HTML UI FastAPI → серверный API-клиент → JSON API FastAPI → прикладные сервисы. `web/admin/api_client.py` предоставляет методы предметных операций; транспорт — `httpx.AsyncClient` с `ASGITransport(app=...)`. Сетевой порт для внутреннего вызова не требуется, но авторизация, сериализация и валидация FastAPI выполняются. Lifespan инициализирует зависимости один раз в основном приложении; ASGITransport не запускает его повторно. + +Пока выполняется оформление этапа B, допускается действующий прямой вызов сервисов из старых обработчиков. Этапы C–D переводят чтение данных и операции контента, превью и публикации на API-клиент. Аутентификация UI, загрузка локальной статики и рендер шаблонов остаются в UI. CLI и будущий MCP могут обращаться к сервисам напрямую. Отдельное развёртывание UI/API не требуется для 001; клиент изолирует транспорт для будущего расширения. + +## 2. Аудит и документация — этап A + +Сопоставить stage7 с `core/models.py`, `core/values.py`, `core/registry.py`, `core/draft_check.py`, `services/content.py`, `services/publish.py`, `web/admin/editor.py` и текущими тестами. В stage7 пометить каждую возможность как реализованную, доработку 001 или следующую очередь. + +Исправить примеры Page/Entry относительно схем сайта-примера: query wrapper, `richtext.content`, доступный layout и поля коллекции. При проверке примеров использовать временную копию сайта, а не рабочие данные. Сопоставить номера ADR и сохранить историю предложений. Не объявлять все предложенные ADR принятыми автоматически. + +Проверить актуальность AGENTS.md: HTML использует `etag`, сервис — `if_match`; принято направление htmx → UI → JSON API. Эти сведения уже зафиксированы. Описание интерактивного превью обновить после его реализации, сохранив требования к безопасности. + +Подготовить изолированное окружение через доступный `uv`, установить extras `server,dev` и средства browser QA. Выполнить исходные проверки и сохранить вывод. Если установка или тест недоступны, записать конкретную причину без объявления проверки успешной. + +**Выход:** актуальная матрица расхождений, проверяемые примеры, исходные результаты тестов, визуальные эталоны по выбранным HTML/CSS. + +## 3. Оформление рабочих экранов — этап B + +### 3.1. Runtime-ресурсы и шаблоны + +Разместить CSS/JS в `src/site_engine/web/admin/static/`, общие Jinja-компоненты и шаблоны — в `web/admin/templates/`. Согласовать токены Antirion из shell, builder и publication; стили отдельных экранов ограничить их контейнерами, чтобы правила таблиц и форм не конфликтовали. + +Общие компоненты: shell, боковое меню, верхняя панель, заголовок, статус, таблица, поле формы, диагностика, пустое состояние, диалог и уведомление. JS подключать внешним локальным файлом; inline event handlers и inline-стили прототипа перенести в разрешённые механизмы. + +Светлая палитра — исходная; предусмотренное Antirion переключение светлой/тёмной палитры реализовать общими токенами. Хранить только UI-предпочтение. Скругления/палитру Rose Graphite не переносить. + +Сохранить обычные формы и полноценную навигацию до внедрения новых редакторов. Статические ресурсы выдаются по allowlist с корректными MIME. Уточнить package-data для вложенных partials и будущих ресурсов превью; установленный пакет не читает `design/`. + +`static/htmx.min.js` версии 2.0.11 уже перенесён побайтно из flexly-estimator; источник, лицензия 0BSD и SHA-256 находятся в `static/VENDOR.md`. Для обновления проверять новый дистрибутив и обновлять запись; установка Node и загрузка CDN в runtime не нужны. Эта поставка не закрывает задачи нового редактора или API. + +### 3.2. Представления и данные + +Последовательно перенести вход, обзор, списки, формы Page/Block/Entry, публикацию, сообщения и пустые состояния. У входа нет отдельного прототипа: использовать те же токены и компоненты формы без копирования shell защищённого раздела. + +Данные получать из Registry и действующих сервисов. Добавить эффективный layout, файл, число блоков, статусы и current build. Поиск/фильтры реализовать через GET-параметры `q`, `status`, `layout` (последний только для Page). Неверные значения фильтра не расширяют доступ и отображаются как ошибка запроса. Выбранный объект идентифицируется по проверенному ID; отсутствие выбора даёт пустой инспектор. + +Счётчики «изменено относительно live», diff, время/автор релиза показываются только при наличии реальных данных. В 001 не вычислять их из вымышленных seed-моделей или времени изменения файлов. Новые разделы прототипа до реализации получают объяснение недоступности, без маршрутов фиктивного CRUD. + +`/admin/publish` продолжает выполнять существующие publish/rollback. Добавить подтверждение действия и реальные состояния успеха/ошибки. Кандидат релиза не появляется до спецификации 002. + +### 3.3. Исправления интеграции + +- Для существующего iframe явно добавить `frame-src 'self'`, сохранив ограничения `frame-ancestors` админки и sandbox превью. +- Для пассивного превью предоставить авторизованную раздачу ассетов workspace из разрешённого `assets/` с safe path, nosniff и ограничивающим CSP. Обновить URL в preview-рендере и CSS, включая вложенные ссылки ресурсов; публичная сборка сохраняет `/assets/...`. +- Поддержать бинарные ответы ассетов, не декодируя изображение как текст. +- При 422 повторно отрисовывать переданные значения; при 409 сохранить пользовательские поля и предоставить текущую версию без автоматического повторного POST. + +**Контрольная точка B:** AC-01, AC-08, AC-09 и упаковочная часть AC-10. Оформление не блокируется отсутствием отдельного preview origin: на этом этапе используется безопасное пассивное превью. + +## 4. Прикладные сервисы и запись — этап C + +### 4.1. Разделение ответственности + +| Слой | Ответственность | +|---|---| +| UI-роутер | Request/FormData, cookie, Origin/CSRF, вызов серверного API-клиента | +| Обработчик UI | Сбор представления и partials из DTO API, статусы/редиректы, введённые значения | +| API-клиент UI | Преобразование полей формы в JSON DTO, внутренний авторизованный вызов, разбор DTO/ошибок | +| JSON API FastAPI | Явные маршруты и Pydantic DTO, проверенный автор, HTTP-коды и общий формат ошибок; без Jinja и HX-веток | +| PageService / EntryService | Проверенный объект, создание/чтение, операции буфера, validation, сохранение и аудит | +| ContentService / storage | Разрешённый путь, один lock, CAS, история, атомарная запись | +| Core | Схемы, разбор/разрешение значений, дерево, валидация и рендер | + +Добавить `services/pages.py`, `services/entries.py` и общий модуль результатов редактора при необходимости. Формы `p.*` остаются представлением; прикладной сервис получает разобранные значения и не зависит от Request или Jinja. + +UI-роутеры, использующие AsyncClient, выполняются как `async def` и ожидают API-клиент. Из прежнего EditorHandlers выделить сборку представлений из DTO; не запускать отдельный event loop на каждый вызов и не выполнять вложенный синхронный HTTP-запрос к тому же uvicorn-процессу. + +### 4.2. Внутренние контракты + +Использовать dataclass-результаты, сохраняя существующий Report/Issue: + +| Контракт | Обязательные данные | +|---|---| +| DocumentSnapshot | Тип Page/Entry, логический ID, относительный путь, исходник, модель, ETag, Report | +| EditorContext | Проверенный Principal, IP/источник операции для аудита; создаётся адаптером | +| BufferResult | Текущий исходник, последняя корректная модель или диагностика ошибки, ETag основы, номер редакции UI | +| SaveResult | Сохранённый снимок и новый ETag | +| ConflictResult | Переданный исходник, ETag основы и текущий серверный снимок | +| PreviewResult | URL ограниченного снимка, срок действия, номер редакции UI | + +Общие возможности сервисов: `get`, `create`, `validate_source`, `transform_buffer`, `save_source`. PageService также применяет операции с блоками; EntryService проверяет поля коллекции. Превью использует тот же разобранный документ/Report, а не отдельный browser codec. + +### 4.3. Транзакционная граница одного файла + +В ContentService добавить операцию обновления с владельцем блокировки. Под одним SiteLock: проверить путь → перечитать байты → проверить if_match/ABSENT → загрузить актуальную схему → подготовить изменение → проверить → сохранить предыдущую версию → atomic_write. Отдельная точка входа записывает уже подготовленный исходник через тот же цикл. + +Не вызывать публичный `write`, повторно захватывающий SiteLock, из участка с уже удерживаемой блокировкой. Старый интерфейс ContentService сохранить или адаптировать совместимо с тестами и текущими вызовами. + +При отказе до записи история и канонический файл не меняются. Аудит успешной операции формируется сервисом однократно, без второго события из старого обработчика. Ошибки журналирования не маскировать под успешное завершение; клиенту не предлагать слепой повтор с прежним ETag после уже состоявшейся записи. + +**Выход:** JSON API вызывает общие сервисы, старый UI переводится на API-клиент; существующие тесты сохраняют семантику, два писателя не теряют изменения. + +### 4.4. JSON-контракт и внутренний клиент + +Разместить API-роутеры, схемы и зависимости в `src/site_engine/web/api/`; HTML-маршруты остаются в `web/admin/`. Добавить `httpx` в extra `server`, поскольку это runtime-зависимость API-клиента, а не только средство тестирования. Ядро и сервисные результаты остаются dataclass; Pydantic-модели на HTTP-границе явно преобразуются в них и обратно. Использовать `response_model` или аннотированные модели ответов, а не произвольные dict. + +Префикс API — `/admin/api/v1/`. UI сохраняет существующие URL и префикс `/admin/editor/` для HTML-фрагментов. Объявить API- и UI-маршруты до существующего catch-all редактора и до раздачи публичного сайта. Не подменять JSON на HTML при наличии HX-Request. + +| Операция | JSON API | +|---|---| +| Обзор и доступные коллекции | `GET /admin/api/v1/site`, `GET /admin/api/v1/collections` | +| Списки/создание документов | `GET/POST /admin/api/v1/pages`, `GET/POST /admin/api/v1/entries/{collection}` | +| Снимок Page | `GET /admin/api/v1/editor/pages/{id}/source` | +| Буфер Page | `POST /admin/api/v1/editor/pages/{id}/{transform,validate,save,preview}` | +| Снимок Entry | `GET /admin/api/v1/editor/entries/{collection}/{slug}/source` | +| Буфер Entry | `POST /admin/api/v1/editor/entries/{collection}/{slug}/{transform,validate,save,preview}` | +| Релизы и текущая публикация | `GET /admin/api/v1/releases` | +| Текущие publish/rollback | `POST /admin/api/v1/publish`, `POST /admin/api/v1/rollback` | + +Фигурная группа действий обозначает отдельный явный маршрут для каждого действия. Вложенные ID Page с `/` поддерживаются и проверяются по Registry; маршрут не принимает произвольный файловый путь. Списки принимают те же q/status/layout, что UI. Create возвращает 201 и DocumentSnapshot; чтение/transform/validate/save/preview — 200 с соответствующим DTO. Publish/rollback возвращают фактический результат действующих сервисов без нового candidate pipeline. + +DTO запросов буфера: `source`, `etag`, `revision`; transform дополнительно содержит дискриминированное типизированное `action`. `revision` — неотрицательное целое, возвращаемое без изменения, `etag` — прежний непрозрачный маркер версии. Схемы запрещают неизвестные служебные поля; пользовательские props проверяет действующая схема фрагмента/коллекции. В JSON не передаются csrf, Principal или произвольный путь записи. + +Ответы соответствуют DocumentSnapshot/BufferResult/SaveResult/ConflictResult/PreviewResult из раздела 4.2. Модель документа передаёт только сериализуемые разрешённые данные, включая типы значений и дерево; Python-объекты и пути вне сайта не выдаются. Ошибка имеет форму `error: {code, message, issues, revision}`; issue содержит code, message и field/path, если применимо. Для 409 дополнительно передаются `submitted_source`, `base_etag`, `current` (DocumentSnapshot). Для ошибок схемы запроса и предметной валидации использовать один envelope, сохраняя различимые коды. + +HTTP-статусы: 401 — нет действительных внутренних credentials, 403 — запрещённая операция, 404 — объект отсутствует, 409 — конфликт, 422 — недопустимый запрос/документ. Недопустимый буфер validate возвращает 422 с диагностикой; валидный неполный draft — 200 с предупреждениями. Ошибки 5xx не содержат трассировки; UI сохраняет введённые данные, сообщает о сбое и не выполняет альтернативную запись напрямую. + +Pydantic-схемы служат источником OpenAPI. Добавить воспроизводимую выгрузку схемы для CI; доступ к HTTP-схеме `/admin/api/v1/openapi.json` и документации `/admin/api/v1/docs` разрешить только проверенной админской сессии. Скрытие docs не заменяет авторизацию API. Тесты проверяют маршруты, модели успешных ответов, envelope ошибок и версию контракта; не требуется отдельная сборка TypeScript-клиента. + +### 4.5. Автор и авторизация между UI и API + +UI сначала проверяет действующую cookie, Origin и CSRF, включая validate/transform/preview без канонической записи. API принимает только серверные credentials, связанные с проверенным администратором, сессией и auth epoch. Наличие /admin в URL или заголовка HX-Request не даёт доступа; одна cookie браузера не авторизует JSON API. + +Внутренние токены создаёт сервер после проверки сессии, хранит в памяти процесса и ограничивает сроком этой сессии. ASGITransport вызывает тот же экземпляр приложения. Logout/изменение эпохи и истечение сессии проверяются на API-границе, не только в UI; после перезапуска прежние внутренние токены недействительны. Клиент передаёт авторизованный audit-контекст; login/epoch/IP нельзя брать из полей формы или копировать из произвольных входящих заголовков. Токены, cookie и исходник не попадают в журналы запросов. + +API-ключ не включается в HTML, JS, URL или browser storage. В 001 не добавлять внешние API-ключи, scopes или настройки внешнего деплоя UI: это отдельное развитие. Файловые операции и рендер остаются синхронными; JSON-адаптер выполняет их в пуле потоков, не блокируя event loop вложенного ASGI-вызова. + +## 5. Буфер и редакторы — этап D + +### 5.1. Жизненный цикл + +```text +GET документа → source + base_etag + корректная модель + → изменение поля / исходника + → server validate/transform → новый буфер, прежний base_etag + → preview → временный результат, прежний base_etag + → явное Save → CAS + validation + history + write + → новый source + новый base_etag, буфер отмечен сохранённым +``` + +Состояния UI: сохранён, есть несохранённые правки, проверяется, ошибка исходника, сохраняется, конфликт. Полнота для публикации показывается отдельно от допустимости сохранения draft. Проверка без правок не меняет dirty-состояние. + +При переключении режима валидный source становится представлением той же модели. Невалидный source остаётся в «Эксперте»; доступны исправление, скачивание текста и явный отказ от правок. Без пользовательского действия не возвращать другую версию документа. При внутреннем переходе к другому документу подтверждать потерю несохранённых правок через окно интерфейса. Не использовать нативные alert/confirm/prompt и beforeunload-диалоги; отдельного подтверждения пересборки YAML нет. + +### 5.2. HTTP-интерфейс + +Существующие страницы `/admin/pages/{id}` и `/admin/content/{collection}/{slug}` сохраняются. В новом редакторе GET-параметр `mode=constructor|expert` задаёт представление; значение по умолчанию — constructor. + +Добавить внутренние endpoints под отдельным префиксом, чтобы вложенный ID Page не конфликтовал с прежней адресацией: + +| Действие | Page | Entry | +|---|---|---| +| Получить исходник | `GET /admin/editor/pages/{id}/source` | `GET /admin/editor/entries/{collection}/{slug}/source` | +| Изменить буфер | `POST /admin/editor/pages/{id}/transform` | `POST /admin/editor/entries/{collection}/{slug}/transform` | +| Проверить | `POST /admin/editor/pages/{id}/validate` | `POST /admin/editor/entries/{collection}/{slug}/validate` | +| Сохранить | `POST /admin/editor/pages/{id}/save` | `POST /admin/editor/entries/{collection}/{slug}/save` | +| Подготовить превью | `POST /admin/editor/pages/{id}/preview` | `POST /admin/editor/entries/{collection}/{slug}/preview` | + +Это HTML-маршруты UI. Каждый вызывает одноимённую операцию JSON API из раздела 4.4 через серверный клиент; UI не обращается к Registry/ContentService для выполнения этих операций. Все POST UI требуют существующие сессию, проверку источника и `csrf`, включая операции без записи. Общие поля формы: `source`, `etag`, `revision` (номер изменения в UI); transform также передаёт типизированное действие и его значения. ID с `/` разбирается как логический ID Page и сверяется с реестром на API/сервисной границе до доступа к файлу. + +Типы transform: метаданные Page, поля/статус/Markdown Entry, props/настройки блока, add/delete/toggle/move блока. Для перемещения использовать ID и `before`/`after` внутри указанного региона/слота; сохранять проверку allow, fixed, предельной вложенности и отсутствия циклов. Кнопки порядка остаются доступны с клавиатуры; drag-and-drop не является отдельным требованием 001. + +HTML-ответы UI: 200 — partials и актуальное состояние буфера; успешный Save — сохранённое состояние (для полной формы допустим 303); 409 — панель сравнения с обеими версиями; 422 — исходник и диагностика. Остальные коды сохраняют смысл действующей админки. JSON API предназначен серверному клиенту UI; анонимный/внешний API не открывается. + +Частичные ответы включают согласованные дерево, инспектор, исходник, диагностику и статус. Каждому ответу соответствует revision; устаревшие ответы игнорируются. Отправка Save блокирует конкурирующее повторное нажатие, но отказ сети сохраняет буфер и позволяет проверить серверную версию перед повтором. + +### 5.3. Реализация UI и конфликтов + +Использовать поставленную локальную версию htmx с лицензионным уведомлением. Настройки `allowEval=false`, `allowScriptTags=false`, `selfRequestsOnly=true`, `includeIndicatorStyles=false`, `historyCacheSize=0` задавать без inline JS, не использовать inline hx-on. История htmx не должна сохранять HTML с контентом/CSRF в localStorage. Разрешить подстановку ожидаемых 409/422: htmx по умолчанию их не подставляет. UI задаёт HX-Retarget/HX-Reswap для области диагностики или панели конфликта, а не заменяет редактор общей страницей ошибки. Сбой 5xx/сети сохраняет буфер и отображается внешним JS. + +Для истёкшей сессии UI возвращает HX-Redirect на вход при htmx-запросе и 303 при обычной навигации. Нельзя молча заменить инспектор HTML-формой входа; перед потерей dirty-буфера предложить скачивание исходника. После Save обновлять состояние редактора без обязательного полного перехода страницы, который используется в estimator. Основные операции сохранения доступны обычной формой; интерактивное превью требует JS. + +Небольшой внешний JS-модуль отвечает за буфер, debounce/порядок запросов, защиту от устаревших revision, dirty-состояние, фокус/выделение и postMessage превью. htmx отвечает за отправку форм и подстановку согласованных HTML-фрагментов, в том числе OOB для дерева/статуса при необходимости. Буфер не пересоздаётся при замене инспектора. + +Сохранить текущие лимиты YAML; запретить повтор ключа вместо молчаливой перезаписи SafeLoader. Валидатор исходника использует те же ограничения, что Конструктор. Не допускать изменение Entry.slug или запись по пути из тела формы. Неподдерживаемый ключ не отбрасывается для получения формально успешного сохранения. + +409 не меняет буфер и base_etag. Панель сравнивает пользовательский текст с текущим source; действия — принять серверную версию либо вручную объединить и явно подтвердить использование новой основы. После этого повторный Save снова проходит CAS; третье изменение на сервере вновь даёт 409. + +**Контрольная точка D:** AC-02–AC-05. Проверять Page с вложенными слотами и привязками, а также Entry со схемой коллекции и Markdown. + +## 6. Интерактивное превью — этап E + +### 6.1. Конфигурация и развёртывание + +Добавить проверяемые полные URL-origin `SITE_ADMIN_ORIGIN` и `SITE_PREVIEW_ORIGIN`: схема, host и необязательный порт без пути/query/fragment. Для интерактивного режима оба обязательны и различаются. В production использовать HTTPS; локально допустим HTTP на loopback. + +Локальный пример: admin `http://localhost:8000`, preview `http://localhost:8001`. Production-пример: `https://cms.example.com` и `https://preview.example.com`. Origin включает порт; CORS-доступ к админке для preview не открывать. + +Добавить отдельную фабрику приложения превью, запускаемую вторым uvicorn-процессом или отдельным контейнером того же образа. Она читает только подготовленные артефакты и необходимые параметры проверки токена/эпохи, без подключения admin router. Preview-контейнеру достаточно read-only доступа к каталогу подготовленных снимков и auth epoch; исходники сайта и возможность их записи ему не требуются. + +При неполной конфигурации новые редакторы сохраняют возможность работы и пассивное превью; интерактивный режим показывает недоступность с причиной конфигурации. Для закрытия этапа E требуется рабочая проверка на двух origin. + +### 6.2. Снимок и токен + +В авторизованном основном приложении разобрать буфер, наложить документ на временное представление Registry и отрендерить HTML. Копирование изменённой Page/Entry в канонический каталог для превью запрещено. Подготовить необходимые ассеты и зависимые CSS-ресурсы из workspace в служебном `SITE_STATE_DIR/preview/`. + +Снимок после выдачи URL неизменяем. Он содержит HTML, ассеты, карту разрешённых блоков, revision, срок и служебные данные авторизации. Токен — криптографически случайный идентификатор с подписью; подпись использует отдельный производный ключ, отличный от назначения подписи сессий. Срок — 600 секунд, токен привязан к одному снимку и текущему auth epoch. + +Проверять доступ к HTML и каждому ассету. Токены/исходники не записывать в аудит и диагностические сообщения; журнал доступа к preview должен маскировать токен в URL. Удалять просроченные/незавершённые артефакты при обслуживании основным приложением и при запуске. Ограничить число сохранённых снимков одного документа одной сессии последними 20; удалённый снимок корректно отвечает отказом доступа, редактор может запросить новый. + +### 6.3. Браузерная изоляция + +В iframe использовать sandbox `allow-scripts allow-same-origin` только при гарантированно отдельном origin. Это сохраняет проверяемый origin сообщений; сочетание этих разрешений для same-origin превью запрещено. Формы, popups и top navigation не разрешаются. + +CSP preview: разрешён только служебный скрипт с nonce, собственные подготовленные изображения/шрифты и стили рендера; код сайта не включается в JS-бандл превью. `frame-ancestors` ограничен SITE_ADMIN_ORIGIN, `form-action 'none'`, `base-uri 'none'`, `Referrer-Policy: no-referrer`, `Cache-Control: no-store`, nosniff. `X-Frame-Options: SAMEORIGIN` на cross-origin preview не переносится. Админка разрешает frame-src только собственный origin для пассивного превью и настроенный preview origin. + +### 6.4. Маркировка и протокол + +Добавить явный preview-mode Renderer, по умолчанию выключенный. Идентификатор блока включает область page/layout/display, владельца и локальный block ID. Маркировка не добавляет контейнеров, меняющих layout. Для fixed/display-блока действие выбора возвращает read-only инспектор. + +Минимальные сообщения: + +| Направление | Типы | Назначение | +|---|---|---| +| Preview → admin | ready, select, viewport | Готовность, выбранный блок, положение/размер viewport | +| Admin → preview | highlight, navigate, restore | Выделение, переход по выбору дерева, восстановление позиции | + +Сообщение содержит ID снимка, revision и разрешённый идентификатор блока, если нужен. Обе стороны проверяют origin, source окна, структуру, текущий снимок и допустимый тип. Не использовать wildcard targetOrigin. Предварительный обмен ready инициируется preview в известный admin origin. + +При refresh сохранить viewport через служебный скрипт; после ready нового снимка восстановить положение и выделение. Навигацию к новому месту выполнять для явного выбора/добавления/перемещения, а не на каждое изменение поля. Учитывать reduced motion. Ответ предыдущей revision не заменяет свежую. + +**Контрольная точка E:** AC-06, AC-07 и публичная часть AC-10/FR-17. + +## 7. Проверки и поставка — этап F + +| Уровень | Обязательная проверка | +|---|---| +| Существующие тесты | Ядро, сборка, routes, auth, редактор, формы, история, конфликты и упаковка | +| Сервисы | Общая валидация, один lock без deadlock, CAS двух писателей, отказ без записи/истории, аудит один раз | +| Буфер | Page/Entry round-trip, вложенные слоты, refs/query, ошибки YAML/дубли, режимы, сохранение всего документа | +| JSON API | Реальные маршруты и Pydantic request/response, OpenAPI, envelope ошибок, недействительные credentials/epoch, проверенный автор, UI использует ASGITransport без обхода API | +| HTTP/UI | Реальный FastAPI: cookie/CSRF/Origin, старые и новые маршруты, вложенные ID, HTML отдельно от JSON, 409/422 с вводом, binary assets | +| Preview security | Два origin, срок/подпись/эпоха токена, подмена снимка, traversal/symlink, spoofed messages, отсутствие admin/login | +| Browser | Настоящий htmx: partial swap, CSRF, 409/422, HX-Redirect и отсутствие API-ключа; dirty-buffer, конфликт, selection/scroll, быстрые правки, истечение токена, недоступность preview | +| Visual/accessibility | Заданные ширины, клавиатура, focus, диалоги, статусы, палитры, reduced motion | +| Packaging/build | Wheel, запуск из установленного пакета, CLI validate/build и отсутствие служебного preview-кода в публичном HTML | + +Команды существующей проверки после подготовки окружения, из корня репозитория: + +```bash +PYTHONPATH=src python -m unittest discover -s tests -v +PYTHONPATH=src python -m site_engine.cli validate examples/studio-site +PYTHONPATH=src python -m site_engine.cli build examples/studio-site --out /tmp/studio-dist +``` + +HTTP/browser-проверки добавляются как воспроизводимые dev-команды; файлы тестов и зависимости включить в документацию. Сохранять снимки/логи QA отдельно от канонического сайта. В отчёте различать выполненные, упавшие и недоступные проверки. Результаты выполненной приёмки приведены в [verification.md](verification.md), действующий контракт и запуск — в [runtime.md](runtime.md). + +Этап B можно проверять и принимать до новых редакторов. Этап D принимается после сервисов C; завершение 001 требует E и F. Контентная миграция и миграция БД для 001 не нужны. Перед первым реальным сохранением новой версией редактора сделать резервную копию тестируемого сайта; deployment сначала проверить на его копии. + +## 8. Следующая очередь спецификаций + +| Номер | Направление | Доработка и результат приёмки | +|---|---|---| +| 002 | Релизы | Разделить build/publish; immutable candidate, manifest/hashes, diff, expected_live под общей блокировкой, безопасные повторы; сбой не меняет live, rollback не затирает workspace | +| 003 | Медиа, структура, настройки | Безопасная загрузка, файловые metadata, where-used, changeset с recovery до rename, меню/redirect/site/data/theme; перенос каталога не теряет метаданные | +| 004 | Доступы и журнал | Пользователи, разрешения, миграции SQLite, сессии и audit UI; отказ прав проверяется сервисом, а не видимостью кнопки | +| 005 | Заявки и outbox | Версия формы, submission+outbox одной транзакцией, Telegram/retry, PII grants; сбой доставки не теряет заявку и rollback сохраняет совместимость | +| 006 | MCP | Те же сервисы и ошибки, узкие scopes, TTL/revoke, draft-only; отсутствие publish grant исключает публикацию | + +Это очередность отдельных работ. Их контракты и задачи не считаются реализованными или полностью специфицированными пакетом 001. diff --git a/specs/001-antirion-admin/qa-results.json b/specs/001-antirion-admin/qa-results.json new file mode 100644 index 0000000..48d4183 --- /dev/null +++ b/specs/001-antirion-admin/qa-results.json @@ -0,0 +1,442 @@ +{ + "date": "2026-11-12", + "unit_tests": 248, + "responsive": { + "widths": [ + [ + "overview", + 1440 + ], + [ + "overview", + 1280 + ], + [ + "overview", + 1024 + ], + [ + "overview", + 768 + ], + [ + "overview", + 390 + ], + [ + "overview", + 360 + ], + [ + "pages", + 1440 + ], + [ + "pages", + 1280 + ], + [ + "pages", + 1024 + ], + [ + "pages", + 768 + ], + [ + "pages", + 390 + ], + [ + "pages", + 360 + ], + [ + "page", + 1440 + ], + [ + "page", + 1280 + ], + [ + "page", + 1024 + ], + [ + "page", + 768 + ], + [ + "page", + 390 + ], + [ + "page", + 360 + ], + [ + "block", + 1440 + ], + [ + "block", + 1280 + ], + [ + "block", + 1024 + ], + [ + "block", + 768 + ], + [ + "block", + 390 + ], + [ + "block", + 360 + ], + [ + "collections", + 1440 + ], + [ + "collections", + 1280 + ], + [ + "collections", + 1024 + ], + [ + "collections", + 768 + ], + [ + "collections", + 390 + ], + [ + "collections", + 360 + ], + [ + "entries", + 1440 + ], + [ + "entries", + 1280 + ], + [ + "entries", + 1024 + ], + [ + "entries", + 768 + ], + [ + "entries", + 390 + ], + [ + "entries", + 360 + ], + [ + "entry", + 1440 + ], + [ + "entry", + 1280 + ], + [ + "entry", + 1024 + ], + [ + "entry", + 768 + ], + [ + "entry", + 390 + ], + [ + "entry", + 360 + ], + [ + "publish", + 1440 + ], + [ + "publish", + 1280 + ], + [ + "publish", + 1024 + ], + [ + "publish", + 768 + ], + [ + "publish", + 390 + ], + [ + "publish", + 360 + ], + [ + "constructor-dark", + 1440 + ], + [ + "constructor-dark", + 1280 + ], + [ + "constructor-dark", + 1024 + ], + [ + "constructor-dark", + 768 + ], + [ + "constructor-dark", + 390 + ], + [ + "constructor-dark", + 360 + ], + [ + "expert-dark", + 1440 + ], + [ + "expert-dark", + 1280 + ], + [ + "expert-dark", + 1024 + ], + [ + "expert-dark", + 768 + ], + [ + "expert-dark", + 390 + ], + [ + "expert-dark", + 360 + ] + ], + "screens": [ + "overview", + "pages", + "page", + "block", + "collections", + "entries", + "entry", + "publish" + ], + "console_errors": [] + }, + "editor": { + "checks": [ + "site_scripts_blocked", + "feature_hidden_not_rendered", + "separate_origin_preview", + "fixed_readonly_inspector", + "preview_to_tree", + "constructor_no_write", + "unsaved_preview", + "workspace_asset", + "tree_scroll_and_viewport_restore", + "mode_roundtrip", + "explicit_save", + "two_tab_conflict_explicit_rebase", + "invalid_expert_preserved", + "entry_buffer_save", + "exact_crlf_source", + "stale_preview_rejected", + "network_error_preserves_buffer", + "message_boundaries_checked", + "forged_messages_rejected", + "no_content_storage", + "publish_public_html", + "rollback_preserves_workspace", + "ordinary_form_without_js", + "session_expiry_download", + "internal_credentials_never_in_browser" + ], + "js_errors": [] + }, + "stage7": { + "errors": 0, + "warnings": 0, + "built_pages": 7 + }, + "wheel": "installed outside checkout, design/ absent; API, templates, static, separate preview passed", + "visual_acceptance": { + "status": "reopened_after_user_review", + "plan": "design-transfer.md", + "current_stage": "3_page_builder", + "stage_status": "ready_for_user_review", + "stage_1": "accepted_by_user", + "other_screens": "stages_4_to_5_pending", + "browser_report": "/tmp/site-engine-builder-001/report.json", + "component_comparisons": 12, + "browser_flow_groups": 12, + "themes": [ + "light", + "dark" + ], + "widths": [ + 1440, + 1280, + 1024, + 768, + 390, + 360 + ], + "shell_regression": "/tmp/site-engine-shell-001/report.json", + "shell_comparisons": 12, + "shell_flows": 6, + "editor_regression_checks": 25, + "unexpected_browser_errors": [], + "stage_2": "accepted_by_user", + "expert_component_comparisons": 6, + "regression_test_count": 248, + "pages_regression": "/tmp/site-engine-pages-001/report.json", + "pages_comparisons": 24, + "pages_flow_groups": 6 + }, + "builder": { + "browser": { + "name": "chromium", + "version": "158.0.8127.18" + }, + "comparisons": 12, + "expert_comparisons": 6, + "flows": [ + "pristine_mode_roundtrip_restores_preview_and_toolbar", + "invalid_fields_retained_save_stopped_correction_and_real_asset_picker", + "auto_apply_focus_caret_preview_and_selection_flush", + "device_retained_after_preview_refresh", + "binding_picker_preserves_typed_source", + "duplicate_selects_new_id_delete_is_memory_only", + "catalog_filters_click_inserts_schema_defaults_no_file_write", + "drag_drop_real_reordering", + "save_flushes_pending_fields_without_publish", + "explicit_server_format_does_not_save_file", + "expert_source_diff_reset_dialog_focus", + "data_map_and_binding_inspector" + ], + "js_errors": [], + "artifacts": "/tmp/site-engine-builder-001" + }, + "builder_firefox": { + "browser": { + "name": "firefox", + "version": "142.0.1" + }, + "comparisons": 12, + "expert_comparisons": 6, + "flows": [ + "pristine_mode_roundtrip_restores_preview_and_toolbar", + "invalid_fields_retained_save_stopped_correction_and_real_asset_picker", + "auto_apply_focus_caret_preview_and_selection_flush", + "device_retained_after_preview_refresh", + "binding_picker_preserves_typed_source", + "duplicate_selects_new_id_delete_is_memory_only", + "catalog_filters_click_inserts_schema_defaults_no_file_write", + "drag_drop_real_reordering", + "save_flushes_pending_fields_without_publish", + "explicit_server_format_does_not_save_file", + "expert_source_diff_reset_dialog_focus", + "data_map_and_binding_inspector" + ], + "js_errors": [], + "artifacts": "/tmp/site-engine-builder-firefox-001" + }, + "live_style_check": { + "direct": true, + "server_modified": false, + "content_modified": false, + "chromium_checks": 42, + "firefox_checks": 42, + "screenshot_page": "/admin/pages/services/index", + "artifacts": "/tmp/cms-live-inspect" + }, + "selection": { + "chromium": { + "runs": [ + { + "interactive_bridge": false, + "selection_posts": 0, + "no_file_write": true, + "navigation_modals": true, + "native_dialogs": [], + "errors": [] + }, + { + "interactive_bridge": true, + "selection_posts": 0, + "no_file_write": true, + "navigation_modals": true, + "native_dialogs": [], + "errors": [] + } + ], + "browser": { + "name": "chromium", + "version": "158.0.8127.18" + } + }, + "firefox": { + "runs": [ + { + "interactive_bridge": false, + "selection_posts": 0, + "no_file_write": true, + "navigation_modals": true, + "native_dialogs": [], + "errors": [] + }, + { + "interactive_bridge": true, + "selection_posts": 0, + "no_file_write": true, + "navigation_modals": true, + "native_dialogs": [], + "errors": [] + } + ], + "browser": { + "name": "firefox", + "version": "142.0.1" + } + }, + "artifacts": [ + "/tmp/site-engine-selection-001", + "/tmp/site-engine-selection-firefox-001" + ], + "deployed_to_user_server": false, + "fixture": "isolated copy; unreadable working pages/index.md replaced with Git HEAD version; workspace unchanged" + } +} diff --git a/specs/001-antirion-admin/runtime.md b/specs/001-antirion-admin/runtime.md new file mode 100644 index 0000000..c24dd0f --- /dev/null +++ b/specs/001-antirion-admin/runtime.md @@ -0,0 +1,120 @@ +# Работающий контракт 001 + +## Редактор и файлы + +Начальный режим — Конструктор. «Применить к буферу» меняет исходник в памяти открытой вкладки; «Сохранить документ» записывает его целиком. Проверка и превью не создают историю контента и не меняют `current`. Публикация отдельно собирает и переключает релиз. В Entry редактируются поля коллекции и Markdown; layout/display доступны для чтения. + +«Эксперт» хранит точный исходник. Переход между режимами без правок не пересобирает YAML; сохранение без изменений сохраняет в том числе CRLF и комментарии. Конструктор предупреждает о пересборке YAML перед первой операцией. До неё можно скачать исходник. Неприменимый YAML остаётся в «Эксперте», последнее корректное дерево доступно для просмотра. В localStorage попадают только тема и ширина навигации; HTML-кеш htmx отключён. + +При 409 доступны отправленная и серверная версии. Внесите слияние в «Эксперте», явно примите показанную серверную версию как основу, затем нажмите Save. Принятие основы не записывает файл. Повторный конфликт обрабатывается так же. При 422, сетевой ошибке или истечении сессии текст остаётся во вкладке и доступен для скачивания. После нового входа можно открыть документ и перенести скачанные правки. Закрытие браузера не является сохранением буфера. + +## HTML и JSON + +Обзор и список Page используют проекцию `Workspace`: страницы, проверки, `release` (current/built_at/routes) и `comparison_available`. `PageRow` включает изменённость файла относительно LIVE, время файла, SEO-описание, относящиеся к странице issues и наличие маршрута на LIVE. Фильтр `changed=true` у JSON `/pages` соответствует HTML-вкладке «Изменённые» (`changed=1`). + +Новые сборки содержат `page_sources` — SHA-256 опубликованных файлов Page. Старый manifest без индекса означает неизвестное сравнение (`changed=null`), а не отсутствие правок. Сравниваются файлы Page; зависимости layout/fragment/assets/коллекций не входят в этот счётчик. Откат меняет базу сравнения вместе с `current`. Создание draft возвращает HTML UI в список с выбранной страницей; публикация остаётся отдельным действием. + +```text +browser/htmx → /admin/... (HTML) + → AdminApi/httpx.ASGITransport + → /admin/api/v1/... (JSON, Pydantic) + → PageService/EntryService → ContentService → files +``` + +Рабочий runtime подключает `AdminApplication`; прежние независимые `AdminHandlers`/`EditorHandlers` сохранены для совместимости. Контент, диагностика, списки, превью и публикация runtime проходят через API. Вход, cookie/CSRF и рендер HTML относятся к UI. + +API принимает случайные credentials, существующие только на время серверного UI-запроса. На каждой API-границе исходная сессия повторно проверяется по подписи, сроку и epoch. Cookie браузера и поддельный Bearer не предоставляют API-доступ. Автор берётся из проверенного Principal, а не из тела запроса. Нет отдельного публичного ключа для браузера. + +| JSON маршрут | Операция | +|---|---| +| `GET /admin/api/v1/site`, `GET /admin/api/v1/collections`, `GET /admin/api/v1/pages?q=&status=&layout=` | Страницы, коллекции, layouts, диагностика workspace/release | +| `GET /admin/api/v1/collections/{collection}/entries` | Записи коллекции | +| `POST /admin/api/v1/pages` | Создать draft Page | +| `POST /admin/api/v1/collections/{collection}/entries` | Создать draft Entry | +| `GET /admin/api/v1/pages/{identity}/source` | Снимок Page; вложенные ID поддерживаются | +| `GET /admin/api/v1/collections/{collection}/entries/{identity}/source` | Снимок Entry | +| `POST …/{identity}/validate, transform, save, preview` | Общий исходник, ETag основы, revision; transform имеет типизированное действие | +| `GET /admin/api/v1/assets/{asset}` | Защищённые workspace-ассеты прежнего превью | +| `GET /admin/api/v1/preview/{snapshot}/html, assets/{asset}` | Защищённый неизменяемый снимок | +| `GET /admin/api/v1/releases` | Реальные релизы и current | +| `POST /admin/api/v1/publish, rollback/{build_id}` | Сборка с публикацией / откат current | + +HTML-операции нового редактора: `/admin/editor/pages/{id}/{operation}` и `/admin/editor/content/{collection}/{slug}/{operation}`. Ответы — HTML; `X-Editor-Revision` позволяет отклонить устаревший результат. Старые `/admin/pages/…/meta`, `/blocks/…`, `/add`, `/content/…` и `/publish` продолжают принимать прежние формы. + +Предусмотренные планом `/admin/api/v1/editor/pages/…`, `/admin/api/v1/editor/entries/{collection}/…` и `GET/POST /admin/api/v1/entries/{collection}` также поддерживаются. Create возвращает 201, rollback доступен и как `POST /admin/api/v1/rollback` с `build_id` в JSON. + +Снимок содержит kind/id/path/source/etag/model/schema/issues/revision; результат превью — URL, snapshot, expires_at и revision. ETag — `sha256:` от исходных байтов; проверка актуальной схемы и CAS выполняются под одним SiteLock вместе с history/atomic write. Изменение code/layouts/schemas через content scope запрещено, в том числе через symlink/traversal. Ошибка аудита после записи возвращает признак committed с сохранённым снимком и не выдаётся за отклонённый Save. + +Ошибки API имеют `error: {code, message, issues, …}`; 409 дополнительно содержит submitted/current, 422 validation — неприменимый buffer либо диагностику. Лимит JSON-запроса — 1 MiB; source ограничен DTO и безопасным YAML-парсером. Неожиданная ошибка API возвращается без трассировки и секретов. + +Схема и локальная страница документации доступны после входа: `/admin/api/v1/openapi.json`, `/admin/api/v1/docs`; сокращённые `/admin/api/openapi.json`, `/admin/api/docs` также работают. Воспроизводимый экспорт без секретов и работающего сайта: + +```bash +site-engine export-openapi --out specs/001-antirion-admin/openapi.json +``` + +Эталон экспорта — [openapi.json](openapi.json). Экспорт с той же версией зависимостей даёт одинаковый JSON. + +## Отдельное превью + +Требуются два разных точных origin без завершающего `/`. Схема/host/порт сравниваются как origin; разный регистр или явный default port не делают origin разными. HTTP разрешён только на loopback, production требует HTTPS. + +Пример локального запуска после установки `.[server,dev]`, с уже настроенными `SITE_ADMIN_LOGIN`, `SITE_ADMIN_PASSWORD_HASH`, `SITE_SECRET_KEY`: + +```bash +export SITE_ROOT=/absolute/path/to/test-site +export SITE_DIST=/absolute/path/to/test-dist +export SITE_STATE_DIR=/absolute/path/to/test-state +export SITE_ADMIN_ORIGIN=http://127.0.0.1:8000 +export SITE_PREVIEW_ORIGIN=http://127.0.0.1:8001 +export SITE_COOKIE_SECURE=0 +uvicorn site_engine.web.app:create_app --factory --host 127.0.0.1 --port 8000 --no-access-log +# Во втором терминале с теми же env: +uvicorn site_engine.web.preview_app:create_preview_app --factory --host 127.0.0.1 --port 8001 --no-access-log +``` + +Перед запуском на рабочем сайте сделайте резервную копию site, dist и state. Для разработки используйте отдельную копию сайта без рабочего `.engine`; QA-скрипты создают такую копию автоматически. Они не меняют права и секреты рабочего примера. + +Отдельный процесс превью читает только подготовленные снимки и `auth_epoch` из общего state. Ему не нужен workspace или dist; state можно смонтировать read-only. Не подключайте admin-приложение на preview-origin. Пример с образом из текущего Dockerfile (env-файл содержит те же ключи и внешние HTTPS-origin): + +```bash +docker run --rm --name cms-admin -p 8181:8000 --env-file .env \ + -v "$PWD/data:/data" flexly-cms +docker run --rm --name cms-preview -p 8182:8000 --env-file .env \ + -e SITE_STATE_DIR=/data/state -v "$PWD/data/state:/data/state:ro" flexly-cms \ + uvicorn site_engine.web.preview_app:create_preview_app --factory --host 0.0.0.0 --port 8000 --no-access-log +``` + +Reverse proxy направляет каждый внешний origin в соответствующий процесс. Отключите query strings в access logs proxy для `/s/`; приложение также маскирует `token` в uvicorn access logs. Реальный Docker/proxy deployment не выполнялся при приёмке 001. + +Токен подписан отдельным purpose-key, привязан к immutable snapshot, revision, документу/сессии и epoch; TTL — 600 секунд. Проверяется на каждом HTML/asset-запросе, после logout недействителен. Снимок содержит копию ассетов workspace (до 50 MiB), включая защищённые CSS-зависимости. Symlink и traversal отклоняются. Последние 20 снимков документа/сессии сохраняются; просроченные/отозванные и оставшиеся после сбоя незавершённые снимки очищаются при старте и создании следующего снимка (незавершённые — после TTL). Если превью больше не запрашивается, файлы могут оставаться на диске до следующего создания, но обслуживаться после TTL не будут. + +Iframe отдельного origin имеет `allow-scripts allow-same-origin`; CSP разрешает только nonce bridge, CSS/изображения/шрифты снимка. JS сайта не подключается, inline-скрипты сайта блокируются. Сообщения проверяются по точному origin, source, типу, snapshot, revision и адресу блока `(scope, owner, id)`. Клик превью не прокручивает страницу, дерево прокручивает к невидимому блоку, последующие обновления восстанавливают viewport/selection. Скрытые блоки не появляются искусственно. + +Если обе origin-переменные отсутствуют, редактор работает с превью на административном origin: iframe с `allow-same-origin`, без scripts, CSP `script-src 'none'` и защищённые снимки/ассеты. Выбор секций в обе стороны работает и здесь: родительская админка обрабатывает клики по служебным маркерам и выделяет блок в DOM iframe, проверяя точный URL снимка, iframe/document, revision и адрес блока `(scope, owner, id)`. Код внутри превью не исполняется. Поле API `interactive` обозначает наличие bridge отдельного origin, а не возможность выбрать секцию. При частично заданной или небезопасной конфигурации основное приложение также использует режим без scripts; отдельное приложение превью требует корректные два origin. + +## Проверки + +```bash +python -m unittest discover -s tests -q +PYTHONPATH=src python scripts/qa_001.py +PYTHONPATH=src python scripts/qa_editor_001.py +python scripts/verify_package_001.py +``` + +Для браузерных скриптов установите Chromium: `python -m playwright install chromium`. Результаты текущей приёмки, ссылки на тесты и ограничения приведены в [verification.md](verification.md). + + +## Конструктор Page после этапа 3 + +Оригинал UI — `design/builder-antirion.html`; runtime не зависит от наличия `design/`. Поведение и визуальные адаптации перечислены в [design-transfer.md](design-transfer.md). + +HTML-проекция содержит серверные шаблоны инспектора для всех блоков. Чистый выбор секции локально обновляет дерево/инспектор/выделение и прокрутку превью: без POST, изменения source/revision, нового снимка или замены iframe. Клик по секции превью выбирает её без дополнительной прокрутки. HTML `/select` остаётся для форм без JS и совместимости; он валидирует переданный исходник и строит инспектор, без записи файла. + +Инспектор применяет поля к текущему source после паузы 650 мс; Save/выбор блока/смена режима сначала применяют ожидающую форму. Такой POST transform проверяет и преобразует переданный source, затем обновляет HTML-проекцию; это не сохранение черновика. До явного 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`. diff --git a/specs/001-antirion-admin/spec.md b/specs/001-antirion-admin/spec.md new file mode 100644 index 0000000..a72d4f1 --- /dev/null +++ b/specs/001-antirion-admin/spec.md @@ -0,0 +1,194 @@ +# 001 — Antirion Rework: админка и редакторы + +Дата: 2026-11-12. Статус: реализовано и проверено. Контракт и запуск — [runtime.md](runtime.md), результаты приёмки — [verification.md](verification.md). Локальная библиотека htmx поставляется в runtime-пакете. + +Связанные документы: [технический план](plan.md), [задачи](tasks.md). + +## 1. Цель и результат + +Перенести оформление Antirion Rework на работающую админку Site Engine, затем развить редакторы страниц и записей: общий буфер Конструктора и «Эксперта», встроенный инспектор, контролируемое сохранение и интерактивное превью несохранённого документа. + +Результат 001 — интерфейс, работающий с реальными файлами сайта и действующими операциями бэкенда. Сохранённый документ, несохранённый буфер редактора и опубликованный релиз имеют разные явно показанные состояния. + +Реализация выполнена по этапам A–F. Статусы задач и привязка к фактическим проверкам ведутся в `tasks.md`; кандидаты 002–006 остаются следующей очередью. + +## 2. Источники и приоритет + +1. Решения пользователя, перечисленные в разделе 3 этой спецификации. +2. Действующие файловые контракты, реализация и тесты репозитория; [журнал архитектурных решений](../../docs/TZ-site-engine-decisions.md). +3. HTML/CSS выбранного варианта как эталон оформления и взаимодействий. +4. [Документы stage7](../../design/docs/stage7/README.md) как проект развития с поправками из этого пакета. + +Визуальные источники: + +| Экран | Источник | +|---|---| +| Shell, обзор, страницы | [antirion-rework.html](../../design/antirion-rework.html), `design/assets/antirion-rework.css` | +| Конструктор и «Эксперт» страницы | [builder-antirion.html](../../design/builder-antirion.html), `design/assets/builder.css` | +| Коллекции и записи | [content-antirion.html](../../design/content-antirion.html), `design/assets/content-editor.css` | +| Публикация и история | [publication-antirion.html](../../design/publication-antirion.html), `design/assets/publication.css` | + +JS прототипов описывает UX; его seed-данные, localStorage, browser codec и имитации публикации не являются контрактом бэкенда. При расхождении скриншота и исходного выбранного HTML/CSS приоритет имеет исходник. `design/` сохраняется как визуальный эталон; уточнения stage7 выполняются отдельными задачами. + +## 3. Зафиксированные решения пользователя + +| Решение | Принятый вариант | +|---|---| +| Первый результат | Оформить все существующие рабочие экраны и выполнить необходимые точечные доработки | +| Следующий приоритет | Редакторы страниц и записей | +| Доступ | Один администратор через существующую конфигурацию; пользователи и роли позднее | +| Сохранение | Только по явной кнопке, без автозаписи файла после изменения поля | +| Превью редактора | Интерактивное сразу в этапе развития редакторов, с отдельным origin | +| Оформление | Antirion Rework; Rose Graphite и другие концепции не внедряются в 001 | +| Взаимодействие UI и бэкенда | htmx + Jinja; UI вызывает единый JSON API FastAPI через серверный клиент, по схеме flexly-estimator | +| Транспорт API | В одном приложении `httpx.ASGITransport`, без сетевого соединения; API-ключи не передаются браузеру | + +Технические значения по умолчанию: светлая палитра при первом входе; предпочтение оформления хранится только как UI-настройка; срок токена превью — 10 минут. Изменяемый контент остаётся в файлах сайта. + +## 4. Исходное состояние и расхождения со stage7 + +| Область | Уже существует | Доработка в 001 | +|---|---|---| +| Контент | Page/Entry, YAML front matter, Markdown, коллекции и display | Использовать текущую модель в новом UI | +| Композиция | Layout, Fragment, регионы, слоты, fixed, явные ID, `hidden`/`requires` | Дерево и инспектор без уплощения структуры | +| Значения | Literal, Binding, LinkRef, Query; разрешение на сервере | Единый буфер и операции Конструктора | +| Запись | ContentService: ETag, блокировка сайта, история, атомарная запись | Перенести прикладные операции из HTTP-обработчиков в сервисы | +| Валидация | Workspace/release, проверки нового текста до записи | Общая проверка Конструктора и «Эксперта» | +| Доступ | Одна учётная запись, cookie, CSRF, ограничение входа, аудит | Сохранить; передавать проверенного автора в новые сервисы | +| Конфликт | 409 с текущим ETag, общая страница сообщения | Сохранить ввод, показать версии и дать повторное сохранение после разрешения | +| Превью | Рендер сохранённого документа без скриптов | Временный рендер буфера, отдельное приложение и взаимодействие с деревом | +| Публикация | Build сразу переключает `current`; сохранённые релизы и rollback | Новое оформление существующих операций | +| HTTP-контракт | FastAPI-адаптер, общий dispatch редактора, HTML-ответы; OpenAPI отключён | Явные JSON-маршруты, Pydantic DTO, OpenAPI и HTML-адаптер над серверным API-клиентом | + +Обнаруженные несовместимости stage7, подлежащие документированию и исправлению: + +- Для `collection_list.source` нужен `{query: {collection: ...}}`; объект запроса без `query` не соответствует текущему контракту. +- У `richtext` поле Markdown называется `content`, а не `source`. +- Блоки используют `hidden` и `requires`; `visibility` не поддерживается. +- Пример с `layout: landing` требует собственного layout; текущий сайт-пример содержит `default`. +- Поля примера Entry должны соответствовать схеме `services`: `title`, `tagline`, `summary`, `order` и системным полям. +- Текущая публикация доступна по `/admin/publish`; `/admin/publication` — предложение stage7. +- В HTML-формах используются `csrf` и `etag`; параметр сервиса называется `if_match`. +- ETag вычисляется по байтам файла, без добавления версии схемы. Ядро использует dataclass, а не Pydantic. +- Наличие моделей SQLAlchemy не означает готовности пользователей, заявок, outbox или истории сборок в БД. +- Новые ADR stage7 не должны переопределять существующие ADR с теми же номерами без явного сопоставления и сохранения истории. + +Текущий CSP админки не объявляет `frame-src` при `default-src 'none'`, что препятствует загрузке iframe в браузере. Ссылки `/assets/...` в текущем превью относятся к опубликованному сайту, поэтому не гарантируют отображение ассетов workspace. Обе проблемы входят в первый этап. + +## 5. Объём 001 + +### Этап A — рабочие экраны + +Вход/выход, обзор, список и создание страниц, формы страницы и блока, операции с блоками, коллекции, список/создание/редактирование записей, существующее превью, публикация, история релизов, откат, ошибки и пустые состояния. + +Рабочие маршруты и обычные формы сохраняются. Пока новые редакторы не готовы, пользователь сохраняет изменения существующими кнопками форм. На этом этапе оформление публикации соответствует текущей операции «собрать и опубликовать». + +### Этап B — редакторы + +Общие сервисы, единый API-контракт и серверный клиент UI, буфер документа, дерево блоков, встроенный инспектор, режим «Эксперт», сохранение документа целиком, разрешение конфликтов и интерактивное превью. + +Начальный режим страницы — «Конструктор». Для Entry Конструктор редактирует поля её коллекции; дерево блоков относится к Page, а display/fixed-блоки вывода Entry доступны для просмотра. Изменение display-кода из редактора записи не предоставляется. + +### Следующая очередь + +Отдельные кандидаты релиза, diff с live, медиабиблиотека и загрузки, changeset/rename, редактирование меню/настроек, пользователи/RBAC, заявки/outbox и MCP описываются следующими спецификациями. В 001 не добавляются Node-сборка, новая структура всего Python-пакета или миграция канонического контента в БД. + +### Контракт интерфейса + +Принята схема, проверенная по коду `../flexly-estimator/`: `web/client.py`, `web/deps.py`, `web/routes/estimates.py`, `api/routers/estimates.py`. Переносится архитектурный подход; модели пользователей, БД и расчётов estimator не являются зависимостями CMS. + +```text +Браузер / htmx → UI-маршрут FastAPI → серверный API-клиент + → JSON API FastAPI → прикладной сервис → файловое хранилище + ← HTML-страница / фрагменты ← результат API +``` + +UI-маршруты возвращают страницы или HTML-фрагменты; `/admin/api/v1/` возвращает JSON и не выбирает формат по `HX-Request`. Браузер отправляет формы с cookie и CSRF в UI, не получает внутренние credentials и не вызывает API напрямую. Прямой вызов сервисов из UI допустим только как переходное состояние этапа оформления существующих экранов; к завершению 001 операции контента, проверки, превью и публикации проходят через API-клиент. Проверки сессии и рендер шаблонов остаются ответственностью UI. + +API задаёт единый контракт операций и данных. HTML-фрагменты дополнительно имеют собственный UI-контракт: DOM-цели, правила замены, сообщения об ошибках и revision. Общие сервисы остаются доступными CLI и будущему MCP напрямую. + +## 6. Функциональные требования + +| ID | Требование | +|---|---| +| FR-01 | Общий shell воспроизводит навигацию, верхнюю панель, рабочую область и адаптивное поведение Antirion Rework. | +| FR-02 | Экран показывает реальные данные. Действие без серверной реализации не выдаётся за доступную операцию; недоступное состояние объясняется. | +| FR-03 | Списки страниц и записей поддерживают поиск по названию/ID/маршруту и фильтр статуса; список страниц также фильтруется по эффективному layout. Выбор показывает свойства и переход в редактор. | +| FR-04 | Существующие формы сохраняют маршруты, имена полей, CSRF, контроль версии и работающие операции. | +| FR-05 | Ответы 409/422 сохраняют ввод и показывают причину отказа. | +| FR-06 | PageService и EntryService предоставляют чтение, создание, проверку и изменение документа независимо от HTTP-представления. | +| FR-07 | Снимок документа содержит идентификатор, путь относительно сайта, исходник, модель, ETag и диагностику. | +| FR-08 | Конструктор и «Эксперт» изменяют общий временный буфер. Проверка, преобразование и превью не записывают канонические файлы и историю их версий. | +| FR-09 | «Сохранить» записывает весь документ одной операцией с проверкой версии, валидацией, историей и аудитом успешного изменения. | +| FR-10 | Конструктор сохраняет регионы, слоты, ID, привязки, ссылки, запросы и Markdown; fixed-блоки layout доступны только для просмотра. | +| FR-11 | YAML разбирает сервер. Ошибочный исходник остаётся в редакторе и не заменяет последнюю корректную модель. | +| FR-12 | Переключение режимов сохраняет корректные правки. Ошибочный исходник не позволяет молча перейти к другой модели; внутренний переход с несохранёнными изменениями требует подтверждения в интерфейсе. | +| FR-13 | При 409 доступны пользовательская и текущая серверная версии. Пользователь вручную объединяет правки либо явно принимает серверную версию; повторное сохранение использует актуальный ETag. | +| FR-14 | Превью показывает буфер документа и соответствующие ассеты workspace до сохранения файла. | +| FR-15 | Клик в превью выбирает блок без прокрутки; выбор в дереве прокручивает к невидимому блоку; обновление поля сохраняет положение и выделение. | +| FR-16 | Интерактивное превью обслуживается отдельным origin, доступно по ограниченному токену и использует проверенные сообщения между окнами. | +| FR-17 | Обычная публичная сборка не получает служебных атрибутов/скриптов редактора и сохраняет прежнюю семантику. | +| FR-18 | Прикладные операции UI проходят через явный версионированный JSON API FastAPI; запросы, ответы и ошибки описаны Pydantic DTO и OpenAPI. Ядро сохраняет dataclass-модели. | +| FR-19 | UI вызывает API через серверный клиент с ASGITransport в том же приложении. Проверенный автор и эпоха сессии сохраняются; API отклоняет анонимные, отозванные и поддельные внутренние credentials. | +| FR-20 | htmx получает только HTML от UI. Ответы 409/422 и истечение сессии обрабатываются явно; JS редактора сохраняет буфер, revision и связь с превью при частичных обновлениях. | + +## 7. Модель данных и сохранения + +- Canonical Page — `pages/**/*.md`; Entry — `content//*.md`. Идентичность документа определяется проверенным реестром и путём, а не произвольным путём из запроса. +- Сохраняются типы значений, `regions`, `slots`, `hidden`, `requires`, `editorial`, Markdown и существующие статусы `draft/published/archived`. +- Буфер содержит исходник, ETag сохранённой основы и последнюю корректную модель. Преобразование буфера не обновляет ETag основы. +- Конструктор изменяет разобранный документ на сервере. Сериализация сохраняет смысл, порядок блоков и данные, которые текущая политика схемы допускает сохранять; поля не исчезают молча. +- «Эксперт» сохраняет проверенный исходный текст. Конструктор использует текущую нормализацию YAML; это описано рядом с исходником, без отдельного предупреждения при правке. Исходник можно скачать. Нативные `alert`/`confirm`/`prompt` и `beforeunload`-диалоги не используются; подтверждения удаления, отмены и внутренних переходов с несохранёнными правками показываются в окнах интерфейса. Перезагрузка/закрытие вкладки не вызывает системного подтверждения. +- Неполный draft допустим в пределах базовых требований текущей модели: например, Page по-прежнему требует корректный заголовок, но обязательные бизнес-поля фрагмента могут быть не заполнены. +- Алиасы, дублирующиеся ключи YAML, недопустимая вложенность, Jinja-выражения в данных и попытки записи кода отклоняются с диагностикой. Действующие лимиты безопасного парсера сохраняются. +- Переименование файла и изменение логического slug Entry через исходник запрещены в 001. Изменение route страницы остаётся существующей возможностью без обещания автоматического создания редиректа. +- `etag` формы передаётся как `if_match`; его значение — `sha256:` и SHA-256 текущих байтов файла. После успешного сохранения клиент получает новый ETag. +- При 409 новый ETag не подставляется в повторную отправку автоматически. Диалог конфликта сохраняет обе версии и требует явного действия пользователя. +- Несохранённый исходник хранится в памяти вкладки; UI предлагает скачать его перед отказом от правок. Восстановление буфера после перезагрузки не обещается. LocalStorage допускается для темы/свёрнутой навигации, но не для канонического контента. +- Аудит содержит автора, тип операции и идентификатор объекта; содержимое исходника, токены и секреты не записываются. + +## 8. Интерактивное превью + +Превью — временный производный результат. Его создание может писать артефакты в служебное состояние, но не изменяет canonical Page/Entry, историю файлов и live. + +- Отдельные явно заданные origin админки и превью; wildcard и совпадающие origin для интерактивного режима запрещены. +- Отдельное приложение превью не имеет login/admin/API-маршрутов и не использует админскую cookie для авторизации. +- Токен открывает один подготовленный снимок HTML и его ассеты, действует 10 минут и проверяется на каждом запросе. Выход администратора отзывает доступ через эпоху сессий. Токен одного снимка не открывает другой. +- Превью содержит только разрешённый служебный скрипт взаимодействия. Скрипты сайта и произвольный исходник не получают права исполнения. +- `postMessage` проверяет origin, source, тип сообщения, текущий снимок и существование блока. Отправка направляется точному origin. +- Fixed/layout, display и редактируемые блоки имеют различимые области идентификаторов; совпадение локального ID не даёт возможности менять fixed-блок. +- Скрытый блок или блок с выключенным feature остаётся в дереве с пояснением; превью не показывает его как публично видимый. Выбор такого блока не вызывает ошибочную прокрутку. +- Удаление выбранного блока сбрасывает выбор на существующий соседний блок или свойства документа. Ответ старого запроса превью не заменяет более новое состояние. +- Истечение токена требует повторной генерации из авторизованного редактора. Недоступность приложения превью сохраняет буфер и возможность редактировать/сохранить документ. + +## 9. Качество и совместимость + +| ID | Требование | +|---|---| +| NFR-01 | Существующие URL, форматы файлов, основные команды CLI и поведение публикации/отката сохраняются. | +| NFR-02 | Autoescape, санитайзер Markdown, safe paths, CSRF и защитные cookie сохраняются. CSP разрешает только необходимые ресурсы. | +| NFR-03 | Проверяются ширины 1440, 1280, 1024, 768, 390 и 360 px; таблицы могут иметь внутреннюю прокрутку, весь экран не переполняется. | +| NFR-04 | Управление доступно с клавиатуры, фокус видим, у полей и iframe есть подписи. Модальные окна удерживают фокус и возвращают его инициатору; учитывается reduced motion. | +| NFR-05 | Установленный wheel содержит шаблоны, статику админки и служебные ресурсы превью. Работа не зависит от наличия каталога design на сервере. | +| NFR-06 | Канонические файлы и live меняются только соответствующими явными операциями; ответы ошибок не показывают трассировки и секреты. | + +Для FR-18–FR-20 обязательны локальная закреплённая версия htmx с источником, лицензией и SHA-256, запрет eval/скриптов из фрагментов и запросов htmx к сторонним origin. OpenAPI выгружается воспроизводимо для проверки контракта; HTTP-доступ к схеме и документации требует административной авторизации. Анонимные Swagger/OpenAPI не включаются. + +## 10. Приёмочные сценарии + +| ID | Проверка и ожидаемый результат | +|---|---| +| AC-01 | Вход → обзор → создание/редактирование Page/Block/Entry → reload: существующие операции работают в новом оформлении. | +| AC-02 | Конструктор → «Эксперт» → Конструктор сохраняет ID, вложенность, привязки и Markdown; простой переход без правок не переформатирует исходник. | +| AC-03 | Изменение поля/блока, validate и preview оставляют байты canonical-файлов, историю и current прежними; «Сохранить» фиксирует все правки документа. | +| AC-04 | Ошибочный YAML, повтор ключа, неподдерживаемый блок или попытка изменить fixed не записывают файл; введённый текст остаётся в UI. | +| AC-05 | Две вкладки читают один ETag; первая сохраняет, вторая получает 409 с сохранённым вводом и текущей версией; после ручного объединения сохраняет с новым ETag. | +| AC-06 | Превью выбирает нужный вложенный/fixed-блок, соблюдает правила прокрутки и отображает последнюю версию буфера, включая ассеты workspace. | +| AC-07 | Неверный/истёкший/отозванный токен, чужой снимок, поддельные origin/source/сообщения и traversal отклоняются; приложение превью не открывает admin/login. | +| AC-08 | Успешная публикация переключает current; неудачная сохраняет live; откат сохраняет workspace. В UI отсутствует имитация ещё не реализованного кандидата. | +| AC-09 | Основные экраны, ошибки, диалоги и редакторы проходят адаптивную и клавиатурную проверку на заданных размерах. | +| AC-10 | Wheel содержит runtime-ресурсы; обычная сборка сайта проходит и не содержит служебной разметки/скриптов preview-режима. | +| AC-11 | Реальный FastAPI проверяет запросы и ответы JSON API, единый формат ошибок и OpenAPI. HTML- и API-маршруты не смешивают форматы; UI вызывает API через ASGITransport с проверенным автором. Ошибки/отказ API отражаются в UI без обхода через прямую запись. | +| AC-12 | Настоящий htmx загружает фрагмент, отправляет форму с CSRF, показывает 409/422, обрабатывает истечение сессии и согласованные обновления без потери буфера. Поддельные внутренние credentials и прежняя эпоха после logout не дают API-доступ; API-токенов нет в HTML и браузерных запросах. | + +Готовность требует исполнения сценариев через реальный FastAPI и браузер. Тесты обработчиков и QA прототипа не заменяют эту проверку. diff --git a/specs/001-antirion-admin/tasks.md b/specs/001-antirion-admin/tasks.md new file mode 100644 index 0000000..c64acc9 --- /dev/null +++ b/specs/001-antirion-admin/tasks.md @@ -0,0 +1,156 @@ +# Задачи 001 — Antirion Rework + +Дата: 2026-11-12. Статус: функциональная реализация проверена; задачи переноса и визуальной приёмки открыты повторно после замечаний пользователя. [Поэтапная проверка дизайна](design-transfer.md). Результаты и ограничения — [verification.md](verification.md), воспроизводимый контракт и запуск — [runtime.md](runtime.md). + +Основание: [спецификация](spec.md) и [технический план](plan.md). Создание этих документов не закрывает перечисленные задачи разработки. Новые ID T037–T041 добавлены без перенумерации прежних задач; порядок выполнения задаётся этапами и зависимостями. + +## Правила выполнения + +- Выполнять этапы A → B → C → D → E → F с контрольными точками ниже. +- Задача закрывается после изменения, относящейся к нему проверки и записи результата; наличие кода без проверки не равно завершению. +- Существующие проверки запускаются по характеру изменения; чистые CSS-правки проверяются сборкой и браузером, а не тестами, повторяющими CSS. +- Несвязанные пользовательские файлы и прототипы сохраняются. Рабочие данные и секреты не используются как место реализации. +- Результаты реально выполненных проверок записываются при реализации. Не отмечать задачи выполненными по результатам чтения документации или QA mock-прототипа. + +## A. Подготовка и соответствие документации + +Зависимость: нет. Выход — проверяемая исходная точка для оформления и сервисов. + +- [x] **T001** Сопоставить stage7 текущему коду и исправить несовместимые примеры/контракты. + - Матрица охватывает файловую модель, query/content, visibility, layout/schema Entry, маршруты, csrf/etag, preview, release, DB/MCP-заготовки. Примеры проверены в временной копии сайта. +- [x] **T002** Сопоставить ADR и зафиксировать границы 001 в документации stage7. + - История сохранена; реализованные решения отделены от предложений; новые кандидаты/медиа/RBAC/заявки/MCP отнесены к следующей очереди. +- [x] **T003** Подготовить изолированное окружение и выполнить исходные тесты, validate и build. + - Зафиксированы команды, результаты и реальные ограничения окружения. Включены server/dev-зависимости; подготовлен способ запускать HTTP/browser QA. +- [ ] **T004** Зафиксировать визуальные эталоны рабочих экранов и тестовые состояния. + - Использованы выбранные HTML/CSS; сохранены проверки desktop/mobile, пустых состояний, ошибок, формы входа и данных сайта-примера. +- [x] **T041** Поставить локальный htmx из flexly-estimator и проверить существующее подключение. + - Побайтовая копия 2.0.11, SHA-256 совпадает с источником и VENDOR.md; лицензия/источник записаны, статическая раздача и wheel проверены. Это не реализация API или нового редактора. + - Проверено 2026-11-12: `node --check`; 62 теста обработчиков/редактора и 2 теста упаковки, включая сборку wheel; HTTP smoke через настоящий FastAPI/TestClient (файл/MIME/nosniff, вход, hx-boost-разметка, CSRF/422, конфигурация и allowlist). + - Тесты обработчиков/редактора запускались на временной копии примера без `.engine`: исходный запуск упёрся в недоступный рабочий `.engine/audit.jsonl`. Рабочие данные и права не менялись. На момент подготовки T041 исполнение htmx в браузере ещё не проверялось; итоговые T023/T032 закрыты реальными Chromium-сценариями, см. verification.md. + +## B. Оформление рабочих экранов + +Зависимость: T001–T004. Этап завершается до перехода к новому общему буферу. + +- [ ] **T005** Перенести стили, токены и ресурсы Antirion Rework в runtime-пакет. + - Shell/editor/publication не конфликтуют; светлая палитра по умолчанию и тёмная палитра Antirion согласованы; работа не зависит от `design/` на сервере. +- [ ] **T006** Реализовать общий shell, адаптивную навигацию, диалоги и UI-настройки. + - Клавиатура, фокус, открытие/закрытие мобильного меню, Esc, возврат фокуса; localStorage содержит только настройки интерфейса. +- [ ] **T007** Перенести вход, обзор, сообщения и пустые состояния. + - Реальные статусы сайта/релиза, ошибки входа и недоступного сайта; сохранены текущие защитные заголовки и cookie. +- [ ] **T008** Перенести списки Page/Entry, поиск, фильтры и просмотр свойств. + - Проверены q/status/layout, вложенные ID, пустая выдача, выбранный объект и неизвестный ID; представлены реальные file/layout/count/current. +- [ ] **T009** Перенести формы Page, Block и Entry и существующие операции блоков. + - Сохранены имена полей и URL, создание draft, слоты/привязки, добавление/порядок/видимость/удаление и семантика формы без изменений. +- [ ] **T010** Перенести существующие публикацию, историю и откат с подтверждениями. + - В UI отражены реальные build+publish и rollback; кандидат/diff не имитируются; ошибки сборки и отсутствие релизов отображаются. +- [x] **T011** Исправить CSP iframe и защищённые ассеты workspace. + - Браузер загружает пассивное превью; изображения и зависимые ресурсы берутся из workspace; traversal/выход по symlink отклоняется; binary MIME корректен. +- [x] **T012** Сохранить пользовательские значения при 409/422 на существующих формах. + - Ошибка не теряет ввод, не выдаёт новый ETag за согласие перезаписать файл и не запускает повторный POST автоматически. +- [ ] **T013** Принять оформление рабочих экранов по AC-01, AC-08, AC-09 и упаковочной части AC-10. + - Выполнены подходящие существующие тесты, реальные HTTP/browser-сценарии, адаптивная проверка и проверка wheel со статикой/шаблонами. + +**Контрольная точка B:** существующие операции работают в новом оформлении. Новый буфер и интерактивное превью ещё не считаются выполненными. + +## C. Общие сервисы и файловая запись + +Зависимость: T013. Новые сервисы сохраняют действующие файловые контракты. + +- [x] **T014** Определить снимки документов, результаты буфера/сохранения/конфликта и контекст автора. + - Использованы dataclass/Report; сервис не зависит от Request/Jinja, автор получен из проверенной сессии. +- [x] **T015** Реализовать обновление файла с одним владельцем SiteLock. + - CAS и актуальная validation находятся внутри цикла обновления; нет вложенного lock/deadlock; отказ не создаёт историю или частичный файл; два писателя проверены. +- [x] **T016** Выделить PageService и перевести операции Page/Block на него. + - Чтение, создание, metadata, props, add/delete/toggle/move используют общий validation/save; аудит без дублирования, старые маршруты совместимы. +- [x] **T017** Выделить EntryService и перевести операции Entry на него. + - Поля коллекции, статус и Markdown проходят общую проверку; идентичность записи и запрет записи кода сохраняются. +- [x] **T037** Реализовать основу версионированного JSON API FastAPI и схемы контракта. + - Зависимость: T014–T017. Явные маршруты `/admin/api/v1/`, Pydantic request/response и error envelope, текущее чтение/создание/изменение документов, пассивное превью и publish/rollback; защищённые OpenAPI/docs и выгрузка схемы. DTO буфера определены; операции развиваются в T019/T020, интерактивное превью — в T026. Dataclass-ядро сохранено. +- [x] **T038** Реализовать серверный API-клиент UI и внутреннюю авторизацию. + - Зависимость: T037. httpx включён в server extra; ASGITransport вызывает то же приложение с общим lifespan, синхронные операции не блокируют event loop; credentials связаны с автором/сессией/epoch и не попадают в браузер или логи. +- [x] **T039** Перевести существующие UI-операции на единый API-клиент. + - Зависимость: T038. Списки/обзор, Page/Block/Entry, validation, превью и publish/rollback используют контракт API; HTML-маршруты сохраняются, ошибки API не обходятся прямым вызовом сервисов. Вход/сессия/статика остаются в UI. +- [x] **T040** Проверить API-контракт и реальное прохождение UI → API по AC-11. + - Зависимость: T037–T039. Реальный FastAPI проверяет реализованные операции: request/response/OpenAPI, единые 401/403/404/409/422, авторство, эпоху/logout, разграничение JSON/HTML и отсутствие обхода при ошибке API. Проверки расширяются в T024/T030/T032; полная приёмка AC-11 выполняется после редакторов/превью. + +## D. Буфер, Конструктор и «Эксперт» + +Зависимость: T014–T017, T037–T040. Изменение буфера не означает сохранение файла. + +- [x] **T018** Отклонять повторяющиеся ключи YAML и проверить безопасный разбор. + - Покрыты вложенные дубли, aliases, лимиты, запрещённые выражения и корректный текущий сайт; ошибка не приводит к потере текста. +- [x] **T019** Реализовать получение, проверку и transform буфера без записи. + - HTML-endpoints под `/admin/editor/` вызывают JSON API через клиент; проверены сессия/Origin/CSRF на UI, credentials на API, вложенные ID, схемы, типизированные действия и прежний ETag основы. +- [x] **T020** Реализовать явное сохранение полного исходника с ETag, историей и аудитом. + - API save и HTML-адаптер используют общий контракт; Page/Entry сохраняются одной операцией; slug/path/fixed нельзя изменить в обход правил; клиент получает сохранённый source и новый ETag. +- [x] **T021** Реализовать общий буфер Конструктора и «Эксперта», дерево и встроенный инспектор. + - Constructor выбран по умолчанию, Entry использует схему коллекции, layout/display показываются read-only, неприменимый source остаётся в редакторе. +- [x] **T022** Реализовать подтверждения внутренних переходов с несохранёнными правками через окна интерфейса, скачивание исходника и разрешение 409. Нативные alert/confirm/prompt и beforeunload-диалоги не использовать. + - Переход режима/документа и уход не отбрасывают правки; две версии доступны; принятие новой основы явно; повторный конфликт обрабатывается. +- [x] **T023** Настроить htmx и обработку согласованных частичных ответов редактора. + - Локальная библиотека поставлена в T041; нет inline-выражений/eval/скриптов из ответов и сторонних запросов; 409/422 направляются в нужный регион, не очищают буфер; устаревшие revision игнорируются; истечение сессии и полная форма Save работают по AC-12. +- [x] **T024** Принять сервисы и редакторы по AC-02–AC-05. + - Проверены semantic round-trip, сохранение исходника без правок, вложенные слоты, refs/query, Entry, отсутствие файловых изменений до Save и реальный CAS двух вкладок. + +**Контрольная точка D:** работают общий буфер и ручное сохранение; подготовка интерактивного превью не подменяется mock-iframe. + +## E. Интерактивное превью + +Зависимость: T019–T024. Приёмка требует двух действительных origin. + +- [x] **T025** Добавить SITE_ADMIN_ORIGIN/SITE_PREVIEW_ORIGIN и отдельное приложение превью. + - Валидируются разные точные origin; приложение не имеет admin/login; описан запуск вторым процессом/контейнером, пассивный режим сохранён при отсутствии конфигурации. +- [x] **T026** Реализовать временный рендер буфера, ассеты, токены и очистку. + - API preview и HTML-адаптер возвращают PreviewResult; 600 секунд, подпись с отдельным назначением ключа, привязка к снимку/epoch, проверка каждого ресурса, последние 20 снимков документа/сессии, очистка и маскирование токенов в логах. +- [x] **T027** Добавить preview-маркировку Renderer с различимыми областями блоков. + - Page/layout/display и вложенные блоки адресуются однозначно; fixed read-only; лишние контейнеры не меняют layout; обычный рендер не маркируется. +- [x] **T028** Реализовать служебный скрипт и двусторонний протокол сообщений. + - Точные origin/source, разрешённые типы, snapshot/revision и блоки проверяются; CSP/sandbox допускают только нужное поведение; wildcard отсутствует. +- [x] **T029** Связать превью с деревом и инспектором, сохранить viewport и порядок обновлений. + - Клик preview без scroll, дерево скроллит только при необходимости, изменение props не сбрасывает позицию; hidden/fixed/deleted и быстрые последовательные правки обработаны. +- [x] **T030** Выполнить security-проверки превью по AC-07. + - Проверены неверный/истёкший/отозванный токен, чужой снимок, logout, traversal/symlink, поддельные сообщения, запрет admin/login и исполнения скриптов сайта. +- [x] **T031** Проверить живое превью буфера и неизменность публичной сборки по AC-06/AC-10. + - Используется новый ассет workspace без публикации; canonical/current не меняются; истечение токена/сбой сервиса не теряет буфер; обычный HTML не содержит bridge/служебных атрибутов. + +## F. Сквозная приёмка и документация + +Зависимость: T005–T031, T037–T041. + +- [x] **T032** Выполнить сквозные сценарии через реальное FastAPI и браузер. + - Вход/истечение сессии, Page/Entry, режимы, validate/Save/409/422, preview, publish/rollback; настоящий htmx и ASGI-клиент, AC-11/AC-12; результат приложен отдельно от тестов подставного FastAPI. +- [ ] **T033** Проверить размеры, клавиатуру, фокус, ошибки и reduced motion. + - 1440/1280/1024/768/390/360 px, палитры Antirion, мобильное меню, таблицы, диалоги, инспектор и отсутствие переполнения страницы. +- [x] **T034** Выполнить регрессию, validate/build и проверку установленного wheel. + - Установленный пакет содержит все runtime-ресурсы, работает без `design/`, сохраняет существующие гарантии CLI/core/build/security. +- [x] **T035** Обновить README, AGENTS.md, stage7 и инструкцию запуска превью. + - Документация соответствует фактическому состоянию, описывает env, два origin, состояние/очистку токенов, backup тестового сайта и воспроизводимый локальный/Docker-запуск. +- [ ] **T036** Сопоставить результаты с FR-01–FR-20, NFR-01–NFR-06 и AC-01–AC-12. + - Приложены результаты и ограничения; незавершённые пункты остаются открытыми; 001 не объявляется готовой по одному визуальному сравнению. + +## Матрица требований и задач + +| Требования | Основные задачи | Приёмка | +|---|---|---| +| FR-01–FR-03 | T004–T008, T033 | AC-01, AC-09 | +| FR-04–FR-05 | T009–T013, T022–T023 | AC-01, AC-04, AC-05 | +| FR-06–FR-07 | T014–T017, T019–T020 | AC-02–AC-05 | +| FR-08–FR-10 | T015–T024 | AC-02, AC-03, AC-05 | +| FR-11–FR-13 | T018–T024 | AC-02, AC-04, AC-05 | +| FR-14–FR-16 | T025–T031 | AC-03, AC-06, AC-07 | +| FR-17 | T027, T031, T034 | AC-10 | +| FR-18–FR-19 | T014–T017, T037–T040, T032 | AC-11, AC-12 | +| FR-20 | T019–T023, T032, T041 | AC-03–AC-05, AC-12 | +| NFR-01–NFR-02 | T003, T009–T020, T025–T030, T032, T034 | AC-01, AC-07, AC-08 | +| NFR-03–NFR-04 | T004–T006, T021–T023, T029, T033 | AC-09 | +| NFR-05–NFR-06 | T011–T015, T020, T026, T031, T034–T036 | AC-03, AC-05, AC-08, AC-10 | + +Релизы, медиа/настройки, доступы, заявки и MCP следующей очереди не входят в список выполнения 001. Их порядок и зависимости перечислены в конце `plan.md`. + +## Прежняя функциональная проверка (визуальная приёмка открыта повторно) + +2026-11-12: 239 тестов; настоящий FastAPI/ASGITransport; 25 сценариев Chromium на двух origin; 8 экранов и 60 проверок ширины, обе темы, клавиатура и reduced motion; validate/build примеров stage7 — 0 ошибок/0 предупреждений, 7 страниц; wheel установлен вне checkout без design/. Подробная матрица требований, команды и ограничения — [verification.md](verification.md); машиночитаемые результаты — [qa-results.json](qa-results.json). + +Этапы 1–2 приняты пользователем. Этап 3 (Конструктор/Эксперт Page) подготовлен к проверке: исходные компоненты builder-antirion, реальные дерево/инспектор/каталог/источники, автоматическое применение полей и явное сохранение, дублирование поддерева, перетаскивание, 422 без потери ввода, сравнение/отмена/форматирование исходника. 247 тестов; Chromium — 12 сравнений Конструктора и 6 «Эксперта», 11 групп сценариев; регрессия editor/shell/pages, CLI и установленного wheel — OK. Подробности — [design-transfer.md](design-transfer.md). Этапы 4–5 и общая визуальная приёмка T033/T036 остаются открытыми; переход — после проверки пользователя. diff --git a/specs/001-antirion-admin/verification.md b/specs/001-antirion-admin/verification.md new file mode 100644 index 0000000..506651f --- /dev/null +++ b/specs/001-antirion-admin/verification.md @@ -0,0 +1,95 @@ +# Приёмка 001 — 2026-11-12 + +**Визуальная приёмка открыта повторно.** Пользователь обнаружил расхождения с исходной вёрсткой и поведением дизайна. Прежние функциональные проверки ниже не доказывают корректность переноса макетов. Повторный перенос идёт по [отдельным этапам с проверкой пользователя](design-transfer.md): каркас, обзор и страницы приняты пользователем; этап 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](design-transfer.md). Ниже сохранены свидетельства предыдущей функциональной реализации, а не статус визуальной приёмки всех экранов. + +Ниже сохранены результаты функциональной реализации A–F. Действующий контракт и инструкции запуска: [runtime.md](runtime.md). Машиночитаемые результаты: [qa-results.json](qa-results.json), JSON-контракт: [openapi.json](openapi.json). + +## Выполненные проверки + +| Проверка | Результат | +|---|---| +| Исходная точка | 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`: + +```bash +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; остальные доступные файлы примера скопированы как обычно. Права и рабочий контент не менялись. Изменения выбора и диалогов на сервер пользователя не устанавливались. diff --git a/src/site_engine/build/pipeline.py b/src/site_engine/build/pipeline.py index f238c7a..d6073c2 100644 --- a/src/site_engine/build/pipeline.py +++ b/src/site_engine/build/pipeline.py @@ -165,6 +165,11 @@ def build_site(root: Path, out: Path, *, keep: int = 5, now: dt.datetime | None report.extend(validate_release(reg, table)) source_hash = hash_tree(root) + # Only published Page sources: the public manifest must not reveal draft paths. + page_sources = { + p.file: hashlib.sha256((root / p.file).read_bytes()).hexdigest() + for p in reg.pages.values() if p.status == "published" + } build_id = f"{now.strftime('%Y%m%dT%H%M%S')}-{source_hash[:8]}" views = make_views(reg, table, report) @@ -224,6 +229,7 @@ def build_site(root: Path, out: Path, *, keep: int = 5, now: dt.datetime | None (staging / "manifest.json").write_text(json.dumps({ "build_id": build_id, "source_hash": source_hash, "built_at": now.isoformat(), "routes": sorted(rendered), "fragments": sorted(used), + "page_sources": page_sources, }, ensure_ascii=False, indent=2), encoding="utf-8") final = out / build_id if final.exists(): diff --git a/src/site_engine/builtin/fragments/card_grid/fragment.yaml b/src/site_engine/builtin/fragments/card_grid/fragment.yaml index 5630a94..b408d6a 100644 --- a/src/site_engine/builtin/fragments/card_grid/fragment.yaml +++ b/src/site_engine/builtin/fragments/card_grid/fragment.yaml @@ -1,17 +1,49 @@ id: card_grid -name: Сетка карточек -category: content +name: Карточки +category: Контент version: 1 fields: - - {key: title, type: text} - - {key: variant, type: select, options: [features, steps, links], default: features} - - key: items - type: list +- key: title + type: text + label: Заголовок + hint: Короткий заголовок, понятный посетителю. +- key: variant + type: select + options: + - features + - steps + - links + default: features + label: Вариант оформления + hint: Вариант меняет оформление; содержимое остаётся в полях блока. +- key: items + type: list + required: true + fields: + - key: title + type: text required: true - fields: - - {key: title, type: text, required: true} - - {key: text, type: markdown} - - {key: link, type: link} - - {key: badge, type: text} + label: Заголовок + hint: Короткий заголовок, понятный посетителю. + - key: text + type: markdown + label: Текст + - key: link + type: link + label: Ссылка + - key: badge + type: text + label: Метка + label: Элементы slots: {} -preview: {variant: features} +preview: + title: Как мы работаем + variant: steps + items: + - title: Разбираемся в задаче + text: Описываем процесс и ограничения. + - title: Проверяем решение + text: Собираем прототип на одном сценарии. + - title: Внедряем и сопровождаем + text: Подключаем системы и передаём документацию. +description: Сетка преимуществ diff --git a/src/site_engine/builtin/fragments/collection_list/fragment.yaml b/src/site_engine/builtin/fragments/collection_list/fragment.yaml index 6e57826..583cbb6 100644 --- a/src/site_engine/builtin/fragments/collection_list/fragment.yaml +++ b/src/site_engine/builtin/fragments/collection_list/fragment.yaml @@ -1,13 +1,56 @@ id: collection_list -name: Список записей коллекции -category: collections +name: Список коллекций +category: Данные version: 1 fields: - - {key: title, type: text} - - {key: source, type: query, required: true} - - {key: card, type: select, options: [default, direction], default: default} - - {key: layout, type: select, options: [grid, list], default: grid} - - {key: empty, type: select, options: [hide, message], default: hide} - - {key: empty_message, type: text} +- key: title + type: text + label: Заголовок + hint: Название списка на странице. +- key: source + type: query + required: true + label: Какие записи показать + hint: Коллекция, фильтр, сортировка и ограничение количества. Черновики исключаются + автоматически. +- key: card + type: select + options: + - default + - direction + default: default + label: Вид карточки + hint: Вариант direction также показывает короткую подпись записи. +- key: layout + type: select + options: + - grid + - list + default: grid + label: Расположение + hint: Сетка карточек или вертикальный список. +- key: empty + type: select + options: + - hide + - message + default: hide + label: Пустой список + hint: Скрыть блок или показать сообщение, если записей нет. +- key: empty_message + type: text + label: Сообщение для пустого списка + hint: Текст при выборе варианта message. slots: {} -preview: {} +preview: + title: Записи коллекции + source: + query: + collection: services + sort: order + limit: 3 + card: direction + layout: grid + empty: message + empty_message: Записей пока нет. +description: Карточки, получаемые из collection diff --git a/src/site_engine/builtin/fragments/collection_list/style.css b/src/site_engine/builtin/fragments/collection_list/style.css index 22a67fe..16a6338 100644 --- a/src/site_engine/builtin/fragments/collection_list/style.css +++ b/src/site_engine/builtin/fragments/collection_list/style.css @@ -2,3 +2,6 @@ .f-collection_list__items { display: grid; gap: 1rem; padding: 0; margin: 0; } .f-collection_list--grid .f-collection_list__items { grid-template-columns: repeat(auto-fit, minmax(16rem, 1fr)); } .f-card__tagline { font-weight: 600; margin: 0 0 .4rem; } + +.f-collection_list__cover { display: block; width: 100%; aspect-ratio: 16 / 9; object-fit: cover; border-radius: .3rem; margin-bottom: .75rem; } +.f-collection_list__items > li { min-width: 0; } diff --git a/src/site_engine/builtin/fragments/collection_list/template.html.j2 b/src/site_engine/builtin/fragments/collection_list/template.html.j2 index 3deee40..c8294fb 100644 --- a/src/site_engine/builtin/fragments/collection_list/template.html.j2 +++ b/src/site_engine/builtin/fragments/collection_list/template.html.j2 @@ -5,6 +5,8 @@
    {% for e in props.source %}
  • + {% if e.get('cover') %}{{ e.get("cover_alt", "") }}{% endif %} + {% if e.get('demo') %}Демонстрационный кейс{% endif %}

    {{ e.title }}

    {% if props.card == 'direction' and e.get('tagline') %}

    {{ e.tagline }}

    {% endif %} {% if e.get('summary') %}

    {{ e.summary }}

    {% endif %} diff --git a/src/site_engine/builtin/fragments/columns/fragment.yaml b/src/site_engine/builtin/fragments/columns/fragment.yaml index 768141b..5bb2a3b 100644 --- a/src/site_engine/builtin/fragments/columns/fragment.yaml +++ b/src/site_engine/builtin/fragments/columns/fragment.yaml @@ -1,12 +1,22 @@ id: columns name: Колонки -category: layout +category: Компоновка version: 1 fields: - - {key: count, type: select, options: [2, 3, 4], default: 2} +- key: count + type: select + options: + - 2 + - 3 + - 4 + default: 2 + label: Количество колонок + hint: Заполняйте слоты col_1…col_N в соответствии с количеством колонок. slots: col_1: {} col_2: {} col_3: {} col_4: {} -preview: {count: 2} +preview: + count: 2 +description: Независимые блоки в двух, трёх или четырёх колонках diff --git a/src/site_engine/builtin/fragments/cta_banner/fragment.yaml b/src/site_engine/builtin/fragments/cta_banner/fragment.yaml index 83418d0..dfce917 100644 --- a/src/site_engine/builtin/fragments/cta_banner/fragment.yaml +++ b/src/site_engine/builtin/fragments/cta_banner/fragment.yaml @@ -1,11 +1,33 @@ id: cta_banner -name: Призыв к действию -category: conversion +name: CTA-баннер +category: Конверсия version: 1 fields: - - {key: title, type: text, required: true} - - {key: text, type: markdown} - - {key: variant, type: select, options: [contact, link, form], default: link} - - {key: actions, type: list, of: link} +- key: title + type: text + required: true + label: Заголовок + hint: Короткий заголовок, понятный посетителю. +- key: text + type: markdown + label: Текст +- key: variant + type: select + options: + - contact + - link + - form + default: link + label: Вариант оформления + hint: Вариант меняет оформление; содержимое остаётся в полях блока. +- key: actions + type: list + of: link + label: Кнопки и ссылки + hint: Ссылки на страницы, записи или внешние адреса. slots: {} -preview: {title: Расскажите о задаче, variant: contact} +preview: + title: Расскажите о задаче + text: Добавьте описание следующего шага. + variant: link +description: Контрастный призыв к действию diff --git a/src/site_engine/builtin/fragments/disclaimer/fragment.yaml b/src/site_engine/builtin/fragments/disclaimer/fragment.yaml index 0ee8424..4c67914 100644 --- a/src/site_engine/builtin/fragments/disclaimer/fragment.yaml +++ b/src/site_engine/builtin/fragments/disclaimer/fragment.yaml @@ -1,9 +1,18 @@ id: disclaimer -name: Пометка или оговорка -category: content +name: Пояснение +category: Контент version: 1 fields: - - {key: variant, type: select, options: [info, warning], default: info} - - {key: text, type: markdown, required: true} +- key: variant + type: select + options: + - info + - warning + default: info +- key: text + type: markdown + required: true slots: {} -preview: {text: Пояснение.} +preview: + text: Пояснение. +description: Важная оговорка или предупреждение для посетителя diff --git a/src/site_engine/builtin/fragments/entry_header/fragment.yaml b/src/site_engine/builtin/fragments/entry_header/fragment.yaml index 0d2e5f6..2df009f 100644 --- a/src/site_engine/builtin/fragments/entry_header/fragment.yaml +++ b/src/site_engine/builtin/fragments/entry_header/fragment.yaml @@ -1,9 +1,15 @@ id: entry_header -name: Шапка страницы записи -category: collections +name: Заголовок записи +category: Данные version: 1 fields: - - {key: title, type: text, required: true} - - {key: meta, type: list, of: text} +- key: title + type: text + required: true +- key: meta + type: list + of: text slots: {} -preview: {title: Заголовок записи} +preview: + title: Заголовок записи +description: Название и дополнительные сведения записи коллекции diff --git a/src/site_engine/builtin/fragments/faq/fragment.yaml b/src/site_engine/builtin/fragments/faq/fragment.yaml index 51354fb..57720a3 100644 --- a/src/site_engine/builtin/fragments/faq/fragment.yaml +++ b/src/site_engine/builtin/fragments/faq/fragment.yaml @@ -1,14 +1,29 @@ id: faq -name: Вопросы и ответы -category: content +name: FAQ +category: Контент version: 1 fields: - - {key: title, type: text} - - key: items - type: list +- key: title + type: text + label: Заголовок + hint: Короткий заголовок, понятный посетителю. +- key: items + type: list + required: true + fields: + - key: q + type: text required: true - fields: - - {key: q, type: text, required: true} - - {key: a, type: markdown, required: true} + label: Вопрос + - key: a + type: markdown + required: true + label: Ответ + label: Элементы slots: {} -preview: {} +preview: + title: Частые вопросы + items: + - q: С чего начать? + a: Опишите задачу и текущий процесс. Мы предложим следующий шаг. +description: Частые вопросы diff --git a/src/site_engine/builtin/fragments/form/fragment.yaml b/src/site_engine/builtin/fragments/form/fragment.yaml index c5e1cb9..0d805f4 100644 --- a/src/site_engine/builtin/fragments/form/fragment.yaml +++ b/src/site_engine/builtin/fragments/form/fragment.yaml @@ -1,8 +1,11 @@ id: form -name: Форма обратной связи -category: conversion +name: Форма +category: Конверсия version: 1 fields: - - {key: form, type: text, required: true} +- key: form + type: text + required: true slots: {} preview: {} +description: Поля формы по выбранной схеме diff --git a/src/site_engine/builtin/fragments/hero/fragment.yaml b/src/site_engine/builtin/fragments/hero/fragment.yaml index 3f7816b..5f2c76d 100644 --- a/src/site_engine/builtin/fragments/hero/fragment.yaml +++ b/src/site_engine/builtin/fragments/hero/fragment.yaml @@ -1,13 +1,41 @@ id: hero -name: Hero-баннер -category: marketing +name: Hero +category: Первый экран version: 1 fields: - - {key: title, type: text, required: true, max: 120} - - {key: subtitle, type: markdown} - - {key: image, type: asset} - - {key: image_alt, type: text} - - {key: actions, type: list, of: link} - - {key: variant, type: select, options: [light, dark, split], default: light} +- key: title + type: text + required: true + max: 120 + label: Заголовок + hint: Короткий заголовок, понятный посетителю. +- key: subtitle + type: markdown + label: Описание первого экрана +- key: image + type: asset + label: Изображение +- key: image_alt + type: text + label: Описание изображения + hint: Опишите смысл изображения для посетителя, который его не видит. +- key: actions + type: list + of: link + label: Кнопки и ссылки + hint: Ссылки на страницы, записи или внешние адреса. +- key: variant + type: select + options: + - light + - dark + - split + default: light + label: Вариант оформления + hint: Вариант меняет оформление; содержимое остаётся в полях блока. slots: {} -preview: {title: Заголовок страницы, variant: dark} +preview: + title: Заголовок страницы + subtitle: Краткое описание предложения. + variant: dark +description: Заголовок, подзаголовок и действие diff --git a/src/site_engine/builtin/fragments/image/fragment.yaml b/src/site_engine/builtin/fragments/image/fragment.yaml index 62ebe2d..54b8713 100644 --- a/src/site_engine/builtin/fragments/image/fragment.yaml +++ b/src/site_engine/builtin/fragments/image/fragment.yaml @@ -1,10 +1,22 @@ id: image name: Изображение -category: content +category: Медиа version: 1 fields: - - {key: asset, type: asset, required: true} - - {key: alt, type: text, required: true} - - {key: caption, type: text} +- key: asset + type: asset + required: true + label: Изображение + hint: Файл из assets сайта. +- key: alt + type: text + required: true + label: Описание изображения + hint: Опишите смысл изображения для посетителя, который его не видит. +- key: caption + type: text + label: Подпись + hint: Необязательная подпись под изображением. slots: {} preview: {} +description: Asset из медиатеки с подписью diff --git a/src/site_engine/builtin/fragments/page_header/fragment.yaml b/src/site_engine/builtin/fragments/page_header/fragment.yaml index 0791d6b..d0d5a9e 100644 --- a/src/site_engine/builtin/fragments/page_header/fragment.yaml +++ b/src/site_engine/builtin/fragments/page_header/fragment.yaml @@ -1,10 +1,22 @@ id: page_header name: Заголовок страницы -category: marketing +category: Первый экран version: 1 fields: - - {key: title, type: text, required: true} - - {key: lead, type: markdown} - - {key: breadcrumbs, type: boolean, default: true} +- key: title + type: text + required: true + label: Заголовок + hint: Короткий заголовок, понятный посетителю. +- key: lead + type: markdown + label: Вводный текст +- key: breadcrumbs + type: boolean + default: true + label: Хлебные крошки slots: {} -preview: {title: Заголовок} +preview: + title: Новый раздел + lead: Кратко объясните, что посетитель найдёт на странице. +description: Название страницы, вводный текст и хлебные крошки diff --git a/src/site_engine/builtin/fragments/richtext/fragment.yaml b/src/site_engine/builtin/fragments/richtext/fragment.yaml index b3cfc57..7c69312 100644 --- a/src/site_engine/builtin/fragments/richtext/fragment.yaml +++ b/src/site_engine/builtin/fragments/richtext/fragment.yaml @@ -1,8 +1,15 @@ id: richtext -name: Текст -category: content +name: Markdown body +category: Контент version: 1 fields: - - {key: content, type: markdown, required: true} +- key: content + type: markdown + required: true + label: Текст в Markdown + hint: Поддерживает Markdown. Для текста страницы используйте привязку page.body. slots: {} -preview: {content: Текст **страницы**.} +preview: + content: + bind: page.body +description: Выводит Markdown из файла страницы diff --git a/src/site_engine/builtin/fragments/section/fragment.yaml b/src/site_engine/builtin/fragments/section/fragment.yaml index ecfee67..fd90e14 100644 --- a/src/site_engine/builtin/fragments/section/fragment.yaml +++ b/src/site_engine/builtin/fragments/section/fragment.yaml @@ -1,11 +1,38 @@ id: section -name: Секция -category: layout +name: Текстовая секция +category: Контент version: 1 fields: - - {key: title, type: text} - - {key: background, type: select, options: [none, muted, primary], default: none} - - {key: width, type: select, options: [narrow, normal, wide], default: normal} +- key: title + type: text + label: Заголовок + hint: Короткий заголовок, понятный посетителю. +- key: text + type: markdown + label: Текст секции + hint: Содержимое этой секции. Для Markdown из файла страницы используйте блок Markdown + body. +- key: background + type: select + options: + - none + - muted + - primary + default: none + label: Фон +- key: width + type: select + options: + - narrow + - normal + - wide + default: normal + label: Ширина содержимого slots: content: {} -preview: {title: Секция} +preview: + title: Почему мы + text: Разрабатываем решения под конкретные задачи бизнеса. + background: none + width: normal +description: Заголовок и содержимое секции diff --git a/src/site_engine/builtin/fragments/section/template.html.j2 b/src/site_engine/builtin/fragments/section/template.html.j2 index d6a011e..41f1511 100644 --- a/src/site_engine/builtin/fragments/section/template.html.j2 +++ b/src/site_engine/builtin/fragments/section/template.html.j2 @@ -1,6 +1,7 @@
    {% if props.title %}

    {{ props.title }}

    {% endif %} + {% if props.text %}
    {{ props.text|md }}
    {% endif %} {{ slots.content }}
    diff --git a/src/site_engine/builtin/fragments/site_footer/fragment.yaml b/src/site_engine/builtin/fragments/site_footer/fragment.yaml index 5635041..fd27ce8 100644 --- a/src/site_engine/builtin/fragments/site_footer/fragment.yaml +++ b/src/site_engine/builtin/fragments/site_footer/fragment.yaml @@ -1,9 +1,14 @@ id: site_footer name: Подвал сайта -category: global +category: Каркас version: 1 fields: - - {key: menu, type: text, default: footer} - - {key: note, type: text} +- key: menu + type: text + default: footer +- key: note + type: text slots: {} -preview: {menu: footer} +preview: + menu: footer +description: Меню, контакты и сведения о компании diff --git a/src/site_engine/builtin/fragments/site_header/fragment.yaml b/src/site_engine/builtin/fragments/site_header/fragment.yaml index c6372dd..39b81f0 100644 --- a/src/site_engine/builtin/fragments/site_header/fragment.yaml +++ b/src/site_engine/builtin/fragments/site_header/fragment.yaml @@ -1,9 +1,14 @@ id: site_header name: Шапка сайта -category: global +category: Каркас version: 1 fields: - - {key: menu, type: text, default: main} - - {key: action, type: link} +- key: menu + type: text + default: main +- key: action + type: link slots: {} -preview: {menu: main} +preview: + menu: main +description: Логотип, меню и основное действие diff --git a/src/site_engine/cli.py b/src/site_engine/cli.py index 9490d67..154d0b9 100644 --- a/src/site_engine/cli.py +++ b/src/site_engine/cli.py @@ -93,6 +93,21 @@ def gen_secret_cmd() -> None: click.echo(secrets.token_urlsafe(48)) +@main.command("export-openapi") +@click.option("--out", type=click.Path(path_type=Path), default=None, help="JSON file; default stdout") +def export_openapi(out: Path | None) -> None: + """Export Admin API v1 without loading secrets or changing the site (requires server extra).""" + import json + + from .web.api.export import schema + + text = json.dumps(schema(), ensure_ascii=False, indent=2, sort_keys=True) + "\n" + if out: + out.write_text(text, encoding="utf-8") + else: + click.echo(text, nl=False) + + @main.command() @click.option("--site", type=click.Path(exists=True, file_okay=False, path_type=Path), default=None) def fragments(site: Path | None) -> None: diff --git a/src/site_engine/core/models.py b/src/site_engine/core/models.py index c96a8bc..ec12183 100644 --- a/src/site_engine/core/models.py +++ b/src/site_engine/core/models.py @@ -35,7 +35,7 @@ class Block: id: str fragment: str props: dict = field(default_factory=dict) - slots: dict[str, list["Block"]] = field(default_factory=dict) + slots: dict[str, list[Block]] = field(default_factory=dict) hidden: bool = False anchor: str | None = None note: str | None = None @@ -132,7 +132,7 @@ class FieldDef: options: list = field(default_factory=list) label: str | None = None to: str | None = None - fields: list["FieldDef"] = field(default_factory=list) + fields: list[FieldDef] = field(default_factory=list) of: str | None = None extra: dict = field(default_factory=dict) @@ -201,6 +201,7 @@ class Fragment: script: str | None = None builtin: bool = False dir: Path | None = None + description: str = "" def parse_fragment( @@ -227,6 +228,10 @@ def parse_fragment( slots = {} style = directory / "style.css" script = directory / "script.js" + description = raw.get("description", "") + if not isinstance(description, str): + report.add("E_FRAGMENT_DESCRIPTION", "description: ожидается строка", rel) + description = "" return Fragment( id=fid, name=str(raw.get("name", fid)), category=str(raw.get("category", "misc")), version=version, fields=parse_fields(raw.get("fields"), f"{rel}:fields", report), @@ -234,7 +239,7 @@ def parse_fragment( template=template_file.read_text(encoding="utf-8"), style=style.read_text(encoding="utf-8") if style.is_file() else None, script=script.read_text(encoding="utf-8") if script.is_file() else None, - builtin=builtin, dir=directory, + builtin=builtin, dir=directory, description=description, ) diff --git a/src/site_engine/core/page_ops.py b/src/site_engine/core/page_ops.py index 946cfde..9e58a15 100644 --- a/src/site_engine/core/page_ops.py +++ b/src/site_engine/core/page_ops.py @@ -6,6 +6,7 @@ from __future__ import annotations +import copy import secrets import string from typing import Iterator @@ -57,10 +58,10 @@ def find_block(meta: dict, block_id: str) -> tuple[list, int, dict] | None: return None -def new_block_id(meta: dict) -> str: +def new_block_id(meta: dict, fragment_id: str) -> str: taken = all_ids(meta) while True: - candidate = "b_" + "".join(secrets.choice(_ALPHABET) for _ in range(5)) + candidate = fragment_id + "_" + "".join(secrets.choice(_ALPHABET) for _ in range(5)) if candidate not in taken: return candidate @@ -68,7 +69,7 @@ def new_block_id(meta: dict) -> str: def add_block(meta: dict, fragment_id: str, *, region: str | None = None, parent: str | None = None, slot: str | None = None) -> str: """Добавляет пустой блок в конец региона или слота родителя. Возвращает id нового блока.""" - block = {"id": new_block_id(meta), "fragment": fragment_id} + block = {"id": new_block_id(meta, fragment_id), "fragment": fragment_id} if parent: found = find_block(meta, parent) if found is None or not slot: @@ -106,6 +107,19 @@ def delete_block(meta: dict, block_id: str) -> None: del siblings[index] +def duplicate_block(meta: dict, block_id: str) -> str: + found = find_block(meta, block_id) + if found is None: + raise KeyError(block_id) + siblings, index, block = found + cloned = copy.deepcopy(block) + siblings.insert(index + 1, cloned) + for node in _blocks_of(cloned): + node["id"] = new_block_id(meta, node["fragment"]) + node.pop("anchor", None) + return cloned["id"] + + def set_hidden(meta: dict, block_id: str, hidden: bool) -> None: found = find_block(meta, block_id) if found is None: diff --git a/src/site_engine/core/preview_marks.py b/src/site_engine/core/preview_marks.py new file mode 100644 index 0000000..03ceb43 --- /dev/null +++ b/src/site_engine/core/preview_marks.py @@ -0,0 +1,56 @@ +"""Attach markers to existing fragment roots, without inserting layout wrappers.""" + +from html import escape +from html.parser import HTMLParser + +VOID = { + "area", + "base", + "br", + "col", + "embed", + "hr", + "img", + "input", + "link", + "meta", + "param", + "source", + "track", + "wbr", +} + + +class Roots(HTMLParser): + def __init__(self, html, attrs): + super().__init__(convert_charrefs=False) + self.html, self.attrs, self.depth, self.offsets = html, attrs, 0, [] + self.lines = html.splitlines(keepends=True) + self.feed(html) + + def handle_starttag(self, tag, attrs): + if self.depth == 0 and not any(k == "data-preview-id" for k, _ in attrs): + line, col = self.getpos() + self.offsets.append(sum(map(len, self.lines[: line - 1])) + col + len(tag) + 1) + if tag not in VOID: + self.depth += 1 + + def handle_startendtag(self, tag, attrs): + depth = self.depth + self.handle_starttag(tag, attrs) + self.depth = depth + + def handle_endtag(self, tag): + if tag not in VOID: + self.depth = max(0, self.depth - 1) + + +def mark_roots(html: str, scope: str, owner: str, block_id: str) -> str: + attrs = "".join( + f' data-preview-{k}="{escape(v, quote=True)}"' + for k, v in {"scope": scope, "owner": owner, "id": block_id}.items() + ) + parser = Roots(html, attrs) + for at in reversed(parser.offsets): + html = html[:at] + attrs + html[at:] + return html diff --git a/src/site_engine/core/render.py b/src/site_engine/core/render.py index c3b48e5..fd04403 100644 --- a/src/site_engine/core/render.py +++ b/src/site_engine/core/render.py @@ -109,13 +109,14 @@ def _is_active(url: str, route: str) -> bool: class Renderer: def __init__( self, reg: Registry, table: dict[str, RouteRef], report: Report, *, - strict: bool = True, now: dt.datetime | None = None, build_id: str = "", + strict: bool = True, now: dt.datetime | None = None, build_id: str = "", preview_mode: bool = False, ): self.reg = reg self.table = table self.report = report self.strict = strict self.build_id = build_id + self.preview_mode = preview_mode self.now = now or dt.datetime.now(dt.timezone.utc) self.resolver = Resolver(reg, table, report, strict) templates = {f"layout/{lid}": l.template for lid, l in reg.layouts.items()} @@ -268,7 +269,7 @@ class Renderer: return Props({fd.key: self._field(fd, block.props.get(fd.key), st, f"{path}.props.{fd.key}") for fd in fragment.fields}) # ── блоки ───────────────────────────────────────────────────────────── - def _block(self, block: Block, st: _State, where: str) -> Markup: + def _block(self, block: Block, st: _State, where: str, scope: str = "page", owner: str = "") -> Markup: path = f"{where}[{block.id}]" if block.hidden or not self._feature_on(block.requires): return Markup("") @@ -279,11 +280,14 @@ class Renderer: st.used.add(fragment.id) props = self._props(block, fragment, st, path) slots = { - name: Markup("".join(str(self._block(c, st, f"{path}.slots.{name}")) for c in block.slots.get(name, []))) + name: Markup("".join(str(self._block(c, st, f"{path}.slots.{name}", scope, owner)) for c in block.slots.get(name, []))) for name in fragment.slots } ctx = {**st.ctx, "props": props, "slots": slots, "block": {"id": block.id, "anchor": block.anchor}} html = self.env.get_template(f"fragment/{fragment.id}").render(ctx) + if self.preview_mode: + from .preview_marks import mark_roots + html = mark_roots(html, scope, owner or st.view.id, block.id) if block.anchor: html = f"" + html return Markup(html) @@ -347,9 +351,15 @@ class Renderer: return Markup("") out = [] for b in rdef.fixed: - out.append(str(self._block(b, st, f"layouts/{layout.id}/layout.yaml:regions.{name}.fixed"))) + out.append(str(self._block(b, st, f"layouts/{layout.id}/layout.yaml:regions.{name}.fixed", "layout", layout.id))) for b in view.regions.get(name, []): - out.append(str(self._block(b, st, f"{view.source}:regions.{name}"))) + scope, owner = "page", view.id + if self.preview_mode and view.entry: + scope = "entry" + display = self.reg.displays.get(view.collection.display or view.collection.id) + if display and any(b is d for ds in display.regions.values() for d in ds): + scope, owner = "display", view.collection.display or view.collection.id + out.append(str(self._block(b, st, f"{view.source}:regions.{name}", scope, owner))) return Markup("".join(out)) html = self.env.get_template(f"layout/{layout.id}").render({ diff --git a/src/site_engine/parsing/yamlio.py b/src/site_engine/parsing/yamlio.py index 6535e26..b76c5ac 100644 --- a/src/site_engine/parsing/yamlio.py +++ b/src/site_engine/parsing/yamlio.py @@ -15,10 +15,28 @@ class YamlError(ValueError): class _NoAliasLoader(yaml.SafeLoader): + def construct_mapping(self, node, deep=False): + keys = set() + for key_node, _ in node.value: + key = self.construct_object(key_node, deep=deep) + try: + if key in keys: + raise yaml.YAMLError(f"повтор ключа YAML: {key!r}") + keys.add(key) + except TypeError as exc: + raise yaml.YAMLError("ключ YAML должен быть скалярным") from exc + return super().construct_mapping(node, deep=deep) + def compose_node(self, parent, index): # type: ignore[override] if self.check_event(yaml.events.AliasEvent): raise yaml.YAMLError("алиасы YAML запрещены") - return super().compose_node(parent, index) + self._node_depth = getattr(self, "_node_depth", 0) + 1 + try: + if self._node_depth > MAX_DEPTH + 1: + raise yaml.YAMLError(f"вложенность YAML больше {MAX_DEPTH}") + return super().compose_node(parent, index) + finally: + self._node_depth -= 1 def _depth(obj: Any, level: int = 0) -> int: diff --git a/src/site_engine/services/content.py b/src/site_engine/services/content.py index 605c905..753781e 100644 --- a/src/site_engine/services/content.py +++ b/src/site_engine/services/content.py @@ -9,6 +9,7 @@ from __future__ import annotations from pathlib import Path +from collections.abc import Callable from ..errors import ConflictError, EngineError, Report, UnsafePathError from ..parsing import frontmatter @@ -28,8 +29,10 @@ class ContentService: def _resolve(self, rel: str) -> Path: path = safe_join(self.root, rel) - if self.allowed_prefixes is not None and not rel.startswith(self.allowed_prefixes): - raise UnsafePathError(f"запись в «{rel}» не разрешена для этой роли") + if self.allowed_prefixes is not None: + actual = path.relative_to(self.root.resolve()).as_posix() + if not rel.startswith(self.allowed_prefixes) or not actual.startswith(self.allowed_prefixes): + raise UnsafePathError(f"запись в «{rel}» не разрешена для этой роли") return path def read(self, rel: str) -> tuple[str, str]: @@ -52,13 +55,22 @@ class ContentService: def write(self, rel: str, text: str, if_match: str) -> str: """Записывает файл; возвращает новый etag. Конфликт версий → ConflictError (HTTP 409).""" - path = self._resolve(rel) - self._check_syntax(rel, text) + return self.update(rel, if_match, lambda _: text) + + def update(self, rel: str, if_match: str, prepare: Callable[[str | None], str]) -> str: + """One lock owns reread, CAS, current-schema validation, history and write. + + prepare must not acquire SiteLock or call public write/update recursively. + It receives the exact current source (None for a newly created file). + """ with SiteLock(self.root): + path = self._resolve(rel) current = file_etag(path) expected = current if current is not None else ABSENT if if_match != expected: raise ConflictError(f"{rel}: файл изменился (ожидали {if_match}, сейчас {expected})", expected) + text = prepare(path.read_text(encoding="utf-8") if current is not None else None) + self._check_syntax(rel, text) save_previous(self.root, rel) atomic_write(path, text) return etag_of(text.encode("utf-8")) diff --git a/src/site_engine/services/documents.py b/src/site_engine/services/documents.py new file mode 100644 index 0000000..05d060f --- /dev/null +++ b/src/site_engine/services/documents.py @@ -0,0 +1,372 @@ +"""Framework-independent document snapshots, buffer operations and explicit saves.""" + +from __future__ import annotations + +import copy +import re +from dataclasses import asdict, dataclass +from pathlib import Path + +from ..core import page_ops +from ..core.draft_check import check_entry_text, check_page_text +from ..core.models import parse_entry, parse_page +from ..core.registry import Registry, load_site +from ..errors import EngineError, Report, UnsafePathError +from ..parsing import frontmatter +from ..parsing.yamlio import YamlError +from ..storage.fs import safe_join +from .auth import AuditLog, Principal +from .content import ABSENT, ContentService + +ID_RE = re.compile(r"^[a-z0-9][a-z0-9_-]*(/[a-z0-9][a-z0-9_-]*)*$") +RESERVED = {"new", "blocks", "add", "meta"} + + +@dataclass(frozen=True) +class EditorContext: + principal: Principal + ip: str = "" + source: str = "admin-ui" + + +@dataclass +class DocumentSnapshot: + kind: str + id: str + path: str + source: str + etag: str + model: dict | None + report: Report + schema: dict + revision: int = 0 + + +class DocumentMissing(EngineError): + pass + + +class AuditCommitError(EngineError): + def __init__(self, snapshot: DocumentSnapshot): + super().__init__( + "Файл сохранён, но аудит недоступен. Проверьте серверную версию перед повтором." + ) + self.snapshot = snapshot + + +class DocumentService: + kind = "page" + + def __init__(self, root: Path, audit: AuditLog | None = None, collection: str = ""): + self.root, self.audit, self.collection = Path(root), audit, collection + self.content = ContentService(self.root, allowed_prefixes=("pages/", "content/")) + + def registry(self) -> Registry: + return load_site(self.root) + + def _path(self, reg: Registry, identity: str, *, create: bool = False) -> str: + if not ID_RE.fullmatch(identity) or RESERVED & set(identity.split("/")): + raise DocumentMissing("Недопустимый идентификатор документа") + if self.kind == "page": + obj = reg.pages.get(identity) + if obj: + return obj.file + rel = f"pages/{identity}.md" + else: + if "/" in identity or self.collection not in reg.collections: + raise DocumentMissing("Нет коллекции или записи") + obj = next( + (e for e in reg.entries.get(self.collection, []) if e.slug == identity), None + ) + if obj: + return obj.file + rel = f"content/{self.collection}/{identity}.md" + # Malformed documents omitted by Registry still need Expert recovery. + if not create and not safe_join(self.root, rel).is_file(): + raise DocumentMissing("Документ не найден") + return rel + + def _schema(self, reg: Registry, model: dict | None, identity: str) -> dict: + layout = None + if self.kind == "page" and model: + page = parse_page( + model["meta"], model["body"], identity, f"pages/{identity}.md", Report() + ) + layout = reg.layouts.get(reg.effective_layout(page)) if page else None + elif self.collection in reg.collections: + display = reg.displays.get(reg.collections[self.collection].display or self.collection) + layout = reg.layouts.get(display.layout) if display else None + regions = ( + { + name: {"allow": value.allow, "fixed": [asdict(b) for b in value.fixed]} + for name, value in layout.regions.items() + } + if layout + else {} + ) + display_regions = {} + if self.kind == "entry": + display = reg.displays.get(reg.collections[self.collection].display or self.collection) + display_regions = ( + {name: [asdict(b) for b in blocks] for name, blocks in display.regions.items()} + if display + else {} + ) + assets = self.root / "assets" + asset_choices = [] + if assets.is_dir() and not assets.is_symlink(): + for path in assets.rglob("*"): + if path.is_file() and not any( + p.is_symlink() for p in [path, *path.parents] if p != self.root + ): + asset_choices.append(path.relative_to(self.root).as_posix()) + return { + "owner": identity if self.kind == "page" else f"{self.collection}/{identity}", + "display_owner": (reg.collections[self.collection].display or self.collection) + if self.kind == "entry" + else "", + "layouts": sorted(reg.layouts), + "layout": layout.id if layout else None, + "regions": regions, + "display": display_regions, + "features": reg.site.features, + "fragments": { + fid: { + "name": f.name, + "description": f.description, + "category": f.category, + "preview": f.preview, + "fields": [asdict(fd) for fd in f.fields], + "slots": f.slots, + } + for fid, f in reg.fragments.items() + }, + "fields": [asdict(fd) for fd in reg.collections[self.collection].fields] + if self.kind == "entry" + else [], + "has_body": self.kind == "page" or reg.collections[self.collection].body == "markdown", + "preview": self.kind == "page" or reg.collections[self.collection].kind != "taxonomy", + "choices": { + "pages": sorted(reg.pages), + "page_titles": {pid: page.title for pid, page in reg.pages.items()}, + "collections": sorted(reg.collections), + "entries": { + cid: sorted(e.slug for e in items) for cid, items in reg.entries.items() + }, + "assets": sorted(asset_choices)[:500], + }, + } + + def snapshot( + self, reg: Registry, identity: str, rel: str, source: str, etag: str, revision: int = 0 + ) -> DocumentSnapshot: + report = Report() + model = None + try: + meta, body = frontmatter.parse(source) + report = ( + check_page_text(reg, identity, rel, source) + if self.kind == "page" + else check_entry_text(reg, self.collection, identity, rel, source) + ) + if self.kind == "entry" and meta.get("slug", identity) != identity: + report.add("E_IDENTITY", "Изменение slug требует отдельной операции rename", rel) + # Schema diagnostics may contain warnings, but invalid source never becomes a UI model. + if not report.errors: + model = {"meta": meta, "body": body} + except (YamlError, TypeError, ValueError, AttributeError) as exc: + report.add("E_DOCUMENT", str(exc), rel) + return DocumentSnapshot( + self.kind, + identity, + rel, + source, + etag, + model, + report, + self._schema(reg, model, identity), + revision, + ) + + def get(self, identity: str) -> DocumentSnapshot: + reg = self.registry() + rel = self._path(reg, identity) + source, etag = self.content.read(rel) + return self.snapshot(reg, identity, rel, source, etag) + + def validate_source( + self, identity: str, source: str, etag: str, revision: int = 0 + ) -> DocumentSnapshot: + reg = self.registry() + return self.snapshot(reg, identity, self._path(reg, identity), source, etag, revision) + + def transform_buffer( + self, identity: str, source: str, etag: str, action: dict, revision: int = 0 + ) -> DocumentSnapshot: + before = self.validate_source(identity, source, etag, revision) + if before.report.errors: + return before + meta, body = copy.deepcopy(before.model["meta"]), before.model["body"] + try: + op = action["type"] + if op == "metadata": + allowed = ( + {"title", "status", "layout", "route", "seo", "nav", "editorial"} + if self.kind == "page" + else {"status"} + ) + if set(action.get("values", {})) - allowed: + raise ValueError("Недопустимое поле документа") + for key, value in action.get("values", {}).items(): + if value is None: + meta.pop(key, None) + else: + meta[key] = value + if action.get("body") is not None: + body = action["body"] + elif op == "entry_fields" and self.kind == "entry": + fields = {f["key"] for f in before.schema["fields"]} + if (set(action.get("values", {})) | set(action.get("unset", []))) - fields: + raise ValueError("Неизвестное поле коллекции") + meta.update(action.get("values", {})) + for key in action.get("unset", []): + meta.pop(key, None) + if action.get("body") is not None: + body = action["body"] + if action.get("status") is not None: + meta["status"] = action["status"] + elif self.kind == "page" and op in { + "block", + "add", + "delete", + "toggle", + "move", + "duplicate", + }: + bid = action.get("block_id", "") + found = page_ops.find_block(meta, bid) + if op == "add": + if action["fragment"] not in before.schema["fragments"]: + raise ValueError("Нет такого фрагмента") + added = page_ops.add_block( + meta, + action["fragment"], + region=action.get("region"), + parent=action.get("parent"), + slot=action.get("slot"), + ) + page_ops.find_block(meta, added)[2]["props"] = copy.deepcopy( + action.get("props", {}) + ) + elif not found: + raise ValueError("Блок не найден или доступен только для чтения") + elif op == "block": + block = found[2] + for key, value in action.get("values", {}).items(): + if key not in {"props", "hidden", "anchor", "note", "requires"}: + raise ValueError("Недопустимое поле блока") + block[key] = value + elif op == "delete": + page_ops.delete_block(meta, bid) + elif op == "duplicate": + page_ops.duplicate_block(meta, bid) + elif op == "toggle": + page_ops.set_hidden(meta, bid, not found[2].get("hidden", False)) + elif action.get("direction"): + page_ops.move_block(meta, bid, action["direction"]) + else: + sibling_id = action.get("before") or action.get("after") + target = page_ops.find_block(meta, sibling_id) if sibling_id else None + if not target or sibling_id in page_ops.all_ids({"regions": {"x": [found[2]]}}): + raise ValueError("Недопустимая цель перемещения или цикл") + block = found[2] + found[0].remove(block) + index = target[0].index(target[2]) + (1 if action.get("after") else 0) + target[0].insert(index, block) + else: + raise ValueError("Операция недоступна для этого документа") + transformed = self.validate_source( + identity, frontmatter.dumps(meta, body), etag, revision + ) + if transformed.report.errors: + # A refused structural action must keep the valid input buffer/tree. + before.report = transformed.report + return before + return transformed + except (KeyError, ValueError, TypeError) as exc: + before.report.add("E_OPERATION", str(exc), before.path) + return before + + def _saved(self, context: EditorContext, result: DocumentSnapshot, event: str) -> None: + if self.audit: + try: + self.audit.write( + event, + actor=context.principal.login, + object=result.path, + ip=context.ip, + source=context.source, + ) + except OSError as exc: + raise AuditCommitError(result) from exc + + def save_source( + self, identity: str, source: str, etag: str, context: EditorContext, revision: int = 0 + ) -> DocumentSnapshot: + rel = self._path(self.registry(), identity) + result = None + + def prepare(current): + nonlocal result + reg = self.registry() + if self._path(reg, identity) != rel: + raise UnsafePathError("Идентичность файла изменилась") + result = self.snapshot(reg, identity, rel, source, etag, revision) + if result.report.errors: + raise EngineError("Документ не сохранён", result.report) + return source + + new_etag = self.content.update(rel, etag, prepare) + result.etag = new_etag + self._saved(context, result, f"{self.kind}_save") + return result + + def create( + self, identity: str, title: str, layout: str | None, context: EditorContext + ) -> DocumentSnapshot: + if not ID_RE.fullmatch(identity) or RESERVED & set(identity.split("/")): + raise EngineError("Недопустимый идентификатор нового документа") + reg = self.registry() + rel = self._path(reg, identity, create=True) + meta = {"title": title, "status": "draft"} if self.kind == "page" else {"status": "draft"} + if layout and self.kind == "page": + meta["layout"] = layout + source = frontmatter.dumps(meta) + result = None + + def prepare(current): + nonlocal result + result = self.snapshot(self.registry(), identity, rel, source, ABSENT) + if result.report.errors: + raise EngineError("Документ не создан", result.report) + return source + + result_etag = self.content.update(rel, ABSENT, prepare) + result.etag = result_etag + self._saved(context, result, f"{self.kind}_create") + return result + + def overlay(self, identity: str, source: str, etag: str) -> tuple[Registry, DocumentSnapshot]: + reg = self.registry() + result = self.snapshot(reg, identity, self._path(reg, identity), source, etag) + if result.report.errors: + raise EngineError("Превью недоступно: исправьте документ", result.report) + meta, body = result.model["meta"], result.model["body"] + if self.kind == "page": + reg.pages[identity] = parse_page(meta, body, identity, result.path, Report()) + else: + entry = parse_entry(meta, body, self.collection, identity, result.path, Report()) + reg.entries[self.collection] = [ + entry if e.slug == identity else e for e in reg.entries[self.collection] + ] + return reg, result diff --git a/src/site_engine/services/entries.py b/src/site_engine/services/entries.py new file mode 100644 index 0000000..72c75e6 --- /dev/null +++ b/src/site_engine/services/entries.py @@ -0,0 +1,7 @@ +"""Collection Entry operations share validation and persistence with PageService.""" + +from .documents import DocumentService + + +class EntryService(DocumentService): + kind = "entry" diff --git a/src/site_engine/services/pages.py b/src/site_engine/services/pages.py new file mode 100644 index 0000000..d470c45 --- /dev/null +++ b/src/site_engine/services/pages.py @@ -0,0 +1,7 @@ +"""Page operations share the canonical document buffer and persistence boundary.""" + +from .documents import DocumentService + + +class PageService(DocumentService): + kind = "page" diff --git a/src/site_engine/services/preview.py b/src/site_engine/services/preview.py new file mode 100644 index 0000000..9f249fb --- /dev/null +++ b/src/site_engine/services/preview.py @@ -0,0 +1,314 @@ +"""Immutable short-lived preview snapshots. Only the admin process writes them.""" + +from __future__ import annotations + +import base64 +import hashlib +import hmac +import ipaddress +import json +import logging +import os +import posixpath +import re +import secrets +import shutil +import threading +import time +from dataclasses import dataclass +from html.parser import HTMLParser +from pathlib import Path +from urllib.parse import quote, urlsplit + +from ..build.pipeline import _bundle, make_views +from ..core.render import ASSETS_BODY, ASSETS_HEAD, Renderer +from ..core.routes import build_route_table +from ..errors import EngineError, Report, UnsafePathError +from ..storage.fs import atomic_write, safe_join + + +def origin(value): + parts = urlsplit(value) + if ( + parts.scheme not in {"https", "http"} + or not parts.netloc + or parts.path + or parts.query + or parts.fragment + or parts.username + ): + raise ValueError("Origin должен содержать только схему, host и порт, без завершающего /") + try: + local = parts.hostname == "localhost" or ipaddress.ip_address(parts.hostname).is_loopback + except ValueError: + local = False + if parts.scheme == "http" and not local: + raise ValueError("HTTP разрешён только для loopback; для production нужен HTTPS") + port = parts.port + host = parts.hostname.lower() + if ":" in host: + host = "[" + host + "]" + return ( + parts.scheme.lower() + + "://" + + host + + (f":{port}" if port and port != {"http": 80, "https": 443}[parts.scheme] else "") + ) + + +@dataclass(frozen=True) +class PreviewConfig: + admin: str + preview: str + + @classmethod + def from_env(cls): + a, p = os.getenv("SITE_ADMIN_ORIGIN", ""), os.getenv("SITE_PREVIEW_ORIGIN", "") + if not a and not p: + return None + if not a or not p or origin(a) == origin(p): + raise ValueError( + "SITE_ADMIN_ORIGIN и SITE_PREVIEW_ORIGIN должны быть разными точными origin" + ) + return cls(origin(a), origin(p)) + + +def asset_path(root: Path, rel: str) -> Path: + if any(p in {"..", ".", ""} for p in rel.split("/")) or "\\" in rel: + raise UnsafePathError("Недопустимый путь ассета") + path = safe_join(root, rel) + candidate = root + if root.is_symlink(): + raise UnsafePathError("Symlink ассета запрещён") + for part in Path(rel).parts: + candidate = candidate / part + if candidate.is_symlink(): + raise UnsafePathError("Symlink ассета запрещён") + if not path.is_file(): + raise FileNotFoundError(rel) + return path + + +class RedactPreviewTokens(logging.Filter): + def filter(self, record): + if isinstance(record.args, tuple): + record.args = tuple( + re.sub(r"([?&]token=)[^ &]+", r"\1[redacted]", v) if isinstance(v, str) else v + for v in record.args + ) + return True + + +logging.getLogger("uvicorn.access").addFilter(RedactPreviewTokens()) + + +def rewrite_assets(text, prefix, token): + return re.sub( + r"/assets/([^\s)'\";,<>]+)", + lambda m: prefix + m[1] + ("&" if "?" in m[1] else "?") + "token=" + token, + text, + ) + + +def rewrite_css(text, rel, prefix, token): + def resource(value): + parts = urlsplit(value.strip()) + if parts.scheme or parts.netloc or value.startswith(("/", "#")): + return value + path = posixpath.normpath(posixpath.join(posixpath.dirname(rel), parts.path)) + if path.startswith("../"): + raise UnsafePathError("CSS выходит за корень assets") + return ( + prefix + + quote(path) + + "?" + + (parts.query + "&" if parts.query else "") + + "token=" + + token + + ("#" + parts.fragment if parts.fragment else "") + ) + + text = re.sub( + r"url\(\s*(['\"]?)([^)'\"]+)\1\s*\)", lambda m: 'url("' + resource(m[2]) + '")', text + ) + text = re.sub( + r"(@import\s+)(['\"])([^'\"]+)\2", lambda m: m[1] + '"' + resource(m[3]) + '"', text + ) + return rewrite_assets(text, prefix, token) + + +class PreviewStore: + ttl = 600 + + def __init__(self, state, secret, config=None, clock=time.time): + self.state, self.directory, self.config, self.clock = ( + Path(state), + Path(state) / "preview", + config, + clock, + ) + self.key = hmac.new(secret, b"site-engine/preview/v1", hashlib.sha256).digest() + self.lock = threading.Lock() + self.unavailable_reason = "" + + def startup_cleanup(self): + if self.directory.is_dir(): + self.cleanup("", "") + + def epoch(self): + try: + return int((self.state / "auth_epoch").read_text()) + except FileNotFoundError: + return 0 + + def signature(self, payload): + return hmac.new(self.key, payload.encode(), hashlib.sha256).hexdigest() + + def authorize(self, snapshot, token): + try: + payload, sig = token.split(".") + if not hmac.compare_digest(sig, self.signature(payload)): + raise ValueError() + data = json.loads(base64.urlsafe_b64decode(payload + "=" * (-len(payload) % 4))) + if ( + data["snapshot"] != snapshot + or data["exp"] <= self.clock() + or data["epoch"] != self.epoch() + ): + raise ValueError() + if not re.fullmatch(r"[0-9a-f]{32}", snapshot): + raise ValueError() + folder = self.directory / snapshot + meta = json.loads((folder / "meta.json").read_text()) + if {k: v for k, v in meta.items() if k != "blocks"} != data: + raise ValueError() + return folder, data + except (ValueError, KeyError, TypeError, OSError, UnicodeError): + raise PermissionError("Токен превью недействителен или истёк") from None + + def cleanup(self, owner, document): + items = [] + for p in self.directory.iterdir(): + if not p.is_dir(): + continue + if p.name.startswith("."): + if p.stat().st_mtime + self.ttl <= self.clock(): + shutil.rmtree(p, ignore_errors=True) + continue + try: + data = json.loads((p / "meta.json").read_text()) + if data["exp"] <= self.clock() or data["epoch"] != self.epoch(): + shutil.rmtree(p) + elif data["owner"] == owner and data["document"] == document: + items.append((data["created"], p)) + except (OSError, ValueError, KeyError): + continue + for _, p in sorted(items, reverse=True)[20:]: + shutil.rmtree(p, ignore_errors=True) + + def render(self, service, identity, source, etag, revision, principal): + reg, _result = service.overlay(identity, source, etag) + report = Report() + table = build_route_table(reg, report) + docid = identity if service.kind == "page" else f"{service.collection}/{identity}" + view = next( + (v for v in make_views(reg, table, report, published_only=False) if v.id == docid), None + ) + if view is None: + raise EngineError("У этого документа нет страницы превью", report) + renderer = Renderer(reg, table, report, strict=False, build_id="preview", preview_mode=True) + html, used = renderer.render(view) + css, _ = _bundle(reg, used, report) + from ..web.admin.render import read_static + + css += "\n" + read_static("preview.css") + html = html.replace(ASSETS_HEAD, f"").replace(ASSETS_BODY, "") + with self.lock: + self.directory.mkdir(parents=True, exist_ok=True, mode=0o700) + snapshot = secrets.token_hex(16) + folder = self.directory / ("." + snapshot) + folder.mkdir(mode=0o700) + now = self.clock() + nonce = secrets.token_urlsafe(24) + data = { + "snapshot": snapshot, + "exp": now + self.ttl, + "epoch": self.epoch(), + "owner": principal.sid, + "document": f"{service.kind}:{service.collection}:{identity}", + "revision": revision, + "created": now, + "nonce": nonce, + } + payload = ( + base64.urlsafe_b64encode(json.dumps(data, separators=(",", ":")).encode()) + .rstrip(b"=") + .decode() + ) + token = payload + "." + self.signature(payload) + base = "" if self.config else "/admin/preview" + prefix = f"{base}/s/{snapshot}/assets/" + try: + assets = reg.root / "assets" + total = 0 + for path in assets.rglob("*") if assets.is_dir() else []: + if not path.is_file(): + continue + rel = path.relative_to(assets).as_posix() + path = asset_path(assets, rel) + raw = path.read_bytes() + total += len(raw) + if total > 50 * 1024 * 1024: + raise EngineError("Ассеты превью превышают 50 MiB") + if path.suffix.lower() == ".css": + raw = rewrite_css(raw.decode(), rel, prefix, token).encode() + atomic_write(folder / "assets" / rel, raw) + html = rewrite_assets(html, prefix, token) + if self.config: + bridge = read_static("preview.js").replace( + "__CONFIG__", + json.dumps( + { + "origin": self.config.admin, + "snapshot": snapshot, + "revision": revision, + } + ), + ) + script = f'' + html = ( + html.replace("", script + "") + if "" in html + else html + script + ) + atomic_write(folder / "index.html", html) + + class BlockMap(HTMLParser): + def handle_starttag(self, tag, attrs): + attrs = dict(attrs) + if attrs.get("data-preview-id"): + blocks.append( + { + k: attrs.get("data-preview-" + k) + for k in ("scope", "owner", "id") + } + ) + + blocks = [] + BlockMap().feed(html) + atomic_write(folder / "meta.json", json.dumps({**data, "blocks": blocks})) + folder.rename(self.directory / snapshot) + self.cleanup(principal.sid, data["document"]) + host = self.config.preview if self.config else "/admin/preview" + return { + "url": f"{host}/s/{snapshot}/?token={token}", + "snapshot": snapshot, + "revision": revision, + "interactive": bool(self.config), + "expires_at": data["exp"], + "html": "", + "message": "Выберите секцию в предпросмотре или в дереве слева.", + } + except BaseException: + shutil.rmtree(folder, ignore_errors=True) + raise diff --git a/src/site_engine/services/workspace.py b/src/site_engine/services/workspace.py new file mode 100644 index 0000000..09925ab --- /dev/null +++ b/src/site_engine/services/workspace.py @@ -0,0 +1,158 @@ +"""Read projections shared by JSON clients, independent from templates.""" + +import datetime as dt +import hashlib +import json +from pathlib import Path + +from ..build.pipeline import BUILD_ID_RE +from ..core.page_ops import all_blocks +from ..core.registry import load_site +from ..core.routes import build_route_table +from ..core.validate import validate_release, validate_workspace +from ..errors import Report +from ..parsing import frontmatter + + +def release_info(dist: Path) -> dict: + current = (dist / "current").resolve().name if (dist / "current").exists() else None + manifest = {} + if current and BUILD_ID_RE.fullmatch(current): + try: + value = json.loads((dist / current / "manifest.json").read_text()) + if isinstance(value, dict): + manifest = value + except (OSError, ValueError): + pass + return { + "current": current, + "built_at": manifest.get("built_at"), + "routes": manifest.get("routes", []), + "page_sources": manifest.get("page_sources"), + } + + +def filter_pages(pages, *, q="", status="", layout="", changed=False): + return [ + p + for p in pages + if (not status or p["status"] == status) + and (not layout or p["layout"] == layout) + and (not changed or p.get("changed") is True) + and q.casefold() + in " ".join(str(p.get(k, "")) for k in ("title", "route", "file")).casefold() + ] + + +def workspace(root: Path, dist: Path, state: Path) -> dict: + reg = load_site(root) + report = Report() + table = build_route_table(reg, report) + report.extend(validate_workspace(reg, table)) + report.extend(validate_release(reg, table)) + routes = {r.page.id: r.route for r in table.values() if r.page} + release = release_info(dist) + hashes = release["page_sources"] + if not isinstance(hashes, dict): + hashes = None + pages = [] + for p in reg.pages.values(): + raw = (root / p.file).read_bytes() + meta, _ = frontmatter.parse(raw.decode("utf-8")) + changed = ( + (hashes.get(p.file) != hashlib.sha256(raw).hexdigest()) + if hashes is not None + else (True if not release["current"] else None) + ) + page_issues = [ + i.to_dict() + for i in report.issues + if i.path == p.file or i.path.startswith(p.file + ".") + ] + updated = dt.datetime.fromtimestamp((root / p.file).stat().st_mtime, dt.UTC) + description = ( + meta.get("seo", {}).get("description", "") if isinstance(meta.get("seo"), dict) else "" + ) + pages.append( + { + "id": p.id, + "title": p.title, + "status": p.status, + "route": routes.get(p.id, "—"), + "file": p.file, + "layout": reg.effective_layout(p), + "count": sum(1 for _ in all_blocks(meta)), + "changed": changed, + "description": description if isinstance(description, str) else "", + "updated_at": updated.isoformat(), + "issues": page_issues, + "on_live": routes.get(p.id) in release["routes"], + } + ) + return { + "site_name": reg.site.name, + "pages": sorted(pages, key=lambda p: p["route"]), + "collections": [ + { + "id": c.id, + "name": c.name, + "total": len(reg.entries.get(c.id, [])), + "published": sum(e.status == "published" for e in reg.entries.get(c.id, [])), + } + for c in reg.collections.values() + ], + "layouts": sorted(reg.layouts), + "issues": [i.to_dict() for i in report.issues], + "release": {k: release[k] for k in ("current", "built_at", "routes")}, + "comparison_available": not release["current"] or hashes is not None, + "paths": { + "site": str(root.resolve()), + "dist": str(dist.resolve()), + "state": str(state.resolve()), + }, + } + + +def entries(root: Path, collection: str) -> dict: + from .documents import DocumentMissing + + reg = load_site(root) + c = reg.collections.get(collection) + if c is None: + raise DocumentMissing("Нет коллекции") + table = build_route_table(reg, Report()) + routes = { + (r.collection.id, r.entry.slug): r.route for r in table.values() if r.collection and r.entry + } + items = reg.entries.get(c.id, []) + return { + "collection": { + "id": c.id, + "name": c.name, + "total": len(items), + "published": sum(e.status == "published" for e in items), + }, + "entries": [ + { + "slug": e.slug, + "title": str(e.data.get("title", e.slug)), + "status": e.status, + "file": e.file, + "route": routes.get((c.id, e.slug), "—"), + } + for e in items + ], + } + + +def releases(dist: Path) -> dict: + current = (dist / "current").resolve().name if (dist / "current").exists() else None + ids = ( + sorted( + (p.name for p in dist.iterdir() if p.is_dir() and BUILD_ID_RE.fullmatch(p.name)), + reverse=True, + ) + if dist.is_dir() + else [] + ) + return {"current": current, "builds": [{"id": i, "current": i == current} for i in ids]} diff --git a/src/site_engine/storage/fs.py b/src/site_engine/storage/fs.py index 70e2f73..8b32559 100644 --- a/src/site_engine/storage/fs.py +++ b/src/site_engine/storage/fs.py @@ -12,7 +12,7 @@ from ..errors import UnsafePathError def safe_join(root: Path, rel: str) -> Path: """Путь внутри корня сайта. Абсолютные пути, `..` и symlink наружу запрещены.""" - if not rel or rel.startswith(("/", "\\")) or "\x00" in rel: + if not rel or rel.startswith(("/", "\\")) or "\x00" in rel or ".." in rel.replace("\\", "/").split("/"): raise UnsafePathError(f"недопустимый путь: {rel!r}") root_r = root.resolve() candidate = (root_r / rel).resolve() diff --git a/src/site_engine/web/admin/api_client.py b/src/site_engine/web/admin/api_client.py new file mode 100644 index 0000000..6b8d864 --- /dev/null +++ b/src/site_engine/web/admin/api_client.py @@ -0,0 +1,38 @@ +"""Request-scoped in-process API credentials never reach browser HTML.""" + +import secrets +from contextlib import asynccontextmanager + +import httpx + + +class ApiError(Exception): + def __init__(self, status: int, data: dict): + self.status, self.data = status, data + super().__init__(data.get("error", {}).get("message", "Ошибка API")) + + +class AdminApi: + def __init__(self, client): + self.client = client + + async def call(self, method, path, data=None): + response = await self.client.request(method, "/admin/api/v1" + path, json=data) + if response.status_code >= 400: + raise ApiError(response.status_code, response.json()) + return response.json() + + +@asynccontextmanager +async def api_for(request, cookie, ip): + token = secrets.token_urlsafe(32) + request.app.state.api_credentials[token] = (cookie, ip) + try: + async with httpx.AsyncClient( + transport=httpx.ASGITransport(app=request.app), + base_url="http://internal", + headers={"Authorization": "Bearer " + token}, + ) as client: + yield AdminApi(client) + finally: + request.app.state.api_credentials.pop(token, None) diff --git a/src/site_engine/web/admin/application.py b/src/site_engine/web/admin/application.py new file mode 100644 index 0000000..06589ef --- /dev/null +++ b/src/site_engine/web/admin/application.py @@ -0,0 +1,732 @@ +"""HTML UI. Application data and mutations are obtained exclusively through AdminApi.""" + +import json +import re +from contextvars import ContextVar +from urllib.parse import quote + +from ...core.models import STATUSES, FieldDef +from ...services.auth import COOKIE_NAME, is_same_origin +from .api_client import ApiError, api_for +from .editor import PREVIEW_HEADERS +from .forms import FormData, build_view, parse_props +from .handlers import HttpResult, htmx_available, page_result, redirect_result +from .render import render +from .views import pages_view, workspace_view + +_navigation = ContextVar("admin_navigation", default=None) + + +def field_def(raw): + data = dict(raw) + data["fields"] = [field_def(f) for f in raw.get("fields", [])] + if isinstance(raw.get("of"), dict): + data["of"] = field_def(raw["of"]) + return FieldDef(**data) + + +def walk_blocks(regions, scope, owner): + result = [] + + def walk(items, region, depth=0): + for block in items or []: + result.append( + dict( + {"hidden": False, "requires": [], "anchor": None, "note": None}, + **block, + scope=scope, + owner=owner, + region=region, + depth=depth, + ) + ) + for name, children in (block.get("slots") or {}).items(): + walk(children, region + "/" + block["id"] + "/" + name, depth + 1) + + for name, items in regions.items(): + walk(items, name) + return result + + +class AdminApplication: + def __init__(self, auth, previews): + self.auth, self.previews = auth, previews + + def ctx(self, principal, section, **extra): + navigation = dict(_navigation.get() or {}) + if "current" in extra: + navigation["current"] = extra["current"] + return dict( + login=principal.login, + csrf=self.auth.csrf_token(principal), + section=section, + flash="", + htmx=htmx_available(), + navigation=navigation, + **extra, + ) + + def page(self, template, principal, section, status=200, **extra): + return page_result(render(template, **self.ctx(principal, section, **extra)), status) + + def message(self, principal, text, status): + return self.page( + "message.html.j2", + principal, + "", + status, + title="Сообщение", + text=text, + issues=[], + links=[], + ) + + def editor_context( + self, + snap, + base, + selection="", + mode="constructor", + conflict=None, + errors=None, + saved=False, + readonly="", + ): + model = snap.get("model") or {} + meta = model.get("meta", {}) + schema = snap["schema"] + blocks = walk_blocks(meta.get("regions", {}), snap["kind"], schema["owner"]) + fixed = walk_blocks( + {k: v["fixed"] for k, v in schema["regions"].items()}, "layout", schema["layout"] or "" + ) + display = walk_blocks(schema.get("display", {}), "display", schema["display_owner"]) + if snap["kind"] == "entry": + display += blocks + blocks = [] + try: + key = json.loads(readonly) if readonly else {} + except ValueError: + key = {} + readonly_selected = next( + ( + b + for b in fixed + display + if all(b[k] == key.get(k) for k in ("scope", "owner", "id")) + ), + None, + ) + readonly_key = ( + json.dumps({k: readonly_selected[k] for k in ("scope", "owner", "id")}) + if readonly_selected + else "" + ) + selected = next((b for b in blocks if b["id"] == selection), None) + fields = [] + definitions = ( + schema["fields"] + if snap["kind"] == "entry" + else ( + schema["fragments"].get(selected["fragment"], {}).get("fields", []) + if selected + else [] + ) + ) + values = ( + meta if snap["kind"] == "entry" else (selected.get("props", {}) if selected else {}) + ) + fields = [ + build_view(field_def(f), values.get(f["key"]), "p." + f["key"], schema["choices"]) + for f in definitions + ] + context = { + "snap": snap, + "base": base, + "meta": meta, + "body": model.get("body", ""), + "blocks": blocks, + "fixed": fixed, + "display": display, + "selected": selected, + "readonly_selected": readonly_selected, + "readonly_key": readonly_key, + "fields": fields, + "mode": mode, + "selection": selection, + "conflict": conflict, + "errors": errors or [], + "saved": saved, + "statuses": STATUSES, + "preview_origin": self.previews.config.preview if self.previews.config else "", + } + if snap["kind"] == "page": + from .builder import builder_view + + context.update(builder_view(context, _navigation.get() or {})) + context["inspector_views"] = [] + for item in context.pop("inspector_blocks"): + block = item["block"] + editable = block["scope"] == "page" + definitions = schema["fragments"].get(block["fragment"], {}).get("fields", []) + context["inspector_views"].append( + dict( + item, + selected=block if editable else None, + readonly_selected=None if editable else block, + selection=block["id"] if editable else "", + readonly_key="" + if editable + else json.dumps({k: block[k] for k in ("scope", "owner", "id")}), + fields=[ + build_view( + field_def(f), + block.get("props", {}).get(f["key"]), + "p." + f["key"], + schema["choices"], + ) + for f in definitions + ] + if editable + else [], + ) + ) + context["catalog_fields"] = { + fid: [ + build_view( + field_def(f), + fragment.get("preview", {}).get(f["key"], f.get("default")), + "p." + f["key"], + schema["choices"], + ) + for f in fragment["fields"] + ] + for fid, fragment in schema["fragments"].items() + } + return context + + def editor( + self, + principal, + snap, + base, + form=None, + status=200, + conflict=None, + errors=None, + saved=False, + partial=False, + canonical=None, + ): + form = form or FormData() + selection = form.first("choose") if "choose" in form else form.first("selection") + ctx = self.editor_context( + snap, + base, + selection, + form.first("mode") or "constructor", + conflict, + errors, + saved, + readonly=form.first("choose_readonly") + if "choose_readonly" in form + else form.first("readonly"), + ) + ctx["submitted_fields"] = list(form._d.items()) if errors else [] + ctx["canonical_source"] = snap["source"] if saved or canonical is None else canonical + template = ( + "editor_result.html.j2" + if partial + else "page_builder.html.j2" + if snap["kind"] == "page" + else "document.html.j2" + ) + result = self.page( + template, principal, "pages" if snap["kind"] == "page" else "content", status, **ctx + ) + result.headers["X-Editor-Revision"] = str(snap["revision"]) + if self.previews.config: + result.headers["Content-Security-Policy"] = result.headers[ + "Content-Security-Policy" + ].replace("frame-src 'self'", "frame-src 'self' " + self.previews.config.preview) + return result + + async def dispatch(self, request): + cookie = request.cookies.get(COOKIE_NAME) + principal = self.auth.authenticate(cookie) + if principal is None: + if request.headers.get("hx-request"): + return page_result( + "Сессия истекла. Скачайте исходник перед новым входом.", + 401, + {"X-Session-Expired": "1"}, + ) + return redirect_result("/admin/login") + form = ( + FormData.from_pairs((await request.form()).multi_items()) + if request.method == "POST" + else FormData() + ) + if request.method == "POST" and not ( + is_same_origin(request.headers, self.auth.cfg.public_host) + and self.auth.verify_csrf(principal, form.first("csrf")) + ): + return self.message(principal, "Недействительный токен или источник запроса", 403) + ip = request.client.host if request.client else "unknown" + async with api_for(request, cookie, ip) as api: + token = _navigation.set(None) + try: + if not request.url.path.startswith(("/admin/editor/", "/admin/preview/")): + site = await api.call("GET", "/site") + releases = await api.call("GET", "/releases") + _navigation.set( + { + **site, + "host": self.auth.cfg.public_host or request.url.netloc, + "current": releases["current"], + } + ) + return await self.route(request, api, principal, form) + except ApiError as exc: + return self.message(principal, str(exc), exc.status) + finally: + _navigation.reset(token) + + async def route(self, request, api, principal, form): + path = request.url.path.removeprefix("/admin") or "/" + query = dict(request.query_params) + post = request.method == "POST" + snapshot_route = re.fullmatch(r"/preview/s/([a-f0-9]{32})/(?:assets/(.+))?", path) + if snapshot_route and not post: + resource = ( + "assets/" + quote(snapshot_route[2], safe="/") if snapshot_route[2] else "html" + ) + response = await api.client.get( + f"/admin/api/v1/preview/{snapshot_route[1]}/" + resource, + params={"token": request.query_params.get("token", "")}, + ) + return HttpResult( + response.status_code, + response.content, + response.headers.get("content-type", "text/html"), + { + k: v + for k, v in response.headers.items() + if k + in { + "cache-control", + "content-security-policy", + "referrer-policy", + "x-content-type-options", + "x-frame-options", + } + }, + ) + if path.startswith("/preview/assets/"): + response = await api.client.get( + "/admin/api/v1/assets/" + quote(path.removeprefix("/preview/assets/"), safe="/") + ) + return HttpResult( + response.status_code, + response.content, + response.headers.get("content-type", "application/octet-stream"), + {**PREVIEW_HEADERS, "X-Content-Type-Options": "nosniff"}, + ) + if path in {"/", "/pages", "/content"} and not post: + data = _navigation.get() or await api.call("GET", "/site") + if path == "/": + return self.page( + "dashboard.html.j2", + principal, + "dashboard", + site_error="", + errors=sum(i["severity"] == "error" for i in data["issues"]), + warnings=sum(i["severity"] == "warning" for i in data["issues"]), + **workspace_view(data), + **{k: data[k] for k in ("site_name", "pages", "collections", "paths")}, + ) + if path == "/content": + return self.page( + "content_index.html.j2", principal, "content", collections=data["collections"] + ) + if ( + query.get("status") + and query["status"] not in STATUSES + or query.get("layout") + and query["layout"] not in data["layouts"] + or query.get("changed", "") not in {"", "1"} + ): + return self.message(principal, "Проверьте status/layout", 422) + try: + view = pages_view(data, query) + except LookupError: + return self.message(principal, "Нет выбранной страницы", 404) + return self.page( + "pages_list.html.j2", + principal, + "pages", + **view, + create_open=query.get("create") == "1", + created=query.get("msg") == "created", + errors=[], + values={"page_id": "", "title": "", "layout": ""}, + ) + if path == "/pages/new" and post: + try: + snap = await api.call( + "POST", + "/pages", + { + "id": form.first("page_id").strip(), + "title": form.first("title"), + "layout": form.first("layout") or None, + }, + ) + except ApiError as exc: + data = await api.call("GET", "/site") + return self.page( + "pages_list.html.j2", + principal, + "pages", + exc.status, + **pages_view(data, {}), + create_open=True, + created=False, + errors=[str(exc)], + values={k: form.first(k) for k in ("page_id", "title", "layout")}, + ) + return redirect_result( + "/admin/pages?selected=" + quote(snap["id"], safe="") + "&msg=created" + ) + match = re.fullmatch(r"/content/([a-z][a-z0-9_]*)", path) + if match and not post: + data = await api.call("GET", f"/collections/{match[1]}/entries") + if query.get("status") and query["status"] not in STATUSES: + return self.message(principal, "Проверьте status", 422) + data["entries"] = [ + e + for e in data["entries"] + if (not query.get("status") or e["status"] == query["status"]) + and query.get("q", "").casefold() in " ".join(str(v) for v in e.values()).casefold() + ] + return self.page( + "entries_list.html.j2", + principal, + "content", + **data, + errors=[], + slug="", + filters=query, + ) + match = re.fullmatch(r"/content/([a-z][a-z0-9_]*)/new", path) + if match and post: + try: + snap = await api.call( + "POST", f"/collections/{match[1]}/entries", {"id": form.first("slug").strip()} + ) + except ApiError as exc: + data = await api.call("GET", f"/collections/{match[1]}/entries") + return self.page( + "entries_list.html.j2", + principal, + "content", + exc.status, + **data, + errors=[str(exc)], + slug=form.first("slug"), + filters={}, + ) + return redirect_result(f"/admin/content/{match[1]}/{snap['id']}") + if path == "/publish" or path.startswith("/publish/rollback/"): + endpoint = ( + "/releases" + if not post + else ("/rollback/" + path.rsplit("/", 1)[1] if "/rollback/" in path else "/publish") + ) + try: + data = await api.call("POST" if post else "GET", endpoint) + return self.page("publish.html.j2", principal, "publish", **data, issues=[]) + except ApiError as exc: + data = await api.call("GET", "/releases") + return self.page( + "publish.html.j2", + principal, + "publish", + exc.status, + **data, + issues=exc.data["error"].get("issues") + or [ + { + "code": "E_OPERATION", + "message": str(exc), + "path": "", + "severity": "error", + } + ], + ) + + # HTML editor endpoints mirror the document path and operation; JSON paths remain separate. + editor_request = path.startswith("/editor/") + passive = path.startswith("/preview/") + docpath = ( + path.removeprefix("/editor") + if editor_request + else path.removeprefix("/preview") + if passive + else path + ) + docpath = docpath.replace("/entries/", "/content/", 1) + op = "" + if editor_request: + docpath, op = docpath.rsplit("/", 1) + block_match = re.fullmatch( + r"/pages/(.+?)/blocks/([^/]+)(?:/(move|delete|toggle))?", docpath + ) + legacy_block, legacy_action = "", "" + if block_match: + docpath = "/pages/" + block_match[1] + legacy_block, legacy_action = block_match[2], block_match[3] or "" + elif not editor_request and post and docpath.endswith(("/meta", "/add")): + docpath, legacy_action = docpath.rsplit("/", 1) + if docpath.startswith("/pages/"): + identity = docpath.removeprefix("/pages/") + endpoint = "/pages/" + quote(identity, safe="/") + else: + match = re.fullmatch(r"/content/([a-z][a-z0-9_]*)/([^/]+)", docpath) + if not match: + return self.message(principal, "Такой страницы нет", 404) + identity = match[2] + endpoint = f"/collections/{match[1]}/entries/{quote(identity, safe='')}" + snap = await api.call("GET", endpoint + "/source") + if not post: + if passive: + preview = await api.call( + "POST", + endpoint + "/preview", + {"source": snap["source"], "etag": snap["etag"], "revision": 0}, + ) + return redirect_result(preview["url"]) + mode = query.get("mode", "constructor") + if mode not in {"constructor", "expert"}: + return self.message(principal, "Неизвестный режим редактора", 422) + page_blocks = ( + walk_blocks( + (snap.get("model") or {}).get("meta", {}).get("regions", {}), "page", identity + ) + if snap["kind"] == "page" + else [] + ) + initial_selection = legacy_block or query.get( + "block", page_blocks[0]["id"] if page_blocks else "" + ) + return self.editor( + principal, + snap, + docpath, + FormData.from_pairs([("selection", initial_selection), ("mode", mode)]), + partial=editor_request and bool(request.headers.get("hx-request")), + ) + + partial = editor_request and bool(request.headers.get("hx-request")) + canonical = snap["source"] + source = form.first("source") if "source" in form._d else canonical + if ( + not request.headers.get("hx-request") + and source == canonical.replace("\r\n", "\n").replace("\r", "\n") + and form.first("etag") == snap["etag"] + ): + source = canonical + try: + revision = int(form.first("revision") or 0) + except ValueError: + return self.message(principal, "Некорректная revision", 422) + submitted = {"source": source, "etag": form.first("etag"), "revision": revision} + snap.update(source=source, etag=submitted["etag"], revision=submitted["revision"]) + try: + if editor_request and op == "preview": + preview = await api.call("POST", endpoint + "/preview", submitted) + result = self.page("preview_result.html.j2", principal, "pages", preview=preview) + result.headers["X-Editor-Revision"] = str(submitted["revision"]) + return result + if editor_request and op == "rebase": + if form.first("confirm_rebase") != "1": + return self.message(principal, "Подтвердите принятие новой основы", 422) + submitted["etag"] = form.first("new_etag") + snap = await api.call("POST", endpoint + "/validate", submitted) + elif editor_request and op in {"save", "validate", "select"}: + snap = await api.call( + "POST", endpoint + ("/save" if op == "save" else "/validate"), submitted + ) + else: + # Parse a typed form using the schema returned by the API; no canonical filesystem reads here. + validated = await api.call("POST", endpoint + "/validate", submitted) + action = self.form_action(validated, form, legacy_action, legacy_block) + snap = await api.call( + "POST", endpoint + "/transform", dict(**submitted, action=action) + ) + if action["type"] in {"add", "duplicate"}: + old_ids = { + b["id"] + for b in walk_blocks( + validated["model"]["meta"].get("regions", {}), "page", identity + ) + } + added = next( + ( + b["id"] + for b in walk_blocks( + (snap.get("model") or {}).get("meta", {}).get("regions", {}), + "page", + identity, + ) + if b["id"] not in old_ids + ), + None, + ) + if added: + form._d["selection"] = [added] + form._d["readonly"] = [""] + elif action["type"] == "delete": + before = walk_blocks( + validated["model"]["meta"].get("regions", {}), "page", identity + ) + remaining = walk_blocks( + snap["model"]["meta"].get("regions", {}), "page", identity + ) + index = next( + (i for i, b in enumerate(before) if b["id"] == action["block_id"]), 0 + ) + form._d["selection"] = [ + remaining[min(index, len(remaining) - 1)]["id"] if remaining else "" + ] + if not editor_request: + snap = await api.call( + "POST", endpoint + "/save", dict(submitted, source=snap["source"]) + ) + return self.editor( + principal, + snap, + docpath, + form, + partial=partial, + saved=(op == "save" or not editor_request), + canonical=canonical, + ) + except ApiError as exc: + err = exc.data.get("error", {}) + if err.get("buffer"): + snap = err["buffer"] + elif err.get("committed"): + snap = err["committed"] + else: + # Validate submitted text for a projection while retaining its exact source/base. + try: + snap = await api.call("POST", endpoint + "/validate", submitted) + except ApiError as invalid: + snap = invalid.data.get("error", {}).get("buffer") or dict(snap, model=None) + result = self.editor( + principal, + snap, + docpath, + form, + exc.status, + conflict=err.get("current"), + saved=bool(err.get("committed")), + errors=[str(exc)] + [i["message"] for i in err.get("issues", [])], + partial=partial, + canonical=canonical, + ) + if err.get("committed"): + result.headers["X-Document-Committed"] = "1" + return result + + def form_action(self, snap, form, legacy="", block_id=""): + op = ( + form.first("operation") + or legacy + or ("block" if block_id else "metadata" if snap["kind"] == "page" else "entry_fields") + ) + block_id = block_id or form.first("block_id") or form.first("selection") + if op == "format" and snap["kind"] == "page": + return {"type": "metadata", "values": {}} + if op in {"toggle", "delete", "move", "duplicate"}: + action = {"type": op, "block_id": block_id} + if op == "move": + for key in ("direction", "before", "after"): + if form.first(key): + action[key] = form.first(key) + return action + if op == "add": + fragment = snap["schema"]["fragments"].get(form.first("fragment")) + errors = [] + props = ( + parse_props([field_def(f) for f in fragment["fields"]], form, "p", errors) + if fragment + else {} + ) + if errors: + raise ApiError(422, {"error": {"message": "; ".join(errors)}}) + return { + "type": "add", + "props": props, + **{k: form.first(k) or None for k in ("fragment", "region", "parent", "slot")}, + } + meta = snap["model"]["meta"] + if op == "metadata": + seo = dict(meta.get("seo") or {}) + seo["description"] = form.first("seo_description") + if "seo_title" in form: + seo["title"] = form.first("seo_title") + return { + "type": op, + "values": { + "title": form.first("title"), + "status": form.first("status") or "draft", + "layout": form.first("layout") or None, + "route": form.first("route") or None, + "seo": seo, + }, + "body": form.first("body"), + } + if op == "entry_fields": + raw_fields = snap["schema"]["fields"] + else: + block = next( + ( + b + for b in walk_blocks(meta.get("regions", {}), "page", snap["id"]) + if b["id"] == block_id + ), + None, + ) + if not block: + raise ApiError(422, {"error": {"message": "Блок не найден"}}) + raw_fields = snap["schema"]["fragments"][block["fragment"]]["fields"] + errors = [] + props = parse_props([field_def(f) for f in raw_fields], form, "p", errors) + if errors: + raise ApiError(422, {"error": {"message": "; ".join(errors)}}) + if op == "entry_fields": + return { + "type": op, + "values": props, + "unset": [f["key"] for f in raw_fields if f["key"] not in props], + "status": form.first("status") or "draft", + "body": form.first("body") if snap["schema"]["has_body"] else None, + } + # Preserve unrecognized props exactly; the core validator reports them. + merged = { + k: v + for k, v in block.get("props", {}).items() + if k not in {f["key"] for f in raw_fields} + } + merged.update(props) + return { + "type": "block", + "block_id": block_id, + "values": { + "props": merged, + "hidden": form.first("hidden") == "1", + "anchor": form.first("anchor") or None, + "note": form.first("note") or None, + "requires": form.all("requires"), + }, + } diff --git a/src/site_engine/web/admin/builder.py b/src/site_engine/web/admin/builder.py new file mode 100644 index 0000000..bcd5f76 --- /dev/null +++ b/src/site_engine/web/admin/builder.py @@ -0,0 +1,115 @@ +"""Read-only presentation of the real document/schema for the designer's builder.""" + +import json +from fnmatch import fnmatch + + +def builder_view(ctx, navigation): + snap, meta = ctx["snap"], ctx["meta"] + schema = snap["schema"] + pages = navigation.get("pages") or [ + {"id": identity, "title": schema["choices"].get("page_titles", {}).get(identity, identity)} + for identity in schema["choices"]["pages"] + ] + if not any(p["id"] == snap["id"] for p in pages): + pages = [*pages, {"id": snap["id"], "title": meta.get("title", snap["id"])}] + page = next((p for p in pages if p["id"] == snap["id"]), {}) + route = ( + meta.get("route") + or page.get("route") + or ("/" if snap["id"] == "index" else "/" + snap["id"].removesuffix("/index") + "/") + ) + groups, targets = [], [] + + def allowed(patterns): + return [ + fid + for fid in schema["fragments"] + if patterns is None or any(fnmatch(fid, pattern) for pattern in patterns) + ] + + for name, region in schema["regions"].items(): + editable = region["allow"] is not None or not region["fixed"] + groups.append( + { + "name": name, + "editable": editable, + "fixed": [b for b in ctx["fixed"] if b["region"].split("/")[0] == name], + "blocks": [b for b in ctx["blocks"] if b["region"].split("/")[0] == name], + } + ) + if editable: + targets.append( + { + "label": name, + "region": name, + "parent": "", + "slot": "", + "allow": allowed(region["allow"]), + } + ) + for block in ctx["blocks"]: + for name, slot in schema["fragments"].get(block["fragment"], {}).get("slots", {}).items(): + targets.append( + { + "label": block["id"] + " / " + name, + "parent": block["id"], + "slot": name, + "region": "", + "allow": allowed(slot.get("allow")), + } + ) + + def sources(props, prefix=""): + rows = [] + for key, value in props.items(): + path = prefix + key + kind = next( + ( + k + for k in ("bind", "query", "page", "entry", "url") + if isinstance(value, dict) and k in value + ), + "literal", + ) + if isinstance(value, dict) and kind == "literal": + rows.extend(sources(value, path + ".")) + else: + rows.append( + { + "key": path, + "kind": kind, + "value": value.get(kind) if kind != "literal" else value, + "text": json.dumps(value, ensure_ascii=False) + if isinstance(value, (list, dict)) + else str(value), + } + ) + return rows + + return { + "page_options": pages, + "page_route": route, + "tree_groups": groups, + "catalog_targets": targets, + "catalog_categories": sorted( + {f["category"] for f in schema["fragments"].values()}, + key=lambda category: ( + {"Контент": 0, "Данные": 1, "Первый экран": 2, "Конверсия": 3, "Медиа": 4}.get( + category, 5 + ), + category, + ), + ), + "source_maps": [ + {"block": b, "sources": sources(b.get("props", {}))} for b in ctx["blocks"] + ], + "selected_sources": sources( + (ctx["readonly_selected"] or ctx["selected"] or {}).get("props", {}) + ), + "inspector_blocks": [ + {"block": b, "sources": sources(b.get("props", {}))} + for b in ctx["blocks"] + ctx["fixed"] + ], + "seo": meta.get("seo") if isinstance(meta.get("seo"), dict) else {}, + } diff --git a/src/site_engine/web/admin/editor.py b/src/site_engine/web/admin/editor.py index bec5cc2..3b772d5 100644 --- a/src/site_engine/web/admin/editor.py +++ b/src/site_engine/web/admin/editor.py @@ -10,6 +10,7 @@ CSRF-токен и Origin своего хоста. Логика не завис from __future__ import annotations import re +import mimetypes from collections.abc import Mapping from pathlib import Path from typing import Any @@ -26,6 +27,7 @@ from ...parsing import frontmatter from ...services.auth import AuthService, Principal, is_same_origin from ...services.content import ABSENT, ContentService from ...services.publish import publish, rollback +from ...storage.fs import safe_join from .forms import FormData, _norm_text, build_view, parse_props from .handlers import ADMIN_HEADERS, HttpResult, htmx_available, page_result, redirect_result from .render import render @@ -44,7 +46,7 @@ FLASH = { PREVIEW_HEADERS = { "Cache-Control": "no-store", "X-Content-Type-Options": "nosniff", "X-Frame-Options": "SAMEORIGIN", "Referrer-Policy": "same-origin", - "Content-Security-Policy": ("default-src 'none'; style-src 'unsafe-inline'; img-src 'self' data:; " + "Content-Security-Policy": ("default-src 'none'; style-src 'self' 'unsafe-inline'; font-src 'self'; img-src 'self' data:; " "frame-ancestors 'self'; base-uri 'none'; form-action 'none'"), } @@ -61,6 +63,7 @@ class EditorHandlers: coll = r"(?P[a-z][a-z0-9_]*)" slug = r"(?P[a-z0-9][a-z0-9_-]*)" table = [ + ("GET", r"/preview/assets/(?P.+)", self.preview_asset), ("GET", r"/pages", self.pages_list), ("POST", r"/pages/new", self.page_create), ("GET", rf"/pages/{page_id}/blocks/{block_id}", self.block_edit), @@ -98,9 +101,9 @@ class EditorHandlers: try: return handler(principal, match.groupdict(), query, form, ip) except ConflictError as exc: - return self._message( - principal, "Файл изменился", f"{exc} Откройте страницу заново и повторите правку: " - "чужие изменения не перезаписаны.", 409, links=[{"url": "/admin/pages", "label": "К списку страниц"}]) + return self._render("legacy_conflict.html.j2", principal, "pages", query, 409, + submitted=list(form._d.items()), retry_url="/admin" + path, + current_etag=exc.current_etag, message=str(exc)) except UnsafePathError as exc: return self._message(principal, "Запись запрещена", str(exc), 403) except EngineError as exc: @@ -188,14 +191,20 @@ class EditorHandlers: # ── страницы ────────────────────────────────────────────────────────── def pages_list(self, principal, g, query, form, ip, *, errors=None, values=None, status=200) -> HttpResult: - reg = load_site(self.site_root) - table = build_route_table(reg, Report()) - routes = {r.page.id: r.route for r in table.values() if r.page} - pages = [{"id": p.id, "title": p.title, "status": p.status, "route": routes.get(p.id, "—")} - for p in sorted(reg.pages.values(), key=lambda x: routes.get(x.id, x.id))] - return self._render("pages_list.html.j2", principal, "pages", query, status, pages=pages, - errors=errors or [], layouts=sorted(reg.layouts), - values=values or {"page_id": "", "title": "", "layout": ""}) + from ...services.workspace import workspace + from .views import pages_view + data = workspace(self.site_root, self.dist, self.auth.state_dir) + if (query.get("status") and query["status"] not in STATUSES + or query.get("layout") and query["layout"] not in data["layouts"] + or query.get("changed", "") not in {"", "1"}): + return self._message(principal, "Некорректный фильтр", "Проверьте status/layout.", 422) + try: + view = pages_view(data, query) + except LookupError: + return self._not_found(principal, "Выбранной страницы нет.") + return self._render("pages_list.html.j2", principal, "pages", query, status, **view, + create_open=bool(errors) or query.get("create") == "1", created=False, + errors=errors or [], values=values or {"page_id": "", "title": "", "layout": ""}) def page_create(self, principal, g, query, form, ip) -> HttpResult: reg = load_site(self.site_root) @@ -439,9 +448,23 @@ class EditorHandlers: # ── предпросмотр ────────────────────────────────────────────────────── @staticmethod def _preview_result(html: str) -> HttpResult: - return HttpResult(200, html or "

    Страницу нельзя отрендерить: проверьте layout.

    ", + return HttpResult(200, html.replace("/assets/", "/admin/preview/assets/") or "

    Страницу нельзя отрендерить: проверьте layout.

    ", headers=dict(PREVIEW_HEADERS)) + def preview_asset(self, principal, g, query, form, ip) -> HttpResult: + try: + root = self.site_root / "assets" + path = safe_join(root, g["asset"]) + if not path.is_file(): + raise FileNotFoundError + content = path.read_bytes() + mime = mimetypes.guess_type(path.name)[0] or "application/octet-stream" + if mime == "text/css": + content = content.decode("utf-8").replace("/assets/", "/admin/preview/assets/").encode() + return HttpResult(200, content, mime, headers=dict(PREVIEW_HEADERS)) + except (FileNotFoundError, UnsafePathError): + return self._not_found(principal, "Ассет не найден.") + def preview_page(self, principal, g, query, form, ip) -> HttpResult: try: html, _ = preview_page(self.site_root, g["page_id"]) @@ -472,9 +495,14 @@ class EditorHandlers: table = build_route_table(reg, Report()) routes = {(r.collection.id, r.entry.slug): r.route for r in table.values() if r.entry and r.collection} entries = [{"slug": e.slug, "title": e.data.get("title", e.slug), "status": e.status, - "route": routes.get((coll.id, e.slug), "—")} for e in reg.entries.get(coll.id, [])] + "file": e.file, "route": routes.get((coll.id, e.slug), "—")} for e in reg.entries.get(coll.id, [])] + if query.get("status") and query["status"] not in STATUSES: + return self._message(principal, "Некорректный фильтр", "Проверьте status.", 422) + q = query.get("q", "").casefold() + entries = [e for e in entries if (not query.get("status") or e["status"] == query["status"]) + and q in " ".join(str(e[k]) for k in ("slug", "title", "route", "file")).casefold()] return self._render("entries_list.html.j2", principal, "content", query, status, collection=coll, - entries=entries, errors=errors or [], slug=slug) + entries=entries, errors=errors or [], slug=slug, filters=dict(query)) def entry_create(self, principal, g, query, form, ip) -> HttpResult: reg = load_site(self.site_root) diff --git a/src/site_engine/web/admin/handlers.py b/src/site_engine/web/admin/handlers.py index 7f47b34..c8c93fd 100644 --- a/src/site_engine/web/admin/handlers.py +++ b/src/site_engine/web/admin/handlers.py @@ -9,10 +9,7 @@ from __future__ import annotations from dataclasses import dataclass, field from pathlib import Path -from ...core.registry import load_site -from ...core.routes import build_route_table -from ...core.validate import validate_release, validate_workspace -from ...errors import EngineError, Report +from ...errors import EngineError from ...services.auth import COOKIE_NAME, AuthError, AuthService, is_same_origin from .render import ADMIN_DIR, read_static, render @@ -23,7 +20,7 @@ ADMIN_HEADERS = { "Referrer-Policy": "same-origin", "Content-Security-Policy": ( "default-src 'none'; style-src 'self'; script-src 'self'; img-src 'self'; " - "connect-src 'self'; form-action 'self'; frame-ancestors 'none'; base-uri 'none'" + "connect-src 'self'; frame-src 'self'; form-action 'self'; frame-ancestors 'none'; base-uri 'none'" ), } @@ -31,7 +28,7 @@ ADMIN_HEADERS = { @dataclass class HttpResult: status: int = 200 - body: str = "" + body: str | bytes = "" content_type: str = "text/html; charset=utf-8" headers: dict[str, str] = field(default_factory=dict) cookies: list[str] = field(default_factory=list) # готовые значения Set-Cookie @@ -57,7 +54,7 @@ redirect_result = _redirect def htmx_available() -> bool: - """htmx подключается, только если файл положен в static/ (в репозиторий не входит).""" + """Проверка поставляемого локального htmx; без файла обычные формы продолжают работать.""" return (ADMIN_DIR / "static" / "htmx.min.js").is_file() @@ -115,26 +112,25 @@ class AdminHandlers: "paths": {"site": str(self.site_root.resolve()), "dist": str(self.dist.resolve()) if self.dist else "не задан", "state": str(self.auth.state_dir.resolve())}} + from ...services.workspace import workspace + from .views import workspace_view try: - reg = load_site(self.site_root) - report = Report() - table = build_route_table(reg, report) - report.extend(validate_workspace(reg, table)) - report.extend(validate_release(reg, table)) - routes = {r.page.id: r.route for r in table.values() if r.page} - ctx.update( - site_name=reg.site.name, errors=len(report.errors), warnings=len(report.warnings), - pages=[{"title": p.title, "status": p.status, "route": routes.get(p.id, "—")} - for p in sorted(reg.pages.values(), key=lambda x: routes.get(x.id, ""))], - collections=[{"name": c.name, "total": len(reg.entries.get(c.id, [])), - "published": sum(e.status == "published" for e in reg.entries.get(c.id, []))} - for c in reg.collections.values()], - ) + data = workspace(self.site_root, self.dist or self.site_root / "dist", self.auth.state_dir) + ctx.update(site_name=data["site_name"], pages=data["pages"], collections=data["collections"], + errors=sum(i["severity"] == "error" for i in data["issues"]), + warnings=sum(i["severity"] == "warning" for i in data["issues"]), + **workspace_view(data)) except EngineError as exc: ctx["site_error"] = str(exc) return _page(render("dashboard.html.j2", **ctx)) - _STATIC = {"admin.css": "text/css; charset=utf-8", "htmx.min.js": "text/javascript; charset=utf-8"} + _STATIC = {"admin.css": "text/css; charset=utf-8", + "builder.css": "text/css; charset=utf-8", "builder-adapter.css": "text/css; charset=utf-8", + "builder.js": "text/javascript; charset=utf-8", + "antirion-rework.css": "text/css; charset=utf-8", "shell.css": "text/css; charset=utf-8", + "pages.css": "text/css; charset=utf-8", "pages.js": "text/javascript; charset=utf-8", + "htmx.min.js": "text/javascript; charset=utf-8", + "admin.js": "text/javascript; charset=utf-8", "editor.js": "text/javascript; charset=utf-8"} def static_file(self, name: str) -> HttpResult: content_type = self._STATIC.get(name) diff --git a/src/site_engine/web/admin/render.py b/src/site_engine/web/admin/render.py index 1785613..d77102e 100644 --- a/src/site_engine/web/admin/render.py +++ b/src/site_engine/web/admin/render.py @@ -2,6 +2,7 @@ from __future__ import annotations +from hashlib import sha256 from pathlib import Path from jinja2 import Environment, FileSystemLoader, StrictUndefined @@ -13,6 +14,15 @@ _env = Environment( ) +def static_url(name: str) -> str: + """A changed bundled asset gets a new URL, including after a wheel upgrade.""" + digest = sha256((ADMIN_DIR / "static" / name).read_bytes()).hexdigest()[:12] + return f"/admin/static/{name}?v={digest}" + + +_env.globals["static_url"] = static_url + + def render(name: str, **ctx) -> str: return _env.get_template(name).render(**ctx) diff --git a/src/site_engine/web/admin/routes.py b/src/site_engine/web/admin/routes.py index c489923..1289fc1 100644 --- a/src/site_engine/web/admin/routes.py +++ b/src/site_engine/web/admin/routes.py @@ -16,7 +16,7 @@ from .forms import FormData from .handlers import AdminHandlers, HttpResult -def create_admin_router(handlers: AdminHandlers, editor: EditorHandlers | None = None): +def create_admin_router(handlers: AdminHandlers, editor: EditorHandlers | None = None, application=None): from fastapi import APIRouter, Form, Request, Response router = APIRouter(prefix="/admin") @@ -44,21 +44,28 @@ def create_admin_router(handlers: AdminHandlers, editor: EditorHandlers | None = def logout(request: Request, csrf: str = Form("")): return adapt(handlers.logout(request.cookies.get(COOKIE_NAME), csrf, dict(request.headers), client_ip(request))) - @router.get("/") - def dashboard(request: Request): - return adapt(handlers.dashboard(request.cookies.get(COOKIE_NAME))) + if application is not None: + @router.get("/") + async def dashboard(request: Request): + return adapt(await application.dispatch(request)) + else: + @router.get("/") + def dashboard(request: Request): + return adapt(handlers.dashboard(request.cookies.get(COOKIE_NAME))) @router.get("/static/{name}") def static_file(name: str): return adapt(handlers.static_file(name)) - if editor is not None: + if editor is not None or application is not None: from starlette.concurrency import run_in_threadpool # Все экраны редактора идут через один маршрут: `dispatch` сам сопоставляет путь и метод. # Он объявлен последним, поэтому /login, /logout, /static/* и обзор имеют приоритет. @router.api_route("/{rest:path}", methods=["GET", "POST"]) async def editor_route(request: Request, rest: str): + if application is not None: + return adapt(await application.dispatch(request)) form = FormData() if request.method == "POST": form = FormData.from_pairs((await request.form()).multi_items()) diff --git a/src/site_engine/web/admin/static/VENDOR.md b/src/site_engine/web/admin/static/VENDOR.md new file mode 100644 index 0000000..cd8d43b --- /dev/null +++ b/src/site_engine/web/admin/static/VENDOR.md @@ -0,0 +1,28 @@ +# Сторонние ресурсы + +| Файл | Версия | Источник | Лицензия | SHA-256 | +|---|---|---|---|---| +| htmx.min.js | 2.0.11 | npm `htmx.org`, `dist/htmx.min.js`; побайтовая копия из `flexly-estimator/src/estimator/web/static/htmx.min.js` | 0BSD | `d6fdc75f204e6bdefa99b69bf1e6d4ac69b8a364f77929f45c13476b4000f717` | + +Перенесён 2026-11-12. SHA-256 проверен по файлу и записи `VENDOR.md` проекта flexly-estimator. Повторная загрузка из npm при переносе не выполнялась. + +Upstream: [htmx](https://htmx.org/), [npm htmx.org 2.0.11](https://www.npmjs.com/package/htmx.org/v/2.0.11), [лицензия 0BSD](https://github.com/bigskysoftware/htmx/blob/v2.0.11/LICENSE). + +Обновление: получить дистрибутив нужной версии, проверить integrity npm и SHA-256 файла, заменить библиотеку и обновить эту таблицу. Проверить статическую раздачу, обычные формы, htmx-навигацию, ответы ошибок и включение файла в wheel. Загрузка с CDN и Node-сборка при запуске не требуются. + +Остальные собственные CSS/JS админки не относятся к сторонним ресурсам. + +## Исходники утверждённого дизайна + +`antirion-rework.css` — побайтовая копия `design/assets/antirion-rework.css`, SHA-256 `84700ddb15dae0660a97dff7635dc2cee8717241aba226946e607cf5822cc371`. +SVG paths в `templates/_icons.html.j2` извлечены из `paths` в `design/assets/antirion-rework.js`; viewBox, stroke и размеры сохранены. +Адаптация к HTML/htmx и доступности находится отдельно в `shell.css`/`admin.js`. Старые стили содержимого экранов временно остаются в `admin.css`, их общие элементы изолированы от каркаса. +При изменении CSS/JS URL получает хеш содержимого: браузер загружает новую версию ресурсов после обновления пакета. + + +`builder-design.css` — побайтовая копия `design/assets/builder.css`, SHA-256 `77b5864a5e9c1c0475515f8b0d305514f032c4690f1a06da809395ebe5e399c4`. +Runtime `builder.css` генерируется `scripts/sync_builder_design.py` с помощью `scripts/css_scope.py`: декларации и media queries сохранены, обычные селекторы получают префикс `:where(#document-editor.page-builder)`, document root — `:where(#document-editor).page-builder` с сохранением специфичности `:scope`. SHA-256 результата `a5b94f51ca3b30994fe6c5a48a765d703878eded17410637599f8317a03bcd83`. Это изолирует reset и токены конструктора от принятого каркаса без зависимости от поддержки CSS `@scope` браузером. Аналогично изолированы handwritten-адаптеры и старый редактор в `admin.css`. +SVG в `templates/_builder_icons.html.j2` извлечены тем же скриптом из `I` в `design/assets/builder.js`; viewBox/path/stroke-width 1.7 сохранены. Подсветка исходника использует классификацию `syntaxHighlight` из того же оригинала, выводя текст через DOM text nodes. +Адаптации находятся в `builder-adapter.css`/`builder.js`; исходный `builder.css` вручную не редактируется. Тёмные токены сопоставлены с утверждённым Antirion Rework. Проверка воспроизводимости без записи: `python scripts/sync_builder_design.py --check`. Отдельная frontend-сборка/Node/CDN не требуются. + +`preview.css` переносит оформление выделения/hover и бейдж SELECTED из `previewCss` в `design/assets/builder.js` на служебные `data-preview-*` маркеры настоящих блоков. Этот CSS добавляется только в снимки предпросмотра; публичная сборка его не получает. diff --git a/src/site_engine/web/admin/static/admin.css b/src/site_engine/web/admin/static/admin.css index b3e230b..6e93a30 100644 --- a/src/site_engine/web/admin/static/admin.css +++ b/src/site_engine/web/admin/static/admin.css @@ -1,49 +1,16 @@ -:root { --c-primary: #0b5fff; --c-border: #dcdfe6; --c-muted: #667085; } -* { box-sizing: border-box; } -body { margin: 0; font: 15px/1.5 system-ui, sans-serif; color: #1b1f24; background: #f7f8fa; } -.login { max-width: 22rem; margin: 12vh auto; padding: 1.5rem; background: #fff; border: 1px solid var(--c-border); border-radius: .6rem; } -.login h1 { font-size: 1.2rem; margin: 0 0 1rem; } -label { display: grid; gap: .25rem; margin-bottom: .8rem; font-size: .9rem; color: var(--c-muted); } -input[type=text], input[type=password] { padding: .55rem .6rem; font: inherit; border: 1px solid var(--c-border); border-radius: .4rem; } -button { padding: .55rem 1rem; font: inherit; color: #fff; background: var(--c-primary); border: 0; border-radius: .4rem; cursor: pointer; } -.error { padding: .6rem .8rem; color: #8a1c1c; background: #fdecec; border-radius: .4rem; } -.bar { display: flex; align-items: center; gap: .8rem; padding: .6rem 1rem; background: #fff; border-bottom: 1px solid var(--c-border); } -.bar form { margin: 0; } -.spacer { flex: 1; } -.content { max-width: 60rem; margin: 1.5rem auto; padding: 0 1rem; } -table { width: 100%; border-collapse: collapse; background: #fff; } -th, td { padding: .5rem .7rem; text-align: left; border-bottom: 1px solid var(--c-border); } -.status { padding: .1rem .5rem; border-radius: 1rem; font-size: .8rem; background: #eef0f4; } -.status-published { background: #e3f6e8; } -.status-draft { background: #fff4d6; } -.summary { color: var(--c-muted); } -.nav { display: flex; gap: .2rem; margin-left: 1rem; } -.nav a { padding: .3rem .7rem; color: inherit; text-decoration: none; border-radius: .4rem; } -.nav a.active, .nav a:hover { background: #eef0f4; } -.flash { margin: 0; padding: .5rem 1rem; background: #e3f6e8; } -.muted { color: var(--c-muted); } -.crumbs { margin: 0 0 .3rem; } -.stack { display: grid; gap: .8rem; max-width: 44rem; } -.stack textarea, .field textarea { width: 100%; padding: .5rem; font: inherit; border: 1px solid var(--c-border); border-radius: .4rem; } -.field input[type=text], .field select, .stack input[type=text], .stack select { width: 100%; } -fieldset { border: 1px solid var(--c-border); border-radius: .4rem; padding: .6rem .8rem; background: #fff; } -.row { padding: .5rem 0; border-top: 1px dashed var(--c-border); } -.row.blank { opacity: .75; } -details.bind { font-size: .8rem; color: var(--c-muted); } -.hint { color: var(--c-muted); font-size: .8rem; } -label.inline { display: inline-flex; gap: .3rem; align-items: center; margin-right: .8rem; } -.issues { padding-left: 1.2rem; } -.issues .error { color: #8a1c1c; } -.issues .warning { color: #8a5a00; } -.issues-box { margin: 1rem 0; } -.region { margin: 1rem 0; padding: .6rem 1rem; background: #fff; border: 1px solid var(--c-border); border-radius: .5rem; } -.blocks { list-style: none; padding: 0; margin: .4rem 0; } -.block { padding: .5rem .7rem; margin-bottom: .4rem; border: 1px solid var(--c-border); border-radius: .4rem; } -.block.is-hidden { opacity: .55; } -.block .actions { display: flex; flex-wrap: wrap; gap: .4rem; align-items: center; margin-top: .3rem; } -.slot { margin: .5rem 0 0 1rem; padding-left: .8rem; border-left: 3px solid var(--c-border); } -.inline-form { display: inline; margin: 0; } -button.small { padding: .2rem .6rem; font-size: .85rem; } -button.danger { background: #b42318; } -.add { display: flex; gap: .4rem; margin: .4rem 0; } -iframe.preview { width: 100%; height: 28rem; border: 1px solid var(--c-border); background: #fff; } +/* Legacy screen content,retained until each design screen is transferred. + * The shared Antirion design lives verbatim in antirion-rework.css. */ +.content:not(.design-content) a{color:var(--accent);text-decoration:none}.content:not(.design-content) a:hover{text-decoration:underline}:where(.content:not(.design-content),.login,#confirm-dialog) .unavailable{opacity:.45;cursor:default}.cover{border:0}.skip-link{position:fixed;left:16px;top:-80px;z-index:200;background:var(--paper);padding:12px}.skip-link:focus{top:10px}:where(.content:not(.design-content),.login,#confirm-dialog) :is(a,button,summary):focus-visible{outline:2px solid var(--focus);outline-offset:3px}.content:not(.design-content)>h1{font-size:38px;letter-spacing:-.06em;font-weight:620;margin:10px 0 25px}.content:not(.design-content)>h2{font-size:16px;border-top:1px solid var(--stroke);padding-top:20px;margin-top:28px}:where(.content:not(.design-content),.login,#confirm-dialog) :is(button,.button){border:1px solid var(--stroke);background:var(--paper);color:var(--ink);padding:8px 13px;font-weight:600}:where(.content:not(.design-content),.login,#confirm-dialog) button:hover{background:var(--paper3)}:where(.content:not(.design-content),.login,#confirm-dialog) :is(.primary,button[type=submit]){background:var(--ink);color:var(--paper)}:where(.content:not(.design-content),.login,#confirm-dialog) .small{font-size:11px;padding:5px 9px}:where(.content:not(.design-content),.login,#confirm-dialog) .danger{color:var(--error)}:where(.content:not(.design-content),.login,#confirm-dialog) .stack{display:grid;gap:14px;max-width:820px}:where(.content:not(.design-content),.login,#confirm-dialog) .stack>button{justify-self:start}:where(.content:not(.design-content),.login,#confirm-dialog) label{font-size:12px;line-height:1.6}:where(.content:not(.design-content),.login,#confirm-dialog) label:not(.inline){display:block}:where(.content:not(.design-content),.login,#confirm-dialog) :is(input,select,textarea){color:var(--ink);background:var(--paper);border:1px solid var(--stroke);padding:9px;max-width:100%;min-width:0}:where(.content:not(.design-content),.login,#confirm-dialog) :is(label>input:not([type=checkbox]),label>textarea,label>select){display:block;width:100%;margin-top:5px}:where(.content:not(.design-content),.login,#confirm-dialog) textarea{font-family:ui-monospace,monospace;line-height:1.6;resize:vertical}:where(.content:not(.design-content),.login,#confirm-dialog) fieldset{border:1px solid var(--stroke);padding:15px;min-width:0}:where(.content:not(.design-content),.login,#confirm-dialog) legend{font-size:11px;color:var(--secondary)}:where(.content:not(.design-content),.login,#confirm-dialog) .inline{display:inline-flex;gap:7px;align-items:center}:where(.content:not(.design-content),.login,#confirm-dialog) .inline-form{display:inline;margin:0}:where(.content:not(.design-content),.login,#confirm-dialog) .actions,:where(.content:not(.design-content),.login,#confirm-dialog) .add{display:flex;gap:7px;align-items:center;flex-wrap:wrap}:where(.content:not(.design-content),.login,#confirm-dialog) .table-scroll{overflow:auto;max-width:100%;border-top:1px solid var(--stroke);border-bottom:1px solid var(--stroke)}:where(.content:not(.design-content),.login,#confirm-dialog) table{border-collapse:collapse;width:100%;font-size:12px}:where(.content:not(.design-content),.login,#confirm-dialog) th{text-align:left;font-size:10px;text-transform:uppercase;letter-spacing:.06em;color:var(--secondary);background:var(--paper2)}:where(.content:not(.design-content),.login,#confirm-dialog) td,:where(.content:not(.design-content),.login,#confirm-dialog) th{padding:14px 12px;border-bottom:1px solid var(--stroke2)}:where(.content:not(.design-content),.login,#confirm-dialog) tr:hover td{background:var(--paper2)}:where(.content:not(.design-content),.login,#confirm-dialog) td code{overflow-wrap:anywhere}:where(.content:not(.design-content),.login,#confirm-dialog) code{font-size:11px;overflow-wrap:anywhere}:where(.content:not(.design-content),.login,#confirm-dialog) .status-published{color:var(--good);background:var(--goodbg)}:where(.content:not(.design-content),.login,#confirm-dialog) .status-draft,:where(.content:not(.design-content),.login,#confirm-dialog) .status-archived{color:var(--secondary);background:var(--paper3)}:where(.content:not(.design-content),.login,#confirm-dialog) .error,:where(.content:not(.design-content),.login,#confirm-dialog) .warning,:where(.content:not(.design-content),.login,#confirm-dialog) .flash,:where(.content:not(.design-content),.login,#confirm-dialog) .issues-box{padding:12px;border:1px solid var(--stroke);line-height:1.6}:where(.content:not(.design-content),.login,#confirm-dialog) .error{color:var(--error);background:var(--errorbg)}:where(.content:not(.design-content),.login,#confirm-dialog) .warning{color:var(--warn);background:var(--warnbg)}:where(.content:not(.design-content),.login,#confirm-dialog) .flash{background:var(--goodbg);color:var(--good)}:where(.content:not(.design-content),.login,#confirm-dialog) .issues{padding-left:25px}:where(.content:not(.design-content),.login,#confirm-dialog) .paths{font-size:10px;overflow-wrap:anywhere}:where(.content:not(.design-content),.login,#confirm-dialog) .blocks{list-style:none;padding:0}:where(.content:not(.design-content),.login,#confirm-dialog) .block{border:1px solid var(--stroke);padding:14px;margin:10px 0;background:var(--paper2)}:where(.content:not(.design-content),.login,#confirm-dialog) .block .head{display:flex;flex-wrap:wrap;gap:10px;margin-bottom:12px}:where(.content:not(.design-content),.login,#confirm-dialog) .slot{padding-left:15px;border-left:2px solid var(--stroke);margin-top:14px}:where(.content:not(.design-content),.login,#confirm-dialog) .is-hidden{opacity:.65}:where(.content:not(.design-content),.login,#confirm-dialog) .preview{border:1px solid var(--stroke);width:100%;height:540px;background:white}.login{max-width:410px;margin:12vh auto;padding:30px;border-top:2px solid var(--ink)}.login h1{font-size:30px;letter-spacing:-.05em}.login form{display:grid;gap:16px}:where(.content:not(.design-content),.login,#confirm-dialog) .summary{padding:18px 0;border-block:1px solid var(--stroke)}dialog:not(.shell-dialog){border:1px solid var(--stroke);background:var(--paper);color:var(--ink);width:min(500px,calc(100% - 32px));padding:25px}dialog::backdrop{background:#0008}dialog:not(.shell-dialog) h2{margin-top:0}:where(.content:not(.design-content),.login,#confirm-dialog) .list-toolbar{display:flex;gap:10px;margin:20px 0;flex-wrap:wrap}:where(.content:not(.design-content),.login,#confirm-dialog) .list-toolbar input{flex:1}:where(.content:not(.design-content),.login,#confirm-dialog) .selected-row td{background:var(--accent2)}:where(.content:not(.design-content),.login,#confirm-dialog) .properties{border-top:1px solid var(--stroke);padding:20px 0;margin:20px 0}:where(.content:not(.design-content),.login,#confirm-dialog) .properties dl{display:grid;grid-template-columns:130px 1fr;gap:10px}:where(.content:not(.design-content),.login,#confirm-dialog) .properties dd{margin:0;overflow-wrap:anywhere}:where(.content:not(.design-content),.login,#confirm-dialog) .legacy-source{width:100%;min-height:150px}.login .error{overflow-wrap:anywhere} +@media(max-width:760px){.content:not(.design-content)>h1{font-size:31px}:where(.content:not(.design-content),.login,#confirm-dialog) .stack{max-width:100%}:where(.content:not(.design-content),.login,#confirm-dialog) .preview{height:400px}.login{margin:8vh 16px}:where(.content:not(.design-content),.login,#confirm-dialog) .properties dl{grid-template-columns:95px 1fr}} +@media(prefers-reduced-motion:reduce){*,*::before,*::after{scroll-behavior:auto!important;animation:none!important;transition:none!important}} +/* Document editor: Antirion surfaces, borders and shared controls. */ + + +:where(.content:not(.design-content)) .doc-toolbar,:where(.content:not(.design-content)) .doc-actions{display:flex;align-items:center;gap:10px;flex-wrap:wrap}:where(.content:not(.design-content)) .doc-toolbar{justify-content:space-between}:where(.content:not(.design-content)) .doc-toolbar h1{margin:5px 0}:where(.content:not(.design-content)) .doc-actions{margin:14px 0}:where(.content:not(.design-content)) .eyebrow{font:600 10px ui-monospace,monospace;letter-spacing:.12em;color:var(--secondary)} +:where(.content:not(.design-content)) #buffer-status{font-size:12px;border:1px solid var(--stroke);padding:8px 12px;border-radius:var(--radius)} +:where(.content:not(.design-content)) #document-editor{min-width:0}:where(.content:not(.design-content)) #document-editor textarea{max-width:100%;width:100%}:where(.content:not(.design-content)) #document-source{font:13px/1.6 ui-monospace,monospace;tab-size:2;min-height:420px;white-space:pre} +:where(.content:not(.design-content)) #document-editor[data-ready='1'][data-mode='constructor'] #expert-pane{display:none}:where(.content:not(.design-content)) #document-editor[data-ready='1'][data-mode='expert'] [data-constructor]{display:none} +:where(.content:not(.design-content)) .constructor-grid{display:grid;grid-template-columns:minmax(190px, 280px) minmax(0,1fr);border:1px solid var(--stroke);background:var(--paper)}:where(.content:not(.design-content)) .doc-tree{border-right:1px solid var(--stroke);background:var(--paper2)}:where(.content:not(.design-content)) .doc-tree,:where(.content:not(.design-content)) .doc-inspector{padding:18px;min-width:0}:where(.content:not(.design-content)) .doc-tree h2,:where(.content:not(.design-content)) .doc-inspector h2,:where(.content:not(.design-content)) .doc-preview h2{font-size:15px}:where(.content:not(.design-content)) .doc-tree form{margin:0}:where(.content:not(.design-content)) .doc-tree button{width:100%;text-align:left;white-space:normal}:where(.content:not(.design-content)) .tree-node,:where(.content:not(.design-content)) .readonly-block{border-bottom:1px solid var(--stroke);padding:10px 0;overflow-wrap:anywhere}:where(.content:not(.design-content)) .tree-node[data-depth='1']{padding-left:12px}:where(.content:not(.design-content)) .tree-node[data-depth='2']{padding-left:24px}:where(.content:not(.design-content)) .tree-node[data-depth='3']{padding-left:36px}:where(.content:not(.design-content)) .tree-node.selected{border-left:3px solid var(--accent);padding-left:8px}:where(.content:not(.design-content)) .readonly-block{color:var(--secondary)}:where(.content:not(.design-content)) .doc-inspector form{max-width:800px}:where(.content:not(.design-content)) .conflict-panel{padding:16px;border:1px solid var(--warn);margin:16px 0}:where(.content:not(.design-content)) .conflict-columns{display:grid;grid-template-columns:1fr 1fr;gap:16px;min-width:0}:where(.content:not(.design-content)) .conflict-columns label{min-width:0}:where(.content:not(.design-content)) .conflict-columns textarea{font:12px/1.5 ui-monospace,monospace}:where(.content:not(.design-content)) .doc-preview{margin-top:22px;border:1px solid var(--stroke);padding:12px;background:var(--paper2)}:where(.content:not(.design-content)) #preview-result{min-width:0;overflow:auto}:where(.content:not(.design-content)) #preview-result iframe{display:block;width:100%;height:650px;border:1px solid var(--stroke);background:white;margin:0 auto}:where(.content:not(.design-content)) #preview-result iframe.mobile-viewport{width:390px;max-width:100%} +@media(max-width:800px){:where(.content:not(.design-content)) .constructor-grid,:where(.content:not(.design-content)) .conflict-columns{grid-template-columns:1fr}:where(.content:not(.design-content)) .doc-tree{border-right:0;border-bottom:1px solid var(--stroke)}:where(.content:not(.design-content)) .doc-tree,:where(.content:not(.design-content)) .doc-inspector{padding:12px}:where(.content:not(.design-content)) #preview-result iframe{height:480px}:where(.content:not(.design-content)) .doc-toolbar{align-items:flex-start}:where(.content:not(.design-content)) #buffer-status{width:100%}} +@media(min-width:1380px){:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .editor-layout{display:grid;grid-template-columns:205px minmax(0,1fr) 300px;gap:0;align-items:start;border:1px solid var(--stroke)}:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] #editor-result,:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .constructor-grid{display:contents}:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] #editor-result>p,:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] #editor-result>ul,:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .submitted-fields,:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .conflict-panel{grid-column:1/-1}:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .doc-tree{grid-column:1;grid-row:10;max-height:760px;overflow:auto}:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .doc-inspector{grid-column:3;grid-row:10;max-height:760px;overflow:auto;border-left:1px solid var(--stroke)}:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .doc-preview{grid-column:2;grid-row:10;margin:0;border:0;min-width:0}:where(.content:not(.design-content)) #document-editor[data-mode='constructor'] .doc-preview iframe{height:660px}:where(.content:not(.design-content)) .doc-tree button{background:transparent;color:var(--ink);border:0;padding:10px 4px}:where(.content:not(.design-content)) .doc-tree .selected button{background:var(--accent2)}:where(.content:not(.design-content)) .doc-tree small{color:var(--secondary);font-size:10px}:where(.content:not(.design-content)) .doc-inspector label{margin-bottom:12px}} +:where(.content:not(.design-content)) .doc-inspector pre{white-space:pre-wrap;overflow-wrap:anywhere;max-width:100%;font-size:12px}:where(.content:not(.design-content)) .readonly-block.selected{border-left:3px solid var(--accent);padding-left:8px;background:var(--accent2)} diff --git a/src/site_engine/web/admin/static/admin.js b/src/site_engine/web/admin/static/admin.js new file mode 100644 index 0000000..1858c80 --- /dev/null +++ b/src/site_engine/web/admin/static/admin.js @@ -0,0 +1,115 @@ +/* UI preferences only; document buffers never enter browser storage. */ +(() => { + if (window.siteAdmin) return; + window.siteAdmin = true; + const preference = (key, value) => { try { if (value === undefined) return localStorage.getItem(key); localStorage.setItem(key, value); } catch (_) {} }; + let menuInvoker; + const compact = matchMedia('(max-width: 760px)'); + const rail = matchMedia('(max-width: 1050px)'); + function updateCollapse() { + const narrow = document.getElementById('app')?.classList.contains('narrow'); + document.querySelector('[data-action="collapse"]')?.setAttribute('aria-expanded', String(compact.matches || (rail.matches ? narrow : !narrow))); + } + function closeMenu(restoreFocus = true) { + document.getElementById('sidebar')?.classList.remove('open'); + document.getElementById('cover')?.classList.remove('show'); + document.querySelector('[data-action="mobile"]')?.setAttribute('aria-expanded', 'false'); + const main = document.querySelector('.main'); if (main) main.inert = false; + if (restoreFocus) menuInvoker?.focus(); + menuInvoker = null; + } + function searchCommand() { + const query = document.getElementById('cmd-input')?.value.trim().toLocaleLowerCase() || ''; + let count = 0; + document.querySelectorAll('[data-command-result]').forEach(result => { + result.hidden = !result.dataset.search.toLocaleLowerCase().includes(query) || count >= 12; + if (!result.hidden) count++; + }); + const empty = document.querySelector('[data-command-empty]'); if (empty) empty.hidden = count > 0; + } + function openDialog(id, invoker) { + const dialog = document.getElementById(id); + if (!dialog || dialog.open) return; + closeMenu(false); + dialog.invoker = invoker; + if (id === 'command-dialog') { document.getElementById('cmd-input').value = ''; searchCommand(); } + dialog.showModal(); + if (id === 'command-dialog') document.getElementById('cmd-input').focus(); + } + window.siteAdminConfirm=(title,message,label)=>new Promise(resolve=>{ + const dialog=document.getElementById('confirm-dialog'); + if(!dialog || dialog.open){resolve(false);return;} + document.getElementById('confirm-title').textContent=title; + document.getElementById('confirm-message').textContent=message; + dialog.querySelector('[value=confirm]').textContent=label; + dialog.returnValue='cancel'; + const invoker=document.activeElement; + dialog.addEventListener('close',()=>{invoker?.isConnected&&invoker.focus();resolve(dialog.returnValue==='confirm');},{once:true}); + dialog.showModal(); + }); + function initialize() { + document.body.dataset.skin = preference('site-admin-theme') === 'dark' ? 'dark' : 'light'; + document.getElementById('app')?.classList.toggle('narrow', preference('site-admin-narrow') === '1'); + updateCollapse(); + document.querySelectorAll('table').forEach(table => { + if (!table.closest('.design-content') && !table.parentElement.classList.contains('table-scroll')) { const wrap = document.createElement('div'); wrap.className = 'table-scroll'; table.before(wrap); wrap.append(table); } + }); + document.querySelectorAll('form[action="/admin/publish"]').forEach(form => form.dataset.confirm = 'Собрать и опубликовать текущие файлы сайта?'); + document.querySelectorAll('form[action^="/admin/publish/rollback/"]').forEach(form => form.dataset.confirm = 'Вернуть выбранный релиз? Рабочие файлы сохранятся.'); + } + document.addEventListener('click', event => { + const close = event.target.closest('[data-close-dialog]'); + if (close) { event.preventDefault(); close.closest('dialog').close(); } + const opener = event.target.closest('[data-open-modal]'); + if (opener) { event.preventDefault(); openDialog(opener.dataset.openModal, opener); } + const result = event.target.closest('[data-command-result]'); + if (result) result.closest('dialog').close(); + if (event.target.matches('dialog.shell-dialog')) { + const r = event.target.getBoundingClientRect(); + if (event.clientX < r.left || event.clientX > r.right || event.clientY < r.top || event.clientY > r.bottom) event.target.close(); + } + const button = event.target.closest('[data-action]'); + if (event.target.id === 'cover') closeMenu(); + if (!button) return; + if (button.dataset.action === 'theme') { const skin = document.body.dataset.skin === 'dark' ? 'light' : 'dark'; preference('site-admin-theme', skin); document.body.dataset.skin = skin; } + if (button.dataset.action === 'collapse') { const narrow = document.getElementById('app').classList.toggle('narrow'); preference('site-admin-narrow', narrow ? '1' : '0'); updateCollapse(); } + if (button.dataset.action === 'mobile') { menuInvoker = button; document.getElementById('sidebar').classList.add('open'); document.getElementById('cover').classList.add('show'); button.setAttribute('aria-expanded', 'true'); document.querySelector('.main').inert = true; document.querySelector('.sidebar a')?.focus(); } + if (button.dataset.action === 'command') openDialog('command-dialog', button); + if (button.dataset.action === 'profile') openDialog('profile-dialog', button); + }); + document.addEventListener('close', event => { if (event.target.matches('dialog.shell-dialog')) event.target.invoker?.focus(); }, true); + document.addEventListener('input', event => { if (event.target.id === 'cmd-input') searchCommand(); }); + document.addEventListener('change', event => { if (event.target.matches('[data-rebase-legacy]')) { const form=event.target.form; const etag=form.querySelector('[data-current-etag]'); if (event.target.checked) etag.value=etag.dataset.currentEtag; form.querySelector('[data-retry-legacy]').disabled=!event.target.checked; } }); + document.addEventListener('keydown', event => { + if ((event.ctrlKey || event.metaKey) && event.key.toLowerCase() === 'k') { + if (!document.getElementById('command-dialog') || document.querySelector('dialog[open]')) return; + event.preventDefault(); openDialog('command-dialog', document.querySelector('[data-action="command"]')); + } + const dialog = document.querySelector('dialog[open]'); + if (event.key === 'Tab' && dialog?.open) { + const controls = [...dialog.querySelectorAll('button,input,select,textarea,a[href]')].filter(n => !n.disabled && n.getClientRects().length); + if (event.shiftKey && document.activeElement === controls[0]) { event.preventDefault(); controls.at(-1)?.focus(); } + else if (!event.shiftKey && document.activeElement === controls.at(-1)) { event.preventDefault(); controls[0]?.focus(); } + } + if (event.key === 'Escape' && document.querySelector('.sidebar.open')) closeMenu(); + if (event.key === 'Tab' && document.querySelector('.sidebar.open')) { + const nodes = [...document.querySelectorAll('.sidebar a,.sidebar button')].filter(n => n.getClientRects().length); + if (event.shiftKey && document.activeElement === nodes[0]) { event.preventDefault(); nodes.at(-1).focus(); } + else if (!event.shiftKey && document.activeElement === nodes.at(-1)) { event.preventDefault(); nodes[0].focus(); } + } + }); + document.addEventListener('submit', async event => { + const form = event.target; + if (!form.dataset.confirm || form.dataset.confirmed) return; + event.preventDefault(); event.stopImmediatePropagation(); + const invoker = event.submitter; + if(await window.siteAdminConfirm('Подтверждение',form.dataset.confirm,'Продолжить')) { + form.dataset.confirmed='1'; + try{form.requestSubmit(invoker);}finally{delete form.dataset.confirmed;} + } + }, true); + document.addEventListener('htmx:load', initialize); + compact.addEventListener('change', () => { closeMenu(false); updateCollapse(); }); + rail.addEventListener('change', updateCollapse); + initialize(); +})(); diff --git a/src/site_engine/web/admin/static/antirion-rework.css b/src/site_engine/web/admin/static/antirion-rework.css new file mode 100644 index 0000000..a8b8361 --- /dev/null +++ b/src/site_engine/web/admin/static/antirion-rework.css @@ -0,0 +1,25 @@ +/* Site Engine — 04 / Antirion Rework. An original design inspired by Antirion's flat, hairline-driven console grammar. */ +:root{font-synthesis:none} +*{box-sizing:border-box}html,body{margin:0;min-height:100%;font-family:Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Arial,sans-serif;font-size:13px}button,input,select,textarea{font:inherit}button{cursor:pointer}button:disabled{cursor:not-allowed;opacity:.45}button:focus-visible,input:focus-visible,select:focus-visible{outline:2px solid var(--focus);outline-offset:2px} +body[data-skin="light"]{color-scheme:light;--shell:#151719;--shell2:#1e2023;--nav-text:#b3b4b8;--paper:#f8f8f6;--paper2:#f2f2ef;--paper3:#eaeae6;--ink:#222426;--secondary:#6c6e70;--dim:#9a9c9b;--stroke:#d9dad6;--stroke2:#e5e6e2;--accent:#6558d4;--accent2:#edeafe;--focus:#8f83ef;--good:#347f69;--goodbg:#e8f3ee;--warn:#ac6c32;--warnbg:#fff2e2;--error:#ae4953;--errorbg:#fcebed;--site:#f4f1e9;--siteink:#1f2326;--sider:#fff} +body[data-skin="dark"]{color-scheme:dark;--shell:#101113;--shell2:#1e2022;--nav-text:#a9aaad;--paper:#151719;--paper2:#1b1d20;--paper3:#25272a;--ink:#eeeeed;--secondary:#b0b1b3;--dim:#777a7d;--stroke:#383b3f;--stroke2:#292c30;--accent:#aba2ff;--accent2:#2c293d;--focus:#b9b2ff;--good:#8dd4ad;--goodbg:#1d352d;--warn:#e7b57a;--warnbg:#35291f;--error:#ff9eab;--errorbg:#3c252c;--site:#ebe9e0;--siteink:#1f2326;--sider:#1a1b1e} +body{background:var(--paper);color:var(--ink)}.app{display:grid;grid-template-columns:222px minmax(0,1fr);min-height:100vh}.app.narrow{grid-template-columns:66px minmax(0,1fr)}.sidebar{height:100vh;position:sticky;top:0;background:var(--shell);color:var(--nav-text);display:flex;flex-direction:column;min-width:0;z-index:40}.brand{height:98px;border-bottom:1px solid #333639;display:flex;align-items:center;gap:11px;padding:22px 17px}.brand-logo{width:37px;height:37px;display:grid;place-items:center;flex:none;background:#eeeeea;color:#171819;font-size:22px;font-weight:790;letter-spacing:-.12em;clip-path:polygon(0 0,100% 0,100% 75%,76% 100%,0 100%)}.brand h1{margin:0;color:#f2f2ef;font-size:14px;letter-spacing:-.035em;font-weight:720}.brand p{margin:5px 0 0;color:#777c80;font-size:9px;letter-spacing:.14em;font-weight:700}.nav-title{font-size:9px;letter-spacing:.12em;font-weight:760;color:#707478;margin:27px 17px 10px}.sidebar-nav{padding:0 8px;flex:1;overflow:auto}.nav-item{width:100%;display:flex;gap:12px;align-items:center;height:39px;background:none;border:0;color:#b6b8bc;text-align:left;padding:0 12px;border-radius:0;font-size:12px;position:relative;white-space:nowrap}.nav-item:hover{background:#242629;color:#fff}.nav-item.active{color:#fff;background:#292b2f;font-weight:670}.nav-item.active:before{content:"";position:absolute;inset:0 auto 0 0;width:2px;background:#d5d1ff}.nav-item svg{width:16px;height:16px;flex:none}.nav-item .count{margin-left:auto;border:1px solid #494a4d;font-size:10px;padding:0px 5px;color:#aeb0b4}.sidebar-bottom{border-top:1px solid #36383b;padding:14px}.sitelabel{border:1px solid #3b3d40;padding:10px 9px;display:flex;align-items:center;gap:9px;color:#e8e8ea}.sitelabel svg{width:15px;height:15px}.sitelabel b{font-size:11px}.sitelabel small{display:block;font-size:10px;color:#8e9296;margin-top:4px}.side-footer{display:flex;align-items:center;justify-content:space-between;margin-top:13px}.side-footer button{border:0;background:none;color:#a2a4a8;padding:7px}.side-footer button:hover{color:white}.sidebar .mini-brand{display:none} +.narrow .brand{padding:15px;justify-content:center}.narrow .brand-copy,.narrow .nav-title,.narrow .nav-item span,.narrow .sitelabel,.narrow .side-footer .hide-when-narrow{display:none}.narrow .nav-item{justify-content:center;padding:0}.narrow .sidebar-nav{padding:12px 5px}.narrow .sidebar-bottom{padding:10px 0}.narrow .side-footer{justify-content:center}.narrow .brand-logo{width:33px;height:33px} +.main{min-width:0;min-height:100vh;display:flex;flex-direction:column}.topbar{height:62px;border-bottom:1px solid var(--stroke);display:flex;align-items:center;padding:0 34px;gap:12px;background:var(--paper);flex:none}.crumb{display:flex;align-items:center;gap:10px;color:var(--secondary);font-size:11px;white-space:nowrap;min-width:0}.crumb strong{color:var(--ink);font-weight:620}.cmd{border:1px solid var(--stroke);background:transparent;color:var(--secondary);height:32px;min-width:230px;text-align:left;display:flex;align-items:center;gap:10px;padding:0 10px;white-space:nowrap}.cmd kbd{margin-left:auto;font-size:10px;color:var(--secondary);border:1px solid var(--stroke);padding:2px 5px}.cmd svg{width:14px;height:14px}.header-spacer{flex:1}.live-pip{display:flex;align-items:center;gap:8px;font-size:11px;font-weight:650;white-space:nowrap;color:var(--secondary)}.live-pip:before{content:"";width:7px;height:7px;border-radius:50%;background:var(--good)}.header-btn{display:grid;place-items:center;background:none;border:1px solid transparent;color:var(--secondary);width:32px;height:32px}.header-btn:hover{border-color:var(--stroke);color:var(--ink)}.header-btn svg{width:17px;height:17px}.user-chip{background:var(--ink);color:var(--paper);border:0;width:28px;height:28px;border-radius:50%;font-size:10px;font-weight:800}.workspace{flex:1;min-width:0}.content{width:100%;padding:35px 34px 60px}.kicker{font:700 10px/1.2 ui-monospace,SFMono-Regular,Consolas,monospace;text-transform:uppercase;letter-spacing:.095em;color:var(--secondary)}.headline{display:flex;justify-content:space-between;align-items:end;gap:16px;padding-bottom:25px}.headline h2{font-size:38px;line-height:1.1;font-weight:620;letter-spacing:-.06em;margin:12px 0 9px}.headline p{margin:0;color:var(--secondary);font-size:12px;line-height:1.5}.head-actions{display:flex;gap:8px;align-items:center}.btn{height:34px;border:1px solid var(--stroke);background:transparent;color:var(--ink);display:inline-flex;align-items:center;justify-content:center;gap:7px;padding:0 13px;white-space:nowrap;font-weight:600;font-size:11px}.btn:hover{background:var(--paper3)}.btn.primary{color:var(--paper);background:var(--ink);border-color:var(--ink)}.btn.primary:hover{filter:contrast(.78)}.btn.ghost{border:0}.btn.small{height:28px;padding:0 9px;font-size:10px}.btn svg{width:14px;height:14px}.btn.danger{border-color:var(--error);color:var(--error)}.mono{font-family:ui-monospace,SFMono-Regular,Consolas,monospace}.muted{color:var(--secondary)}.label{color:var(--secondary);text-transform:uppercase;font-size:9px;font-weight:730;letter-spacing:.1em}.label + .label{margin-top:4px}.status{display:inline-flex;align-items:center;gap:6px;font-size:10px;font-weight:600;padding:4px 7px;white-space:nowrap}.status:before{content:"";width:5px;height:5px;border-radius:50%;background:currentColor}.status.live{background:var(--goodbg);color:var(--good)}.status.draft{background:var(--paper3);color:var(--secondary)}.status.changed{background:var(--accent2);color:var(--accent)}.status.error{background:var(--errorbg);color:var(--error)}.status.warn{background:var(--warnbg);color:var(--warn)} +/* Signature Antirion-inspired design move: full-bleed ruled sections instead of cards. */ +.rule{border-top:1px solid var(--stroke)}.ribbon{display:grid;grid-template-columns:repeat(4,minmax(0,1fr));border-top:1px solid var(--stroke);border-bottom:1px solid var(--stroke);min-height:92px;margin-bottom:28px}.ribbon-item{padding:17px 18px;border-right:1px solid var(--stroke);min-width:0}.ribbon-item:first-child{padding-left:0}.ribbon-item:last-child{border-right:0}.ribbon-item .number{font-size:30px;letter-spacing:-.055em;font-weight:650;line-height:1.15;margin:8px 0 0}.ribbon-item .sub{font-size:10px;color:var(--secondary);margin-top:4px}.ribbon-item .number small{font-size:12px;font-weight:550;color:var(--secondary)} +.section-title{display:flex;justify-content:space-between;align-items:center;gap:10px;padding:13px 0;border-bottom:1px solid var(--stroke)}.section-title h3{font-size:13px;margin:0;font-weight:700;letter-spacing:-.01em}.section-title p{font-size:10px;margin:3px 0 0;color:var(--secondary)}.section-grid{display:grid;grid-template-columns:minmax(0,1.5fr) minmax(290px,.75fr);gap:32px}.section-grid > *{min-width:0}.activity{display:flex;align-items:center;gap:12px;border-bottom:1px solid var(--stroke2);padding:12px 0;text-align:left;width:100%;background:none;color:inherit;border-left:0;border-right:0;border-top:0}.activity:hover{background:var(--paper2)}.activity .activity-symbol{flex:none;background:var(--paper3);display:grid;place-items:center;width:30px;height:30px;color:var(--ink)}.activity .activity-symbol svg{width:15px;height:15px}.activity b{font-size:11px;font-weight:650}.activity small{display:block;margin-top:4px;color:var(--secondary);font-size:10px}.activity time{margin-left:auto;color:var(--secondary);font-family:monospace;font-size:10px;white-space:nowrap}.overview-stage{display:grid;grid-template-columns:minmax(0,1.2fr) minmax(300px,.8fr);border-top:1px solid var(--stroke);border-bottom:1px solid var(--stroke);margin-bottom:30px}.overview-lead{padding:27px 25px 29px 0}.overview-lead .giant{font-size:clamp(40px,5vw,77px);font-weight:640;line-height:1.05;letter-spacing:-.085em;margin:18px 0 16px}.overview-lead .giant em{font-style:normal;color:var(--secondary)}.overview-lead p{font-size:12px;color:var(--secondary);max-width:470px;line-height:1.65}.overview-live{border-left:1px solid var(--stroke);padding:25px 0 25px 28px;display:flex;flex-direction:column;justify-content:space-between;gap:20px}.overview-live .buildid{font-size:21px;letter-spacing:-.05em;margin:12px 0 6px}.overview-live .meta{font-size:11px;line-height:1.7;color:var(--secondary)}.overview-live button{align-self:flex-start} +.toolbar{display:flex;gap:8px;align-items:center;margin-bottom:14px;min-width:0}.search{display:flex;align-items:center;gap:9px;border:1px solid var(--stroke);height:35px;flex:1;min-width:0;padding:0 11px;background:var(--paper)}.search svg{width:14px;height:14px;flex:none;color:var(--secondary)}.search input{background:none;border:0;outline:none;color:var(--ink);min-width:0;width:100%;font-size:11px}.search input:focus{outline:0}.select{height:35px;background:var(--paper);border:1px solid var(--stroke);color:var(--ink);padding:0 10px;font-size:11px;min-width:140px}.tabs{display:flex;border-bottom:1px solid var(--stroke);gap:23px;white-space:nowrap;overflow-x:auto;scrollbar-width:none}.tabs button{border:0;background:transparent;padding:12px 0;color:var(--secondary);font-size:11px;position:relative}.tabs button[aria-selected="true"]{color:var(--ink);font-weight:710}.tabs button[aria-selected="true"]:after{content:"";position:absolute;bottom:0;left:0;right:0;height:2px;background:var(--ink)}.tabs .num{font-family:monospace;font-size:10px;color:var(--dim);margin-left:5px} +.workbench{display:grid;grid-template-columns:minmax(0,1fr) 325px;gap:27px;min-width:0}.workbench > *{min-width:0}.data-table{border-collapse:collapse;width:100%;table-layout:fixed}.data-table th{text-align:left;font-size:9px;letter-spacing:.075em;color:var(--secondary);text-transform:uppercase;font-weight:700;border-bottom:1px solid var(--stroke);padding:13px 11px}.data-table td{font-size:11px;padding:11px;border-bottom:1px solid var(--stroke2);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.data-table tr{transition:background .08s}.data-table tbody tr{cursor:pointer}.data-table tbody tr:hover{background:var(--paper2)}.data-table tbody tr.selected{background:var(--accent2)}.data-table tbody tr.selected td:first-child{box-shadow:inset 3px 0 var(--accent)}.data-table td .name{display:flex;align-items:center;gap:10px;min-width:0}.name .file{display:grid;place-items:center;width:27px;height:31px;background:var(--paper3);color:var(--secondary);flex:none}.name .file svg{width:14px;height:14px}.name .labelname{min-width:0}.name b{display:block;font-weight:660;overflow:hidden;text-overflow:ellipsis}.name small{display:block;font-size:10px;color:var(--secondary);margin-top:4px;overflow:hidden;text-overflow:ellipsis}.table-foot{display:flex;justify-content:space-between;gap:10px;align-items:center;font-size:10px;color:var(--secondary);padding:13px 11px}.table-foot span:last-child{cursor:default} +.inspector{border-left:1px solid var(--stroke);padding-left:26px;min-width:0}.inspect-heading{display:flex;align-items:start;justify-content:space-between;gap:8px;padding:12px 0 18px}.inspect-heading h3{font-size:18px;font-weight:680;margin:5px 0;letter-spacing:-.04em}.preview{border:1px solid var(--stroke);padding:9px;background:var(--paper2)}.browser{background:var(--site);color:var(--siteink);height:175px;overflow:hidden}.browserbar{height:21px;background:#e2e1db;border-bottom:1px solid #d4d2cb;display:flex;align-items:center;gap:3px;padding:0 9px}.browserbar i{width:4px;height:4px;border-radius:100%;background:#b0aea6}.browserbar span{font-size:8px;color:#928f87;margin-left:auto}.sitehero{padding:17px 14px}.sitehero .site-header{font-size:7px;letter-spacing:.08em;font-weight:800;border-bottom:1px solid #c5c4bd;padding-bottom:9px;margin-bottom:20px}.sitehero h3{font-size:19px;letter-spacing:-.06em;line-height:1.03;max-width:190px;margin:0 0 8px}.sitehero p{font-size:8px;max-width:210px;color:#777671}.device-toggle{display:flex;border-bottom:1px solid var(--stroke);padding:10px 0;gap:8px}.device-toggle button{flex:1;border:0;background:transparent;color:var(--secondary);padding:6px;font-size:10px}.device-toggle button.active{background:var(--ink);color:var(--paper)}.inspector dl{margin:0}.inspector .kv{display:grid;grid-template-columns:95px minmax(0,1fr);gap:10px;border-bottom:1px solid var(--stroke2);padding:11px 0;font-size:10px}.kv dt{color:var(--secondary)}.kv dd{margin:0;min-width:0;overflow-wrap:anywhere}.inspector-actions{display:flex;gap:7px;padding:17px 0}.inspector-actions .btn{flex:1}.note{background:var(--paper2);border-left:2px solid var(--stroke);padding:11px 12px;color:var(--secondary);font-size:10px;line-height:1.5}.empty{padding:50px 20px;text-align:center;color:var(--secondary);font-size:12px}.empty h3{color:var(--ink);font-size:15px}.empty .btn{margin-top:10px} +.collection-row{display:grid;grid-template-columns:1.2fr 1.2fr .6fr .6fr 30px;align-items:center;gap:10px;border-bottom:1px solid var(--stroke2);padding:15px 12px;cursor:pointer}.collection-row:hover,.collection-row.selected{background:var(--accent2)}.collection-row .collection-name{font-weight:690;font-size:12px}.collection-row .collection-desc{color:var(--secondary);font-size:11px}.collection-row svg{width:14px;height:14px}.collection-row .mono{font-size:11px}.collections-split{display:grid;grid-template-columns:minmax(0,1.3fr) minmax(0,.7fr);gap:33px}.entries-list{margin:0}.entry{width:100%;display:flex;text-align:left;gap:12px;align-items:center;padding:13px 0;border:0;border-bottom:1px solid var(--stroke2);background:transparent;color:var(--ink)}.entry:hover{background:var(--paper2)}.entry b{font-size:11px}.entry small{display:block;margin-top:4px;color:var(--secondary);font-size:10px}.entry .status{margin-left:auto}.leadbar{display:flex;gap:12px;padding:16px 0;border-top:1px solid var(--stroke);border-bottom:1px solid var(--stroke);align-items:center}.leadbar strong{font-size:12px}.leadbar small{font-size:10px;color:var(--secondary);display:block;margin-top:4px}.leadbar .status{margin-left:auto}.release-stages{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));border-bottom:1px solid var(--stroke);margin:15px 0 28px}.stage{padding:25px 23px 25px 0;border-right:1px solid var(--stroke);margin-right:23px}.stage:last-child{border:0;margin-right:0}.stage .step-index{font-size:10px;font-family:monospace;color:var(--secondary)}.stage h3{font-size:18px;letter-spacing:-.035em;margin:14px 0 10px}.stage p{font-size:11px;color:var(--secondary);line-height:1.5;min-height:34px}.release-line{display:grid;grid-template-columns:130px minmax(0,1fr) 100px 76px;gap:12px;align-items:center;border-bottom:1px solid var(--stroke2);padding:13px 0;font-size:11px}.release-line > span{min-width:0;overflow:hidden;text-overflow:ellipsis}.release-line button{justify-self:end}.checks{padding:13px 0;border-bottom:1px solid var(--stroke2);display:flex;align-items:center;gap:12px}.checks .check-icon{width:27px;height:27px;display:grid;place-items:center;background:var(--paper3)}.checks svg{width:14px;height:14px}.checks b{font-size:11px}.checks small{display:block;margin-top:4px;font-size:10px;color:var(--secondary)}.checks .status{margin-left:auto} +.dialog-backdrop{position:fixed;inset:0;z-index:100;background:rgba(10,10,14,.58);display:grid;place-items:center;padding:16px}.dialog{width:min(510px,100%);background:var(--paper);color:var(--ink);border:1px solid var(--stroke);box-shadow:0 20px 70px rgba(0,0,0,.18);max-height:min(90vh,840px);display:flex;flex-direction:column;overflow:auto}.dialog header{display:flex;align-items:start;justify-content:space-between;border-bottom:1px solid var(--stroke);padding:20px}.dialog h3{margin:0;font-size:20px;letter-spacing:-.05em}.dialog header p{color:var(--secondary);font-size:11px;margin:6px 0 0}.dialog .dialog-body{padding:19px 20px}.dialog .dialog-actions{display:flex;justify-content:end;gap:8px;padding:15px 20px;border-top:1px solid var(--stroke)}.field{display:block;margin-bottom:14px;font-size:11px;font-weight:650}.field input,.field select{width:100%;height:36px;border:1px solid var(--stroke);background:var(--paper);color:var(--ink);padding:0 9px;margin-top:7px;font-size:11px}.field small{font-weight:400;color:var(--secondary)}.toast{position:fixed;right:25px;bottom:25px;z-index:200;background:var(--ink);color:var(--paper);border:1px solid var(--stroke);padding:13px 16px;max-width:340px;font-size:11px;box-shadow:0 6px 30px #0002}.command-pop{width:min(570px,100%)}.cmd-list button{width:100%;display:flex;gap:12px;align-items:center;text-align:left;height:39px;background:none;border:0;border-bottom:1px solid var(--stroke2);color:var(--ink);padding:0 7px;font-size:11px}.cmd-list button:hover{background:var(--paper3)}.cmd-list button small{color:var(--secondary);margin-left:auto}.subtle{color:var(--secondary)}.mobile-only{display:none}.cover{display:none}.mobile-menu{display:none}.copyline{display:flex;justify-content:space-between;align-items:center;gap:10px;border-bottom:1px solid var(--stroke2);padding:10px 0;font-size:11px} +@media(max-width:1250px){.content{padding:27px 25px 50px}.topbar{padding:0 25px}.workbench{grid-template-columns:minmax(0,1fr) 285px;gap:20px}.inspector{padding-left:20px}.data-table th,.data-table td{padding-left:8px;padding-right:8px}} +@media(max-width:1050px){.app{grid-template-columns:66px minmax(0,1fr)}.sidebar .brand-copy,.sidebar .nav-title,.sidebar .nav-item span,.sidebar .sitelabel,.sidebar .side-footer .hide-when-narrow{display:none}.sidebar .brand{padding:15px;justify-content:center}.sidebar .brand-logo{width:33px;height:33px}.sidebar .nav-item{justify-content:center;padding:0}.sidebar .sidebar-nav{padding:12px 5px}.sidebar .sidebar-bottom{padding:10px 0}.sidebar .side-footer{justify-content:center}.app.narrow{grid-template-columns:222px minmax(0,1fr)}.app.narrow .sidebar .brand-copy,.app.narrow .sidebar .nav-title,.app.narrow .sidebar .nav-item span,.app.narrow .sidebar .sitelabel,.app.narrow .sidebar .side-footer .hide-when-narrow{display:block}.app.narrow .sidebar .brand{justify-content:start}.app.narrow .sidebar .sidebar-nav{padding:0 8px}.app.narrow .sidebar .nav-item{justify-content:start;padding:0 12px}.workbench{grid-template-columns:minmax(0,1fr)}.inspector{border-left:0;border-top:1px solid var(--stroke);padding:18px 0 0;display:grid;grid-template-columns:220px minmax(0,1fr);gap:0 20px}.inspect-heading{grid-column:1/-1}.inspector .inspect-details{min-width:0}.inspector-actions{grid-column:1/-1}.inspector .note{grid-column:1/-1}} +@media(max-width:760px){.app,.app.narrow{display:block}.sidebar,.app.narrow .sidebar{width:250px;position:fixed;inset:0 auto 0 0;transform:translateX(-102%);transition:transform .16s;box-shadow:15px 0 50px #0004}.sidebar.open{transform:translateX(0)}.sidebar .brand-copy,.sidebar .nav-title,.sidebar .nav-item span,.sidebar .sitelabel,.sidebar .side-footer .hide-when-narrow,.app.narrow .sidebar .brand-copy,.app.narrow .sidebar .nav-title,.app.narrow .sidebar .nav-item span,.app.narrow .sidebar .sitelabel,.app.narrow .sidebar .side-footer .hide-when-narrow{display:block}.sidebar .brand,.app.narrow .sidebar .brand{justify-content:start;padding:22px 17px}.sidebar .sidebar-nav,.app.narrow .sidebar .sidebar-nav{padding:0 8px}.sidebar .nav-item,.app.narrow .sidebar .nav-item{justify-content:start;padding:0 12px}.sidebar .sidebar-bottom{padding:14px}.cover.show{display:block;position:fixed;inset:0;z-index:39;background:#0007}.mobile-menu{display:grid}.topbar{height:53px;padding:0 16px}.crumb{font-size:10px}.cmd{margin-left:auto;min-width:0;width:32px;padding:0;justify-content:center;border:0}.cmd span,.cmd kbd{display:none}.header-spacer{display:none}.content{padding:22px 16px 42px}.headline{align-items:start}.headline h2{font-size:31px}.head-actions{gap:4px}.head-actions .btn{padding:0 9px}.ribbon{grid-template-columns:repeat(2,minmax(0,1fr))}.ribbon-item:nth-child(2){border-right:0}.ribbon-item:nth-child(-n+2){border-bottom:1px solid var(--stroke)}.ribbon-item:nth-child(3){padding-left:0}.ribbon-item .number{font-size:24px}.overview-stage,.section-grid,.collections-split{grid-template-columns:minmax(0,1fr)}.overview-live{border-left:0;border-top:1px solid var(--stroke);padding:20px 0}.overview-lead{padding:20px 0}.overview-lead .giant{font-size:47px}.section-grid{gap:24px}.toolbar{flex-wrap:wrap}.toolbar .search{flex-basis:100%}.toolbar .select{flex:1}.workbench{display:block}.inspector{display:block;margin-top:20px}.inspector .preview{max-width:360px}.release-stages{display:block}.stage{border-right:0;border-bottom:1px solid var(--stroke);margin-right:0;padding:17px 0}.stage:last-child{border:0}.stage p{min-height:0}.release-line{grid-template-columns:90px minmax(0,1fr) 70px}.release-line .datecell{display:none}.mobile-hide{display:none}.collection-row{grid-template-columns:1.3fr .7fr .4fr 25px}.collection-desc{display:none}.inspector .kv{grid-template-columns:110px minmax(0,1fr)}} +@media(max-width:420px){.headline{display:block}.headline .head-actions{margin-top:18px}.headline .btn{min-width:0}.topbar{gap:7px}.topbar .live-pip{font-size:0}.topbar .live-pip:before{width:7px;height:7px}.table-foot span:last-child{display:none}.data-table th,.data-table td{font-size:10px;padding:10px 5px}.data-table .col-layout,.data-table .col-updates{display:none}.data-table col.col-name{width:56%}.data-table col.col-url{width:25%}.data-table col.col-status{width:19%}.data-table .name .file{display:none}.data-table .name b{font-size:10px}.data-table .name small{font-size:8px}.status{font-size:9px;padding:3px 4px}.ribbon-item{padding:14px 10px}.cmd{width:25px}.header-btn{width:24px}.crumb span:first-child{display:none}} +/* Icon geometry is explicitly bounded; standalone inline SVG must never expand its flex/grid cell. */ +.app svg, .dialog svg {width:16px;height:16px;flex:0 0 16px;vertical-align:middle} +.btn svg,.header-btn svg,.cmd svg,.activity svg,.table-foot svg,.device-toggle svg {width:14px;height:14px;flex-basis:14px} +.device-toggle svg{margin-right:4px} +.table-foot svg{width:12px;height:12px;flex-basis:12px} diff --git a/src/site_engine/web/admin/static/builder-adapter.css b/src/site_engine/web/admin/static/builder-adapter.css new file mode 100644 index 0000000..406da35 --- /dev/null +++ b/src/site_engine/web/admin/static/builder-adapter.css @@ -0,0 +1,111 @@ +/* Semantic HTML/CSP adapters. Component declarations come from design/assets/builder.css. */ +.content.builder-content{padding:0} +#document-editor.page-builder{min-width:0} +body[data-skin='dark'] #document-editor.page-builder{color-scheme:dark;--bg:var(--paper);--surface:var(--paper);--surface2:var(--paper2);--surface3:var(--paper3);--text:var(--ink);--muted:var(--secondary);--border:var(--stroke);--border2:var(--stroke2);--accent:#aba2ff;--focus:#b9b2ff;--dim:#777a7d;--accentSoft:var(--accent2);--accentText:var(--paper);--positive:var(--good);--positiveBg:var(--goodbg);--warning:var(--warn);--warningBg:var(--warnbg);--danger:var(--error);--dangerBg:var(--errorbg);--previewOuter:var(--paper2);--shadow:0 10px 30px #0003} + + :where(#document-editor.page-builder) [hidden]{display:none!important} + :where(#document-editor.page-builder) #editor-result,:where(#document-editor.page-builder) .builder-projection{display:contents} + :where(#document-editor.page-builder) .builder{grid-template-rows:minmax(0,1fr)} + :where(#document-editor.page-builder) .pane{min-height:0} + :where(#document-editor.page-builder) .treepane{grid-column:1;grid-row:1} + :where(#document-editor.page-builder) .stagepane{grid-column:2;grid-row:1} + :where(#document-editor.page-builder) .inspectpane{grid-column:3;grid-row:1} + :where(#document-editor.page-builder) .expert-editor-pane,:where(#document-editor.page-builder) .expert-only{display:none} + :where(#document-editor.page-builder) .status:before{display:none} + :where(#document-editor.page-builder) #editor-notice{font-size:10px;color:var(--muted);background:var(--surface2);margin:0;padding:0 13px} + :where(#document-editor.page-builder) #editor-notice:not(:empty){padding-block:7px;border-bottom:1px solid var(--border)} + :where(#document-editor.page-builder) form{margin:0;min-width:0} + :where(#document-editor.page-builder) .tree-select-form .tree-item{width:100%} + :where(#document-editor.page-builder) .tree-item[data-depth='1']{padding-left:20px} + :where(#document-editor.page-builder) .tree-item[data-depth='2']{padding-left:32px} + :where(#document-editor.page-builder) .tree-item[data-depth='3']{padding-left:44px} + :where(#document-editor.page-builder) .tree-item[data-depth='4']{padding-left:56px} + :where(#document-editor.page-builder) .tree-add{padding:9px 2px} + :where(#document-editor.page-builder) .field{position:relative} + :where(#document-editor.page-builder) .field>label{display:block;font-size:12px;font-weight:400;line-height:1.5} + :where(#document-editor.page-builder) .field input,:where(#document-editor.page-builder) .field textarea,:where(#document-editor.page-builder) .field select{font-size:12px;font-weight:400} + :where(#document-editor.page-builder) .field .checkrow{justify-content:flex-start} + :where(#document-editor.page-builder) .field>label>span{display:flex;align-items:center;justify-content:space-between;font-size:10px;color:var(--muted);font-weight:680;margin-bottom:6px;padding-right:65px} + :where(#document-editor.page-builder) .field>.tiny-source{position:absolute;right:0;top:-3px;max-width:160px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + :where(#document-editor.page-builder) .field:has(>[data-value-picker])>label>input{padding-right:92px} + :where(#document-editor.page-builder) .field>[data-value-picker]{position:absolute;right:5px;top:25px} + :where(#document-editor.page-builder) .schema-complex{font-size:10px;margin-bottom:15px} + :where(#document-editor.page-builder) .schema-complex label{display:block;margin-block:6px;color:var(--muted)} + :where(#document-editor.page-builder) .schema-complex input,:where(#document-editor.page-builder) .schema-complex select,:where(#document-editor.page-builder) .schema-complex textarea{width:100%;min-width:0;max-width:100%;font:inherit;color:var(--text);background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);padding:8px 9px} + :where(#document-editor.page-builder) .schema-complex fieldset{min-width:0;border:1px solid var(--border);padding:8px;margin:7px 0} + :where(#document-editor.page-builder) .schema-complex .inline{display:flex;gap:7px;align-items:center} + :where(#document-editor.page-builder) .schema-complex input[type='checkbox']{width:auto} + :where(#document-editor.page-builder) .schema-complex .hint{display:block;color:var(--dim);font-size:10px} + :where(#document-editor.page-builder) .schema-complex .list-item{padding:5px;border-bottom:1px solid var(--border)} + :where(#document-editor.page-builder) .schema-complex button{background:var(--surface2);border:1px solid var(--border);color:var(--text);padding:5px 8px;border-radius:var(--radius);font-size:10px} + :where(#document-editor.page-builder) .apply-inspector{margin-top:3px} + :where(#document-editor.page-builder) .issues{padding:10px 10px 10px 23px;margin:0 0 12px;font-size:10px;overflow-wrap:anywhere} + :where(#document-editor.page-builder) .success{margin-bottom:12px} + :where(#document-editor.page-builder) .stage-scroller>#preview-result{min-width:0;width:100%} + :where(#document-editor.page-builder) #preview-result iframe{width:100%;max-width:100%;height:720px;border:1px solid var(--border);background:#fff;box-shadow:var(--shadow);border-radius:var(--radius);display:block;margin-inline:auto;transition:width .18s} + :where(#document-editor.page-builder) #preview-result iframe.tablet-viewport{width:768px} + :where(#document-editor.page-builder) #preview-result iframe.mobile-viewport{width:390px;height:740px} + :where(#document-editor.page-builder) #preview-result .hint{font-size:10px;color:var(--muted);margin-bottom:8px} + :where(#document-editor.page-builder) .stage-caption{overflow:hidden;text-overflow:ellipsis;white-space:nowrap} + :where(#document-editor.page-builder) dialog.builder-dialog{position:fixed;inset:0;margin:auto;padding:0;color:var(--text);max-width:calc(100vw - 32px);max-height:90dvh} + :where(#document-editor.page-builder) dialog.builder-dialog:not([open]){display:none} + :where(#document-editor.page-builder) dialog.builder-dialog::backdrop{background:#08080bb2} + :where(#document-editor.page-builder) .conflict-columns textarea{font:10px/1.5 ui-monospace,monospace;white-space:pre} + :where(#document-editor.page-builder) .expert-source-form{display:flex;flex-direction:column;min-height:0;flex:1} + :where(#document-editor.page-builder) .expert-source-form textarea{resize:none} + :where(#document-editor.page-builder) .expert-tree-section{padding:9px 7px} + :where(#document-editor.page-builder) .expert-tree-caption{font-size:9px;letter-spacing:.1em;text-transform:uppercase;color:var(--muted);margin:12px 8px 6px} + :where(#document-editor.page-builder) .expert-file.active{background:var(--accentSoft);color:var(--accent);border-color:var(--accent)} + :where(#document-editor.page-builder) .expert-note{margin-top:12px} + :where(#document-editor.page-builder) .expert-highlighter{pointer-events:none} + :where(#document-editor).page-builder:not([data-ready]) .expert-textarea{color:var(--text);-webkit-text-fill-color:var(--text)} + :where(#document-editor.page-builder) .expert-codebox pre{margin:0} + :where(#document-editor).page-builder[data-mode='expert'] .constructor-only{display:none!important} + :where(#document-editor).page-builder[data-mode='expert'] .expert-only{display:block} + :where(#document-editor).page-builder[data-mode='expert'] .pane-head .expert-only{display:inline} + :where(#document-editor).page-builder[data-mode='expert'] .expert-editor-pane{display:flex;grid-column:2;grid-row:1} + :where(#document-editor).page-builder[data-mode='expert'] .treepane{grid-column:1;grid-row:1} + :where(#document-editor).page-builder[data-mode='expert'] .inspectpane{grid-column:3;grid-row:1} + :where(#document-editor.page-builder) .expert-preview-pane{display:flex;flex-direction:column;flex:none;background:var(--surface)} + :where(#document-editor.page-builder) .expert-preview-pane>.stage-toolbar:first-child,:where(#document-editor.page-builder) .expert-preview-pane .stage-caption,:where(#document-editor.page-builder) .expert-preview-pane .pane-foot{display:none} + :where(#document-editor.page-builder) .expert-preview-pane>.stage-toolbar{padding:0;border:0;margin-bottom:11px} + :where(#document-editor.page-builder) .expert-preview-pane .stage-scroller{padding:0;overflow:hidden;flex:none} + :where(#document-editor.page-builder) .expert-preview-pane #preview-result iframe{height:205px;border-radius:var(--radius);box-shadow:none} + :where(#document-editor.page-builder) .expert-side-scroll>.expert-only{min-width:0} + /* The real toolbar wraps with translated labels and longer document titles. + Let it take its actual height; the panes share the remaining viewport. */ + @media(min-width:961px){ + :where(#document-editor).page-builder{display:flex;flex-direction:column;height:calc(100dvh - 62px);min-height:0} + :where(#document-editor.page-builder) .head,:where(#document-editor.page-builder) #editor-notice{flex:none} + :where(#document-editor.page-builder) .builder,:where(#document-editor.page-builder) .builder.expert-layout{flex:1;min-height:0;max-height:none} + } + @media(max-width:1050px){ + :where(#document-editor).page-builder[data-mode='expert']{display:block;height:auto} + :where(#document-editor).page-builder[data-mode='expert'] .builder{height:auto;grid-template-rows:auto auto} + :where(#document-editor).page-builder[data-mode='expert'] .treepane{grid-area:tree} + :where(#document-editor).page-builder[data-mode='expert'] .expert-editor-pane{grid-area:stage} + :where(#document-editor).page-builder[data-mode='expert'] .inspectpane{grid-area:inspect} + :where(#document-editor.page-builder) .expert-preview-pane #preview-result iframe{height:250px} + } + @media(max-width:960px){ + :where(#document-editor.page-builder) .builder{height:auto;grid-template-rows:auto auto} + :where(#document-editor).page-builder:not([data-mode='expert']) .treepane{grid-column:1;grid-row:1} + :where(#document-editor).page-builder:not([data-mode='expert']) .stagepane{grid-column:2;grid-row:1} + :where(#document-editor).page-builder:not([data-mode='expert']) .inspectpane{grid-column:1/3;grid-row:2} + :where(#document-editor.page-builder) #preview-result iframe{height:610px} + } + @media(max-width:700px){ + :where(#document-editor.page-builder) .builder-projection{display:contents} + :where(#document-editor).page-builder[data-mode='expert'] .builder{display:flex} + :where(#document-editor).page-builder[data-mode='expert'] .expert-editor-pane{order:0;min-height:680px} + :where(#document-editor).page-builder[data-mode='expert'] .treepane{order:1;min-height:190px;max-height:none} + :where(#document-editor).page-builder[data-mode='expert'] .inspectpane{order:2} + :where(#document-editor.page-builder) .expert-source-form{min-height:480px} + :where(#document-editor.page-builder) #preview-result iframe{height:440px} + :where(#document-editor.page-builder) #preview-result iframe.mobile-viewport{height:480px} + :where(#document-editor.page-builder) .stage-toolbar{min-width:0} + :where(#document-editor.page-builder) .head-meta{overflow-wrap:anywhere} + :where(#document-editor.page-builder) .head-meta code{white-space:normal} + :where(#document-editor.page-builder) .head-actions #page-picker{max-width:100%} + } + @media(prefers-reduced-motion:reduce){:where(#document-editor.page-builder) #preview-result iframe{transition:none}} diff --git a/src/site_engine/web/admin/static/builder-design.css b/src/site_engine/web/admin/static/builder-design.css new file mode 100644 index 0000000..011a6e3 --- /dev/null +++ b/src/site_engine/web/admin/static/builder-design.css @@ -0,0 +1,189 @@ +/* Site Engine / Stage 2.1–2.2. Shared layout, two approved visual skins. Vanilla CSS. */ +:root{font-synthesis:none}*{box-sizing:border-box}html,body{margin:0;min-height:100%;font:12px/1.5 Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Arial,sans-serif}button,input,textarea,select{font:inherit}button{cursor:pointer}button:disabled{opacity:.38;cursor:not-allowed}button:focus-visible,input:focus-visible,select:focus-visible,textarea:focus-visible,a:focus-visible{outline:2px solid var(--focus);outline-offset:2px}a{color:inherit;text-decoration:none}svg{width:16px;height:16px;flex:none;stroke:currentColor}button svg{width:15px;height:15px}h1,h2,h3,p{margin:0}body{background:var(--bg);color:var(--text)}body[data-theme="antirion"]{color-scheme:light;--nav:#151719;--navhover:#26282b;--navtext:#bbc0c4;--navborder:#343639;--navactive:#ececf2;--bg:#f5f5f3;--surface:#fff;--surface2:#f0f1ee;--surface3:#e9eae7;--text:#222529;--muted:#72777c;--dim:#94999b;--border:#dcdedb;--border2:#e8e9e5;--accent:#665ad8;--accentSoft:#eeebff;--focus:#8173ed;--accentText:#fff;--positive:#2e856d;--positiveBg:#e6f4eb;--warning:#a8742a;--warningBg:#fff2e1;--danger:#b14e60;--dangerBg:#fae9ef;--previewOuter:#e9e9e5;--shadow:0 10px 30px #21282b12;--radius:3px;--pill:3px}body[data-theme="rose"]{color-scheme:dark;--nav:#060607;--navhover:#1b1b20;--navtext:#a5a4b1;--navborder:#29292f;--navactive:#f7f3f8;--bg:#0a0a0d;--surface:#121216;--surface2:#19191e;--surface3:#222229;--text:#f5f2f7;--muted:#a19da8;--dim:#797581;--border:#2e2c33;--border2:#26242b;--accent:#ff4f99;--accentSoft:#321824;--focus:#ff78b5;--accentText:#fff;--positive:#39d6a0;--positiveBg:#132b22;--warning:#ffc786;--warningBg:#332719;--danger:#ff829e;--dangerBg:#3b1a26;--previewOuter:#19191e;--shadow:0 12px 40px #0004;--radius:11px;--pill:7px} +.layout{display:grid;grid-template-columns:220px minmax(0,1fr);min-height:100vh}.side{position:sticky;top:0;height:100dvh;min-width:0;background:var(--nav);border-right:1px solid var(--navborder);color:var(--navtext);display:flex;flex-direction:column;z-index:12}.side-brand{height:78px;display:flex;align-items:center;gap:11px;padding:16px 15px}.brand-logo{height:38px;width:38px;display:grid;place-items:center;background:#e7e7e5;color:#161718;font-size:19px;font-weight:750;letter-spacing:-.1em;clip-path:polygon(0 0,100% 0,100% 77%,78% 100%,0 100%)}[data-theme="rose"] .brand-logo{clip-path:none;border-radius:12px;background:linear-gradient(138deg,#fa9b5c,#ff4c87 70%,#de318c);color:#fff}.brand-copy b{display:block;color:#f5f5f5;font-size:13px}.brand-copy small{display:block;color:#80818b;margin-top:3px;letter-spacing:.12em;font-size:9px}.side-section{margin:21px 17px 8px;text-transform:uppercase;font-size:9px;letter-spacing:.12em;color:#777b80;font-weight:750}.side-nav{padding:0 8px;flex:1;overflow:auto}.side-link{display:flex;align-items:center;gap:11px;min-height:37px;padding:0 11px;color:var(--navtext);margin:2px 0;position:relative;white-space:nowrap}.side-link:hover{background:var(--navhover);color:#fff}.side-link.active{background:#292a2d;color:#fff;font-weight:700}.side-link.active:before{content:"";position:absolute;inset:0 auto 0 0;width:3px;background:#bcb5ff}[data-theme="rose"] .side-link{border-radius:10px}[data-theme="rose"] .side-link.active{background:#1b1b20}[data-theme="rose"] .side-link.active:before{top:7px;bottom:7px;border-radius:4px;background:var(--accent)}.side-link em{margin-left:auto;font:10px ui-monospace,Consolas,monospace;color:#868993;font-style:normal}.side-bottom{padding:14px;border-top:1px solid var(--navborder)}.side-site{padding:11px;border:1px solid #34383c;display:flex;gap:9px;align-items:center;color:#e8e8e8}.side-site b{font-size:10px}.side-site small{display:block;font-size:10px;color:#9397a0;margin-top:3px}[data-theme="rose"] .side-site{border-radius:11px;background:#121216}.side-footer{display:flex;justify-content:space-between;align-items:center;margin-top:12px;font-size:9px;letter-spacing:.09em;color:#777d83}.side-footer a{padding:5px;color:#b1b3bd}.main{min-width:0;min-height:100vh;display:flex;flex-direction:column}.top{height:60px;display:flex;align-items:center;gap:11px;padding:0 22px;background:var(--surface);border-bottom:1px solid var(--border);flex:none}.breadcrumbs{display:flex;gap:9px;align-items:center;color:var(--muted);font-size:11px;min-width:0;white-space:nowrap}.breadcrumbs strong{color:var(--text)}.breadcrumbs .sep{color:var(--dim)}.spacer{flex:1}.top-live{display:flex;align-items:center;gap:7px;color:var(--muted);font-size:10px;white-space:nowrap}.dot{display:inline-block;background:var(--positive);width:7px;height:7px;border-radius:50%;flex:none}.user-pill{height:29px;width:29px;display:grid;place-items:center;border:0;background:var(--text);color:var(--surface);border-radius:50%;font-size:10px;font-weight:700}[data-theme="rose"] .user-pill{background:linear-gradient(135deg,#f56790,#ac54d9);color:white}.top-icon{border:1px solid transparent;background:transparent;color:var(--muted);height:30px;width:30px;display:grid;place-items:center}.top-icon:hover{border-color:var(--border);background:var(--surface2)}.mobile-menu{display:none}.head{min-width:0;display:flex;align-items:center;gap:15px;justify-content:space-between;padding:18px 22px 16px;border-bottom:1px solid var(--border)}.head-main{min-width:0}.eyebrow{font:700 9px ui-monospace,Consolas,monospace;letter-spacing:.10em;color:var(--accent);text-transform:uppercase}.head h1{font-size:22px;font-weight:690;letter-spacing:-.05em;line-height:1.3;margin:3px 0}.head-meta{font-size:10px;color:var(--muted);display:flex;align-items:center;gap:10px;flex-wrap:wrap}.head-meta code{font-size:10px}.head-actions{display:flex;gap:8px;align-items:center;justify-content:flex-end;flex-wrap:wrap}.button{height:32px;border:1px solid var(--border);border-radius:var(--radius);display:inline-flex;align-items:center;justify-content:center;gap:7px;padding:0 12px;background:var(--surface);color:var(--text);font-size:11px;font-weight:650;white-space:nowrap}.button:hover{background:var(--surface2);border-color:var(--accent)}.button.primary{background:var(--accent);color:var(--accentText);border-color:var(--accent)}.button.primary:hover{filter:brightness(1.09)}.button.ghost{background:transparent}.button.small{height:27px;padding:0 8px;font-size:10px}.button.icon{width:30px;padding:0}.button.danger{color:var(--danger);border-color:var(--danger)}.toggle{display:flex;gap:2px;background:var(--surface2);border:1px solid var(--border);padding:3px;border-radius:var(--radius)}.toggle button{height:27px;border:0;color:var(--muted);background:transparent;padding:0 10px;font-size:10px;white-space:nowrap;border-radius:calc(var(--radius) - 2px)}.toggle button.active{background:var(--surface);color:var(--text);box-shadow:0 1px 5px #0001;font-weight:700}[data-theme="rose"] .toggle button.active{background:#2c202a;color:#ff82b6}.status{font-size:10px;display:inline-flex;align-items:center;gap:6px;padding:3px 7px;background:var(--surface3);color:var(--muted);border-radius:var(--pill);white-space:nowrap;font-weight:650}.status.changed{background:var(--accentSoft);color:var(--accent)}.status.good{background:var(--positiveBg);color:var(--positive)}.status.warn{background:var(--warningBg);color:var(--warning)}.status.error{background:var(--dangerBg);color:var(--danger)}.builder{display:grid;grid-template-columns:252px minmax(0,1fr) 302px;min-height:calc(100dvh - 165px);max-height:calc(100dvh - 165px);min-width:0}.pane{min-width:0;display:flex;flex-direction:column;overflow:hidden;background:var(--surface)}.treepane{border-right:1px solid var(--border)}.stagepane{background:var(--previewOuter)}.inspectpane{border-left:1px solid var(--border)}.pane-head{padding:13px 13px 10px;border-bottom:1px solid var(--border);display:flex;align-items:center;justify-content:space-between;gap:7px;flex:none}.pane-head b{font-size:12px;letter-spacing:-.01em}.pane-head small{font-size:10px;color:var(--muted)}.pane-scroll{overflow:auto;min-height:0;flex:1}.pane-foot{border-top:1px solid var(--border);padding:10px 13px;display:flex;align-items:center;gap:7px;justify-content:space-between;flex:none;color:var(--muted);font-size:10px}.tree-tabs{display:grid;grid-template-columns:1fr 1fr;padding:6px;gap:5px;border-bottom:1px solid var(--border)}.tree-tabs button{padding:8px 5px;border:0;color:var(--muted);background:transparent;font-size:10px;border-radius:var(--radius)}.tree-tabs button.active{background:var(--accentSoft);color:var(--accent);font-weight:720}.tree-group{padding:15px 11px 7px}.tree-caption{color:var(--muted);text-transform:uppercase;letter-spacing:.11em;font-size:9px;font-weight:700;margin:0 5px 8px}.tree-layout{padding:10px;background:var(--surface2);border:1px solid var(--border);display:flex;align-items:center;gap:9px;border-radius:var(--radius);margin-bottom:10px}.tree-layout b{font-size:11px}.tree-layout small{font-size:9px;display:block;color:var(--muted)}.tree-region{display:flex;align-items:center;justify-content:space-between;padding:7px 7px;color:var(--muted);font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.06em}.tree-region .plus{border:0;background:transparent;color:var(--accent);font-size:18px;height:22px;width:24px}.tree-item{width:100%;display:flex;align-items:center;gap:7px;background:transparent;border:1px solid transparent;color:var(--text);padding:9px 7px;text-align:left;min-width:0;position:relative;border-radius:var(--radius);margin:1px 0;cursor:pointer}.tree-item:hover{background:var(--surface2)}.tree-item.selected{border-color:var(--accent);background:var(--accentSoft)}.tree-item .node-icon{display:grid;place-items:center;height:25px;width:25px;flex:none;background:var(--surface3);border-radius:var(--radius);color:var(--muted)}.tree-item.selected .node-icon{color:var(--accent)}.tree-item .node-label{min-width:0;flex:1}.tree-item .node-label b{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-size:10px}.tree-item .node-label small{display:block;color:var(--muted);font:9px ui-monospace,Consolas,monospace;margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.tree-item .node-badges{display:flex;gap:3px}.mini-dot{width:6px;height:6px;background:var(--accent);border-radius:50%;display:inline-block}.tree-item.fixed{opacity:.76}.tree-item.hidden{opacity:.47}.tree-item[draggable="true"]{cursor:grab}.tree-item.drag-over{border:1px dashed var(--accent)}.mapping-card{padding:11px;border-bottom:1px solid var(--border2)}.mapping-card button{width:100%;text-align:left;border:0;background:none;color:var(--text);font-weight:680;padding:2px 0}.mapping-card small{color:var(--muted);font-size:10px;display:block;margin:3px 0 6px}.map-route{display:flex;align-items:center;gap:4px;flex-wrap:wrap;color:var(--muted);font:9px ui-monospace,Consolas,monospace}.map-route span{padding:3px 5px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius)}.mapping-note{font-size:10px;color:var(--muted);padding:12px;line-height:1.6}.stage-toolbar{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:11px 13px;border-bottom:1px solid var(--border);background:var(--surface);flex:none}.stage-toolbar .meta{color:var(--muted);font-size:10px;display:flex;align-items:center;gap:7px}.stage-scroller{flex:1;overflow:auto;padding:22px 20px 40px;display:flex;align-items:start;justify-content:center;min-width:0}.preview-frame{width:100%;max-width:100%;height:720px;border:1px solid var(--border);background:white;box-shadow:var(--shadow);border-radius:var(--radius);display:block;transition:width .18s}.preview-frame.tablet{width:768px}.preview-frame.mobile{width:390px;height:740px}.stage-caption{font:9px ui-monospace,Consolas,monospace;color:var(--muted)}.notice{padding:11px;border-bottom:1px solid var(--border);color:var(--muted);font-size:10px;background:var(--surface2)}.notice strong{color:var(--text)}.panel-tabs{padding:9px 12px;display:flex;gap:5px;border-bottom:1px solid var(--border);flex:none}.panel-tabs button{border:0;background:transparent;color:var(--muted);padding:7px 10px;font-size:10px;border-radius:var(--radius)}.panel-tabs button.active{background:var(--accentSoft);color:var(--accent);font-weight:750}.inspect-scroll{padding:15px 14px 30px;overflow:auto;min-height:0;flex:1}.inspect-title{display:flex;justify-content:space-between;align-items:start;margin-bottom:15px;gap:8px}.inspect-title h3{font-size:15px;letter-spacing:-.025em;line-height:1.35}.inspect-title code{display:block;font-size:10px;color:var(--muted);margin-top:5px;overflow-wrap:anywhere}.field{display:block;margin:0 0 15px}.field > span{display:flex;align-items:center;justify-content:space-between;font-size:10px;color:var(--muted);font-weight:680;margin-bottom:6px}.field input,.field textarea,.field select{width:100%;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);color:var(--text);padding:8px 9px;outline:0;min-width:0}.field input,.field select{height:34px}.field textarea{resize:vertical;min-height:64px;line-height:1.5}.field input:focus,.field select:focus,.field textarea:focus{border-color:var(--focus);box-shadow:0 0 0 2px color-mix(in srgb,var(--accent) 12%,transparent)}.field small{display:block;margin-top:5px;color:var(--dim);font-size:10px;line-height:1.4}.field .inline-source{display:flex;gap:5px}.field .inline-source select{flex:0 0 104px;width:104px;font-size:10px}.field .inline-source input{min-width:0;flex:1}.field input[disabled],.field textarea[disabled]{opacity:.64;cursor:not-allowed}.field input[type="checkbox"]{height:15px;width:15px;accent-color:var(--accent)}.field .checkrow{display:flex;align-items:center;gap:9px;color:var(--text);font-size:11px}.divider{height:1px;background:var(--border);margin:14px 0}.actionrow{display:flex;gap:6px;flex-wrap:wrap;margin:12px 0 5px}.actionrow .button{flex:1}.helper{font-size:10px;color:var(--muted);line-height:1.6}.helper code{color:var(--accent)}.source-line{display:flex;gap:5px;flex-wrap:wrap;margin:7px 0}.source-line span{font:9px ui-monospace,Consolas,monospace;background:var(--surface2);border:1px solid var(--border);padding:5px;border-radius:var(--radius)}.inline-alert{margin:9px 0;padding:10px 11px;background:var(--warningBg);color:var(--warning);font-size:10px;border-left:2px solid currentColor}.inline-alert.error{color:var(--danger);background:var(--dangerBg)}.small-title{font-size:10px;text-transform:uppercase;letter-spacing:.10em;color:var(--muted);font-weight:750;margin:18px 0 9px}.codebox{font:10px/1.7 ui-monospace,Consolas,monospace;white-space:pre-wrap;overflow-wrap:anywhere;padding:12px;background:var(--surface2);border:1px solid var(--border);color:var(--text);border-radius:var(--radius)}.mobilebar{display:none}.modal-back{position:fixed;inset:0;z-index:100;background:#08080bb2;display:flex;align-items:center;justify-content:center;padding:16px}.modal{width:min(560px,100%);max-height:90dvh;overflow:auto;background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);box-shadow:0 28px 80px #0005}.modal-head{padding:18px 19px;border-bottom:1px solid var(--border)}.modal-head h2{font-size:18px;letter-spacing:-.03em}.modal-head p{font-size:11px;color:var(--muted);margin-top:5px}.modal-body{padding:17px 19px;max-height:55dvh;overflow:auto}.modal-foot{border-top:1px solid var(--border);padding:12px 19px;display:flex;justify-content:flex-end;gap:8px;flex-wrap:wrap}.modal .field{margin:0 0 13px}.catalog-search{width:100%;padding:10px;background:var(--surface2);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);margin-bottom:10px}.catalog-list{display:grid;gap:6px}.catalog-item{display:flex;align-items:center;gap:12px;width:100%;background:var(--surface2);border:1px solid var(--border);text-align:left;border-radius:var(--radius);padding:11px;color:var(--text)}.catalog-item:hover{border-color:var(--accent)}.catalog-item b{display:block;font-size:11px}.catalog-item small{font-size:10px;display:block;color:var(--muted);margin-top:2px}.catalog-item svg{color:var(--accent);width:18px;height:18px}.catalog-item span{flex:1}.catalog-group{display:flex;gap:5px;margin-bottom:10px;flex-wrap:wrap}.catalog-group button{font-size:10px;border:1px solid var(--border);background:var(--surface2);color:var(--muted);border-radius:var(--radius);padding:5px 9px}.catalog-group button.active{background:var(--accentSoft);color:var(--accent);border-color:var(--accent)}#toast{position:fixed;right:18px;bottom:17px;z-index:130;background:var(--surface);border:1px solid var(--accent);border-radius:var(--radius);padding:12px 15px;color:var(--text);max-width:360px;box-shadow:var(--shadow);display:none;font-size:11px}.mobile-cover{display:none}.muted{color:var(--muted)}.mono{font-family:ui-monospace,Consolas,monospace}.empty{padding:26px 15px;text-align:center;color:var(--muted);font-size:11px}.empty b{display:block;color:var(--text);margin-bottom:4px} +@media(max-width:1380px){.layout{grid-template-columns:205px minmax(0,1fr)}.builder{grid-template-columns:233px minmax(0,1fr) 283px}.head,.top{padding-left:16px;padding-right:16px}.head h1{font-size:20px}} +@media(max-width:1160px){.layout{grid-template-columns:64px minmax(0,1fr)}.side-brand{justify-content:center;padding:10px}.brand-logo{width:34px;height:34px}.brand-copy,.side-section,.side-link span,.side-link em,.side-bottom .side-site,.side-footer small{display:none}.side-nav{padding:0 6px}.side-link{justify-content:center;padding:0}.side-footer{justify-content:center}.builder{grid-template-columns:226px minmax(0,1fr) 277px}} +@media(max-width:960px){.builder{grid-template-columns:218px minmax(0,1fr);max-height:none;min-height:calc(100vh - 165px);grid-template-areas:"tree stage" "inspect inspect"}.treepane{grid-area:tree;min-height:650px;max-height:820px}.stagepane{grid-area:stage;min-height:650px;max-height:820px}.inspectpane{grid-area:inspect;min-height:0;overflow:visible;max-height:none;border:0;border-top:1px solid var(--border)}.inspect-scroll{max-width:750px;width:100%;padding:15px 20px}.pane-scroll{max-height:760px}.stage-scroller{min-height:0}.preview-frame{height:610px}.head{align-items:flex-start}.head-actions{max-width:400px}.inspectpane .pane-foot{display:none}} +@media(max-width:700px){.layout{display:block}.side{position:fixed;left:0;top:0;bottom:0;width:230px;transform:translateX(-110%);transition:transform .2s;box-shadow:18px 0 55px #0006}.side.open{transform:translateX(0)}.mobile-cover.show{position:fixed;inset:0;background:#0009;display:block;z-index:11}.side .brand-copy,.side .side-section,.side .side-link span,.side .side-link em,.side .side-bottom .side-site,.side .side-footer small{display:block}.side .side-link{justify-content:flex-start;padding:0 11px}.mobile-menu{display:grid}.top{height:49px;padding:0 12px}.head{padding:13px 13px 14px;display:block}.head h1{font-size:21px}.head-actions{margin-top:12px;max-width:none;justify-content:flex-start}.head-actions .button{height:30px}.builder{display:flex;flex-direction:column;max-height:none;min-height:0}.pane{overflow:visible;border-left:0;border-right:0}.stagepane{order:0;min-height:0;max-height:none}.treepane{order:1;min-height:0;max-height:none;border-bottom:1px solid var(--border)}.inspectpane{order:2;min-height:0}.stage-scroller{min-height:0;overflow:auto;padding:14px 14px 20px;display:block}.preview-frame{height:440px;width:100%!important;max-width:100%;margin:auto}.preview-frame.mobile{width:390px!important;max-width:100%;height:480px}.stage-toolbar{flex-wrap:wrap;gap:5px}.treepane .pane-scroll,.inspectpane .pane-scroll,.inspect-scroll{overflow:visible;max-height:none}.tree-group{padding-bottom:15px}.tree-item{padding:12px 9px}.pane-head{padding:13px}.inspect-scroll{max-width:100%}.mobilebar{display:flex;padding:7px 12px;gap:6px;border-bottom:1px solid var(--border);background:var(--surface2)}.mobilebar button{flex:1;min-height:31px;border:1px solid var(--border);background:var(--surface);color:var(--text);border-radius:var(--radius)}.top-live{display:none}.breadcrumbs{overflow:hidden;text-overflow:ellipsis}.breadcrumbs .truncate{display:none}} +@media(max-width:390px){.head-actions .toggle{width:100%}.head-actions .button{flex:1}.stage-toolbar .meta{width:100%}.toggle button{padding:0 7px}.head-meta code{overflow:hidden;text-overflow:ellipsis;max-width:225px}.pane-head b{font-size:11px}} +/* Stage 2.3 — source mapping, data explorer and reverse dependencies. */ +.mapping-metrics{display:flex;gap:5px;flex-wrap:wrap;margin:11px 0} +.mapping-metrics span{display:inline-flex;padding:4px 7px;border:1px solid var(--border);background:var(--surface2);font:10px ui-monospace,Consolas,monospace;color:var(--muted);border-radius:var(--pill)} +.mapping-metrics .has-issues{color:var(--warning);background:var(--warningBg);border-color:color-mix(in srgb,var(--warning) 30%,var(--border))} +.mapping-card{padding:11px 10px 13px;margin:0 5px 7px;border:1px solid var(--border);background:var(--surface);border-radius:var(--radius)} +.mapping-card.map-selected{border-color:var(--accent);background:color-mix(in srgb,var(--accentSoft) 34%,var(--surface))} +.mapping-card .map-block-title{display:flex;align-items:flex-start;gap:7px;text-align:left;color:var(--text);padding-bottom:8px;min-width:0} +.mapping-card .map-block-title > svg{width:14px;height:14px;color:var(--accent);flex:none;margin-top:2px} +.mapping-card .map-block-title span{min-width:0} +.mapping-card .map-block-title b{display:block;overflow-wrap:anywhere} +.mapping-card .map-block-title small{font:9px/1.5 ui-monospace,Consolas,monospace;color:var(--muted);overflow-wrap:anywhere} +.map-edge{display:grid;grid-template-columns:minmax(0,65px) auto minmax(0,1fr) 19px;align-items:center;gap:5px;font-size:10px;padding:7px 0;border-top:1px solid var(--border2)} +.map-edge .mono{color:var(--muted);overflow:hidden;text-overflow:ellipsis} +.map-edge .edge-type{font-size:9px;font-weight:700;color:var(--accent);padding:1px 5px;border-radius:var(--pill);background:var(--accentSoft)} +.map-edge .edge-type.error{color:var(--danger);background:var(--dangerBg)} +.map-edge .edge-value{color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-family:ui-monospace,Consolas,monospace;font-size:9px} +.map-edge button{border:0;background:none;color:var(--accent);padding:0;width:19px;height:20px} +.map-issue{color:var(--danger);font-size:9px;line-height:1.45;display:flex;align-items:start;gap:5px;padding-top:5px;overflow-wrap:anywhere} +.map-issue svg{width:11px;height:11px;flex:none} +.tree-error-dot{display:grid;place-items:center;font-size:9px;font-weight:900;height:16px;width:16px;background:var(--dangerBg);color:var(--danger);border-radius:50%} +.picker-current{display:flex;align-items:center;gap:5px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);padding:5px 5px 5px 9px;min-width:0} +.picker-current .mono{font-size:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;flex:1} +.mini-action{border:1px solid var(--border);background:var(--surface2);border-radius:var(--pill);color:var(--muted);display:inline-flex;align-items:center;justify-content:center;gap:5px;padding:6px 8px;font-size:10px;font-weight:600;min-height:27px;white-space:nowrap} +.mini-action svg{height:12px;width:12px} +.mini-action:hover{color:var(--accent);border-color:var(--accent);background:var(--accentSoft)} +.mini-action.primary-action{background:var(--accentSoft);color:var(--accent);border-color:color-mix(in srgb,var(--accent) 32%,var(--border))} +.tiny-source{display:inline-flex;align-items:center;gap:4px;background:var(--surface2);color:var(--muted);border:1px solid var(--border);border-radius:var(--pill);font-size:9px;max-width:158px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;padding:3px 5px} +.tiny-source.bound{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 33%,var(--border));background:var(--accentSoft)} +.tiny-source svg{width:10px;height:10px} +.field-issue{padding:7px 8px;display:flex;gap:5px;align-items:flex-start;font:10px/1.5 ui-monospace,Consolas,monospace;color:var(--warning);background:var(--warningBg);margin-top:7px;border-left:2px solid currentColor;overflow-wrap:anywhere} +.field-issue svg{width:13px;height:13px;flex:none} +.field-issue.error{color:var(--danger);background:var(--dangerBg)} +.binding-entry{border:1px solid var(--border);background:var(--surface2);border-radius:var(--radius);padding:11px;margin:0 0 10px} +.binding-top,.binding-actions{display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap} +.binding-top b{font-size:11px} +.source-type{font:9px ui-monospace,Consolas,monospace;padding:3px 6px;color:var(--accent);background:var(--accentSoft);border:1px solid var(--border);border-radius:var(--pill)} +.source-type.error{color:var(--danger);background:var(--dangerBg)} +.source-type.warn{color:var(--warning);background:var(--warningBg)} +.binding-key{margin:8px 0;color:var(--muted);font:9px/1.5 ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +.binding-result{color:var(--text);display:flex;align-items:flex-start;gap:7px;font-size:11px;line-height:1.45;overflow-wrap:anywhere;margin:8px 0} +.binding-result svg{color:var(--accent);width:13px;height:13px;flex:none;margin-top:2px} +.binding-actions{justify-content:flex-start;gap:5px;margin-top:10px} +.path-strip{display:flex;align-items:center;gap:3px;flex-wrap:wrap;font:9px ui-monospace,Consolas,monospace;color:var(--muted);padding:9px 7px;background:var(--surface2);border:1px solid var(--border);margin:0 0 16px;border-radius:var(--radius)} +.path-strip span{overflow-wrap:anywhere} +.picker-summary{padding:11px;display:flex;gap:7px;flex-wrap:wrap;align-items:center;border:1px solid var(--border);background:var(--surface2);border-radius:var(--radius);font:10px/1.5 ui-monospace,Consolas,monospace;margin-bottom:12px;overflow-wrap:anywhere} +.picker-summary svg{width:15px;height:15px;color:var(--accent)} +.choice-group{margin:14px 0 18px} +.choice-label{font-size:10px;font-weight:750;color:var(--muted);display:flex;justify-content:space-between;text-transform:uppercase;letter-spacing:.06em;margin:10px 0 7px} +.choice-item{width:100%;display:flex;align-items:center;gap:9px;text-align:left;color:var(--text);background:var(--surface2);border:1px solid var(--border);border-bottom:0;padding:10px;min-width:0} +.choice-item:last-child{border-bottom:1px solid var(--border)} +.choice-item:first-of-type{border-radius:var(--radius) var(--radius) 0 0} +.choice-item:last-child{border-radius:0 0 var(--radius) var(--radius)} +.choice-item:hover{background:var(--accentSoft);border-color:var(--accent)} +.choice-item .choice-glyph{color:var(--accent);display:grid;place-items:center;flex:none;width:19px} +.choice-item .choice-glyph svg{width:15px;height:15px} +.choice-info{min-width:0;flex:1} +.choice-info b{display:block;font-size:11px} +.choice-info small{font-size:9px;color:var(--muted);display:block;overflow-wrap:anywhere} +.choice-flag{border-radius:var(--pill);font-size:9px;color:var(--muted);border:1px solid var(--border);padding:3px 5px;flex:none} +.choice-flag.bad{color:var(--danger);background:var(--dangerBg)} +.choice-flag.warning{color:var(--warning);background:var(--warningBg)} +.usage-summary{display:flex;gap:9px;align-items:center;margin-bottom:13px;overflow-wrap:anywhere} +.usage-summary code{font-size:10px;color:var(--muted);overflow-wrap:anywhere} +.usage-item{display:flex;align-items:center;gap:12px;justify-content:space-between;width:100%;background:var(--surface2);color:var(--text);border:1px solid var(--border);border-bottom:0;text-align:left;padding:10px;border-radius:0} +.usage-item:last-of-type{border-bottom:1px solid var(--border)} +.usage-item:hover{background:var(--accentSoft);color:var(--accent)} +.usage-item span{min-width:0} +.usage-item b{display:block;font-size:11px} +.usage-item small{font:9px ui-monospace,Consolas,monospace;display:block;color:var(--muted);overflow-wrap:anywhere;margin-top:5px} +.library-grid{display:grid;gap:0} +.library-head{font-size:10px;font-weight:800;text-transform:uppercase;letter-spacing:.08em;color:var(--accent);margin:15px 0 4px} +.library-row{display:flex;align-items:center;justify-content:space-between;gap:9px;padding:9px 0;border-bottom:1px solid var(--border2)} +.library-row b{font-size:10px;display:block} +.library-row small{font-size:9px;display:block;color:var(--muted);overflow-wrap:anywhere} +.library-row span{min-width:0} +.library-row .mini-action{flex:none} +@media(max-width:700px){.mapping-card{margin:0 10px 9px}.choice-item{padding:9px}.binding-entry{padding:12px}} +.usage-entry{border:1px solid var(--border);border-bottom:0;background:var(--surface2);padding:9px 10px} +.usage-entry:last-of-type{border-bottom:1px solid var(--border)} +.usage-entry b{display:block;font-size:11px} +.usage-entry small{display:block;margin-top:4px;color:var(--muted);font:9px ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +/* Stage 2.4 — live/workspace clarity, per-field QA, version comparisons. */ +.draft-hint{font:10px ui-monospace,Consolas,monospace;color:var(--muted)} +.head-meta{display:flex;align-items:center;gap:8px;flex-wrap:wrap} +.tag-muted{font:9px ui-monospace,Consolas,monospace;color:var(--dim);text-transform:none;letter-spacing:0;margin-left:auto} +.inspector-callout{font-size:10px;line-height:1.6;padding:10px 11px;background:var(--accentSoft);border-left:2px solid var(--accent);margin-bottom:13px;color:var(--text)} +.serp-preview{margin:10px 0 18px;padding:13px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);font-size:11px;overflow-wrap:anywhere} +.serp-url{color:var(--positive);font-size:10px;margin-bottom:4px} +.serp-title{color:var(--accent);font-size:15px;font-weight:650;line-height:1.35;margin-bottom:5px} +.serp-desc{color:var(--muted);font-size:11px} +.markdown-preview{border:1px solid var(--border);background:var(--surface2);margin-top:10px;border-radius:var(--radius)} +.markdown-preview summary{padding:10px 11px;cursor:pointer;color:var(--text);font-weight:650;font-size:10px} +.markdown-render{padding:10px 12px;border-top:1px solid var(--border);font-size:11px;overflow-wrap:anywhere} +.markdown-render h1{font-size:17px;margin-bottom:7px}.markdown-render h2{font-size:15px;margin-bottom:7px}.markdown-render h3{font-size:13px;margin-bottom:6px}.markdown-render p{margin:7px 0}.markdown-render ul{padding-left:20px}.markdown-render a{color:var(--accent);text-decoration:underline} +.review-dialog,.compare-dialog{width:min(1020px,calc(100vw - 32px));max-width:100%;} +.review-summary{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px;margin-bottom:13px} +.review-count{border:1px solid var(--border);background:var(--surface2);padding:12px;display:flex;flex-direction:column;gap:3px;border-radius:var(--radius)} +.review-count b{font-size:24px;line-height:1.2;letter-spacing:-.04em}.review-count span{font-size:10px;color:var(--muted)} +.review-count:first-child b{color:var(--danger)}.review-count:nth-child(2) b{color:var(--warning)}.review-count:nth-child(3) b{color:var(--accent)} +.review-banner{padding:10px 12px;border-left:3px solid var(--positive);background:var(--positiveBg);font-size:11px;margin:8px 0 13px} +.review-banner.danger{background:var(--dangerBg);border-color:var(--danger)} +.review-filters{display:flex;gap:4px;flex-wrap:wrap;padding:4px;background:var(--surface2);border-radius:var(--radius);margin:12px 0} +.review-filters button{border:1px solid transparent;background:transparent;color:var(--muted);padding:8px 10px;font-size:10px;border-radius:var(--pill);font-weight:650} +.review-filters button.active{background:var(--surface);border-color:var(--border);color:var(--text)} +.review-list{max-height:300px;overflow:auto;border:1px solid var(--border);border-radius:var(--radius)} +.review-item{display:flex;align-items:center;width:100%;text-align:left;gap:10px;background:var(--surface);color:var(--text);padding:12px;border:0;border-bottom:1px solid var(--border2)} +.review-item:last-child{border-bottom:0}.review-item:hover{background:var(--accentSoft)} +.issue-label{font-size:9px;font-weight:800;padding:4px 6px;color:var(--warning);background:var(--warningBg);flex:none} +.review-item.error .issue-label{color:var(--danger);background:var(--dangerBg)} +.review-item span:nth-child(2){flex:1;min-width:0} +.review-item b{font-size:11px;display:block;font-weight:600} +.review-item small{display:block;color:var(--muted);margin-top:5px;font:9px/1.4 ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +.review-item svg{color:var(--accent)} +.compare-meta{display:flex;gap:8px;flex-wrap:wrap;align-items:center;font-size:10px;color:var(--muted)} +.compare-meta span{background:var(--surface2);border:1px solid var(--border);padding:6px 8px} +.compare-meta b{color:var(--text)} +.compare-table{border:1px solid var(--border);border-radius:var(--radius);max-height:350px;overflow:auto} +.compare-label-head,.compare-line{display:grid;grid-template-columns:minmax(100px,.7fr) minmax(0,1fr) minmax(0,1fr);gap:8px;padding:10px;border-bottom:1px solid var(--border2);font-size:10px} +.compare-label-head{background:var(--surface2);color:var(--muted);position:sticky;top:0;z-index:1} +.compare-line:last-child{border-bottom:0}.compare-line code{font:10px ui-monospace,Consolas,monospace;color:var(--accent);overflow-wrap:anywhere}.compare-line span{line-height:1.5;overflow-wrap:anywhere;white-space:pre-wrap}.compare-line span:nth-child(2){color:var(--danger)}.compare-line span:nth-child(3){color:var(--positive)} +.visual-compare{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:10px 0} +.visual-compare>div{min-width:0}.visual-compare h3{font-size:11px;margin-bottom:8px;color:var(--muted)} +.compare-mini{background:#f5f5f4;color:#20252d;border:1px solid #d8d9dc;font-family:ui-sans-serif,Arial,sans-serif;min-height:230px;overflow:hidden} +.mini-header{display:flex;justify-content:space-between;background:white;border-bottom:1px solid #e2e3e5;padding:12px;font-weight:800;font-size:13px}.mini-header span{color:#c069a9}.mini-header small{font-size:9px;color:#848896} +.mini-hero{background:#edf0f7;padding:22px 18px;min-height:100px}.mini-hero small{font-size:9px;color:#827aa0}.mini-hero strong{display:block;font-size:17px;line-height:1.2;max-width:300px;margin:8px 0;letter-spacing:-.04em}.mini-hero p{font-size:10px;line-height:1.5;color:#636b7c;max-width:310px} +.mini-section{padding:14px 18px;border-bottom:1px solid #e2e3e5}.mini-section small{color:#898d99;display:block;font-size:9px}.mini-section b{display:block;font-size:13px;margin-top:5px;overflow-wrap:anywhere} +@media(max-width:700px){.review-summary{grid-template-columns:repeat(2,minmax(0,1fr))}.visual-compare{grid-template-columns:1fr}.compare-label-head,.compare-line{grid-template-columns:minmax(0,.7fr) minmax(0,1fr) minmax(0,1fr);gap:5px;padding:8px 6px;font-size:9px}.review-item{padding:9px 7px;gap:6px}.issue-label{font-size:8px}.compare-mini{min-height:180px}.draft-hint{width:100%}} + +/* ━━━━━━━━━━━━━━━ Site Engine / Stage 3 · Expert ━━━━━━━━━━━━━━━ */ +.builder.expert-layout{grid-template-columns:218px minmax(0,1fr) 315px;min-height:calc(100dvh - 165px);max-height:calc(100dvh - 165px)} +.expert-layout .treepane{background:var(--surface2)} +.expert-layout .stagepane{min-height:0;background:var(--surface)} +.expert-layout .inspectpane{background:var(--surface)} +.expert-files{padding:9px 7px;overflow-y:auto} +.expert-folder{display:flex;align-items:center;gap:7px;padding:16px 10px 9px;font:700 10px ui-monospace,Consolas,monospace;color:var(--muted)} +.expert-folder svg{width:13px;height:13px;color:var(--accent)} +.expert-folder small{margin-left:auto;font-size:9px;opacity:.75} +.expert-file{display:flex;width:100%;border:1px solid transparent;align-items:center;gap:9px;min-height:40px;padding:7px 9px;text-align:left;color:var(--text);background:transparent;border-radius:var(--radius)} +.expert-file svg{color:var(--muted);width:14px;height:14px} +.expert-file span{min-width:0;display:block}.expert-file span b{font-size:10px;font-weight:700;display:block}.expert-file span small{font-size:9px;color:var(--muted);display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis} +.expert-file:hover{background:var(--surface3)}.expert-file.selected{background:var(--accentSoft);color:var(--accent);border-color:color-mix(in srgb,var(--accent) 40%,var(--border))}.expert-file.selected svg{color:var(--accent)} +.expert-file.disabled-file{cursor:default;color:var(--dim);font-size:10px;opacity:.8}.expert-file.disabled-file:hover{background:transparent}.expert-tree-note{font-size:10px;line-height:1.65;color:var(--muted);padding:11px;margin:21px 5px;border:1px solid var(--border);background:var(--surface)} +.expert-tree-note b{color:var(--text)} +.expert-editor-header{height:40px;display:flex;align-items:center;justify-content:space-between;gap:10px;border-bottom:1px solid var(--border);padding:0 12px;background:var(--surface2);font-size:10px;color:var(--muted);flex:none} +.expert-editor-header .filetab{align-items:center;display:flex;gap:8px;max-width:100%;min-width:0;padding:0 10px;height:100%;border-bottom:2px solid var(--accent);background:var(--surface)} +.expert-editor-header .filetab svg{color:var(--accent);height:14px;width:14px}.expert-editor-header .filetab b{color:var(--text);font:650 10px ui-monospace,Consolas,monospace;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +.file-edited{color:var(--warning);font-size:13px}.expert-editor-header .muted{white-space:nowrap;font-size:9px;color:var(--muted)} +.expert-tools{display:flex;align-items:center;flex-wrap:wrap;gap:7px;padding:9px 11px;border-bottom:1px solid var(--border);background:var(--surface);flex:none;min-height:45px} +.expert-tools>.mono{font-size:9px;color:var(--dim);margin-right:auto}.expert-find{display:flex;gap:3px}.expert-find input{width:118px;min-width:0;height:28px;padding:0 7px;border:1px solid var(--border);color:var(--text);background:var(--surface2);border-radius:var(--radius);font-size:10px} +.expert-codebox{min-height:300px;flex:1;display:flex;overflow:hidden;position:relative;background:var(--surface)} +.expert-codebox:focus-within{box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--accent) 32%,transparent)} +.expert-gutter{flex:none;margin:0;width:44px;overflow:hidden;padding:13px 9px 40px 7px;border-right:1px solid var(--border);background:var(--surface2);color:var(--dim);font:11.5px/19px ui-monospace,SFMono-Regular,Consolas,monospace;text-align:right;white-space:pre;user-select:none;tab-size:2} +.expert-codewrap{min-width:0;min-height:0;flex:1;position:relative;overflow:hidden} +.expert-highlighter,.expert-textarea{position:absolute;inset:0;margin:0;border:0;border-radius:0;padding:13px 14px 40px;width:100%;height:100%;overflow:auto;white-space:pre;word-wrap:normal;overflow-wrap:normal;tab-size:2;letter-spacing:0;font:11.5px/19px ui-monospace,SFMono-Regular,Consolas,Monaco,monospace} +.expert-highlighter{z-index:0;pointer-events:none;scrollbar-width:none;color:var(--text);background:transparent;white-space:pre} +.expert-highlighter::-webkit-scrollbar{display:none} +.expert-textarea{z-index:1;resize:none;background:transparent;color:transparent;caret-color:var(--text);-webkit-text-fill-color:transparent;outline:none;scrollbar-color:var(--border) transparent} +.expert-textarea::selection{background:color-mix(in srgb,var(--accent) 30%,transparent);-webkit-text-fill-color:transparent} +.expert-textarea:focus-visible{outline:none} +.tok-key{color:var(--accent);font-weight:650}.tok-punct{color:var(--muted)}.tok-value{color:var(--text)}.tok-atom{color:var(--positive)}.tok-rule{color:var(--warning)}.tok-comment{color:var(--dim);font-style:italic}.tok-md{color:var(--text)} +.expert-statusbar{height:29px;display:flex;align-items:center;justify-content:space-between;gap:12px;padding:0 13px;color:var(--muted);background:var(--surface2);border-top:1px solid var(--border);flex:none;font:9px ui-monospace,Consolas,monospace;white-space:nowrap} +.expert-statusbar #expert-source-state{overflow:hidden;text-overflow:ellipsis}.expert-status-invalid{color:var(--danger)}.expert-status-unapplied{color:var(--warning)}.expert-status-good{color:var(--positive)} +.expert-side-scroll{overflow-y:auto;overflow-x:hidden;min-height:0;flex:1;padding:11px;display:flex;flex-direction:column;gap:11px} +.expert-side-top{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:6px} +.expert-mini-preview{height:205px;border:1px solid var(--border);background:var(--previewOuter);border-radius:var(--radius);overflow:hidden;flex:none} +.expert-mini-preview iframe{display:block;height:100%;width:100%;border:0;background:#fff} +.expert-summary{display:flex;align-items:center;justify-content:space-between;gap:8px;border-bottom:1px solid var(--border);padding:6px 0 10px;font-size:11px} +.expert-summary #expert-validation-pip{font-size:9px;color:var(--positive)}.expert-summary #expert-validation-pip.alert{color:var(--danger)} +.expert-issue{min-height:40px}.expert-ok{padding:10px;border-left:2px solid var(--positive);background:var(--positiveBg);font-size:10px;color:var(--positive);line-height:1.5} +.expert-error{padding:10px;border-left:2px solid var(--danger);background:var(--dangerBg);color:var(--danger);font-size:10px;display:flex;flex-direction:column;align-items:start;gap:5px;line-height:1.4} +.expert-error code{overflow-wrap:anywhere}.expert-error .mini-action{margin-top:5px} +.expert-info{display:grid;gap:0;background:var(--surface2);padding:3px 10px;border:1px solid var(--border)}.expert-info>div{display:flex;justify-content:space-between;gap:8px;flex-wrap:wrap;padding:8px 0;border-bottom:1px solid var(--border2);color:var(--muted);font-size:10px}.expert-info>div:last-child{border:0}.expert-info code{color:var(--text);overflow-wrap:anywhere} +.expert-side-actions{display:flex;flex-wrap:wrap;gap:6px}.expert-note{border:1px solid var(--border);background:var(--surface2);padding:11px}.expert-note b{font-size:10px}.expert-note p{margin-top:6px;font-size:10px;line-height:1.65;color:var(--muted)} +.expert-publish-issues{font-size:10px;color:var(--muted)}.expert-publish-issues>b{color:var(--text)}.expert-publish-issues p{margin-top:10px}.expert-publish-line{display:flex;gap:7px;padding:7px 0;border-bottom:1px solid var(--border2);line-height:1.4}.expert-publish-line svg{width:12px;height:12px;flex:none;color:var(--warning)}.expert-publish-line.error svg{color:var(--danger)} +.expert-diff-dialog{width:min(940px,100%)}.expert-diff{overflow:auto;max-height:min(60dvh,650px);border:1px solid var(--border);background:var(--surface2);margin-top:10px} +.diff-line{display:grid;grid-template-columns:35px 35px minmax(0,1fr);min-width:510px;font:10px/1.55 ui-monospace,Consolas,monospace}.diff-line>span{color:var(--dim);border-right:1px solid var(--border);padding:1px 7px;text-align:right;user-select:none}.diff-line code{white-space:pre;min-width:0;overflow:visible;padding:1px 8px;color:var(--text)}.diff-line.add{background:var(--positiveBg)}.diff-line.remove{background:var(--dangerBg)}.diff-line.add code{color:var(--positive)}.diff-line.remove code{color:var(--danger)} +.expert-conflict-dialog{width:min(760px,100%)}.expert-conflict-meta{display:flex;gap:12px;flex-wrap:wrap;justify-content:space-between;border:1px solid var(--border);background:var(--surface2);padding:10px;margin-bottom:13px;font-size:11px}.expert-conflict-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-bottom:14px}.expert-conflict-grid section{padding:13px;border:1px solid var(--border);background:var(--surface2);min-width:0;display:flex;flex-direction:column;gap:8px}.expert-conflict-grid section:first-child{border-top:3px solid var(--accent)}.expert-conflict-grid section:last-child{border-top:3px solid var(--warning)}.expert-conflict-grid h3{font-size:12px}.expert-conflict-grid p{font-size:10px}.expert-conflict-grid code,.expert-conflict-grid small{font-size:10px;color:var(--muted);overflow-wrap:anywhere} +@media(max-width:1380px){.builder.expert-layout{grid-template-columns:195px minmax(0,1fr) 282px}.expert-tools>.mono{display:none}} +@media(max-width:1050px){.builder.expert-layout{grid-template-columns:190px minmax(0,1fr);grid-template-areas:"tree stage" "inspect inspect";max-height:none;min-height:calc(100dvh - 165px)}.expert-layout .treepane{grid-area:tree;min-height:620px;max-height:830px}.expert-layout .stagepane{grid-area:stage;min-height:620px;max-height:830px}.expert-layout .inspectpane{grid-area:inspect;min-height:0;max-height:none}.expert-layout .expert-side-scroll{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));align-items:start}.expert-layout .expert-mini-preview{height:250px}} +@media(max-width:700px){.builder.expert-layout{display:flex;flex-direction:column;max-height:none;min-height:0}.expert-layout .stagepane{order:0;min-height:680px;max-height:none}.expert-layout .treepane{order:1;min-height:190px;max-height:none}.expert-layout .inspectpane{order:2}.expert-codebox{height:480px;flex:none;min-height:480px}.expert-tools{flex-wrap:wrap}.expert-layout .expert-side-scroll{display:flex}.expert-editor-header .muted{display:none}.expert-conflict-grid{grid-template-columns:1fr}.expert-diff{max-height:55dvh}} +@media(max-width:390px){.expert-find input{width:88px}.expert-tools{gap:5px;padding:7px}.expert-gutter{width:34px;padding-left:4px;padding-right:6px}.expert-textarea,.expert-highlighter{font-size:10.5px;line-height:19px;padding-left:9px;padding-right:8px}.expert-statusbar>span:last-child{display:none}} diff --git a/src/site_engine/web/admin/static/builder.css b/src/site_engine/web/admin/static/builder.css new file mode 100644 index 0000000..74b8500 --- /dev/null +++ b/src/site_engine/web/admin/static/builder.css @@ -0,0 +1,190 @@ +/* Generated by scripts/sync_builder_design.py. Do not hand-edit. */ +/* Site Engine / Stage 2.1–2.2. Shared layout, two approved visual skins. Vanilla CSS. */ +:where(#document-editor).page-builder{font-synthesis:none}:where(#document-editor.page-builder) *{box-sizing:border-box}:where(#document-editor).page-builder,:where(#document-editor).page-builder{margin:0;min-height:100%;font:12px/1.5 Inter,ui-sans-serif,-apple-system,BlinkMacSystemFont,"Segoe UI",Arial,sans-serif}:where(#document-editor.page-builder) button,:where(#document-editor.page-builder) input,:where(#document-editor.page-builder) textarea,:where(#document-editor.page-builder) select{font:inherit}:where(#document-editor.page-builder) button{cursor:pointer}:where(#document-editor.page-builder) button:disabled{opacity:.38;cursor:not-allowed}:where(#document-editor.page-builder) button:focus-visible,:where(#document-editor.page-builder) input:focus-visible,:where(#document-editor.page-builder) select:focus-visible,:where(#document-editor.page-builder) textarea:focus-visible,:where(#document-editor.page-builder) a:focus-visible{outline:2px solid var(--focus);outline-offset:2px}:where(#document-editor.page-builder) a{color:inherit;text-decoration:none}:where(#document-editor.page-builder) svg{width:16px;height:16px;flex:none;stroke:currentColor}:where(#document-editor.page-builder) button svg{width:15px;height:15px}:where(#document-editor.page-builder) h1,:where(#document-editor.page-builder) h2,:where(#document-editor.page-builder) h3,:where(#document-editor.page-builder) p{margin:0}:where(#document-editor).page-builder{background:var(--bg);color:var(--text)}:where(#document-editor).page-builder[data-theme="antirion"]{color-scheme:light;--nav:#151719;--navhover:#26282b;--navtext:#bbc0c4;--navborder:#343639;--navactive:#ececf2;--bg:#f5f5f3;--surface:#fff;--surface2:#f0f1ee;--surface3:#e9eae7;--text:#222529;--muted:#72777c;--dim:#94999b;--border:#dcdedb;--border2:#e8e9e5;--accent:#665ad8;--accentSoft:#eeebff;--focus:#8173ed;--accentText:#fff;--positive:#2e856d;--positiveBg:#e6f4eb;--warning:#a8742a;--warningBg:#fff2e1;--danger:#b14e60;--dangerBg:#fae9ef;--previewOuter:#e9e9e5;--shadow:0 10px 30px #21282b12;--radius:3px;--pill:3px}:where(#document-editor).page-builder[data-theme="rose"]{color-scheme:dark;--nav:#060607;--navhover:#1b1b20;--navtext:#a5a4b1;--navborder:#29292f;--navactive:#f7f3f8;--bg:#0a0a0d;--surface:#121216;--surface2:#19191e;--surface3:#222229;--text:#f5f2f7;--muted:#a19da8;--dim:#797581;--border:#2e2c33;--border2:#26242b;--accent:#ff4f99;--accentSoft:#321824;--focus:#ff78b5;--accentText:#fff;--positive:#39d6a0;--positiveBg:#132b22;--warning:#ffc786;--warningBg:#332719;--danger:#ff829e;--dangerBg:#3b1a26;--previewOuter:#19191e;--shadow:0 12px 40px #0004;--radius:11px;--pill:7px} +:where(#document-editor.page-builder) .layout{display:grid;grid-template-columns:220px minmax(0,1fr);min-height:100vh}:where(#document-editor.page-builder) .side{position:sticky;top:0;height:100dvh;min-width:0;background:var(--nav);border-right:1px solid var(--navborder);color:var(--navtext);display:flex;flex-direction:column;z-index:12}:where(#document-editor.page-builder) .side-brand{height:78px;display:flex;align-items:center;gap:11px;padding:16px 15px}:where(#document-editor.page-builder) .brand-logo{height:38px;width:38px;display:grid;place-items:center;background:#e7e7e5;color:#161718;font-size:19px;font-weight:750;letter-spacing:-.1em;clip-path:polygon(0 0,100% 0,100% 77%,78% 100%,0 100%)}:where(#document-editor.page-builder) [data-theme="rose"] .brand-logo{clip-path:none;border-radius:12px;background:linear-gradient(138deg,#fa9b5c,#ff4c87 70%,#de318c);color:#fff}:where(#document-editor.page-builder) .brand-copy b{display:block;color:#f5f5f5;font-size:13px}:where(#document-editor.page-builder) .brand-copy small{display:block;color:#80818b;margin-top:3px;letter-spacing:.12em;font-size:9px}:where(#document-editor.page-builder) .side-section{margin:21px 17px 8px;text-transform:uppercase;font-size:9px;letter-spacing:.12em;color:#777b80;font-weight:750}:where(#document-editor.page-builder) .side-nav{padding:0 8px;flex:1;overflow:auto}:where(#document-editor.page-builder) .side-link{display:flex;align-items:center;gap:11px;min-height:37px;padding:0 11px;color:var(--navtext);margin:2px 0;position:relative;white-space:nowrap}:where(#document-editor.page-builder) .side-link:hover{background:var(--navhover);color:#fff}:where(#document-editor.page-builder) .side-link.active{background:#292a2d;color:#fff;font-weight:700}:where(#document-editor.page-builder) .side-link.active:before{content:"";position:absolute;inset:0 auto 0 0;width:3px;background:#bcb5ff}:where(#document-editor.page-builder) [data-theme="rose"] .side-link{border-radius:10px}:where(#document-editor.page-builder) [data-theme="rose"] .side-link.active{background:#1b1b20}:where(#document-editor.page-builder) [data-theme="rose"] .side-link.active:before{top:7px;bottom:7px;border-radius:4px;background:var(--accent)}:where(#document-editor.page-builder) .side-link em{margin-left:auto;font:10px ui-monospace,Consolas,monospace;color:#868993;font-style:normal}:where(#document-editor.page-builder) .side-bottom{padding:14px;border-top:1px solid var(--navborder)}:where(#document-editor.page-builder) .side-site{padding:11px;border:1px solid #34383c;display:flex;gap:9px;align-items:center;color:#e8e8e8}:where(#document-editor.page-builder) .side-site b{font-size:10px}:where(#document-editor.page-builder) .side-site small{display:block;font-size:10px;color:#9397a0;margin-top:3px}:where(#document-editor.page-builder) [data-theme="rose"] .side-site{border-radius:11px;background:#121216}:where(#document-editor.page-builder) .side-footer{display:flex;justify-content:space-between;align-items:center;margin-top:12px;font-size:9px;letter-spacing:.09em;color:#777d83}:where(#document-editor.page-builder) .side-footer a{padding:5px;color:#b1b3bd}:where(#document-editor.page-builder) .main{min-width:0;min-height:100vh;display:flex;flex-direction:column}:where(#document-editor.page-builder) .top{height:60px;display:flex;align-items:center;gap:11px;padding:0 22px;background:var(--surface);border-bottom:1px solid var(--border);flex:none}:where(#document-editor.page-builder) .breadcrumbs{display:flex;gap:9px;align-items:center;color:var(--muted);font-size:11px;min-width:0;white-space:nowrap}:where(#document-editor.page-builder) .breadcrumbs strong{color:var(--text)}:where(#document-editor.page-builder) .breadcrumbs .sep{color:var(--dim)}:where(#document-editor.page-builder) .spacer{flex:1}:where(#document-editor.page-builder) .top-live{display:flex;align-items:center;gap:7px;color:var(--muted);font-size:10px;white-space:nowrap}:where(#document-editor.page-builder) .dot{display:inline-block;background:var(--positive);width:7px;height:7px;border-radius:50%;flex:none}:where(#document-editor.page-builder) .user-pill{height:29px;width:29px;display:grid;place-items:center;border:0;background:var(--text);color:var(--surface);border-radius:50%;font-size:10px;font-weight:700}:where(#document-editor.page-builder) [data-theme="rose"] .user-pill{background:linear-gradient(135deg,#f56790,#ac54d9);color:white}:where(#document-editor.page-builder) .top-icon{border:1px solid transparent;background:transparent;color:var(--muted);height:30px;width:30px;display:grid;place-items:center}:where(#document-editor.page-builder) .top-icon:hover{border-color:var(--border);background:var(--surface2)}:where(#document-editor.page-builder) .mobile-menu{display:none}:where(#document-editor.page-builder) .head{min-width:0;display:flex;align-items:center;gap:15px;justify-content:space-between;padding:18px 22px 16px;border-bottom:1px solid var(--border)}:where(#document-editor.page-builder) .head-main{min-width:0}:where(#document-editor.page-builder) .eyebrow{font:700 9px ui-monospace,Consolas,monospace;letter-spacing:.10em;color:var(--accent);text-transform:uppercase}:where(#document-editor.page-builder) .head h1{font-size:22px;font-weight:690;letter-spacing:-.05em;line-height:1.3;margin:3px 0}:where(#document-editor.page-builder) .head-meta{font-size:10px;color:var(--muted);display:flex;align-items:center;gap:10px;flex-wrap:wrap}:where(#document-editor.page-builder) .head-meta code{font-size:10px}:where(#document-editor.page-builder) .head-actions{display:flex;gap:8px;align-items:center;justify-content:flex-end;flex-wrap:wrap}:where(#document-editor.page-builder) .button{height:32px;border:1px solid var(--border);border-radius:var(--radius);display:inline-flex;align-items:center;justify-content:center;gap:7px;padding:0 12px;background:var(--surface);color:var(--text);font-size:11px;font-weight:650;white-space:nowrap}:where(#document-editor.page-builder) .button:hover{background:var(--surface2);border-color:var(--accent)}:where(#document-editor.page-builder) .button.primary{background:var(--accent);color:var(--accentText);border-color:var(--accent)}:where(#document-editor.page-builder) .button.primary:hover{filter:brightness(1.09)}:where(#document-editor.page-builder) .button.ghost{background:transparent}:where(#document-editor.page-builder) .button.small{height:27px;padding:0 8px;font-size:10px}:where(#document-editor.page-builder) .button.icon{width:30px;padding:0}:where(#document-editor.page-builder) .button.danger{color:var(--danger);border-color:var(--danger)}:where(#document-editor.page-builder) .toggle{display:flex;gap:2px;background:var(--surface2);border:1px solid var(--border);padding:3px;border-radius:var(--radius)}:where(#document-editor.page-builder) .toggle button{height:27px;border:0;color:var(--muted);background:transparent;padding:0 10px;font-size:10px;white-space:nowrap;border-radius:calc(var(--radius) - 2px)}:where(#document-editor.page-builder) .toggle button.active{background:var(--surface);color:var(--text);box-shadow:0 1px 5px #0001;font-weight:700}:where(#document-editor.page-builder) [data-theme="rose"] .toggle button.active{background:#2c202a;color:#ff82b6}:where(#document-editor.page-builder) .status{font-size:10px;display:inline-flex;align-items:center;gap:6px;padding:3px 7px;background:var(--surface3);color:var(--muted);border-radius:var(--pill);white-space:nowrap;font-weight:650}:where(#document-editor.page-builder) .status.changed{background:var(--accentSoft);color:var(--accent)}:where(#document-editor.page-builder) .status.good{background:var(--positiveBg);color:var(--positive)}:where(#document-editor.page-builder) .status.warn{background:var(--warningBg);color:var(--warning)}:where(#document-editor.page-builder) .status.error{background:var(--dangerBg);color:var(--danger)}:where(#document-editor.page-builder) .builder{display:grid;grid-template-columns:252px minmax(0,1fr) 302px;min-height:calc(100dvh - 165px);max-height:calc(100dvh - 165px);min-width:0}:where(#document-editor.page-builder) .pane{min-width:0;display:flex;flex-direction:column;overflow:hidden;background:var(--surface)}:where(#document-editor.page-builder) .treepane{border-right:1px solid var(--border)}:where(#document-editor.page-builder) .stagepane{background:var(--previewOuter)}:where(#document-editor.page-builder) .inspectpane{border-left:1px solid var(--border)}:where(#document-editor.page-builder) .pane-head{padding:13px 13px 10px;border-bottom:1px solid var(--border);display:flex;align-items:center;justify-content:space-between;gap:7px;flex:none}:where(#document-editor.page-builder) .pane-head b{font-size:12px;letter-spacing:-.01em}:where(#document-editor.page-builder) .pane-head small{font-size:10px;color:var(--muted)}:where(#document-editor.page-builder) .pane-scroll{overflow:auto;min-height:0;flex:1}:where(#document-editor.page-builder) .pane-foot{border-top:1px solid var(--border);padding:10px 13px;display:flex;align-items:center;gap:7px;justify-content:space-between;flex:none;color:var(--muted);font-size:10px}:where(#document-editor.page-builder) .tree-tabs{display:grid;grid-template-columns:1fr 1fr;padding:6px;gap:5px;border-bottom:1px solid var(--border)}:where(#document-editor.page-builder) .tree-tabs button{padding:8px 5px;border:0;color:var(--muted);background:transparent;font-size:10px;border-radius:var(--radius)}:where(#document-editor.page-builder) .tree-tabs button.active{background:var(--accentSoft);color:var(--accent);font-weight:720}:where(#document-editor.page-builder) .tree-group{padding:15px 11px 7px}:where(#document-editor.page-builder) .tree-caption{color:var(--muted);text-transform:uppercase;letter-spacing:.11em;font-size:9px;font-weight:700;margin:0 5px 8px}:where(#document-editor.page-builder) .tree-layout{padding:10px;background:var(--surface2);border:1px solid var(--border);display:flex;align-items:center;gap:9px;border-radius:var(--radius);margin-bottom:10px}:where(#document-editor.page-builder) .tree-layout b{font-size:11px}:where(#document-editor.page-builder) .tree-layout small{font-size:9px;display:block;color:var(--muted)}:where(#document-editor.page-builder) .tree-region{display:flex;align-items:center;justify-content:space-between;padding:7px 7px;color:var(--muted);font-size:10px;font-weight:700;text-transform:uppercase;letter-spacing:.06em}:where(#document-editor.page-builder) .tree-region .plus{border:0;background:transparent;color:var(--accent);font-size:18px;height:22px;width:24px}:where(#document-editor.page-builder) .tree-item{width:100%;display:flex;align-items:center;gap:7px;background:transparent;border:1px solid transparent;color:var(--text);padding:9px 7px;text-align:left;min-width:0;position:relative;border-radius:var(--radius);margin:1px 0;cursor:pointer}:where(#document-editor.page-builder) .tree-item:hover{background:var(--surface2)}:where(#document-editor.page-builder) .tree-item.selected{border-color:var(--accent);background:var(--accentSoft)}:where(#document-editor.page-builder) .tree-item .node-icon{display:grid;place-items:center;height:25px;width:25px;flex:none;background:var(--surface3);border-radius:var(--radius);color:var(--muted)}:where(#document-editor.page-builder) .tree-item.selected .node-icon{color:var(--accent)}:where(#document-editor.page-builder) .tree-item .node-label{min-width:0;flex:1}:where(#document-editor.page-builder) .tree-item .node-label b{display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;font-size:10px}:where(#document-editor.page-builder) .tree-item .node-label small{display:block;color:var(--muted);font:9px ui-monospace,Consolas,monospace;margin-top:2px;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}:where(#document-editor.page-builder) .tree-item .node-badges{display:flex;gap:3px}:where(#document-editor.page-builder) .mini-dot{width:6px;height:6px;background:var(--accent);border-radius:50%;display:inline-block}:where(#document-editor.page-builder) .tree-item.fixed{opacity:.76}:where(#document-editor.page-builder) .tree-item.hidden{opacity:.47}:where(#document-editor.page-builder) .tree-item[draggable="true"]{cursor:grab}:where(#document-editor.page-builder) .tree-item.drag-over{border:1px dashed var(--accent)}:where(#document-editor.page-builder) .mapping-card{padding:11px;border-bottom:1px solid var(--border2)}:where(#document-editor.page-builder) .mapping-card button{width:100%;text-align:left;border:0;background:none;color:var(--text);font-weight:680;padding:2px 0}:where(#document-editor.page-builder) .mapping-card small{color:var(--muted);font-size:10px;display:block;margin:3px 0 6px}:where(#document-editor.page-builder) .map-route{display:flex;align-items:center;gap:4px;flex-wrap:wrap;color:var(--muted);font:9px ui-monospace,Consolas,monospace}:where(#document-editor.page-builder) .map-route span{padding:3px 5px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius)}:where(#document-editor.page-builder) .mapping-note{font-size:10px;color:var(--muted);padding:12px;line-height:1.6}:where(#document-editor.page-builder) .stage-toolbar{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:11px 13px;border-bottom:1px solid var(--border);background:var(--surface);flex:none}:where(#document-editor.page-builder) .stage-toolbar .meta{color:var(--muted);font-size:10px;display:flex;align-items:center;gap:7px}:where(#document-editor.page-builder) .stage-scroller{flex:1;overflow:auto;padding:22px 20px 40px;display:flex;align-items:start;justify-content:center;min-width:0}:where(#document-editor.page-builder) .preview-frame{width:100%;max-width:100%;height:720px;border:1px solid var(--border);background:white;box-shadow:var(--shadow);border-radius:var(--radius);display:block;transition:width .18s}:where(#document-editor.page-builder) .preview-frame.tablet{width:768px}:where(#document-editor.page-builder) .preview-frame.mobile{width:390px;height:740px}:where(#document-editor.page-builder) .stage-caption{font:9px ui-monospace,Consolas,monospace;color:var(--muted)}:where(#document-editor.page-builder) .notice{padding:11px;border-bottom:1px solid var(--border);color:var(--muted);font-size:10px;background:var(--surface2)}:where(#document-editor.page-builder) .notice strong{color:var(--text)}:where(#document-editor.page-builder) .panel-tabs{padding:9px 12px;display:flex;gap:5px;border-bottom:1px solid var(--border);flex:none}:where(#document-editor.page-builder) .panel-tabs button{border:0;background:transparent;color:var(--muted);padding:7px 10px;font-size:10px;border-radius:var(--radius)}:where(#document-editor.page-builder) .panel-tabs button.active{background:var(--accentSoft);color:var(--accent);font-weight:750}:where(#document-editor.page-builder) .inspect-scroll{padding:15px 14px 30px;overflow:auto;min-height:0;flex:1}:where(#document-editor.page-builder) .inspect-title{display:flex;justify-content:space-between;align-items:start;margin-bottom:15px;gap:8px}:where(#document-editor.page-builder) .inspect-title h3{font-size:15px;letter-spacing:-.025em;line-height:1.35}:where(#document-editor.page-builder) .inspect-title code{display:block;font-size:10px;color:var(--muted);margin-top:5px;overflow-wrap:anywhere}:where(#document-editor.page-builder) .field{display:block;margin:0 0 15px}:where(#document-editor.page-builder) .field > span{display:flex;align-items:center;justify-content:space-between;font-size:10px;color:var(--muted);font-weight:680;margin-bottom:6px}:where(#document-editor.page-builder) .field input,:where(#document-editor.page-builder) .field textarea,:where(#document-editor.page-builder) .field select{width:100%;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);color:var(--text);padding:8px 9px;outline:0;min-width:0}:where(#document-editor.page-builder) .field input,:where(#document-editor.page-builder) .field select{height:34px}:where(#document-editor.page-builder) .field textarea{resize:vertical;min-height:64px;line-height:1.5}:where(#document-editor.page-builder) .field input:focus,:where(#document-editor.page-builder) .field select:focus,:where(#document-editor.page-builder) .field textarea:focus{border-color:var(--focus);box-shadow:0 0 0 2px color-mix(in srgb,var(--accent) 12%,transparent)}:where(#document-editor.page-builder) .field small{display:block;margin-top:5px;color:var(--dim);font-size:10px;line-height:1.4}:where(#document-editor.page-builder) .field .inline-source{display:flex;gap:5px}:where(#document-editor.page-builder) .field .inline-source select{flex:0 0 104px;width:104px;font-size:10px}:where(#document-editor.page-builder) .field .inline-source input{min-width:0;flex:1}:where(#document-editor.page-builder) .field input[disabled],:where(#document-editor.page-builder) .field textarea[disabled]{opacity:.64;cursor:not-allowed}:where(#document-editor.page-builder) .field input[type="checkbox"]{height:15px;width:15px;accent-color:var(--accent)}:where(#document-editor.page-builder) .field .checkrow{display:flex;align-items:center;gap:9px;color:var(--text);font-size:11px}:where(#document-editor.page-builder) .divider{height:1px;background:var(--border);margin:14px 0}:where(#document-editor.page-builder) .actionrow{display:flex;gap:6px;flex-wrap:wrap;margin:12px 0 5px}:where(#document-editor.page-builder) .actionrow .button{flex:1}:where(#document-editor.page-builder) .helper{font-size:10px;color:var(--muted);line-height:1.6}:where(#document-editor.page-builder) .helper code{color:var(--accent)}:where(#document-editor.page-builder) .source-line{display:flex;gap:5px;flex-wrap:wrap;margin:7px 0}:where(#document-editor.page-builder) .source-line span{font:9px ui-monospace,Consolas,monospace;background:var(--surface2);border:1px solid var(--border);padding:5px;border-radius:var(--radius)}:where(#document-editor.page-builder) .inline-alert{margin:9px 0;padding:10px 11px;background:var(--warningBg);color:var(--warning);font-size:10px;border-left:2px solid currentColor}:where(#document-editor.page-builder) .inline-alert.error{color:var(--danger);background:var(--dangerBg)}:where(#document-editor.page-builder) .small-title{font-size:10px;text-transform:uppercase;letter-spacing:.10em;color:var(--muted);font-weight:750;margin:18px 0 9px}:where(#document-editor.page-builder) .codebox{font:10px/1.7 ui-monospace,Consolas,monospace;white-space:pre-wrap;overflow-wrap:anywhere;padding:12px;background:var(--surface2);border:1px solid var(--border);color:var(--text);border-radius:var(--radius)}:where(#document-editor.page-builder) .mobilebar{display:none}:where(#document-editor.page-builder) .modal-back{position:fixed;inset:0;z-index:100;background:#08080bb2;display:flex;align-items:center;justify-content:center;padding:16px}:where(#document-editor.page-builder) .modal{width:min(560px,100%);max-height:90dvh;overflow:auto;background:var(--surface);border:1px solid var(--border);border-radius:var(--radius);box-shadow:0 28px 80px #0005}:where(#document-editor.page-builder) .modal-head{padding:18px 19px;border-bottom:1px solid var(--border)}:where(#document-editor.page-builder) .modal-head h2{font-size:18px;letter-spacing:-.03em}:where(#document-editor.page-builder) .modal-head p{font-size:11px;color:var(--muted);margin-top:5px}:where(#document-editor.page-builder) .modal-body{padding:17px 19px;max-height:55dvh;overflow:auto}:where(#document-editor.page-builder) .modal-foot{border-top:1px solid var(--border);padding:12px 19px;display:flex;justify-content:flex-end;gap:8px;flex-wrap:wrap}:where(#document-editor.page-builder) .modal .field{margin:0 0 13px}:where(#document-editor.page-builder) .catalog-search{width:100%;padding:10px;background:var(--surface2);color:var(--text);border:1px solid var(--border);border-radius:var(--radius);margin-bottom:10px}:where(#document-editor.page-builder) .catalog-list{display:grid;gap:6px}:where(#document-editor.page-builder) .catalog-item{display:flex;align-items:center;gap:12px;width:100%;background:var(--surface2);border:1px solid var(--border);text-align:left;border-radius:var(--radius);padding:11px;color:var(--text)}:where(#document-editor.page-builder) .catalog-item:hover{border-color:var(--accent)}:where(#document-editor.page-builder) .catalog-item b{display:block;font-size:11px}:where(#document-editor.page-builder) .catalog-item small{font-size:10px;display:block;color:var(--muted);margin-top:2px}:where(#document-editor.page-builder) .catalog-item svg{color:var(--accent);width:18px;height:18px}:where(#document-editor.page-builder) .catalog-item span{flex:1}:where(#document-editor.page-builder) .catalog-group{display:flex;gap:5px;margin-bottom:10px;flex-wrap:wrap}:where(#document-editor.page-builder) .catalog-group button{font-size:10px;border:1px solid var(--border);background:var(--surface2);color:var(--muted);border-radius:var(--radius);padding:5px 9px}:where(#document-editor.page-builder) .catalog-group button.active{background:var(--accentSoft);color:var(--accent);border-color:var(--accent)}:where(#document-editor.page-builder) #toast{position:fixed;right:18px;bottom:17px;z-index:130;background:var(--surface);border:1px solid var(--accent);border-radius:var(--radius);padding:12px 15px;color:var(--text);max-width:360px;box-shadow:var(--shadow);display:none;font-size:11px}:where(#document-editor.page-builder) .mobile-cover{display:none}:where(#document-editor.page-builder) .muted{color:var(--muted)}:where(#document-editor.page-builder) .mono{font-family:ui-monospace,Consolas,monospace}:where(#document-editor.page-builder) .empty{padding:26px 15px;text-align:center;color:var(--muted);font-size:11px}:where(#document-editor.page-builder) .empty b{display:block;color:var(--text);margin-bottom:4px} +@media(max-width:1380px){:where(#document-editor.page-builder) .layout{grid-template-columns:205px minmax(0,1fr)}:where(#document-editor.page-builder) .builder{grid-template-columns:233px minmax(0,1fr) 283px}:where(#document-editor.page-builder) .head,:where(#document-editor.page-builder) .top{padding-left:16px;padding-right:16px}:where(#document-editor.page-builder) .head h1{font-size:20px}} +@media(max-width:1160px){:where(#document-editor.page-builder) .layout{grid-template-columns:64px minmax(0,1fr)}:where(#document-editor.page-builder) .side-brand{justify-content:center;padding:10px}:where(#document-editor.page-builder) .brand-logo{width:34px;height:34px}:where(#document-editor.page-builder) .brand-copy,:where(#document-editor.page-builder) .side-section,:where(#document-editor.page-builder) .side-link span,:where(#document-editor.page-builder) .side-link em,:where(#document-editor.page-builder) .side-bottom .side-site,:where(#document-editor.page-builder) .side-footer small{display:none}:where(#document-editor.page-builder) .side-nav{padding:0 6px}:where(#document-editor.page-builder) .side-link{justify-content:center;padding:0}:where(#document-editor.page-builder) .side-footer{justify-content:center}:where(#document-editor.page-builder) .builder{grid-template-columns:226px minmax(0,1fr) 277px}} +@media(max-width:960px){:where(#document-editor.page-builder) .builder{grid-template-columns:218px minmax(0,1fr);max-height:none;min-height:calc(100vh - 165px);grid-template-areas:"tree stage" "inspect inspect"}:where(#document-editor.page-builder) .treepane{grid-area:tree;min-height:650px;max-height:820px}:where(#document-editor.page-builder) .stagepane{grid-area:stage;min-height:650px;max-height:820px}:where(#document-editor.page-builder) .inspectpane{grid-area:inspect;min-height:0;overflow:visible;max-height:none;border:0;border-top:1px solid var(--border)}:where(#document-editor.page-builder) .inspect-scroll{max-width:750px;width:100%;padding:15px 20px}:where(#document-editor.page-builder) .pane-scroll{max-height:760px}:where(#document-editor.page-builder) .stage-scroller{min-height:0}:where(#document-editor.page-builder) .preview-frame{height:610px}:where(#document-editor.page-builder) .head{align-items:flex-start}:where(#document-editor.page-builder) .head-actions{max-width:400px}:where(#document-editor.page-builder) .inspectpane .pane-foot{display:none}} +@media(max-width:700px){:where(#document-editor.page-builder) .layout{display:block}:where(#document-editor.page-builder) .side{position:fixed;left:0;top:0;bottom:0;width:230px;transform:translateX(-110%);transition:transform .2s;box-shadow:18px 0 55px #0006}:where(#document-editor.page-builder) .side.open{transform:translateX(0)}:where(#document-editor.page-builder) .mobile-cover.show{position:fixed;inset:0;background:#0009;display:block;z-index:11}:where(#document-editor.page-builder) .side .brand-copy,:where(#document-editor.page-builder) .side .side-section,:where(#document-editor.page-builder) .side .side-link span,:where(#document-editor.page-builder) .side .side-link em,:where(#document-editor.page-builder) .side .side-bottom .side-site,:where(#document-editor.page-builder) .side .side-footer small{display:block}:where(#document-editor.page-builder) .side .side-link{justify-content:flex-start;padding:0 11px}:where(#document-editor.page-builder) .mobile-menu{display:grid}:where(#document-editor.page-builder) .top{height:49px;padding:0 12px}:where(#document-editor.page-builder) .head{padding:13px 13px 14px;display:block}:where(#document-editor.page-builder) .head h1{font-size:21px}:where(#document-editor.page-builder) .head-actions{margin-top:12px;max-width:none;justify-content:flex-start}:where(#document-editor.page-builder) .head-actions .button{height:30px}:where(#document-editor.page-builder) .builder{display:flex;flex-direction:column;max-height:none;min-height:0}:where(#document-editor.page-builder) .pane{overflow:visible;border-left:0;border-right:0}:where(#document-editor.page-builder) .stagepane{order:0;min-height:0;max-height:none}:where(#document-editor.page-builder) .treepane{order:1;min-height:0;max-height:none;border-bottom:1px solid var(--border)}:where(#document-editor.page-builder) .inspectpane{order:2;min-height:0}:where(#document-editor.page-builder) .stage-scroller{min-height:0;overflow:auto;padding:14px 14px 20px;display:block}:where(#document-editor.page-builder) .preview-frame{height:440px;width:100%!important;max-width:100%;margin:auto}:where(#document-editor.page-builder) .preview-frame.mobile{width:390px!important;max-width:100%;height:480px}:where(#document-editor.page-builder) .stage-toolbar{flex-wrap:wrap;gap:5px}:where(#document-editor.page-builder) .treepane .pane-scroll,:where(#document-editor.page-builder) .inspectpane .pane-scroll,:where(#document-editor.page-builder) .inspect-scroll{overflow:visible;max-height:none}:where(#document-editor.page-builder) .tree-group{padding-bottom:15px}:where(#document-editor.page-builder) .tree-item{padding:12px 9px}:where(#document-editor.page-builder) .pane-head{padding:13px}:where(#document-editor.page-builder) .inspect-scroll{max-width:100%}:where(#document-editor.page-builder) .mobilebar{display:flex;padding:7px 12px;gap:6px;border-bottom:1px solid var(--border);background:var(--surface2)}:where(#document-editor.page-builder) .mobilebar button{flex:1;min-height:31px;border:1px solid var(--border);background:var(--surface);color:var(--text);border-radius:var(--radius)}:where(#document-editor.page-builder) .top-live{display:none}:where(#document-editor.page-builder) .breadcrumbs{overflow:hidden;text-overflow:ellipsis}:where(#document-editor.page-builder) .breadcrumbs .truncate{display:none}} +@media(max-width:390px){:where(#document-editor.page-builder) .head-actions .toggle{width:100%}:where(#document-editor.page-builder) .head-actions .button{flex:1}:where(#document-editor.page-builder) .stage-toolbar .meta{width:100%}:where(#document-editor.page-builder) .toggle button{padding:0 7px}:where(#document-editor.page-builder) .head-meta code{overflow:hidden;text-overflow:ellipsis;max-width:225px}:where(#document-editor.page-builder) .pane-head b{font-size:11px}} +/* Stage 2.3 — source mapping, data explorer and reverse dependencies. */ +:where(#document-editor.page-builder) .mapping-metrics{display:flex;gap:5px;flex-wrap:wrap;margin:11px 0} +:where(#document-editor.page-builder) .mapping-metrics span{display:inline-flex;padding:4px 7px;border:1px solid var(--border);background:var(--surface2);font:10px ui-monospace,Consolas,monospace;color:var(--muted);border-radius:var(--pill)} +:where(#document-editor.page-builder) .mapping-metrics .has-issues{color:var(--warning);background:var(--warningBg);border-color:color-mix(in srgb,var(--warning) 30%,var(--border))} +:where(#document-editor.page-builder) .mapping-card{padding:11px 10px 13px;margin:0 5px 7px;border:1px solid var(--border);background:var(--surface);border-radius:var(--radius)} +:where(#document-editor.page-builder) .mapping-card.map-selected{border-color:var(--accent);background:color-mix(in srgb,var(--accentSoft) 34%,var(--surface))} +:where(#document-editor.page-builder) .mapping-card .map-block-title{display:flex;align-items:flex-start;gap:7px;text-align:left;color:var(--text);padding-bottom:8px;min-width:0} +:where(#document-editor.page-builder) .mapping-card .map-block-title > svg{width:14px;height:14px;color:var(--accent);flex:none;margin-top:2px} +:where(#document-editor.page-builder) .mapping-card .map-block-title span{min-width:0} +:where(#document-editor.page-builder) .mapping-card .map-block-title b{display:block;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .mapping-card .map-block-title small{font:9px/1.5 ui-monospace,Consolas,monospace;color:var(--muted);overflow-wrap:anywhere} +:where(#document-editor.page-builder) .map-edge{display:grid;grid-template-columns:minmax(0,65px) auto minmax(0,1fr) 19px;align-items:center;gap:5px;font-size:10px;padding:7px 0;border-top:1px solid var(--border2)} +:where(#document-editor.page-builder) .map-edge .mono{color:var(--muted);overflow:hidden;text-overflow:ellipsis} +:where(#document-editor.page-builder) .map-edge .edge-type{font-size:9px;font-weight:700;color:var(--accent);padding:1px 5px;border-radius:var(--pill);background:var(--accentSoft)} +:where(#document-editor.page-builder) .map-edge .edge-type.error{color:var(--danger);background:var(--dangerBg)} +:where(#document-editor.page-builder) .map-edge .edge-value{color:var(--text);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-family:ui-monospace,Consolas,monospace;font-size:9px} +:where(#document-editor.page-builder) .map-edge button{border:0;background:none;color:var(--accent);padding:0;width:19px;height:20px} +:where(#document-editor.page-builder) .map-issue{color:var(--danger);font-size:9px;line-height:1.45;display:flex;align-items:start;gap:5px;padding-top:5px;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .map-issue svg{width:11px;height:11px;flex:none} +:where(#document-editor.page-builder) .tree-error-dot{display:grid;place-items:center;font-size:9px;font-weight:900;height:16px;width:16px;background:var(--dangerBg);color:var(--danger);border-radius:50%} +:where(#document-editor.page-builder) .picker-current{display:flex;align-items:center;gap:5px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);padding:5px 5px 5px 9px;min-width:0} +:where(#document-editor.page-builder) .picker-current .mono{font-size:10px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0;flex:1} +:where(#document-editor.page-builder) .mini-action{border:1px solid var(--border);background:var(--surface2);border-radius:var(--pill);color:var(--muted);display:inline-flex;align-items:center;justify-content:center;gap:5px;padding:6px 8px;font-size:10px;font-weight:600;min-height:27px;white-space:nowrap} +:where(#document-editor.page-builder) .mini-action svg{height:12px;width:12px} +:where(#document-editor.page-builder) .mini-action:hover{color:var(--accent);border-color:var(--accent);background:var(--accentSoft)} +:where(#document-editor.page-builder) .mini-action.primary-action{background:var(--accentSoft);color:var(--accent);border-color:color-mix(in srgb,var(--accent) 32%,var(--border))} +:where(#document-editor.page-builder) .tiny-source{display:inline-flex;align-items:center;gap:4px;background:var(--surface2);color:var(--muted);border:1px solid var(--border);border-radius:var(--pill);font-size:9px;max-width:158px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;padding:3px 5px} +:where(#document-editor.page-builder) .tiny-source.bound{color:var(--accent);border-color:color-mix(in srgb,var(--accent) 33%,var(--border));background:var(--accentSoft)} +:where(#document-editor.page-builder) .tiny-source svg{width:10px;height:10px} +:where(#document-editor.page-builder) .field-issue{padding:7px 8px;display:flex;gap:5px;align-items:flex-start;font:10px/1.5 ui-monospace,Consolas,monospace;color:var(--warning);background:var(--warningBg);margin-top:7px;border-left:2px solid currentColor;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .field-issue svg{width:13px;height:13px;flex:none} +:where(#document-editor.page-builder) .field-issue.error{color:var(--danger);background:var(--dangerBg)} +:where(#document-editor.page-builder) .binding-entry{border:1px solid var(--border);background:var(--surface2);border-radius:var(--radius);padding:11px;margin:0 0 10px} +:where(#document-editor.page-builder) .binding-top,:where(#document-editor.page-builder) .binding-actions{display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap} +:where(#document-editor.page-builder) .binding-top b{font-size:11px} +:where(#document-editor.page-builder) .source-type{font:9px ui-monospace,Consolas,monospace;padding:3px 6px;color:var(--accent);background:var(--accentSoft);border:1px solid var(--border);border-radius:var(--pill)} +:where(#document-editor.page-builder) .source-type.error{color:var(--danger);background:var(--dangerBg)} +:where(#document-editor.page-builder) .source-type.warn{color:var(--warning);background:var(--warningBg)} +:where(#document-editor.page-builder) .binding-key{margin:8px 0;color:var(--muted);font:9px/1.5 ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .binding-result{color:var(--text);display:flex;align-items:flex-start;gap:7px;font-size:11px;line-height:1.45;overflow-wrap:anywhere;margin:8px 0} +:where(#document-editor.page-builder) .binding-result svg{color:var(--accent);width:13px;height:13px;flex:none;margin-top:2px} +:where(#document-editor.page-builder) .binding-actions{justify-content:flex-start;gap:5px;margin-top:10px} +:where(#document-editor.page-builder) .path-strip{display:flex;align-items:center;gap:3px;flex-wrap:wrap;font:9px ui-monospace,Consolas,monospace;color:var(--muted);padding:9px 7px;background:var(--surface2);border:1px solid var(--border);margin:0 0 16px;border-radius:var(--radius)} +:where(#document-editor.page-builder) .path-strip span{overflow-wrap:anywhere} +:where(#document-editor.page-builder) .picker-summary{padding:11px;display:flex;gap:7px;flex-wrap:wrap;align-items:center;border:1px solid var(--border);background:var(--surface2);border-radius:var(--radius);font:10px/1.5 ui-monospace,Consolas,monospace;margin-bottom:12px;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .picker-summary svg{width:15px;height:15px;color:var(--accent)} +:where(#document-editor.page-builder) .choice-group{margin:14px 0 18px} +:where(#document-editor.page-builder) .choice-label{font-size:10px;font-weight:750;color:var(--muted);display:flex;justify-content:space-between;text-transform:uppercase;letter-spacing:.06em;margin:10px 0 7px} +:where(#document-editor.page-builder) .choice-item{width:100%;display:flex;align-items:center;gap:9px;text-align:left;color:var(--text);background:var(--surface2);border:1px solid var(--border);border-bottom:0;padding:10px;min-width:0} +:where(#document-editor.page-builder) .choice-item:last-child{border-bottom:1px solid var(--border)} +:where(#document-editor.page-builder) .choice-item:first-of-type{border-radius:var(--radius) var(--radius) 0 0} +:where(#document-editor.page-builder) .choice-item:last-child{border-radius:0 0 var(--radius) var(--radius)} +:where(#document-editor.page-builder) .choice-item:hover{background:var(--accentSoft);border-color:var(--accent)} +:where(#document-editor.page-builder) .choice-item .choice-glyph{color:var(--accent);display:grid;place-items:center;flex:none;width:19px} +:where(#document-editor.page-builder) .choice-item .choice-glyph svg{width:15px;height:15px} +:where(#document-editor.page-builder) .choice-info{min-width:0;flex:1} +:where(#document-editor.page-builder) .choice-info b{display:block;font-size:11px} +:where(#document-editor.page-builder) .choice-info small{font-size:9px;color:var(--muted);display:block;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .choice-flag{border-radius:var(--pill);font-size:9px;color:var(--muted);border:1px solid var(--border);padding:3px 5px;flex:none} +:where(#document-editor.page-builder) .choice-flag.bad{color:var(--danger);background:var(--dangerBg)} +:where(#document-editor.page-builder) .choice-flag.warning{color:var(--warning);background:var(--warningBg)} +:where(#document-editor.page-builder) .usage-summary{display:flex;gap:9px;align-items:center;margin-bottom:13px;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .usage-summary code{font-size:10px;color:var(--muted);overflow-wrap:anywhere} +:where(#document-editor.page-builder) .usage-item{display:flex;align-items:center;gap:12px;justify-content:space-between;width:100%;background:var(--surface2);color:var(--text);border:1px solid var(--border);border-bottom:0;text-align:left;padding:10px;border-radius:0} +:where(#document-editor.page-builder) .usage-item:last-of-type{border-bottom:1px solid var(--border)} +:where(#document-editor.page-builder) .usage-item:hover{background:var(--accentSoft);color:var(--accent)} +:where(#document-editor.page-builder) .usage-item span{min-width:0} +:where(#document-editor.page-builder) .usage-item b{display:block;font-size:11px} +:where(#document-editor.page-builder) .usage-item small{font:9px ui-monospace,Consolas,monospace;display:block;color:var(--muted);overflow-wrap:anywhere;margin-top:5px} +:where(#document-editor.page-builder) .library-grid{display:grid;gap:0} +:where(#document-editor.page-builder) .library-head{font-size:10px;font-weight:800;text-transform:uppercase;letter-spacing:.08em;color:var(--accent);margin:15px 0 4px} +:where(#document-editor.page-builder) .library-row{display:flex;align-items:center;justify-content:space-between;gap:9px;padding:9px 0;border-bottom:1px solid var(--border2)} +:where(#document-editor.page-builder) .library-row b{font-size:10px;display:block} +:where(#document-editor.page-builder) .library-row small{font-size:9px;display:block;color:var(--muted);overflow-wrap:anywhere} +:where(#document-editor.page-builder) .library-row span{min-width:0} +:where(#document-editor.page-builder) .library-row .mini-action{flex:none} +@media(max-width:700px){:where(#document-editor.page-builder) .mapping-card{margin:0 10px 9px}:where(#document-editor.page-builder) .choice-item{padding:9px}:where(#document-editor.page-builder) .binding-entry{padding:12px}} +:where(#document-editor.page-builder) .usage-entry{border:1px solid var(--border);border-bottom:0;background:var(--surface2);padding:9px 10px} +:where(#document-editor.page-builder) .usage-entry:last-of-type{border-bottom:1px solid var(--border)} +:where(#document-editor.page-builder) .usage-entry b{display:block;font-size:11px} +:where(#document-editor.page-builder) .usage-entry small{display:block;margin-top:4px;color:var(--muted);font:9px ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +/* Stage 2.4 — live/workspace clarity, per-field QA, version comparisons. */ +:where(#document-editor.page-builder) .draft-hint{font:10px ui-monospace,Consolas,monospace;color:var(--muted)} +:where(#document-editor.page-builder) .head-meta{display:flex;align-items:center;gap:8px;flex-wrap:wrap} +:where(#document-editor.page-builder) .tag-muted{font:9px ui-monospace,Consolas,monospace;color:var(--dim);text-transform:none;letter-spacing:0;margin-left:auto} +:where(#document-editor.page-builder) .inspector-callout{font-size:10px;line-height:1.6;padding:10px 11px;background:var(--accentSoft);border-left:2px solid var(--accent);margin-bottom:13px;color:var(--text)} +:where(#document-editor.page-builder) .serp-preview{margin:10px 0 18px;padding:13px;background:var(--surface2);border:1px solid var(--border);border-radius:var(--radius);font-size:11px;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .serp-url{color:var(--positive);font-size:10px;margin-bottom:4px} +:where(#document-editor.page-builder) .serp-title{color:var(--accent);font-size:15px;font-weight:650;line-height:1.35;margin-bottom:5px} +:where(#document-editor.page-builder) .serp-desc{color:var(--muted);font-size:11px} +:where(#document-editor.page-builder) .markdown-preview{border:1px solid var(--border);background:var(--surface2);margin-top:10px;border-radius:var(--radius)} +:where(#document-editor.page-builder) .markdown-preview summary{padding:10px 11px;cursor:pointer;color:var(--text);font-weight:650;font-size:10px} +:where(#document-editor.page-builder) .markdown-render{padding:10px 12px;border-top:1px solid var(--border);font-size:11px;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .markdown-render h1{font-size:17px;margin-bottom:7px}:where(#document-editor.page-builder) .markdown-render h2{font-size:15px;margin-bottom:7px}:where(#document-editor.page-builder) .markdown-render h3{font-size:13px;margin-bottom:6px}:where(#document-editor.page-builder) .markdown-render p{margin:7px 0}:where(#document-editor.page-builder) .markdown-render ul{padding-left:20px}:where(#document-editor.page-builder) .markdown-render a{color:var(--accent);text-decoration:underline} +:where(#document-editor.page-builder) .review-dialog,:where(#document-editor.page-builder) .compare-dialog{width:min(1020px,calc(100vw - 32px));max-width:100%;} +:where(#document-editor.page-builder) .review-summary{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px;margin-bottom:13px} +:where(#document-editor.page-builder) .review-count{border:1px solid var(--border);background:var(--surface2);padding:12px;display:flex;flex-direction:column;gap:3px;border-radius:var(--radius)} +:where(#document-editor.page-builder) .review-count b{font-size:24px;line-height:1.2;letter-spacing:-.04em}:where(#document-editor.page-builder) .review-count span{font-size:10px;color:var(--muted)} +:where(#document-editor.page-builder) .review-count:first-child b{color:var(--danger)}:where(#document-editor.page-builder) .review-count:nth-child(2) b{color:var(--warning)}:where(#document-editor.page-builder) .review-count:nth-child(3) b{color:var(--accent)} +:where(#document-editor.page-builder) .review-banner{padding:10px 12px;border-left:3px solid var(--positive);background:var(--positiveBg);font-size:11px;margin:8px 0 13px} +:where(#document-editor.page-builder) .review-banner.danger{background:var(--dangerBg);border-color:var(--danger)} +:where(#document-editor.page-builder) .review-filters{display:flex;gap:4px;flex-wrap:wrap;padding:4px;background:var(--surface2);border-radius:var(--radius);margin:12px 0} +:where(#document-editor.page-builder) .review-filters button{border:1px solid transparent;background:transparent;color:var(--muted);padding:8px 10px;font-size:10px;border-radius:var(--pill);font-weight:650} +:where(#document-editor.page-builder) .review-filters button.active{background:var(--surface);border-color:var(--border);color:var(--text)} +:where(#document-editor.page-builder) .review-list{max-height:300px;overflow:auto;border:1px solid var(--border);border-radius:var(--radius)} +:where(#document-editor.page-builder) .review-item{display:flex;align-items:center;width:100%;text-align:left;gap:10px;background:var(--surface);color:var(--text);padding:12px;border:0;border-bottom:1px solid var(--border2)} +:where(#document-editor.page-builder) .review-item:last-child{border-bottom:0}:where(#document-editor.page-builder) .review-item:hover{background:var(--accentSoft)} +:where(#document-editor.page-builder) .issue-label{font-size:9px;font-weight:800;padding:4px 6px;color:var(--warning);background:var(--warningBg);flex:none} +:where(#document-editor.page-builder) .review-item.error .issue-label{color:var(--danger);background:var(--dangerBg)} +:where(#document-editor.page-builder) .review-item span:nth-child(2){flex:1;min-width:0} +:where(#document-editor.page-builder) .review-item b{font-size:11px;display:block;font-weight:600} +:where(#document-editor.page-builder) .review-item small{display:block;color:var(--muted);margin-top:5px;font:9px/1.4 ui-monospace,Consolas,monospace;overflow-wrap:anywhere} +:where(#document-editor.page-builder) .review-item svg{color:var(--accent)} +:where(#document-editor.page-builder) .compare-meta{display:flex;gap:8px;flex-wrap:wrap;align-items:center;font-size:10px;color:var(--muted)} +:where(#document-editor.page-builder) .compare-meta span{background:var(--surface2);border:1px solid var(--border);padding:6px 8px} +:where(#document-editor.page-builder) .compare-meta b{color:var(--text)} +:where(#document-editor.page-builder) .compare-table{border:1px solid var(--border);border-radius:var(--radius);max-height:350px;overflow:auto} +:where(#document-editor.page-builder) .compare-label-head,:where(#document-editor.page-builder) .compare-line{display:grid;grid-template-columns:minmax(100px,.7fr) minmax(0,1fr) minmax(0,1fr);gap:8px;padding:10px;border-bottom:1px solid var(--border2);font-size:10px} +:where(#document-editor.page-builder) .compare-label-head{background:var(--surface2);color:var(--muted);position:sticky;top:0;z-index:1} +:where(#document-editor.page-builder) .compare-line:last-child{border-bottom:0}:where(#document-editor.page-builder) .compare-line code{font:10px ui-monospace,Consolas,monospace;color:var(--accent);overflow-wrap:anywhere}:where(#document-editor.page-builder) .compare-line span{line-height:1.5;overflow-wrap:anywhere;white-space:pre-wrap}:where(#document-editor.page-builder) .compare-line span:nth-child(2){color:var(--danger)}:where(#document-editor.page-builder) .compare-line span:nth-child(3){color:var(--positive)} +:where(#document-editor.page-builder) .visual-compare{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px;margin:10px 0} +:where(#document-editor.page-builder) .visual-compare>div{min-width:0}:where(#document-editor.page-builder) .visual-compare h3{font-size:11px;margin-bottom:8px;color:var(--muted)} +:where(#document-editor.page-builder) .compare-mini{background:#f5f5f4;color:#20252d;border:1px solid #d8d9dc;font-family:ui-sans-serif,Arial,sans-serif;min-height:230px;overflow:hidden} +:where(#document-editor.page-builder) .mini-header{display:flex;justify-content:space-between;background:white;border-bottom:1px solid #e2e3e5;padding:12px;font-weight:800;font-size:13px}:where(#document-editor.page-builder) .mini-header span{color:#c069a9}:where(#document-editor.page-builder) .mini-header small{font-size:9px;color:#848896} +:where(#document-editor.page-builder) .mini-hero{background:#edf0f7;padding:22px 18px;min-height:100px}:where(#document-editor.page-builder) .mini-hero small{font-size:9px;color:#827aa0}:where(#document-editor.page-builder) .mini-hero strong{display:block;font-size:17px;line-height:1.2;max-width:300px;margin:8px 0;letter-spacing:-.04em}:where(#document-editor.page-builder) .mini-hero p{font-size:10px;line-height:1.5;color:#636b7c;max-width:310px} +:where(#document-editor.page-builder) .mini-section{padding:14px 18px;border-bottom:1px solid #e2e3e5}:where(#document-editor.page-builder) .mini-section small{color:#898d99;display:block;font-size:9px}:where(#document-editor.page-builder) .mini-section b{display:block;font-size:13px;margin-top:5px;overflow-wrap:anywhere} +@media(max-width:700px){:where(#document-editor.page-builder) .review-summary{grid-template-columns:repeat(2,minmax(0,1fr))}:where(#document-editor.page-builder) .visual-compare{grid-template-columns:1fr}:where(#document-editor.page-builder) .compare-label-head,:where(#document-editor.page-builder) .compare-line{grid-template-columns:minmax(0,.7fr) minmax(0,1fr) minmax(0,1fr);gap:5px;padding:8px 6px;font-size:9px}:where(#document-editor.page-builder) .review-item{padding:9px 7px;gap:6px}:where(#document-editor.page-builder) .issue-label{font-size:8px}:where(#document-editor.page-builder) .compare-mini{min-height:180px}:where(#document-editor.page-builder) .draft-hint{width:100%}} + +/* ━━━━━━━━━━━━━━━ Site Engine / Stage 3 · Expert ━━━━━━━━━━━━━━━ */ +:where(#document-editor.page-builder) .builder.expert-layout{grid-template-columns:218px minmax(0,1fr) 315px;min-height:calc(100dvh - 165px);max-height:calc(100dvh - 165px)} +:where(#document-editor.page-builder) .expert-layout .treepane{background:var(--surface2)} +:where(#document-editor.page-builder) .expert-layout .stagepane{min-height:0;background:var(--surface)} +:where(#document-editor.page-builder) .expert-layout .inspectpane{background:var(--surface)} +:where(#document-editor.page-builder) .expert-files{padding:9px 7px;overflow-y:auto} +:where(#document-editor.page-builder) .expert-folder{display:flex;align-items:center;gap:7px;padding:16px 10px 9px;font:700 10px ui-monospace,Consolas,monospace;color:var(--muted)} +:where(#document-editor.page-builder) .expert-folder svg{width:13px;height:13px;color:var(--accent)} +:where(#document-editor.page-builder) .expert-folder small{margin-left:auto;font-size:9px;opacity:.75} +:where(#document-editor.page-builder) .expert-file{display:flex;width:100%;border:1px solid transparent;align-items:center;gap:9px;min-height:40px;padding:7px 9px;text-align:left;color:var(--text);background:transparent;border-radius:var(--radius)} +:where(#document-editor.page-builder) .expert-file svg{color:var(--muted);width:14px;height:14px} +:where(#document-editor.page-builder) .expert-file span{min-width:0;display:block}:where(#document-editor.page-builder) .expert-file span b{font-size:10px;font-weight:700;display:block}:where(#document-editor.page-builder) .expert-file span small{font-size:9px;color:var(--muted);display:block;white-space:nowrap;overflow:hidden;text-overflow:ellipsis} +:where(#document-editor.page-builder) .expert-file:hover{background:var(--surface3)}:where(#document-editor.page-builder) .expert-file.selected{background:var(--accentSoft);color:var(--accent);border-color:color-mix(in srgb,var(--accent) 40%,var(--border))}:where(#document-editor.page-builder) .expert-file.selected svg{color:var(--accent)} +:where(#document-editor.page-builder) .expert-file.disabled-file{cursor:default;color:var(--dim);font-size:10px;opacity:.8}:where(#document-editor.page-builder) .expert-file.disabled-file:hover{background:transparent}:where(#document-editor.page-builder) .expert-tree-note{font-size:10px;line-height:1.65;color:var(--muted);padding:11px;margin:21px 5px;border:1px solid var(--border);background:var(--surface)} +:where(#document-editor.page-builder) .expert-tree-note b{color:var(--text)} +:where(#document-editor.page-builder) .expert-editor-header{height:40px;display:flex;align-items:center;justify-content:space-between;gap:10px;border-bottom:1px solid var(--border);padding:0 12px;background:var(--surface2);font-size:10px;color:var(--muted);flex:none} +:where(#document-editor.page-builder) .expert-editor-header .filetab{align-items:center;display:flex;gap:8px;max-width:100%;min-width:0;padding:0 10px;height:100%;border-bottom:2px solid var(--accent);background:var(--surface)} +:where(#document-editor.page-builder) .expert-editor-header .filetab svg{color:var(--accent);height:14px;width:14px}:where(#document-editor.page-builder) .expert-editor-header .filetab b{color:var(--text);font:650 10px ui-monospace,Consolas,monospace;overflow:hidden;text-overflow:ellipsis;white-space:nowrap} +:where(#document-editor.page-builder) .file-edited{color:var(--warning);font-size:13px}:where(#document-editor.page-builder) .expert-editor-header .muted{white-space:nowrap;font-size:9px;color:var(--muted)} +:where(#document-editor.page-builder) .expert-tools{display:flex;align-items:center;flex-wrap:wrap;gap:7px;padding:9px 11px;border-bottom:1px solid var(--border);background:var(--surface);flex:none;min-height:45px} +:where(#document-editor.page-builder) .expert-tools>.mono{font-size:9px;color:var(--dim);margin-right:auto}:where(#document-editor.page-builder) .expert-find{display:flex;gap:3px}:where(#document-editor.page-builder) .expert-find input{width:118px;min-width:0;height:28px;padding:0 7px;border:1px solid var(--border);color:var(--text);background:var(--surface2);border-radius:var(--radius);font-size:10px} +:where(#document-editor.page-builder) .expert-codebox{min-height:300px;flex:1;display:flex;overflow:hidden;position:relative;background:var(--surface)} +:where(#document-editor.page-builder) .expert-codebox:focus-within{box-shadow:inset 0 0 0 1px color-mix(in srgb,var(--accent) 32%,transparent)} +:where(#document-editor.page-builder) .expert-gutter{flex:none;margin:0;width:44px;overflow:hidden;padding:13px 9px 40px 7px;border-right:1px solid var(--border);background:var(--surface2);color:var(--dim);font:11.5px/19px ui-monospace,SFMono-Regular,Consolas,monospace;text-align:right;white-space:pre;user-select:none;tab-size:2} +:where(#document-editor.page-builder) .expert-codewrap{min-width:0;min-height:0;flex:1;position:relative;overflow:hidden} +:where(#document-editor.page-builder) .expert-highlighter,:where(#document-editor.page-builder) .expert-textarea{position:absolute;inset:0;margin:0;border:0;border-radius:0;padding:13px 14px 40px;width:100%;height:100%;overflow:auto;white-space:pre;word-wrap:normal;overflow-wrap:normal;tab-size:2;letter-spacing:0;font:11.5px/19px ui-monospace,SFMono-Regular,Consolas,Monaco,monospace} +:where(#document-editor.page-builder) .expert-highlighter{z-index:0;pointer-events:none;scrollbar-width:none;color:var(--text);background:transparent;white-space:pre} +:where(#document-editor.page-builder) .expert-highlighter::-webkit-scrollbar{display:none} +:where(#document-editor.page-builder) .expert-textarea{z-index:1;resize:none;background:transparent;color:transparent;caret-color:var(--text);-webkit-text-fill-color:transparent;outline:none;scrollbar-color:var(--border) transparent} +:where(#document-editor.page-builder) .expert-textarea::selection{background:color-mix(in srgb,var(--accent) 30%,transparent);-webkit-text-fill-color:transparent} +:where(#document-editor.page-builder) .expert-textarea:focus-visible{outline:none} +:where(#document-editor.page-builder) .tok-key{color:var(--accent);font-weight:650}:where(#document-editor.page-builder) .tok-punct{color:var(--muted)}:where(#document-editor.page-builder) .tok-value{color:var(--text)}:where(#document-editor.page-builder) .tok-atom{color:var(--positive)}:where(#document-editor.page-builder) .tok-rule{color:var(--warning)}:where(#document-editor.page-builder) .tok-comment{color:var(--dim);font-style:italic}:where(#document-editor.page-builder) .tok-md{color:var(--text)} +:where(#document-editor.page-builder) .expert-statusbar{height:29px;display:flex;align-items:center;justify-content:space-between;gap:12px;padding:0 13px;color:var(--muted);background:var(--surface2);border-top:1px solid var(--border);flex:none;font:9px ui-monospace,Consolas,monospace;white-space:nowrap} +:where(#document-editor.page-builder) .expert-statusbar #expert-source-state{overflow:hidden;text-overflow:ellipsis}:where(#document-editor.page-builder) .expert-status-invalid{color:var(--danger)}:where(#document-editor.page-builder) .expert-status-unapplied{color:var(--warning)}:where(#document-editor.page-builder) .expert-status-good{color:var(--positive)} +:where(#document-editor.page-builder) .expert-side-scroll{overflow-y:auto;overflow-x:hidden;min-height:0;flex:1;padding:11px;display:flex;flex-direction:column;gap:11px} +:where(#document-editor.page-builder) .expert-side-top{display:flex;align-items:center;justify-content:space-between;flex-wrap:wrap;gap:6px} +:where(#document-editor.page-builder) .expert-mini-preview{height:205px;border:1px solid var(--border);background:var(--previewOuter);border-radius:var(--radius);overflow:hidden;flex:none} +:where(#document-editor.page-builder) .expert-mini-preview iframe{display:block;height:100%;width:100%;border:0;background:#fff} +:where(#document-editor.page-builder) .expert-summary{display:flex;align-items:center;justify-content:space-between;gap:8px;border-bottom:1px solid var(--border);padding:6px 0 10px;font-size:11px} +:where(#document-editor.page-builder) .expert-summary #expert-validation-pip{font-size:9px;color:var(--positive)}:where(#document-editor.page-builder) .expert-summary #expert-validation-pip.alert{color:var(--danger)} +:where(#document-editor.page-builder) .expert-issue{min-height:40px}:where(#document-editor.page-builder) .expert-ok{padding:10px;border-left:2px solid var(--positive);background:var(--positiveBg);font-size:10px;color:var(--positive);line-height:1.5} +:where(#document-editor.page-builder) .expert-error{padding:10px;border-left:2px solid var(--danger);background:var(--dangerBg);color:var(--danger);font-size:10px;display:flex;flex-direction:column;align-items:start;gap:5px;line-height:1.4} +:where(#document-editor.page-builder) .expert-error code{overflow-wrap:anywhere}:where(#document-editor.page-builder) .expert-error .mini-action{margin-top:5px} +:where(#document-editor.page-builder) .expert-info{display:grid;gap:0;background:var(--surface2);padding:3px 10px;border:1px solid var(--border)}:where(#document-editor.page-builder) .expert-info>div{display:flex;justify-content:space-between;gap:8px;flex-wrap:wrap;padding:8px 0;border-bottom:1px solid var(--border2);color:var(--muted);font-size:10px}:where(#document-editor.page-builder) .expert-info>div:last-child{border:0}:where(#document-editor.page-builder) .expert-info code{color:var(--text);overflow-wrap:anywhere} +:where(#document-editor.page-builder) .expert-side-actions{display:flex;flex-wrap:wrap;gap:6px}:where(#document-editor.page-builder) .expert-note{border:1px solid var(--border);background:var(--surface2);padding:11px}:where(#document-editor.page-builder) .expert-note b{font-size:10px}:where(#document-editor.page-builder) .expert-note p{margin-top:6px;font-size:10px;line-height:1.65;color:var(--muted)} +:where(#document-editor.page-builder) .expert-publish-issues{font-size:10px;color:var(--muted)}:where(#document-editor.page-builder) .expert-publish-issues>b{color:var(--text)}:where(#document-editor.page-builder) .expert-publish-issues p{margin-top:10px}:where(#document-editor.page-builder) .expert-publish-line{display:flex;gap:7px;padding:7px 0;border-bottom:1px solid var(--border2);line-height:1.4}:where(#document-editor.page-builder) .expert-publish-line svg{width:12px;height:12px;flex:none;color:var(--warning)}:where(#document-editor.page-builder) .expert-publish-line.error svg{color:var(--danger)} +:where(#document-editor.page-builder) .expert-diff-dialog{width:min(940px,100%)}:where(#document-editor.page-builder) .expert-diff{overflow:auto;max-height:min(60dvh,650px);border:1px solid var(--border);background:var(--surface2);margin-top:10px} +:where(#document-editor.page-builder) .diff-line{display:grid;grid-template-columns:35px 35px minmax(0,1fr);min-width:510px;font:10px/1.55 ui-monospace,Consolas,monospace}:where(#document-editor.page-builder) .diff-line>span{color:var(--dim);border-right:1px solid var(--border);padding:1px 7px;text-align:right;user-select:none}:where(#document-editor.page-builder) .diff-line code{white-space:pre;min-width:0;overflow:visible;padding:1px 8px;color:var(--text)}:where(#document-editor.page-builder) .diff-line.add{background:var(--positiveBg)}:where(#document-editor.page-builder) .diff-line.remove{background:var(--dangerBg)}:where(#document-editor.page-builder) .diff-line.add code{color:var(--positive)}:where(#document-editor.page-builder) .diff-line.remove code{color:var(--danger)} +:where(#document-editor.page-builder) .expert-conflict-dialog{width:min(760px,100%)}:where(#document-editor.page-builder) .expert-conflict-meta{display:flex;gap:12px;flex-wrap:wrap;justify-content:space-between;border:1px solid var(--border);background:var(--surface2);padding:10px;margin-bottom:13px;font-size:11px}:where(#document-editor.page-builder) .expert-conflict-grid{display:grid;grid-template-columns:1fr 1fr;gap:12px;margin-bottom:14px}:where(#document-editor.page-builder) .expert-conflict-grid section{padding:13px;border:1px solid var(--border);background:var(--surface2);min-width:0;display:flex;flex-direction:column;gap:8px}:where(#document-editor.page-builder) .expert-conflict-grid section:first-child{border-top:3px solid var(--accent)}:where(#document-editor.page-builder) .expert-conflict-grid section:last-child{border-top:3px solid var(--warning)}:where(#document-editor.page-builder) .expert-conflict-grid h3{font-size:12px}:where(#document-editor.page-builder) .expert-conflict-grid p{font-size:10px}:where(#document-editor.page-builder) .expert-conflict-grid code,:where(#document-editor.page-builder) .expert-conflict-grid small{font-size:10px;color:var(--muted);overflow-wrap:anywhere} +@media(max-width:1380px){:where(#document-editor.page-builder) .builder.expert-layout{grid-template-columns:195px minmax(0,1fr) 282px}:where(#document-editor.page-builder) .expert-tools>.mono{display:none}} +@media(max-width:1050px){:where(#document-editor.page-builder) .builder.expert-layout{grid-template-columns:190px minmax(0,1fr);grid-template-areas:"tree stage" "inspect inspect";max-height:none;min-height:calc(100dvh - 165px)}:where(#document-editor.page-builder) .expert-layout .treepane{grid-area:tree;min-height:620px;max-height:830px}:where(#document-editor.page-builder) .expert-layout .stagepane{grid-area:stage;min-height:620px;max-height:830px}:where(#document-editor.page-builder) .expert-layout .inspectpane{grid-area:inspect;min-height:0;max-height:none}:where(#document-editor.page-builder) .expert-layout .expert-side-scroll{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));align-items:start}:where(#document-editor.page-builder) .expert-layout .expert-mini-preview{height:250px}} +@media(max-width:700px){:where(#document-editor.page-builder) .builder.expert-layout{display:flex;flex-direction:column;max-height:none;min-height:0}:where(#document-editor.page-builder) .expert-layout .stagepane{order:0;min-height:680px;max-height:none}:where(#document-editor.page-builder) .expert-layout .treepane{order:1;min-height:190px;max-height:none}:where(#document-editor.page-builder) .expert-layout .inspectpane{order:2}:where(#document-editor.page-builder) .expert-codebox{height:480px;flex:none;min-height:480px}:where(#document-editor.page-builder) .expert-tools{flex-wrap:wrap}:where(#document-editor.page-builder) .expert-layout .expert-side-scroll{display:flex}:where(#document-editor.page-builder) .expert-editor-header .muted{display:none}:where(#document-editor.page-builder) .expert-conflict-grid{grid-template-columns:1fr}:where(#document-editor.page-builder) .expert-diff{max-height:55dvh}} +@media(max-width:390px){:where(#document-editor.page-builder) .expert-find input{width:88px}:where(#document-editor.page-builder) .expert-tools{gap:5px;padding:7px}:where(#document-editor.page-builder) .expert-gutter{width:34px;padding-left:4px;padding-right:6px}:where(#document-editor.page-builder) .expert-textarea,:where(#document-editor.page-builder) .expert-highlighter{font-size:10.5px;line-height:19px;padding-left:9px;padding-right:8px}:where(#document-editor.page-builder) .expert-statusbar>span:last-child{display:none}} diff --git a/src/site_engine/web/admin/static/builder.js b/src/site_engine/web/admin/static/builder.js new file mode 100644 index 0000000..cb31fe9 --- /dev/null +++ b/src/site_engine/web/admin/static/builder.js @@ -0,0 +1,264 @@ +/* Designer builder interactions, backed by the document API through the HTML adapter. */ +(() => { + 'use strict'; + if(window.siteBuilderLoaded) return; + window.siteBuilderLoaded=true; + const one=(s,r=document)=>r.querySelector(s); + let root, treeTab='tree', inspectorTab=null, bindingField=null, valueField=null, opener=null, catalogCategory='', drag=null, catalogSubmission=null; + let highlightedSource=null,highlightedPane=null; + function open(dialog, trigger) { + if(!dialog) return; + opener=trigger||document.activeElement; + if(dialog.open) dialog.close(); + dialog.showModal(); + } + function move(node,parent,before=null){ + if(node.parentNode===parent)return; + if(parent.moveBefore&&node.isConnected)parent.moveBefore(node,before); + else {window.siteDocument?.previewReloading();parent.insertBefore(node,before);} + } + function layout(){ + if(!root?.isConnected)return; + const expert=root.dataset.mode==='expert',builder=one('#builder',root),preview=one('#stagepane',root),codePane=one('#expert-pane',root),inspect=one('#inspectpane .inspect-scroll,#inspectpane .expert-side-scroll',root); + if(!preview||!inspect)return; + // Move the iframe before changing its ancestor classes so descendants are + // restyled in their final location after a state-preserving moveBefore(). + move(preview,expert?inspect:builder,expert?inspect.firstChild:codePane); + builder.classList.toggle('expert-layout',expert); + codePane.classList.toggle('stagepane',expert); + preview.classList.toggle('stagepane',!expert);preview.classList.toggle('expert-preview-pane',expert); + inspect.classList.toggle('inspect-scroll',!expert);inspect.classList.toggle('expert-side-scroll',expert); + } + window.siteBuilderConfirm=(title,message,label)=>new Promise(resolve=>{ + const dialog=one('#builder-confirm-dialog',root); + if(!dialog || dialog.open){resolve(false);return;} + one('[data-confirm-title]',dialog).textContent=title;one('[data-confirm-message]',dialog).textContent=message; + one('[data-builder-confirm]',dialog).textContent=label;dialog.returnValue='cancel'; + dialog.addEventListener('close',()=>resolve(dialog.returnValue==='confirm'),{once:true});open(dialog); + }); + function tabs() { + if(!root?.isConnected) return; + root.querySelectorAll('[data-tree-tab]').forEach(b=>b.classList.toggle('active',b.dataset.treeTab===treeTab)); + root.querySelectorAll('[data-tree-panel]').forEach(p=>p.hidden=p.dataset.treePanel!==treeTab); + const tab=inspectorTab||one('[data-inspector-tab].active',root)?.dataset.inspectorTab||'page'; + root.querySelectorAll('[data-inspector-tab]').forEach(b=>b.classList.toggle('active',b.dataset.inspectorTab===tab)); + root.querySelectorAll('[data-inspector-panel]').forEach(p=>p.hidden=p.dataset.inspectorPanel!==tab); + } + function code() { + const source=one('#document-source',root), highlighter=one('[data-code-highlight]',root), gutter=one('[data-code-gutter]',root); + if(!source||!highlighter) return; + if(highlightedPane===highlighter&&highlightedSource===source.value){cursor();return;} + highlightedPane=highlighter;highlightedSource=source.value; + // Designer syntaxHighlight classification, emitted as text nodes under strict CSP. + let inside=false; + const token=(kind,text)=>{const span=document.createElement('span');span.className=kind;span.textContent=text;return span;}; + highlighter.replaceChildren(...source.value.split('\n').flatMap((line,i)=>{ + let nodes; + if(i===0||line==='---'){inside=!inside;nodes=[token('tok-rule',line)];} + else if(!inside) nodes=[token('tok-md',line)]; + else if(/^\s*#/.test(line)) nodes=[token('tok-comment',line)]; + else { + const found=line.match(/^(\s*(?:-\s+)?)([a-zA-Z_][\w.-]*)(:)(.*)$/); + nodes=found?[document.createTextNode(found[1]),token('tok-key',found[2]),token('tok-punct',':'),token(/^\s*(?:true|false|null|\d+)\s*$/.test(found[4])?'tok-atom':'tok-value',found[4])]:[document.createTextNode(line)]; + } + return [...nodes,document.createTextNode('\n')]; + })); + gutter.textContent=source.value.split('\n').map((_,i)=>i+1).join('\n'); + highlighter.scrollTop=source.scrollTop;highlighter.scrollLeft=source.scrollLeft;gutter.scrollTop=source.scrollTop; + cursor(); + } + function cursor() { + const source=one('#document-source',root), indicator=one('[data-source-cursor]',root); + if(!source||!indicator) return; + const lines=source.value.slice(0,source.selectionStart).split('\n'); + indicator.textContent=`Ln ${lines.length}, Col ${lines.at(-1).length+1}`; + } + function catalog() { + const dialog=one('#builder-catalog-dialog',root), target=one('[data-catalog-target]',dialog)?.selectedOptions[0]; + if(!target) return; + const allow=JSON.parse(target.dataset.allow||'[]'), query=(one('[data-catalog-search]',dialog).value||'').trim().toLocaleLowerCase(); + let count=0; + dialog.querySelectorAll('[data-fragment]').forEach(b=>{ + b.hidden=!(allow.includes('*')||allow.includes(b.dataset.fragment))||(catalogCategory&&b.dataset.category!==catalogCategory)||!(b.dataset.fragment+' '+b.textContent).toLocaleLowerCase().includes(query); + if(!b.hidden)count++; + }); + one('[data-catalog-empty]',dialog).hidden=count>0; + dialog.querySelectorAll('[data-catalog-form]').forEach(f=>{for(const name of ['region','parent','slot'])f.elements[name].value=target.dataset[name]||'';}); + } + function catalogList() { + const dialog=one('#builder-catalog-dialog',root); + dialog.querySelectorAll('[data-catalog-form]').forEach(f=>f.hidden=true); + for(const selector of ['.catalog-list','.catalog-group','[data-catalog-search]'])one(selector,dialog).hidden=false; + catalog(); + } + function diff() { + const state=window.siteDocument.state, container=one('[data-source-diff]',root); + container.replaceChildren(); + const before=state.saved.split('\n'), after=state.source.split('\n'); + // Common prefix/suffix make the actual changed span visible without a dependency. + let first=0, lastBefore=before.length,lastAfter=after.length; + while(firstfirst&&lastAfter>first&&before[lastBefore-1]===after[lastAfter-1]){lastBefore--;lastAfter--;} + const line=(text,a,b,kind)=>{ + const row=document.createElement('div');row.className='diff-line '+kind; + for(const value of [a,b]){const span=document.createElement('span');span.textContent=value;row.append(span);} + const code=document.createElement('code');code.textContent=text;row.append(code);container.append(row); + }; + if(state.saved===state.source){container.textContent='Нет несохранённых изменений.';return;} + for(let i=Math.max(0,first-3);i{ + if(!root?.contains(event.target))return; + const button=event.target.closest('button');if(!button)return; + if(button.dataset.treeTab){treeTab=button.dataset.treeTab;tabs();} + if(button.dataset.inspectorTab){inspectorTab=button.dataset.inspectorTab;tabs();} + if(button.name==='choose'||button.name==='choose_readonly')inspectorTab=button.hasAttribute('data-focus-bind')?'bindings':'props'; + if(button.hasAttribute('data-focus-bind'))inspectorTab='bindings'; + if(button.hasAttribute('data-catalog-open')){ + const dialog=one('#builder-catalog-dialog',root), select=one('[data-catalog-target]',dialog); + if(button.dataset.region){const option=Array.from(select.options).find(o=>o.dataset.region===button.dataset.region);if(option)select.value=option.value;} + catalogList();open(dialog,button); + } + if(button.hasAttribute('data-catalog-category')){ + catalogCategory=button.dataset.catalogCategory; + root.querySelectorAll('[data-catalog-category]').forEach(b=>b.classList.toggle('active',b===button));catalog(); + } + if(button.dataset.fragment){ + const dialog=one('#builder-catalog-dialog',root); + const form=Array.from(dialog.querySelectorAll('[data-catalog-form]')).find(f=>f.dataset.catalogForm===button.dataset.fragment); + inspectorTab='props';form.requestSubmit(); + } + if(button.hasAttribute('data-catalog-back'))catalogList(); + if(button.hasAttribute('data-builder-diff')){diff();open(one('#builder-diff-dialog',root),button);} + if(button.hasAttribute('data-builder-reset'))window.siteDocument.reset(); + if(button.hasAttribute('data-builder-confirm'))button.closest('dialog').close('confirm'); + if(button.hasAttribute('data-format-source'))window.siteDocument.transform({operation:'format'}); + if(button.dataset.valuePicker){ + valueField=button.closest('form').elements.namedItem(button.dataset.valuePicker); + const choices=Array.from(button.closest('[data-source-field]').querySelectorAll('datalist option')).map(o=>o.value); + const dialog=one('#builder-value-dialog',root),list=one('[data-value-options]',dialog); + list.replaceChildren(...choices.map(value=>{ + const item=document.createElement('button');item.type='button';item.className='catalog-item';item.dataset.valueChoice=value; + item.textContent=value;return item; + })); + one('[data-value-search]',dialog).value='';one('[data-value-empty]',dialog).hidden=choices.length>0;open(dialog,button); + } + if(button.hasAttribute('data-value-choice')&&valueField?.isConnected){ + const multiple=valueField.closest('[data-field-type]')?.dataset.fieldType==='refs'; + valueField.value=multiple?Array.from(new Set([...valueField.value.split(',').map(v=>v.trim()).filter(Boolean),button.dataset.valueChoice])).join(', '):button.dataset.valueChoice; + valueField.disabled=false; + const binding=valueField.form.elements.namedItem(valueField.name+'._bind');if(binding)binding.value=''; + const source=valueField.closest('[data-source-field]')?.querySelector('[data-source-picker]');if(source){source.textContent='literal';source.classList.remove('bound');} + window.siteDocument.change(valueField);one('#builder-value-dialog',root).close(); + } + if(button.hasAttribute('data-source-picker')){ + const context=button.closest('form')||one('[data-inspector] input[name=block_id]',root)?.form; + if(!context)return; + bindingField={form:context,name:button.dataset.sourcePicker}; + const value=context.elements.namedItem(bindingField.name+'._bind'); + if(!value){window.siteDocument.notice('Для этого типа используется типизированная форма поля во вкладке «Свойства».');return;} + const dialog=one('#builder-source-dialog',root); + one('[data-binding-kind]',dialog).value=value.value?'bind':'literal';one('[data-binding-path]',dialog).value=value.value; + open(dialog,button); + } + if(button.hasAttribute('data-apply-binding')&&bindingField?.form.isConnected){ + const {form,name}=bindingField, dialog=one('#builder-source-dialog',root), kind=one('[data-binding-kind]',dialog).value; + const path=kind==='bind'?one('[data-binding-path]',dialog).value.trim():''; + if(kind==='bind'&&!path){one('[data-binding-path]',dialog).focus();return;} + form.elements.namedItem(name+'._bind').value=path; + const literal=form.elements.namedItem(name);if(literal)literal.disabled=!!path; + const picker=Array.from(form.querySelectorAll('[data-source-picker]')).find(b=>b.dataset.sourcePicker===name); + if(picker){picker.textContent=path||'literal';picker.classList.toggle('bound',!!path);} + window.siteDocument.change(form.elements.namedItem(name+'._bind'));dialog.close(); + } + if(button.hasAttribute('data-find-source')){ + const source=one('#document-source',root), query=one('#expert-search',root).value;if(!query)return; + let index=source.value.toLocaleLowerCase().indexOf(query.toLocaleLowerCase(),source.selectionEnd); + if(index<0)index=source.value.toLocaleLowerCase().indexOf(query.toLocaleLowerCase()); + if(index<0){window.siteDocument.notice('Текст не найден.');return;} + source.focus();source.setSelectionRange(index,index+query.length);source.scrollTop=Math.max(0,source.value.slice(0,index).split('\n').length*19-80);code(); + } + }); + document.addEventListener('input',event=>{ + if(!root?.contains(event.target))return; + if(event.target.id==='document-source')code(); + if(event.target.matches('[data-catalog-search]'))catalog(); + if(event.target.matches('[data-value-search]')){ + let count=0;const query=event.target.value.trim().toLocaleLowerCase(); + root.querySelectorAll('[data-value-choice]').forEach(b=>{b.hidden=!b.textContent.toLocaleLowerCase().includes(query);if(!b.hidden)count++;}); + one('[data-value-empty]',root).hidden=count>0; + } + }); + document.addEventListener('change',async event=>{ + if(!root?.contains(event.target))return; + if(event.target.matches('[data-catalog-target]')){catalogList();} + if(event.target.id==='page-picker'){ + const picker=event.target,previous=decodeURIComponent(window.siteDocument.state.base.slice(7)); + const target='/admin/pages/'+picker.value.split('/').map(encodeURIComponent).join('/')+'?mode='+window.siteDocument.state.mode; + if(!await window.siteDocument.leave(()=>location.assign(target)))picker.value=previous; + } + }); + window.addEventListener('submit',event=>{ + if(event.target.matches('[data-catalog-form]'))catalogSubmission={fragment:event.target.dataset.catalogForm,fields:Array.from(event.target.elements).filter(e=>e.name).map(e=>({name:e.name,type:e.type,value:e.value,checked:e.checked,disabled:e.disabled}))}; + },true); + document.addEventListener('close',event=>{if(event.target.matches?.('.builder-dialog')){opener?.isConnected&&opener.focus({preventScroll:true});}},true); + document.addEventListener('click',event=>{const dialog=event.target;if(dialog.matches?.('dialog.builder-dialog:modal')){const rect=dialog.getBoundingClientRect();if(event.clientXrect.right||event.clientYrect.bottom)dialog.close();}}); + document.addEventListener('scroll',event=>{if(event.target.id==='document-source'){const p=one('[data-code-highlight]',root),g=one('[data-code-gutter]',root);p.scrollTop=event.target.scrollTop;p.scrollLeft=event.target.scrollLeft;g.scrollTop=event.target.scrollTop;}},true); + document.addEventListener('keyup',event=>{if(event.target.id==='document-source')cursor();}); + document.addEventListener('click',event=>{if(event.target.id==='document-source')cursor();}); + document.addEventListener('keydown',event=>{ + if(!root?.isConnected)return; + if((event.ctrlKey||event.metaKey)&&event.key.toLowerCase()==='s'){event.preventDefault();one('[data-save-document]',root).click();} + if((event.ctrlKey||event.metaKey)&&event.key.toLowerCase()==='f'&&window.siteDocument.state.mode==='expert'){event.preventDefault();one('#expert-search',root).focus();} + if((event.ctrlKey||event.metaKey)&&event.key==='Enter'&&window.siteDocument.state.mode==='expert'){event.preventDefault();one('[data-validate]',root).click();} + }); + document.addEventListener('dragstart',event=>{const item=event.target.closest('[data-tree-id][draggable]');if(!item)return;drag=item.dataset.treeId;event.dataTransfer.setData('text/plain',drag);event.dataTransfer.effectAllowed='move';}); + document.addEventListener('dragover',event=>{const item=event.target.closest('[data-tree-id][draggable]');if(item&&drag&&item.dataset.treeId!==drag){event.preventDefault();item.classList.add('drag-over');}}); + document.addEventListener('dragleave',event=>event.target.closest?.('[data-tree-id]')?.classList.remove('drag-over')); + document.addEventListener('dragend',()=>{drag=null;root?.querySelectorAll('.drag-over').forEach(e=>e.classList.remove('drag-over'));}); + document.addEventListener('drop',event=>{const item=event.target.closest('[data-tree-id][draggable]');if(!item||!drag||drag===item.dataset.treeId)return;event.preventDefault();const value=drag;drag=null;item.classList.remove('drag-over');window.siteDocument.transform({operation:'move',block_id:value,before:item.dataset.treeId});}); + document.addEventListener('document:state',()=>{ + if(!root?.isConnected)return; + layout(); + const edited=one('[data-file-edited]',root);if(edited)edited.hidden=!window.siteDocument.state.dirty; + code(); + }); + document.addEventListener('document:selection',event=>{inspectorTab=event.detail.bindings?'bindings':'props';tabs();}); + document.addEventListener('htmx:afterSwap',event=>{ + if(!root?.isConnected||event.detail.target.id!=='editor-result')return; + layout();tabs();code(); + if(catalogSubmission){ + if(event.detail.xhr.status===422){ + const form=Array.from(root.querySelectorAll('[data-catalog-form]')).find(f=>f.dataset.catalogForm===catalogSubmission.fragment); + if(form){ + one('.catalog-list',root).hidden=true;form.hidden=false; + const remaining=[...catalogSubmission.fields]; + for(const field of form.elements){ + if(['source','etag','revision','csrf','selection','mode'].includes(field.name))continue; + const index=remaining.findIndex(old=>old.name===field.name&&old.type===field.type);if(index<0)continue; + const [old]=remaining.splice(index,1);field.value=old.value;field.disabled=old.disabled; + if(['checkbox','radio'].includes(field.type))field.checked=old.checked; + } + const errors=one('.issues',root);if(errors){const message=errors.cloneNode(true);message.classList.add('catalog-errors');form.prepend(message);} + open(one('#builder-catalog-dialog',root)); + } + }else catalogSubmission=null; + } + }); + document.addEventListener('htmx:beforeSwap',event=>{ + if(!root?.isConnected||event.detail.target.id!=='editor-result'||event.detail.shouldSwap===false)return; + const preview=one('#stagepane',root);if(preview)move(preview,one('#builder',root),one('#expert-pane',root)); + }); + document.addEventListener('htmx:load',setup);setup(); +})(); diff --git a/src/site_engine/web/admin/static/editor.js b/src/site_engine/web/admin/static/editor.js new file mode 100644 index 0000000..92baea5 --- /dev/null +++ b/src/site_engine/web/admin/static/editor.js @@ -0,0 +1,380 @@ +/* Shared memory-only buffer. No document text or credentials are persisted in Web Storage. */ +(() => { + 'use strict'; + if (window.siteEditorLoaded) return; + window.siteEditorLoaded = true; + let current = null; + let applyTimer, expertTimer, queue=Promise.resolve(); + const leavingForms=new WeakSet(); + const one = (s, root = document) => root.querySelector(s); + function setup() { + const root = one('#document-editor'); + if (root && root === current?.root) return; + clearTimeout(applyTimer);clearTimeout(expertTimer);queue=Promise.resolve(); + if (!root) {current=null;return;} + const source = one('#document-source', root), form = one('#buffer-form', root); + current = {root, source, form, etag: form.elements.etag.value, saved: JSON.parse(root.dataset.canonicalSource), buffer:JSON.parse(root.dataset.rawSource), rev: Number(root.dataset.revision), + mode:'constructor', selection: form.elements.selection.value, readonlySelection:one('#editor-result').dataset.readonly, inspectorDirty:false, preview:null, viewport:{x:0,y:0}, + pending: new Map(), busy:false, page:root.classList.contains('page-builder'), device:'desktop', validated:JSON.parse(root.dataset.rawSource), dirtyForm:null}; + root.dataset.ready = '1'; + showMode(one('#editor-result')?.dataset.valid==='1' ? (form.elements.mode.value || 'constructor') : 'expert'); + status(); + requestPreview(); + } + function dirty() {return current && current.root.isConnected && (current.buffer !== current.saved || current.inspectorDirty);} + function notice(text) {const n = one('#editor-notice'); if (n) n.textContent = text;} + function status() { + if (!current) return; + one('#buffer-status').textContent = dirty() ? 'Есть несохранённые правки' : 'Нет несохранённых изменений'; + current.form.elements.etag.value = current.etag; + current.form.elements.revision.value = current.rev; + current.form.elements.selection.value = current.selection; + current.form.elements.mode.value = current.mode; + one('#buffer-status').classList.toggle('changed',!!dirty()); + one('#buffer-status').classList.toggle('good',!dirty()); + current.root.dispatchEvent(new CustomEvent('document:state', {bubbles:true})); + } + function showMode(mode) { + current.mode = mode; + current.root.dataset.mode = mode; + current.root.querySelectorAll('[data-editor-mode]').forEach(b => {b.setAttribute('aria-pressed', String(b.dataset.editorMode === mode));b.classList.toggle('active', b.dataset.editorMode === mode);}); + status(); + } + function params() {return {source:current.buffer, etag:current.etag, csrf:current.form.elements.csrf.value, + revision:current.rev, mode:current.mode, selection:current.selection, readonly:current.readonlySelection};} + function requestPreview() { + if (!current || !window.htmx || current.busy || one('#editor-result')?.dataset.valid !== '1') return; + htmx.ajax('POST', '/admin/editor' + current.root.dataset.base + '/preview', {target:'#preview-result', swap:'outerHTML', values:params()}); + } + function formValues(form, submitter) { + const data=new FormData(form), values={}; + if(submitter?.name) data.set(submitter.name,submitter.value); + for(const key of new Set(data.keys())) {const all=data.getAll(key);values[key]=all.length>1?all:all[0];} + return values; + } + function liveFieldsHTML(element) { + const clone=element.cloneNode(true), controls=clone.querySelectorAll('input,textarea,select'); + element.querySelectorAll('input,textarea,select').forEach((field,i)=>{ + const next=controls[i]; + if(field.tagName==='TEXTAREA') next.textContent=field.value; + else if(field.tagName==='SELECT') Array.from(next.options).forEach((option,j)=>option.toggleAttribute('selected',field.options[j].selected)); + else {next.setAttribute('value',field.value);if(['checkbox','radio'].includes(field.type)) next.toggleAttribute('checked',field.checked);} + }); + return clone.innerHTML; + } + function request(action, values={}) { + const state=current; + if(!state?.root.isConnected || state.busy) return Promise.resolve(false); + return new Promise(resolve=>{ + const path='/admin/editor'+state.root.dataset.base+'/'+action; + const done=event=>{ + if(event.detail.requestConfig?.path!==path) return; + document.removeEventListener('htmx:afterRequest',done); + resolve(current===state && event.detail.xhr.status===200 && one('#editor-result')?.dataset.valid==='1'); + }; + document.addEventListener('htmx:afterRequest',done); + htmx.ajax('POST',path,{target:'#editor-result',swap:'outerHTML',values:{...values,...params()}}).catch(()=>{document.removeEventListener('htmx:afterRequest',done);resolve(false);}); + }); + } + async function flush() { + clearTimeout(applyTimer); + if(!current.inspectorDirty) return true; + const form=current.dirtyForm; + if(!form?.isConnected) {notice('Проверьте несохранённые поля инспектора.');return false;} + return request('transform',formValues(form)); + } + async function leave(action) { + const state=current; + if(dirty() && !await (state.page?window.siteBuilderConfirm:window.siteAdminConfirm)('Есть несохранённые изменения', 'При переходе правки этой вкладки будут потеряны. Сохраните документ, если хотите оставить изменения.', 'Уйти без сохранения')) return false; + if(current!==state || !state.root.isConnected)return false; + clearTimeout(applyTimer);clearTimeout(expertTimer); + action();return true; + } + function enqueue(work) { + const state=current; + queue=queue.catch(()=>{}).then(async()=>{if(current===state&&state.root.isConnected) await work();}).catch(()=>notice('Запрос не выполнен. Правки остаются в редакторе.')); + } + function editedInspector(target) { + const form=target.closest('[data-inspector]'); + if(!form) return; + current.inspectorDirty=true;current.dirtyForm=form; + if(current.page) {clearTimeout(applyTimer);applyTimer=setTimeout(()=>enqueue(flush),650);} + } + window.siteDocument={ + get state(){return current?{source:current.buffer,saved:current.saved,dirty:!!dirty(),mode:current.mode,busy:current.busy,base:current.root.dataset.base}:null;}, + notice, + leave, + previewReloading:()=>{if(current?.preview) {current.preview.ready=false;current.preview.document=null;}}, + change:element=>{editedInspector(element);status();}, + transform:values=>enqueue(async()=>{if(await flush()) await request('transform',values);}), + reset:()=>enqueue(async()=>{ + if(!await window.siteBuilderConfirm('Отменить изменения?', 'Рабочая редакция вернётся к последней загруженной или сохранённой версии. Файл и опубликованный сайт не изменятся.', 'Отменить изменения')) return; + clearTimeout(applyTimer);clearTimeout(expertTimer);current.inspectorDirty=false;current.dirtyForm=null; + current.buffer=current.saved;current.source.value=current.saved;current.rev++;status();await request('validate'); + }) + }; + function download() { + const url = URL.createObjectURL(new Blob([current.buffer], {type:'text/markdown;charset=utf-8'})); + const a = document.createElement('a'); a.href=url; a.download=current.root.dataset.base.split('/').pop()+'.md'; a.click(); + setTimeout(() => URL.revokeObjectURL(url), 1000); + } + function send(type, extra={}) { + const p = current?.preview, frame = one('#preview-result iframe'); + if(type==='editor:select' && p) p.selectionScroll=extra.scroll===true; + if(p?.ready && p.document && p.document===frame?.contentDocument) { + if(type==='editor:restore') frame.contentWindow.scrollTo({left:extra.x,top:extra.y,behavior:'instant'}); + if(type==='editor:select') { + const roots=Array.from(p.document.querySelectorAll('[data-preview-id]')); + const matches=el=>['scope','owner','id'].every(k=>el.dataset['preview'+k[0].toUpperCase()+k.slice(1)]===extra.block[k]); + roots.forEach(el=>{if(matches(el))el.setAttribute('data-preview-selected','true');else el.removeAttribute('data-preview-selected');}); + if(extra.scroll)roots.find(matches)?.scrollIntoView({block:'nearest',behavior:'instant'}); + } + return; + } + if (p?.ready && frame && current.root.dataset.previewOrigin) frame.contentWindow.postMessage({type,snapshot:p.snapshot,revision:p.revision,...extra},current.root.dataset.previewOrigin); + } + function treeNode(block) { + return Array.from(current.root.querySelectorAll('[data-tree-id]')).find(e=> + e.dataset.treeId===block.id&&e.dataset.treeScope===block.scope&&e.dataset.treeOwner===block.owner); + } + function syncSelection(scroll=false) { + const node=one('.tree-node.selected,.readonly-block.selected'); + if(node)send('editor:select',{block:{scope:node.dataset.treeScope,owner:node.dataset.treeOwner,id:node.dataset.treeId},scroll}); + } + function movePreview(node,parent,before=null) { + if(parent.moveBefore&&node.isConnected)parent.moveBefore(node,before); + else {window.siteDocument.previewReloading();parent.insertBefore(node,before);} + } + function selectSection(block, scroll=true, bindings=false) { + if(!treeNode(block))return; + enqueue(async()=>{ + if(!await flush())return; + const template=Array.from(current.root.querySelectorAll('[data-section-inspector]')).find(e=> + e.dataset.blockId===block.id&&e.dataset.blockScope===block.scope&&e.dataset.blockOwner===block.owner); + if(!template||one('#editor-result').dataset.valid!=='1')return; + const old=one('#inspectpane'),next=template.content.querySelector('#inspectpane').cloneNode(true); + const preview=one('#stagepane',old); + if(preview)movePreview(preview,one('#builder'),one('#expert-pane')); + old.replaceWith(next); + current.selection=block.scope==='page'?block.id:''; + current.readonlySelection=block.scope==='page'?'':JSON.stringify(block); + const result=one('#editor-result');result.dataset.selection=current.selection;result.dataset.readonly=current.readonlySelection; + const selected=treeNode(block); + current.root.querySelectorAll('[data-tree-id]').forEach(e=>e.classList.toggle('selected',e===selected)); + current.root.querySelectorAll('.mapping-card').forEach(e=>e.classList.toggle('map-selected',one('[name=choose]',e)?.value===current.selection)); + current.root.dispatchEvent(new CustomEvent('document:selection',{bubbles:true,detail:{bindings}})); + status();syncSelection(scroll); + }); + } + function chooseFromPreview(block) { + if(!treeNode(block))return; + if(current.page){selectSection(block,false);return;} + if(current.inspectorDirty||current.busy){notice('Сначала примените изменения инспектора.');return;} + current.selection=block.scope==='page'?block.id:''; + current.readonlySelection=block.scope==='page'?'':JSON.stringify(block); + htmx.ajax('POST','/admin/editor'+current.root.dataset.base+'/select',{target:'#editor-result',swap:'outerHTML',values:params()}); + } + function passivePreview(frame) { + const state=current,p=state?.preview; + if(!p||one('#preview-result').dataset.interactive!=='0'||p.revision!==state.rev)return; + const url=new URL(frame.src,location.href); + if(url.origin!==location.origin||url.pathname!==`/admin/preview/s/${p.snapshot}/`)return; + const doc=frame.contentDocument; + if(!doc||doc.URL!==url.href||p.document===doc)return; + const valid=()=>current===state&&state.preview===p&&one('#preview-result iframe')===frame&&frame.contentDocument===doc&&p.revision===state.rev; + p.document=doc;p.ready=true; + doc.addEventListener('click',event=>{ + if(!valid())return; + if(event.target.closest('a,button,input,select,textarea'))event.preventDefault(); + const section=event.target.closest('[data-preview-id]');if(!section)return; + event.preventDefault();event.stopPropagation(); + chooseFromPreview({scope:section.dataset.previewScope,owner:section.dataset.previewOwner,id:section.dataset.previewId}); + },true); + doc.addEventListener('submit',event=>event.preventDefault(),true); + frame.contentWindow.addEventListener('scroll',()=>{if(valid())state.viewport={x:frame.contentWindow.scrollX,y:frame.contentWindow.scrollY};},{passive:true}); + send('editor:restore',state.viewport);syncSelection(p.selectionScroll===true); + } + document.addEventListener('load',event=>{if(event.target===one('#preview-result iframe'))passivePreview(event.target);},true); + document.addEventListener('click', event => { + if (!current || !current.root.isConnected) return; + const b = event.target.closest('button'); + if (b?.matches('[data-editor-mode]')) { + if(current.page) enqueue(async()=>{ + if(!await flush()) return; + if(b.dataset.editorMode==='constructor' && current.buffer!==current.validated && !await request('validate')) return; + if(b.dataset.editorMode==='constructor' && one('#editor-result')?.dataset.valid!=='1') {notice('Исправьте исходник в «Эксперте».');return;} + showMode(b.dataset.editorMode); + }); + else if(!current.inspectorDirty) showMode(b.dataset.editorMode); + else notice('Примените изменения инспектора перед сменой режима.'); + } + if (b?.hasAttribute('data-download')) download(); + if (b?.hasAttribute('data-preview')) requestPreview(); + if (b?.hasAttribute('data-rebase')) {event.preventDefault();if(!current.page||one('[name=confirm_rebase]', b.form)?.checked) {current.etag=b.dataset.rebase; status(); b.disabled=true;notice('Новая основа принята. Проверьте исходник и сохраните отдельной кнопкой.');one('[data-conflict-dialog]')?.close();}} + if (b?.hasAttribute('data-viewport')) { + current.device=b.dataset.viewport; + current.root.querySelectorAll('[data-viewport]').forEach(el=>{el.classList.toggle('active',el.dataset.viewport===current.device);el.setAttribute('aria-pressed',String(el.dataset.viewport===current.device));}); + const frame=one('#preview-result iframe'); + frame?.classList.toggle('mobile-viewport',current.device==='mobile');frame?.classList.toggle('tablet-viewport',current.device==='tablet'); + } + if (b?.hasAttribute('data-validate')) {event.preventDefault();clearTimeout(expertTimer); if(current.page) enqueue(async()=>{if(await flush()) await request('validate');});else if(!current.busy) request('validate');} + const link = event.target.closest('a[href]'); + if(link && !event.defaultPrevented && event.button===0 && !event.ctrlKey && !event.metaKey && !event.shiftKey && !event.altKey && !link.hasAttribute('download') && (!link.target || link.target==='_self') && !(link.href.includes('#')&&link.href.split('#')[0]===location.href.split('#')[0]) && dirty()) { + event.preventDefault();event.stopImmediatePropagation(); + leave(()=>location.assign(link.href)); + } + }, true); + document.addEventListener('input', event => { + if (!current || !current.root.contains(event.target)) return; + if (event.target === current.source) {current.buffer=current.source.value;current.rev++; notice('Исходник изменён.');if(current.page){clearTimeout(expertTimer);expertTimer=setTimeout(()=>enqueue(()=>request('validate')),650);}} + else editedInspector(event.target); + status(); + }); + document.addEventListener('change', event => {if(current && current.root.contains(event.target) && event.target.closest('[data-inspector]')) {editedInspector(event.target);status();}}); + document.addEventListener('submit', event => { + if (!current) return; + const form = event.target; + if (form.closest('#document-editor')) { + if(current.page && window.htmx) { + event.preventDefault();event.stopImmediatePropagation(); + const submitter=event.submitter, values=formValues(form,submitter), action=new URL(submitter?.formAction&&submitter.hasAttribute('formaction')?submitter.formAction:form.action).pathname.split('/').pop(); + if(action==='select' && submitter?.dataset.treeId){selectSection({scope:submitter.dataset.treeScope,owner:submitter.dataset.treeOwner,id:submitter.dataset.treeId},true,submitter.hasAttribute('data-focus-bind'));return;} + if(action==='select' && values.choose!==undefined){const node=Array.from(current.root.querySelectorAll('[data-tree-id]')).find(e=>e.dataset.treeScope==='page'&&e.dataset.treeId===values.choose);if(node){selectSection({scope:node.dataset.treeScope,owner:node.dataset.treeOwner,id:node.dataset.treeId},true,submitter?.hasAttribute('data-focus-bind'));return;}} + clearTimeout(expertTimer); + enqueue(async()=>{ + if(form.matches('[data-inspector]')) {current.dirtyForm=form;current.inspectorDirty=true;if(!await flush()) return;} + else { + if(!await flush()) return; + if(action==='transform' && values.operation==='delete' && !await window.siteBuilderConfirm('Удалить блок?', 'Будет удалён блок '+values.block_id+' вместе с вложенными блоками. Изменения затронут только текущую редакцию до сохранения файла.', 'Удалить из редакции')) return; + if(values.choose!==undefined) {current.selection=values.choose;current.readonlySelection='';} + if(values.choose_readonly) {current.selection='';current.readonlySelection=values.choose_readonly;} + await request(action,values); + } + }); + return; + } + + if (current.busy) {event.preventDefault(); event.stopImmediatePropagation(); return;} + if (current.inspectorDirty && !form.matches('[data-inspector]')) {event.preventDefault(); event.stopImmediatePropagation(); notice('Примените изменения инспектора к буферу. Затем сохраните документ.'); return;} + if(event.submitter?.name==='choose') {current.selection=event.submitter.value;current.readonlySelection='';} + if(event.submitter?.name==='choose_readonly') {current.selection='';current.readonlySelection=event.submitter.value;} + } else if(form.method!=='dialog' && dirty() && !leavingForms.has(form)) { + event.preventDefault();event.stopImmediatePropagation(); + const submitter=event.submitter; + leave(()=>{leavingForms.add(form);try{form.requestSubmit(submitter);}finally{leavingForms.delete(form);}}); + } + }, true); + document.addEventListener('htmx:configRequest', event => { + if (!current || !event.detail.path.startsWith('/admin/editor'+current.root.dataset.base+'/')) return; + const d=event.detail, preview=d.path.endsWith('/preview'); + if (!preview) {if(!d.path.endsWith('/select')) current.rev++; current.busy=true;} + const values=params(); + // Selection is the clicked submitter's value, not the hidden previous selection. + const submitter=d.triggeringEvent?.submitter; + if (submitter?.name==='choose') values.selection=submitter.value; + Object.assign(d.parameters, values); + current.selection=values.selection; + current.form.elements.source.readOnly=!preview; + if(!preview) {const constructor=one('[data-constructor]');if(constructor)constructor.inert=true;} + status(); + }); + document.addEventListener('htmx:beforeRequest', event => { + if (!current || !event.detail.requestConfig.path.startsWith('/admin/editor'+current.root.dataset.base+'/')) return; + const cfg=event.detail.requestConfig; + current.pending.set(event.detail.xhr,{rev: Number(cfg.parameters.revision),source:cfg.parameters.source,path:cfg.path, + selection:cfg.parameters.selection,operation:cfg.parameters.operation,focus:document.activeElement?.name,caret:document.activeElement?.selectionStart,scroll:one('#treepane .pane-scroll')?.scrollTop, inspectorScroll:one('.inspect-scroll')?.scrollTop}); + }); + document.addEventListener('htmx:beforeSwap', event => { + if (!current) return; + const d=event.detail, pending=current.pending.get(d.xhr); + if (!pending) return; + if (d.xhr.status===401) {d.shouldSwap=false; notice('Сессия истекла. Скачайте исходник и войдите снова: /admin/login'); return;} + const revision=Number(d.xhr.getResponseHeader('X-Editor-Revision')); + if (revision!==current.rev || pending.rev!==current.rev) {d.shouldSwap=false; return;} + if (pending.path.endsWith('/preview')) { + if(d.xhr.status!==200) {d.shouldSwap=false; notice('Превью недоступно. Правки остаются в редакторе.');} + return; + } + if (d.xhr.status>=500 && d.xhr.getResponseHeader('X-Document-Committed')!=='1') {d.shouldSwap=false; notice('Сервер не завершил запрос. Правки остаются в редакторе; проверьте серверную версию перед повтором.'); return;} + if(d.xhr.getResponseHeader('X-Document-Committed')==='1') {d.shouldSwap=true;d.isError=false;} + const doc=new DOMParser().parseFromString(d.serverResponse,'text/html'); + const result=doc.querySelector('#editor-result'); + if(!result) {d.shouldSwap=false; notice('Ответ сервера не принят. Правки остаются в редакторе.'); return;} + // Keep the last valid tree when Expert source cannot be projected. + if(result.dataset.valid!=='1') { + const old=one(current.page?'#treepane':'[data-constructor]'); + const next=result.querySelector(current.page?'#treepane':'[data-constructor]'); + if(old&&next) {next.innerHTML=old.innerHTML; next.inert=true;} + showMode('expert'); + } + if(d.xhr.status===422 && result.dataset.valid==='1') { + for(const selector of current.page?['[data-inspector-panel="props"]','[data-inspector-panel="page"]']:['.doc-inspector']) { + const old=one(selector),next=result.querySelector(selector); + if(old&&next) next.innerHTML=liveFieldsHTML(old); + } + } + d.serverResponse=result.outerHTML; + }); + document.addEventListener('htmx:afterSwap', event => { + if(!current) return; + if(event.detail.target.id==='editor-result') { + const el=one('#editor-result'); + if(el.dataset.revision!==String(current.rev)) return; + current.buffer=JSON.parse(el.dataset.rawSource); + current.source.value=current.buffer; + current.etag=el.dataset.etag; + current.readonlySelection=el.dataset.readonly; + if(current.page) current.selection=el.dataset.selection; + if(el.dataset.valid==='1') current.validated=current.buffer; + const pageStatus=one('[data-page-status]');if(pageStatus)pageStatus.textContent=el.dataset.status; + one('.doc-toolbar h1').textContent=el.dataset.title; + if(event.detail.xhr.status!==422) {current.inspectorDirty=false;current.dirtyForm=null;} + if(el.dataset.saved==='1') current.saved=current.buffer; + status(); + notice(el.dataset.valid!=='1'?'Исправьте исходник. Последнее корректное дерево доступно для просмотра.':event.detail.xhr.status===422?'Изменения не применены. Исправьте поля формы.':'Изменения проверены.'); + const selected=one('.tree-node.selected,.readonly-block.selected'); + if(selected) send('editor:select',{block:{scope:selected.dataset.treeScope,owner:selected.dataset.treeOwner,id:selected.dataset.treeId},scroll:false}); + const pending=current.pending.get(event.detail.xhr); + const focus=Array.from(el.querySelectorAll('input,select,textarea,button')).find(e=>e.name===pending?.focus&&!e.hidden&&e.type!=='hidden'); + focus?.focus({preventScroll:true}); + if(focus?.setSelectionRange&&Number.isInteger(pending?.caret)) {try{focus.setSelectionRange(pending.caret,pending.caret);}catch{}} + const treeScroll=one('#treepane .pane-scroll');if(treeScroll&&Number.isFinite(pending?.scroll))treeScroll.scrollTop=pending.scroll; + const inspectScroll=one('.inspect-scroll');if(inspectScroll&&Number.isFinite(pending?.inspectorScroll))inspectScroll.scrollTop=pending.inspectorScroll; + if(current.inspectorDirty) current.dirtyForm=Array.from(el.querySelectorAll('[data-inspector]')).find(form=>form.elements.operation.value===pending?.operation); + } + if(event.detail.target.id==='preview-result') { + const p=one('#preview-result'); current.preview={snapshot:p.dataset.snapshot,revision:Number(p.dataset.revision),ready:false}; + one('iframe',p)?.classList.toggle('mobile-viewport',current.device==='mobile');one('iframe',p)?.classList.toggle('tablet-viewport',current.device==='tablet'); + const frame=one('iframe',p);if(frame)passivePreview(frame); + } + }); + document.addEventListener('htmx:afterRequest', event => { + if(!current) return; + const pending=current.pending.get(event.detail.xhr); + if(!pending) return; + current.pending.delete(event.detail.xhr); + if(!pending.path.endsWith('/preview')) { + current.busy=false; current.source.readOnly=false; + const constructor=one('[data-constructor]');if(constructor)constructor.inert=one('#editor-result')?.dataset.valid!=='1'; + if(event.detail.xhr.status===0) notice('Нет связи с сервером. Правки остаются в открытом редакторе.'); + if(event.detail.xhr.status===200 && !pending.path.endsWith('/select')) setTimeout(requestPreview,0); + if(pending.path.endsWith('/select')) { + const b=one('.tree-node.selected,.readonly-block.selected'); + if(b) send('editor:select',{block:{scope:b.dataset.treeScope,owner:b.dataset.treeOwner,id:b.dataset.treeId},scroll:true}); + } + } + }); + addEventListener('message', event => { + const p=current?.preview, frame=one('#preview-result iframe'), m=event.data; + if(!p || !m || event.origin!==current.root.dataset.previewOrigin || event.source!==frame?.contentWindow || m.snapshot!==p.snapshot || m.revision!==p.revision || p.revision!==current.rev) return; + if(m.type==='preview:ready' && Array.isArray(m.blocks)) {p.ready=true;send('editor:restore',current.viewport); if(current.selection||current.readonlySelection) { + syncSelection(p.selectionScroll===true); + }} + if(m.type==='preview:viewport' && Number.isFinite(m.x)&&Number.isFinite(m.y)) current.viewport={x:m.x,y:m.y}; + if(m.type==='preview:select' && m.block && typeof m.block.id==='string') { + chooseFromPreview(m.block); + } + }); + document.addEventListener('htmx:load',setup); + setup(); +})(); diff --git a/src/site_engine/web/admin/static/htmx.min.js b/src/site_engine/web/admin/static/htmx.min.js new file mode 100644 index 0000000..e6b8394 --- /dev/null +++ b/src/site_engine/web/admin/static/htmx.min.js @@ -0,0 +1 @@ +var htmx=function(){"use strict";const Y={onLoad:null,process:null,on:null,off:null,trigger:null,ajax:null,find:null,findAll:null,closest:null,values:function(e,t){const n=pn(e,t||"post");return n.values},remove:null,addClass:null,removeClass:null,toggleClass:null,takeClass:null,swap:null,defineExtension:null,removeExtension:null,logAll:null,logNone:null,logger:null,config:{historyEnabled:true,historyCacheSize:10,refreshOnHistoryMiss:false,defaultSwapStyle:"innerHTML",defaultSwapDelay:0,defaultSettleDelay:20,includeIndicatorStyles:true,indicatorClass:"htmx-indicator",requestClass:"htmx-request",addedClass:"htmx-added",settlingClass:"htmx-settling",swappingClass:"htmx-swapping",allowEval:true,allowScriptTags:true,inlineScriptNonce:"",inlineStyleNonce:"",attributesToSettle:["class","style","width","height"],withCredentials:false,timeout:0,wsReconnectDelay:"full-jitter",wsBinaryType:"blob",disableSelector:"[hx-disable], [data-hx-disable]",scrollBehavior:"instant",defaultFocusScroll:false,getCacheBusterParam:false,globalViewTransitions:false,methodsThatUseUrlParams:["get","delete"],selfRequestsOnly:true,ignoreTitle:false,scrollIntoViewOnBoost:true,triggerSpecsCache:null,disableInheritance:false,responseHandling:[{code:"204",swap:false},{code:"[23]..",swap:true},{code:"[45]..",swap:false,error:true}],allowNestedOobSwaps:true,historyRestoreAsHxRequest:true,reportValidityOfForms:false},parseInterval:null,location:location,_:null,version:"2.0.11"};Y.onLoad=V;Y.process=Bt;Y.on=ye;Y.off=xe;Y.trigger=ae;Y.ajax=In;Y.find=a;Y.findAll=x;Y.closest=g;Y.remove=z;Y.addClass=w;Y.removeClass=S;Y.toggleClass=G;Y.takeClass=W;Y.swap=C;Y.defineExtension=zn;Y.removeExtension=Jn;Y.logAll=$;Y.logNone=_;Y.parseInterval=d;Y._=e;const n={addTriggerHandler:Et,bodyContains:ie,canAccessLocalStorage:U,findThisElement:we,filterValues:xn,swap:C,hasAttribute:s,getAttributeValue:f,getClosestAttributeValue:te,getClosestMatch:A,getExpressionVars:qn,getHeaders:yn,getInputValues:pn,getInternalData:re,getSwapSpecification:vn,getTriggerSpecs:lt,getTarget:Se,makeFragment:D,mergeObjects:se,makeSettleInfo:En,oobSwap:Te,querySelectorExt:ce,settleImmediately:Qt,shouldCancel:dt,triggerEvent:ae,triggerErrorEvent:ue,withExtensions:Vt};const he=["get","post","put","delete","patch"];const R=he.map(function(e){return"[hx-"+e+"], [data-hx-"+e+"]"}).join(", ");function d(e){if(e==undefined){return undefined}let t=NaN;if(e.slice(-2)=="ms"){t=parseFloat(e.slice(0,-2))}else if(e.slice(-1)=="s"){t=parseFloat(e.slice(0,-1))*1e3}else if(e.slice(-1)=="m"){t=parseFloat(e.slice(0,-1))*1e3*60}else{t=parseFloat(e)}return isNaN(t)?undefined:t}function Q(e,t){return e instanceof Element&&e.getAttribute(t)}function s(e,t){return!!e.hasAttribute&&(e.hasAttribute(t)||e.hasAttribute("data-"+t))}function f(e,t){return Q(e,t)||Q(e,"data-"+t)}function u(e){const t=e.parentElement;if(!t&&e.parentNode instanceof ShadowRoot)return e.parentNode;return t}function ee(){return document}function q(e,t){return e.getRootNode?e.getRootNode({composed:t}):ee()}function A(e,t){while(e&&!t(e)){e=u(e)}return e||null}function o(e,t,n){const r=f(t,n);const o=f(t,"hx-disinherit");var i=f(t,"hx-inherit");if(e!==t){if(Y.config.disableInheritance){if(i&&(i==="*"||i.split(" ").indexOf(n)>=0)){return r}else{return null}}if(o&&(o==="*"||o.split(" ").indexOf(n)>=0)){return"unset"}}return r}function te(t,n){let r=null;A(t,function(e){return!!(r=o(t,le(e),n))});if(r!=="unset"){return r}}function h(e,t){return e instanceof Element&&e.matches(t)}function N(e){const t=/<([a-z][^\/\0>\x20\t\r\n\f]*)/i;const n=t.exec(e);if(n){return n[1].toLowerCase()}else{return""}}function I(e){if("parseHTMLUnsafe"in Document){return Document.parseHTMLUnsafe(e)}const t=new DOMParser;return t.parseFromString(e,"text/html")}function L(e,t){while(t.childNodes.length>0){e.append(t.childNodes[0])}}function r(e){const t=ee().createElement("script");oe(e.attributes,function(e){t.setAttribute(e.name,e.value)});t.textContent=e.textContent;t.async=false;if(Y.config.inlineScriptNonce){t.nonce=Y.config.inlineScriptNonce}return t}function i(e){return e.matches("script")&&(e.type==="text/javascript"||e.type==="module"||e.type==="")}function k(e){if(!Y.config.allowScriptTags){e.querySelectorAll("script").forEach(e=>e.remove());return}Array.from(e.querySelectorAll("script")).forEach(e=>{if(i(e)){const t=r(e);const n=e.parentNode;try{n.insertBefore(t,e)}catch(e){T(e)}finally{e.remove()}}})}function D(e){e=e.replace(/]*)?)>/gi,'");const t=e.replace(/]*)?>[\s\S]*?<\/head>/i,"");const n=N(t);let r;if(n==="html"){r=new DocumentFragment;const i=I(e);L(r,i.body);r.title=i.title}else if(n==="body"){r=new DocumentFragment;const i=I(t);L(r,i.body);r.title=i.title}else{const i=I('");r=i.querySelector("template").content;r.title=i.title;var o=r.querySelector("title");if(o&&o.parentNode===r){o.remove();r.title=o.innerText}}if(r){k(r)}return r}function ne(e){if(e){e()}}function t(e,t){return Object.prototype.toString.call(e)==="[object "+t+"]"}function P(e){return typeof e==="function"}function M(e){return t(e,"Object")}function re(e){const t="htmx-internal-data";let n=e[t];if(!n){n=e[t]={}}return n}function F(t){const n=[];if(t){for(let e=0;e=0}function ie(e){return e.getRootNode({composed:true})===document}function X(e){return e.trim().split(/\s+/)}function se(e,t){return Object.assign({},e,t)}function v(e){try{return JSON.parse(e)}catch(e){T(e);return null}}function U(){const e="htmx:sessionStorageTest";try{sessionStorage.setItem(e,e);sessionStorage.removeItem(e);return true}catch(e){return false}}function j(e){try{const t=new URL(e,window.location.href);e=t.pathname+t.search}catch(e){}if(e!="/"){e=e.replace(/\/+$/,"")}return e}function e(e){return Tn(ee().body,function(){return eval(e)})}function V(t){const e=Y.on("htmx:load",function(e){t(e.detail.elt)});return e}function $(){Y.logger=function(e,t,n){if(console){console.log(t,e,n)}}}function _(){Y.logger=null}function a(e,t){if(typeof e!=="string"){return e.querySelector(t)}else{return a(ee(),e)}}function x(e,t){if(typeof e!=="string"){return e.querySelectorAll(t)}else{return x(ee(),e)}}function b(){return window}function z(e,t){e=E(e);if(t){b().setTimeout(function(){z(e);e=null},t)}else{u(e).removeChild(e)}}function le(e){return e instanceof Element?e:null}function J(e){return e instanceof HTMLElement?e:null}function K(e){return typeof e==="string"?e:null}function p(e){return e instanceof Element||e instanceof Document||e instanceof DocumentFragment?e:null}function w(e,t,n){e=le(E(e));if(!e){return}if(n){b().setTimeout(function(){w(e,t);e=null},n)}else{e.classList&&e.classList.add(t)}}function S(e,t,n){let r=le(E(e));if(!r){return}if(n){b().setTimeout(function(){S(r,t);r=null},n)}else{if(r.classList){r.classList.remove(t);if(r.classList.length===0){r.removeAttribute("class")}}}}function G(e,t){e=E(e);e.classList.toggle(t)}function W(e,t){e=E(e);oe(e.parentElement.children,function(e){S(e,t)});w(le(e),t)}function g(e,t){e=le(E(e));if(e){return e.closest(t)}return null}function l(e,t){return e.substring(0,t.length)===t}function Z(e,t){return e.substring(e.length-t.length)===t}function de(e){const t=e.trim();if(l(t,"<")&&Z(t,"/>")){return t.substring(1,t.length-2)}else{return t}}function m(t,r,n){if(r.indexOf("global ")===0){return m(t,r.slice(7),true)}t=E(t);const o=[];{let t=0;let n=0;for(let e=0;e"){t--}}if(n0){const r=de(o.shift());let e;if(r.indexOf("closest ")===0){e=g(le(t),de(r.slice(8)))}else if(r.indexOf("find ")===0){e=a(p(t),de(r.slice(5)))}else if(r==="next"||r==="nextElementSibling"){e=le(t).nextElementSibling}else if(r.indexOf("next ")===0){e=pe(t,de(r.slice(5)),!!n)}else if(r==="previous"||r==="previousElementSibling"){e=le(t).previousElementSibling}else if(r.indexOf("previous ")===0){e=ge(t,de(r.slice(9)),!!n)}else if(r==="document"){e=document}else if(r==="window"){e=window}else if(r==="body"){e=document.body}else if(r==="root"){e=q(t,!!n)}else if(r==="host"){e=t.getRootNode().host}else{s.push(r)}if(e){i.push(e)}}if(s.length>0){const e=s.join(",");const c=p(q(t,!!n));i.push(...F(c.querySelectorAll(e)))}return i}var pe=function(t,e,n){const r=p(q(t,n)).querySelectorAll(e);for(let e=0;e=0;e--){const o=r[e];if(o.compareDocumentPosition(t)===Node.DOCUMENT_POSITION_FOLLOWING){return o}}};function ce(e,t){if(typeof e!=="string"){return m(e,t)[0]}else{return m(ee().body,e)[0]}}function E(e,t){if(typeof e==="string"){return a(p(t)||document,e)}else{return e}}function me(e,t,n,r){if(P(t)){return{target:ee().body,event:K(e),listener:t,options:n}}else{return{target:E(e),event:K(t),listener:n,options:r}}}function ye(t,n,r,o){Wn(function(){const e=me(t,n,r,o);e.target.addEventListener(e.event,e.listener,e.options)});const e=P(n);return e?n:r}function xe(t,n,r){Wn(function(){const e=me(t,n,r);e.target.removeEventListener(e.event,e.listener)});return P(n)?n:r}const be=ee().createElement("output");function ve(t,n){const e=te(t,n);if(e){if(e==="this"){return[we(t,n)]}else{const r=m(t,e);const o=/(^|,)(\s*)inherit(\s*)($|,)/.test(e);if(o){const i=le(A(t,function(e){return e!==t&&s(le(e),n)}));if(i){r.push(...ve(i,n))}}if(r.length===0){T('The selector "'+e+'" on '+n+" returned no matches!");return[be]}else{return r}}}}function we(e,t){return le(A(e,function(e){return f(le(e),t)!=null}))}function Se(e){const t=te(e,"hx-target");if(t){if(t==="this"){return we(e,"hx-target")}else{return ce(e,t)}}else{const n=re(e);if(n.boosted){return ee().body}else{return e}}}function Ee(e){return Y.config.attributesToSettle.includes(e)}function Ce(t,n){oe(Array.from(t.attributes),function(e){if(!n.hasAttribute(e.name)&&Ee(e.name)){t.removeAttribute(e.name)}});oe(n.attributes,function(e){if(Ee(e.name)){t.setAttribute(e.name,e.value)}})}function Oe(t,e){const n=Kn(e);for(let e=0;e0){s=e.substring(0,e.indexOf(":"));n=e.substring(e.indexOf(":")+1)}else{s=e}o.removeAttribute("hx-swap-oob");o.removeAttribute("data-hx-swap-oob");const r=m(t,n,false);if(r.length){oe(r,function(e){let t;const n=o.cloneNode(true);t=ee().createDocumentFragment();t.appendChild(n);if(!Oe(s,e)){t=p(n)}const r={shouldSwap:true,target:e,fragment:t};if(!ae(e,"htmx:oobBeforeSwap",r))return;e=r.target;if(r.shouldSwap){Re(t);Ve(s,e,e,t,i);He()}oe(i.elts,function(e){ae(e,"htmx:oobAfterSwap",r)})});o.parentNode.removeChild(o)}else{o.parentNode.removeChild(o);ue(ee().body,"htmx:oobErrorNoTarget",{content:o,target:n})}return e}function He(){const e=a("#--htmx-preserve-pantry--");if(e){for(const t of[...e.children]){const n=a("#"+t.id);n.parentNode.moveBefore(t,n);n.remove()}e.remove()}}function Re(e){oe(x(e,"[hx-preserve], [data-hx-preserve]"),function(e){const t=f(e,"id");const n=ee().getElementById(t);if(n!=null){if(e.moveBefore){let e=a("#--htmx-preserve-pantry--");if(e==null){ee().body.insertAdjacentHTML("afterend","
    ");e=a("#--htmx-preserve-pantry--")}e.moveBefore(n,null)}else{e.parentNode.replaceChild(n,e)}}})}function qe(i,e,s){oe(e.querySelectorAll("[id]"),function(t){const n=Q(t,"id");if(n&&n.length>0){const e=p(i);const r=e&&e.querySelector(CSS.escape(t.tagName)+"#"+CSS.escape(n));if(r&&r!==e){const o=t.cloneNode();Ce(t,r);s.tasks.push(function(){Ce(t,o)})}}})}function Ae(e){return function(){S(e,Y.config.addedClass);Bt(le(e));Ne(p(e));ae(e,"htmx:load")}}function Ne(e){const t="[autofocus]";const n=J(h(e,t)?e:e.querySelector(t));if(n!=null){n.focus()}}function c(e,t,n,r){qe(e,n,r);while(n.childNodes.length>0){const o=n.firstChild;w(le(o),Y.config.addedClass);e.insertBefore(o,t);if(o.nodeType!==Node.TEXT_NODE&&o.nodeType!==Node.COMMENT_NODE){r.tasks.push(Ae(o))}}}function Ie(e,t){let n=0;while(n0}function _e(e,n,r){var t=x(e,"[hx-swap-oob], [data-hx-swap-oob]");oe(t,function(e){if(Y.config.allowNestedOobSwaps||e.parentElement===null){const t=f(e,"hx-swap-oob");if(t!=null){Te(t,e,n,r)}}else{e.removeAttribute("hx-swap-oob");e.removeAttribute("data-hx-swap-oob")}});return t.length>0}function C(d,p,g,m){if(!m){m={}}let y=null;let n=null;let e=function(){ne(m.beforeSwapCallback);d=E(d);const r=m.contextElement&&m.contextElement.isConnected?q(m.contextElement,false):ee();const e=document.activeElement;let t={};t={elt:e,start:e?e.selectionStart:null,end:e?e.selectionEnd:null};const o=En(d);if(g.swapStyle==="textContent"){d.textContent=p}else{let n=typeof p==="string"?D(p):p;o.title=m.title||n.title;if(m.historyRequest){n=n.querySelector("[hx-history-elt],[data-hx-history-elt]")||n}if(m.selectOOB){const s=m.selectOOB.split(",");for(let t=0;t0){b().setTimeout(n,g.settleDelay)}else{n()}};let t=Y.config.globalViewTransitions;if(g.hasOwnProperty("transition")){t=g.transition}const r=m.contextElement||ee();if(t&&ae(r,"htmx:beforeTransition",m.eventInfo)&&typeof Promise!=="undefined"&&document.startViewTransition){const o=new Promise(function(e,t){y=e;n=t});const i=e;e=function(){document.startViewTransition(function(){i();return o})}}try{if(g?.swapDelay&&g.swapDelay>0){b().setTimeout(e,g.swapDelay)}else{e()}}catch(e){ue(r,"htmx:swapError",m.eventInfo);ne(n);throw e}}function ze(e,t,n){const r=e.getResponseHeader(t);if(r.indexOf("{")===0){const o=v(r)||{};for(const i of Object.keys(o)){let e=o[i];if(M(e)){n=e.target!==undefined?e.target:n}else{e={value:e}}ae(n,i,e)}}else{const s=r.split(",");for(let e=0;e0){const s=o[0];if(s==="]"){e--;if(e===0){if(n===null){t=t+"true"}o.shift();t+=")})";try{const l=Tn(r,function(){return Function(t)()},function(){return true});l.source=t;return l}catch(e){ue(ee().body,"htmx:syntax:error",{error:e,source:t});return null}}}else if(s==="["){e++}if(nt(s,n,i)){t+="(("+i+"."+s+") ? ("+i+"."+s+") : (window."+s+"))"}else{t=t+s}n=o.shift()}}}function O(e,t){let n="";while(e.length>0&&!t.test(e[0])){n+=e.shift()}return n}function ot(e){let t;if(e.length>0&&Qe.test(e[0])){e.shift();t=O(e,et).trim();e.shift()}else{t=O(e,Ke)}return t}const it="input, textarea, select";function st(e,t,n){const r=[];const o=tt(t);do{O(o,Ye);const l=o.length;const c=O(o,/[,\[\s]/);if(c!==""){if(c==="every"){const u={trigger:"every"};O(o,Ye);u.pollInterval=d(O(o,/[,\[\s]/));O(o,Ye);var i=rt(e,o,"event");if(i){u.eventFilter=i}r.push(u)}else{const a={trigger:c};var i=rt(e,o,"event");if(i){a.eventFilter=i}O(o,Ye);while(o.length>0&&o[0]!==","){const f=o.shift();if(f==="changed"){a.changed=true}else if(f==="once"){a.once=true}else if(f==="consume"){a.consume=true}else if(f==="delay"&&o[0]===":"){o.shift();a.delay=d(O(o,Ke))}else if(f==="from"&&o[0]===":"){o.shift();if(Qe.test(o[0])){var s=ot(o)}else{var s=O(o,Ke);if(s==="closest"||s==="find"||s==="next"||s==="previous"){o.shift();const h=ot(o);if(h.length>0){s+=" "+h}}}a.from=s}else if(f==="target"&&o[0]===":"){o.shift();a.target=ot(o)}else if(f==="throttle"&&o[0]===":"){o.shift();a.throttle=d(O(o,Ke))}else if(f==="queue"&&o[0]===":"){o.shift();a.queue=O(o,Ke)}else if(f==="root"&&o[0]===":"){o.shift();a[f]=ot(o)}else if(f==="threshold"&&o[0]===":"){o.shift();a[f]=O(o,Ke)}else{ue(e,"htmx:syntax:error",{token:o.shift()})}O(o,Ye)}r.push(a)}}if(o.length===l){ue(e,"htmx:syntax:error",{token:o.shift()})}O(o,Ye)}while(o[0]===","&&o.shift());if(n){n[t]=r}return r}function lt(e){const t=f(e,"hx-trigger");let n=[];if(t){const r=Y.config.triggerSpecsCache;n=r&&r[t]||st(e,t,r)}if(n.length>0){return n}else if(h(e,"form")){return[{trigger:"submit"}]}else if(h(e,'input[type="button"], input[type="submit"]')){return[{trigger:"click"}]}else if(h(e,it)){return[{trigger:"change"}]}else{return[{trigger:"click"}]}}function ct(e){re(e).cancelled=true}function ut(e,t,n){const r=re(e);r.timeout=b().setTimeout(function(){if(ie(e)&&r.cancelled!==true){if(!gt(n,e,Ut("hx:poll:trigger",{triggerSpec:n,target:e}))){t(e)}ut(e,t,n)}},n.pollInterval)}function at(e){return location.hostname===e.hostname&&Q(e,"href")&&Q(e,"href").indexOf("#")!==0}function ft(e){return g(e,Y.config.disableSelector)}function ht(t,n,e){if(t instanceof HTMLAnchorElement&&at(t)&&(t.target===""||t.target==="_self")||t.tagName==="FORM"&&String(Q(t,"method")).toLowerCase()!=="dialog"){n.boosted=true;let r,o;if(t.tagName==="A"){r="get";o=Q(t,"href")}else{const i=Q(t,"method");r=i?i.toLowerCase():"get";o=Q(t,"action");if(o==null||o===""){o=location.href}if(r==="get"&&o.includes("?")){o=o.replace(/\?[^#]+/,"")}}e.forEach(function(e){mt(t,function(e,t){const n=le(e);if(ft(n)){y(n);return}fe(r,o,n,t)},n,e,true)})}}function dt(e,t){if(e.type==="submit"&&t.tagName==="FORM"){return true}else if(e.type==="click"){const n=t.closest('input[type="submit"], button');if(n&&n.form&&n.type==="submit"){return true}const r=t.closest("a");const o=/^#.+/;if(r&&r.href&&!o.test(r.getAttribute("href"))){return true}}return false}function pt(e,t){return re(e).boosted&&e instanceof HTMLAnchorElement&&t.type==="click"&&(t.ctrlKey||t.metaKey)}function gt(e,t,n){const r=e.eventFilter;if(r){try{return r.call(t,n)!==true}catch(e){const o=r.source;ue(ee().body,"htmx:eventFilter:error",{error:e,source:o});return true}}return false}function mt(l,c,e,u,a){const f=re(l);let t;if(u.from){t=m(l,u.from)}else{t=[l]}if(u.changed){if(!("lastValue"in f)){f.lastValue=new WeakMap}t.forEach(function(e){if(!f.lastValue.has(u)){f.lastValue.set(u,new WeakMap)}f.lastValue.get(u).set(e,e.value)})}oe(t,function(i){const s=function(e){if(!ie(l)){i.removeEventListener(u.trigger,s);return}if(pt(l,e)){return}if(a||dt(e,i)){e.preventDefault()}if(gt(u,l,e)){return}const t=re(e);t.triggerSpec=u;if(t.handledFor==null){t.handledFor=[]}if(t.handledFor.indexOf(l)<0){t.handledFor.push(l);if(u.consume){e.stopPropagation()}if(u.target&&e.target){if(!h(le(e.target),u.target)){return}}if(u.once){if(f.triggeredOnce){return}else{f.triggeredOnce=true}}if(u.changed){const n=e.target;const r=n.value;const o=f.lastValue.get(u);if(o.has(n)&&o.get(n)===r){return}o.set(n,r)}if(f.delayed){clearTimeout(f.delayed)}if(f.throttle){return}if(u.throttle>0){if(!f.throttle){ae(l,"htmx:trigger");c(l,e);f.throttle=b().setTimeout(function(){f.throttle=null},u.throttle)}}else if(u.delay>0){f.delayed=b().setTimeout(function(){ae(l,"htmx:trigger");c(l,e)},u.delay)}else{ae(l,"htmx:trigger");c(l,e)}}};if(e.listenerInfos==null){e.listenerInfos=[]}e.listenerInfos.push({trigger:u.trigger,listener:s,on:i});i.addEventListener(u.trigger,s)})}let yt=false;let xt=null;function bt(){if(!xt){xt=function(){yt=true};window.addEventListener("scroll",xt);window.addEventListener("resize",xt);setInterval(function(){if(yt){yt=false;oe(ee().querySelectorAll("[hx-trigger*='revealed'],[data-hx-trigger*='revealed']"),function(e){vt(e)})}},200)}}function vt(e){if(!s(e,"data-hx-revealed")&&B(e)){e.setAttribute("data-hx-revealed","true");const t=re(e);if(t.initHash){ae(e,"revealed")}else{e.addEventListener("htmx:afterProcessNode",function(){ae(e,"revealed")},{once:true})}}}function wt(e,t,n,r){const o=function(){if(!n.loaded){n.loaded=true;ae(e,"htmx:trigger");t(e)}};if(r>0){b().setTimeout(o,r)}else{o()}}function St(t,n,e){let i=false;oe(he,function(r){if(s(t,"hx-"+r)){const o=f(t,"hx-"+r);i=true;n.path=o;n.verb=r;e.forEach(function(e){Et(t,e,n,function(e,t){const n=le(e);if(ft(n)){y(n);return}fe(r,o,n,t)})})}});return i}function Et(r,e,t,n){if(e.trigger==="revealed"){bt();mt(r,n,t,e);vt(le(r))}else if(e.trigger==="intersect"){const o={};if(e.root){o.root=ce(r,e.root)}if(e.threshold){o.threshold=parseFloat(e.threshold)}const i=new IntersectionObserver(function(t){for(let e=0;e0){t.polling=true;ut(le(r),n,e)}else{mt(r,n,t,e)}}function Ct(e){const t=le(e);if(!t){return false}const n=t.attributes;for(let e=0;e", "+e).join(""));return o}else{return[]}}function qt(e){const t=Nt(e.target);const n=Lt(e);if(n){n.lastButtonClicked=t}}function At(e){const t=Lt(e);if(t){t.lastButtonClicked=null}}function Nt(e){return g(le(e),"button, input[type='submit']")}function It(e){return e.form||g(e,"form")}function Lt(e){const t=Nt(e.target);if(!t){return}const n=It(t);if(!n){return}return re(n)}function kt(e){e.addEventListener("click",qt);e.addEventListener("focusin",qt);e.addEventListener("focusout",At)}function Dt(t,e,n){const r=re(t);if(!Array.isArray(r.onHandlers)){r.onHandlers=[]}let o;const i=function(e){Tn(t,function(){if(ft(t)){return}if(!o){o=new Function("event",n)}o.call(t,e)})};t.addEventListener(e,i);r.onHandlers.push({event:e,listener:i})}function Pt(t){ke(t);for(let e=0;eY.config.historyCacheSize){i.shift()}while(i.length>0){try{sessionStorage.setItem("htmx-history-cache",JSON.stringify(i));break}catch(e){ue(ee().body,"htmx:historyCacheError",{cause:e,cache:i});i.shift()}}}function Kt(t){if(!U()){return null}t=j(t);const n=v(sessionStorage.getItem("htmx-history-cache"))||[];for(let e=0;e=200&&this.status<400){r.response=this.response;ae(ee().body,"htmx:historyCacheMissLoad",r);C(r.historyElt,r.response,n,{contextElement:r.historyElt,historyRequest:true});_t(r.path);ae(ee().body,"htmx:historyRestore",{path:e,cacheMiss:true,serverResponse:r.response})}else{ue(ee().body,"htmx:historyCacheMissLoadError",r)}};if(ae(ee().body,"htmx:historyCacheMiss",r)){t.send()}}function tn(e){Wt();e=e||location.pathname+location.search;const t=Kt(e);if(t){const n={swapStyle:"innerHTML",swapDelay:0,settleDelay:0,scroll:t.scroll};const r={path:e,item:t,historyElt:zt(),swapSpec:n};if(ae(ee().body,"htmx:historyCacheHit",r)){C(r.historyElt,t.content,n,{contextElement:r.historyElt,title:t.title});_t(r.path);ae(ee().body,"htmx:historyRestore",r)}}else{if(Y.config.refreshOnHistoryMiss){Y.location.reload(true)}else{en(e)}}}function nn(e){let t=ve(e,"hx-indicator");if(t==null){t=[e]}oe(t,function(e){const t=re(e);t.requestCount=(t.requestCount||0)+1;w(e,Y.config.requestClass)});return t}function rn(e){let t=ve(e,"hx-disabled-elt");if(t==null){t=[]}oe(t,function(e){const t=re(e);t.requestCount=(t.requestCount||0)+1;if(!e.hasAttribute("disabled")){e.setAttribute("disabled","");e.setAttribute("data-disabled-by-htmx","")}});return t}function on(e,t){oe(e.concat(t),function(e){const t=re(e);t.requestCount=(t.requestCount||1)-1});oe(e,function(e){const t=re(e);if(t.requestCount===0){S(e,Y.config.requestClass)}});oe(t,function(e){const t=re(e);if(t.requestCount===0&&e.hasAttribute("data-disabled-by-htmx")){e.removeAttribute("disabled");e.removeAttribute("data-disabled-by-htmx")}})}function sn(t,n){for(let e=0;en.indexOf(e)<0)}else{e=e.filter(e=>e!==n)}r.delete(t);oe(e,e=>r.append(t,e))}}function an(e){if(e instanceof HTMLSelectElement&&e.multiple){return F(e.querySelectorAll("option:checked")).map(function(e){return e.value})}if(e instanceof HTMLInputElement&&e.files){return F(e.files)}return e.value}function fn(t,n,r,e,o){if(e==null||sn(t,e)){return}else{t.push(e)}if(ln(e)){const i=Q(e,"name");cn(i,an(e),n);if(o){hn(e,r)}}if(e instanceof HTMLFormElement){oe(e.elements,function(e){if(t.indexOf(e)>=0){un(e.name,an(e),n)}else{t.push(e)}if(o){hn(e,r)}});new FormData(e).forEach(function(e,t){if(e instanceof File&&e.name===""){return}cn(t,e,n)})}}function hn(e,t){const n=e;if(n.willValidate){ae(n,"htmx:validation:validate");if(!n.checkValidity()){if(ae(n,"htmx:validation:failed",{message:n.validationMessage,validity:n.validity})&&!t.length&&Y.config.reportValidityOfForms){n.reportValidity()}t.push({elt:n,message:n.validationMessage,validity:n.validity})}}}function dn(n,e){for(const t of e.keys()){n.delete(t)}e.forEach(function(e,t){n.append(t,e)});return n}function pn(e,t){const n=[];const r=new FormData;const o=new FormData;const i=[];const s=re(e);if(s.lastButtonClicked&&!ie(s.lastButtonClicked)){s.lastButtonClicked=null}let l=e instanceof HTMLFormElement&&e.noValidate!==true||f(e,"hx-validate")==="true";if(s.lastButtonClicked){l=l&&s.lastButtonClicked.formNoValidate!==true}if(t!=="get"){fn(n,o,i,It(e),l)}fn(n,r,i,e,l);if(s.lastButtonClicked||e.tagName==="BUTTON"||e.tagName==="INPUT"&&Q(e,"type")==="submit"){const u=s.lastButtonClicked||e;const a=Q(u,"name");cn(a,u.value,o)}const c=ve(e,"hx-include");oe(c,function(e){fn(n,r,i,le(e),l);if(!h(e,"form")){oe(p(e).querySelectorAll(it),function(e){fn(n,r,i,e,l)})}});dn(r,o);return{errors:i,formData:r,values:Mn(r)}}function gn(e,t,n){if(e!==""){e+="&"}if(String(n)==="[object Object]"){n=JSON.stringify(n)}const r=encodeURIComponent(n);e+=encodeURIComponent(t)+"="+r;return e}function mn(e){e=Dn(e);let n="";e.forEach(function(e,t){n=gn(n,t,e)});return n}function yn(e,t,n){const r={"HX-Request":"true","HX-Trigger":Q(e,"id"),"HX-Trigger-Name":Q(e,"name"),"HX-Target":f(t,"id"),"HX-Current-URL":location.href};On(e,"hx-headers",false,r);if(n!==undefined){r["HX-Prompt"]=n}if(re(e).boosted){r["HX-Boosted"]="true"}return r}function xn(n,e){const t=te(e,"hx-params");if(t){if(t==="none"){return new FormData}else if(t==="*"){return n}else if(t.indexOf("not ")===0){oe(t.slice(4).split(","),function(e){e=e.trim();n.delete(e)});return n}else{const r=new FormData;oe(t.split(","),function(t){t=t.trim();if(n.has(t)){n.getAll(t).forEach(function(e){r.append(t,e)})}});return r}}else{return n}}function bn(e){return!!Q(e,"href")&&Q(e,"href").indexOf("#")>=0}function vn(e,t){const n=t||te(e,"hx-swap");const r={swapStyle:re(e).boosted?"innerHTML":Y.config.defaultSwapStyle,swapDelay:Y.config.defaultSwapDelay,settleDelay:Y.config.defaultSettleDelay};if(Y.config.scrollIntoViewOnBoost&&re(e).boosted&&!bn(e)){r.show="top"}if(n){const s=X(n);if(s.length>0){for(let e=0;e0?o.join(":"):null;r.scroll=u;r.scrollTarget=i}else if(l.indexOf("show:")===0){const a=l.slice(5);var o=a.split(":");const f=o.pop();var i=o.length>0?o.join(":"):null;r.show=f;r.showTarget=i}else if(l.indexOf("focus-scroll:")===0){const h=l.slice("focus-scroll:".length);r.focusScroll=h=="true"}else if(e==0){r.swapStyle=l}else{T("Unknown modifier in hx-swap: "+l)}}}}return r}function wn(e){return te(e,"hx-encoding")==="multipart/form-data"||h(e,"form")&&Q(e,"enctype")==="multipart/form-data"}function Sn(t,n,r){let o=null;Vt(n,function(e){if(o==null){o=e.encodeParameters(t,r,n)}});if(o!=null){return o}else{if(wn(n)){return dn(new FormData,Dn(r))}else{return mn(r)}}}function En(e){return{tasks:[],elts:[e]}}function Cn(e,t){const n=e[0];const r=e[e.length-1];if(t.scroll){var o=null;if(t.scrollTarget){o=le(ce(n,t.scrollTarget))}if(t.scroll==="top"&&(n||o)){o=o||n;o.scrollTop=0}if(t.scroll==="bottom"&&(r||o)){o=o||r;o.scrollTop=o.scrollHeight}if(typeof t.scroll==="number"){b().setTimeout(function(){window.scrollTo(0,t.scroll)},0)}}if(t.show){var o=null;if(t.showTarget){let e=t.showTarget;if(t.showTarget==="window"){e="body"}o=le(ce(n,e))}if(t.show==="top"&&(n||o)){o=o||n;o.scrollIntoView({block:"start",behavior:Y.config.scrollBehavior})}if(t.show==="bottom"&&(r||o)){o=o||r;o.scrollIntoView({block:"end",behavior:Y.config.scrollBehavior})}}}function On(r,e,o,i,s){if(i==null){i={}}if(r==null){return i}const l=f(r,e);if(l){let e=l.trim();let t=o;if(e==="unset"){return null}if(e.indexOf("javascript:")===0){e=e.slice(11);t=true}else if(e.indexOf("js:")===0){e=e.slice(3);t=true}if(e.indexOf("{")!==0){e="{"+e+"}"}let n;if(t){n=Tn(r,function(){if(s){return Function("event","return ("+e+")").call(r,s)}else{return Function("return ("+e+")").call(r)}},{})}else{n=v(e)}for(const c of Object.keys(n)){if(i[c]==null){i[c]=n[c]}}}return On(le(u(r)),e,o,i,s)}function Tn(e,t,n){if(Y.config.allowEval){return t()}else{ue(e,"htmx:evalDisallowedError");return n}}function Hn(e,t,n){return On(e,"hx-vars",true,n,t)}function Rn(e,t,n){return On(e,"hx-vals",false,n,t)}function qn(e,t){return se(Hn(e,t),Rn(e,t))}function An(t,n,r){if(r!==null){try{t.setRequestHeader(n,r)}catch(e){t.setRequestHeader(n,encodeURIComponent(r));t.setRequestHeader(n+"-URI-AutoEncoded","true")}}}function Nn(t){if(t.responseURL){try{const e=new URL(t.responseURL);return e.pathname+e.search}catch(e){ue(ee().body,"htmx:badResponseUrl",{url:t.responseURL})}}}function H(e,t){return e.getResponseHeader(t)!==null}function In(t,n,r){t=t.toLowerCase();if(r){if(r instanceof Element||typeof r==="string"){return fe(t,n,null,null,{targetOverride:E(r)||be,returnPromise:true})}else{let e=E(r.target);if(r.target&&!e||r.source&&!e&&!E(r.source)){e=be}return fe(t,n,E(r.source),r.event,{handler:r.handler,headers:r.headers,values:r.values,targetOverride:e,swapOverride:r.swap,select:r.select,returnPromise:true,push:r.push,replace:r.replace,selectOOB:r.selectOOB})}}else{return fe(t,n,null,null,{returnPromise:true})}}function Ln(e){const t=[];while(e){t.push(e);e=e.parentElement}return t}function kn(e,t,n){const r=new URL(t,location.protocol!=="about:"?location.href:window.origin);const o=location.protocol!=="about:"?location.origin:window.origin;const i=o===r.origin;if(Y.config.selfRequestsOnly){if(!i){return false}}return ae(e,"htmx:validateUrl",se({url:r,sameHost:i},n))}function Dn(e){if(e instanceof FormData)return e;const t=new FormData;for(const n of Object.keys(e)){if(e[n]&&typeof e[n].forEach==="function"){e[n].forEach(function(e){t.append(n,e)})}else if(typeof e[n]==="object"&&!(e[n]instanceof Blob)){t.append(n,JSON.stringify(e[n]))}else{t.append(n,e[n])}}return t}function Pn(r,o,e){return new Proxy(e,{get:function(t,e){if(typeof e==="number")return t[e];if(e==="length")return t.length;if(e==="push"){return function(e){t.push(e);r.append(o,e)}}if(typeof t[e]==="function"){return function(){t[e].apply(t,arguments);r.delete(o);t.forEach(function(e){r.append(o,e)})}}if(t[e]&&t[e].length===1){return t[e][0]}else{return t[e]}},set:function(e,t,n){e[t]=n;r.delete(o);e.forEach(function(e){r.append(o,e)});return true}})}function Mn(o){return new Proxy(o,{get:function(e,t){if(typeof t==="symbol"){const r=Reflect.get(e,t);if(typeof r==="function"){return function(){return r.apply(o,arguments)}}else{return r}}if(t==="toJSON"){return()=>Object.fromEntries(o)}if(t in e){if(typeof e[t]==="function"){return function(){return o[t].apply(o,arguments)}}}const n=o.getAll(t);if(n.length===0){return undefined}else if(n.length===1){return n[0]}else{return Pn(e,t,n)}},set:function(t,n,e){if(typeof n!=="string"){return false}t.delete(n);if(e&&typeof e.forEach==="function"){e.forEach(function(e){t.append(n,e)})}else if(typeof e==="object"&&!(e instanceof Blob)){t.append(n,JSON.stringify(e))}else{t.append(n,e)}return true},deleteProperty:function(e,t){if(typeof t==="string"){e.delete(t)}return true},ownKeys:function(e){return Reflect.ownKeys(Object.fromEntries(e))},getOwnPropertyDescriptor:function(e,t){return Reflect.getOwnPropertyDescriptor(Object.fromEntries(e),t)}})}function fe(t,n,r,o,i,P){let s=null;let l=null;i=i!=null?i:{};if(i.returnPromise&&typeof Promise!=="undefined"){var e=new Promise(function(e,t){s=e;l=t})}if(r==null){r=ee().body}const M=i.handler||Vn;const F=i.select||null;if(!ie(r)){ne(s);return e}const c=i.targetOverride||le(Se(r));if(c==null||c==be){ue(r,"htmx:targetError",{target:te(r,"hx-target")});ne(l);return e}let u=re(r);const a=u.lastButtonClicked;if(a){const A=Q(a,"formaction");if(A!=null){n=A}const N=Q(a,"formmethod");if(N!=null){if(he.includes(N.toLowerCase())){t=N}else{ne(s);return e}}}const f=te(r,"hx-confirm");if(P===undefined){const K=function(e){return fe(t,n,r,o,i,!!e)};const G={target:c,elt:r,path:n,verb:t,triggeringEvent:o,etc:i,issueRequest:K,question:f};if(ae(r,"htmx:confirm",G)===false){ne(s);return e}}let h=r;let d=te(r,"hx-sync");let p=null;let B=false;if(d){const I=d.split(":");const L=I[0].trim();if(L==="this"){h=we(r,"hx-sync")}else{h=le(ce(r,L))}d=(I[1]||"drop").trim();u=re(h);if(d==="drop"&&u.xhr&&u.abortable!==true){ne(s);return e}else if(d==="abort"){if(u.xhr){ne(s);return e}else{B=true}}else if(d==="replace"){ae(h,"htmx:abort")}else if(d.indexOf("queue")===0){const W=d.split(" ");p=(W[1]||"last").trim()}}if(u.xhr){if(u.abortable){ae(h,"htmx:abort")}else{if(p==null){if(o){const k=re(o);if(k&&k.triggerSpec&&k.triggerSpec.queue){p=k.triggerSpec.queue}}if(p==null){p="last"}}if(u.queuedRequests==null){u.queuedRequests=[]}if(p==="first"&&u.queuedRequests.length===0){u.queuedRequests.push(function(){fe(t,n,r,o,i)})}else if(p==="all"){u.queuedRequests.push(function(){fe(t,n,r,o,i)})}else if(p==="last"){u.queuedRequests=[];u.queuedRequests.push(function(){fe(t,n,r,o,i)})}ne(s);return e}}const g=new XMLHttpRequest;u.xhr=g;u.abortable=B;const m=function(){u.xhr=null;u.abortable=false;if(u.queuedRequests!=null&&u.queuedRequests.length>0){const e=u.queuedRequests.shift();e()}};const X=te(r,"hx-prompt");if(X){var y=prompt(X);if(y===null||!ae(r,"htmx:prompt",{prompt:y,target:c})){ne(s);m();return e}}if(f&&!P){if(!confirm(f)){ne(s);m();return e}}let x=yn(r,c,y);if(t!=="get"&&!wn(r)){x["Content-Type"]="application/x-www-form-urlencoded"}if(i.headers){x=se(x,i.headers)}const U=pn(r,t);let b=U.errors;const j=U.formData;if(i.values){dn(j,Dn(i.values))}const V=Dn(qn(r,o));const v=dn(j,V);let w=xn(v,r);if(Y.config.getCacheBusterParam&&t==="get"){w.set("org.htmx.cache-buster",Q(c,"id")||"true")}if(n==null||n===""){n=location.href}const S=On(r,"hx-request");const $=re(r).boosted;let E=Y.config.methodsThatUseUrlParams.indexOf(t)>=0;const C={boosted:$,useUrlParams:E,formData:w,parameters:Mn(w),unfilteredFormData:v,unfilteredParameters:Mn(v),headers:x,elt:r,target:c,verb:t,errors:b,withCredentials:i.credentials||S.credentials||Y.config.withCredentials,timeout:i.timeout||S.timeout||Y.config.timeout,path:n,triggeringEvent:o};if(!ae(r,"htmx:configRequest",C)){ne(s);m();return e}n=C.path;t=C.verb;x=C.headers;w=Dn(C.parameters);b=C.errors;E=C.useUrlParams;if(b&&b.length>0){ae(r,"htmx:validation:halted",C);ne(s);m();return e}const _=n.split("#");const z=_[0];const O=_[1];let T=n;if(E){T=z;const Z=!w.keys().next().done;if(Z){if(T.indexOf("?")<0){T+="?"}else{T+="&"}T+=mn(w);if(O){T+="#"+O}}}if(!kn(r,T,C)){ue(r,"htmx:invalidPath",C);ne(l);m();return e}g.open(t.toUpperCase(),T,true);g.overrideMimeType("text/html");g.withCredentials=C.withCredentials;g.timeout=C.timeout;if(S.noHeaders){}else{for(const D of Object.keys(x)){An(g,D,x[D])}}const H={xhr:g,target:c,requestConfig:C,etc:i,boosted:$,select:F,pathInfo:{requestPath:n,finalRequestPath:T,responsePath:null,anchor:O}};g.onload=function(){try{const t=Ln(r);H.pathInfo.responsePath=Nn(g);M(r,H);if(H.keepIndicators!==true){on(R,q)}ae(r,"htmx:afterRequest",H);ae(r,"htmx:afterOnLoad",H);if(!ie(r)){let e=null;while(t.length>0&&e==null){const n=t.shift();if(ie(n)){e=n}}if(e){ae(e,"htmx:afterRequest",H);ae(e,"htmx:afterOnLoad",H)}}ne(s)}catch(e){ue(r,"htmx:onLoadError",se({error:e},H));throw e}finally{m()}};g.onerror=function(){on(R,q);ue(r,"htmx:afterRequest",H);ue(r,"htmx:sendError",H);ne(l);m()};g.onabort=function(){on(R,q);ue(r,"htmx:afterRequest",H);ue(r,"htmx:sendAbort",H);ne(l);m()};g.ontimeout=function(){on(R,q);ue(r,"htmx:afterRequest",H);ue(r,"htmx:timeout",H);ne(l);m()};if(!ae(r,"htmx:beforeRequest",H)){ne(s);m();return e}var R=nn(r);var q=rn(r);oe(["loadstart","loadend","progress","abort"],function(t){oe([g,g.upload],function(e){e.addEventListener(t,function(e){ae(r,"htmx:xhr:"+t,{lengthComputable:e.lengthComputable,loaded:e.loaded,total:e.total})})})});ae(r,"htmx:beforeSend",H);const J=E?null:Sn(g,r,w);g.send(J);return e}function Fn(e,t){const n=t.xhr;let r=null;let o=null;if(H(n,"HX-Push")){r=n.getResponseHeader("HX-Push");o="push"}else if(H(n,"HX-Push-Url")){r=n.getResponseHeader("HX-Push-Url");o="push"}else if(H(n,"HX-Replace-Url")){r=n.getResponseHeader("HX-Replace-Url");o="replace"}if(r){if(r==="false"){return{}}else{return{type:o,path:r}}}const i=t.pathInfo.finalRequestPath;const s=t.pathInfo.responsePath;const l=t.etc.push||te(e,"hx-push-url");let c=t.etc.replace||te(e,"hx-replace-url");if(c==="false")c=null;const u=re(e).boosted;let a=null;let f=null;if(l){a="push";f=l}else if(c){a="replace";f=c}else if(u){a="push";f=s||i}if(f){if(f==="false"){return{}}if(f==="true"){f=s||i}if(t.pathInfo.anchor&&f.indexOf("#")===-1){f=f+"#"+t.pathInfo.anchor}return{type:a,path:f}}else{return{}}}function Bn(e,t){var n=new RegExp(e.code);return n.test(t.toString(10))}function Xn(e){for(var t=0;t`+`.${t}{opacity:0;visibility: hidden} `+`.${n} .${t}, .${n}.${t}{opacity:1;visibility: visible;transition: opacity 200ms ease-in}`+"")}}function Yn(){const e=ee().querySelector('meta[name="htmx-config"]');if(e){return v(e.content)}else{return null}}function Qn(){const e=Yn();if(e){Y.config=se(Y.config,e)}}Wn(function(){Qn();Zn();let e=ee().body;Bt(e);const t=ee().querySelectorAll("[hx-trigger='restored'],[data-hx-trigger='restored']");e.addEventListener("htmx:abort",function(e){const t=e.detail.elt||e.target;const n=re(t);if(n&&n.xhr){n.xhr.abort()}});const n=window.onpopstate?window.onpopstate.bind(window):null;window.onpopstate=function(e){if(e.state&&e.state.htmx){tn();oe(t,function(e){ae(e,"htmx:restored",{document:ee(),triggerEvent:ae})})}else{if(n){n(e)}}};b().setTimeout(function(){ae(e,"htmx:load",{});e=null},0)});return Y}(); \ No newline at end of file diff --git a/src/site_engine/web/admin/static/pages.css b/src/site_engine/web/admin/static/pages.css new file mode 100644 index 0000000..f16a3ff --- /dev/null +++ b/src/site_engine/web/admin/static/pages.css @@ -0,0 +1,32 @@ +/* Semantic HTML/htmx adapters. All visual components come from antirion-rework.css. */ +.design-content a { color: inherit; text-decoration: none; } +.design-content a:focus-visible { outline: 2px solid var(--focus); outline-offset: 2px; } +.design-content .btn.primary { color: var(--paper); } +.design-content .activity { cursor: pointer; } +.design-content .ribbon .release-number { font-size: 25px; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } +.design-content .overview-live .buildid { overflow-wrap: anywhere; } +.design-content .overview-note { margin-top: 17px; } +.design-content .page-error { border-left-color: var(--error); color: var(--error); } +/* Original tabs are buttons; anchors retain the same geometry and keyboard navigation. */ +.design-content .tabs a { border: 0; background: transparent; padding: 12px 0; color: var(--secondary); font-size: 11px; position: relative; } +.design-content .tabs a[aria-selected='true'] { color: var(--ink); font-weight: 710; } +.design-content .tabs a[aria-selected='true']:after { content: ''; position: absolute; bottom: 0; left: 0; right: 0; height: 2px; background: var(--ink); } +.design-content col.col-name { width: 37%; } +.design-content col.col-url, .design-content col.col-layout { width: 16%; } +.design-content col.col-status { width: 17%; } +.design-content col.col-updates { width: 14%; } +.design-content .labelname a { display: block; } +.design-content .inspector-route { font-size: 10px; } +.design-content .mini-preview-label { margin-bottom: 9px; } +.design-content .mini-route { float: right; } +.design-content .inspector-properties-label { margin-top: 21px; margin-bottom: 8px; } +.design-content .browser.mobile { max-width: 155px; margin: auto; min-height: 170px; } +.design-content .copyline b { text-align: right; min-width: 0; overflow-wrap: anywhere; } +.design-content .shell-dialog .dialog-actions { margin: 0; } +.design-content .toast { z-index: 200; } +.design-content [hidden] { display: none !important; } +@media(max-width:420px) { + .design-content .data-table col.col-name { width: 56%; } + .design-content .data-table col.col-url { width: 25%; } + .design-content .data-table col.col-status { width: 19%; } +} diff --git a/src/site_engine/web/admin/static/pages.js b/src/site_engine/web/admin/static/pages.js new file mode 100644 index 0000000..090fca2 --- /dev/null +++ b/src/site_engine/web/admin/static/pages.js @@ -0,0 +1,38 @@ +/* Page-list interactions mirror the Antirion prototype; content stays server-owned. */ +(() => { + if (window.sitePagesLoaded) return; + window.sitePagesLoaded = true; + let device = 'desktop'; + function initialize() { + const result = document.getElementById('pages-results'), form = document.getElementById('page-filters'); + if (result && form) { + for (const key of ['selected','status','changed']) form.elements[key].value = result.dataset[key]; + const reset = document.querySelector('[data-reset-pages]'); + if (reset) { + const url = '/admin/pages?selected=' + encodeURIComponent(result.dataset.selected); + if (reset.getAttribute('hx-get') !== url) { + reset.href = url; + reset.setAttribute('hx-get',url); + window.htmx?.process(reset); + } + } + } + document.querySelector('[data-page-browser]')?.classList.toggle('mobile', device === 'mobile'); + document.querySelectorAll('[data-page-device]').forEach(button => { const active = button.dataset.pageDevice === device; button.classList.toggle('active',active); button.setAttribute('aria-pressed',String(active)); }); + document.querySelectorAll('dialog[data-auto-open]').forEach(dialog => { dialog.removeAttribute('data-auto-open'); dialog.close(); dialog.showModal(); }); + document.querySelectorAll('[data-page-toast]').forEach(toast => setTimeout(() => toast.remove(),3500)); + } + function selectRow(row) { row.querySelector('[data-select-page]')?.click(); } + document.addEventListener('click', event => { + const row = event.target.closest('#pageRows tr[data-page]'); + if (row && !event.target.closest('a,button,input,select')) selectRow(row); + const button = event.target.closest('[data-page-device]'); + if (button) { device = button.dataset.pageDevice; initialize(); } + }); + document.addEventListener('keydown', event => { + const row = event.target.closest('#pageRows tr[data-page]'); + if (row && (event.key === 'Enter' || event.key === ' ')) { event.preventDefault(); selectRow(row); } + }); + document.addEventListener('htmx:load', initialize); + initialize(); +})(); diff --git a/src/site_engine/web/admin/static/preview.css b/src/site_engine/web/admin/static/preview.css new file mode 100644 index 0000000..c98e88b --- /dev/null +++ b/src/site_engine/web/admin/static/preview.css @@ -0,0 +1,6 @@ +/* Selection treatment from design/assets/builder.js, isolated to preview markers. */ +:where([data-preview-id]){position:relative} +[data-preview-id]{cursor:pointer;outline-offset:-3px} +[data-preview-id]:hover{outline:2px dashed #a085ed} +[data-preview-selected='true']{outline:3px solid #9a6cfa!important;outline-offset:-3px} +[data-preview-selected='true']::after{content:'SELECTED';position:absolute;top:0;right:0;background:#925de0;color:white;font:10px monospace;padding:4px 8px;z-index:2;pointer-events:none} diff --git a/src/site_engine/web/admin/static/preview.js b/src/site_engine/web/admin/static/preview.js new file mode 100644 index 0000000..3f0778e --- /dev/null +++ b/src/site_engine/web/admin/static/preview.js @@ -0,0 +1,39 @@ +(() => { + 'use strict'; + const cfg = __CONFIG__; + let chosen = null; + const key = el => ({scope: el.dataset.previewScope, owner: el.dataset.previewOwner, id: el.dataset.previewId}); + const same = (a, b) => a && b && a.scope === b.scope && a.owner === b.owner && a.id === b.id; + const send = (type, extra = {}) => parent.postMessage({type, snapshot: cfg.snapshot, revision: cfg.revision, ...extra}, cfg.origin); + const roots = () => Array.from(document.querySelectorAll('[data-preview-id]')); + function select(block, scroll) { + chosen = block; + roots().forEach(el => {el.toggleAttribute('data-preview-selected', false);if(same(key(el), block))el.setAttribute('data-preview-selected','true');}); + const el = roots().find(e => same(key(e), block)); + if (el && scroll) { + const r = el.getBoundingClientRect(); + if (r.top < 0 || r.bottom > innerHeight) el.scrollIntoView({block: 'nearest', behavior: 'instant'}); + } + } + addEventListener('click', event => { + if (event.target.closest('a,button,input,select,textarea')) event.preventDefault(); + const el = event.target.closest('[data-preview-id]'); + if (!el) return; + event.preventDefault(); event.stopPropagation(); + select(key(el), false); send('preview:select', {block: key(el)}); + }, true); + addEventListener('submit', event => event.preventDefault(), true); + addEventListener('scroll', () => send('preview:viewport', {x: scrollX, y: scrollY}), {passive:true}); + addEventListener('message', event => { + const m = event.data; + if (event.origin !== cfg.origin || event.source !== parent || !m || m.snapshot !== cfg.snapshot || m.revision !== cfg.revision) return; + if (m.type === 'editor:select' && m.block && roots().some(e => same(key(e), m.block))) select(m.block, m.scroll === true); + if (m.type === 'editor:restore' && Number.isFinite(m.x) && Number.isFinite(m.y)) scrollTo({left:Math.max(0,m.x), top:Math.max(0,m.y), behavior:'instant'}); + }); + const images = Array.from(document.images).map(img => img.complete ? Promise.resolve() : new Promise(resolve => { + img.addEventListener('load', resolve, {once:true}); img.addEventListener('error', resolve, {once:true}); + })); + Promise.all([...images, document.fonts?.ready || Promise.resolve()]).then(() => { + requestAnimationFrame(() => send('preview:ready', {blocks: roots().map(key)})); + }); +})(); diff --git a/src/site_engine/web/admin/static/shell.css b/src/site_engine/web/admin/static/shell.css new file mode 100644 index 0000000..8a5c971 --- /dev/null +++ b/src/site_engine/web/admin/static/shell.css @@ -0,0 +1,37 @@ +/* HTML/htmx and accessibility adapters for the unmodified Antirion Rework CSS. + * Geometry, typography, colours and breakpoints belong to antirion-rework.css. */ +.sidebar a { text-decoration: none; } +.sidebar .brand { color: inherit; } +.sidebar a:focus-visible, .shell-dialog a:focus-visible { outline: 2px solid var(--focus); outline-offset: 2px; } +.sidebar .brand-copy { min-width: 0; } +.sitelabel span { min-width: 0; } +.sitelabel b, .sitelabel small { overflow-wrap: anywhere; } +.side-footer .hide-when-narrow { font: 10px monospace; color: #888; } +.cover { border: 0; padding: 0; } +.crumb > span:first-child { overflow: hidden; text-overflow: ellipsis; } +.crumb-separator { opacity: .35; } +.live-pip .mono { font-weight: 400; max-width: 150px; overflow: hidden; text-overflow: ellipsis; } +.live-pip.no-release:before { background: var(--dim); } +.sidebar .nav-item:disabled { opacity: 1; color: #707478; } +.sidebar .nav-item:disabled:hover { background: none; color: #707478; } +.visually-hidden { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); white-space: nowrap; } +.shell-dialog:not([open]) { display: none; } +.shell-dialog[open] { display: flex; } +.shell-dialog { padding: 0; border-radius: 0; } +.shell-dialog::backdrop { background: rgba(10,10,14,.58); } +.shell-dialog.command-pop { width: min(570px,calc(100% - 32px)); } +.shell-dialog .field { line-height: normal; } +.shell-dialog .cmd-list a { width: 100%; display: flex; gap: 12px; align-items: center; text-align: left; height: 39px; background: none; border: 0; border-bottom: 1px solid var(--stroke2); color: var(--ink); padding: 0 7px; font-size: 11px; text-decoration: none; } +.shell-dialog .cmd-list a:hover { background: var(--paper3); } +.shell-dialog .cmd-list a > span { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; } +.shell-dialog .cmd-list a small { color: var(--secondary); margin-left: auto; white-space: nowrap; } +.shell-dialog [hidden] { display: none !important; } +/* Native dialog supplies modal focus/semantics; dimensions and contents match the design. */ +.shell-dialog header .header-btn { flex: none; } +/* Runtime build IDs are timestamp/hash values, longer than the mock's r00027. */ +@media(max-width:900px) { .live-pip .mono { max-width: 70px; } } +@media(max-width:760px) { + .sidebar:not(.open) { visibility: hidden; } + .crumb { flex: 1; } + .shell-dialog { max-width: calc(100% - 32px); } +} diff --git a/src/site_engine/web/admin/templates/_builder_fields.html.j2 b/src/site_engine/web/admin/templates/_builder_fields.html.j2 new file mode 100644 index 0000000..e400116 --- /dev/null +++ b/src/site_engine/web/admin/templates/_builder_fields.html.j2 @@ -0,0 +1,19 @@ +{% from '_fields.html.j2' import field as complex_field, datalist %} +{% from '_builder_icons.html.j2' import bi %} +{% macro bf(f) %} +{% if f.kind in ['group','list','link','query','multiselect'] %} +
    {{ complex_field(f) }}
    +{% else %} +
    + + {% if f.type in ['asset','ref','refs'] %}{% endif %} + + + {{ datalist(f) }}{{ f.hint or ('Источник: ' + f.bind if f.bind else 'Хранится в props блока') }} +
    +{% endif %} +{% endmacro %} diff --git a/src/site_engine/web/admin/templates/_builder_icons.html.j2 b/src/site_engine/web/admin/templates/_builder_icons.html.j2 new file mode 100644 index 0000000..a502fc2 --- /dev/null +++ b/src/site_engine/web/admin/templates/_builder_icons.html.j2 @@ -0,0 +1 @@ +{% macro bi(name) -%}{% set paths = {"pages": "M7 3h10l4 4v14H7z M17 3v5h4 M11 13h6 M11 17h6", "home": "M3 10 12 3l9 7v11H3z M9 21v-8h6v8", "content": "M12 3 2 8l10 5 10-5-10-5 M2 13l10 5 10-5", "publish": "M12 3v13 M7 11l5 5 5-5 M4 18v3h16v-3", "image": "M3 3h18v18H3z M7 16l4-4 4 4 2-2 4 4 M8 8h.1", "layers": "M3 7l9-4 9 4-9 5-9-5 M3 13l9 5 9-5", "setting": "M4 7h16 M4 12h16 M4 17h16", "clock": "M12 3a9 9 0 1 0 0 18a9 9 0 0 0 0-18z M12 7v5l3 2", "code": "M9 7l-5 5 5 5 M15 7l5 5-5 5", "blocks": "M3 3h7v7H3z M14 3h7v7h-7z M3 14h7v7H3z M14 14h7v7h-7z", "plus": "M12 4v16 M4 12h16", "chevron": "M9 5l7 7-7 7", "up": "M12 20V4 M5 11l7-7 7 7", "down": "M12 4v16 M5 13l7 7 7-7", "trash": "M5 7h14 M8 7V4h8v3 M7 7l1 14h8l1-14", "copy": "M8 8h12v12H8z M4 16H3V3h13v1", "eye": "M2 12s3.5-6 10-6 10 6 10 6-3.5 6-10 6-10-6-10-6z M12 9a3 3 0 1 0 0 6a3 3 0 0 0 0-6z", "hide": "M3 3l18 18 M2 12s3.5-6 10-6c6.5 0 10 6 10 6a17 17 0 0 1-3 3.7 M6.2 6.8C3.5 8.4 2 12 2 12s3.5 6 10 6c1.9 0 3.5-.5 4.8-1.2", "check": "M4 12l5 5L20 6", "alert": "M12 3 2 21h20z M12 9v5 M12 17v1", "monitor": "M3 4h18v14H3z M8 21h8", "tablet": "M6 2h12v20H6z", "phone": "M8 2h8v20H8z", "menu": "M3 7h18 M3 12h18 M3 17h18", "link": "M10 13a5 5 0 0 0 7 0l3-3a5 5 0 0 0-7-7l-2 2 M14 11a5 5 0 0 0-7 0l-3 3a5 5 0 0 0 7 7l2-2", "save": "M4 3h14l3 3v15H3V3z M7 3v7h10V3 M7 21v-8h10v8", "filter": "M3 4h18l-7 9v7l-4 2v-9z", "search": "M10 3a7 7 0 1 0 0 14a7 7 0 0 0 0-14z M15.5 15.5 21 21", "arrow": "M4 12h16m-6-6 6 6-6 6", "close": "M5 5l14 14 M19 5 5 19", "lock": "M6 10V7a6 6 0 0 1 12 0v3 M5 10h14v11H5z", "refresh": "M20 7V3h-4 M4 17v4h4 M20 11a8 8 0 0 0-14-5l-2 2 M4 13a8 8 0 0 0 14 5l2-2", "more": "M4 12h2 M11 12h2 M18 12h2"} %}{%- endmacro %} diff --git a/src/site_engine/web/admin/templates/_builder_inspector.html.j2 b/src/site_engine/web/admin/templates/_builder_inspector.html.j2 new file mode 100644 index 0000000..fb60707 --- /dev/null +++ b/src/site_engine/web/admin/templates/_builder_inspector.html.j2 @@ -0,0 +1,31 @@ +{% from '_builder_icons.html.j2' import bi %} +{% from '_builder_fields.html.j2' import bf %} +{% macro state() %}{% endmacro %} +
    +
    ИнспекторПревью и проверки
    Схема полей Fragment
    {{ bi('setting') }}
    +
    {% for key, label in [('props','Свойства'),('bindings','Связи'),('page','Страница')] %}{% endfor %}
    +
    + {% if saved %}

    Документ сохранён. Публикация не выполнялась.

    {% endif %} + {% if errors %}{% endif %} + {% if snap.issues and not errors %}
      {% for i in snap.issues %}
    • {{ i.code }} {{ i.path }}: {{ i.message }}
    • {% endfor %}
    {% elif not errors %}
    Структура документа проверена сервером.
    {% endif %} + {% if not snap.model %}

    Исправьте исходник в «Эксперте». Последнее корректное дерево доступно для просмотра.

    {% endif %} +
    + {% if readonly_selected %}

    {{ readonly_selected.fragment }}

    {{ readonly_selected.id }}
    {{ bi('lock') }} Fixed
    Только чтение · {{ readonly_selected.scope }} / {{ readonly_selected.owner }}. Блок определяется шаблоном и защищён от перемещения и удаления.
    Props
    {{ readonly_selected.get('props', {})|tojson(indent=2) }}
    + {% elif selected %} +

    {{ snap.schema.fragments.get(selected.fragment, {}).get('name', selected.fragment) }}

    {{ selected.id }} / {{ selected.fragment }}
    {{ 'Скрыт' if selected.hidden else 'Виден' }}
    +
    {{ state() }} + {% for f in fields %}{{ bf(f) }}{% endfor %}
    + {% if snap.schema.features %}
    Условия отображения
    {% for k, enabled in snap.schema.features.items() %}{% endfor %}{% endif %} + +
    +
    Управление блоком
    {{ state() }}
    +
    {{ state() }}
    + {% else %}
    Выберите блок в дереве
    {% endif %}
    + +

    Свойства страницы

    {{ snap.path }}
    Изменения — в текущей редакции этой вкладки. Сохранить ≠ опубликовать.
    +
    {{ state() }} +
    SEO Search preview
    {{ page_route }}
    {{ seo.get('title') or meta.get('title') or snap.id }}
    {{ seo.get('description') or 'Описание страницы пока не заполнено.' }}
    Markdown body pages/*.md
    +
    +
    Файл {{ snap.path }}
    Layout {{ snap.schema.layout }}
    Статус {{ meta.get('status', 'draft') }}
    Блоков {{ blocks|length }}
    Сохранение исходника

    Запись файла выполняется отдельно. Переключение режима не переформатирует исходник. Структурные правки Конструктора пересобирают YAML.

    +
    Сохранение файла — отдельным действиемschema v1
    +
    diff --git a/src/site_engine/web/admin/templates/_fields.html.j2 b/src/site_engine/web/admin/templates/_fields.html.j2 index 4115706..93e7bff 100644 --- a/src/site_engine/web/admin/templates/_fields.html.j2 +++ b/src/site_engine/web/admin/templates/_fields.html.j2 @@ -2,7 +2,7 @@ {% macro bind_box(name, bind) %}
    привязка - +
    {% endmacro %} @@ -37,11 +37,11 @@ diff --git a/src/site_engine/web/admin/templates/_icons.html.j2 b/src/site_engine/web/admin/templates/_icons.html.j2 new file mode 100644 index 0000000..15c2867 --- /dev/null +++ b/src/site_engine/web/admin/templates/_icons.html.j2 @@ -0,0 +1,36 @@ +{% macro icon(name) -%} +{% set paths = { +'overview': 'M3 3h7v7H3zM14 3h7v7h-7zM3 14h7v7H3zM14 14h7v7h-7z', +'pages': 'M7 3h10l4 4v14H7z M17 3v5h4 M11 13h6 M11 17h6 M3 7v14', +'content': 'M12 2 3 7l9 5 9-5-9-5z M3 12l9 5 9-5 M3 17l9 5 9-5', +'publish': 'M12 3v13m-5-5 5 5 5-5 M4 17v4h16v-4', +'media': 'M3 3h18v18H3z M8 10a2 2 0 1 0 0-4a2 2 0 0 0 0 4z M3 19l7-7 4 4 3-3 4 4', +'structure': 'M9 2h6v5H9z M2 17h6v5H2z M16 17h6v5h-6z M12 7v5 M5 17v-5h14v5', +'forms': 'M4 3h16v18H4z M8 9h8 M8 13h8 M8 17h5', +'settings': 'M4 6h16 M4 12h16 M4 18h16 M9 4v4 M15 10v4 M11 16v4', +'journal': 'M4 3h16v18H4z M9 8h7 M9 12h7 M9 16h7', +'search': 'M11 3a8 8 0 1 0 0 16a8 8 0 0 0 0-16z M17 17l4 4', +'theme': 'M20 14.5A8.5 8.5 0 0 1 9.5 4a8.5 8.5 0 1 0 10.5 10.5z', +'arrow': 'M4 12h16m-6-6 6 6-6 6', +'chevron': 'M9 5l7 7-7 7', +'plus': 'M12 4v16 M4 12h16', +'file': 'M6 2h9l5 5v15H6z M15 2v5h5 M10 13h7 M10 17h7', +'globe': 'M12 2a10 10 0 1 0 0 20a10 10 0 0 0 0-20z M2 12h20 M12 2c-4 4-4 16 0 20 M12 2c4 4 4 16 0 20', +'clock': 'M12 2a10 10 0 1 0 0 20a10 10 0 0 0 0-20z M12 7v6l4 2', +'menu': 'M3 6h18 M3 12h18 M3 18h18', +'close': 'M5 5l14 14 M19 5 5 19', +'monitor': 'M3 4h18v13H3z M8 21h8m-4-4v4', +'phone': 'M7 2h10v20H7z M11 19h2', +'check': 'M4 12l5 5L20 6', +'alert': 'M12 2 2 21h20L12 2z M12 9v5 M12 17v1', +'copy': 'M8 8h13v13H8z M3 3h13v4 M3 3v13h4', +'trash': 'M4 7h16 M8 7V4h8v3 M6 7l1 14h10l1-14 M10 11v7m4-7v7', +'layers': 'M3 7l9-4 9 4-9 5-9-5 M3 13l9 5 9-5', +'dots': 'M4 12h2 M11 12h2 M18 12h2', +'code': 'M8 7l-5 5 5 5 M16 7l5 5-5 5', +'filter': 'M3 4h18l-7 9v7l-4 2v-9L3 4', +'pause': 'M7 4v16 M17 4v16', +'help': 'M9 9a3 3 0 1 1 5 2c-2 1-2 3-2 3 M12 18v1' +} %} + +{%- endmacro %} diff --git a/src/site_engine/web/admin/templates/_workspace.html.j2 b/src/site_engine/web/admin/templates/_workspace.html.j2 new file mode 100644 index 0000000..8334484 --- /dev/null +++ b/src/site_engine/web/admin/templates/_workspace.html.j2 @@ -0,0 +1,9 @@ +{% macro status(value) -%}{{ {'published':'В каталоге','draft':'Черновик','archived':'Архив'}.get(value, value) }}{%- endmacro %} +{% macro ribbon(counts, release, comparison_available) %} +
    +
    Страницы
    {{ '%02d'|format(counts.all) }}
    Всего в workspace
    +
    Правки
    {{ '%02d'|format(counts.changed) if comparison_available else '—' }}
    {{ 'Отличаются от live' if release.get('current') else 'До первой публикации' }}
    +
    Черновики
    {{ '%02d'|format(counts.draft) }}
    Пока не готовы
    +
    Активный релиз
    {{ release.get('current') or '—' }}
    {{ 'Неизменяемый снимок' if release.get('current') else 'Пока нет публикаций' }}
    +
    +{% endmacro %} diff --git a/src/site_engine/web/admin/templates/base.html.j2 b/src/site_engine/web/admin/templates/base.html.j2 index 6df5314..d5d570e 100644 --- a/src/site_engine/web/admin/templates/base.html.j2 +++ b/src/site_engine/web/admin/templates/base.html.j2 @@ -4,11 +4,21 @@ + {% block title %}Админка{% endblock %} - + + + + + + - + {% block body %}{% endblock %} {% block scripts %}{% endblock %} + + + + diff --git a/src/site_engine/web/admin/templates/builder_result.html.j2 b/src/site_engine/web/admin/templates/builder_result.html.j2 new file mode 100644 index 0000000..ef82a13 --- /dev/null +++ b/src/site_engine/web/admin/templates/builder_result.html.j2 @@ -0,0 +1,37 @@ +{% from '_builder_icons.html.j2' import bi %} +{% from '_builder_fields.html.j2' import bf %} +{% macro state() %}{% endmacro %} +{% macro select_block(b, locked=false) %} +
    {{ state() }} + +
    +{% endmacro %} +
    + +
    +
    +
    Структура страницы
    {{ blocks|length }} блоков · {{ snap.schema.layout }}
    +
    Файлы сайта
    Page / Layout / Fragment
    {{ bi('code') }}
    +
    +
    +
    Layout / {{ snap.schema.layout }}
    {{ bi('layers') }}{{ snap.schema.layout }}.htmlРегионы: {{ snap.schema.regions.keys()|join(' / ') }}
    + {% for g in tree_groups %}
    {{ g.name }}{% if g.editable %}{% else %}Fixed{% endif %}
    + {% for b in g.fixed %}{{ select_block(b, true) }}{% endfor %} + {% for b in g.blocks %}{{ select_block(b) }}{% endfor %} + {% if g.editable %}
    {% endif %} + {% endfor %} +
    + +
    Pages
    {% for p in page_options %}{{ bi('code') }}{{ p.id }}.md{{ p.title }}{% endfor %}
    Layout · только чтение
    {{ bi('lock') }}{{ snap.schema.layout }}
    Fragments · схема
    {% for fid in snap.schema.fragments %}
    {{ bi('blocks') }}{{ fid }}
    {% endfor %}
    +
    Fixed-блоки защищены от изменений{{ bi('lock') }}
    +
    +{% include '_builder_inspector.html.j2' %} +{% for view in inspector_views %}{% endfor %}
    +{% if conflict %}{% endif %} + +
    diff --git a/src/site_engine/web/admin/templates/dashboard.html.j2 b/src/site_engine/web/admin/templates/dashboard.html.j2 index 39c0e02..d699cd0 100644 --- a/src/site_engine/web/admin/templates/dashboard.html.j2 +++ b/src/site_engine/web/admin/templates/dashboard.html.j2 @@ -1,34 +1,24 @@ {% extends 'shell.html.j2' %} +{% from '_workspace.html.j2' import ribbon, status %} {% block title %}Обзор — админка{% endblock %} +{% block contentclass %}design-content{% endblock %} {% block content %} -

    Каталог сайта: {{ paths.site }} · публикация: {{ paths.dist }} · состояние: {{ paths.state }}

    - {% if site_error %} - - {% else %} -

    {{ site_name }}

    -

    - Страниц: {{ pages|length }} · ошибок проверки: {{ errors }} · предупреждений: {{ warnings }} -

    -

    Страницы

    - - - - {% for p in pages %} - - - - - - {% endfor %} - -
    СтраницаАдресСтатус
    {{ p.title }}{{ p.route }}{{ p.status }}
    -

    Коллекции

    -
      - {% for c in collections %} -
    • {{ c.name }}: опубликовано {{ c.published }} из {{ c.total }}
    • - {% else %} -
    • Коллекций нет
    • - {% endfor %} -
    +
    +
    01 / CONTROL CENTER

    Состояние сайта

    Главное о текущем workspace и опубликованной версии.

    + {% if site_error %}{% else %} +
    +
    STATUS / LIVE SITE
    Сайт {{ 'работает.' if release.get('current') else 'готовится.' }}

    {% if release.get('current') %}Публичный релиз собран. Изменения в рабочей области ещё не опубликованы — текущий релиз остаётся неизменным.{% else %}Рабочая область готова к редактированию. Проверьте страницы и выполните первую публикацию, чтобы создать публичную версию сайта.{% endif %}

    Проверить изменения {{ icon('arrow') }}
    +
    LIVE BUILD
    {{ release.get('current') or 'Нет публикаций' }}
    {{ 'Релиз от ' + built_at if release.get('current') else 'Первый релиз ещё не создан' }}
    {{ site_name }}
    {{ release.get('routes', [])|length }} страниц в снимке
    {{ 'Публичный релиз активен' if release.get('current') else 'До первой публикации' }}
    +
    + {{ ribbon(counts, release, comparison_available) }} +

    Последние изменения

    {{ 'Рабочие файлы отличаются от активного релиза' if release.get('current') else 'Страницы к первой публикации' }}

    Все страницы {{ icon('arrow') }}
    + {% for p in all_pages|sort(attribute='updated_at', reverse=true) if p.changed %}{{ icon('file') }}{{ p.title }}{{ p.file }}{% else %}
    {{ 'Нет изменений' if comparison_available else 'Для этого релиза нет данных сравнения' }}
    {% endfor %} +

    Проверки

    Текущее состояние рабочей области

    К публикации {{ icon('arrow') }}
    + {{ icon('alert' if errors else 'check') }}{{ 'Найдены ошибки' if errors else 'Блокирующих ошибок нет' }}Ошибок проверки: {{ errors }}{{ errors if errors else 'OK' }} + {{ icon('layers') }}Ссылки, данные и структураПредупреждений: {{ warnings }}{{ warnings if warnings else 'OK' }} + {% for i in report_issues[:3] %}
    {{ icon('alert') }}{{ i.message }}{{ i.path }}
    {% endfor %} +
    Сохранение документа обновляет рабочую область. Публикация создаёт отдельный снимок сайта.
    +
    {% endif %} +
    {% endblock %} diff --git a/src/site_engine/web/admin/templates/document.html.j2 b/src/site_engine/web/admin/templates/document.html.j2 new file mode 100644 index 0000000..eae5833 --- /dev/null +++ b/src/site_engine/web/admin/templates/document.html.j2 @@ -0,0 +1,18 @@ +{% extends 'shell.html.j2' %} +{% block title %}{{ snap.id }} — редактор{% endblock %} +{% block content %} +
    +
    {{ snap.kind|upper }} / WORKSPACE

    {{ meta.get('title', snap.id) }}

    {{ snap.path }}
    Сохранённый документ
    +

    Правки остаются в буфере до кнопки «Сохранить документ». Публикация выполняется отдельно.

    +
    +
    + + +

    Исходник сохраняется без переформатирования. Ошибки YAML не удаляют текст; Конструктор доступен после исправления.

    +
    +
    +

    +
    {% include 'editor_result.html.j2' %} +

    Превью буфера

    Нажмите «Обновить превью».

    +
    +{% endblock %} diff --git a/src/site_engine/web/admin/templates/editor_result.html.j2 b/src/site_engine/web/admin/templates/editor_result.html.j2 new file mode 100644 index 0000000..4be1075 --- /dev/null +++ b/src/site_engine/web/admin/templates/editor_result.html.j2 @@ -0,0 +1 @@ +{% if snap.kind == 'page' %}{% include 'builder_result.html.j2' %}{% else %}{% include 'entry_editor_result.html.j2' %}{% endif %} diff --git a/src/site_engine/web/admin/templates/entries_list.html.j2 b/src/site_engine/web/admin/templates/entries_list.html.j2 index ca96d0e..4509199 100644 --- a/src/site_engine/web/admin/templates/entries_list.html.j2 +++ b/src/site_engine/web/admin/templates/entries_list.html.j2 @@ -3,6 +3,7 @@ {% block content %}

    ← Контент

    {{ collection.name }}

    +
    diff --git a/src/site_engine/web/admin/templates/entry_edit.html.j2 b/src/site_engine/web/admin/templates/entry_edit.html.j2 index 8468c05..9ed3895 100644 --- a/src/site_engine/web/admin/templates/entry_edit.html.j2 +++ b/src/site_engine/web/admin/templates/entry_edit.html.j2 @@ -21,6 +21,6 @@ {% if preview %}

    Предпросмотр

    - + {% endif %} {% endblock %} diff --git a/src/site_engine/web/admin/templates/entry_editor_result.html.j2 b/src/site_engine/web/admin/templates/entry_editor_result.html.j2 new file mode 100644 index 0000000..6bc091d --- /dev/null +++ b/src/site_engine/web/admin/templates/entry_editor_result.html.j2 @@ -0,0 +1,46 @@ +{% from '_fields.html.j2' import field %} +{% macro buffer_fields() %}{% endmacro %} +
    + + {% if saved %}

    Документ сохранён. Публикация не выполнялась.

    {% endif %} + {% if errors %}{% endif %} + {% if submitted_fields %}{% endif %} + {% if snap.issues %}
      {% for i in snap.issues %}
    • {{ i.code }} {{ i.path }}: {{ i.message }}
    • {% endfor %}
    {% endif %} + {% if conflict %}{% endif %} +
    + {% if snap.model %} +

    Структура

    +
    {{ buffer_fields() }} + {% for b in fixed + display %}
    {{ b.scope }} / {{ b.region }}
    {{ buffer_fields() }}Только чтение · определяется шаблоном
    {% endfor %} + {% for b in blocks %} +
    + {{ b.region }}
    {{ buffer_fields() }} + {% if b.hidden %}Скрыт: отсутствует в превью{% endif %}{% if b.requires %}Условие: {{ b.requires|join(', ') }}{% endif %} +
    + {% else %}

    Блоков документа нет.

    {% endfor %} + {% if snap.kind == 'page' %}
    Добавить блок
    {{ buffer_fields() }}
    {% endif %} +
    +

    {{ readonly_selected.fragment if readonly_selected else selected.fragment if selected else 'Свойства документа' }}

    + {% if readonly_selected %}

    Только чтение · {{ readonly_selected.scope }} / {{ readonly_selected.owner }}

    {{ readonly_selected.id }} · {{ readonly_selected.region }}

    Props

    {{ readonly_selected.get('props', {})|tojson(indent=2) }}

    Этот блок определяется шаблоном. Изменение layout/display из редактора документа недоступно.

    + {% else %} +
    {{ buffer_fields() }} + + {% if selected %}

    {{ selected.id }}

    + {% for f in fields %}{{ field(f) }}{% endfor %} + + + {% for key, enabled in snap.schema.features.items() %}{% endfor %} + {% else %} + {% if snap.kind == 'page' %} + {% else %}{% for f in fields %}{{ field(f) }}{% endfor %}{% endif %} + + {% if snap.schema.has_body %}{% endif %} + {% endif %} + + {% if selected %}
    {{ buffer_fields() }}
    {{ buffer_fields() }}{% endif %} +

    Конструктор пересобирает YAML: комментарии и форматирование могут измениться. Перед первой правкой скачайте исходник.

    + {% endif %} +
    + {% else %}

    Конструктор недоступен: исправьте исходник в режиме «Эксперт». Последнее корректное дерево сохраняется в открытом редакторе.

    {% endif %} +
    +
    diff --git a/src/site_engine/web/admin/templates/legacy_conflict.html.j2 b/src/site_engine/web/admin/templates/legacy_conflict.html.j2 new file mode 100644 index 0000000..30c1e19 --- /dev/null +++ b/src/site_engine/web/admin/templates/legacy_conflict.html.j2 @@ -0,0 +1,11 @@ +{% extends 'shell.html.j2' %} +{% block content %} +

    Файл изменился

    {{ message }}. Чужие изменения не перезаписаны.

    +

    Введённые значения сохранены ниже. Откройте текущую версию в другой вкладке, объедините правки и явно подтвердите новую основу.

    +Открыть текущие документы + +{% for name, values in submitted %}{% for value in values %} +{% if name in ['csrf','etag'] %}{% else %}{% endif %} +{% endfor %}{% endfor %} + +{% endblock %} diff --git a/src/site_engine/web/admin/templates/page_builder.html.j2 b/src/site_engine/web/admin/templates/page_builder.html.j2 new file mode 100644 index 0000000..d07bff4 --- /dev/null +++ b/src/site_engine/web/admin/templates/page_builder.html.j2 @@ -0,0 +1,34 @@ +{% extends 'shell.html.j2' %} +{% from '_builder_icons.html.j2' import bi %} +{% block title %}{{ meta.get('title', snap.id) }} — редактор{% endblock %} +{% block contentclass %}design-content builder-content{% endblock %} +{% block content %} +
    + + +

    +
    + {% include 'builder_result.html.j2' %} +
    +
    {{ bi('eye') }}Предпросмотр· iframe
    {% for v, i, label in [('desktop','monitor','Desktop'),('tablet','tablet','Tablet'),('mobile','phone','Mobile')] %}{% endfor %}
    +
    {{ page_route }} · сохранение отдельно
    +

    Загрузка предпросмотра…

    +
    Клик по секции выбирает блок · сохранение не публикует сайт
    +
    +
    +
    Режим «Эксперт»
    YAML + Markdown · один документ
    Текущая редакция
    +
    {{ bi('code') }}{{ snap.path }}
    YAML front matter · Markdown
    +
    UTF-8 · {{ 'CRLF' if '\r\n' in snap.source else 'LF' }} · Page schema v1
    +
    + +
    +
    Ln 1, Col 1Исходник сохраняется без переформатирования{{ snap.path }}
    +
    +
    + + + + +
    +{% endblock %} diff --git a/src/site_engine/web/admin/templates/page_edit.html.j2 b/src/site_engine/web/admin/templates/page_edit.html.j2 index bc34b1c..4a23d66 100644 --- a/src/site_engine/web/admin/templates/page_edit.html.j2 +++ b/src/site_engine/web/admin/templates/page_edit.html.j2 @@ -103,5 +103,5 @@ {% endfor %}

    Предпросмотр

    - + {% endblock %} diff --git a/src/site_engine/web/admin/templates/pages_list.html.j2 b/src/site_engine/web/admin/templates/pages_list.html.j2 index dcc7cd0..3ccb0e2 100644 --- a/src/site_engine/web/admin/templates/pages_list.html.j2 +++ b/src/site_engine/web/admin/templates/pages_list.html.j2 @@ -1,34 +1,31 @@ {% extends 'shell.html.j2' %} +{% from '_workspace.html.j2' import ribbon, status %} {% block title %}Страницы — админка{% endblock %} +{% block contentclass %}design-content{% endblock %} {% block content %} -

    Страницы

    -
    ЗаписьАдресСтатус
    - - - {% for p in pages %} - - - - - - - {% endfor %} - -
    СтраницаАдресСтатус
    {{ p.title }}
    {{ p.id }}
    {{ p.route }}{{ p.status }}Изменить
    -

    Новая страница

    -{% if errors %}
      {% for e in errors %}
    • {{ e }}
    • {% endfor %}
    {% endif %} -
    - - - - - -
    +
    +
    02 / CONTENT OPERATIONS

    Страницы

    Управление URL, файловыми страницами и состояниями публикации.

    {{ icon('plus') }} Новая страница
    + {{ ribbon(counts, release, comparison_available) }} +
    + + + + Сбросить +
    + {% include 'pages_results.html.j2' %} + +

    Новая страница

    Создать страницу в рабочей области

    {{ icon('close') }}
    +
    +
    + {% if errors %}{% endif %} + + + +
    Страница будет создана как черновик. Публикация выполняется отдельно.
    +
    Отмена
    +
    +
    +

    Pages и Entries

    Одинаковые интерфейсы, разные файловые сущности

    Страницаpages/**/*.md
    Записьcontent/<collection>/*.md
    Layoutlayouts/
    Fragmentfragments/
    Сначала выберите строку страницы, затем откройте её редактор. Сохранение и публикация выполняются отдельно.
    + {% if created %}
    Черновик создан
    {% endif %} +
    {% endblock %} diff --git a/src/site_engine/web/admin/templates/pages_results.html.j2 b/src/site_engine/web/admin/templates/pages_results.html.j2 new file mode 100644 index 0000000..dff5e33 --- /dev/null +++ b/src/site_engine/web/admin/templates/pages_results.html.j2 @@ -0,0 +1,30 @@ +{% from '_icons.html.j2' import icon %} +{% from '_workspace.html.j2' import status %} +
    + +
    +
    + + + {% for p in pages %} + + + {% else %}{% endfor %} +
    Название / файлURLLayoutСтатусИзменения
    {{ icon('file') }}{{ p.title }}{{ p.file }}{{ p.route }}{{ p.layout }}{{ status(p.status) }}{% if p.error %}Ошибка{% elif p.changed %}Изменено{% else %}—{% endif %}

    Ничего не найдено

    Страниц по этим фильтрам нет

    Сбросить фильтры
    {{ pages|length }} из {{ counts.all }} страницВыберите строку для просмотра свойств {{ icon('arrow') }}
    + {% if selected %}{% set p = selected %} + + {% else %}{% endif %} +
    + {% if selected %}

    Свойства страницы

    Маппинг и метаданные

    Page{{ selected.id }}
    File{{ selected.file }}
    Layout{{ selected.layout }}
    Блоков{{ selected.count }}
    Workspace{{ 'Нет сравнения' if selected.changed is none else 'Изменён' if selected.changed else 'Без изменений' }}
    Live{{ release.get('current') or 'Нет публикаций' }}
    {% endif %} +
    diff --git a/src/site_engine/web/admin/templates/preview_result.html.j2 b/src/site_engine/web/admin/templates/preview_result.html.j2 new file mode 100644 index 0000000..a36be51 --- /dev/null +++ b/src/site_engine/web/admin/templates/preview_result.html.j2 @@ -0,0 +1,5 @@ +
    +{% if preview.message %}

    {{ preview.message }}

    {% endif %} +{% if preview.interactive %} +{% else %}{% endif %} +
    diff --git a/src/site_engine/web/admin/templates/shell.html.j2 b/src/site_engine/web/admin/templates/shell.html.j2 index b22a021..ec1a579 100644 --- a/src/site_engine/web/admin/templates/shell.html.j2 +++ b/src/site_engine/web/admin/templates/shell.html.j2 @@ -1,24 +1,53 @@ {% extends 'base.html.j2' %} +{% from '_icons.html.j2' import icon %} +{% set nav = navigation|default({}) %} +{% set site_label = nav.get('site_name', site_name|default('Site Engine')) %} +{% set site_host = nav.get('host', site_label) %} +{% set sections = [('dashboard','/admin/','overview','Обзор'),('pages','/admin/pages','pages','Страницы'),('content','/admin/content','content','Контент'),('publish','/admin/publish','publish','Публикация')] %} {% block bodyattrs %}{% if htmx %} hx-boost='true'{% endif %}{% endblock %} {% block scripts %}{% if htmx %}{% endif %}{% endblock %} {% block body %} -
    - Админка - - - {{ login }} -
    - - -
    -
    -{% if flash %}

    {{ flash }}

    {% endif %} -
    -{% block content %}{% endblock %} -
    + +
    + + +
    +
    + +
    {{ site_host }}/{{ {'dashboard':'Обзор','pages':'Страницы','content':'Контент','publish':'Публикация'}.get(section, 'Сообщение') }}
    + + {% if nav.get('current') %}LIVE {{ nav.current|replace('build_', 'r') }}{% else %}НЕТ РЕЛИЗА{% endif %} + + +
    +
    {% if flash %}

    {{ flash }}

    {% endif %}
    {% block content %}{% endblock %}
    +
    +
    +
    + +

    Быстрый переход

    Раздел или страница

    +
    + {% for key, url, glyph, label in sections %}{{ icon(glyph) }} {{ label }}Раздел{% endfor %} + {% for p in nav.get('pages', []) %}{{ icon('file') }} {{ p.title }}{{ p.route }}{% endfor %} + +
    +
    + +

    Профиль

    Текущий администратор сайта

    +
    Логин{{ login }}
    +
    +
    +
    +

    Подтверждение

    {% endblock %} diff --git a/src/site_engine/web/admin/views.py b/src/site_engine/web/admin/views.py new file mode 100644 index 0000000..1e90368 --- /dev/null +++ b/src/site_engine/web/admin/views.py @@ -0,0 +1,85 @@ +"""Read-only template projections shared by runtime HTML and legacy adapters.""" + +import datetime as dt +from urllib.parse import urlencode + +from ...services.workspace import filter_pages + + +def date_label(value, short=False): + try: + date = dt.datetime.fromisoformat(value) + return date.strftime("%d.%m · %H:%M" if short else "%d.%m.%Y · %H:%M UTC") + except (ValueError, TypeError): + return "—" + + +def workspace_view(data): + pages = [dict(p) for p in data["pages"]] + for p in pages: + p["updated"] = date_label(p.get("updated_at"), short=True) + p["error"] = next( + (i["message"] for i in p.get("issues", []) if i["severity"] == "error"), "" + ) + release = data.get("release", {}) + return { + "all_pages": pages, + "counts": { + "all": len(pages), + "changed": sum(p.get("changed") is True for p in pages), + "draft": sum(p["status"] == "draft" for p in pages), + "published": sum(p["status"] == "published" for p in pages), + }, + "comparison_available": data.get("comparison_available", False), + "release": release, + "built_at": date_label(release.get("built_at")), + "report_issues": data.get("issues", []), + } + + +def pages_view(data, query): + view = workspace_view(data) + pages = view["all_pages"] + selected = next((p for p in pages if p["id"] == query.get("selected")), None) + if query.get("selected") and selected is None: + raise LookupError("Нет выбранной страницы") + selected = selected or next(iter(pages), None) + filters = {k: query.get(k, "") for k in ("q", "status", "layout", "changed")} + params = {**filters, "selected": selected["id"] if selected else ""} + + def url(**overrides): + return "/admin/pages?" + urlencode({k: v for k, v in {**params, **overrides}.items() if v}) + + for p in pages: + p["select_url"] = url(selected=p["id"]) + return dict( + view, + pages=filter_pages( + pages, + q=filters["q"], + status=filters["status"], + layout=filters["layout"], + changed=filters["changed"] == "1", + ), + selected=selected, + filters=filters, + layouts=data["layouts"], + tabs=[ + { + "label": label, + "count": view["counts"][key], + "key": key, + "url": url(status=status, changed=changed), + "active": filters["status"] == status and filters["changed"] == changed, + } + for key, label, status, changed in [ + ("all", "Все", "", ""), + ("changed", "Изменённые", "", "1"), + ("draft", "Черновики", "draft", ""), + ("published", "В каталоге", "published", ""), + ] + ], + reset_url="/admin/pages?" + urlencode({"selected": selected["id"]}) + if selected + else "/admin/pages", + ) diff --git a/src/site_engine/web/api/__init__.py b/src/site_engine/web/api/__init__.py new file mode 100644 index 0000000..83f57ee --- /dev/null +++ b/src/site_engine/web/api/__init__.py @@ -0,0 +1 @@ +"""Versioned JSON contract; browser HTML lives in web.admin.""" diff --git a/src/site_engine/web/api/export.py b/src/site_engine/web/api/export.py new file mode 100644 index 0000000..cddea4b --- /dev/null +++ b/src/site_engine/web/api/export.py @@ -0,0 +1,21 @@ +"""Deterministic contract export without admin credentials or a live workspace.""" + +from pathlib import Path + + +def schema(): + from fastapi import FastAPI + + from ...services.auth import AuthConfig, AuthService + from ...services.preview import PreviewStore + from .routes import install_api + + app = FastAPI(docs_url=None, openapi_url=None) + # No login, service call, state directory creation or environment secrets are needed for schemas. + auth = AuthService( + AuthConfig("schema", "", b"schema-only-placeholder-key-00000"), Path(".schema-state") + ) + install_api( + app, auth, Path("."), Path(".schema-dist"), PreviewStore(auth.state_dir, auth.cfg.secret) + ) + return app.openapi() diff --git a/src/site_engine/web/api/models.py b/src/site_engine/web/api/models.py new file mode 100644 index 0000000..aec685e --- /dev/null +++ b/src/site_engine/web/api/models.py @@ -0,0 +1,198 @@ +"""Pydantic exists only at the HTTP boundary.""" + +from typing import Annotated, Any, Literal + +from pydantic import BaseModel, ConfigDict, Field, model_validator + + +class DTO(BaseModel): + model_config = ConfigDict(extra="forbid") + + +class IssueDTO(DTO): + code: str + message: str + path: str = "" + severity: str = "error" + hint: str = "" + + +class Snapshot(DTO): + kind: Literal["page", "entry"] + id: str + path: str + source: str + etag: str + model: dict[str, Any] | None + issues: list[IssueDTO] + schema_data: dict[str, Any] = Field(alias="schema") + revision: int = 0 + + +class Buffer(DTO): + source: str = Field(max_length=524288) + etag: str = Field(min_length=1, max_length=80) + revision: int = Field(default=0, ge=0) + + +class Metadata(DTO): + type: Literal["metadata"] + values: dict[str, Any] = Field(default_factory=dict) + body: str | None = None + + +class EntryFields(DTO): + type: Literal["entry_fields"] + values: dict[str, Any] = Field(default_factory=dict) + unset: list[str] = Field(default_factory=list) + body: str | None = None + status: Literal["draft", "published", "archived"] | None = None + + +class BlockAction(DTO): + type: Literal["block", "delete", "toggle", "duplicate"] + block_id: str + values: dict[str, Any] = Field(default_factory=dict) + + +class Add(DTO): + type: Literal["add"] + fragment: str + region: str | None = None + parent: str | None = None + slot: str | None = None + props: dict[str, Any] = Field(default_factory=dict) + + +class Move(DTO): + type: Literal["move"] + block_id: str + direction: Literal["up", "down"] | None = None + before: str | None = None + after: str | None = None + + @model_validator(mode="after") + def one_target(self): + if sum(v is not None for v in (self.direction, self.before, self.after)) != 1: + raise ValueError("Specify exactly one direction, before or after") + return self + + +Action = Annotated[Metadata | EntryFields | BlockAction | Add | Move, Field(discriminator="type")] + + +class Transform(Buffer): + action: Action + + +class Create(DTO): + id: str = Field(min_length=1, max_length=200) + title: str = "" + layout: str | None = None + + +class ErrorBody(DTO): + code: str + message: str + revision: int | None = None + submitted_source: str | None = None + base_etag: str | None = None + issues: list[IssueDTO] = Field(default_factory=list) + submitted: Buffer | None = None + current: Snapshot | None = None + committed: Snapshot | None = None + buffer: Snapshot | None = None + + +class ErrorEnvelope(DTO): + error: ErrorBody + + +class PageRow(DTO): + id: str + title: str + status: str + route: str + file: str + layout: str | None + count: int + changed: bool | None = None + description: str = "" + updated_at: str = "" + issues: list[IssueDTO] = Field(default_factory=list) + on_live: bool = False + + +class EntryRow(DTO): + slug: str + title: str + status: str + route: str + file: str + + +class CollectionRow(DTO): + id: str + name: str + total: int + published: int + + +class WorkspaceRelease(DTO): + current: str | None = None + built_at: str | None = None + routes: list[str] = Field(default_factory=list) + + +class Workspace(DTO): + site_name: str + pages: list[PageRow] + collections: list[CollectionRow] + layouts: list[str] + issues: list[IssueDTO] + paths: dict[str, str] + release: WorkspaceRelease = Field(default_factory=WorkspaceRelease) + comparison_available: bool = False + + +class Entries(DTO): + collection: CollectionRow + entries: list[EntryRow] + + +class Release(DTO): + id: str + current: bool + + +class Releases(DTO): + current: str | None + builds: list[Release] + + +class Preview(DTO): + url: str = "" + snapshot: str = "" + revision: int + interactive: bool + expires_at: float + message: str = "" + html: str = "" + + +class Rollback(DTO): + build_id: str = Field(pattern=r"^\d{8}T\d{6}-[0-9a-f]{8}$") + + +def snapshot_dto(value): + return Snapshot( + kind=value.kind, + id=value.id, + path=value.path, + source=value.source, + etag=value.etag, + model=value.model, + issues=[i.to_dict() for i in value.report.issues], + schema=value.schema, + revision=value.revision, + ) diff --git a/src/site_engine/web/api/routes.py b/src/site_engine/web/api/routes.py new file mode 100644 index 0000000..6a32c89 --- /dev/null +++ b/src/site_engine/web/api/routes.py @@ -0,0 +1,399 @@ +"""Explicit JSON routes. All filesystem work is off the event loop.""" + +import mimetypes +from typing import Annotated + +from fastapi import APIRouter, Depends, Request +from fastapi.exceptions import RequestValidationError +from fastapi.responses import HTMLResponse, JSONResponse, Response +from fastapi.security import HTTPAuthorizationCredentials, HTTPBearer + +from ...core.models import STATUSES +from ...errors import ConflictError, EngineError, UnsafePathError +from ...services.documents import AuditCommitError, DocumentMissing, EditorContext +from ...services.entries import EntryService +from ...services.pages import PageService +from ...services.preview import asset_path +from ...services.publish import publish, rollback +from ...services.workspace import entries, filter_pages, releases, workspace +from ...storage.locks import SiteLock +from .models import ( + Buffer, + CollectionRow, + Create, + Entries, + ErrorEnvelope, + PageRow, + Preview, + Releases, + Rollback, + Snapshot, + Transform, + Workspace, + snapshot_dto, +) + + +def install_api(app, auth, root, dist, previews): + app.state.api_credentials = {} + app.state.api_calls = 0 + + bearer = HTTPBearer( + auto_error=False, + scheme_name="InternalUiSession", + description="Request-scoped server credential; never sent to the browser", + ) + + def context( + request: Request, + credentials: Annotated[HTTPAuthorizationCredentials | None, Depends(bearer)], + ): + token = credentials.credentials if credentials else "" + saved = app.state.api_credentials.get(token) + principal = auth.authenticate(saved[0]) if saved else None + if principal is None: + from fastapi import HTTPException + + raise HTTPException(401, "Требуется внутренняя авторизация UI") + app.state.api_calls += 1 + return EditorContext(principal, saved[1]) + + Ctx = Annotated[EditorContext, Depends(context)] + router = APIRouter( + prefix="/admin/api/v1", + dependencies=[Depends(context)], + responses={s: {"model": ErrorEnvelope} for s in (401, 403, 404, 409, 422, 500)}, + ) + + def service(kind, collection=""): + return ( + PageService(root, auth.audit) + if kind == "page" + else EntryService(root, auth.audit, collection) + ) + + def error(status, code, message, **extra): + buffer = extra.get("submitted") or extra.get("buffer") or {} + details = { + "revision": buffer.get("revision"), + "submitted_source": buffer.get("source"), + "base_etag": buffer.get("etag"), + } + return JSONResponse( + {"error": {"code": code, "message": str(message), "issues": [], **details, **extra}}, + status_code=status, + headers={"Cache-Control": "no-store"}, + ) + + def invoke(fn, svc=None, identity=None, buf=None): + try: + return fn() + except ConflictError as exc: + current = None + if svc and identity: + try: + current = snapshot_dto(svc.get(identity)).model_dump(by_alias=True, mode="json") + except DocumentMissing: + pass + return error( + 409, + "conflict", + exc, + submitted=buf.model_dump(exclude={"action"}) if buf else None, + current=current, + ) + except AuditCommitError as exc: + return error( + 500, + "audit_after_commit", + exc, + committed=snapshot_dto(exc.snapshot).model_dump(by_alias=True, mode="json"), + ) + except DocumentMissing as exc: + return error(404, "not_found", exc) + except UnsafePathError as exc: + return error(403, "forbidden", exc) + except EngineError as exc: + return error( + 422, + "validation", + exc, + issues=[i.to_dict() for i in exc.report.issues], + submitted=buf.model_dump(exclude={"action"}) if buf else None, + ) + except (ValueError, KeyError) as exc: + return error(422, "invalid_operation", exc) + + @router.get("/site", response_model=Workspace) + def site(): + return invoke(lambda: workspace(root, dist, auth.state_dir)) + + @router.get("/collections", response_model=list[CollectionRow]) + def collections(): + return invoke(lambda: workspace(root, dist, auth.state_dir)["collections"]) + + @router.get("/pages", response_model=list[PageRow]) + def page_list(q: str = "", status: str = "", layout: str = "", changed: bool = False): + def read(): + data = workspace(root, dist, auth.state_dir) + if status and status not in STATUSES or layout and layout not in data["layouts"]: + raise EngineError("Некорректный status/layout") + return filter_pages(data["pages"], q=q, status=status, layout=layout, changed=changed) + + return invoke(read) + + @router.get("/entries/{collection}", response_model=Entries) + @router.get("/collections/{collection}/entries", response_model=Entries) + def entry_list(collection: str, q: str = "", status: str = ""): + def read(): + if status and status not in STATUSES: + raise EngineError("Некорректный status") + data = entries(root, collection) + data["entries"] = [ + e + for e in data["entries"] + if (not status or e["status"] == status) + and q.casefold() in " ".join(str(v) for v in e.values()).casefold() + ] + return data + + return invoke(read) + + @router.get("/releases", response_model=Releases) + def release_list(): + return releases(dist) + + @router.post("/publish", response_model=Releases) + def publish_site(ctx: Ctx): + def run(): + publish(root, dist) + auth.audit.write("publish", actor=ctx.principal.login, ip=ctx.ip, source=ctx.source) + return releases(dist) + + return invoke(run) + + @router.post("/rollback/{build_id}", response_model=Releases) + def rollback_site(build_id: str, ctx: Ctx): + def run(): + with SiteLock(root): + rollback(dist, build_id) + auth.audit.write( + "rollback", actor=ctx.principal.login, ip=ctx.ip, object=build_id, source=ctx.source + ) + return releases(dist) + + return invoke(run) + + @router.post("/rollback", response_model=Releases) + def rollback_body(body: Rollback, ctx: Ctx): + return rollback_site(body.build_id, ctx) + + @router.get("/assets/{asset:path}", response_class=Response) + def asset(asset: str): + def read(): + path = asset_path(root / "assets", asset) + raw = path.read_bytes() + if path.suffix.lower() == ".css": + raw = raw.decode().replace("/assets/", "/admin/preview/assets/").encode() + return Response( + raw, + media_type=mimetypes.guess_type(path.name)[0] or "application/octet-stream", + headers={"Cache-Control": "no-store", "X-Content-Type-Options": "nosniff"}, + ) + + try: + return invoke(read) + except FileNotFoundError: + return error(404, "not_found", "Нет ассета") + + # Each document operation has the same DTO for Page and Entry. + @router.get("/preview/{snapshot}/html", response_class=Response) + def preview_html(snapshot: str, token: str = ""): + from ..preview_app import snapshot_response + + return snapshot_response(previews, snapshot, token) + + @router.get("/preview/{snapshot}/assets/{asset:path}", response_class=Response) + def preview_asset(snapshot: str, asset: str, token: str = ""): + from ..preview_app import snapshot_response + + return snapshot_response(previews, snapshot, token, asset) + + @router.post("/pages", response_model=Snapshot, status_code=201) + def page_create(body: Create, ctx: Ctx): + return invoke( + lambda: snapshot_dto(service("page").create(body.id, body.title, body.layout, ctx)) + ) + + @router.post("/entries/{collection}", response_model=Snapshot, status_code=201) + @router.post("/collections/{collection}/entries", response_model=Snapshot, status_code=201) + def entry_create(collection: str, body: Create, ctx: Ctx): + return invoke( + lambda: snapshot_dto( + service("entry", collection).create(body.id, body.title, None, ctx) + ) + ) + + # {identity:path} deliberately accepts nested Page IDs; literal operation suffixes remain part of the route. + @router.get("/editor/pages/{identity:path}/source", response_model=Snapshot) + @router.get("/pages/{identity:path}/source", response_model=Snapshot) + def page_source(identity: str): + return invoke(lambda: snapshot_dto(service("page").get(identity))) + + @router.get("/editor/entries/{collection}/{identity}/source", response_model=Snapshot) + @router.get("/collections/{collection}/entries/{identity}/source", response_model=Snapshot) + def entry_source(collection: str, identity: str): + return invoke(lambda: snapshot_dto(service("entry", collection).get(identity))) + + def operation(kind, identity, body, ctx, collection="", op="validate"): + svc = service(kind, collection) + + def run(): + args = (identity, body.source, body.etag) + if op == "preview": + return previews.render(svc, *args, body.revision, ctx.principal) + if op == "save": + result = svc.save_source(*args, ctx, body.revision) + elif op == "transform": + result = svc.transform_buffer( + *args, body.action.model_dump(exclude_none=True), body.revision + ) + else: + result = svc.validate_source(*args, body.revision) + dto = snapshot_dto(result) + if result.report.errors: + return error( + 422, + "validation", + "Исправьте ошибки документа", + buffer=dto.model_dump(by_alias=True, mode="json"), + issues=dto.model_dump()["issues"], + ) + return dto + + return invoke(run, svc, identity, body) + + @router.post("/editor/pages/{identity:path}/validate", response_model=Snapshot) + @router.post("/pages/{identity:path}/validate", response_model=Snapshot) + def page_validate(identity: str, body: Buffer, ctx: Ctx): + return operation("page", identity, body, ctx) + + @router.post("/editor/pages/{identity:path}/transform", response_model=Snapshot) + @router.post("/pages/{identity:path}/transform", response_model=Snapshot) + def page_transform(identity: str, body: Transform, ctx: Ctx): + return operation("page", identity, body, ctx, op="transform") + + @router.post("/editor/pages/{identity:path}/save", response_model=Snapshot) + @router.post("/pages/{identity:path}/save", response_model=Snapshot) + def page_save(identity: str, body: Buffer, ctx: Ctx): + return operation("page", identity, body, ctx, op="save") + + @router.post("/editor/pages/{identity:path}/preview", response_model=Preview) + @router.post("/pages/{identity:path}/preview", response_model=Preview) + def page_preview(identity: str, body: Buffer, ctx: Ctx): + return operation("page", identity, body, ctx, op="preview") + + @router.post("/editor/entries/{collection}/{identity}/validate", response_model=Snapshot) + @router.post("/collections/{collection}/entries/{identity}/validate", response_model=Snapshot) + def entry_validate(collection: str, identity: str, body: Buffer, ctx: Ctx): + return operation("entry", identity, body, ctx, collection) + + @router.post("/editor/entries/{collection}/{identity}/transform", response_model=Snapshot) + @router.post("/collections/{collection}/entries/{identity}/transform", response_model=Snapshot) + def entry_transform(collection: str, identity: str, body: Transform, ctx: Ctx): + return operation("entry", identity, body, ctx, collection, "transform") + + @router.post("/editor/entries/{collection}/{identity}/save", response_model=Snapshot) + @router.post("/collections/{collection}/entries/{identity}/save", response_model=Snapshot) + def entry_save(collection: str, identity: str, body: Buffer, ctx: Ctx): + return operation("entry", identity, body, ctx, collection, "save") + + @router.post("/editor/entries/{collection}/{identity}/preview", response_model=Preview) + @router.post("/collections/{collection}/entries/{identity}/preview", response_model=Preview) + def entry_preview(collection: str, identity: str, body: Buffer, ctx: Ctx): + return operation("entry", identity, body, ctx, collection, "preview") + + app.include_router(router) + + @app.middleware("http") + async def api_limits(request: Request, call_next): + if request.url.path.startswith("/admin/api/v1"): + chunks = bytearray() + async for chunk in request.stream(): + chunks.extend(chunk) + if len(chunks) > 1048576: + return error(413, "body_too_large", "Максимум 1 MiB") + request._body = bytes(chunks) + try: + response = await call_next(request) + except Exception: # noqa: BLE001 — HTTP boundary must return a content-free error envelope. + return error( + 500, + "internal_error", + "Ошибка сервера. Проверьте текущую версию перед повтором.", + ) + response.headers["Cache-Control"] = "no-store" + response.headers["X-Content-Type-Options"] = "nosniff" + return response + return await call_next(request) + + from fastapi import HTTPException + from fastapi.openapi.utils import get_openapi + + def contract_schema(): + return get_openapi( + title="Site Engine Admin API", version="1.0.0", routes=[r for r in router.routes] + ) + + app.openapi = contract_schema + + @app.exception_handler(HTTPException) + async def http_error(request, exc): + return error(exc.status_code, "http_error", exc.detail) + + @app.exception_handler(RequestValidationError) + async def validation_error(request, exc): + # Do not echo pydantic input: it can contain source or credentials. + return error( + 422, + "request_validation", + "Некорректный запрос", + issues=[ + { + "code": "E_REQUEST", + "path": ".".join(map(str, e["loc"])), + "message": e["msg"], + "severity": "error", + "hint": "", + } + for e in exc.errors() + ], + ) + + def require_session(request): + if not auth.authenticate(request.cookies.get("se_session")): + raise HTTPException(401, "Войдите в админку") + + @app.get("/admin/api/v1/openapi.json", include_in_schema=False) + @app.get("/admin/api/openapi.json", include_in_schema=False) + def openapi(request: Request): + require_session(request) + return JSONResponse(app.openapi(), headers={"Cache-Control": "no-store"}) + + @app.get("/admin/api/v1/docs", include_in_schema=False) + @app.get("/admin/api/docs", include_in_schema=False) + def docs(request: Request): + require_session(request) + # Local, CSP-compatible docs without CDN scripts or client credentials. + return HTMLResponse( + 'Site Engine API v1' + "

    Site Engine API v1

    UI uses request-scoped server credentials.

    " + '

    OpenAPI JSON

      ' + + "".join( + f"
    • {' / '.join(p.upper() for p in methods)} {path}
    • " + for path, methods in app.openapi()["paths"].items() + if path.startswith("/admin/api/v1") + ) + + "
    ", + headers={"Cache-Control": "no-store", "Content-Security-Policy": "default-src 'none'"}, + ) diff --git a/src/site_engine/web/app.py b/src/site_engine/web/app.py index c59bf14..2176ba8 100644 --- a/src/site_engine/web/app.py +++ b/src/site_engine/web/app.py @@ -20,7 +20,9 @@ def create_app(): from ..services.auth import AuthConfig, AuthService, ConfigError from .config import SitePaths - from .admin.editor import EditorHandlers + from .admin.application import AdminApplication + from .api.routes import install_api + from ..services.preview import PreviewConfig, PreviewStore from .admin.handlers import AdminHandlers from .admin.routes import create_admin_router @@ -44,7 +46,19 @@ def create_app(): uvicorn_log.warning("админка отключена: %s", exc) else: auth = AuthService(cfg, paths.state) - app.include_router(create_admin_router(AdminHandlers(auth, root, dist), EditorHandlers(auth, root, dist))) + preview_error = "" + try: + preview_config = PreviewConfig.from_env() + except ValueError as exc: + preview_config, preview_error = None, str(exc) + uvicorn_log.warning("интерактивное превью отключено: %s", exc) + previews = PreviewStore(paths.state, cfg.secret, preview_config) + previews.unavailable_reason = preview_error + previews.startup_cleanup() + install_api(app, auth, root, dist, previews) + app.state.auth = auth + app.state.previews = previews + app.include_router(create_admin_router(AdminHandlers(auth, root, dist), application=AdminApplication(auth, previews))) admin = "on" uvicorn_log.info("site-engine: %s, admin=%s", paths.describe(), admin) for problem in paths.problems(): diff --git a/src/site_engine/web/preview_app.py b/src/site_engine/web/preview_app.py new file mode 100644 index 0000000..3afd312 --- /dev/null +++ b/src/site_engine/web/preview_app.py @@ -0,0 +1,65 @@ +"""Run on SITE_PREVIEW_ORIGIN, with read-only state; never mount admin here.""" + +import mimetypes +import os + + +def snapshot_response(store, snapshot, token, asset=None): + from fastapi.responses import Response + + from ..errors import UnsafePathError + from ..services.preview import asset_path + + try: + folder, data = store.authorize(snapshot, token) + path = asset_path(folder / "assets", asset) if asset is not None else folder / "index.html" + content = path.read_bytes() + except (PermissionError, OSError, ValueError, UnsafePathError): + return Response("Превью недоступно", status_code=403, headers={"Cache-Control": "no-store"}) + config = store.config + script = f"'nonce-{data['nonce']}'" if config else "'none'" + ancestors = config.admin if config else "'self'" + headers = { + "Cache-Control": "no-store", + "Referrer-Policy": "no-referrer", + "X-Content-Type-Options": "nosniff", + "Content-Security-Policy": ( + f"default-src 'none'; script-src {script}; style-src 'self' 'unsafe-inline'; " + f"img-src 'self' data:; font-src 'self'; frame-ancestors {ancestors}; " + "connect-src 'none'; base-uri 'none'; form-action 'none'; object-src 'none'" + ), + } + if not config: + headers["X-Frame-Options"] = "SAMEORIGIN" + mime = mimetypes.guess_type(path.name)[0] if asset else "text/html" + return Response(content, media_type=mime or "application/octet-stream", headers=headers) + + +def create_preview_app(): + from fastapi import FastAPI, Request + + from ..services.preview import PreviewConfig, PreviewStore + + config = PreviewConfig.from_env() + if config is None: + raise ValueError("Настройте SITE_ADMIN_ORIGIN и SITE_PREVIEW_ORIGIN") + from .config import SitePaths + + state = SitePaths.from_env().state + secret = os.environ.get("SITE_SECRET_KEY", "").encode() + if len(secret) < 32: + raise ValueError( + "SITE_SECRET_KEY должен совпадать с ключом admin и содержать минимум 32 символа" + ) + store = PreviewStore(state, secret, config) + app = FastAPI(docs_url=None, redoc_url=None, openapi_url=None) + + @app.get("/s/{snapshot}/", include_in_schema=False) + def page(snapshot: str, request: Request): + return snapshot_response(store, snapshot, request.query_params.get("token", "")) + + @app.get("/s/{snapshot}/assets/{asset:path}", include_in_schema=False) + def asset(snapshot: str, asset: str, request: Request): + return snapshot_response(store, snapshot, request.query_params.get("token", ""), asset) + + return app diff --git a/tests/helpers.py b/tests/helpers.py index f6b93ab..2dcb488 100644 --- a/tests/helpers.py +++ b/tests/helpers.py @@ -17,7 +17,7 @@ class SiteTestCase(unittest.TestCase): self.addCleanup(self._tmp.cleanup) self.tmp = Path(self._tmp.name) self.site = self.tmp / "site" - shutil.copytree(EXAMPLE, self.site) + shutil.copytree(EXAMPLE, self.site, ignore=shutil.ignore_patterns('.engine')) self.out = self.tmp / "dist" def edit(self, rel: str, old: str, new: str) -> None: diff --git a/tests/test_admin_handlers.py b/tests/test_admin_handlers.py index 9431cde..5d991cc 100644 --- a/tests/test_admin_handlers.py +++ b/tests/test_admin_handlers.py @@ -82,19 +82,19 @@ class AdminHandlersTest(SiteTestCase): result = self.h.login_submit("admin", "super-secret-guess!!", ORIGIN, "1.1.1.1") self.assertNotIn("super-secret-guess", result.body) - def test_dashboard_lists_pages_collections_and_validation(self): + def test_dashboard_shows_workspace_release_changes_and_validation(self): result = self.h.dashboard(self.login()) self.assertEqual(result.status, 200) - for text in ("Acme Studio", "Главная", "Контакты", "Черновик новой страницы", "status-draft", - "опубликовано 3 из 3", "ошибок проверки: 0"): + for text in ("Acme Studio", "Главная", "Контакты", "Черновик новой страницы", + "Нет публикаций", "Последние изменения", "Ошибок проверки: 0"): self.assertIn(text, result.body) self.assertIn("name='csrf'", result.body) self.assertIn("no-store", result.headers["Cache-Control"]) - def test_dashboard_shows_the_absolute_paths_in_use(self): + def test_ordinary_dashboard_omits_developer_paths(self): body = self.h.dashboard(self.login()).body for path in (self.site.resolve(), (self.tmp / "dist").resolve(), (self.tmp / "state").resolve()): - self.assertIn(str(path), body) + self.assertNotIn(str(path), body) def test_missing_site_error_names_the_absolute_path(self): (self.site / "site.yaml").unlink() @@ -126,16 +126,21 @@ class AdminHandlersTest(SiteTestCase): result = self.h.login_page(self.login()) self.assertEqual((result.status, result.headers["Location"]), (303, "/admin/")) - def test_static_css_is_served(self): + def test_static_assets_are_served(self): result = self.h.static_css() self.assertEqual(result.status, 200) self.assertTrue(result.content_type.startswith("text/css")) self.assertIn(".login", result.body) + script = self.h.static_file("htmx.min.js") + self.assertEqual(script.status, 200) + self.assertTrue(script.content_type.startswith("text/javascript")) + self.assertIn('version:"2.0.11"', script.body) + self.assertEqual(script.headers["X-Content-Type-Options"], "nosniff") def test_no_inline_scripts_or_styles_in_templates(self): # CSP не разрешает inline: проверяем, что шаблоны её не нарушают for body in (self.h.login_page(None).body, self.h.dashboard(self.login()).body): - self.assertNotIn("]*\bsrc=)") self.assertNotIn("style=", body) self.assertNotIn(" ASGI client -> API integration.""" + +import os +from unittest.mock import patch + +from fastapi.testclient import TestClient +from helpers import SiteTestCase + +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app + + +class ApiTests(SiteTestCase): + @classmethod + def setUpClass(cls): + cls.password = "temporary test password" + cls.password_hash = hash_password(cls.password, n=2**10) + + def setUp(self): + super().setUp() + self.env = patch.dict( + os.environ, + { + "SITE_ROOT": str(self.site), + "SITE_DIST": str(self.out), + "SITE_STATE_DIR": str(self.tmp / "state"), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": self.password_hash, + "SITE_SECRET_KEY": "test-api-secret-" * 4, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": "", + "SITE_PREVIEW_ORIGIN": "", + }, + ) + self.env.start() + self.addCleanup(self.env.stop) + self.app = create_app() + self.client = TestClient(self.app) + self.addCleanup(self.client.close) + self.cookie = self.app.state.auth.login("admin", self.password, "testclient") + self.client.cookies.set("se_session", self.cookie) + self.principal = self.app.state.auth.authenticate(self.cookie) + self.csrf = self.app.state.auth.csrf_token(self.principal) + self.app.state.api_credentials["test-credential"] = (self.cookie, "testclient") + self.headers = {"Authorization": "Bearer test-credential"} + + def api(self, method, path, data=None, headers=None): + return self.client.request( + method, "/admin/api/v1" + path, json=data, headers=headers or self.headers + ) + + def source(self): + return self.api("GET", "/pages/index/source").json() + + def test_fragment_names_and_descriptions_reach_catalog_through_api(self): + fragments = self.source()["schema"]["fragments"] + expected = { + "collection_list": ("Список коллекций", "Карточки, получаемые из collection"), + "section": ("Текстовая секция", "Заголовок и содержимое секции"), + "richtext": ("Markdown body", "Выводит Markdown из файла страницы"), + "card_grid": ("Карточки", "Сетка преимуществ"), + } + html = self.client.get("/admin/pages/index").text + from html.parser import HTMLParser + + class Catalog(HTMLParser): + def __init__(self): + super().__init__() + self.items, self.current = {}, None + + def handle_starttag(self, tag, attrs): + attrs = dict(attrs) + if tag == "button" and "data-fragment" in attrs: + self.current = attrs["data-fragment"] + self.items[self.current] = [] + + def handle_data(self, data): + if self.current: + self.items[self.current].append(data) + + def handle_endtag(self, tag): + if tag == "button": + self.current = None + + catalog = Catalog() + catalog.feed(html) + for fid, (name, description) in expected.items(): + self.assertEqual(fragments[fid]["name"], name) + self.assertEqual(fragments[fid]["description"], description) + text = " ".join(catalog.items[fid]) + self.assertIn(name, text) + self.assertIn(description, text) + + def test_json_html_and_openapi_separate(self): + self.assertEqual(self.client.get("/admin/api/v1/site").status_code, 401) + data = self.api("GET", "/site") + self.assertEqual(data.status_code, 200) + self.assertIn("pages", data.json()) + self.assertEqual(data.headers["cache-control"], "no-store") + schema = self.client.get("/admin/api/openapi.json") + self.assertEqual(schema.status_code, 200) + self.assertIn("/admin/api/v1/pages/{identity}/save", schema.json()["paths"]) + self.assertIn("Transform", schema.json()["components"]["schemas"]) + self.assertIn("InternalUiSession", schema.json()["components"]["securitySchemes"]) + self.client.cookies.clear() + self.assertEqual(self.client.get("/admin/api/openapi.json").status_code, 401) + self.assertEqual(self.client.get("/admin/api/docs").status_code, 401) + + def test_html_uses_client_and_removes_request_credentials(self): + before = self.app.state.api_calls + response = self.client.get("/admin/pages/index") + self.assertEqual(response.status_code, 200) + self.assertIn("document-editor", response.text) + self.assertGreater(self.app.state.api_calls, before) + self.assertEqual(set(self.app.state.api_credentials), {"test-credential"}) + self.assertNotIn("test-credential", response.text) + self.assertNotIn("Bearer ", response.text) + with patch( + "site_engine.web.admin.api_client.AdminApi.call", + side_effect=__import__( + "site_engine.web.admin.api_client", fromlist=["ApiError"] + ).ApiError(503, {"error": {"message": "Unavailable"}}), + ): + response = self.client.get("/admin/pages") + self.assertEqual(response.status_code, 503) + self.assertIn("Unavailable", response.text) + + def test_buffer_validate_transform_save_and_conflict(self): + s = self.source() + payload = {"source": s["source"], "etag": s["etag"], "revision": 7} + transformed = self.api( + "POST", + "/pages/index/transform", + dict(payload, action={"type": "metadata", "values": {"title": "API buffer"}}), + ) + self.assertEqual(transformed.status_code, 200, transformed.text) + t = transformed.json() + self.assertEqual(t["etag"], s["etag"]) + self.assertEqual(self.source()["source"], s["source"]) + saved = self.api("POST", "/pages/index/save", dict(payload, source=t["source"])) + self.assertEqual(saved.status_code, 200, saved.text) + conflict = self.api("POST", "/pages/index/save", payload) + self.assertEqual(conflict.status_code, 409) + e = conflict.json()["error"] + self.assertEqual(e["current"]["source"], t["source"]) + self.assertEqual(e["submitted"]["source"], s["source"]) + self.assertEqual(e["submitted"]["etag"], s["etag"]) + + def test_typed_actions_and_error_envelopes(self): + s = self.source() + payload = {"source": s["source"], "etag": s["etag"]} + for action in ( + {"type": "unimplemented"}, + {"type": "move", "block_id": "b_hero", "direction": "up", "before": "b_hero"}, + ): + response = self.api("POST", "/pages/index/transform", dict(payload, action=action)) + self.assertEqual(response.status_code, 422) + self.assertIn("error", response.json()) + bad = self.api( + "POST", "/pages/index/validate", dict(payload, source="---\na: 1\na: 2\n---\n") + ) + self.assertEqual(bad.status_code, 422) + self.assertIsNone(bad.json()["error"]["buffer"]["model"]) + self.assertEqual(self.api("GET", "/pages/missing/source").status_code, 404) + self.assertEqual(self.api("GET", "/assets/..%2f..%2fsite.yaml").status_code, 403) + + def test_builder_catalog_duplicate_and_metadata_use_the_same_contract(self): + s = self.source() + payload = {"source": s["source"], "etag": s["etag"], "revision": 4} + added = self.api( + "POST", + "/pages/index/transform", + dict( + payload, + action={ + "type": "add", + "fragment": "hero", + "region": "main", + "props": {"title": "Catalog"}, + }, + ), + ) + self.assertEqual(added.status_code, 200, added.text) + block = added.json()["model"]["meta"]["regions"]["main"][-1] + self.assertRegex(block["id"], r"^hero_[a-z0-9]{5}$") + duplicate = self.api( + "POST", + "/pages/index/transform", + dict( + payload, + source=added.json()["source"], + action={"type": "duplicate", "block_id": block["id"]}, + ), + ) + self.assertEqual(duplicate.status_code, 200, duplicate.text) + blocks = duplicate.json()["model"]["meta"]["regions"]["main"] + self.assertNotEqual(blocks[-1]["id"], block["id"]) + self.assertRegex(blocks[-1]["id"], r"^hero_[a-z0-9]{5}$") + self.assertEqual(blocks[-1]["props"], block["props"]) + response = self.client.post( + "/admin/editor/pages/index/transform", + data={ + **payload, + "csrf": self.csrf, + "operation": "metadata", + "title": "Changed title", + "status": "published", + "seo_title": "Real SEO title", + "seo_description": "Description", + }, + headers={"Origin": "http://testserver", "HX-Request": "true"}, + ) + self.assertEqual(response.status_code, 200, response.text[:1000]) + self.assertIn("Real SEO title", response.text) + self.assertEqual(self.source()["source"], s["source"]) + + def test_nested_create_entry_and_publish_rollback(self): + result = self.api("POST", "/pages", {"id": "nested/api", "title": "Nested API"}) + self.assertEqual(result.status_code, 201, result.text) + self.assertEqual(self.api("GET", "/pages/nested/api/source").status_code, 200) + self.assertEqual( + self.api("POST", "/collections/services/entries", {"id": "api-draft"}).status_code, 201 + ) + e = self.api("GET", "/collections/services/entries/bots/source").json() + self.assertEqual(e["kind"], "entry") + result = self.api("POST", "/publish") + self.assertEqual(result.status_code, 200, result.text) + build = result.json()["current"] + self.assertEqual(self.api("POST", "/rollback/" + build).status_code, 200) + + def test_epoch_revokes_api_credentials(self): + self.app.state.auth.logout(self.principal) + self.assertEqual(self.api("GET", "/site").status_code, 401) + + def test_pages_comparison_and_html_creation_preserve_list_selection(self): + self.assertEqual(len(self.api("GET", "/pages?changed=true").json()), 5) + self.assertEqual(self.api("POST", "/publish").status_code, 200) + rows = self.api("GET", "/pages?changed=true").json() + self.assertEqual([p["id"] for p in rows], ["drafts/next"]) + self.assertEqual(self.client.get("/admin/pages?selected=missing").status_code, 404) + payload = { + "csrf": self.csrf, + "title": "Nested draft", + "page_id": "nested/ui", + "layout": "default", + } + response = self.client.post( + "/admin/pages/new", + data=payload, + headers={"Origin": "http://testserver"}, + follow_redirects=False, + ) + self.assertEqual(response.status_code, 303, response.text) + self.assertEqual( + response.headers["location"], "/admin/pages?selected=nested%2Fui&msg=created" + ) + response = self.client.post( + "/admin/pages/new", data=payload, headers={"Origin": "http://testserver"} + ) + self.assertEqual(response.status_code, 409, response.text[:500]) + self.assertIn("open data-auto-open", response.text) + self.assertIn("value='Nested draft'", response.text) + + def test_html_csrf_and_full_form_save(self): + s = self.source() + response = self.client.post( + "/admin/editor/pages/index/save", + data={"source": s["source"], "etag": s["etag"], "csrf": self.csrf}, + ) + self.assertEqual(response.status_code, 403) + source = s["source"].replace("title:", "# preserved\ntitle:", 1) + response = self.client.post( + "/admin/editor/pages/index/save", + data={"source": source, "etag": s["etag"], "csrf": self.csrf}, + headers={"Origin": "http://testserver"}, + ) + self.assertEqual(response.status_code, 200, response.text[:1000]) + self.assertEqual(self.source()["source"], source) + response = self.client.post( + "/admin/editor/pages/index/save", + data={"source": s["source"], "etag": s["etag"], "csrf": self.csrf}, + headers={"Origin": "http://testserver", "HX-Request": "true"}, + ) + self.assertEqual(response.status_code, 409) + self.assertIn("data-rebase", response.text) + self.assertIn("Серверный исходник", response.text) + + def test_ui_assets_are_binary_and_protected(self): + self.write("assets/new.svg", '') + response = self.client.get("/admin/preview/assets/new.svg") + self.assertEqual(response.status_code, 200) + self.assertIn("image/svg+xml", response.headers["content-type"]) + self.client.cookies.clear() + self.assertEqual( + self.client.get("/admin/preview/assets/new.svg", follow_redirects=False).status_code, + 303, + ) + + def test_planned_routes_filters_and_readonly_inspector(self): + self.assertEqual(self.api("GET", "/collections").status_code, 200) + self.assertEqual(self.api("GET", "/pages?q=no-such-document").json(), []) + self.assertEqual(self.api("GET", "/pages?status=unknown").status_code, 422) + self.assertEqual(self.api("GET", "/entries/services").status_code, 200) + s = self.api("GET", "/editor/pages/index/source").json() + self.assertEqual(s["kind"], "page") + response = self.api( + "POST", + "/editor/pages/index/validate", + {"source": s["source"], "etag": s["etag"], "revision": 2}, + ) + self.assertEqual(response.status_code, 200) + self.assertEqual(self.client.get("/admin/api/v1/openapi.json").status_code, 200) + self.assertEqual(self.client.get("/admin/api/v1/docs").status_code, 200) + import json + + response = self.client.post( + "/admin/editor/pages/index/select", + data={ + "source": s["source"], + "etag": s["etag"], + "csrf": self.csrf, + "readonly": json.dumps({"scope": "layout", "owner": "default", "id": "lh_header"}), + }, + headers={"Origin": "http://testserver", "HX-Request": "true"}, + ) + self.assertEqual(response.status_code, 200) + self.assertIn("data-readonly-inspector", response.text) + self.assertIn("site_header", response.text) + + def test_incomplete_preview_configuration_keeps_editor_available(self): + with patch.dict( + os.environ, {"SITE_ADMIN_ORIGIN": "http://127.0.0.1:8000", "SITE_PREVIEW_ORIGIN": ""} + ): + app = create_app() + self.assertIsNone(app.state.previews.config) + self.assertTrue(app.state.previews.unavailable_reason) + + def test_limits_and_forged_credentials_keep_error_contract(self): + response = self.api("GET", "/site", headers={"Authorization": "Bearer forged"}) + self.assertEqual(response.status_code, 401) + self.assertIn("error", response.json()) + response = self.client.post( + "/admin/api/v1/pages/index/validate", content=b"x" * 1048577, headers=self.headers + ) + self.assertEqual(response.status_code, 413) + self.assertEqual(response.json()["error"]["code"], "body_too_large") + response = self.api("GET", "/site", headers={**self.headers, "HX-Request": "true"}) + self.assertIn("application/json", response.headers["content-type"]) + response = self.client.get("/admin/pages/index?mode=expert") + self.assertEqual(response.status_code, 200) + self.assertIn("name='mode' value='expert'", response.text) diff --git a/tests/test_documents.py b/tests/test_documents.py new file mode 100644 index 0000000..098313b --- /dev/null +++ b/tests/test_documents.py @@ -0,0 +1,268 @@ +"""Service guarantees for the shared editor buffer and explicit CAS save.""" + +import concurrent.futures +from dataclasses import asdict +from unittest.mock import patch + +from helpers import SiteTestCase + +from site_engine.errors import ConflictError, EngineError +from site_engine.parsing.yamlio import YamlError, load_yaml +from site_engine.services.auth import AuditLog, Principal +from site_engine.services.documents import AuditCommitError, EditorContext +from site_engine.services.entries import EntryService +from site_engine.services.pages import PageService + + +class DocumentTests(SiteTestCase): + def setUp(self): + super().setUp() + self.audit = AuditLog(self.tmp / "audit.jsonl") + self.context = EditorContext(Principal("editor", "session"), "127.0.0.1") + self.svc = PageService(self.site, self.audit) + + def test_read_and_buffer_do_not_write(self): + s = self.svc.get("index") + original = (self.site / s.path).read_bytes() + t = self.svc.transform_buffer( + "index", s.source, s.etag, {"type": "metadata", "values": {"title": "Unsaved"}}, 9 + ) + self.assertTrue(t.report.ok, asdict(t.report)) + self.assertEqual(t.model["meta"]["title"], "Unsaved") + self.assertEqual(t.etag, s.etag) + self.assertEqual(t.revision, 9) + self.assertEqual((self.site / s.path).read_bytes(), original) + self.assertFalse((self.site / ".engine").exists()) + self.assertFalse(self.audit.path.exists()) + self.svc.overlay("index", t.source, s.etag) + self.assertEqual((self.site / s.path).read_bytes(), original) + + def test_exact_source_save_history_and_single_audit(self): + s = self.svc.get("index") + source = s.source.replace("title:", "# original comment\ntitle:", 1) + saved = self.svc.save_source("index", source, s.etag, self.context) + self.assertEqual((self.site / s.path).read_bytes(), source.encode()) + self.assertEqual(saved.source, source) + self.assertNotEqual(saved.etag, s.etag) + self.assertEqual(len(self.audit.path.read_text().splitlines()), 1) + self.assertTrue(list((self.site / ".engine/history").rglob("*.md"))) + with self.assertRaises(ConflictError): + self.svc.save_source("index", s.source, s.etag, self.context) + self.assertEqual(len(self.audit.path.read_text().splitlines()), 1) + + def test_invalid_text_never_writes_or_histories(self): + s = self.svc.get("index") + bad = "---\ntitle: first\ntitle: duplicate\n---\n" + result = self.svc.validate_source("index", bad, s.etag) + self.assertIsNone(result.model) + self.assertEqual(result.source, bad) + with self.assertRaises(EngineError): + self.svc.save_source("index", bad, s.etag, self.context) + self.assertEqual(self.svc.get("index").source, s.source) + self.assertFalse((self.site / ".engine/history").exists()) + + def test_two_writers_only_one_commits(self): + s = self.svc.get("index") + + def write(title): + t = self.svc.transform_buffer( + "index", s.source, s.etag, {"type": "metadata", "values": {"title": title}} + ) + try: + self.svc.save_source("index", t.source, s.etag, self.context) + return "saved" + except ConflictError: + return "conflict" + + with concurrent.futures.ThreadPoolExecutor(2) as pool: + outcomes = list(pool.map(write, ("A", "B"))) + self.assertCountEqual(outcomes, ["saved", "conflict"]) + + def test_current_layout_schema_is_checked_under_lock(self): + s = self.svc.get("index") + self.write("layouts/default/layout.yaml", "id: default\nregions:\n other: {}\n") + with self.assertRaises(EngineError): + self.svc.save_source("index", s.source, s.etag, self.context) + self.assertEqual((self.site / s.path).read_text(), s.source) + + def test_nested_page_and_create_draft(self): + s = self.svc.create("nested/test", "Nested", None, self.context) + self.assertEqual(s.model["meta"]["status"], "draft") + self.assertEqual(self.svc.get("nested/test").etag, s.etag) + with self.assertRaises(ConflictError): + self.svc.create("nested/test", "Again", None, self.context) + for bad in ("../outside", "/absolute", "new", "a/blocks", "a//b"): + with self.assertRaises(EngineError): + self.svc.create(bad, "Bad", None, self.context) + + def test_blocks_round_trip_and_read_only_layout(self): + s = self.svc.get("index") + for action in ( + {"type": "toggle", "block_id": "b_hero"}, + {"type": "move", "block_id": "b_hero", "direction": "down"}, + ): + s = self.svc.transform_buffer("index", s.source, s.etag, action) + self.assertTrue(s.report.ok, asdict(s.report)) + denied = self.svc.transform_buffer( + "index", s.source, s.etag, {"type": "delete", "block_id": "missing_fixed"} + ) + self.assertFalse(denied.report.ok) + self.assertEqual(denied.source, s.source) + + def test_entry_fields_identity_and_exact_save(self): + svc = EntryService(self.site, self.audit, "services") + s = svc.get("bots") + t = svc.transform_buffer( + "bots", + s.source, + s.etag, + {"type": "entry_fields", "values": {"title": "Buffer entry"}, "body": "Markdown\n"}, + ) + self.assertTrue(t.report.ok, asdict(t.report)) + self.assertEqual(svc.get("bots").source, s.source) + saved = svc.save_source("bots", t.source, t.etag, self.context) + self.assertEqual(saved.model["body"], "Markdown\n") + self.assertFalse( + svc.validate_source( + "bots", saved.source.replace("status:", "slug: another\nstatus:", 1), saved.etag + ).report.ok + ) + + def test_duplicate_subtree_generates_ids_preserves_sources_and_does_not_write(self): + from site_engine.core.page_ops import all_ids + from site_engine.parsing import frontmatter + + self.write( + "fragments/slot_probe/fragment.yaml", + "id: slot_probe\nname: Slots\ncategory: test\nfields: []\nslots:\n main: {}\n", + ) + self.write("fragments/slot_probe/template.html.j2", "{{ slots.main }}") + snapshot = self.svc.get("index") + meta, body = frontmatter.parse(snapshot.source) + hero = meta["regions"]["main"][0] + hero["anchor"] = "hero-anchor" + hero["props"]["title"] = {"bind": "page.title"} + parent = { + "id": "b_parent", + "fragment": "slot_probe", + "anchor": "parent-anchor", + "hidden": True, + "note": "Keep me", + "slots": {"main": [hero]}, + } + meta["regions"]["main"][0] = parent + source = frontmatter.dumps(meta, body) + result = self.svc.transform_buffer( + "index", source, snapshot.etag, {"type": "duplicate", "block_id": "b_parent"}, 7 + ) + self.assertTrue(result.report.ok, asdict(result.report)) + original, clone = result.model["meta"]["regions"]["main"][:2] + self.assertEqual(original, parent) + self.assertNotEqual(clone["id"], parent["id"]) + self.assertRegex(clone["id"], r"^slot_probe_[a-z0-9]{5}$") + self.assertRegex(clone["slots"]["main"][0]["id"], r"^hero_[a-z0-9]{5}$") + self.assertNotEqual(clone["slots"]["main"][0]["id"], hero["id"]) + self.assertNotIn("anchor", clone) + self.assertNotIn("anchor", clone["slots"]["main"][0]) + self.assertEqual(clone["slots"]["main"][0]["props"], hero["props"]) + self.assertEqual(clone["note"], "Keep me") + self.assertTrue(clone["hidden"]) + self.assertEqual(len(all_ids(result.model["meta"])), len(all_ids(meta)) + 2) + self.assertEqual(self.svc.get("index").source, snapshot.source) + self.assertEqual(result.revision, 7) + self.assertFalse(self.audit.path.exists()) + + def test_catalog_props_are_validated_and_fixed_blocks_cannot_duplicate(self): + snapshot = self.svc.get("index") + action = { + "type": "add", + "fragment": "hero", + "region": "main", + "props": {"title": "Catalog title"}, + } + result = self.svc.transform_buffer("index", snapshot.source, snapshot.etag, action) + self.assertTrue(result.report.ok, asdict(result.report)) + self.assertEqual( + result.model["meta"]["regions"]["main"][-1]["props"]["title"], "Catalog title" + ) + for denied in ( + {"type": "duplicate", "block_id": "lh_header"}, + dict(action, region="header"), + dict(action, props={"title": 42}), + ): + refused = self.svc.transform_buffer("index", snapshot.source, snapshot.etag, denied) + self.assertFalse(refused.report.ok) + self.assertEqual(refused.source, snapshot.source) + self.assertIsNotNone(refused.model) + self.assertEqual(self.svc.get("index").source, snapshot.source) + + def test_audit_failure_reports_committed_snapshot(self): + s = self.svc.get("index") + with ( + patch.object(self.audit, "write", side_effect=OSError("disk")), + self.assertRaises(AuditCommitError) as raised, + ): + self.svc.save_source("index", s.source, s.etag, self.context) + self.assertEqual(raised.exception.snapshot.etag, self.svc.get("index").etag) + + def test_duplicates_and_aliases_rejected(self): + for text in ( + "a: 1\na: 2", + "a:\n b: 1\n b: 2", + "a: &x value\nb: *x", + "[" * 2000 + "0" + "]" * 2000, + ): + with self.assertRaises(YamlError): + load_yaml(text) + + def test_scope_cannot_be_bypassed_through_symlink_or_traversal(self): + from site_engine.errors import UnsafePathError + + target = self.site / "layouts/default/layout.html.j2" + original = target.read_bytes() + link = self.site / "pages/code.md" + link.symlink_to(target) + for rel in ("pages/code.md", "pages/../layouts/default/layout.html.j2"): + with self.assertRaises(UnsafePathError): + self.svc.content.write(rel, "code changed", "absent") + self.assertEqual(target.read_bytes(), original) + + def test_invalid_structural_action_retains_valid_input(self): + s = self.svc.get("index") + t = self.svc.transform_buffer( + "index", s.source, s.etag, {"type": "add", "fragment": "hero", "region": "missing"} + ) + self.assertFalse(t.report.ok) + self.assertEqual(t.source, s.source) + self.assertIsNotNone(t.model) + + def test_nested_slots_queries_and_bindings_survive_constructor(self): + self.write( + "fragments/slot_probe/fragment.yaml", + "id: slot_probe\nname: Slots\ncategory: test\nfields: []\nslots:\n main: {}\n", + ) + self.write("fragments/slot_probe/template.html.j2", "
    {{ slots.main }}
    ") + from site_engine.parsing import frontmatter + + s = self.svc.get("index") + meta, body = frontmatter.parse(s.source) + original = meta["regions"]["main"][0] + meta["regions"]["main"][0] = { + "id": "b_parent", + "fragment": "slot_probe", + "slots": {"main": [original]}, + } + source = frontmatter.dumps(meta, body) + t = self.svc.transform_buffer( + "index", source, s.etag, {"type": "toggle", "block_id": "b_hero"} + ) + self.assertTrue(t.report.ok, asdict(t.report)) + hero = t.model["meta"]["regions"]["main"][0]["slots"]["main"][0] + self.assertTrue(hero["hidden"]) + self.assertEqual(hero["props"], original["props"]) + self.assertEqual(t.model["meta"]["regions"]["main"][1], meta["regions"]["main"][1]) + cycle = self.svc.transform_buffer( + "index", t.source, s.etag, {"type": "move", "block_id": "b_parent", "before": "b_hero"} + ) + self.assertFalse(cycle.report.ok) + self.assertEqual(cycle.source, t.source) diff --git a/tests/test_editor.py b/tests/test_editor.py index aee1fdf..b6e802b 100644 --- a/tests/test_editor.py +++ b/tests/test_editor.py @@ -92,15 +92,18 @@ class AccessTest(EditorTestCase): self.assertEqual(result.status, 200, path) self.assertIn("frame-ancestors 'none'", result.headers["Content-Security-Policy"], path) self.assertEqual(result.headers["Cache-Control"], "no-store") - for bad in ("]*\bsrc=)") + for bad in ("style=", "alert(1)'") @@ -277,7 +280,7 @@ class BlockTest(EditorTestCase): "region": "main", "fragment": "disclaimer"}) self.assertEqual(result.status, 303) location = result.headers["Location"] - self.assertRegex(location, r"^/admin/pages/privacy/blocks/b_[a-z0-9]{5}\?msg=added$") + self.assertRegex(location, r"^/admin/pages/privacy/blocks/disclaimer_[a-z0-9]{5}\?msg=added$") block_id = location.split("/blocks/")[1].split("?")[0] path = f"/pages/privacy/blocks/{block_id}" self.submit_form(path, f"/admin{path}", p__text="Важная **оговорка**") diff --git a/tests/test_editor_forms.py b/tests/test_editor_forms.py index 9f9efb9..aabb756 100644 --- a/tests/test_editor_forms.py +++ b/tests/test_editor_forms.py @@ -166,6 +166,9 @@ class PageOpsTest(unittest.TestCase): a = page_ops.add_block(m, "image", region="main") b = page_ops.add_block(m, "disclaimer", parent="b_s", slot="content") c = page_ops.add_block(m, "image", region="new_region") + self.assertRegex(a, r"^image_[a-z0-9]{5}$") + self.assertRegex(b, r"^disclaimer_[a-z0-9]{5}$") + self.assertRegex(c, r"^image_[a-z0-9]{5}$") self.assertEqual(len({a, b, c, "b_a", "b_s", "b_x", "b_y", "b_c"}), 8) self.assertEqual(m["regions"]["main"][-1]["id"], a) self.assertEqual(m["regions"]["main"][1]["slots"]["content"][-1]["id"], b) diff --git a/tests/test_fragments.py b/tests/test_fragments.py index 43839b4..11de3b7 100644 --- a/tests/test_fragments.py +++ b/tests/test_fragments.py @@ -1,36 +1,92 @@ +import shutil import unittest -from helpers import NOW, SiteTestCase +from helpers import NOW, ROOT, SiteTestCase from site_engine.core.registry import load_site from site_engine.core.render import Renderer from site_engine.core.routes import build_route_table from site_engine.errors import Report -CORE_15 = { +CORE_FRAGMENTS = { "site_header", "site_footer", "hero", "page_header", "section", "columns", "richtext", "image", "card_grid", "collection_list", "entry_header", "cta_banner", "form", "faq", "disclaimer", } class BuiltinFragmentsTest(SiteTestCase): - def test_builtin_set_is_exactly_the_15_from_adr_006(self): + def test_builtin_set_matches_adr_006(self): reg = load_site(self.site) builtin = {f.id for f in reg.fragments.values() if f.builtin} - self.assertEqual(builtin, CORE_15) + self.assertEqual(builtin, CORE_FRAGMENTS) def test_all_templates_compile_in_sandbox(self): reg = load_site(self.site) renderer = Renderer(reg, build_route_table(reg, Report()), Report(), now=NOW) - for fid in CORE_15: + for fid in CORE_FRAGMENTS: renderer.env.get_template(f"fragment/{fid}") def test_every_builtin_has_style_and_flat_unique_id(self): reg = load_site(self.site) self.assertEqual(reg.report.errors, []) - for fid in CORE_15: + for fid in CORE_FRAGMENTS: self.assertTrue(reg.fragments[fid].style, fid) + def test_steps_support_more_than_three_items_and_escape_titles(self): + shutil.copytree( + ROOT / "examples/ai-studio/fragments/steps", + self.site / "fragments/steps", + dirs_exist_ok=True, + ) + self.write("pages/process.md", """--- +schema: 1 +title: Процесс +status: published +regions: + main: + - id: process_steps + fragment: steps + props: + title: Этапы + items: + - {title: Исследование, text: '**Проверяем** задачу.'} + - {title: Разработка} + - {title: Внедрение} + - {title: ''} +--- +""") + from site_engine.build.pipeline import build_site + + build_site(self.site, self.out, now=NOW) + html = (self.out / "current/process/index.html").read_text(encoding="utf-8") + self.assertEqual(html.count("class='f-steps__item'"), 4) + self.assertIn("aria-hidden='true'>04", html) + self.assertIn("Проверяем", html) + self.assertIn("<script>unsafe()</script>", html) + self.assertNotIn("