diff --git a/AGENTS.md b/AGENTS.md index a09820e..8c98303 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,12 +9,15 @@ ## Куда подключать дизайн - Публичный сайт-пример: `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 и обновляй ссылки на него в блоках; изменения встроенных компонентов влияют на все сайты. +- `examples/ai-studio/` — расширенный кандидат на замену примера, схема остаётся 1: services/scenarios/cases, общие встроенные фрагменты и локальные `entry_cover`, `benefits`, `related`. Списки записей используют `collection_list`, отдельного `catalog` нет. `columns` — контейнер со слотами, `steps` — общий builtin-компонент «Этапы» из дизайна; прежний `card_grid.variant: steps` поддерживается для совместимости. Локальные ID не должны дублировать встроенные. Контракт и отдельный запуск — его `README.md`; проверка — `PYTHONPATH=src python scripts/qa_ai_studio.py`. Базовую фикстуру и рабочий SITE_ROOT не переключать без задачи на перенос. +- Новый независимый публичный пример `examples/site-studio/` переносит разметку/CSS из `design/examples/site-studio/` без локальных дублей builtin и mini-renderer. `entry_card.entry` — ref с `to: '*'`, значение collection/slug; редактор предлагает опубликованные записи включённых коллекций. Fixed ref/refs сохраняют slug + to. `collections/*.yaml:requires` ограничивает публикацию и queries через feature.<имя>, как у courses/posts. Формы сохраняют HTTP 501 с видимым сообщением. +- Встроенные компоненты: `src/site_engine/builtin/fragments///` — `fragment.yaml` (поля/слоты), `template.html.j2`, `style.css`, необязательный `script.js`. Категории: `content`, `data`, `forms`, `marketing`, `media`, `system`. Тема — `site.yaml:theme.file` → `theme.yaml` (`schema: 1`, `preset`, `preset_version`, `overrides`); inline `theme.tokens` отклоняется. Resolver/валидация/CSS — `core/theme.py`, immutable пресеты из дизайна — `builtin/themes/v1/`. Без настройки темы используется minimal@1 в памяти. Общие стили — `builtin/base.css`, затем стили фрагментов, вычисленные токены и `builtin/containers.css`. +- Ширина блока — отдельный `layout: {section_width, content_width}`, значения `inherit|boxed|fluid|full`. Отсутствующий layout у hero/cta_banner/site_header/site_footer означает full/inherit, у остальных inherit/inherit; явный inherit берёт глобальный mode темы. `core/block_layout.py` и `layout_marks.py` применяют ширину к корням и собственным `.f-container`/`.container`, не к контейнерам вложенных блоков. Для независимой ширины фона и текста шаблон должен иметь внешний корень и внутренний контейнер; не оборачивай sticky-header общим служебным div. Контролы инспектора перенесены из design; изменение до Save остаётся в памяти вкладки. +- Компоненты сайта ищутся рекурсивно по `fragment.yaml`: работают `fragments//` и `fragments///`. Во вложенном размещении категория — первый каталог относительно `fragments/`, в плоском — `category` из YAML или `misc`. ID берётся из манифеста, остаётся плоским и уникальным; встроенные фрагменты нельзя затенять. Опциональный `preview.yaml:props` переопределяет inline `fragment.yaml:preview` по ключам; затем используются defaults полей. Для особого дизайна используй новый ID и обновляй ссылки на него в блоках; изменения builtin влияют на все сайты. - Изображения, шрифты и прочие файлы сайта — `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`. +- Новый перенос — `specs/002-site-studio-theme/{spec,plan,tasks}.md`: этапы 1–5 реализованы, контракт — `runtime.md`, результаты проверок — `verification.md` и `verification-stages-2-3.md`. Отдельный `examples/site-studio/` перенесён на штатный renderer (13 опубликованных страниц); проверка — `scripts/qa_site_studio_002.py`, отчёт — `verification-stage-4.md`. Theme Manager реализован: `/admin/theme`, `/admin/setup/theme`, ThemeService/OnboardingService, snapshot/ETag/CAS и серверный preview overlay. Источники Theme Manager — `design/theme-studio-antirion.html` и `design/assets/theme-studio.css` / `theme-studio.js`; сохраняй исходную композицию и сценарии. Runtime заменяет mock-хранилище API: edits только в памяти вкладки, явный Save, никакого localStorage с палитрой. CSS экрана ограничен theme-content, sample и страница живут в immutable iframe. Workflow — SITE_STATE_DIR/theme-onboarding.json; существующий сайт не перенаправляется. Проверка — scripts/qa_theme_manager_002.py, отчёт — verification-stage-5.md. Первый Save создаёт файл темы и ссылку через ContentService.update_files под одной блокировкой; каждая запись atomic, обычный отказ второго файла откатывает первый, но это не crash-atomic транзакция нескольких файлов. При ошибке после commit API возвращает committed snapshot; не повторяй запись вслепую. Manifest релиза фиксирует документ/effective tokens темы; build fingerprint учитывает ресурсы движка. Исторический каталог релиза не перезаписывается, rollback не меняет workspace. ## Правила интеграции diff --git a/README.md b/README.md index e8cfadb..f604658 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ pip install -e ".[dev]" # ядру нужны jinja2, PyYAML, ma site-engine validate examples/studio-site site-engine build examples/studio-site --out /tmp/studio-dist site-engine preview examples/studio-site drafts/next > /tmp/draft.html -site-engine fragments # 15 встроенных фрагментов +site-engine fragments # 17 встроенных фрагментов make test # или: pytest ``` @@ -19,6 +19,55 @@ make test # или: pytest Расширенный пример для проверки перед возможным переносом сайта — [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. +Отдельный перенос публичного дизайна из `design/examples/site-studio/` — [examples/site-studio](examples/site-studio/README.md): 13 страниц, пять layouts, общие `steps` и `entry_card`, файловая тема и ширины секций, сохранённые черновики и отключённые коллекции. `site-engine validate examples/site-studio`, `site-engine build examples/site-studio --out /tmp/site-studio-dist`; браузерная сверка с оригиналом — `PYTHONPATH=src python scripts/qa_site_studio_002.py`. Отчёт — [этап 4](specs/002-site-studio-theme/verification-stage-4.md). + +## Каталог фрагментов + +Фрагмент определяется файлом `fragment.yaml`, поиск рекурсивный. Поддерживаются прежнее плоское размещение `fragments/richtext/fragment.yaml` и категории `fragments/content/richtext/fragment.yaml`. ID берётся из манифеста и не зависит от имени папки; в блоках по-прежнему указывается `fragment: richtext`. + +Для вложенного размещения категория определяется первым каталогом относительно `fragments/` и имеет приоритет над `category` в YAML. Для плоского размещения сохраняется категория из YAML, по умолчанию `misc`. Встроенные фрагменты разложены по `content`, `data`, `forms`, `marketing`, `media`, `system`; дополнительные категории сайта допустимы. Повторные ID, включая совпадения с builtin, запрещены. + +В конструкторе категория видна рядом с названием; назначение остаётся под названием. Поиск учитывает ID, название, описание и категорию, фильтры объединяют прежние русские подписи со стандартными категориями. + +Данные для добавления блока можно вынести в соседний `preview.yaml`: + +```yaml +name: Пример текстовой секции +props: + title: Новый раздел + text: Начальный текст раздела +``` + +`props` из этого файла переопределяет одноимённые значения inline `fragment.yaml:preview`, затем применяются defaults полей. Название самого фрагмента остаётся в `fragment.yaml:name`. Некорректный preview входит в диагностику загрузки и не пропускается молча. + +Этапы 1–5 [спецификации 002](specs/002-site-studio-theme/spec.md) реализованы: категории, файловая тема, ширина блоков, отдельный Site Studio и Theme Manager. Экран `/admin/theme` доступен через «Дизайн сайта»; для нового сайта мастер открывается через `/admin/setup/theme`. [Отчёт этапа 5](specs/002-site-studio-theme/verification-stage-5.md) подготовлен к пользовательской приёмке. + +## Тема и ширина секций + +В `site.yaml` тема подключается через `theme: {file: theme.yaml}`. Документ темы: + +```yaml +schema: 1 +preset: minimal +preset_version: 1 +overrides: + colors: + primary: '#4255b9' + ui: + container: + mode: boxed + max_width: 1080 + gutter: {desktop: 36, tablet: 24, mobile: 16} +``` + +Доступны перенесённые из дизайна пресеты `minimal`, `dark`, `editorial`, `bold`, `natural`, `custom` версии 1. Один resolver проверяет цвета, разрешённые шрифты, числовые токены, дополнительные цвета и градиенты для CLI, сборки и preview. Недостаточный контраст — предупреждение. Без настройки темы новый сайт использует minimal@1 без записи файла; явная неправильная ссылка и старый inline `theme.tokens` дают ошибку. Конфигурации `studio-site` и `ai-studio` обновлены в исходниках; автоматической миграции нет. + +Блок может задать `layout: {section_width: full, content_width: boxed}`: первая ширина отвечает за фон секции, вторая — за содержимое. Допустимы `inherit`, `boxed`, `fluid`, `full`; наследование идёт от темы. В конструкторе эти поля находятся в инспекторе «Макет блока · ширина» и сохраняются в YAML при явном Save. Изменение preview не записывает страницу. + +Theme Manager переносит четыре шага исходного Antirion: пресеты, цвета/градиенты, шрифты, дизайн-токены/ширину. Правки остаются в памяти вкладки до «Сохранить тему»; YAML экспортируется после серверной проверки. Стенд компонентов и реальная страница используют изолированное серверное превью. Save изменяет workspace, публикация — отдельное действие. Состояние мастера (пропуск/повтор/завершение) хранится в `SITE_STATE_DIR/theme-onboarding.json`; палитры в нём нет. Для новых ресурсов нужна пересборка образа. Проверка: `PYTHONPATH=src python scripts/qa_theme_manager_002.py`. + +Тема и вычисленные токены фиксируются в `manifest.json` релиза; fingerprint учитывает файлы сайта и ресурсы рендера. Откат возвращает готовый HTML/CSS выбранного релиза, сохраняя рабочие файлы. Подробный контракт и таблица CSS-переменных — [runtime 002](specs/002-site-studio-theme/runtime.md), приёмка — [проверки этапов 2–3](specs/002-site-studio-theme/verification-stages-2-3.md). + ## Структура проекта ``` diff --git a/design/CHANGELOG.md b/design/CHANGELOG.md index bf5cbf7..081031b 100644 --- a/design/CHANGELOG.md +++ b/design/CHANGELOG.md @@ -1,3 +1,11 @@ + + +## 2026-11-13 — Theme Manager / setup Wizard (дополнение к Этапу 7) + +- Добавлен интерактивный мастер дизайна **публичного сайта** в 04 Antirion Rework и 06 Rose Graphite. Первичная настройка: готовые 5 presets + Custom → цвета → шрифты → tokens. +- Можно изменять выбранный пресет, просматривать Desktop/Mobile, получать предупреждения по контрасту, сохранять локальный draft и экспортировать пример `theme.yaml`. Нет реального `publish`. +- В Stage 6 `Настройки → Тема` прежняя мини-форма заменена входом в Theme Manager. Логика и палитры админки остались независимыми от пользовательской темы сайта. +- Добавлен `docs/stage7/07_THEME_MANAGER.md` и `adr/ADR-007.md`, уточнены сервисные контракты/план реализации. ADR-007 остаётся Proposed из-за отличия от inline `site.yaml.theme.tokens` в исходном ТЗ. # Site Engine — Журнал изменений ## 2026-11-12 — Этап 6: завершение HTML-админки (04/06) @@ -139,3 +147,20 @@ - Приложены исходные ТЗ и архитектурное ревью в неизменённом виде; источник и рекомендация разграничены. - Сохранены 4 утверждённых HTML-концепта и функциональные экраны Этапов 2–6 без изменений их JS/CSS. - **Backend не реализован:** этап является проектированием интеграции. + +## 2026-11-13 — Theme Manager extensions + example site-studio + +- Согласовано: без браузерных `alert()`, `confirm()`, `prompt()`. Подтверждения — собственные dialogs, результаты — toast/inline. Из `content-editor.js` удалён нативный `prompt()` поиска по исходнику. +- Theme Manager: расширяемые именованные цвета и необязательные градиенты для публичного сайта (Hero, кнопки, CTA, пользовательские роли). Экспорт в `theme.yaml`; fallback без градиентов. +- Создан `examples/site-studio/`: Pages, Collections/Entries, Layouts, Fragments, Displays, Forms, Menus, Data, Assets, YAML-тема и redirects. Сгенерирована проверяемая автономная `preview-dist/` с 13 страницами. +- Пример — единая file-first seed-модель для будущей интеграции; действующие HTML-редакторы по-прежнему работают на локальных mock и не читают seed напрямую. +- Добавлены `tools/render_preview.py`, `tools/validate_example.py`, README примера и превью главной в галерею. + + +## 2026-11-13 — Container width modes + +- В Theme Manager добавлены Boxed, Fluid, Full Width с максимальной шириной и адаптивными отступами. +- Оба редактора страниц получили независимый выбор внешней и внутренней ширины блока, поддерживающий режим наследования. +- YAML режима Эксперт, сравнение изменений и предпросмотр сохраняют `layout.section_width / content_width`. +- Обновлены образец `examples/site-studio/`, рендер публичного превью и описание интеграции в Этапе 7. +- Сохранены все четыре согласованных оформления 03–06. `alert/confirm/prompt` не используются для сообщений. diff --git a/design/README.md b/design/README.md index bcdad21..83062ae 100644 --- a/design/README.md +++ b/design/README.md @@ -2,6 +2,21 @@ **Статус:** Этапы 1–6 — интерактивный дизайн-прототип; Этап 7 — техническое проектирование переноса, **без реализации backend**. +## Дополнение от 13.11.2026 — examples/site-studio и расширенные темы + +- `examples/site-studio/` — **полный файловый пример публичного сайта**: 9 ручных страниц, 8 Entries в 5 коллекциях, 5 Layouts, 15 Fragments, 5 Display templates, 2 схемы форм, меню, data, redirects, ассеты, `site.yaml`, `theme.yaml`. +- `examples/site-studio/preview-dist/index.html` — **13 уже собранных HTML-страниц**; доступны локально. Пересборка: `python examples/site-studio/tools/render_preview.py` при наличии PyYAML, Jinja2 и mistune. +- `theme.yaml` содержит стандартные семантические цвета, пользовательские `custom_colors` и опциональные именованные `gradients` (`enabled: false` = однотонные фоны). Это конфигурация **публичного сайта**, а не Antirion/Rose theme админки. +- Мастер Theme Manager в обоих оформлениях позволяет добавлять свои цвета/градиенты, проверять превью и экспортировать `theme.yaml`; подтверждения — только собственные модальные окна, уведомления — toast/inline, **без нативных `alert()/confirm()/prompt()`**. +- Убрана последняя нативная `prompt()` из редактора исходника Entry; вместо неё кастомный поиск. +- Файлы примера **ещё не подключены к HTML mock-редакторам**. Их разрозненные `localStorage` должны быть заменены этими file-first документами после реализации backend. Пример также не является production-renderer: статическое HTML создаёт вспомогательный mini-renderer. + +## Дополнение от 13.11.2026 — Theme Manager / первый вход + +В пакет добавлен отдельный дизайн-прототип настроек **публичной темы сайта** для двух активных тем админки: `theme-studio-antirion.html` и `theme-studio-rose-graphite.html`. Пять готовых пресетов + Custom, палитра, шрифты, дизайн-токены, превью, локальное сохранение черновика и экспорт примера `theme.yaml`. Из `modules-*.html?section=settings` → вкладка «Тема» — ссылка на мастер. Реального backend и изменения live нет. + +**Техническое дополнение:** [`docs/stage7/07_THEME_MANAGER.md`](docs/stage7/07_THEME_MANAGER.md), открытый [`ADR-007`](docs/stage7/adr/ADR-007.md). В исходном ТЗ токены inline в `site.yaml`; выделение `theme.yaml` ещё требует архитектурного утверждения. Утверждённые четыре дизайна 03–06 сохранены, оболочки старых экранов неизменны, кроме ссылки на мастер в «Настройках». + ## Быстрое открытие - `index.html` — галерея четырёх утверждённых визуальных вариантов 03–06. @@ -9,6 +24,7 @@ - `content-antirion.html` / `content-rose-graphite.html` — коллекции и записи. - `publication-antirion.html` / `publication-rose-graphite.html` — публикация, история, rollback (mock). - `modules-antirion.html` / `modules-rose-graphite.html` — Медиа, Структура, Формы и заявки, Настройки, Журнал. +- `theme-studio-antirion.html` / `theme-studio-rose-graphite.html` — Theme Manager, мастер первоначальной настройки публичной темы. ## Этап 7 — документы @@ -29,6 +45,15 @@ ## Как использовать с кодовым агентом -Передайте агенту весь ZIP, попросите прочитать `docs/stage7/IMPLEMENTATION_HANDOFF_PROMPT.md`. Согласуйте ADR-001/002/003/004/005/006, затем V0 и V1; не пытайтесь реализовать все модули одновременно. +Передайте агенту весь ZIP, попросите прочитать `docs/stage7/IMPLEMENTATION_HANDOFF_PROMPT.md`. Согласуйте ADR-001/002/003/004/005/006/007, затем V0 и V1; не пытайтесь реализовать все модули одновременно. Для общего localStorage текущего mock между вкладками можно открыть прототип через `python -m http.server 8000`, но это не сервер CMS. + + +## Обновление: Fluid / Boxed / Full Width + +- Theme Manager (`theme-studio-antirion.html`, `theme-studio-rose-graphite.html`) → шаг 4 «Дизайн-код» — режим, max width, отступы. +- Конструкторы (`builder-antirion.html`, `builder-rose-graphite.html`) → инспектор блока → независимые настройки **Внешняя секция** / **Контент**. +- Эксперт показывает `layout.section_width` и `layout.content_width` того же блока; unsupported values не применяются. +- Демо-файлы `examples/site-studio/theme.yaml`, `pages/index.md` и `preview-dist/` обновлены. +- Это всё ещё HTML mock без server-side persistence; в backend будет нужна отдельная валидируемая схема LayoutTokens. diff --git a/design/assets/builder.js b/design/assets/builder.js index 2d8cff6..949d49a 100644 --- a/design/assets/builder.js +++ b/design/assets/builder.js @@ -20,7 +20,10 @@ const F={ 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 WIDTH_MODES=['inherit','boxed','fluid','full']; +const defaultWidth=fragment=>({section_width:['hero','cta_banner'].includes(fragment)?'full':'inherit',content_width:'inherit'}); +const blockLayout=b=>({...defaultWidth(b.fragment),...(b.layout||{})}); +const block=(id,fragment,props={},bindings={},extra={})=>({id,fragment,props:{...F[fragment].defaults,...props},bindings,visible:true,anchor:'',note:'',layout:defaultWidth(fragment),...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'}}), @@ -180,7 +183,8 @@ function fieldHTML(b,[key,name,type]){ 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 blockWidthControls(b){const layout=blockLayout(b);const options=[['inherit','Наследовать'],['boxed','Boxed'],['fluid','Fluid'],['full','Full Width']];return `
Макет блока · ширина
Пример: фон Hero — Full Width, текст — Boxed. Наследовать использует настройки темы публичного сайта; сохраняется в layout блока.
`;} +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('')}${blockWidthControls(b)}${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); @@ -212,7 +216,22 @@ function pageTab(){let p=page(),diags=pageDiagnostics(p),hasBody=p.blocks.some(b 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=''; +function currentThemeContainer(){const fallback={mode:'boxed',max_width:1080,gutter:{desktop:32,tablet:24,mobile:16}};try{const stored=JSON.parse(localStorage.getItem('site-engine-theme-manager-v1')||'null');const c=stored?.tokens?.ui?.container;if(typeof c==='number')return {...fallback,max_width:c};if(!c||!['boxed','fluid','full'].includes(c.mode))return fallback;return {mode:c.mode,max_width:Number(c.max_width)||1080,gutter:{...fallback.gutter,...(c.gutter||{})}};}catch{return fallback;}} +const previewContainer=currentThemeContainer(); +const layoutCss=` +:root{--preview-gutter:${previewContainer.gutter.desktop}px;--preview-container:${previewContainer.max_width}px;--preview-mode:${previewContainer.mode}} +[data-section-width=boxed]{width:calc(100% - 2 * var(--preview-gutter));max-width:var(--preview-container);margin-inline:auto} +[data-section-width=fluid]{width:calc(100% - 2 * var(--preview-gutter));max-width:none;margin-inline:auto} +[data-section-width=full]{width:100%;max-width:none;margin-inline:0} +[data-content-width=boxed] .inner{max-width:var(--preview-container);padding-inline:var(--preview-gutter)} +[data-content-width=fluid] .inner{max-width:none;padding-inline:var(--preview-gutter)} +[data-content-width=full] .inner{max-width:none;padding-inline:0} +[data-content-width=inherit] .inner{max-width:var(--preview-container);padding-inline:var(--preview-gutter)} +[data-section-width=inherit]{width:100%} +@media(max-width:1023px){:root{--preview-gutter:${previewContainer.gutter.tablet}px}} +@media(max-width:700px){:root{--preview-gutter:${previewContainer.gutter.mobile}px}} +`; +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 layout=blockLayout(b);const outer=layout.section_width==='inherit'?previewContainer.mode:layout.section_width;const inner=layout.content_width==='inherit'?previewContainer.mode:layout.content_width;const att=`data-bid="${esc(b.id)}" data-section-width="${esc(outer)}" data-content-width="${esc(inner)}" 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); @@ -226,7 +245,7 @@ case'faq':content=`

${v('heading')}

${!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/examples/site-studio/layouts/default/layout.yaml b/design/examples/site-studio/layouts/default/layout.yaml new file mode 100644 index 0000000..ab1e3bc --- /dev/null +++ b/design/examples/site-studio/layouts/default/layout.yaml @@ -0,0 +1,32 @@ +id: default +name: Default / Внутренняя +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + cta_label: Обсудить проект + cta_url: /request/ +- id: main + allow: + - hero + - section + - steps + - card_grid + - collection_list + - richtext + - faq + - image + - cta_banner + - entry_card + - entry_header + - form + - disclaimer +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/design/examples/site-studio/layouts/form-page/layout.html.j2 b/design/examples/site-studio/layouts/form-page/layout.html.j2 new file mode 100644 index 0000000..4a3d3d0 --- /dev/null +++ b/design/examples/site-studio/layouts/form-page/layout.html.j2 @@ -0,0 +1,7 @@ + + + +{{ page.seo.title or page.title }} — {{ site.name }} +{{ theme_style|safe }} +{{ region('header')|safe }}
{{ region('main')|safe }}
{{ region('footer')|safe }} + diff --git a/design/examples/site-studio/layouts/form-page/layout.yaml b/design/examples/site-studio/layouts/form-page/layout.yaml new file mode 100644 index 0000000..cd0a289 --- /dev/null +++ b/design/examples/site-studio/layouts/form-page/layout.yaml @@ -0,0 +1,24 @@ +id: form-page +name: Форма заявки +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + cta_label: Обсудить проект + cta_url: /request/ +- id: main + allow: + - hero + - form + - richtext + - section + - cta_banner +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/design/examples/site-studio/layouts/landing/layout.html.j2 b/design/examples/site-studio/layouts/landing/layout.html.j2 new file mode 100644 index 0000000..4a3d3d0 --- /dev/null +++ b/design/examples/site-studio/layouts/landing/layout.html.j2 @@ -0,0 +1,7 @@ + + + +{{ page.seo.title or page.title }} — {{ site.name }} +{{ theme_style|safe }} +{{ region('header')|safe }}
{{ region('main')|safe }}
{{ region('footer')|safe }} + diff --git a/design/examples/site-studio/layouts/landing/layout.yaml b/design/examples/site-studio/layouts/landing/layout.yaml new file mode 100644 index 0000000..9ed6f75 --- /dev/null +++ b/design/examples/site-studio/layouts/landing/layout.yaml @@ -0,0 +1,30 @@ +id: landing +name: Landing / Главная +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + cta_label: Обсудить проект + cta_url: /request/ +- id: main + allow: + - hero + - section + - steps + - card_grid + - collection_list + - cta_banner + - richtext + - faq + - image + - entry_card + - form +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/design/examples/site-studio/layouts/legal/layout.html.j2 b/design/examples/site-studio/layouts/legal/layout.html.j2 new file mode 100644 index 0000000..4a3d3d0 --- /dev/null +++ b/design/examples/site-studio/layouts/legal/layout.html.j2 @@ -0,0 +1,7 @@ + + + +{{ page.seo.title or page.title }} — {{ site.name }} +{{ theme_style|safe }} +{{ region('header')|safe }}
{{ region('main')|safe }}
{{ region('footer')|safe }} + diff --git a/design/examples/site-studio/layouts/legal/layout.yaml b/design/examples/site-studio/layouts/legal/layout.yaml new file mode 100644 index 0000000..ac896b1 --- /dev/null +++ b/design/examples/site-studio/layouts/legal/layout.yaml @@ -0,0 +1,23 @@ +id: legal +name: Legal / Юридическая +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + cta_label: Обсудить проект + cta_url: /request/ +- id: main + allow: + - hero + - richtext + - disclaimer + - section +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/design/examples/site-studio/layouts/minimal/layout.html.j2 b/design/examples/site-studio/layouts/minimal/layout.html.j2 new file mode 100644 index 0000000..4a3d3d0 --- /dev/null +++ b/design/examples/site-studio/layouts/minimal/layout.html.j2 @@ -0,0 +1,7 @@ + + + +{{ page.seo.title or page.title }} — {{ site.name }} +{{ theme_style|safe }} +{{ region('header')|safe }}
{{ region('main')|safe }}
{{ region('footer')|safe }} + diff --git a/design/examples/site-studio/layouts/minimal/layout.yaml b/design/examples/site-studio/layouts/minimal/layout.yaml new file mode 100644 index 0000000..b10246f --- /dev/null +++ b/design/examples/site-studio/layouts/minimal/layout.yaml @@ -0,0 +1,23 @@ +id: minimal +name: Minimal / Результат +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + cta_label: Обсудить проект + cta_url: /request/ +- id: main + allow: + - hero + - richtext + - cta_banner + - section +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/design/examples/site-studio/menus/footer.yaml b/design/examples/site-studio/menus/footer.yaml new file mode 100644 index 0000000..841c114 --- /dev/null +++ b/design/examples/site-studio/menus/footer.yaml @@ -0,0 +1,11 @@ +id: footer +name: Меню футера +items: +- id: privacy + label: Политика конфиденциальности + page: /privacy/ + enabled: true +- id: request + label: Оставить заявку + page: /request/ + enabled: true diff --git a/design/examples/site-studio/menus/main.yaml b/design/examples/site-studio/menus/main.yaml new file mode 100644 index 0000000..f68e20e --- /dev/null +++ b/design/examples/site-studio/menus/main.yaml @@ -0,0 +1,23 @@ +id: main +name: Главная навигация +items: +- id: home + label: Главная + page: / + enabled: true +- id: services + label: Услуги + page: /services/ + enabled: true +- id: cases + label: Кейсы + page: /cases/ + enabled: true +- id: about + label: О компании + page: /about/ + enabled: true +- id: contacts + label: Контакты + page: /contacts/ + enabled: true diff --git a/design/examples/site-studio/pages/about.md b/design/examples/site-studio/pages/about.md new file mode 100644 index 0000000..117a34b --- /dev/null +++ b/design/examples/site-studio/pages/about.md @@ -0,0 +1,36 @@ +--- +schema: 1 +title: О компании +layout: default +status: published +route: /about/ +seo: + title: О студии + description: Наша команда и инженерный подход. +regions: + main: + - id: about_intro + fragment: hero + props: + title: Команда, которая делает AI полезным + subtitle: От идеи до работающего продукта. + button: Связаться + buttonUrl: /contacts/ + - id: body_about + fragment: richtext + props: + heading: О студии + source: body + - id: team_asset + fragment: image + props: + asset: assets/team.webp + alt: Иллюстрация команды студии +--- +Мы небольшая инженерная команда, ориентированная на **измеримые результаты**. + +Проектируем решения, которые действительно помогают сотрудникам и клиентам. + +- Прорабатываем задачу перед разработкой. +- Строим понятные интеграции и сценарии. +- Поддерживаем решения после запуска. diff --git a/design/examples/site-studio/pages/cases/index.md b/design/examples/site-studio/pages/cases/index.md new file mode 100644 index 0000000..6850535 --- /dev/null +++ b/design/examples/site-studio/pages/cases/index.md @@ -0,0 +1,26 @@ +--- +schema: 1 +title: Кейсы +layout: default +status: published +route: /cases/ +seo: + title: Кейсы автоматизации + description: Примеры проектов и прототипов студии. +regions: + main: + - id: cases_head + fragment: hero + props: + title: Что мы уже сделали + subtitle: Примеры внедрения автоматизации и AI в рабочие процессы. + button: Обсудить задачу + buttonUrl: /request/ + - id: cases_query + fragment: collection_list + props: + collection: cases + heading: Проекты + limit: 6 + sort: order +--- diff --git a/design/examples/site-studio/pages/contacts.md b/design/examples/site-studio/pages/contacts.md new file mode 100644 index 0000000..33c9f83 --- /dev/null +++ b/design/examples/site-studio/pages/contacts.md @@ -0,0 +1,31 @@ +--- +schema: 1 +title: Контакты +layout: default +status: published +route: /contacts/ +seo: + title: Контакты студии + description: Свяжитесь с нами для обсуждения проекта. +regions: + main: + - id: contacts_head + fragment: hero + props: + title: Давайте знакомиться + subtitle: Расскажите нам о вашей задаче. + button: Оставить заявку + buttonUrl: /request/ + - id: contacts_copy + fragment: section + props: + heading: На связи + text: 'Электронная почта: hello@studio.example · Telegram: @studio_demo' + - id: contacts_cta + fragment: cta_banner + props: + title: Есть задача? + text: Выберем оптимальный формат запуска. + button: Обсудить проект + buttonUrl: /request/ +--- diff --git a/design/examples/site-studio/pages/index.md b/design/examples/site-studio/pages/index.md new file mode 100644 index 0000000..e44b8a6 --- /dev/null +++ b/design/examples/site-studio/pages/index.md @@ -0,0 +1,56 @@ +--- +schema: 1 +title: Главная +layout: landing +status: published +route: / +seo: + title: Разработка Telegram-ботов и AI-систем + description: Автоматизация бизнес-процессов и создание AI-решений. +regions: + main: + - id: hero_home + fragment: hero + layout: + section_width: full + content_width: boxed + props: + title: Автоматизируем бизнес с помощью AI + subtitle: Telegram-боты, AI-ассистенты и интеграции, которые решают задачи, а не просто отвечают на сообщения. + button: Обсудить проект + buttonUrl: /request/ + - id: services_list + fragment: collection_list + layout: + section_width: fluid + content_width: fluid + props: + heading: Наши направления + collection: services + limit: 3 + sort: order + - id: benefits_grid + fragment: card_grid + props: + heading: Почему нам доверяют + card1: Под задачу, а не по шаблону + card2: Интеграции с вашим стеком + card3: Сопровождение после запуска + - id: process_steps + fragment: steps + props: + heading: Как мы работаем + step1: Исследование + step2: Разработка + step3: Внедрение + - id: cta_home + fragment: cta_banner + layout: + section_width: full + content_width: boxed + props: + title: Обсудим вашу задачу? + text: Расскажите о задаче — подскажем решение. + button: Оставить заявку + buttonUrl: /request/ +--- diff --git a/design/examples/site-studio/pages/privacy.md b/design/examples/site-studio/pages/privacy.md new file mode 100644 index 0000000..afeef10 --- /dev/null +++ b/design/examples/site-studio/pages/privacy.md @@ -0,0 +1,24 @@ +--- +schema: 1 +title: Политика конфиденциальности +layout: legal +status: published +route: /privacy/ +seo: + title: Политика конфиденциальности + description: Демонстрационный документ по обработке данных. +regions: + main: + - id: privacy_text + fragment: richtext + props: + heading: Обработка данных + source: body + - id: privacy_disclaimer + fragment: disclaimer + props: + text: Демонстрационный текст. Перед публикацией настоящего сайта необходима юридическая проверка. +--- +Это **пример**, не юридически действующая политика конфиденциальности. + +При разработке настоящего сайта необходимо описать правовые основания обработки данных, сроки хранения, права посетителей и способы связи с оператором. diff --git a/design/examples/site-studio/pages/request.md b/design/examples/site-studio/pages/request.md new file mode 100644 index 0000000..b8b273c --- /dev/null +++ b/design/examples/site-studio/pages/request.md @@ -0,0 +1,33 @@ +--- +schema: 1 +title: Заявка +layout: form-page +status: published +route: /request/ +seo: + title: Обсудить проект + description: Форма первичного обращения в студию. +regions: + main: + - id: request_head + fragment: hero + props: + title: Расскажите о задаче + subtitle: Мы свяжемся с вами после уточнения деталей. + button: '' + buttonUrl: '' + - id: request_form + fragment: form + props: + form_id: form_contact + heading: Оставить заявку + description: Заполните форму — в демонстрации данные никуда не отправляются. + - id: request_body + fragment: richtext + props: + heading: Как происходит знакомство + source: body +--- +Опишите задачу своими словами. На реальном сайте мы сначала уточним детали и только затем предложим вариант решения. + +Это демонстрационный сайт: **не отправляйте реальные персональные данные**. diff --git a/design/examples/site-studio/pages/scenarios/index.md b/design/examples/site-studio/pages/scenarios/index.md new file mode 100644 index 0000000..53aabae --- /dev/null +++ b/design/examples/site-studio/pages/scenarios/index.md @@ -0,0 +1,26 @@ +--- +schema: 1 +title: Решения по отраслям +layout: default +status: published +route: /scenarios/ +seo: + title: Решения для отраслей + description: Сценарии автоматизации под задачи бизнеса. +regions: + main: + - id: scenarios_head + fragment: hero + props: + title: Решения для вашей сферы + subtitle: Подстраиваем AI и автоматизацию под процессы команды. + button: Обсудить проект + buttonUrl: /request/ + - id: scenarios_query + fragment: collection_list + props: + collection: scenarios + heading: Сценарии + limit: 6 + sort: order +--- diff --git a/design/examples/site-studio/pages/services/_section.yaml b/design/examples/site-studio/pages/services/_section.yaml new file mode 100644 index 0000000..fd3a233 --- /dev/null +++ b/design/examples/site-studio/pages/services/_section.yaml @@ -0,0 +1,4 @@ +section: services +layout: default +menu: main +sort: order diff --git a/design/examples/site-studio/pages/services/index.md b/design/examples/site-studio/pages/services/index.md new file mode 100644 index 0000000..952be0c --- /dev/null +++ b/design/examples/site-studio/pages/services/index.md @@ -0,0 +1,32 @@ +--- +schema: 1 +title: Услуги +layout: default +status: published +route: /services/ +seo: + title: Наши услуги + description: Telegram-боты, AI и автоматизация. +regions: + main: + - id: services_head + fragment: hero + props: + title: Сервисы и решения + subtitle: Подберём стек и формат под процессы вашей команды. + button: Обсудить проект + buttonUrl: /request/ + - id: services_query + fragment: collection_list + props: + collection: services + heading: Каталог услуг + limit: 6 + sort: order + - id: services_faq + fragment: faq + props: + heading: Частые вопросы + question: С чего начать проект? + answer: С короткого обсуждения бизнес-задачи и входных данных. +--- diff --git a/design/examples/site-studio/pages/thank-you.md b/design/examples/site-studio/pages/thank-you.md new file mode 100644 index 0000000..53d4eaf --- /dev/null +++ b/design/examples/site-studio/pages/thank-you.md @@ -0,0 +1,19 @@ +--- +schema: 1 +title: Спасибо за заявку +layout: minimal +status: published +route: /thank-you/ +seo: + title: Спасибо! + description: Страница подтверждения отправки формы. +regions: + main: + - id: thanks_hero + fragment: hero + props: + title: Спасибо за обращение! + subtitle: Мы получили вашу заявку. Это демонстрационная страница, не подтверждение реальной отправки. + button: На главную + buttonUrl: / +--- diff --git a/design/examples/site-studio/preview-dist/about/index.html b/design/examples/site-studio/preview-dist/about/index.html new file mode 100644 index 0000000..e3796c9 --- /dev/null +++ b/design/examples/site-studio/preview-dist/about/index.html @@ -0,0 +1,16 @@ + + + +О студии — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Команда, которая делает AI полезным

От идеи до работающего продукта.

Связаться →
+

О студии

Мы небольшая инженерная команда, ориентированная на измеримые результаты.

+

Проектируем решения, которые действительно помогают сотрудникам и клиентам.

+
    +
  • Прорабатываем задачу перед разработкой.
  • +
  • Строим понятные интеграции и сценарии.
  • +
  • Поддерживаем решения после запуска.
  • +
+
+
Иллюстрация команды студии
Иллюстрация команды студии
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/assets/ai.webp b/design/examples/site-studio/preview-dist/assets/ai.webp new file mode 100644 index 0000000..3d97dd3 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/ai.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/automation.webp b/design/examples/site-studio/preview-dist/assets/automation.webp new file mode 100644 index 0000000..b23da26 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/automation.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/booking.webp b/design/examples/site-studio/preview-dist/assets/booking.webp new file mode 100644 index 0000000..8688792 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/booking.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/bots.webp b/design/examples/site-studio/preview-dist/assets/bots.webp new file mode 100644 index 0000000..f6d177e Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/bots.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/case-reception.webp b/design/examples/site-studio/preview-dist/assets/case-reception.webp new file mode 100644 index 0000000..9d2c330 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/case-reception.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/case.webp b/design/examples/site-studio/preview-dist/assets/case.webp new file mode 100644 index 0000000..9d2c330 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/case.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/hero-studio.webp b/design/examples/site-studio/preview-dist/assets/hero-studio.webp new file mode 100644 index 0000000..0af3c29 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/hero-studio.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/hero.webp b/design/examples/site-studio/preview-dist/assets/hero.webp new file mode 100644 index 0000000..0af3c29 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/hero.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/houses.webp b/design/examples/site-studio/preview-dist/assets/houses.webp new file mode 100644 index 0000000..b06a98a Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/houses.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/legal.webp b/design/examples/site-studio/preview-dist/assets/legal.webp new file mode 100644 index 0000000..900af51 Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/legal.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/site-mark.svg b/design/examples/site-studio/preview-dist/assets/site-mark.svg new file mode 100644 index 0000000..3f4c236 --- /dev/null +++ b/design/examples/site-studio/preview-dist/assets/site-mark.svg @@ -0,0 +1 @@ +Знак студии (демо) \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/assets/site.css b/design/examples/site-studio/preview-dist/assets/site.css new file mode 100644 index 0000000..84c140a --- /dev/null +++ b/design/examples/site-studio/preview-dist/assets/site.css @@ -0,0 +1,21 @@ +/* Demo public-site styles. Tokens are resolved from theme.yaml by tools/render_preview.py. */ +:root{--color-background:#fbfaf7;--color-surface:#fff;--color-text:#191e23;--color-muted:#5a6670;--color-primary:#9a6cfa;--color-secondary:#f0f1ef;--color-accent:#d4beff;--color-border:#e0e1de;--radius:7px;--container:1080px;--hero-gradient:linear-gradient(145deg,#1e2735,#15202d 55%,#31344a);--button-gradient:linear-gradient(105deg,#d4beff,#b5abf9);--cta-gradient:linear-gradient(125deg,#dfe3f2,#eef0fc);--font-body:system-ui,sans-serif;--font-heading:system-ui,sans-serif} +*{box-sizing:border-box}html{scroll-behavior:smooth}body{margin:0;background:var(--color-background);color:var(--color-text);font:14px/1.6 var(--font-body)}a{color:inherit;text-decoration:none}button,input,textarea{font:inherit}.container{max-width:var(--container);padding:0 36px;margin:auto}.site-header{position:sticky;top:0;z-index:10;border-bottom:1px solid var(--color-border);background:#fffdfdf5;backdrop-filter:blur(12px)}.site-header .container{height:64px;display:flex;align-items:center;justify-content:space-between;gap:18px}.brand{display:flex;align-items:center;gap:8px;font-size:16px;font-weight:750}.brandmark{width:28px;height:28px;display:grid;place-items:center;background:#1d2635;color:#fff;border-radius:6px}.site-header nav{display:flex;gap:18px;color:#657081;font-size:12px}.site-header nav a:hover,.site-footer a:hover{text-decoration:underline}.smallbtn,.btn{display:inline-flex;align-items:center;justify-content:center;background:var(--color-primary);color:white;border:0;border-radius:var(--radius);font-weight:750;padding:10px 16px;font-size:12px}.smallbtn{background:#1e2938}.hero{padding:85px 0 90px;background:var(--hero-gradient);color:#fff;min-height:330px}.hero .tag,.entry-intro .tag{color:#c5d1e8;letter-spacing:.16em;font-size:10px;font-weight:700}.hero h1,.entry-intro h1{font:750 clamp(31px,4.2vw,54px)/1.12 var(--font-heading);letter-spacing:-.055em;max-width:720px;margin:18px 0}.hero p{color:#c5ccdc;max-width:590px;font-size:14px}.hero .btn{margin-top:22px;background:var(--button-gradient);color:#242438}.section{padding:58px 0}.section.alt{background:var(--color-secondary)}.section h2,.cta h2{font:700 30px/1.2 var(--font-heading);letter-spacing:-.045em;margin:0 0 14px}.section p,.cta p{color:var(--color-muted)}.section-lead{margin-top:-4px}.cards{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:16px;margin-top:24px}.card{display:block;padding:22px 20px;background:var(--color-surface);border:1px solid var(--color-border);border-radius:var(--radius);min-height:130px}.card small{color:#8174bd;font-weight:800;font-size:10px}.card strong{display:block;font-size:16px;margin:14px 0 5px}.card p{font-size:12px;margin:0}.card.standalone{max-width:440px}.steps{display:grid;grid-template-columns:repeat(3,1fr);gap:24px;margin-top:25px}.steps div{border-top:1px solid var(--color-border);padding-top:14px}.steps span{display:block;color:#8c7ac9;font-size:11px}.steps b{font-size:18px}.cta{padding:55px 0;background:var(--cta-gradient)}.cta h2{font-size:36px}.cta .btn{background:#1d2432;color:#fff;margin-top:16px}.site-footer{padding:26px 0;background:#18202b;color:#bdc7d3;font-size:11px}.footer-inner{display:flex;align-items:center;justify-content:space-between;gap:16px}.site-footer nav{display:flex;gap:16px}.faq{border-top:1px solid var(--color-border);border-bottom:1px solid var(--color-border);padding:14px 0}.faq summary{font-weight:650;cursor:pointer}.faq p{margin:10px 0}.site-image{margin:0}.site-image img,.entry-cover{width:100%;max-width:850px;display:block;border-radius:var(--radius)}.site-image figcaption{font-size:11px;color:var(--color-muted);margin-top:6px}.entry-intro{padding:72px 0 55px;background:#1f2937;color:#fff}.entry-intro p{max-width:660px;color:#ccd4e2}.entry-cover{margin-top:20px}.prose{max-width:1080px}.prose :is(p,ul){max-width:740px}.prose a{color:var(--color-primary);text-decoration:underline}.disclaimer{border-top:1px solid var(--color-border);background:#fff2eb}.demo-form{margin-top:20px;max-width:620px;display:grid;gap:14px}.demo-form label{display:grid;gap:6px;font-size:12px;font-weight:600}.demo-form :is(input,textarea){width:100%;border:1px solid var(--color-border);border-radius:var(--radius);background:white;padding:11px 12px}.demo-form textarea{min-height:110px;resize:vertical}.demo-form .btn{justify-self:start}.form-feedback{font-size:11px!important;margin:0}.site-header :focus-visible,.site-footer :focus-visible,.btn:focus-visible{outline:2px solid var(--color-primary);outline-offset:3px} +@media(max-width:700px){.container{padding:0 20px}.site-header nav,.site-header .smallbtn{display:none}.hero{padding:56px 0}.section{padding:39px 0}.cards,.steps{grid-template-columns:1fr}.card{min-height:auto}.site-footer .footer-inner{flex-direction:column;align-items:flex-start}.cta h2{font-size:28px}} + +/* Site Engine container modes: section/background vs. inner content. */ +:root{--container-max:1080px;--gutter-desktop:36px;--gutter-tablet:24px;--gutter-mobile:16px;--active-gutter:var(--gutter-desktop)} +/* Global layout default for header/footer and non-overridden content */ +.container{width:100%;max-width:var(--container-max);padding-inline:var(--active-gutter);margin-inline:auto} +body[data-container-mode="fluid"] .container{max-width:none} +body[data-container-mode="full"] .container{max-width:none;padding-inline:0} +/* block-shell owns the background extent; nested .container owns the text width */ +.block-shell{width:100%;max-width:none;margin-inline:auto;min-width:0} +.block-shell[data-section-width="boxed"]{width:calc(100% - 2*var(--active-gutter));max-width:var(--container-max)} +.block-shell[data-section-width="fluid"]{width:calc(100% - 2*var(--active-gutter));max-width:none} +.block-shell[data-section-width="full"]{width:100%;max-width:none} +.block-shell[data-content-width="boxed"] .container{width:100%;max-width:var(--container-max);padding-inline:var(--active-gutter)} +.block-shell[data-content-width="fluid"] .container{width:100%;max-width:none;padding-inline:var(--active-gutter)} +.block-shell[data-content-width="full"] .container{width:100%;max-width:none;padding-inline:0} +@media(max-width:1023px){:root{--active-gutter:var(--gutter-tablet)}} +@media(max-width:699px){:root{--active-gutter:var(--gutter-mobile)}} diff --git a/design/examples/site-studio/preview-dist/assets/site.js b/design/examples/site-studio/preview-dist/assets/site.js new file mode 100644 index 0000000..c2d4491 --- /dev/null +++ b/design/examples/site-studio/preview-dist/assets/site.js @@ -0,0 +1,4 @@ +/* Public preview interaction. No alerts; no data exfiltration. */ +document.querySelectorAll('form.demo-form').forEach(form=>form.addEventListener('submit',event=>{ + event.preventDefault();const status=form.querySelector('.form-feedback');if(status)status.textContent='Демо: форма не отправлена. Подключение FormService планируется при backend-интеграции.'; +})); diff --git a/design/examples/site-studio/preview-dist/assets/team-working.webp b/design/examples/site-studio/preview-dist/assets/team-working.webp new file mode 100644 index 0000000..0c424ae Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/team-working.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/team.webp b/design/examples/site-studio/preview-dist/assets/team.webp new file mode 100644 index 0000000..0c424ae Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/team.webp differ diff --git a/design/examples/site-studio/preview-dist/assets/telegram-bots.webp b/design/examples/site-studio/preview-dist/assets/telegram-bots.webp new file mode 100644 index 0000000..f6d177e Binary files /dev/null and b/design/examples/site-studio/preview-dist/assets/telegram-bots.webp differ diff --git a/design/examples/site-studio/preview-dist/cases/ai-reception/index.html b/design/examples/site-studio/preview-dist/cases/ai-reception/index.html new file mode 100644 index 0000000..561c9d3 --- /dev/null +++ b/design/examples/site-studio/preview-dist/cases/ai-reception/index.html @@ -0,0 +1,13 @@ + + + +AI-приёмная для сервиса — Студия автоматизации + +
STUDIO / CASES

AI-приёмная для сервиса

Автоматизация обработки обращений и классификации заявок.

+

Задача

+

Клиенты обращаются через разные каналы, а операторам требуется единый поток заявок.

+

Решение

+

Помощник помогает структурировать и направлять обращения. Показатели в этом примере не являются реальной статистикой.

+
+

Обсудим ваш проект?

Расскажите, какие задачи хотите автоматизировать.

Оставить заявку →
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/cases/index.html b/design/examples/site-studio/preview-dist/cases/index.html new file mode 100644 index 0000000..829c845 --- /dev/null +++ b/design/examples/site-studio/preview-dist/cases/index.html @@ -0,0 +1,8 @@ + + + +Кейсы автоматизации — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Что мы уже сделали

Примеры внедрения автоматизации и AI в рабочие процессы.

Обсудить задачу →
+
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/contacts/index.html b/design/examples/site-studio/preview-dist/contacts/index.html new file mode 100644 index 0000000..aa53b7c --- /dev/null +++ b/design/examples/site-studio/preview-dist/contacts/index.html @@ -0,0 +1,9 @@ + + + +Контакты студии — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Давайте знакомиться

Расскажите нам о вашей задаче.

Оставить заявку →
+

На связи

Электронная почта: hello@studio.example · Telegram: @studio_demo

+

Есть задача?

Выберем оптимальный формат запуска.

Обсудить проект →
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/index.html b/design/examples/site-studio/preview-dist/index.html new file mode 100644 index 0000000..e4d459b --- /dev/null +++ b/design/examples/site-studio/preview-dist/index.html @@ -0,0 +1,11 @@ + + + +Разработка Telegram-ботов и AI-систем — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Автоматизируем бизнес с помощью AI

Telegram-боты, AI-ассистенты и интеграции, которые решают задачи, а не просто отвечают на сообщения.

Обсудить проект →
+ +

Почему нам доверяют

01 / VALUEПод задачу, а не по шаблону

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

02 / VALUEИнтеграции с вашим стеком

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

03 / VALUEСопровождение после запуска

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

+

Как мы работаем

01Исследование
02Разработка
03Внедрение
+

Обсудим вашу задачу?

Расскажите о задаче — подскажем решение.

Оставить заявку →
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/privacy/index.html b/design/examples/site-studio/preview-dist/privacy/index.html new file mode 100644 index 0000000..c9a34fb --- /dev/null +++ b/design/examples/site-studio/preview-dist/privacy/index.html @@ -0,0 +1,10 @@ + + + +Политика конфиденциальности — Студия автоматизации + +

Обработка данных

Это пример, не юридически действующая политика конфиденциальности.

+

При разработке настоящего сайта необходимо описать правовые основания обработки данных, сроки хранения, права посетителей и способы связи с оператором.

+
+
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/request/index.html b/design/examples/site-studio/preview-dist/request/index.html new file mode 100644 index 0000000..5f3f768 --- /dev/null +++ b/design/examples/site-studio/preview-dist/request/index.html @@ -0,0 +1,11 @@ + + + +Обсудить проект — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Расскажите о задаче

Мы свяжемся с вами после уточнения деталей.

+

Оставить заявку

Заполните форму — в демонстрации данные никуда не отправляются.

+

Как происходит знакомство

Опишите задачу своими словами. На реальном сайте мы сначала уточним детали и только затем предложим вариант решения.

+

Это демонстрационный сайт: не отправляйте реальные персональные данные.

+
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/scenarios/index.html b/design/examples/site-studio/preview-dist/scenarios/index.html new file mode 100644 index 0000000..e6297d4 --- /dev/null +++ b/design/examples/site-studio/preview-dist/scenarios/index.html @@ -0,0 +1,8 @@ + + + +Решения для отраслей — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Решения для вашей сферы

Подстраиваем AI и автоматизацию под процессы команды.

Обсудить проект →
+
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/scenarios/legal/index.html b/design/examples/site-studio/preview-dist/scenarios/legal/index.html new file mode 100644 index 0000000..bb1f1b6 --- /dev/null +++ b/design/examples/site-studio/preview-dist/scenarios/legal/index.html @@ -0,0 +1,11 @@ + + + +Для юридических компаний — Студия автоматизации + +
STUDIO / SCENARIOS

Для юридических компаний

Обработка обращений, извлечение данных из документов, AI-поиск.

+

Автоматизация юридической практики

+

Сбор первичной информации и структурирование документов.

+
+

Обсудим ваш проект?

Расскажите, какие задачи хотите автоматизировать.

Оставить заявку →
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/services/ai/index.html b/design/examples/site-studio/preview-dist/services/ai/index.html new file mode 100644 index 0000000..1e7cf09 --- /dev/null +++ b/design/examples/site-studio/preview-dist/services/ai/index.html @@ -0,0 +1,12 @@ + + + +AI-ассистенты — Студия автоматизации + +
STUDIO / SERVICES

AI-ассистенты

Интеллектуальные помощники с доступом к базе знаний и вашим данным.

+

AI-системы для команд

+

Подключаем модели, инструменты и данные в единую систему.

+

Решение проектируется под процессы и требования безопасности.

+
+

Обсудим ваш проект?

Расскажите, какие задачи хотите автоматизировать.

Оставить заявку →
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/services/bots/index.html b/design/examples/site-studio/preview-dist/services/bots/index.html new file mode 100644 index 0000000..34ba60a --- /dev/null +++ b/design/examples/site-studio/preview-dist/services/bots/index.html @@ -0,0 +1,17 @@ + + + +Telegram-боты — Студия автоматизации + +
STUDIO / SERVICES

Telegram-боты

Автоматизируем заявки, коммуникации и поддержку клиентов в Telegram.

+

Умный бот для бизнеса

+

Создаём ботов, которые экономят время сотрудников и улучшают сервис.

+

Что входит

+
    +
  • Продуманная структура диалога.
  • +
  • Интеграция с внутренними системами.
  • +
  • Панель обработки заявок.
  • +
+
+

Обсудим ваш проект?

Расскажите, какие задачи хотите автоматизировать.

Оставить заявку →
+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/services/index.html b/design/examples/site-studio/preview-dist/services/index.html new file mode 100644 index 0000000..b00b5a2 --- /dev/null +++ b/design/examples/site-studio/preview-dist/services/index.html @@ -0,0 +1,9 @@ + + + +Наши услуги — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Сервисы и решения

Подберём стек и формат под процессы вашей команды.

Обсудить проект →
+ +

Частые вопросы

С чего начать проект?

С короткого обсуждения бизнес-задачи и входных данных.

+ \ No newline at end of file diff --git a/design/examples/site-studio/preview-dist/thank-you/index.html b/design/examples/site-studio/preview-dist/thank-you/index.html new file mode 100644 index 0000000..26da962 --- /dev/null +++ b/design/examples/site-studio/preview-dist/thank-you/index.html @@ -0,0 +1,7 @@ + + + +Спасибо! — Студия автоматизации + +
● DIGITAL / AI ENGINEERING

Спасибо за обращение!

Мы получили вашу заявку. Это демонстрационная страница, не подтверждение реальной отправки.

На главную →
+ \ No newline at end of file diff --git a/design/examples/site-studio/redirects.yaml b/design/examples/site-studio/redirects.yaml new file mode 100644 index 0000000..1ee8cce --- /dev/null +++ b/design/examples/site-studio/redirects.yaml @@ -0,0 +1,8 @@ +schema: 1 +rules: +- from: /bot/ + to: /services/bots/ + status: 301 +- from: /about-us/ + to: /about/ + status: 301 diff --git a/design/examples/site-studio/site.yaml b/design/examples/site-studio/site.yaml new file mode 100644 index 0000000..7b6d71b --- /dev/null +++ b/design/examples/site-studio/site.yaml @@ -0,0 +1,31 @@ +# Пример site-studio: данные и домен фиктивные; никакие настоящие заявки не принимаются. +schema: 1 +name: Студия автоматизации +base_url: https://studio.example +default_locale: ru +locales: +- ru +description: Разработка Telegram-ботов, AI-систем и автоматизация бизнеса +theme: + file: theme.yaml +defaults: + layout: default + seo: + title_suffix: ' — Студия автоматизации' +menus: + main: main + footer: footer +features: + cases: true + scenarios: true + courses: false + blog: false +forms: + primary: form_contact +build: + output: dist/ + minify: true + keep_releases: 10 +contacts: + email: hello@studio.example + telegram: '@studio_demo' diff --git a/design/examples/site-studio/theme.yaml b/design/examples/site-studio/theme.yaml new file mode 100644 index 0000000..508344c --- /dev/null +++ b/design/examples/site-studio/theme.yaml @@ -0,0 +1,68 @@ +# Site Studio: responsive container defaults, overridden per block via layout. +schema: 1 +preset: minimal +preset_version: 1 +overrides: + colors: + background: '#fbfaf7' + surface: '#ffffff' + text: '#191e23' + muted: '#5a6670' + primary: '#9a6cfa' + secondary: '#f0f1ef' + accent: '#d4beff' + border: '#e0e1de' + type: + pair: system + heading: system-ui, "Segoe UI", sans-serif + body: system-ui, "Segoe UI", sans-serif + scale: 1.0 + line: 1.6 + headingWeight: 700 + ui: + radius: 7 + container: + mode: boxed + max_width: 1080 + gutter: + desktop: 36 + tablet: 24 + mobile: 16 + spacing: 1.0 + shadow: soft + button: solid + custom_colors: + hero_ink: '#ffffff' + hero_muted: '#bbc6d6' + card_label: '#9d92cf' + cta_surface: '#dfe3f2' + footer_surface: '#18202b' + gradients: + enabled: true + definitions: + hero: + type: linear + angle: 145 + stops: + - at: 0 + color: '#1e2735' + - at: 55 + color: '#15202d' + - at: 100 + color: '#31344a' + button: + type: linear + angle: 105 + stops: + - at: 0 + color: '#d4beff' + - at: 100 + color: '#b5abf9' + cta: + type: linear + angle: 125 + stops: + - at: 0 + color: '#dfe3f2' + - at: 100 + color: '#eef0fc' diff --git a/design/examples/site-studio/tools/check_containers.py b/design/examples/site-studio/tools/check_containers.py new file mode 100644 index 0000000..4c776ce --- /dev/null +++ b/design/examples/site-studio/tools/check_containers.py @@ -0,0 +1,20 @@ +#!/usr/bin/env python3 +"""Offline smoke test of Site Studio's width-mode example.""" +from pathlib import Path +import yaml +p = Path(__file__).resolve().parents[1] +theme = yaml.safe_load((p/'theme.yaml').read_text()) +c = theme['overrides']['ui']['container'] +assert c['mode'] in {'boxed','fluid','full'} +assert 720 <= c['max_width'] <= 1920 +assert all(isinstance(x,int) and 0<=x<=96 for x in c['gutter'].values()) +raw=(p/'pages/index.md').read_text() +yaml_text=raw[4:].split('\n---\n')[0] +blocks=yaml.safe_load(yaml_text)['regions']['main'] +assert blocks[0]['layout']=={'section_width':'full','content_width':'boxed'} +assert blocks[1]['layout']=={'section_width':'fluid','content_width':'fluid'} +assert blocks[-1]['layout']=={'section_width':'full','content_width':'boxed'} +index=(p/'preview-dist/index.html').read_text() +for mode in ['data-section-width="full" data-content-width="boxed"','data-section-width="fluid" data-content-width="fluid"']: + assert mode in index +print('Container settings and preview: OK') diff --git a/design/examples/site-studio/tools/render_preview.py b/design/examples/site-studio/tools/render_preview.py new file mode 100644 index 0000000..b15a7c6 --- /dev/null +++ b/design/examples/site-studio/tools/render_preview.py @@ -0,0 +1,218 @@ +#!/usr/bin/env python3 +"""Offline example renderer (NOT the Site Engine production BuildService). + +Converts the Site Studio demo's YAML/Markdown/Jinja fragments into portable HTML. +Needs PyYAML, Jinja2, mistune; no FastAPI, server or external CDN. +""" +from pathlib import Path +import shutil +import yaml +import mistune +from jinja2 import Environment, FileSystemLoader, select_autoescape + +ROOT = Path(__file__).resolve().parents[1] +OUT = ROOT / 'preview-dist' +load = lambda path: yaml.safe_load(path.read_text(encoding='utf8')) + + +def parse_md(path): + text = path.read_text(encoding='utf8') + if not text.startswith('---\n'): + raise ValueError(f'Missing front matter: {path}') + raw, body = text[4:].split('\n---\n', 1) + return yaml.safe_load(raw), body + + +def route_path(route): + if not isinstance(route, str) or not route.startswith('/') or '..' in Path(route).parts: + raise ValueError(f'Unsafe route: {route}') + return Path('index.html') if route == '/' else Path(route.strip('/')) / 'index.html' + + +site = load(ROOT/'site.yaml') +theme = load(ROOT/'theme.yaml') +company = load(ROOT/'data/company.yaml') +menus = {p.stem: load(p)['items'] for p in (ROOT/'menus').glob('*.yaml')} +forms = {p.stem: load(p) for p in (ROOT/'forms').glob('*.yaml')} +layouts = {d.name: load(d/'layout.yaml') for d in (ROOT/'layouts').iterdir() if d.is_dir()} +fragments = {p.parent.name: p.parent.relative_to(ROOT) for p in (ROOT/'fragments').glob('*/*/fragment.yaml')} +env = Environment(loader=FileSystemLoader(ROOT), autoescape=select_autoescape(['html','j2'])) + +entries = [] +for file in (ROOT/'content').glob('*/*.md'): + data, body = parse_md(file) + schema = load(ROOT/'collections'/f'{file.parent.name}.yaml') + data.update({'collection': file.parent.name, 'body': body, + 'url': schema['route'].replace('{slug}', data['slug'])}) + entries.append(data) +entry_by_key = {e['collection']+'/'+e['slug']: e for e in entries} +CURRENT = Path('index.html') + + +def site_link(route): + return '../' * len(CURRENT.parent.parts) + route_path(route).as_posix() + + +def asset_url(path): + if not isinstance(path, str) or not path.startswith('assets/') or '..' in Path(path).parts: + raise ValueError('Unsafe asset reference '+repr(path)) + return '../' * len(CURRENT.parent.parts) + path + + +def read_bind(key, page, entry): + parts = key.split('.') + value = {'page': page, 'entry': entry or {}, 'data': {'company': company}}.get(parts.pop(0), {}) + for part in parts: + if not isinstance(value, dict): return '' + value = value.get(part, '') + return value + + +def resolve(value, page, entry): + if isinstance(value, dict): + if 'bind' in value: return read_bind(value['bind'], page, entry) + return {k: resolve(v, page, entry) for k,v in value.items()} + if isinstance(value, list): return [resolve(v, page, entry) for v in value] + return value + + +def query_entries(collection, sort='order', limit=6): + schema_file = ROOT/'collections'/f'{collection}.yaml' + if not schema_file.is_file() or not load(schema_file).get('enabled', True): return [] + result = [e for e in entries if e['collection']==collection and e.get('status')=='published'] + sort = str(sort) + reverse = sort.startswith('-') + field = sort.lstrip('-') + result.sort(key=lambda e: e.get(field, 999) if field=='order' else str(e.get(field,'')), reverse=reverse) + return result[:min(int(limit), 30)] + + +def entry_by_ref(ref): + e = entry_by_key.get(ref) + return e if e and e.get('status')=='published' else None + + +def gradients(role): + settings = theme.get('overrides', {}).get('gradients', {}) + if not settings.get('enabled'): return '' + definition = settings.get('definitions', {}).get(role) + if not definition or definition.get('type') != 'linear': return '' + stops = ', '.join(str(s['color'])+' '+str(s['at'])+'%' for s in definition['stops']) + return f"linear-gradient({definition['angle']}deg, {stops})" + + +VALID_CONTAINER_MODES = {'boxed','fluid','full'} + +def get_container_config(): + raw = theme.get('overrides',{}).get('ui',{}).get('container',1080) + if isinstance(raw,(int,float)): raw={'mode':'boxed','max_width':int(raw)} + raw = raw if isinstance(raw,dict) else {} + mode = raw.get('mode','boxed') + max_width = int(raw.get('max_width',1080)) + gutter = {'desktop':36,'tablet':24,'mobile':16} | (raw.get('gutter',{}) or {}) + if mode not in VALID_CONTAINER_MODES or not 720 <= max_width <= 1920: + raise ValueError('Invalid theme container mode/max_width') + if any(not isinstance(x,int) or not 0 <= x <= 96 for x in gutter.values()): + raise ValueError('Invalid responsive gutters') + return {'mode':mode,'max_width':max_width,'gutter':gutter} + + +def block_layout(block): + raw = block.get('layout') or {} + defaults = {'section_width':'full' if block['fragment'] in ('hero','cta_banner','site_header','site_footer') else 'inherit', 'content_width':'inherit'} + result = defaults | raw + for key in defaults: + if result[key] not in VALID_CONTAINER_MODES | {'inherit'}: + raise ValueError(f"Invalid {key} for {block.get('id')}") + return result + + +def effective_width(mode): + return get_container_config()['mode'] if mode=='inherit' else mode + + +def theme_style(): + overrides = theme.get('overrides', {}) + tokens = [] + for key, value in overrides.get('colors', {}).items(): tokens.append(('--color-'+key, value)) + for key, value in overrides.get('custom_colors', {}).items(): tokens.append(('--color-'+key.replace('_','-'), value)) + ui = overrides.get('ui', {}) + if 'radius' in ui: tokens.append(('--radius', str(ui['radius'])+'px')) + container = get_container_config() + tokens.extend([('--container', str(container['max_width'])+'px'), + ('--container-max',str(container['max_width'])+'px'), + ('--gutter-desktop',str(container['gutter']['desktop'])+'px'), + ('--gutter-tablet',str(container['gutter']['tablet'])+'px'), + ('--gutter-mobile',str(container['gutter']['mobile'])+'px')]) + typography = overrides.get('type', {}) + for part in ('heading','body'): + if part in typography: tokens.append(('--font-'+part, typography[part])) + tokens += [('--hero-gradient', gradients('hero') or '#1e2735'), + ('--button-gradient', gradients('button') or overrides['colors']['accent']), + ('--cta-gradient', gradients('cta') or overrides['colors']['secondary'])] + # Inputs are trusted example tokens; backend must validate typed values before CSS output. + return '' + + +def render_fragment(block, page, entry, body): + fid = block['fragment'] + if fid not in fragments: raise ValueError(f'Unknown Fragment: {fid}') + if block.get('visible') is False or block.get('hidden'): return '' + template = env.get_template(str(fragments[fid]/'template.html.j2')) + rendered = template.render( + props=resolve(block.get('props', {}), page, entry), block=block, page=page, entry=entry, + site=site, company=company, menus=menus, site_link=site_link, asset_url=asset_url, + query_entries=query_entries, entry_by_ref=entry_by_ref, + render_markdown=lambda value: mistune.create_markdown(escape=True)(value), content_body=body, + get_form=forms.get) + # Section width and inner content width are independent. No raw CSS from editable content. + width = block_layout(block) + outer = effective_width(width['section_width']) + inner = effective_width(width['content_width']) + return f'
{rendered}
' + + +def render_page(page, body, route, entry=None): + global CURRENT + CURRENT = route_path(route) + lid = page['layout'] + layout = layouts[lid] + regions = {r['id']:r for r in layout['regions']} + allowed = set(regions['main']['allow']) + blocks = page.get('regions',{}).get('main', []) + for block in blocks: + if block['fragment'] not in allowed: + raise ValueError(f"{page['title']}: Fragment {block['fragment']} disallowed in layout {lid}") + def render_region(name): + region = regions[name] + source = blocks if name=='main' else region.get('fixed',[]) + return '\n'.join(render_fragment(block, page, entry, body) for block in source) + layout_html = env.get_template(f'layouts/{lid}/layout.html.j2') + html = layout_html.render(page=page, site=site, layout_id=lid, container_mode=get_container_config()['mode'], region=render_region, + theme_style=theme_style(), static_css=asset_url('assets/site.css'), + static_js=asset_url('assets/site.js')) + output = OUT / CURRENT + output.parent.mkdir(parents=True, exist_ok=True) + output.write_text(html, encoding='utf-8') + return output + + +def main(): + if OUT.exists(): shutil.rmtree(OUT) + OUT.mkdir(parents=True) + shutil.copytree(ROOT/'assets', OUT/'assets', ignore=shutil.ignore_patterns('manifest.yaml')) + documents = [] + for f in (ROOT/'pages').rglob('*.md'): + page, body = parse_md(f) + documents.append(render_page(page, body, page['route'])) + for entry in entries: + if entry['status'] != 'published': continue + display = load(ROOT/'display'/f"{entry['collection']}.yaml") + page = {'title':entry['title'], 'layout':display['layout'], + 'seo':{'title':entry['title'], 'description':entry['summary']}, + 'regions':display['regions']} + documents.append(render_page(page, entry['body'], entry['url'], entry)) + print(f'Generated {len(documents)} HTML pages at {OUT}') + for d in documents: print(' - '+str(d.relative_to(OUT))) + +if __name__=='__main__': main() diff --git a/design/examples/site-studio/tools/validate_example.py b/design/examples/site-studio/tools/validate_example.py new file mode 100644 index 0000000..f56ce64 --- /dev/null +++ b/design/examples/site-studio/tools/validate_example.py @@ -0,0 +1,112 @@ +#!/usr/bin/env python3 +"""Validate sample site file graph and generated preview; not a production schema validator.""" +from pathlib import Path +from html.parser import HTMLParser +import re +import yaml + +ROOT=Path(__file__).resolve().parents[1] +load=lambda p:yaml.safe_load(p.read_text(encoding='utf-8')) + +def front(p): + raw=p.read_text(encoding='utf8') + if not raw.startswith('---\n'):raise ValueError('No YAML front matter '+str(p)) + return yaml.safe_load(raw[4:].split('\n---\n',1)[0]) + +errors=[];warnings=[] +def err(message):errors.append(message) + +def validate_yaml(): + yaml_files=list(ROOT.rglob('*.yaml')) + for p in yaml_files: + try: load(p) + except Exception as ex:err(f'Invalid YAML {p.relative_to(ROOT)}: {ex}') + print('YAML files:',len(yaml_files)) + return yaml_files + +frags={};layout_ids=set() +for p in ROOT.glob('fragments/*/*/fragment.yaml'): + f=load(p) + frags[f['id']]=p + if not (p.parent/'template.html.j2').is_file():err('Fragment template missing: '+str(p)) +for p in ROOT.glob('layouts/*/layout.yaml'): + obj=load(p);layout_ids.add(obj['id']) + if not (p.parent/'layout.html.j2').is_file():err('Layout template missing: '+str(p)) + +routes={} +for p in ROOT.glob('pages/**/*.md'): + f=front(p) + if f.get('route') in routes:err('Duplicate route '+f['route']) + routes[f['route']]=p + if f.get('layout') not in layout_ids:err('Unknown layout '+str(f['layout'])) + allowed=next((set(r['allow']) for r in load(ROOT/'layouts'/f['layout']/'layout.yaml')['regions'] if r['id']=='main'),set()) + ids=set() + for b in f.get('regions',{}).get('main',[]): + if b['id'] in ids:err(f'Duplicate block ID {b["id"]} in {p}') + ids.add(b['id']) + if b['fragment'] not in frags:err(f'Unknown Fragment {b["fragment"]} in {p}') + if b['fragment'] not in allowed:err(f'Disallowed Fragment {b["fragment"]} in {p}') + props=b.get('props',{}) + for k in ('buttonUrl',): + if props.get(k) and props[k] not in routes:pass # check after all files collected + if b['fragment']=='form' and not (ROOT/'forms'/f"{props['form_id']}.yaml").is_file():err('Missing form '+props['form_id']) + if p.name=='index.md' and len(f.get('regions',{}).get('main',[]))==0:err('Empty index') + +entries={} +for p in ROOT.glob('content/*/*.md'): + f=front(p) + key=p.parent.name+'/'+f['slug'] + if key in entries:err('Duplicate Entry '+key) + entries[key]=f + if not (ROOT/'collections'/f'{p.parent.name}.yaml').is_file():err('Missing collection '+p.parent.name) + if not (ROOT/'display'/f'{p.parent.name}.yaml').is_file():err('Missing display '+p.parent.name) + if not f.get('title'):err('Missing Entry.title '+key) + for fk in ('hero_asset',): + asset=f.get(fk) + if asset and not (ROOT/asset).is_file(): + if f['status']=='draft':warnings.append(f'Expected draft warning: {key} -> {asset}') + else:err('Missing published asset '+asset) + for fk,target in [('related_scenarios','scenarios'),('related_services','services')]: + for slug in f.get(fk,[]): + if not (ROOT/f'content/{target}/{slug}.md').is_file():err(f'Missing Entry reference {key} -> {target}/{slug}') +for p in ROOT.glob('pages/**/*.md'): + f=front(p) + for b in f.get('regions',{}).get('main',[]): + props=b.get('props',{}) + for key in ('buttonUrl',): + link=props.get(key) + if link and link not in routes:err(f'Broken link {link} from {p}') + for key in ('asset','background'): + asset=props.get(key) + if asset and not (ROOT/asset).is_file():err(f'Missing page asset {asset} in {p}') + if b['fragment']=='collection_list' and not (ROOT/'collections'/f"{props.get('collection')}.yaml").is_file():err(f'Missing query collection {props.get("collection")}') + if b['fragment']=='entry_card' and props.get('entry') not in entries:err('Missing entry_card ref '+str(props.get('entry'))) +for p in ROOT.glob('menus/*.yaml'): + for item in load(p)['items']: + if item.get('enabled',True) and item.get('page') not in routes:err(f'Menu target not found: {item.get("page")} in {p}') +for asset in load(ROOT/'assets/manifest.yaml')['files']: + if not (ROOT/asset['path']).is_file():err('Asset manifest path missing: '+asset['path']) + +class Links(HTMLParser): + def __init__(self):super().__init__();self.refs=[] + def handle_starttag(self,tag,attrs): + d=dict(attrs) + if tag in ('a','link','script','img'): + val=d.get('href') or d.get('src') + if val:self.refs.append(val) + +html_docs=list((ROOT/'preview-dist').rglob('*.html')) +for p in html_docs: + links=Links();links.feed(p.read_text(encoding='utf8')) + for ref in links.refs: + if ref.startswith(('#','http:','https:','mailto:','tel:','data:')):continue + r=(p.parent/ref.split('#',1)[0]).resolve() + if not r.is_relative_to((ROOT/'preview-dist').resolve()):err(f'Preview link outside root {p}: {ref}') + elif not r.is_file():err(f'Broken preview href/src {p.relative_to(ROOT)} -> {ref}') +if len(html_docs)<12:err(f'Expected 12+ rendered pages, got {len(html_docs)}') +print('Pages:',len(routes),'Entries:',len(entries),'Fragments:',len(frags),'Layouts:',len(layout_ids),'Static HTML:',len(html_docs)) +print('Warnings:',*warnings,sep='\n ') +if errors: + print('ERRORS:',*errors,sep='\n - ') + raise SystemExit(1) +print('PASS: YAML, file paths, entry refs, block IDs, layouts, menus, HTML links') diff --git a/design/index.html b/design/index.html index 7a71511..d0e378b 100644 --- a/design/index.html +++ b/design/index.html @@ -2,7 +2,27 @@ body{background:#0b0b0e}.eyebrow,.intro h1 em,.tile-title i{color:#f873b0}.signal,.new{background:#fb5299}.signal{box-shadow:0 0 0 4px #fb52991c}.tile{background:#121216;border-color:#303037;border-radius:13px;overflow:hidden;transform:none}.tile:hover{border-color:#f356a0}.new{color:white;border-radius:5px}.preview{background:#101014;border-color:#302d34}.intro,footer{border-color:#29292f}.stage strong{color:#f5f1f4}.stage span,.stage small{color:#8e8798}.dim{color:#797683}.tile-title span{color:#98919f}.tile p{color:#aba4af}.sectionlabel{display:flex;justify-content:space-between;align-items:baseline;gap:15px;border-bottom:1px solid #2a2a30;padding:23px 0 13px;margin-top:14px}.sectionlabel h2{margin:0;font-size:16px;letter-spacing:-.025em}.sectionlabel small{font:10px ui-monospace,monospace;color:#97939e}.builderGrid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:17px;margin:19px 0 23px}.builderCard{border:1px solid #36343c;background:#141418;border-radius:12px;overflow:hidden}.builderCard .preview{aspect-ratio:1.8;border-bottom:1px solid #35323a}.builderCard h3{font-size:15px;margin:0 0 5px}.builderCard p{font-size:11px;line-height:1.65;margin:0;color:#9c98a4}.cardInfo{padding:16px}.actions{display:flex;gap:9px;margin-top:15px}.actions a{padding:9px 14px;border:1px solid #424048;border-radius:7px;font-size:11px;font-weight:650}.actions a.primary{background:#ef438f;color:#fff;border-color:#ef438f}.actions a.primary.alt{background:#8d79d8;border-color:#8d79d8}.actions a:hover{filter:brightness(1.15)}.gallery-grid{margin:17px 0 32px}.tile .preview{aspect-ratio:1.7}.tile p{min-height:52px}@media(max-width:700px){.builderGrid{grid-template-columns:1fr}.sectionlabel{display:block}.sectionlabel small{display:block;margin-top:5px}.actions a{flex:1;text-align:center}}
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
+

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

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

СТАТУСStage 7 · Theme Manager + Site Studio exampleMedia · Structure · Forms · Settings · Audit
+ +
+
Публичный сайт студии автоматизации, собранный из YAML, Markdown и Jinja-фрагментов

Site Studio — пример сайта

Ручные страницы, коллекции и записи, layouts и fragments, шаблоны display, формы, меню, ассеты и theme.yaml. Отдельный независимый от backend статический preview.

+

Файловая структура сайта

Канонический пример для будущего Site Engine. Существующие HTML-прототипы CMS пока используют mock/localStorage; этот seed станет их единым источником после интеграции с сервисным слоем.

examples/site-studio/
+  site.yaml · theme.yaml
+  pages/**/*.md
+  collections/*.yaml
+  content/*/*.md
+  layouts/*/layout.yaml · *.j2
+  fragments/*/*/fragment.yaml · *.j2
+  display/*.yaml · menus/*.yaml
+  forms/*.yaml · data/*.yaml
+  assets/* · redirects.yaml
+  preview-dist/ · tools/
+
+ +
+
Antirion Rework — выбор стиля сайта, настройки и живое превью

04 / Antirion Rework — Дизайн сайта

Выбор готового пресета или Custom, цвета, шрифты, три режима ширины контейнера и отступы. Мастер для нового владельца, сохранение черновика отдельно от live.

+
Rose Graphite — мастер дизайна публичного сайта

06 / Rose Graphite — Дизайн сайта

Тот же мастер с Boxed, Fluid и Full Width в тёмной оболочке админки. Цвета в preview относятся к публичному сайту и не перекрашивают CMS.

+
diff --git a/design/previews/fluid-builder-antirion-1440.png b/design/previews/fluid-builder-antirion-1440.png new file mode 100644 index 0000000..414ce78 Binary files /dev/null and b/design/previews/fluid-builder-antirion-1440.png differ diff --git a/design/previews/fluid-builder-rose-graphite-1440.png b/design/previews/fluid-builder-rose-graphite-1440.png new file mode 100644 index 0000000..56dc33b Binary files /dev/null and b/design/previews/fluid-builder-rose-graphite-1440.png differ diff --git a/design/previews/fluid-site-studio-1440.png b/design/previews/fluid-site-studio-1440.png new file mode 100644 index 0000000..6691b5c Binary files /dev/null and b/design/previews/fluid-site-studio-1440.png differ diff --git a/design/previews/fluid-site-studio-390.png b/design/previews/fluid-site-studio-390.png new file mode 100644 index 0000000..a42d470 Binary files /dev/null and b/design/previews/fluid-site-studio-390.png differ diff --git a/design/previews/fluid-theme-antirion-1440.png b/design/previews/fluid-theme-antirion-1440.png new file mode 100644 index 0000000..1c93461 Binary files /dev/null and b/design/previews/fluid-theme-antirion-1440.png differ diff --git a/design/previews/fluid-theme-rose-390.png b/design/previews/fluid-theme-rose-390.png new file mode 100644 index 0000000..951ca90 Binary files /dev/null and b/design/previews/fluid-theme-rose-390.png differ diff --git a/design/previews/fluid-theme-rose-graphite-1440.png b/design/previews/fluid-theme-rose-graphite-1440.png new file mode 100644 index 0000000..4ff4a41 Binary files /dev/null and b/design/previews/fluid-theme-rose-graphite-1440.png differ diff --git a/design/previews/site-studio-home-1440.png b/design/previews/site-studio-home-1440.png new file mode 100644 index 0000000..f212368 Binary files /dev/null and b/design/previews/site-studio-home-1440.png differ diff --git a/design/previews/site-studio-home-390.png b/design/previews/site-studio-home-390.png new file mode 100644 index 0000000..2bb6c54 Binary files /dev/null and b/design/previews/site-studio-home-390.png differ diff --git a/design/previews/theme-antirion-1440.png b/design/previews/theme-antirion-1440.png new file mode 100644 index 0000000..53cea7e Binary files /dev/null and b/design/previews/theme-antirion-1440.png differ diff --git a/design/previews/theme-antirion-390.png b/design/previews/theme-antirion-390.png new file mode 100644 index 0000000..bf72d92 Binary files /dev/null and b/design/previews/theme-antirion-390.png differ diff --git a/design/previews/theme-rose-1440.png b/design/previews/theme-rose-1440.png new file mode 100644 index 0000000..f41203c Binary files /dev/null and b/design/previews/theme-rose-1440.png differ diff --git a/design/previews/theme-rose-390.png b/design/previews/theme-rose-390.png new file mode 100644 index 0000000..6b1e6b6 Binary files /dev/null and b/design/previews/theme-rose-390.png differ diff --git a/design/theme-studio-antirion.html b/design/theme-studio-antirion.html new file mode 100644 index 0000000..6b266e0 --- /dev/null +++ b/design/theme-studio-antirion.html @@ -0,0 +1 @@ +Site Engine — Мастер дизайна сайта · Antirion Rework
diff --git a/design/theme-studio-rose-graphite.html b/design/theme-studio-rose-graphite.html new file mode 100644 index 0000000..1507e66 --- /dev/null +++ b/design/theme-studio-rose-graphite.html @@ -0,0 +1 @@ +Site Engine — Мастер дизайна сайта · Rose Graphite
diff --git a/docker-run.sh b/docker-run.sh index 3804e2b..cc3274c 100644 --- a/docker-run.sh +++ b/docker-run.sh @@ -5,8 +5,8 @@ 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/examples/site-studio:/app/examples/site-studio" \ + -v "$PWD/dist:/app/dist" \ -v "$PWD/data:/data" \ flexly-cms diff --git a/examples/site-studio/README.md b/examples/site-studio/README.md new file mode 100644 index 0000000..6c1722b --- /dev/null +++ b/examples/site-studio/README.md @@ -0,0 +1,63 @@ +# Site Studio — публичный дизайн на штатном движке + +Отдельный пример на схеме **1**, перенесённый из `design/examples/site-studio/`. Он не заменяет `studio-site` или `ai-studio` и не переключает рабочий `SITE_ROOT`. + +Здесь 9 страниц, 8 записей и 5 layouts. Обычная сборка публикует **13 страниц**: 9 ручных и 4 страницы записей (`services/bots`, `services/ai`, `scenarios/legal`, `cases/ai-reception`). Четыре записи со статусом draft исключаются. Два редиректа создаются отдельно: `/bot/` → `/services/bots/`, `/about-us/` → `/about/`. + +## Проверка и отдельный запуск + +Из корня репозитория, после установки `.[server,dev]`: + +```bash +PYTHONPATH=src python -m site_engine.cli validate examples/site-studio +PYTHONPATH=src python -m site_engine.cli build examples/site-studio --out /tmp/site-studio-dist +SITE_ROOT="$PWD/examples/site-studio" SITE_DIST=/tmp/site-studio-dist SITE_STATE_DIR=/tmp/site-studio-state \ + PYTHONPATH=src python -m uvicorn site_engine.web.app:create_app --factory --host 127.0.0.1 --port 8182 +``` + +Сайт доступен на `http://127.0.0.1:8182/`. Для админки нужны обычные `SITE_ADMIN_LOGIN`, `SITE_ADMIN_PASSWORD_HASH`, `SITE_SECRET_KEY` из основного README; отдельное состояние остаётся в `/tmp/site-studio-state`. Переменные выше действуют для одной команды; рабочие Docker/env/data не меняются. Runtime-фрагменты поставляются в пакете движка, поэтому для Docker нужна пересборка образа. + +Автоматическая приёмка на изолированной копии с настоящим FastAPI и Chromium: + +```bash +PYTHONPATH=src python scripts/qa_site_studio_002.py +PYTHONPATH=src python scripts/verify_package_001.py --site examples/site-studio +``` + +`validate` выдаёт одно ожидаемое предупреждение `W_THEME_GRADIENT_CONTRAST`: фоновые градиенты требуют визуальной оценки контраста. Намеренно отсутствующая обложка `cases/booking` не мешает релизу; preview черновика показывает `E_ASSET_MISSING`. + +## Как адаптирован исходник + +| Исходный seed | Штатный контракт | +|---|---| +| `heading` | `title` | +| `card1…3`, `step1…3`, `question/answer` | Списки `items`; количество не ограничено тремя | +| `button/buttonUrl` | `actions` со ссылками на ID страниц | +| `collection/sort/limit` | `source: {query: …}` | +| `source: body` / `entry.body` | `content: {bind: page.body}` / `{bind: entry.body}` | +| Строковые Jinja-выражения в SEO | `{bind: entry.title}` и `{bind: entry.summary}` | +| Маршруты в меню и `success.page` | ID страниц, например `services/index`, `request`, `thank-you` | +| Поля формы с `id`, `enabled`, отдельная privacy | `key`, активные поля, отдельный consent со ссылкой на `privacy` | +| `redirects.yaml: rules` | Список `{from, to, status}` | +| Неполные list/group | Явные `of`, `fields`, типизированные ссылки | +| `enabled: false` у courses/posts | `requires: [feature.courses]` / `[feature.blog]` и выключенные features в site.yaml | + +`slug/status/body` — системные поля записи; они не дублируются в fields. Данные, статусы, тексты и изображения сохранены. Статические подписи вроде метки Hero и описания списка заданы в props, а не в шаблоне всех сайтов. Разметка и CSS общего builtin перенесены из seed, с сохранением slots, вариантов, типизированных ссылок и списков произвольной длины. + +Layouts используют `seo_head()`, `assets_head()`, `region()`, `assets_body()`. Для демо сохранён `noindex,nofollow`. Локальных копий builtin, `preview-dist` и собственного mini-renderer здесь нет; public CSS/JS собирает движок. Тема находится в `theme.yaml`, ширины секций — в `layout` блоков. Объявленные роли цветов подключены к общим семантическим переменным. В `assets/site.css` сохранён особый вес крупных заголовков Hero/Entry (750) из исходного дизайна; обычные заголовки используют вес темы. Shadow в теме задан `none`, поскольку исходные карточки не имеют теней; изменение токена включает их в общем builtin. + +Каталог содержит общие `steps` и `entry_card`. Ссылка карточки имеет вид: + +```yaml +- id: recommended_service + fragment: entry_card + props: + title: Рекомендуем + entry: services/bots +``` + +`entry_card.entry` — обязательный `ref` с `to: '*'`. Конструктор предлагает опубликованные записи всех включённых коллекций. Старые фиксированные `ref/refs` продолжают принимать slug с `to: `. + +## Формы + +`form_contact` сохраняет статус active, `form_brief` — draft. Схемы и оформление перенесены; приём заявок ещё не подключён. Реальный POST `/forms/form_contact` возвращает **HTTP 501**, интерфейс показывает причину и сохраняет введённые значения. Переход на thank-you при отказе не выполняется. Страница thank-you сохранена как самостоятельная демонстрационная страница, её текст прямо поясняет отсутствие реальной отправки. Доставка email/Telegram не реализована; значения notification в seed служат только описанием схемы. diff --git a/examples/site-studio/assets/ai.webp b/examples/site-studio/assets/ai.webp new file mode 100644 index 0000000..3d97dd3 Binary files /dev/null and b/examples/site-studio/assets/ai.webp differ diff --git a/examples/site-studio/assets/automation.webp b/examples/site-studio/assets/automation.webp new file mode 100644 index 0000000..b23da26 Binary files /dev/null and b/examples/site-studio/assets/automation.webp differ diff --git a/examples/site-studio/assets/booking.webp b/examples/site-studio/assets/booking.webp new file mode 100644 index 0000000..8688792 Binary files /dev/null and b/examples/site-studio/assets/booking.webp differ diff --git a/examples/site-studio/assets/bots.webp b/examples/site-studio/assets/bots.webp new file mode 100644 index 0000000..f6d177e Binary files /dev/null and b/examples/site-studio/assets/bots.webp differ diff --git a/examples/site-studio/assets/case-reception.webp b/examples/site-studio/assets/case-reception.webp new file mode 100644 index 0000000..9d2c330 Binary files /dev/null and b/examples/site-studio/assets/case-reception.webp differ diff --git a/examples/site-studio/assets/case.webp b/examples/site-studio/assets/case.webp new file mode 100644 index 0000000..9d2c330 Binary files /dev/null and b/examples/site-studio/assets/case.webp differ diff --git a/examples/site-studio/assets/hero-studio.webp b/examples/site-studio/assets/hero-studio.webp new file mode 100644 index 0000000..0af3c29 Binary files /dev/null and b/examples/site-studio/assets/hero-studio.webp differ diff --git a/examples/site-studio/assets/hero.webp b/examples/site-studio/assets/hero.webp new file mode 100644 index 0000000..0af3c29 Binary files /dev/null and b/examples/site-studio/assets/hero.webp differ diff --git a/examples/site-studio/assets/houses.webp b/examples/site-studio/assets/houses.webp new file mode 100644 index 0000000..b06a98a Binary files /dev/null and b/examples/site-studio/assets/houses.webp differ diff --git a/examples/site-studio/assets/legal.webp b/examples/site-studio/assets/legal.webp new file mode 100644 index 0000000..900af51 Binary files /dev/null and b/examples/site-studio/assets/legal.webp differ diff --git a/examples/site-studio/assets/manifest.yaml b/examples/site-studio/assets/manifest.yaml new file mode 100644 index 0000000..3ef9ad8 --- /dev/null +++ b/examples/site-studio/assets/manifest.yaml @@ -0,0 +1,72 @@ +# Метаданные ассетов, не являются отдельным источником истины для бинарников. +schema: 1 +files: +- path: assets/hero-studio.webp + kind: image + alt: Иллюстрация hero — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/hero.webp + kind: image + alt: Иллюстрация hero — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/team.webp + kind: image + alt: Иллюстрация team — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/team-working.webp + kind: image + alt: Иллюстрация team — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/bots.webp + kind: image + alt: Иллюстрация bots — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/telegram-bots.webp + kind: image + alt: Иллюстрация bots — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/ai.webp + kind: image + alt: Иллюстрация ai — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/automation.webp + kind: image + alt: Иллюстрация automation — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/legal.webp + kind: image + alt: Иллюстрация legal — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/houses.webp + kind: image + alt: Иллюстрация houses — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/case.webp + kind: image + alt: Иллюстрация case — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/case-reception.webp + kind: image + alt: Иллюстрация case — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/booking.webp + kind: image + alt: Иллюстрация booking — демонстрационный материал + caption: Созданный локально графический плейсхолдер + status: ready +- path: assets/site-mark.svg + kind: image + alt: Логотип студии + status: ready diff --git a/examples/site-studio/assets/site-mark.svg b/examples/site-studio/assets/site-mark.svg new file mode 100644 index 0000000..3f4c236 --- /dev/null +++ b/examples/site-studio/assets/site-mark.svg @@ -0,0 +1 @@ +Знак студии (демо) \ No newline at end of file diff --git a/examples/site-studio/assets/site.css b/examples/site-studio/assets/site.css new file mode 100644 index 0000000..94c4899 --- /dev/null +++ b/examples/site-studio/assets/site.css @@ -0,0 +1,2 @@ +/* Display heading weight from the source design; ordinary headings use the theme weight. */ +.hero h1,.entry-intro h1{font-weight:750} diff --git a/examples/site-studio/assets/team-working.webp b/examples/site-studio/assets/team-working.webp new file mode 100644 index 0000000..0c424ae Binary files /dev/null and b/examples/site-studio/assets/team-working.webp differ diff --git a/examples/site-studio/assets/team.webp b/examples/site-studio/assets/team.webp new file mode 100644 index 0000000..0c424ae Binary files /dev/null and b/examples/site-studio/assets/team.webp differ diff --git a/examples/site-studio/assets/telegram-bots.webp b/examples/site-studio/assets/telegram-bots.webp new file mode 100644 index 0000000..f6d177e Binary files /dev/null and b/examples/site-studio/assets/telegram-bots.webp differ diff --git a/examples/site-studio/collections/cases.yaml b/examples/site-studio/collections/cases.yaml new file mode 100644 index 0000000..b13f0cd --- /dev/null +++ b/examples/site-studio/collections/cases.yaml @@ -0,0 +1,27 @@ +id: cases +name: Кейсы +route: /cases/{slug}/ +list_page: /cases/ +display: cases +sort: -published_date +body: markdown +fields: +- key: title + type: text + required: true +- key: summary + type: textarea + required: true +- key: client + type: text + required: false +- key: published_date + type: date + required: false +- key: related_services + type: refs + required: false + to: services +- key: hero_asset + type: asset + required: false diff --git a/examples/site-studio/collections/courses.yaml b/examples/site-studio/collections/courses.yaml new file mode 100644 index 0000000..09618fe --- /dev/null +++ b/examples/site-studio/collections/courses.yaml @@ -0,0 +1,16 @@ +id: courses +name: Курсы +route: /courses/{slug}/ +list_page: null +display: courses +sort: title +body: markdown +fields: +- key: title + type: text + required: true +- key: summary + type: textarea + required: false +requires: +- feature.courses diff --git a/examples/site-studio/collections/posts.yaml b/examples/site-studio/collections/posts.yaml new file mode 100644 index 0000000..dc6e326 --- /dev/null +++ b/examples/site-studio/collections/posts.yaml @@ -0,0 +1,19 @@ +id: posts +name: Публикации +route: /blog/{slug}/ +list_page: null +display: posts +sort: -published_date +body: markdown +fields: +- key: title + type: text + required: true +- key: summary + type: textarea + required: false +- key: published_date + type: date + required: false +requires: +- feature.blog diff --git a/examples/site-studio/collections/scenarios.yaml b/examples/site-studio/collections/scenarios.yaml new file mode 100644 index 0000000..553239a --- /dev/null +++ b/examples/site-studio/collections/scenarios.yaml @@ -0,0 +1,28 @@ +id: scenarios +name: Сценарии +route: /scenarios/{slug}/ +list_page: /scenarios/ +display: scenarios +sort: title +body: markdown +fields: +- key: title + type: text + required: true +- key: summary + type: textarea + required: true +- key: sector + type: select + required: false + options: + - Юридические услуги + - Недвижимость + - Сфера услуг +- key: related_services + type: refs + required: false + to: services +- key: hero_asset + type: asset + required: false diff --git a/examples/site-studio/collections/services.yaml b/examples/site-studio/collections/services.yaml new file mode 100644 index 0000000..76a53ab --- /dev/null +++ b/examples/site-studio/collections/services.yaml @@ -0,0 +1,39 @@ +id: services +name: Услуги +route: /services/{slug}/ +list_page: /services/ +display: services +sort: order +body: markdown +fields: +- key: title + type: text + required: true +- key: summary + type: textarea + required: true +- key: order + type: number + required: false +- key: featured + type: boolean + required: false +- key: hero_asset + type: asset + required: false +- key: related_scenarios + type: refs + required: false + to: scenarios +- key: benefits + type: list + required: false + of: markdown +- key: cta + type: group + required: false + fields: + - key: label + type: text + - key: href + type: link diff --git a/examples/site-studio/content/cases/ai-reception.md b/examples/site-studio/content/cases/ai-reception.md new file mode 100644 index 0000000..c6d1989 --- /dev/null +++ b/examples/site-studio/content/cases/ai-reception.md @@ -0,0 +1,19 @@ +--- +title: AI-приёмная для сервиса +slug: ai-reception +status: published +summary: Автоматизация обработки обращений и классификации заявок. +client: Сервисный центр (демо) +published_date: '2026-10-28' +related_services: +- ai +- bots +hero_asset: assets/case.webp +--- +## Задача + +Клиенты обращаются через разные каналы, а операторам требуется единый поток заявок. + +## Решение + +Помощник помогает структурировать и направлять обращения. Показатели в этом примере **не являются реальной статистикой**. diff --git a/examples/site-studio/content/cases/booking.md b/examples/site-studio/content/cases/booking.md new file mode 100644 index 0000000..9eb9332 --- /dev/null +++ b/examples/site-studio/content/cases/booking.md @@ -0,0 +1,14 @@ +--- +title: Бот для онлайн-записи +slug: booking +status: draft +summary: Запись клиентов через Telegram с напоминаниями. +client: Сеть салонов (демо) +published_date: '2026-11-03' +related_services: +- bots +hero_asset: assets/missing-cover.webp +--- +## Решение + +Встроенное расписание. В текущем демо-черновике изображение намеренно отсутствует для проверки валидации. diff --git a/examples/site-studio/content/scenarios/legal.md b/examples/site-studio/content/scenarios/legal.md new file mode 100644 index 0000000..b9248e8 --- /dev/null +++ b/examples/site-studio/content/scenarios/legal.md @@ -0,0 +1,14 @@ +--- +title: Для юридических компаний +slug: legal +status: published +summary: Обработка обращений, извлечение данных из документов, AI-поиск. +sector: Юридические услуги +related_services: +- bots +- ai +hero_asset: assets/legal.webp +--- +## Автоматизация юридической практики + +Сбор первичной информации и структурирование документов. diff --git a/examples/site-studio/content/scenarios/real-estate.md b/examples/site-studio/content/scenarios/real-estate.md new file mode 100644 index 0000000..17a76fc --- /dev/null +++ b/examples/site-studio/content/scenarios/real-estate.md @@ -0,0 +1,13 @@ +--- +title: Для недвижимости +slug: real-estate +status: draft +summary: Квалификация лидов, подбор объектов и консультации 24/7. +sector: Недвижимость +related_services: +- ai +hero_asset: assets/houses.webp +--- +## AI-помощник риелтора + +Первичный диалог и маршрутизация обращений. diff --git a/examples/site-studio/content/scenarios/services.md b/examples/site-studio/content/scenarios/services.md new file mode 100644 index 0000000..b018fd5 --- /dev/null +++ b/examples/site-studio/content/scenarios/services.md @@ -0,0 +1,14 @@ +--- +title: Для сферы услуг +slug: services +status: draft +summary: Запись клиентов, напоминания и ответы на частые вопросы. +sector: Сфера услуг +related_services: +- bots +- automation +hero_asset: assets/automation.webp +--- +## Автоматизация клиентского сервиса + +Переносим повторяющиеся сценарии в чат-ботов. diff --git a/examples/site-studio/content/services/ai.md b/examples/site-studio/content/services/ai.md new file mode 100644 index 0000000..80c3705 --- /dev/null +++ b/examples/site-studio/content/services/ai.md @@ -0,0 +1,24 @@ +--- +title: AI-ассистенты +slug: ai +status: published +summary: Интеллектуальные помощники с доступом к базе знаний и вашим данным. +order: 2 +featured: true +hero_asset: assets/ai.webp +related_scenarios: +- legal +- real-estate +benefits: +- RAG и поиск по документам +- Контроль ответов +cta: + label: Заказать консультацию + href: + page: contacts +--- +## AI-системы для команд + +Подключаем модели, инструменты и данные в единую систему. + +Решение проектируется под процессы и требования безопасности. diff --git a/examples/site-studio/content/services/automation.md b/examples/site-studio/content/services/automation.md new file mode 100644 index 0000000..e4e4195 --- /dev/null +++ b/examples/site-studio/content/services/automation.md @@ -0,0 +1,20 @@ +--- +title: Бизнес-автоматизация +slug: automation +status: draft +summary: Связываем существующие сервисы и избавляем команды от ручных операций. +order: 3 +featured: false +hero_asset: assets/automation.webp +related_scenarios: +- services +benefits: +- Надёжные интеграции +cta: + label: Оставить заявку + href: + page: request +--- +## Процессы без рутины + +Связываем CRM, формы, мессенджеры и базы данных. diff --git a/examples/site-studio/content/services/bots.md b/examples/site-studio/content/services/bots.md new file mode 100644 index 0000000..b8fb4bc --- /dev/null +++ b/examples/site-studio/content/services/bots.md @@ -0,0 +1,27 @@ +--- +title: Telegram-боты +slug: bots +status: published +summary: Автоматизируем заявки, коммуникации и поддержку клиентов в Telegram. +order: 1 +featured: true +hero_asset: assets/bots.webp +related_scenarios: +- legal +- services +benefits: +- Быстрые ответы клиентам +- Интеграция с CRM +cta: + label: Обсудить проект + href: + page: request +--- +## Умный бот для бизнеса + +Создаём ботов, которые экономят время сотрудников и улучшают сервис. + +### Что входит +- Продуманная структура диалога. +- Интеграция с внутренними системами. +- Панель обработки заявок. diff --git a/examples/site-studio/data/company.yaml b/examples/site-studio/data/company.yaml new file mode 100644 index 0000000..b9fdb84 --- /dev/null +++ b/examples/site-studio/data/company.yaml @@ -0,0 +1,11 @@ +schema: 1 +name: Студия автоматизации +short_name: studio. +tagline: AI · Telegram · Автоматизация +email: hello@studio.example +phone: +7 (999) 000-00-00 +telegram: '@studio_demo' +location: Удалённая команда +legal: + company: Демо-студия (фиктивная организация) + privacy_contact: privacy@studio.example diff --git a/examples/site-studio/display/cases.yaml b/examples/site-studio/display/cases.yaml new file mode 100644 index 0000000..6614b32 --- /dev/null +++ b/examples/site-studio/display/cases.yaml @@ -0,0 +1,32 @@ +layout: default +seo: + title: + bind: entry.title + description: + bind: entry.summary +regions: + main: + - id: entry_head + fragment: entry_header + props: + title: + bind: entry.title + summary: + bind: entry.summary + image: + bind: entry.hero_asset + eyebrow: STUDIO / CASES + - id: entry_body + fragment: richtext + props: + content: + bind: entry.body + - id: entry_cta + fragment: cta_banner + props: + title: Обсудим ваш проект? + text: Расскажите, какие задачи хотите автоматизировать. + actions: + - page: request + label: Оставить заявку → +overrides: allow diff --git a/examples/site-studio/display/courses.yaml b/examples/site-studio/display/courses.yaml new file mode 100644 index 0000000..065dc77 --- /dev/null +++ b/examples/site-studio/display/courses.yaml @@ -0,0 +1,32 @@ +layout: default +seo: + title: + bind: entry.title + description: + bind: entry.summary +regions: + main: + - id: entry_head + fragment: entry_header + props: + title: + bind: entry.title + summary: + bind: entry.summary + image: + bind: entry.hero_asset + eyebrow: STUDIO / COURSES + - id: entry_body + fragment: richtext + props: + content: + bind: entry.body + - id: entry_cta + fragment: cta_banner + props: + title: Обсудим ваш проект? + text: Расскажите, какие задачи хотите автоматизировать. + actions: + - page: request + label: Оставить заявку → +overrides: allow diff --git a/examples/site-studio/display/posts.yaml b/examples/site-studio/display/posts.yaml new file mode 100644 index 0000000..443d562 --- /dev/null +++ b/examples/site-studio/display/posts.yaml @@ -0,0 +1,32 @@ +layout: default +seo: + title: + bind: entry.title + description: + bind: entry.summary +regions: + main: + - id: entry_head + fragment: entry_header + props: + title: + bind: entry.title + summary: + bind: entry.summary + image: + bind: entry.hero_asset + eyebrow: STUDIO / POSTS + - id: entry_body + fragment: richtext + props: + content: + bind: entry.body + - id: entry_cta + fragment: cta_banner + props: + title: Обсудим ваш проект? + text: Расскажите, какие задачи хотите автоматизировать. + actions: + - page: request + label: Оставить заявку → +overrides: allow diff --git a/examples/site-studio/display/scenarios.yaml b/examples/site-studio/display/scenarios.yaml new file mode 100644 index 0000000..ae27ad0 --- /dev/null +++ b/examples/site-studio/display/scenarios.yaml @@ -0,0 +1,32 @@ +layout: default +seo: + title: + bind: entry.title + description: + bind: entry.summary +regions: + main: + - id: entry_head + fragment: entry_header + props: + title: + bind: entry.title + summary: + bind: entry.summary + image: + bind: entry.hero_asset + eyebrow: STUDIO / SCENARIOS + - id: entry_body + fragment: richtext + props: + content: + bind: entry.body + - id: entry_cta + fragment: cta_banner + props: + title: Обсудим ваш проект? + text: Расскажите, какие задачи хотите автоматизировать. + actions: + - page: request + label: Оставить заявку → +overrides: allow diff --git a/examples/site-studio/display/services.yaml b/examples/site-studio/display/services.yaml new file mode 100644 index 0000000..9300037 --- /dev/null +++ b/examples/site-studio/display/services.yaml @@ -0,0 +1,32 @@ +layout: default +seo: + title: + bind: entry.title + description: + bind: entry.summary +regions: + main: + - id: entry_head + fragment: entry_header + props: + title: + bind: entry.title + summary: + bind: entry.summary + image: + bind: entry.hero_asset + eyebrow: STUDIO / SERVICES + - id: entry_body + fragment: richtext + props: + content: + bind: entry.body + - id: entry_cta + fragment: cta_banner + props: + title: Обсудим ваш проект? + text: Расскажите, какие задачи хотите автоматизировать. + actions: + - page: request + label: Оставить заявку → +overrides: allow diff --git a/examples/site-studio/forms/form_brief.yaml b/examples/site-studio/forms/form_brief.yaml new file mode 100644 index 0000000..6fd932f --- /dev/null +++ b/examples/site-studio/forms/form_brief.yaml @@ -0,0 +1,35 @@ +id: form_brief +version: 1 +status: draft +notification: + channel: email + destination: configured_in_server_settings +success: + page: thank-you + message: Спасибо! Мы свяжемся с вами. +privacy: + consent_required: true + policy_page: /privacy/ +fields: +- key: name + label: Имя + type: text + required: false +- key: email + label: Email + type: email + required: true +- key: phone + label: Телефон + type: tel + required: false +- key: message + label: Описание задачи + type: textarea + required: false +- key: consent + type: consent + label: Согласен(на) на обработку персональных данных + required: true + policy: privacy +title: Обсудить проект diff --git a/examples/site-studio/forms/form_contact.yaml b/examples/site-studio/forms/form_contact.yaml new file mode 100644 index 0000000..842eb9b --- /dev/null +++ b/examples/site-studio/forms/form_contact.yaml @@ -0,0 +1,35 @@ +id: form_contact +version: 2 +status: active +notification: + channel: telegram + destination: configured_in_server_settings +success: + page: thank-you + message: Спасибо! Мы свяжемся с вами. +privacy: + consent_required: true + policy_page: /privacy/ +fields: +- key: name + label: Имя + type: text + required: true +- key: email + label: Email + type: email + required: true +- key: phone + label: Телефон + type: tel + required: false +- key: message + label: Сообщение + type: textarea + required: false +- key: consent + type: consent + label: Согласен(на) на обработку персональных данных + required: true + policy: privacy +title: Форма заявки diff --git a/examples/site-studio/layouts/default/layout.html.j2 b/examples/site-studio/layouts/default/layout.html.j2 new file mode 100644 index 0000000..44e5945 --- /dev/null +++ b/examples/site-studio/layouts/default/layout.html.j2 @@ -0,0 +1,3 @@ + +{{ seo_head() }}{{ assets_head() }} +{{ region('header') }}
{{ region('main') }}
{{ region('footer') }}{{ assets_body() }} diff --git a/examples/site-studio/layouts/default/layout.yaml b/examples/site-studio/layouts/default/layout.yaml new file mode 100644 index 0000000..53e953d --- /dev/null +++ b/examples/site-studio/layouts/default/layout.yaml @@ -0,0 +1,34 @@ +id: default +name: Default / Внутренняя +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + action: + page: request + label: Обсудить проект + brand_mark: S +- id: main + allow: + - hero + - section + - steps + - card_grid + - collection_list + - richtext + - faq + - image + - cta_banner + - entry_card + - entry_header + - form + - disclaimer +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/examples/site-studio/layouts/form-page/layout.html.j2 b/examples/site-studio/layouts/form-page/layout.html.j2 new file mode 100644 index 0000000..db3a920 --- /dev/null +++ b/examples/site-studio/layouts/form-page/layout.html.j2 @@ -0,0 +1,3 @@ + +{{ seo_head() }}{{ assets_head() }} +{{ region('header') }}
{{ region('main') }}
{{ region('footer') }}{{ assets_body() }} diff --git a/examples/site-studio/layouts/form-page/layout.yaml b/examples/site-studio/layouts/form-page/layout.yaml new file mode 100644 index 0000000..c07cd2c --- /dev/null +++ b/examples/site-studio/layouts/form-page/layout.yaml @@ -0,0 +1,26 @@ +id: form-page +name: Форма заявки +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + action: + page: request + label: Обсудить проект + brand_mark: S +- id: main + allow: + - hero + - form + - richtext + - section + - cta_banner +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/examples/site-studio/layouts/landing/layout.html.j2 b/examples/site-studio/layouts/landing/layout.html.j2 new file mode 100644 index 0000000..e63457e --- /dev/null +++ b/examples/site-studio/layouts/landing/layout.html.j2 @@ -0,0 +1,3 @@ + +{{ seo_head() }}{{ assets_head() }} +{{ region('header') }}
{{ region('main') }}
{{ region('footer') }}{{ assets_body() }} diff --git a/examples/site-studio/layouts/landing/layout.yaml b/examples/site-studio/layouts/landing/layout.yaml new file mode 100644 index 0000000..0634d4c --- /dev/null +++ b/examples/site-studio/layouts/landing/layout.yaml @@ -0,0 +1,32 @@ +id: landing +name: Landing / Главная +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + action: + page: request + label: Обсудить проект + brand_mark: S +- id: main + allow: + - hero + - section + - steps + - card_grid + - collection_list + - cta_banner + - richtext + - faq + - image + - entry_card + - form +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/examples/site-studio/layouts/legal/layout.html.j2 b/examples/site-studio/layouts/legal/layout.html.j2 new file mode 100644 index 0000000..9b1e655 --- /dev/null +++ b/examples/site-studio/layouts/legal/layout.html.j2 @@ -0,0 +1,3 @@ + +{{ seo_head() }}{{ assets_head() }} +{{ region('header') }}
{{ region('main') }}
{{ region('footer') }}{{ assets_body() }} diff --git a/examples/site-studio/layouts/legal/layout.yaml b/examples/site-studio/layouts/legal/layout.yaml new file mode 100644 index 0000000..5f205bc --- /dev/null +++ b/examples/site-studio/layouts/legal/layout.yaml @@ -0,0 +1,25 @@ +id: legal +name: Legal / Юридическая +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + action: + page: request + label: Обсудить проект + brand_mark: S +- id: main + allow: + - hero + - richtext + - disclaimer + - section +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/examples/site-studio/layouts/minimal/layout.html.j2 b/examples/site-studio/layouts/minimal/layout.html.j2 new file mode 100644 index 0000000..9223e7a --- /dev/null +++ b/examples/site-studio/layouts/minimal/layout.html.j2 @@ -0,0 +1,3 @@ + +{{ seo_head() }}{{ assets_head() }} +{{ region('header') }}
{{ region('main') }}
{{ region('footer') }}{{ assets_body() }} diff --git a/examples/site-studio/layouts/minimal/layout.yaml b/examples/site-studio/layouts/minimal/layout.yaml new file mode 100644 index 0000000..ab3a501 --- /dev/null +++ b/examples/site-studio/layouts/minimal/layout.yaml @@ -0,0 +1,25 @@ +id: minimal +name: Minimal / Результат +regions: +- id: header + fixed: + - id: site_header + fragment: site_header + props: + menu: main + action: + page: request + label: Обсудить проект + brand_mark: S +- id: main + allow: + - hero + - richtext + - cta_banner + - section +- id: footer + fixed: + - id: site_footer + fragment: site_footer + props: + menu: footer diff --git a/examples/site-studio/menus/footer.yaml b/examples/site-studio/menus/footer.yaml new file mode 100644 index 0000000..6b4f0ff --- /dev/null +++ b/examples/site-studio/menus/footer.yaml @@ -0,0 +1,11 @@ +id: footer +name: Меню футера +items: +- id: privacy + label: Политика конфиденциальности + page: privacy + enabled: true +- id: request + label: Оставить заявку + page: request + enabled: true diff --git a/examples/site-studio/menus/main.yaml b/examples/site-studio/menus/main.yaml new file mode 100644 index 0000000..6e50335 --- /dev/null +++ b/examples/site-studio/menus/main.yaml @@ -0,0 +1,23 @@ +id: main +name: Главная навигация +items: +- id: home + label: Главная + page: index + enabled: true +- id: services + label: Услуги + page: services/index + enabled: true +- id: cases + label: Кейсы + page: cases/index + enabled: true +- id: about + label: О компании + page: about + enabled: true +- id: contacts + label: Контакты + page: contacts + enabled: true diff --git a/examples/site-studio/pages/about.md b/examples/site-studio/pages/about.md new file mode 100644 index 0000000..189c9b4 --- /dev/null +++ b/examples/site-studio/pages/about.md @@ -0,0 +1,41 @@ +--- +schema: 1 +title: О компании +layout: default +status: published +route: /about/ +seo: + title: О студии + description: Наша команда и инженерный подход. +regions: + main: + - id: about_intro + fragment: hero + props: + title: Команда, которая делает AI полезным + subtitle: От идеи до работающего продукта. + actions: + - page: contacts + label: Связаться → + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING + - id: body_about + fragment: richtext + props: + title: О студии + content: + bind: page.body + - id: team_asset + fragment: image + props: + asset: assets/team.webp + alt: Иллюстрация команды студии + caption: Иллюстрация команды студии +--- +Мы небольшая инженерная команда, ориентированная на **измеримые результаты**. + +Проектируем решения, которые действительно помогают сотрудникам и клиентам. + +- Прорабатываем задачу перед разработкой. +- Строим понятные интеграции и сценарии. +- Поддерживаем решения после запуска. diff --git a/examples/site-studio/pages/cases/index.md b/examples/site-studio/pages/cases/index.md new file mode 100644 index 0000000..21726bb --- /dev/null +++ b/examples/site-studio/pages/cases/index.md @@ -0,0 +1,34 @@ +--- +schema: 1 +title: Кейсы +layout: default +status: published +route: /cases/ +seo: + title: Кейсы автоматизации + description: Примеры проектов и прототипов студии. +regions: + main: + - id: cases_head + fragment: hero + props: + title: Что мы уже сделали + subtitle: Примеры внедрения автоматизации и AI в рабочие процессы. + actions: + - page: request + label: Обсудить задачу → + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING + - id: cases_query + fragment: collection_list + props: + title: Проекты + source: + query: + collection: cases + sort: order + limit: 6 + description: Технологические решения для ваших процессов. + empty: message + empty_message: Пока нет опубликованных записей. +--- diff --git a/examples/site-studio/pages/contacts.md b/examples/site-studio/pages/contacts.md new file mode 100644 index 0000000..f96dfa5 --- /dev/null +++ b/examples/site-studio/pages/contacts.md @@ -0,0 +1,35 @@ +--- +schema: 1 +title: Контакты +layout: default +status: published +route: /contacts/ +seo: + title: Контакты студии + description: Свяжитесь с нами для обсуждения проекта. +regions: + main: + - id: contacts_head + fragment: hero + props: + title: Давайте знакомиться + subtitle: Расскажите нам о вашей задаче. + actions: + - page: request + label: Оставить заявку → + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING + - id: contacts_copy + fragment: section + props: + text: 'Электронная почта: hello@studio.example · Telegram: @studio_demo' + title: На связи + - id: contacts_cta + fragment: cta_banner + props: + title: Есть задача? + text: Выберем оптимальный формат запуска. + actions: + - page: request + label: Обсудить проект → +--- diff --git a/examples/site-studio/pages/index.md b/examples/site-studio/pages/index.md new file mode 100644 index 0000000..6cf27bb --- /dev/null +++ b/examples/site-studio/pages/index.md @@ -0,0 +1,78 @@ +--- +schema: 1 +title: Главная +layout: landing +status: published +route: / +seo: + title: Разработка Telegram-ботов и AI-систем + description: Автоматизация бизнес-процессов и создание AI-решений. +regions: + main: + - id: hero_home + fragment: hero + layout: + section_width: full + content_width: boxed + props: + title: Автоматизируем бизнес с помощью AI + subtitle: Telegram-боты, AI-ассистенты и интеграции, которые решают задачи, а не просто отвечают + на сообщения. + actions: + - page: request + label: Обсудить проект → + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING + - id: services_list + fragment: collection_list + layout: + section_width: boxed + content_width: fluid + props: + title: Наши направления + source: + query: + collection: services + sort: order + limit: 3 + empty: message + empty_message: Пока нет опубликованных записей. + description: Технологические решения для ваших процессов. + hidden: false + anchor: null + note: null + requires: [] + - id: benefits_grid + fragment: card_grid + props: + title: Почему нам доверяют + items: + - title: Под задачу, а не по шаблону + badge: 01 / VALUE + text: Практичный подход к реализации проекта. + - title: Интеграции с вашим стеком + badge: 02 / VALUE + text: Практичный подход к реализации проекта. + - title: Сопровождение после запуска + badge: 03 / VALUE + text: Практичный подход к реализации проекта. + - id: process_steps + fragment: steps + props: + title: Как мы работаем + items: + - title: Исследование + - title: Разработка + - title: Внедрение + - id: cta_home + fragment: cta_banner + layout: + section_width: full + content_width: boxed + props: + title: Обсудим вашу задачу? + text: Расскажите о задаче — подскажем решение. + actions: + - page: request + label: Оставить заявку → +--- diff --git a/examples/site-studio/pages/privacy.md b/examples/site-studio/pages/privacy.md new file mode 100644 index 0000000..cf0c825 --- /dev/null +++ b/examples/site-studio/pages/privacy.md @@ -0,0 +1,26 @@ +--- +schema: 1 +title: Политика конфиденциальности +layout: legal +status: published +route: /privacy/ +seo: + title: Политика конфиденциальности + description: Демонстрационный документ по обработке данных. +regions: + main: + - id: privacy_text + fragment: richtext + props: + title: Обработка данных + content: + bind: page.body + - id: privacy_disclaimer + fragment: disclaimer + props: + text: Демонстрационный текст. Перед публикацией настоящего сайта необходима юридическая проверка. + variant: warning +--- +Это **пример**, не юридически действующая политика конфиденциальности. + +При разработке настоящего сайта необходимо описать правовые основания обработки данных, сроки хранения, права посетителей и способы связи с оператором. diff --git a/examples/site-studio/pages/request.md b/examples/site-studio/pages/request.md new file mode 100644 index 0000000..14646e4 --- /dev/null +++ b/examples/site-studio/pages/request.md @@ -0,0 +1,34 @@ +--- +schema: 1 +title: Заявка +layout: form-page +status: published +route: /request/ +seo: + title: Обсудить проект + description: Форма первичного обращения в студию. +regions: + main: + - id: request_head + fragment: hero + props: + title: Расскажите о задаче + subtitle: Мы свяжемся с вами после уточнения деталей. + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING + - id: request_form + fragment: form + props: + description: Заполните форму — в демонстрации данные никуда не отправляются. + title: Оставить заявку + form: form_contact + - id: request_body + fragment: richtext + props: + title: Как происходит знакомство + content: + bind: page.body +--- +Опишите задачу своими словами. На реальном сайте мы сначала уточним детали и только затем предложим вариант решения. + +Это демонстрационный сайт: **не отправляйте реальные персональные данные**. diff --git a/examples/site-studio/pages/scenarios/index.md b/examples/site-studio/pages/scenarios/index.md new file mode 100644 index 0000000..a1b0626 --- /dev/null +++ b/examples/site-studio/pages/scenarios/index.md @@ -0,0 +1,34 @@ +--- +schema: 1 +title: Решения по отраслям +layout: default +status: published +route: /scenarios/ +seo: + title: Решения для отраслей + description: Сценарии автоматизации под задачи бизнеса. +regions: + main: + - id: scenarios_head + fragment: hero + props: + title: Решения для вашей сферы + subtitle: Подстраиваем AI и автоматизацию под процессы команды. + actions: + - page: request + label: Обсудить проект → + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING + - id: scenarios_query + fragment: collection_list + props: + title: Сценарии + source: + query: + collection: scenarios + sort: order + limit: 6 + description: Технологические решения для ваших процессов. + empty: message + empty_message: Пока нет опубликованных записей. +--- diff --git a/examples/site-studio/pages/services/_section.yaml b/examples/site-studio/pages/services/_section.yaml new file mode 100644 index 0000000..fd3a233 --- /dev/null +++ b/examples/site-studio/pages/services/_section.yaml @@ -0,0 +1,4 @@ +section: services +layout: default +menu: main +sort: order diff --git a/examples/site-studio/pages/services/index.md b/examples/site-studio/pages/services/index.md new file mode 100644 index 0000000..13d703d --- /dev/null +++ b/examples/site-studio/pages/services/index.md @@ -0,0 +1,41 @@ +--- +schema: 1 +title: Услуги +layout: default +status: published +route: /services/ +seo: + title: Наши услуги + description: Telegram-боты, AI и автоматизация. +regions: + main: + - id: services_head + fragment: hero + props: + title: Сервисы и решения + subtitle: Подберём стек и формат под процессы вашей команды. + actions: + - page: request + label: Обсудить проект → + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING + - id: services_query + fragment: collection_list + props: + title: Каталог услуг + source: + query: + collection: services + sort: order + limit: 6 + description: Технологические решения для ваших процессов. + empty: message + empty_message: Пока нет опубликованных записей. + - id: services_faq + fragment: faq + props: + title: Частые вопросы + items: + - q: С чего начать проект? + a: С короткого обсуждения бизнес-задачи и входных данных. +--- diff --git a/examples/site-studio/pages/thank-you.md b/examples/site-studio/pages/thank-you.md new file mode 100644 index 0000000..da3c48a --- /dev/null +++ b/examples/site-studio/pages/thank-you.md @@ -0,0 +1,22 @@ +--- +schema: 1 +title: Спасибо за заявку +layout: minimal +status: published +route: /thank-you/ +seo: + title: Спасибо! + description: Страница подтверждения отправки формы. +regions: + main: + - id: thanks_hero + fragment: hero + props: + title: Спасибо за обращение! + subtitle: Мы получили вашу заявку. Это демонстрационная страница, не подтверждение реальной отправки. + actions: + - page: index + label: На главную → + variant: dark + eyebrow: ● DIGITAL / AI ENGINEERING +--- diff --git a/examples/site-studio/redirects.yaml b/examples/site-studio/redirects.yaml new file mode 100644 index 0000000..b2131ff --- /dev/null +++ b/examples/site-studio/redirects.yaml @@ -0,0 +1,6 @@ +- from: /bot/ + to: /services/bots/ + status: 301 +- from: /about-us/ + to: /about/ + status: 301 diff --git a/examples/site-studio/site.yaml b/examples/site-studio/site.yaml new file mode 100644 index 0000000..7b6d71b --- /dev/null +++ b/examples/site-studio/site.yaml @@ -0,0 +1,31 @@ +# Пример site-studio: данные и домен фиктивные; никакие настоящие заявки не принимаются. +schema: 1 +name: Студия автоматизации +base_url: https://studio.example +default_locale: ru +locales: +- ru +description: Разработка Telegram-ботов, AI-систем и автоматизация бизнеса +theme: + file: theme.yaml +defaults: + layout: default + seo: + title_suffix: ' — Студия автоматизации' +menus: + main: main + footer: footer +features: + cases: true + scenarios: true + courses: false + blog: false +forms: + primary: form_contact +build: + output: dist/ + minify: true + keep_releases: 10 +contacts: + email: hello@studio.example + telegram: '@studio_demo' diff --git a/examples/site-studio/theme.yaml b/examples/site-studio/theme.yaml new file mode 100644 index 0000000..3e46bdd --- /dev/null +++ b/examples/site-studio/theme.yaml @@ -0,0 +1,60 @@ +schema: 1 +preset: editorial +preset_version: 1 +overrides: + colors: + accent: '#bf7953' + background: '#f4f0e8' + border: '#d9d0c7' + muted: '#756a64' + primary: '#82563e' + secondary: '#eadace' + surface: '#fffdfa' + text: '#342c2a' + gradients: + definitions: + hero: + angle: 125 + stops: + - at: 0 + color: '#82563e' + - at: 100 + color: '#f4f0e8' + type: linear + button: + angle: 105 + stops: + - at: 0 + color: '#82563e' + - at: 100 + color: '#bf7953' + type: linear + cta: + angle: 125 + stops: + - at: 0 + color: '#eadace' + - at: 100 + color: '#bf7953' + type: linear + enabled: false + type: + body: Arial, sans-serif + heading: Georgia, "Times New Roman", serif + headingWeight: 700 + line: 1.63 + pair: editorial + scale: 1.08 + ui: + button: outline + container: + gutter: + desktop: 32 + mobile: 16 + tablet: 24 + max_width: 1040 + mode: boxed + radius: 2 + shadow: none + spacing: 1.12 + custom_colors: {} diff --git a/examples/studio-site/assets/hero.svg b/examples/studio-site/assets/hero.svg deleted file mode 100644 index 3219d73..0000000 --- a/examples/studio-site/assets/hero.svg +++ /dev/null @@ -1 +0,0 @@ -Acme Studio diff --git a/examples/studio-site/collections/services.yaml b/examples/studio-site/collections/services.yaml deleted file mode 100644 index 1944a9e..0000000 --- a/examples/studio-site/collections/services.yaml +++ /dev/null @@ -1,12 +0,0 @@ -id: services -name: Услуги -route: /services/{slug}/ -list_page: /services/ -display: services -sort: order -body: markdown -fields: - - {key: title, type: text, required: true} - - {key: tagline, type: text} - - {key: summary, type: textarea} - - {key: order, type: number} diff --git a/examples/studio-site/content/services/ai.md b/examples/studio-site/content/services/ai.md deleted file mode 100644 index 163c6d3..0000000 --- a/examples/studio-site/content/services/ai.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: AI-системы -status: published -order: 2 -tagline: Ассистенты на ваших данных -summary: Поиск по базе знаний, подготовка ответов, разбор обращений. ---- -AI-ассистент работает с вашими документами и данными в согласованном контуре. diff --git a/examples/studio-site/content/services/automation.md b/examples/studio-site/content/services/automation.md deleted file mode 100644 index 892239e..0000000 --- a/examples/studio-site/content/services/automation.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Автоматизации -status: published -order: 3 -tagline: Меньше рутины в процессах -summary: Интеграции между сервисами и автоматизация повторяющихся операций. ---- -Связываем CRM, таблицы, мессенджеры и внутренние системы. diff --git a/examples/studio-site/content/services/bots.md b/examples/studio-site/content/services/bots.md deleted file mode 100644 index 30dddca..0000000 --- a/examples/studio-site/content/services/bots.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -title: Telegram-боты -status: published -order: 1 -tagline: Автоматизация общения с клиентами -summary: Боты для заявок, записи, напоминаний и поддержки. ---- -Бот принимает обращения, задаёт уточняющие вопросы и передаёт задачу менеджеру. diff --git a/examples/studio-site/data/company.yaml b/examples/studio-site/data/company.yaml deleted file mode 100644 index 0f0d7bd..0000000 --- a/examples/studio-site/data/company.yaml +++ /dev/null @@ -1,2 +0,0 @@ -legal_name: Acme Studio LLC -requisites: реквизиты указывает владелец сайта diff --git a/examples/studio-site/display/services.yaml b/examples/studio-site/display/services.yaml deleted file mode 100644 index b62d74e..0000000 --- a/examples/studio-site/display/services.yaml +++ /dev/null @@ -1,14 +0,0 @@ -layout: default -seo: - title: {bind: entry.title} - description: {bind: entry.summary} -regions: - main: - - id: d_header - fragment: entry_header - props: {title: {bind: entry.title}, meta: [{bind: entry.tagline}]} - - {id: d_text, fragment: richtext, props: {content: {bind: entry.body}}} - - id: d_cta - fragment: cta_banner - props: {title: 'Обсудим вашу задачу?', variant: contact} -overrides: allow diff --git a/examples/studio-site/forms/consultation.yaml b/examples/studio-site/forms/consultation.yaml deleted file mode 100644 index 7544b27..0000000 --- a/examples/studio-site/forms/consultation.yaml +++ /dev/null @@ -1,12 +0,0 @@ -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: contacts} -notify: - - {kind: telegram, chat: '${TG_CHAT_ID}'} -antispam: {honeypot: true, rate_limit: '5/hour'} -store: {retention_days: 365} diff --git a/examples/studio-site/layouts/default/layout.html.j2 b/examples/studio-site/layouts/default/layout.html.j2 deleted file mode 100644 index 0f3d826..0000000 --- a/examples/studio-site/layouts/default/layout.html.j2 +++ /dev/null @@ -1,13 +0,0 @@ - - - -{{ seo_head() }} -{{ assets_head() }} - - -{{ region('header') }} -
{{ region('main') }}
-{{ region('footer') }} -{{ assets_body() }} - - diff --git a/examples/studio-site/layouts/default/layout.yaml b/examples/studio-site/layouts/default/layout.yaml deleted file mode 100644 index 215a3a7..0000000 --- a/examples/studio-site/layouts/default/layout.yaml +++ /dev/null @@ -1,14 +0,0 @@ -id: default -name: Основной -regions: - - id: header - fixed: - - id: lh_header - fragment: site_header - props: - menu: main - action: {url: 'https://t.me/acme_studio', label: Написать в Telegram} - - {id: main, allow: ['*']} - - id: footer - fixed: - - {id: lf_footer, fragment: site_footer, props: {menu: footer}} diff --git a/examples/studio-site/menus/footer.yaml b/examples/studio-site/menus/footer.yaml deleted file mode 100644 index 4c07dd5..0000000 --- a/examples/studio-site/menus/footer.yaml +++ /dev/null @@ -1,3 +0,0 @@ -items: - - {label: Политика ПД, page: privacy} - - {label: Контакты, page: contacts} diff --git a/examples/studio-site/menus/main.yaml b/examples/studio-site/menus/main.yaml deleted file mode 100644 index 2cae788..0000000 --- a/examples/studio-site/menus/main.yaml +++ /dev/null @@ -1,4 +0,0 @@ -items: - - {label: Услуги, page: services/index} - - {label: Проекты, page: cases/index, enabled: false, note: Исключено на старте — нет согласий и данных} - - {label: Контакты, page: contacts} diff --git a/examples/studio-site/pages/_section.yaml b/examples/studio-site/pages/_section.yaml deleted file mode 100644 index f08a51a..0000000 --- a/examples/studio-site/pages/_section.yaml +++ /dev/null @@ -1,2 +0,0 @@ -title: Корень -layout: default diff --git a/examples/studio-site/pages/contacts.md b/examples/studio-site/pages/contacts.md deleted file mode 100644 index 6b2ad0d..0000000 --- a/examples/studio-site/pages/contacts.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -schema: 1 -title: Контакты -status: published -regions: - main: - - {id: b_head, fragment: page_header, props: {title: Контакты, lead: Свяжитесь удобным способом.}} - - {id: b_text, fragment: richtext, props: {content: {bind: page.body}}} - - {id: b_form, fragment: form, props: {form: consultation}} ---- -Основной канал связи — Telegram. Почту и форму ниже используйте, если так удобнее. diff --git a/examples/studio-site/pages/drafts/next.md b/examples/studio-site/pages/drafts/next.md deleted file mode 100644 index d0025e3..0000000 --- a/examples/studio-site/pages/drafts/next.md +++ /dev/null @@ -1,8 +0,0 @@ ---- -schema: 1 -title: Черновик новой страницы -status: draft -regions: - main: - - {id: b_head, fragment: page_header, props: {title: Черновик}} ---- diff --git a/examples/studio-site/pages/index.md b/examples/studio-site/pages/index.md deleted file mode 100644 index 3d34aa1..0000000 --- a/examples/studio-site/pages/index.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -schema: 1 -title: Главная -status: published -seo: - description: Telegram-боты, AI-системы и автоматизации под ваши процессы -editorial: - priority: P1 - goal: За 10 секунд объяснить, что мы делаем, и дать действие -regions: - main: - - id: b_hero - fragment: hero - props: - title: Telegram-боты, AI-системы и автоматизации - subtitle: Разрабатываем и сопровождаем решения под ваши процессы. - variant: dark - actions: - - {page: contacts, label: Обсудить задачу} - - id: b_dirs - fragment: collection_list - props: - title: Направления - source: {query: {collection: services, limit: 3}} - card: direction - - id: b_demo - fragment: faq - requires: [feature.demo] - note: Исключён на старте — нет демо (вернётся при feature.demo) - props: - items: - - {q: Заглушка, a: 'Блок скрыт, пока выключен флаг demo'} - - id: b_steps - fragment: card_grid - props: - title: Как идёт работа - variant: steps - items: - - {title: Разговор, text: Обсуждаем задачу без ТЗ.} - - {title: Постановка, text: Фиксируем границы и сроки.} - - {title: Разработка, text: Делаем по этапам с демонстрациями.} - - {title: Запуск, text: Выпускаем в работу.} - - {title: Поддержка, text: Сопровождаем и дорабатываем.} - - id: b_cta - fragment: cta_banner - props: - title: Расскажите о задаче - variant: contact - actions: - - {page: contacts, label: Оставить заявку} ---- diff --git a/examples/studio-site/pages/privacy.md b/examples/studio-site/pages/privacy.md deleted file mode 100644 index 40e36e7..0000000 --- a/examples/studio-site/pages/privacy.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -schema: 1 -title: Политика обработки персональных данных -status: published -regions: - main: - - {id: b_head, fragment: page_header, props: {title: Политика обработки персональных данных}} - - {id: b_text, fragment: richtext, props: {content: {bind: page.body}}} ---- -Текст политики добавляет владелец сайта и согласует с юристом. diff --git a/examples/studio-site/pages/services/index.md b/examples/studio-site/pages/services/index.md deleted file mode 100644 index c4387cf..0000000 --- a/examples/studio-site/pages/services/index.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -schema: 1 -title: Услуги -status: published -regions: - main: - - {id: b_head, fragment: page_header, props: {title: Услуги, lead: Три направления работы.}} - - id: b_list - fragment: collection_list - props: - source: {query: {collection: services}} - layout: list ---- diff --git a/examples/studio-site/redirects.yaml b/examples/studio-site/redirects.yaml deleted file mode 100644 index 070acdf..0000000 --- a/examples/studio-site/redirects.yaml +++ /dev/null @@ -1 +0,0 @@ -- {from: /uslugi/, to: /services/} diff --git a/examples/studio-site/site.yaml b/examples/studio-site/site.yaml deleted file mode 100644 index 811816b..0000000 --- a/examples/studio-site/site.yaml +++ /dev/null @@ -1,22 +0,0 @@ -schema: 1 -name: Acme Studio -base_url: https://studio.example -default_locale: ru -locales: [ru] -theme: - tokens: - color.primary: '#0b5fff' - color.dark: '#14213d' - font.body: 'Inter, system-ui, sans-serif' -defaults: - layout: default - seo: {title_suffix: ' — Acme Studio'} -features: - cases: false - blog: false - demo: false -contacts: - telegram: '@acme_studio' - email: hello@studio.example -rules: - - {id: form-consent, forms: all, require_field: consent, level: error} diff --git a/scripts/qa_ai_studio.py b/scripts/qa_ai_studio.py index e1c4781..f7614c1 100644 --- a/scripts/qa_ai_studio.py +++ b/scripts/qa_ai_studio.py @@ -83,12 +83,12 @@ def main(): "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 ( + "steps", "hero", "page_header", "richtext", @@ -321,11 +321,11 @@ def main(): 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( + expect(frame.locator("[data-preview-id=process_steps] b").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( + expect(frame.locator("[data-preview-id=process_steps] b").first).to_have_text( "Разбираемся в задаче" ) checks.append("dedicated_steps_inspector_and_list_edit_reach_preview") diff --git a/scripts/qa_fragments_002.py b/scripts/qa_fragments_002.py new file mode 100644 index 0000000..a70fb4f --- /dev/null +++ b/scripts/qa_fragments_002.py @@ -0,0 +1,355 @@ +"""Stage 1 catalog acceptance on real FastAPI/preview origins and a git baseline. + +PYTHONPATH=src python scripts/qa_fragments_002.py +Artifacts: /tmp/site-engine-fragments-002/{catalog-desktop.png,mobile.png,report.json} +Never reads or modifies the working examples/studio-site/pages/index.md. +""" + +from __future__ import annotations + +import argparse +import hashlib +import io +import json +import os +import re +import shutil +import subprocess +import sys +import tarfile +import tempfile +import traceback +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 + +sys.path.insert(0, str(ROOT / "tests")) +from test_fragment_catalog_ui import ( + LABELS, + PAGE_ID, + PREVIEW, + environment, + seed_catalog, +) + +from site_engine.build.pipeline import build_site +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 baseline(work: Path) -> Path: + """Extract committed example only; tar filter rejects traversal and unsafe links.""" + archive = subprocess.run( + ["git", "archive", "--format=tar", "HEAD", "examples/studio-site"], + cwd=ROOT, check=True, capture_output=True, + ) + with tarfile.open(fileobj=io.BytesIO(archive.stdout)) as tar: + tar.extractall(work / "baseline", filter="data") + site = work / "baseline/examples/studio-site" + # Only configuration follows the new runtime contract; content stays at the git baseline. + for name in ("site.yaml", "theme.yaml"): + shutil.copyfile(ROOT / "examples/studio-site" / name, site / name) + return site + + +def idle(page): + page.wait_for_function("() => window.siteDocument && !window.siteDocument.state.busy") + + +def source_blocks(page): + source = page.locator("#document-source").input_value() + meta, _ = frontmatter.parse(source) + return source, meta["regions"]["main"] + + +def select_target(dialog, *, region="", parent="", slot=""): + option = dialog.locator( + f'[data-catalog-target] option[data-region="{region}"][data-parent="{parent}"][data-slot="{slot}"]' + ) + expect(option).to_have_count(1) + dialog.locator("[data-catalog-target]").select_option(option.get_attribute("value")) + + +def visible_ids(dialog): + return set(dialog.locator(".catalog-item[data-fragment]:visible").evaluate_all( + "items => items.map(item => item.dataset.fragment)" + )) + + +def check_geometry(page, dialog, width, report): + geometry = dialog.evaluate("""dialog => { + const r=dialog.getBoundingClientRect(); + const body=dialog.querySelector('.modal-body'); + return {x:r.x,right:r.right,width:r.width,scroll:body.scrollWidth,client:body.clientWidth, + page:document.documentElement.scrollWidth,viewport:innerWidth}; + }""") + assert geometry["x"] >= -1 and geometry["right"] <= width + 1, geometry + assert geometry["scroll"] <= geometry["client"] + 1, geometry + assert geometry["page"] <= width + 1, geometry + report["widths"].append({"width": width, "geometry": geometry}) + + +def catalog_checks(page, expected, width, out, report): + page.set_viewport_size({"width": width, "height": 960 if width == 1440 else 844}) + opener = page.locator('[data-catalog-open][data-region="main"]').first + opener.click() + dialog = page.locator("#builder-catalog-dialog") + expect(dialog).to_be_visible() + select_target(dialog, region="main") + search = dialog.locator("[data-catalog-search]") + search.fill("") + dialog.locator('[data-catalog-category=""]').click() + check_geometry(page, dialog, width, report) + for group, label in LABELS.items(): + button = dialog.locator(f'[data-catalog-category="{group}"]') + expect(button).to_have_text(label) + expect(button).to_have_count(1) + for fid, (raw, group) in expected.items(): + item = dialog.locator(f'[data-fragment="{fid}"]') + expect(item).to_have_attribute("data-category", group) + expect(item).to_have_attribute("data-category-source", raw) + expect(item).to_have_attribute("title", fid) + badge = item.locator("[data-fragment-category]") + expect(badge).to_be_visible() + expect(badge).to_have_text(LABELS[group]) + expect(badge).to_have_attribute("title", raw) + expect(dialog.locator('[data-fragment="qa_nested"] b')).to_have_text("Nested catalog card") + expect(dialog.locator('[data-fragment="qa_nested"] [data-fragment-description]')).to_have_text("Sidecar defaults probe") + + # Filter expectations come from every rendered item's declared group, including builtins. + all_groups = dialog.locator("[data-fragment]").evaluate_all( + "items => Object.fromEntries(items.map(item => [item.dataset.fragment,item.dataset.category]))" + ) + for group in LABELS: + dialog.locator(f'[data-catalog-category="{group}"]').click() + assert visible_ids(dialog) == {fid for fid, value in all_groups.items() if value == group}, (width, group) + expect(dialog.locator("[data-catalog-empty]")).to_be_hidden() + dialog.locator('[data-catalog-category=""]').click() + for group, label in LABELS.items(): + for query in (group, label): + search.fill(query) + want = {fid for fid, (_, value) in expected.items() if value == group} + assert want <= visible_ids(dialog), (width, query, want, visible_ids(dialog)) + # Raw legacy labels, names, descriptions and IDs remain searchable. + for query, fid in [ + ("Компоновка", "qa_category_8"), ("Nested catalog card", "qa_nested"), + ("Sidecar defaults probe", "qa_nested"), ("qa_nested", "qa_nested"), + ]: + search.fill(query) + assert fid in visible_ids(dialog), (width, query) + dialog.locator('[data-catalog-category="content"]').click() + search.fill("qa_nested") + assert not visible_ids(dialog) + expect(dialog.locator("[data-catalog-empty]")).to_be_visible() + dialog.locator('[data-catalog-category=""]').click() + search.fill("no-such-fragment-002") + expect(dialog.locator("[data-catalog-empty]")).to_be_visible() + assert not visible_ids(dialog) + search.fill("") + expect(dialog.locator("[data-catalog-empty]")).to_be_hidden() + + select_target(dialog, region="restricted") + assert visible_ids(dialog) == {"qa_legacy"} + search.fill("marketing") + expect(dialog.locator("[data-catalog-empty]")).to_be_visible() + search.fill("") + select_target(dialog, parent="qa_container_block", slot="body") + assert visible_ids(dialog) == {"qa_nested"} + dialog.locator('[data-catalog-category="content"]').click() + expect(dialog.locator("[data-catalog-empty]")).to_be_visible() + dialog.locator('[data-catalog-category=""]').click() + assert visible_ids(dialog) == {"qa_nested"} + select_target(dialog, region="main") + # Include the local card and its localized badge in both requested screenshots. + search.fill("qa_") + dialog.locator('[data-fragment="qa_nested"]').scroll_into_view_if_needed() + page.screenshot(path=str(out / ("catalog-desktop.png" if width == 1440 else "mobile.png"))) + for _ in range(5): + page.keyboard.press("Tab") + assert dialog.evaluate("dialog => dialog.contains(document.activeElement)") + page.keyboard.press("Escape") + expect(dialog).to_be_hidden() + expect(opener).to_be_focused() + report["checks"].append(f"catalog_categories_search_empty_targets_keyboard_{width}") + + +def add_save_reopen(page, site, origin, work, report): + path = site / f"pages/{PAGE_ID}.md" + original = path.read_bytes() + page.set_viewport_size({"width": 1440, "height": 960}) + page.locator('[data-catalog-open][data-region="main"]').first.click() + dialog = page.locator("#builder-catalog-dialog") + select_target(dialog, parent="qa_container_block", slot="body") + dialog.locator('[data-catalog-category="marketing"]').click() + dialog.locator("[data-catalog-search]").fill("qa_nested") + form = dialog.locator('[data-catalog-form="qa_nested"]') + for key, value in {**PREVIEW, "fallback": "Schema fallback"}.items(): + rendered = "false" if value is False else str(value) + expect(form.locator(f'[name="p.{key}"]')).to_have_value(rendered) + # The real catalog click submits the existing add flow, using its populated hidden form. + with page.expect_response(lambda response: response.url.endswith(f"/pages/{PAGE_ID}/transform")) as response: + dialog.locator('[data-fragment="qa_nested"]').click() + assert response.value.status == 200, response.value.text() + idle(page) + source, blocks = source_blocks(page) + added = blocks[0]["slots"]["body"][-1] + assert added["fragment"] == "qa_nested", added + assert re.fullmatch(r"qa_nested_[a-z0-9]{5}", added["id"]), added + assert {key: added["props"][key] for key in PREVIEW} == PREVIEW, added + assert blocks[1]["fragment"] == "qa_legacy", blocks + assert path.read_bytes() == original, "Add must not write the document" + assert not (site / ".engine/history").exists(), "Add must not create content history" + frame = page.frame_locator("#preview-result iframe") + expect(frame.locator(".qa-nested h2")).to_have_text(PREVIEW["title"]) + expect(frame.locator(".qa-legacy")).to_have_text("Legacy flat content") + expect(frame.locator(".qa-nested")).to_have_css("border-top-width", "7px") + assert path.read_bytes() == original, "Preview must not write the document" + report["checks"].extend(["sidecar_defaults_override_per_key_false_zero", "add_preview_does_not_write"]) + + # A successful transform replaces the catalog HTML, while the chosen group persists. + page.locator('[data-catalog-open][data-region="main"]').first.click() + expect(dialog).to_be_visible() + expect(dialog.locator('[data-catalog-category].active')).to_have_count(1) + expect(dialog.locator('[data-catalog-category].active')).to_have_attribute( + "data-catalog-category", "marketing" + ) + dialog.locator("[data-catalog-search]").fill("") + groups = dialog.locator("[data-fragment]").evaluate_all( + "items => Object.fromEntries(items.map(item => [item.dataset.fragment,item.dataset.category]))" + ) + assert visible_ids(dialog) == {fid for fid, group in groups.items() if group == "marketing"} + expect(dialog.locator('[data-fragment="qa_nested"]')).to_be_visible() + expect(dialog.locator('[data-fragment="qa_legacy"]')).to_be_hidden() + expect(dialog.locator("[data-catalog-empty]")).to_be_hidden() + page.keyboard.press("Escape") + expect(dialog).to_be_hidden() + assert source_blocks(page)[0] == source + assert path.read_bytes() == original + report["checks"].append("active_category_and_results_preserved_after_add_swap") + + with page.expect_response(lambda response: response.url.endswith(f"/pages/{PAGE_ID}/save")) as response: + page.get_by_role("button", name="Сохранить документ", exact=True).click() + assert response.value.status == 200, response.value.text() + idle(page) + expect(page.locator("#editor-result")).to_have_attribute("data-saved", "1") + assert path.read_text() == source + page.reload() + idle(page) + reopened, reopened_blocks = source_blocks(page) + assert reopened == source and reopened_blocks == blocks + expect(page.locator(f'[data-tree-id="{added["id"]}"]')).to_be_visible() + expect(page.frame_locator("#preview-result iframe").locator(".qa-nested h2")).to_have_text(PREVIEW["title"]) + report["checks"].append("save_reopen_nested_local_and_legacy_flat") + + build_site(site, work / "dist") + public = (work / f"dist/current/{PAGE_ID}/index.html").read_text() + css_paths = list((work / "dist/current/assets").glob("site.*.css")) + assert len(css_paths) == 1, css_paths + css = css_paths[0].read_text() + for fid, selector in [("qa_nested", ".qa-nested"), ("qa_legacy", ".qa-legacy")]: + assert f"/* fragment: {fid} */" in css and selector in css + assert "/assets/" + css_paths[0].name in public + assert "data-preview-" not in public and "data-fragment-category" not in public + assert PREVIEW["title"] in public and "Legacy flat content" in public + public_page = page.context.new_page() + response = public_page.goto(origin + f"/{PAGE_ID}/") + assert response.status == 200, response.status + expect(public_page.locator(".qa-nested")).to_have_css("border-top-width", "7px") + expect(public_page.locator(".qa-legacy")).to_have_css("padding-top", "11px") + public_page.close() + report["checks"].append("static_nested_flat_hashed_css_bundle_served") + + +def run(out: Path, report): + with tempfile.TemporaryDirectory(prefix="fragments-002-browser-") as tmp: + work = Path(tmp) + site = baseline(work) + expected = seed_catalog(site) + admin_socket, preview_socket = reserve(), reserve() + origin = f"http://127.0.0.1:{admin_socket.getsockname()[1]}" + preview_origin = f"http://127.0.0.1:{preview_socket.getsockname()[1]}" + env = environment(site, work, hash_password(PASSWORD, n=2**10)) + env.update(SITE_ADMIN_ORIGIN=origin, SITE_PREVIEW_ORIGIN=preview_origin) + report["fixture"] = "git archive HEAD examples/studio-site + disposable catalog probes" + with (patch.dict(os.environ, env), serve(create_app(), admin_socket), + serve(create_preview_app(), preview_socket), sync_playwright() as pw): + browser_type = getattr(pw, os.environ.get("QA_BROWSER", "chromium")) + options = {"headless": True} + if browser_type.name == "chromium": + options["args"] = ["--no-sandbox", "--no-proxy-server"] + elif browser_type.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 = browser_type.launch(**options) + report["browser"] = {"name": browser_type.name, "version": browser.version} + context = browser.new_context(viewport={"width": 1440, "height": 960}, reduced_motion="reduce") + + def monitor(page): + page.set_default_timeout(12000) + 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) + def native_dialog(dialog): + report["errors"].append(f"Forbidden native dialog: {dialog.type}: {dialog.message}") + dialog.dismiss() + page.on("dialog", native_dialog) + page.on("request", lambda request: report["browser_api_requests"].append(request.url) + if "/admin/api/v1/" in request.url or "authorization" in request.headers else None) + context.on("page", monitor) + page = context.new_page() + try: + 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/") + response = page.goto(origin + f"/admin/pages/{PAGE_ID}") + assert response.status == 200, response.status + idle(page) + # Compare served assets with exact current sources, including category CSS. + report["runtime_assets"] = {} + for name in ("builder-adapter.css", "builder.js"): + response = page.request.get(origin + "/admin/static/" + name) + assert response.status == 200, (name, response.status) + current = (ROOT / "src/site_engine/web/admin/static" / name).read_bytes() + assert response.body() == current, name + report["runtime_assets"][name] = hashlib.sha256(current).hexdigest() + expect(page.locator("#preview-result iframe")).to_have_attribute("src", re.compile(re.escape(preview_origin))) + for width in (1440, 390): + catalog_checks(page, expected, width, out, report) + add_save_reopen(page, site, origin, work, report) + assert not report["errors"], report["errors"] + assert not report["browser_api_requests"], report["browser_api_requests"] + report["checks"].append("no_native_dialogs_js_errors_or_browser_credentials") + except Exception: + page.screenshot(path=str(out / "failure.png"), full_page=True) + raise + finally: + browser.close() + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--out", type=Path, default=Path("/tmp/site-engine-fragments-002")) + args = parser.parse_args() + args.out.mkdir(parents=True, exist_ok=True) + report = {"status": "running", "checks": [], "widths": [], "errors": [], "browser_api_requests": []} + try: + run(args.out, report) + report["status"] = "passed" + except Exception: + report["status"] = "failed" + report["failure"] = traceback.format_exc() + raise + finally: + (args.out / "report.json").write_text(json.dumps(report, ensure_ascii=False, indent=2), encoding="utf-8") + print(json.dumps({"status": report["status"], "checks": len(report["checks"]), "artifacts": str(args.out)})) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_site_studio_002.py b/scripts/qa_site_studio_002.py new file mode 100644 index 0000000..82c2450 --- /dev/null +++ b/scripts/qa_site_studio_002.py @@ -0,0 +1,247 @@ +"""Compare production Site Studio with the seed in Chromium, using isolated FastAPI servers.""" + +from __future__ import annotations + +import argparse +import json +import os +import re +import shutil +import tempfile +from pathlib import Path +from unittest.mock import patch + +from fastapi import FastAPI +from fastapi.staticfiles import StaticFiles +from playwright.sync_api import expect, sync_playwright +from qa_001 import PASSWORD, ROOT, serve +from qa_ai_studio import LocalURLs + +from site_engine.build.pipeline import build_site +from site_engine.core.registry import load_site +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app + + +def geometry(page, selector): + return page.locator(selector).evaluate_all("""nodes => nodes.map(n => { + const r=n.getBoundingClientRect(), s=getComputedStyle(n); + return {x:r.x,y:r.y,width:r.width,height:r.height,paddingTop:s.paddingTop, + paddingBottom:s.paddingBottom,font:s.font,background:s.backgroundImage,backgroundColor:s.backgroundColor}; + })""") + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--out", type=Path, default=Path("/tmp/site-engine-studio-002")) + args = parser.parse_args() + args.out.mkdir(parents=True, exist_ok=True) + report = {"checks": [], "geometry": [], "page_errors": [], "dialogs": [], "http_errors": []} + with tempfile.TemporaryDirectory(prefix="site-studio-002-") as tmp: + work = Path(tmp) + site, dist = work / "site", work / "dist" + shutil.copytree(ROOT / "examples/site-studio", site) + result = build_site(site, dist) + assert result.pages == 13, result.pages + current = dist / "current" + # Every generated local link and asset must resolve. Redirect HTML is included. + for html in current.rglob("*.html"): + parsed = LocalURLs() + parsed.feed(html.read_text()) + for url in parsed.urls: + local = url.split("#", 1)[0].split("?", 1)[0] + if not local: + continue + target = ( + current / local.lstrip("/") if local.startswith("/") else html.parent / local + ) + assert target.is_file() or (target / "index.html").is_file(), (html, url) + assert not (current / "cases/booking").exists() + assert not (current / "services/automation").exists() + assert not (current / "scenarios/real-estate").exists() + assert not (current / "blog").exists() and not (current / "courses").exists() + report["checks"].append( + "13 pages, all local links/assets/redirects, draft and feature exclusion" + ) + reference = FastAPI() + reference.mount( + "/", StaticFiles(directory=ROOT / "design/examples/site-studio/preview-dist", html=True) + ) + env = { + "SITE_ROOT": str(site), + "SITE_DIST": str(dist), + "SITE_STATE_DIR": str(work / "state"), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "site-studio-browser-secret-" * 3, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": "", + "SITE_PREVIEW_ORIGIN": "", + } + with ( + patch.dict(os.environ, env), + serve(create_app()) as origin, + serve(reference) as ref_origin, + sync_playwright() as pw, + ): + browser = pw.chromium.launch(channel="chromium", headless=True, args=["--no-sandbox"]) + page = browser.new_page(viewport={"width": 1440, "height": 1000}) + source = browser.new_page(viewport={"width": 1440, "height": 1000}) + page.on("pageerror", lambda e: report["page_errors"].append(str(e))) + page.on("dialog", lambda d: (report["dialogs"].append(d.message), d.dismiss())) + page.on( + "response", + lambda r: ( + report["http_errors"].append([r.status, r.url]) + if r.status >= 400 and "/forms/" not in r.url + else None + ), + ) + for width in (1440, 1280, 1024, 768, 390, 360): + for p in (page, source): + p.set_viewport_size({"width": width, "height": 1000}) + for route in ( + "/", + "/about/", + "/services/", + "/services/bots/", + "/request/", + "/privacy/", + ): + page.goto(origin + route) + source.goto(ref_origin + route) + page.locator("img").evaluate_all( + "(nodes)=>Promise.all(nodes.map(n=>n.decode().catch(()=>{})))" + ) + source.locator("img").evaluate_all( + "(nodes)=>Promise.all(nodes.map(n=>n.decode().catch(()=>{})))" + ) + page.evaluate("window.scrollTo(0,0)") + source.evaluate("window.scrollTo(0,0)") + assert page.evaluate("document.documentElement.scrollWidth <= innerWidth"), ( + width, + route, + ) + actual = geometry(page, "[data-engine-block]") + expected = geometry(source, "[data-block] > :first-child") + report["geometry"].append( + {"width": width, "route": route, "actual": actual, "source": expected} + ) + assert len(actual) == len(expected), (width, route, len(actual), len(expected)) + for a, b in zip(actual, expected): + assert abs(a["x"] - b["x"]) < 1 and abs(a["width"] - b["width"]) < 1, ( + width, + route, + a, + b, + ) + if route != "/request/": + assert ( + abs(a["y"] - b["y"]) < 1 and abs(a["height"] - b["height"]) < 1 + ), (width, route, a, b) + assert a["background"] == b["background"], (width, route, a, b) + # Header alpha uses the theme color and may serialize as color(srgb …). + if a != actual[0]: + assert a["backgroundColor"] == b["backgroundColor"], ( + width, + route, + a, + b, + ) + if width in (1440, 390): + name = route.strip("/").replace("/", "-") or "home" + page.screenshot( + path=str(args.out / f"public-{name}-{width}.png"), full_page=True + ) + source.screenshot( + path=str(args.out / f"source-{name}-{width}.png"), full_page=True + ) + report["checks"].append( + f"{width}px: six source/public pages, width geometry and no overflow" + ) + page.set_viewport_size({"width": 1440, "height": 1000}) + page.goto(origin + "/services/") + page.locator("details summary").focus() + page.keyboard.press("Enter") + assert page.locator("details").evaluate("(n)=>n.open") + page.goto(origin + "/request/") + page.locator('[name="name"]').fill("Демонстрация") + page.locator('[name="email"]').fill("test@example.org") + page.locator('[name="consent"]').check() + with page.expect_response(lambda r: "/forms/form_contact" in r.url) as sent: + page.locator(".demo-form button").click() + assert sent.value.status == 501 + page.get_by_role("status").filter(has_text="HTTP 501").wait_for() + assert page.locator('[name="email"]').input_value() == "test@example.org" + assert page.url == origin + "/request/" + report["checks"].append( + "FAQ keyboard/native details; actual form POST=501 with visible feedback and preserved input" + ) + 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/index") + page.bring_to_front() + assert page.locator("#document-editor").count() or "document-editor" in page.content() + frame = page.frame_locator("#preview-result iframe") + expect(frame.locator(".f-hero h1")).to_have_text("Автоматизируем бизнес с помощью AI") + expect(frame.locator(".f-hero")).to_have_attribute("data-preview-selected", "true") + expect(frame.locator(".f-hero")).to_have_css( + "background-image", re.compile("linear-gradient") + ) + expect(frame.locator(".f-hero h1")).to_be_visible() + page.wait_for_load_state("networkidle") + page.screenshot(path=str(args.out / "constructor-1440.png"), full_page=True) + reg = load_site(site) + assert reg.fragments["steps"].builtin and reg.fragments["entry_card"].builtin + report["checks"].append( + "Real admin opens the independent example with shared steps/entry_card" + ) + original = (site / "pages/index.md").read_bytes() + page.locator("[data-catalog-open]").first.click() + dialog = page.locator("#builder-catalog-dialog") + dialog.locator("[data-catalog-search]").fill("entry_card") + dialog.locator('[data-fragment="entry_card"]').click() + field = page.locator('[data-inspector] [name="p.entry"]') + expect(field).to_be_visible() + options = page.locator( + '[data-inspector] datalist[id="dl-p.entry"] option' + ).evaluate_all("(nodes)=>nodes.map(n=>n.value)") + assert set(options) == { + "services/bots", + "services/ai", + "scenarios/legal", + "cases/ai-reception", + }, options + field.fill("services/bots") + expect(page.locator("#document-source")).to_have_value( + re.compile("entry: services/bots") + ) + assert (site / "pages/index.md").read_bytes() == original + expect(frame.locator('.f-entry_card a[href="/services/bots/"]')).to_contain_text( + "Telegram-боты" + ) + page.locator("[data-save-document]").click() + expect(page.locator("#editor-result")).to_have_attribute("data-saved", "1") + assert "entry: services/bots" in (site / "pages/index.md").read_text() + page.reload() + assert "entry: services/bots" in page.locator("#document-source").input_value() + report["checks"].append( + "entry_card: only published collection/slug choices, unsaved buffer, explicit Save and reopen" + ) + browser.close() + assert not report["page_errors"] and not report["dialogs"] and not report["http_errors"], report + (args.out / "browser.json").write_text(json.dumps(report, ensure_ascii=False, indent=2)) + print( + json.dumps( + {"checks": report["checks"], "comparisons": len(report["geometry"])}, + ensure_ascii=False, + indent=2, + ) + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_theme_002.py b/scripts/qa_theme_002.py new file mode 100644 index 0000000..8793a3d --- /dev/null +++ b/scripts/qa_theme_002.py @@ -0,0 +1,280 @@ +"""Stages 2/3: real public/admin/preview browser checks on a disposable independent site.""" + +from __future__ import annotations + +import argparse +import json +import os +import re +import sys +import tempfile +import traceback +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 + +sys.path.insert(0, str(ROOT / "tests")) +from test_fragment_catalog_ui import environment +from theme_fixture import document, seed, write + +from site_engine.build.pipeline import build_site +from site_engine.core.theme import preset_catalog +from site_engine.parsing import frontmatter +from site_engine.parsing.yamlio import dump_yaml +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 + +WIDTHS = (1440, 1280, 1024, 1023, 768, 700, 699, 390, 360) + + +def palette_checks(page, origin, site, work, report): + def rgb(color): + return "rgb(" + ", ".join(str(int(color[i:i + 2], 16)) for i in (1, 3, 5)) + ")" + for name, preset in preset_catalog().items(): + overrides = {k: preset[k] for k in ("colors", "type", "ui")} if name == "custom" else {} + write(site, "theme.yaml", dump_yaml(document(name, overrides))) + build_site(site, work / "dist") + page.goto(origin + "/") + expect(page.locator("body")).to_have_css("background-color", rgb(preset["colors"]["background"])) + expect(page.locator("body")).to_have_css("color", rgb(preset["colors"]["text"])) + expect(page.locator(".f-hero h1")).to_have_css("font-weight", str(preset["type"]["headingWeight"])) + expect(page.locator(".f-hero .f-btn")).to_have_css("border-radius", str(preset["ui"]["radius"]) + "px") + write(site, "theme.yaml", dump_yaml(document(overrides={"gradients": {"enabled": True}}))) + build_site(site, work / "dist") + page.goto(origin + "/") + assert page.locator(".f-hero .f-btn").evaluate("e=>getComputedStyle(e).backgroundImage").startswith("linear-gradient"), "button gradient not consumed" + write(site, "theme.yaml", dump_yaml(document(overrides={"gradients": {"enabled": False}}))) + build_site(site, work / "dist") + page.goto(origin + "/") + expect(page.locator(".f-hero .f-btn")).to_have_css("background-image", "none") + report["checks"].append("6_presets_typography_button_tokens_and_gradient_toggle_rendered") + + +def public_checks(page, origin, site, work, out, report): + meta, body = frontmatter.parse((site / "pages/index.md").read_text()) + meta["regions"]["main"] += [ + {"id": f"pair_{outer}_{inner}", "fragment": "hero", "anchor": f"pair_{outer}_{inner}", + "props": {"title": f"{outer} / {inner}"}, + "layout": {"section_width": outer, "content_width": inner}} + for outer in ("boxed", "fluid", "full") for inner in ("boxed", "fluid", "full") + ] + write(site, "pages/index.md", frontmatter.dumps(meta, body)) + for mode in ("boxed", "fluid", "full"): + write(site, "theme.yaml", dump_yaml(document(overrides={"ui": {"container": { + "mode": mode, "max_width": 1080, "gutter": {"desktop": 36, "tablet": 24, "mobile": 16}, + }}}))) + build_site(site, work / "dist") + for width in WIDTHS: + page.set_viewport_size({"width": width, "height": 960}) + response = page.goto(origin + "/") + assert response.status == 200, response.status + gutter = 36 if width >= 1024 else 24 if width >= 700 else 16 + assert page.evaluate("document.documentElement.scrollWidth <= innerWidth + 1"), (mode, width, "overflow") + for outer in ("boxed", "fluid", "full"): + expected = min(width - 2 * gutter, 1080) if outer == "boxed" else width - 2 * gutter if outer == "fluid" else width + for inner in ("boxed", "fluid", "full"): + locator = page.locator(f"#pair_{outer}_{inner} + section") + actual = locator.evaluate("e=>({width:e.getBoundingClientRect().width,inner:e.firstElementChild.getBoundingClientRect().width,padding:parseFloat(getComputedStyle(e.firstElementChild).paddingLeft)})") + assert abs(actual["width"] - expected) < 1, (mode, width, outer, inner, actual, expected) + expected_content = min(expected, 1080) if inner == "boxed" else expected + assert abs(actual["inner"] - expected_content) < 1, (width, outer, inner, actual) + assert actual["padding"] == (0 if inner == "full" else gutter), (width, outer, inner, actual) + # Parent full content must not rewrite the nested block's fluid container. + child = page.locator('.f-section .f-richtext [data-engine-container]') + expect(child).to_have_attribute("data-engine-container", "fluid") + expect(child).to_have_css("padding-left", f"{gutter}px") + expect(page.locator('body > .f-site_header [data-engine-container]')).to_have_attribute("data-engine-container", mode) + page.evaluate("scrollTo(0, 550)") + assert abs(page.locator("body > .f-site_header").bounding_box()["y"]) < 1, "sticky header" + if mode == "boxed" and width in (1440, 390, 360): + page.evaluate("scrollTo(0,0)") + page.screenshot(path=str(out / f"public-{width}.png")) + report["geometry"].append({"mode": mode, "width": width, "gutter": gutter, "pairs": 9}) + for gutter in (0, 96): + write(site, "theme.yaml", dump_yaml(document(overrides={"ui": {"container": {"gutter": {"desktop": gutter, "tablet": gutter, "mobile": gutter}}}}))) + build_site(site, work / "dist") + page.set_viewport_size({"width": 360, "height": 960}) + page.goto(origin + "/") + assert page.evaluate("document.documentElement.scrollWidth <= innerWidth + 1"), ("gutter", gutter) + # Return to boxed before the constructor scenario. + write(site, "theme.yaml", dump_yaml(document(overrides={"ui": {"container": { + "mode": "boxed", "max_width": 1080, "gutter": {"desktop": 36, "tablet": 24, "mobile": 16}, + }}}))) + report["checks"].append("3_global_modes_9_width_pairs_9_breakpoints_nested_and_sticky") + + +def active_frame(page, identity="hero_home"): + frame = page.frame_locator("#preview-result iframe") + expect(frame.locator(f'[data-preview-id="{identity}"]')).to_have_count(1) + return frame + + +def source(page): + return page.locator("#document-source").input_value() + + +def idle(page): + page.wait_for_function("() => window.siteDocument && !window.siteDocument.state.busy") + + +def constructor_checks(page, origin, preview_origin, site, out, report): + 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/") + page.goto(origin + "/admin/pages/index") + idle(page) + expect(page.locator("#preview-result iframe")).to_have_attribute("src", re.compile(re.escape(preview_origin))) + active_frame(page) + reference = page.context.browser.new_page(viewport={"width": 1440, "height": 960}) + try: + reference.goto((ROOT / "design/builder-antirion.html").as_uri()) + reference.locator('[data-block-width="section_width"]').wait_for() + properties = ["fontFamily", "fontSize", "backgroundColor", "color", "borderRadius", "borderTopWidth", "height", "paddingTop", "paddingLeft"] + for key in ("section_width", "content_width"): + selector = f'[data-block-width="{key}"]' + actual = page.locator("#inspectpane " + selector) + expected = reference.locator(selector) + self_options = actual.locator("option").evaluate_all("items=>items.map(i=>[i.value,i.textContent])") + reference_options = expected.locator("option").evaluate_all("items=>items.map(i=>[i.value,i.textContent])") + assert self_options == reference_options, (key, self_options, reference_options) + metrics = "(el,props)=>Object.fromEntries(props.map(p=>[p,getComputedStyle(el)[p]]))" + a, b = actual.evaluate(metrics, properties), expected.evaluate(metrics, properties) + assert a == b, (key, a, b) + reference.screenshot(path=str(out / "reference-controls-1440.png")) + report["checks"].append("width_controls_options_and_computed_styles_match_original_design") + finally: + reference.close() + requests = [] + page.on("request", lambda r: requests.append(r.url) if "/admin/editor/pages/index/" in r.url else None) + count = len(requests) + page.locator('[data-tree-id="section_outer"]').click() + expect(page.locator('#inspectpane [data-block-width="section_width"]')).to_have_value("fluid") + page.locator('[data-tree-id="hero_home"]').click() + expect(active_frame(page).locator('[data-preview-id="hero_home"]')).to_have_attribute("data-preview-selected", "true") + assert len(requests) == count, requests + report["checks"].append("section_selection_local_and_preview_highlights") + before = (site / "pages/index.md").read_bytes() + # Change the long last section while retaining its selected preview and viewport position. + page.locator('[data-tree-id="richtext_long_7"]').click() + frame = active_frame(page, "richtext_long_7") + expect(frame.locator('[data-preview-id="richtext_long_7"]')).to_have_attribute("data-preview-selected", "true") + position = frame.locator("body").evaluate("()=>scrollY") + assert position > 100, position + preview_before = page.locator("#preview-result").get_attribute("data-snapshot") + page.locator('#inspectpane [data-block-width="content_width"]').select_option("full") + expect(page.locator("#document-source")).to_have_value(re.compile("content_width: full")) + page.wait_for_function("old => document.querySelector('#preview-result').dataset.snapshot !== old", arg=preview_before) + frame = active_frame(page, "richtext_long_7") + expect(frame.locator('[data-preview-id="richtext_long_7"]')).to_have_attribute("data-content-width", "full") + expect(frame.locator('[data-preview-id="richtext_long_7"]')).to_have_attribute("data-preview-selected", "true") + page.wait_for_function("() => !window.siteDocument.state.busy") + actual = frame.locator("body").evaluate("()=>scrollY") + assert abs(actual - position) < 3, (position, actual) + assert (site / "pages/index.md").read_bytes() == before + report["checks"].append("width_change_refreshes_preview_preserves_scroll_selection_without_save") + # Constructor/expert share the same YAML; changing props retains explicit layout. + canonical = source(page) + page.locator('[data-editor-mode="expert"]').click() + expect(page.locator("#document-editor")).to_have_attribute("data-mode", "expert") + assert source(page) == canonical + page.locator('[data-editor-mode="constructor"]').click() + expect(page.locator("#document-editor")).to_have_attribute("data-mode", "constructor") + assert source(page) == canonical + page.locator('[data-tree-id="hero_home"]').click() + page.locator('#inspectpane [data-block-width="section_width"]').select_option("fluid") + expect(page.locator("#document-source")).to_have_value(re.compile("section_width: fluid")) + idle(page) + page.locator('#inspectpane [name="p.title"]').fill("Ширина после изменения текста") + expect(page.locator("#document-source")).to_have_value(re.compile("Ширина после изменения текста")) + expect(page.locator('#inspectpane [data-block-width="section_width"]')).to_have_value("fluid") + idle(page) + page.locator('[data-save-document]').click() + expect(page.locator("#buffer-status")).to_have_text("Нет несохранённых изменений") + page.reload() + idle(page) + frame = active_frame(page) + expect(frame.locator('[data-preview-id="hero_home"]')).to_have_attribute("data-preview-selected", "true") + expect(page.locator('#inspectpane [data-block-width="section_width"]')).to_have_value("fluid") + meta, _ = frontmatter.parse((site / "pages/index.md").read_text()) + assert meta["regions"]["main"][0]["layout"]["section_width"] == "fluid" + report["checks"].append("constructor_expert_props_save_reopen_keep_layout") + for width in (1440, 1280, 1024, 768, 390, 360): + page.set_viewport_size({"width": width, "height": 960}) + assert page.evaluate("document.documentElement.scrollWidth <= innerWidth + 1"), ("admin", width) + if width in (1440, 390): + page.locator('#inspectpane [data-block-width="section_width"]').scroll_into_view_if_needed() + page.screenshot(path=str(out / f"constructor-{width}.png")) + report["checks"].append("admin_6_widths_no_overflow") + + +def run(out, report): + with tempfile.TemporaryDirectory(prefix="theme-002-browser-") as temp: + work = Path(temp) + site = work / "site" + seed(site) + admin_socket, preview_socket = reserve(), reserve() + origin = f"http://127.0.0.1:{admin_socket.getsockname()[1]}" + preview_origin = f"http://127.0.0.1:{preview_socket.getsockname()[1]}" + env = environment(site, work, hash_password(PASSWORD, n=2**10)) + env.update(SITE_ADMIN_ORIGIN=origin, SITE_PREVIEW_ORIGIN=preview_origin) + with (patch.dict(os.environ, env), serve(create_app(), admin_socket), + serve(create_preview_app(), preview_socket), sync_playwright() as pw): + options = {"headless": True, "args": ["--no-sandbox", "--no-proxy-server"]} + if os.environ.get("QA_BROWSER_EXECUTABLE"): + options["executable_path"] = os.environ["QA_BROWSER_EXECUTABLE"] + browser = pw.chromium.launch(**options) + report["browser"] = browser.version + context = browser.new_context(viewport={"width": 1440, "height": 960}, reduced_motion="reduce") + def monitor(page): + page.set_default_timeout(15000) + page.on("pageerror", lambda error: report["errors"].append(str(error))) + page.on("console", lambda m: report["errors"].append(m.text) if m.type == "error" else None) + def dialog(d): + report["errors"].append(f"native dialog: {d.type}") + d.dismiss() + page.on("dialog", dialog) + page.on("request", lambda r: report["browser_api_requests"].append(r.url) + if "/admin/api/v1/" in r.url or "authorization" in r.headers else None) + context.on("page", monitor) + page = context.new_page() + try: + palette_checks(page, origin, site, work, report) + public_checks(page, origin, site, work, out, report) + constructor_checks(page, origin, preview_origin, site, out, report) + assert not report["errors"], report["errors"] + assert not report["browser_api_requests"], report["browser_api_requests"] + report["checks"].append("no_js_errors_native_dialogs_browser_api_credentials") + except Exception: + page.screenshot(path=str(out / "failure.png"), full_page=True) + raise + finally: + browser.close() + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--out", type=Path, default=Path("/tmp/site-engine-theme-002")) + args = parser.parse_args() + args.out.mkdir(parents=True, exist_ok=True) + report = {"status": "running", "checks": [], "geometry": [], "errors": [], "browser_api_requests": []} + try: + run(args.out, report) + report["status"] = "passed" + except Exception: + report["status"] = "failed" + report["failure"] = traceback.format_exc() + raise + finally: + (args.out / "browser.json").write_text(json.dumps(report, ensure_ascii=False, indent=2)) + print(json.dumps({"status": report["status"], "checks": len(report["checks"]), "artifacts": str(args.out)})) + + +if __name__ == "__main__": + main() diff --git a/scripts/qa_theme_manager_002.py b/scripts/qa_theme_manager_002.py new file mode 100644 index 0000000..6ed3c60 --- /dev/null +++ b/scripts/qa_theme_manager_002.py @@ -0,0 +1,506 @@ +"""Theme Manager: source comparison and real browser/API acceptance on an isolated site.""" + +from __future__ import annotations + +import argparse +import json +import os +import shutil +import socket +import tempfile +from pathlib import Path +from unittest.mock import patch + +from fastapi import FastAPI +from fastapi.staticfiles import StaticFiles +from playwright.sync_api import expect, sync_playwright +from qa_001 import PASSWORD, ROOT, serve + +from site_engine.parsing.yamlio import dump_yaml, load_yaml +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 click(page, action, identity=None): + selector = f'button[data-action="{action}"]' + if identity is not None: + selector += f'[data-id="{identity}"]' + page.locator(selector).click() + + +def frame_ready(page): + page.wait_for_function( + """()=>{const f=document.getElementById('theme-preview'),app=document.getElementById('theme-app'),device=document.querySelector('[data-action=device][aria-pressed=true]')?.dataset.id,target=document.getElementById('theme-preview-target')?.value==='sample'?'sample':'page';return f&&f.dataset.revision===app.dataset.revision&&f.dataset.device===device&&f.dataset.target===target&&+f.dataset.viewportWidth===innerWidth}""", + timeout=20000, + ) + page.frame_locator("#theme-preview").locator( + ".sample-site, [data-engine-block]" + ).first.wait_for(timeout=20000) + # Wait for a resolved resource, not an animation frame inside a passive sandbox. + expect(page.locator("#source-preview")).not_to_have_text( + "Проверяем текущие изменения…", timeout=20000 + ) + + +def styles(page, selector): + return page.locator(selector).first.evaluate("""e=>{const s=getComputedStyle(e),r=e.getBoundingClientRect();return { + fontSize:s.fontSize,fontWeight:s.fontWeight,borderRadius:s.borderRadius, + padding:s.padding,background:s.backgroundColor,width:r.width,height:r.height + }}""") + + +def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--out", type=Path, default=Path("/tmp/site-engine-manager-002")) + args = parser.parse_args() + args.out.mkdir(parents=True, exist_ok=True) + report = { + "checks": [], + "comparisons": [], + "page_errors": [], + "csp_errors": [], + "native_dialogs": [], + "unexpected_http": [], + "expected_http": [], + } + with tempfile.TemporaryDirectory(prefix="theme-manager-002-") as tmp: + work = Path(tmp) + site, state = work / "site", work / "state" + shutil.copytree(ROOT / "examples/site-studio", site) + # Use the exact source default for component comparison, with no live publication. + (site / "theme.yaml").write_text( + dump_yaml({"schema": 1, "preset": "minimal", "preset_version": 1, "overrides": {}}) + ) + env = { + "SITE_ROOT": str(site), + "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(state), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": hash_password(PASSWORD, n=2**10), + "SITE_SECRET_KEY": "theme-manager-browser-secret-" * 3, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": "", + "SITE_PREVIEW_ORIGIN": "", + } + reference = FastAPI() + reference.mount("/", StaticFiles(directory=ROOT / "design", html=True)) + with ( + patch.dict(os.environ, env), + serve(create_app()) as origin, + serve(reference) as source_origin, + sync_playwright() as pw, + ): + browser = pw.chromium.launch( + channel="chromium", headless=True, args=["--no-sandbox", "--no-proxy-server"] + ) + context = browser.new_context(viewport={"width": 1440, "height": 1050}) + page = context.new_page() + source = context.new_page() + expected_errors = set() + + def watch(p): + p.on("pageerror", lambda e: report["page_errors"].append(str(e))) + p.on( + "console", + lambda m: ( + report["csp_errors"].append(m.text) + if "Content Security Policy" in m.text or "violates" in m.text + else None + ), + ) + p.on("dialog", lambda d: (report["native_dialogs"].append(d.message), d.dismiss())) + p.on( + "response", + lambda r: ( + ( + report["expected_http"] + if any(x in r.url for x in expected_errors) + else report["unexpected_http"] + ).append([r.status, r.url.split("?")[0]]) + if r.status >= 400 and not r.url.endswith("/favicon.ico") + else None + ), + ) + + watch(page) + 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/theme") + source.goto(source_origin + "/theme-studio-antirion.html") + frame_ready(page) + initial = (site / "theme.yaml").read_bytes() + expect(page.locator("[data-action=preset]")).to_have_count(6) + assert page.locator("[data-action=preset]").evaluate_all( + "(ns)=>ns.map(n=>n.dataset.id)" + ) == ["minimal", "dark", "editorial", "bold", "natural", "custom"] + # The source shell is deliberately not transplanted: existing admin skin is retained. + original_shell = styles(page, ".sidebar") + for width in (1440, 1280, 1024, 768, 390, 360): + for p in (page, source): + p.set_viewport_size({"width": width, "height": 1050}) + for step in range(4): + print(f"source comparison {width}px step {step + 1}", flush=True) + click(page, "step", str(step)) + click(source, "step", str(step)) + assert page.evaluate("document.documentElement.scrollWidth<=innerWidth+1"), ( + width, + step, + ) + # Exact designer component metrics, excluding textual changes and the persistent shell. + for selector in ( + ".theme-heading h1", + ".theme-section-head h2", + ".step-button", + ".preset-option" if step == 0 else ".wz-subtitle", + ): + actual, ref = styles(page, selector), styles(source, selector) + for key in ("fontSize", "borderRadius", "padding"): + assert actual[key] == ref[key], ( + width, + step, + selector, + key, + actual, + ref, + ) + report["comparisons"].append( + { + "width": width, + "step": step, + "selector": selector, + "actual": actual, + "source": ref, + } + ) + frame_ready(page) + if step == 0: + actual_hero = ( + page.frame_locator("#theme-preview") + .locator(".sample-hero") + .evaluate("e=>getComputedStyle(e).paddingTop") + ) + source_hero = source.locator(".sample-hero").evaluate( + "e=>getComputedStyle(e).paddingTop" + ) + assert actual_hero == source_hero, (width, actual_hero, source_hero) + actual_nav = ( + page.frame_locator("#theme-preview") + .locator(".sample-nav-links") + .evaluate("e=>getComputedStyle(e).display") + ) + source_nav = source.locator(".sample-nav-links").evaluate( + "e=>getComputedStyle(e).display" + ) + assert actual_nav == source_nav, (width, actual_nav, source_nav) + page.evaluate( + "document.getElementById('theme-preview')?.scrollIntoView({block:'center'})" + ) + page.wait_for_timeout(120) + if step == 3: + page.screenshot(path=str(args.out / f"manager-{width}-preview.png")) + page.evaluate("window.scrollTo(0,0)") + page.wait_for_timeout(60) + page.screenshot( + path=str(args.out / f"manager-{width}-step{step + 1}.png"), full_page=True + ) + source.screenshot( + path=str(args.out / f"source-{width}-step{step + 1}.png"), full_page=True + ) + click(page, "device", "phone") + frame_ready(page) + assert page.locator("#theme-preview").bounding_box()["width"] <= 315 + click(page, "device", "desktop") + frame_ready(page) + report["checks"].append( + "24 source UI comparisons × 4 components, six widths, all steps and devices, no overflow" + ) + page.set_viewport_size({"width": 1440, "height": 1050}) + click(page, "step", "0") + # Every server preset renders through the same stand, with no file writes. + for preset in ("minimal", "dark", "editorial", "bold", "natural", "custom"): + click(page, "preset", preset) + if page.locator("#theme-confirm.open").count(): + click(page, "confirm-yes") + frame_ready(page) + expect(page.locator(f"[data-action=preset][data-id={preset}]")).to_have_attribute( + "aria-pressed", "true" + ) + page.screenshot(path=str(args.out / f"preset-{preset}.png")) + assert (site / "theme.yaml").read_bytes() == initial + report["checks"].append("Six presets, source confirmation, zero auto-save") + click(page, "step", "1") + field = page.locator('[data-field="color:primary"]') + field.fill("#123456") + frame_ready(page) + expect(page.locator("#source-preview")).to_contain_text("#123456") + # A late response for older input cannot replace the newer snapshot. + held = [] + + def hold_first(route): + part = route.request.post_data.split('name="payload"', 1)[1].split("\r\n\r\n", 1)[1] + payload = json.loads(part.rsplit("\r\n--", 1)[0]) + if not held: + held.append((route, payload["revision"])) + else: + route.continue_() + + page.route("**/admin/theme/preview", hold_first) + with page.expect_request("**/admin/theme/preview"): + field.fill("#112233") + page.wait_for_timeout(50) + assert held + field.fill("#334455") + frame_ready(page) + newest = page.locator("#theme-preview").get_attribute("src") + held[0][0].fulfill( + status=200, + content_type="application/json", + body=json.dumps( + { + "url": "about:blank", + "revision": held[0][1], + "interactive": False, + "snapshot": "obsolete", + "expires_at": 0, + } + ), + ) + page.wait_for_timeout(100) + assert page.locator("#theme-preview").get_attribute("src") == newest + page.unroute("**/admin/theme/preview") + field.fill("#123456") + frame_ready(page) + before_step = page.locator("#theme-preview").element_handle() + click(page, "step", "2") + assert before_step.evaluate("e=>e===document.getElementById('theme-preview')") + click(page, "step", "1") + report["checks"].append( + "Delayed old preview ignored; step selection retains the same iframe" + ) + page.locator("#new-color-name").fill("promo_highlight") + click(page, "add-color") + expect(page.locator("[data-extra-color=promo_highlight]")).to_be_visible() + page.locator("[data-gradient-toggle]").check() + click(page, "add-stop") + frame_ready(page) + assert page.locator("[data-gradient-stop]").count() == 3 + page.locator("#new-gradient-name").fill("promo_bg") + click(page, "add-gradient") + frame_ready(page) + expect(page.locator("[data-action=gradient-role][data-id=promo_bg]")).to_be_visible() + click(page, "remove-gradient", "promo_bg") + expect(page.locator("button[data-action=confirm-no]")).to_be_focused() + page.keyboard.press("Shift+Tab") + expect(page.locator("[data-action=confirm-yes]")).to_be_focused() + page.keyboard.press("Tab") + expect(page.locator("button[data-action=confirm-no]")).to_be_focused() + page.keyboard.press("Escape") + expect(page.locator("#theme-confirm")).not_to_have_class("open") + click(page, "step", "2") + click(page, "font-pair", "classic") + page.locator('[data-field="type:heading"]').select_option("Arial, sans-serif") + frame_ready(page) + click(page, "step", "3") + click(page, "container-mode", "fluid") + page.locator("[data-container-gutter=mobile]").fill("0") + click(page, "choice", "button:outline") + frame_ready(page) + assert (site / "theme.yaml").read_bytes() == initial + # Real page and component stand are both immutable snapshots of unsaved input. + page.locator("#theme-preview-target").select_option("index") + frame_ready(page) + expect( + page.frame_locator("#theme-preview").locator("[data-engine-block]").first + ).to_be_visible() + page.screenshot(path=str(args.out / "real-page-overlay.png"), full_page=True) + page.locator("#theme-preview-target").select_option("sample") + frame_ready(page) + report["checks"].append( + "Colors, custom tokens, gradients/stops, fonts, widths and real-page overlay; keyboard modal containment" + ) + with page.expect_download() as dl: + click(page, "yaml-download") + download = dl.value + export = load_yaml(Path(download.path()).read_text()) + assert export["schema"] == 1 and export["overrides"]["colors"]["primary"] == "#123456" + assert export["overrides"]["ui"]["container"]["gutter"]["mobile"] == 0 + report["checks"].append("Server-validated YAML/export, including zero gutters") + # Deliberately invalid values: visible error and untouched file, then recovery. + click(page, "step", "1") + expected_errors.add("/admin/theme/validate") + page.locator('[data-field="color:primary"]').fill("bad") + expect(page.locator("#theme-diagnostics")).to_contain_text("HEX", timeout=10000) + expect(page.locator("[data-action=save]")).to_be_disabled() + assert (site / "theme.yaml").read_bytes() == initial + page.locator('[data-field="color:primary"]').fill("#123456") + frame_ready(page) + expect(page.locator("[data-action=save]")).to_be_enabled() + # Two real tabs: second commit wins; first receives current snapshot and keeps its edits. + second = context.new_page() + watch(second) + second.goto(origin + "/admin/theme") + frame_ready(second) + click(second, "preset", "dark") + frame_ready(second) + click(second, "save") + expect(second.locator(".save-note")).to_contain_text( + "Сохранено в workspace", timeout=10000 + ) + expected_errors.add("/admin/theme/save") + click(page, "save") + expect(page.locator("#theme-request-error")).to_contain_text("conflict", timeout=10000) + expect(page.locator('[data-field="color:primary"]')).to_have_value("#123456") + assert load_yaml((site / "theme.yaml").read_text())["preset"] == "dark" + page.screenshot(path=str(args.out / "conflict-keeps-input.png"), full_page=True) + click(page, "conflict-rebase") + click(page, "confirm-yes") + click(page, "save") + expect(page.locator(".save-note")).to_contain_text( + "Сохранено в workspace", timeout=10000 + ) + assert ( + load_yaml((site / "theme.yaml").read_text())["overrides"]["colors"]["primary"] + == "#123456" + ) + assert ( + json.loads((state / "theme-onboarding.json").read_text())["status"] == "completed" + ) + assert not (work / "dist/current").exists() + report["checks"].append( + "Invalid input blocked; two editors 409/current + explicit rebase; Save completes workflow without publishing" + ) + # A real HTTP 500, then failed transport: edits and focus survive both. + page.locator('[data-field="color:primary"]').fill("#654321") + frame_ready(page) + page.route( + "**/admin/theme/save", + lambda route: route.fulfill( + status=500, + content_type="application/json", + body=json.dumps( + { + "error": { + "code": "qa_failure", + "message": "Ошибка сохранения · QA", + "request_id": "test-request-id", + } + } + ), + ), + ) + click(page, "save") + expect(page.locator("#theme-request-error")).to_contain_text("test-request-id") + expect(page.locator('[data-field="color:primary"]')).to_have_value("#654321") + page.unroute("**/admin/theme/save") + page.route("**/admin/theme/save", lambda route: route.abort("failed")) + click(page, "save") + expect(page.locator("#theme-request-error")).to_contain_text("network_error") + expect(page.locator('[data-field="color:primary"]')).to_have_value("#654321") + page.unroute("**/admin/theme/save") + assert ( + load_yaml((site / "theme.yaml").read_text())["overrides"]["colors"]["primary"] + == "#123456" + ) + report["checks"].append( + "HTTP 500/request_id and transport failure visible; unsaved input and saved file preserved" + ) + # Leaving asks through source modal; cancellation keeps form. + page.locator('a[href="/admin/pages"]').first.click() + expect(page.locator("#theme-confirm")).to_have_class("open") + click(page, "confirm-no") + expect(page.locator('[data-field="color:primary"]')).to_have_value("#654321") + click(page, "reset-onboarding") + click(page, "confirm-yes") + expect(page.locator('[data-action=step][data-id="0"]')).to_have_attribute( + "aria-current", "step" + ) + assert ( + json.loads((state / "theme-onboarding.json").read_text())["status"] == "in_progress" + ) + assert ( + load_yaml((site / "theme.yaml").read_text())["overrides"]["colors"]["primary"] + == "#123456" + ) + click(page, "skip") + click(page, "confirm-yes") + page.wait_for_url(origin + "/admin/") + assert json.loads((state / "theme-onboarding.json").read_text())["status"] == "skipped" + report["checks"].append( + "Navigation cancel, repeat and skip persist independently of theme/live" + ) + page.goto(origin + "/admin/theme") + frame_ready(page) + assert styles(page, ".sidebar")["background"] == original_shell["background"] + assert not page.evaluate( + "Object.keys(localStorage).some(x=>x.includes('theme-manager'))" + ) + assert not report["page_errors"], report["page_errors"] + assert not report["csp_errors"], report["csp_errors"] + assert not report["native_dialogs"], report["native_dialogs"] + assert not report["unexpected_http"], report["unexpected_http"] + second.close() + # Separate-origin immutable preview uses the existing nonce bridge/CSP. + a = socket.socket() + a.bind(("127.0.0.1", 0)) + p = socket.socket() + p.bind(("127.0.0.1", 0)) + with ( + patch.dict( + os.environ, + { + "SITE_ADMIN_ORIGIN": f"http://127.0.0.1:{a.getsockname()[1]}", + "SITE_PREVIEW_ORIGIN": f"http://127.0.0.1:{p.getsockname()[1]}", + }, + ), + serve(create_app(), a) as admin2, + serve(create_preview_app(), p) as preview2, + ): + interactive_context = browser.new_context(viewport={"width": 1440, "height": 1050}) + interactive = interactive_context.new_page() + watch(interactive) + interactive.goto(admin2 + "/admin/login") + interactive.locator("[name=login]").fill("admin") + interactive.locator("[name=password]").fill(PASSWORD) + interactive.get_by_role("button", name="Войти", exact=True).click() + interactive.goto(admin2 + "/admin/theme") + frame_ready(interactive) + expect(interactive.locator("#theme-preview")).to_have_attribute( + "sandbox", "allow-scripts allow-same-origin" + ) + assert ( + interactive.locator("#theme-preview") + .get_attribute("src") + .startswith(preview2 + "/s/") + ) + expect( + interactive.frame_locator("#theme-preview").locator(".sample-card") + ).to_have_count(3) + interactive.screenshot(path=str(args.out / "separate-origin.png"), full_page=True) + interactive_context.close() + report["checks"].append( + "Passive and separate-origin nonce preview, unchanged admin skin, no storage/native dialogs/CSP/JS/unexpected HTTP errors" + ) + assert not report["page_errors"], report["page_errors"] + assert not report["csp_errors"], report["csp_errors"] + assert not report["native_dialogs"], report["native_dialogs"] + assert not report["unexpected_http"], report["unexpected_http"] + browser.close() + (args.out / "browser.json").write_text(json.dumps(report, ensure_ascii=False, indent=2)) + print( + json.dumps( + { + "checks": len(report["checks"]), + "comparisons": len(report["comparisons"]), + "out": str(args.out), + }, + ensure_ascii=False, + ) + ) + + +if __name__ == "__main__": + main() diff --git a/scripts/verify_package_001.py b/scripts/verify_package_001.py index 1727f03..7b30f8a 100644 --- a/scripts/verify_package_001.py +++ b/scripts/verify_package_001.py @@ -1,5 +1,6 @@ """Install a wheel and smoke real FastAPI outside the checkout, without design/.""" +import argparse import os import shutil import subprocess @@ -11,6 +12,9 @@ ROOT = Path(__file__).resolve().parents[1] def main(): + parser = argparse.ArgumentParser(description=__doc__) + parser.add_argument("--site", type=Path, default=ROOT / "examples/studio-site") + args = parser.parse_args() with tempfile.TemporaryDirectory(prefix="cms-installed-001-") as tmp: work = Path(tmp) project = work / "project" @@ -54,7 +58,7 @@ def main(): check=True, ) shutil.copytree( - ROOT / "examples/studio-site", work / "site", ignore=shutil.ignore_patterns(".engine") + args.site, work / "site", ignore=shutil.ignore_patterns(".engine") ) env = dict( os.environ, @@ -76,6 +80,15 @@ 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']) +from site_engine.core.theme import preset_catalog, resolve_theme +from site_engine.errors import Report +for name, preset in preset_catalog().items(): + overrides={k:preset[k] for k in ('colors','type','ui')} if name=='custom' else {} + report=Report() + theme=resolve_theme(dict(schema=1,preset=name,preset_version=1,overrides=overrides), report) + assert theme and report.ok,(name,report) +from site_engine.build.pipeline import build_site +build_site(Path(os.environ['SITE_ROOT']),Path(os.environ['SITE_DIST'])) os.environ['SITE_ADMIN_PASSWORD_HASH']=hash_password('installed wheel password',n=2**10) os.environ['SITE_ADMIN_LOGIN']='admin' app=create_app() @@ -84,7 +97,7 @@ with TestClient(app) as client: 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'): + 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','theme-studio.css','theme-studio.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') @@ -99,8 +112,20 @@ with TestClient(app) as client: 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 'data-section-width' in result.text and '--container-max:' in result.text + assert 'theme-bootstrap' in client.get('/admin/theme').text + import json + document={'schema':1,'preset':'dark','preset_version':1,'overrides':{}} + result=client.post('/admin/theme/validate',data={'csrf':csrf,'payload':json.dumps({'document':document,'revision':17})},headers={'Origin':'http://testserver','HX-Request':'true'}) + assert result.status_code==200 and result.json()['revision']==17,result.text + result=client.post('/admin/theme/preview',data={'csrf':csrf,'payload':json.dumps({'document':document,'revision':17})},headers={'Origin':'http://testserver','HX-Request':'true'}) + assert result.status_code==200,result.text + with TestClient(create_preview_app()) as preview: + result=preview.get(result.json()['url']) + assert result.status_code==200 and 'sample-site' in result.text,result.text + assert '--color-primary: #a48bfa' in result.text assert app.state.api_calls>0 -print('installed wheel: static, templates, API, bridge, separate preview OK; design/ absent') +print('installed wheel: all theme presets, build, widths, static, templates, Theme Manager, API, bridge, separate preview OK; design/ absent') """ subprocess.run([sys.executable, "-c", program], cwd=work, env=env, check=True) diff --git a/specs/001-antirion-admin/openapi.json b/specs/001-antirion-admin/openapi.json index b3f19d6..ce683b2 100644 --- a/specs/001-antirion-admin/openapi.json +++ b/specs/001-antirion-admin/openapi.json @@ -77,9 +77,7 @@ "type": "string" }, "values": { - "additionalProperties": true, - "title": "Values", - "type": "object" + "$ref": "#/components/schemas/BlockValues" } }, "required": [ @@ -89,6 +87,83 @@ "title": "BlockAction", "type": "object" }, + "BlockLayoutDTO": { + "additionalProperties": false, + "properties": { + "content_width": { + "default": "inherit", + "enum": [ + "inherit", + "boxed", + "fluid", + "full" + ], + "title": "Content Width", + "type": "string" + }, + "section_width": { + "default": "inherit", + "enum": [ + "inherit", + "boxed", + "fluid", + "full" + ], + "title": "Section Width", + "type": "string" + } + }, + "title": "BlockLayoutDTO", + "type": "object" + }, + "BlockValues": { + "additionalProperties": false, + "properties": { + "anchor": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Anchor" + }, + "hidden": { + "title": "Hidden", + "type": "boolean" + }, + "layout": { + "$ref": "#/components/schemas/BlockLayoutDTO" + }, + "note": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Note" + }, + "props": { + "additionalProperties": true, + "title": "Props", + "type": "object" + }, + "requires": { + "items": { + "type": "string" + }, + "title": "Requires", + "type": "array" + } + }, + "title": "BlockValues", + "type": "object" + }, "Buffer": { "additionalProperties": false, "properties": { @@ -320,20 +395,28 @@ { "$ref": "#/components/schemas/Snapshot" }, + { + "$ref": "#/components/schemas/ThemeSnapshot" + }, { "type": "null" } - ] + ], + "title": "Committed" }, "current": { "anyOf": [ { "$ref": "#/components/schemas/Snapshot" }, + { + "$ref": "#/components/schemas/ThemeSnapshot" + }, { "type": "null" } - ] + ], + "title": "Current" }, "issues": { "items": { @@ -526,6 +609,37 @@ "title": "Move", "type": "object" }, + "OnboardingState": { + "additionalProperties": false, + "properties": { + "can_manage": { + "title": "Can Manage", + "type": "boolean" + }, + "needs_setup": { + "title": "Needs Setup", + "type": "boolean" + }, + "status": { + "enum": [ + "new", + "existing", + "in_progress", + "skipped", + "completed" + ], + "title": "Status", + "type": "string" + } + }, + "required": [ + "status", + "needs_setup", + "can_manage" + ], + "title": "OnboardingState", + "type": "object" + }, "PageRow": { "additionalProperties": false, "properties": { @@ -787,6 +901,207 @@ "title": "Snapshot", "type": "object" }, + "ThemePresets": { + "additionalProperties": false, + "properties": { + "allowed_fonts": { + "items": { + "items": { + "type": "string" + }, + "type": "array" + }, + "title": "Allowed Fonts", + "type": "array" + }, + "fonts": { + "additionalProperties": true, + "title": "Fonts", + "type": "object" + }, + "presets": { + "additionalProperties": true, + "title": "Presets", + "type": "object" + } + }, + "required": [ + "presets", + "fonts", + "allowed_fonts" + ], + "title": "ThemePresets", + "type": "object" + }, + "ThemePreviewRequest": { + "additionalProperties": false, + "properties": { + "device": { + "default": "desktop", + "enum": [ + "desktop", + "phone" + ], + "title": "Device", + "type": "string" + }, + "document": { + "additionalProperties": true, + "title": "Document", + "type": "object" + }, + "page_id": { + "default": "", + "maxLength": 200, + "title": "Page Id", + "type": "string" + }, + "revision": { + "default": 0, + "minimum": 0.0, + "title": "Revision", + "type": "integer" + }, + "target": { + "default": "sample", + "enum": [ + "sample", + "page" + ], + "title": "Target", + "type": "string" + }, + "viewport_width": { + "default": 1440, + "maximum": 3840.0, + "minimum": 320.0, + "title": "Viewport Width", + "type": "integer" + } + }, + "required": [ + "document" + ], + "title": "ThemePreviewRequest", + "type": "object" + }, + "ThemeSnapshot": { + "additionalProperties": false, + "properties": { + "contrast": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ], + "title": "Contrast" + }, + "css": { + "title": "Css", + "type": "string" + }, + "diagnostics": { + "items": { + "$ref": "#/components/schemas/IssueDTO" + }, + "title": "Diagnostics", + "type": "array" + }, + "document": { + "additionalProperties": true, + "title": "Document", + "type": "object" + }, + "effective_tokens": { + "anyOf": [ + { + "additionalProperties": true, + "type": "object" + }, + { + "type": "null" + } + ], + "title": "Effective Tokens" + }, + "etag": { + "title": "Etag", + "type": "string" + }, + "live_build_id": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ], + "title": "Live Build Id" + }, + "path": { + "title": "Path", + "type": "string" + }, + "revision": { + "default": 0, + "title": "Revision", + "type": "integer" + }, + "workspace_revision": { + "title": "Workspace Revision", + "type": "string" + }, + "yaml": { + "title": "Yaml", + "type": "string" + } + }, + "required": [ + "document", + "etag", + "effective_tokens", + "workspace_revision", + "live_build_id", + "path", + "yaml", + "css", + "contrast" + ], + "title": "ThemeSnapshot", + "type": "object" + }, + "ThemeUpdate": { + "additionalProperties": false, + "properties": { + "document": { + "additionalProperties": true, + "title": "Document", + "type": "object" + }, + "if_match": { + "maxLength": 80, + "minLength": 1, + "title": "If Match", + "type": "string" + }, + "revision": { + "default": 0, + "minimum": 0.0, + "title": "Revision", + "type": "integer" + } + }, + "required": [ + "document", + "if_match" + ], + "title": "ThemeUpdate", + "type": "object" + }, "Transform": { "additionalProperties": false, "properties": { @@ -5606,6 +5921,938 @@ ], "summary": "Site" } + }, + "/admin/api/v1/theme": { + "get": { + "operationId": "theme_get_admin_api_v1_theme_get", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ThemeSnapshot" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Get" + }, + "patch": { + "operationId": "theme_save_admin_api_v1_theme_patch", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ThemeUpdate" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ThemeSnapshot" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Save" + } + }, + "/admin/api/v1/theme/onboarding": { + "get": { + "operationId": "theme_onboarding_admin_api_v1_theme_onboarding_get", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OnboardingState" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Onboarding" + } + }, + "/admin/api/v1/theme/onboarding/restart": { + "post": { + "operationId": "theme_restart_admin_api_v1_theme_onboarding_restart_post", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OnboardingState" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Restart" + } + }, + "/admin/api/v1/theme/onboarding/skip": { + "post": { + "operationId": "theme_skip_admin_api_v1_theme_onboarding_skip_post", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/OnboardingState" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Skip" + } + }, + "/admin/api/v1/theme/presets": { + "get": { + "operationId": "theme_presets_admin_api_v1_theme_presets_get", + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ThemePresets" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Presets" + } + }, + "/admin/api/v1/theme/preview": { + "post": { + "operationId": "theme_preview_admin_api_v1_theme_preview_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ThemePreviewRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Preview" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Preview" + } + }, + "/admin/api/v1/theme/validate": { + "post": { + "operationId": "theme_validate_admin_api_v1_theme_validate_post", + "requestBody": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ThemePreviewRequest" + } + } + }, + "required": true + }, + "responses": { + "200": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ThemeSnapshot" + } + } + }, + "description": "Successful Response" + }, + "400": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Bad Request" + }, + "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" + }, + "405": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Method Not Allowed" + }, + "409": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Conflict" + }, + "413": { + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/ErrorEnvelope" + } + } + }, + "description": "Request Entity Too Large" + }, + "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": "Theme Validate" + } } } } diff --git a/specs/002-site-studio-theme/plan.md b/specs/002-site-studio-theme/plan.md new file mode 100644 index 0000000..b793fe2 --- /dev/null +++ b/specs/002-site-studio-theme/plan.md @@ -0,0 +1,82 @@ +# План 002 — Site Studio и Theme Manager + +Дата: 2026-11-13. Основание — [спецификация](spec.md), выполнение — [задачи](tasks.md), проверка текущего этапа — [verification.md](verification.md). + +Этапы 4 и 5 выполнены последовательно по отдельным поручениям пользователя. Этап 4 принят; приёмка Theme Manager — отдельный шаг. + +Этапы 2 и 3 взяты и выполнены вместе по прямому поручению пользователя. Их совместная приёмка — [verification-stages-2-3.md](verification-stages-2-3.md); переход к этапу 4 остаётся отдельным решением. + +## Архитектурные решения + +- Каталог обнаруживает манифесты рекурсивно; идентичность фрагмента и категория — разные свойства. Сохранены глобальные ID и запрет затенения builtin. +- Категория пути вычисляется в registry. API остаётся проекцией ядра; русские подписи и объединение прежних категорий относятся только к HTML-представлению. +- Файловый theme.yaml — единственный реализованный формат темы с этапа 2. Это выбранное пользователем решение, без инфраструктуры миграции; прежний inline runtime отклоняется диагностикой. +- Валидация/разрешение темы и ширины живут в ядре с dataclass. API использует Pydantic DTO, вызывает сервисы вне event loop и сохраняет существующие обработчики ошибок. Предпросмотр, CLI и build используют один resolver. +- Theme Manager переносится из исходников Antirion. Моки и localStorage заменяются API; новый интерфейс и независимые frontend-алгоритмы темы не создаются. +- Каждая стадия готовится отдельно для пользовательской приёмки. Запуск проекта с новым SITE_ROOT и коммиты examples в этот план не входят. + +## Этап 1 — Категории и каталог (реализован, ожидает приёмки) + +1. В загрузчике вычислить категорию из первого каталога для вложенного размещения, сохранив плоскую структуру и рекурсивный поиск. +2. Загрузить optional preview.yaml, проверить envelope/props, объединить поверх inline preview по ключам, оставить плоскую форму API. +3. Перенести 15 builtin по категориям, изменить только category в манифестах. Сверить ID и байты шаблонов/ресурсов. +4. Показать категории в существующем каталоге, добавить поиск по коду и подписи, объединить legacy labels, сохранить описание/allow/ID. Синхронизировать фильтр после HTML swap. +5. Проверить смешанный сайт и реальный путь login → HTML → внутренний API → transform/preview/save. Повреждённый preview должен быть виден в workspace/publish, отказ не меняет live. +6. Проверить wheel вне checkout, браузер desktop/mobile и регрессии; обновить AGENTS/README и отчёт. + +Выход: действующие сайты используют прежние ссылки на фрагменты; пользователь видит категории в добавлении блока. Ни тема, ни оформление публичных фрагментов на этой стадии не меняются. + +## Этап 2 — Ядро файловой темы и публикация (реализован, ожидает приёмки) + +1. Добавить dataclass-модель ThemeDocument/EffectiveTheme, валидатор и каталог immutable preset@version в runtime-пакете. Перенести значения и разрешённые шрифты из дизайн-JS, зафиксировать диапазоны из spec. +2. Site читает theme.file; registry разрешает документ и добавляет диагностику в общий Report. Отсутствующая настройка использует minimal@1 в памяти; явная плохая ссылка и legacy tokens дают ошибку. +3. Обновить конфигурации примеров/фикстур в исходниках под theme.yaml. Сохранять цвета существующих примеров через новые семантические/custom токены, не переписывая их страницы. +4. Подключить effective tokens к bundle и preview через общий renderer. Токены применяются после defaults; CSS-потребители builtin используют согласованную таблицу переменных. Не менять палитру админки. +5. Дополнить manifest релиза разрешённой темой и preset/version. Учитывать theme/preset/render resources при fingerprint; не перезаписывать исторический релиз другим результатом. Сохранять атомарный current и независимость rollback от workspace. +6. Проверить воспроизводимость, все preset/Custom, контраст-warning, недопустимый ввод, сохранность старого live при ошибке и правильную тему после rollback. Набор пресетов и данные темы должны попадать в wheel. + +Выход: CLI/build/preview читают один новый контракт и одинаково формируют оформление. API/UI управления темой добавляются на этапе 5. + +## Этап 3 — Ширина сайта и блока (реализован, ожидает приёмки) + +1. Добавить BlockLayout в модель, разрешённые ключи YAML, общий валидатор и resolver наследования. Явно проверить объекты и enum; числовой legacy container не включать. +2. Передать layout через снимки, существующие операции блока, API DTO, формы и parse/serialize. Метаданные не должны теряться при редактировании props, добавлении, дублировании и переносе блока. +3. Применять ширину к собственным корням и контейнерам фрагмента, исключая утечку правил в nested blocks. Сохранить sticky-header, anchors, slots и preview markers без нарушающих геометрию wrappers. +4. Перенести контролы ширины инспектора из обновлённого дизайна и связать с transform. Обновление preview асинхронное; сохранить выделение/scroll и локальный выбор секции. +5. Проверить global modes, пары внешней/внутренней ширины, responsive gutters и границы 699/700/1023/1024 px. Сверить Конструктор ↔ Эксперт, fixed/Display/slots и отсутствие overflow на 360 px. + +Выход: штатный renderer и конструктор понимают layout из нового примера. + +## Этап 4 — Общие компоненты и examples/site-studio + +1. Сопоставить seed и текущие полноценные схемы по ST-01/02. Сохранить ID и проверенные названия/описания, перенести HTML/CSS компонентов из источника. +2. Добавить builtin content/steps с title/items, исключив локальный дубликат ai-studio в том же обновлении исходников. Сохранить поддержку прежнего card_grid.variant: steps. +3. Добавить data/entry_card и универсальный ref `to: '*'`, value collection/slug: парсинг, валидация, resolver, выбор в формах, проверки published target. Фиксированные ref/refs не изменяются. +4. Дополнить entry_header и form необязательными полями из spec. Перенести общие стили, связывая литералы дизайна с effective tokens, сохраняя исходное оформление при значениях seed. +5. Создать новый examples/site-studio: данные/ассеты из seed, адаптированные Page/Entry/Collection/Display/Menu/Form/Redirect, layouts с engine hooks. Не копировать повторные builtin manifests или mini-renderer. +6. Описать запуск отдельно от рабочего сайта. Проверить 13 опубликованных страниц, отсутствие draft booking в live, ссылки/ассеты/редиректы, формы без ложного успеха, отключённые коллекции и совместимость прежних примеров. +7. Проверить публичные страницы и общие компоненты относительно design preview на desktop/mobile. Документировать различия из-за данных и штатных SEO/assets hooks; не заменять визуальную проверку HTTP 200. + +Выход: отдельный пример проходит стандартный validate/build, общие компоненты сохраняют функциональные возможности. + +## Этап 5 — ThemeService, Theme Manager и onboarding + +1. ThemeService предоставляет get/list_presets/resolve/validate/save; OnboardingService — status/skip/restart. Подключить JSON и HTML endpoints из API-01 без обходов внутреннего API. +2. API DTO: ThemeSnapshot, ThemeUpdate, ThemePreviewRequest, ThemeDiagnostics, OnboardingState. Snapshot содержит document/etag/effective_tokens/diagnostics/workspace_revision/live_build_id; ErrorEnvelope допускает текущий снимок темы при 409. If-match для создания — ABSENT. +3. Save проходит через ContentService с точным разрешённым путём, SiteLock, CAS, проверку, историю, atomic write и аудит. Изменения после Save не публикуются. Конфликт и 5xx сохраняют пользовательский ввод; неожиданные ошибки коррелируются через request_id. +4. Расширить существующий PreviewStore overlay темы без сохранения файлов сайта, сохранив CSP/origin/nonce/immutable snapshots. Стенд из дизайн-макета и фактическая страница используют один token resolver; ответы связаны с revision. +5. Перенести исходные HTML/CSS/JS Theme Manager в существующий Antirion shell. Подключить четыре шага, reset/skip/repeat, YAML/export, диагностику, desktop/mobile и ссылки настройки. Сохранять рабочее состояние вкладки до явного Save; не переносить auto-localStorage или beforeunload. +6. Состояние мастера хранить атомарно в SITE_STATE_DIR/theme-onboarding.json под блокировкой сайта; в нём нет canonical palette. Инициализацию различать по наличию настроенной темы/релиза, текущему admin разрешить как владельцу. Save завершает workflow, skip/restart независимы от live. +7. Выполнить серверные проверки ETag/CSRF/доступа, сбои диска/аудита/сети, два одновременных редактора, рестарт, существующий/новый сайт, skip/repeat, publish/rollback и отсутствие потери правок. + +Выход: экран из дизайна управляет настоящим файлом и превью, существующая публикация остаётся отдельным действием. + +## Общая проверка и передача этапов + +После каждого функционального этапа: целевые unit/integration checks → штатные validate/build → реальный FastAPI и browser → installed wheel для новых ресурсов → отчёт с ограничениями → пользовательская приёмка. + +Для нового Theme Manager обязательна сверка с оригиналом на 1440/1280/1024/768/390/360 px, клавиатура и фокус, отсутствие native dialogs, JS/CSP/HTTP-ошибок, горизонтального переполнения и изменения skin админки. Для общих компонентов повторить проверки старых примеров и функциональности больше трёх steps/items. + +Пользовательские изменения examples/studio-site/pages/index.md не исправляются ради тестов. При необходимости базовая фикстура извлекается из HEAD во временный каталог; отчёт явно отличает такую регрессию от проверки текущего пользовательского сайта. + +Изменения runtime требуют пересборки образа. Root examples не коммитятся, рабочий SITE_ROOT не переключается, live не публикуется автоматически. Завершение всей 002 отмечается только после выполнения и приёмки всех этапов. diff --git a/specs/002-site-studio-theme/runtime.md b/specs/002-site-studio-theme/runtime.md new file mode 100644 index 0000000..a858237 --- /dev/null +++ b/specs/002-site-studio-theme/runtime.md @@ -0,0 +1,143 @@ +# Runtime 002 — файловая тема и ширина блоков + +Реализованы этапы 1–3. Версия схемы сайта, страниц и темы — 1. Интерфейс Theme Manager, его endpoints и новый `examples/site-studio` относятся к этапам 4–5 и пока отсутствуют. + +## Загрузка и источник истины + +`site.yaml` содержит `theme: {file: theme.yaml}`; путь относительный, внутри корня сайта. Файл темы обязателен при явной ссылке. Неверные YAML/тип/путь, symlink наружу и inline-настройки дают диагностику с путём; ошибка блокирует build/preview. Если настройка темы вообще отсутствует, используется minimal@1 в памяти, файл не создаётся. + +```yaml +schema: 1 +preset: minimal +preset_version: 1 +overrides: + colors: + primary: '#4255b9' + ui: + container: + mode: boxed + max_width: 1080 + gutter: {desktop: 36, tablet: 24, mobile: 16} +``` + +`core/theme.py` предоставляет dataclass `ThemeDocument`, `EffectiveTheme`, `ContainerSettings`, `Gutters`, функции `preset_catalog`, `font_catalog`, `resolve_theme`, `load_theme`, `theme_css`. Ядро не требует Pydantic. Registry содержит вычисленную `theme`; `Site` содержит только ссылку `theme_file`. + +Пресеты minimal/dark/editorial/bold/natural/custom и каталог шрифтов скопированы из `design/assets/theme-studio.js` в `builtin/themes/v1/*.json`. Runtime не читает design и не хранит отдельную палитру в БД/JS. Каталог отдаёт независимые копии; определения опубликованной версии не изменяются. Будущие изменения пресета требуют отдельной версии и поддержки этой версии в resolver. + +Переопределения объединяются глубоко, поэтому изменение mobile gutter сохраняет desktop/tablet. `custom_colors` и явно заданный `gradients.definitions` заменяют соответствующую карту целиком: удалённые определения не возвращаются из defaults. Custom требует полный набор colors/type/ui, включая вложенный container/gutter. Дополнительные цвета и градиенты необязательны. + +## Валидация + +| Поле | Контракт | +|---|---| +| colors | background/surface/text/muted/primary/secondary/accent/border, HEX #RRGGBB | +| type | pair из каталога или custom, heading/body только разрешённые системные стеки | +| type.scale / line | числа 0.85–1.3 / 1.3–1.9 | +| type.headingWeight | целое 100–900 | +| ui.radius / spacing | числа 0–24 px / 0.8–1.4 | +| ui.shadow / button | none/soft/medium и solid/outline | +| ui.container | объект mode/max_width/gutter; старое число отклоняется | +| max_width / gutters | целое 720–1920 / целые 0–96 px | +| custom_colors | до 24 HEX; имена `[a-z][a-z0-9_]{1,31}`, без конфликтов с зарезервированными токенами | +| gradients | enabled: boolean, до 12 именованных linear definitions | +| definition | angle 0–360, 2–5 stops `{at: 0..100, color: HEX}`, позиции строго возрастают | + +Неизвестные ключи, null вместо объекта, boolean вместо числа, строки с CSS/URL/Jinja и нечисловые/бесконечные значения отклоняются. Ошибки используют коды `E_THEME_*`. Проверяются контрасты text/background, text/surface, muted/surface; `W_THEME_CONTRAST` не блокирует публикацию. Включённые градиенты добавляют предупреждение о проверке контраста по всей поверхности. + +## CSS и релиз + +Порядок общего бандла: base.css → стили использованных фрагментов → вычисленные переменные → containers.css. Встроенные компоненты используют семантические переменные; дополнительных CSS из пользовательских данных нет. + +| Токены | CSS | +|---|---| +| colors.name | `--color-name`; background также `--color-bg` | +| custom_colors.hero_ink | `--color-hero-ink`, адресное использование шаблоном | +| type | `--font-heading`, `--font-body`, `--type-scale`, `--type-line`, `--heading-weight` | +| ui | `--radius`, `--spacing`, `--shadow`, `--button-background`, `--button-text` | +| container/gutter | `--container`, `--container-max`, `--gutter-desktop/tablet/mobile`, responsive `--active-gutter` | +| gradients.definitions.name | `--gradient-name`; для hero/button/cta также `--hero-gradient`, `--button-gradient`, `--cta-gradient` | + +Градиенты применяются адресно: тёмный Hero, основная solid-кнопка и CTA используют соответствующие роли. При отключении возвращаются однотонные значения, outline-кнопка остаётся прозрачной. Публичные CSS находятся в релизе/iframe, на skin админки не влияют. + +Manifest содержит прежние source_hash/routes/fragments/page_sources и новые `render_hash`, `fingerprint`, `theme: {document, effective_tokens}`. ID строится из времени и общего fingerprint файлов сайта, кода ядра/сборки/парсинга, builtin-ресурсов, пресетов и загруженных фрагментов. При одинаковом ID существующий релиз переиспользуется только при побайтово одинаковом результате; несовпадение даёт `E_RELEASE_COLLISION` и сохраняет историю. Ошибка не переключает current. Rollback переключает готовый релиз и не меняет theme.yaml/контент workspace. + +## Layout блока и конструктор + +```yaml +- id: hero_home + fragment: hero + layout: + section_width: full + content_width: boxed + props: + title: Пример +``` + +Оба поля допускают inherit/boxed/fluid/full. Отсутствующий layout у hero/cta_banner/site_header/site_footer означает full/inherit; у остальных — inherit/inherit. Явный пустой объект или явно заданный inherit наследует глобальную ширину. Неизвестные ключи и режимы дают `E_BLOCK_LAYOUT`; молчаливого исправления нет. + +Boxed ограничивает секцию до `min(available - 2*gutter, max_width)`, fluid убирает max_width, full занимает всю доступную ширину без gutter. Внутренний boxed-контейнер имеет max_width и padding, fluid — только padding, full — без ограничения и padding. Внешняя секция ограничивает внутреннюю. Gutters переключаются на 700 и 1024 px; для слишком узкого вложенного контейнера padding ограничен его доступной шириной. + +Renderer ставит `data-engine-block`, `data-section-width`, `data-content-width` на существующие корни и `data-engine-container` на собственные `.f-container`/`.container`. Область вложенного блока исключается из обработки родителем. Для разделения фона и содержимого собственный шаблон должен иметь внешний корень и внутренний контейнер. Richtext/image/columns builtin получили собственные внутренние контейнеры; общий wrapper вокруг всех фрагментов не добавляется, sticky-header остаётся корнем. Preview markers добавляются отдельно; публикация их не содержит. + +Один парсер применяется к Page, Display, Entry regions, fixed и slots. Снимки передают layout без потери данных. Transform меняет сырой YAML; props edit, duplicate, move, toggle, Save и reopen сохраняют layout. На API-границе `BlockLayoutDTO` объявляет enum в OpenAPI, `BlockValues` ограничивает поля, явный null для anchor/note сохраняет значение очистки. `schema.container` отдаёт глобальные настройки. + +Контролы инспектора перенесены из `design/assets/builder.js:blockWidthControls`: те же названия, варианты, классы и пояснение. Обновление использует существующий HTML → внутренний JSON API → DocumentService; debounce и preview остаются асинхронными. Выбор секции локальный; изменение до Save не создаёт черновик на диске. Выделение и scroll preview сохраняются. + +## Проверка и запуск + +```bash +PYTHONPATH=src python -m unittest discover -s tests -p 'test_theme.py' -v +PYTHONPATH=src python -m unittest discover -s tests -p 'test_block_layout.py' -v +PYTHONPATH=src python scripts/qa_theme_002.py +PYTHONPATH=src python scripts/verify_package_001.py --site /path/to/isolated-site +``` + +Нужна пересборка образа/установка нового пакета. Рабочий SITE_ROOT не переключается автоматически; примеры обновлены только в исходниках. Root examples не коммитятся. Проверки и артефакты — в [отчёте](verification-stages-2-3.md). + +## Этап 4: публичный builtin и отдельный Site Studio + +Источник разметки/CSS — design/examples/site-studio/fragments и assets/site.css. Общие примитивы перенесены в builtin/base.css, правила компонентов — в их style.css. Служебные f-классы сохранены для существующих локальных шаблонов. Штатный сборщик добавляет тему и containers.css после этих правил. Готовый пакет не читает design/. + +Добавлены content/steps (прежний title/items из ai-studio, локальный дубликат удалён) и data/entry_card. `entry_header` дополнен summary/image/image_alt, `form` — title/description. Метки Hero, шапки, записи, заголовок richtext и описание collection_list задаются опциональными props; тексты нового примера не захардкожены в общие шаблоны. Списки произвольной длины, slots, columns/page_header и card_grid.variant:steps сохранены. + +`ref` с `to: '*'` использует collection/slug. Парсер/валидатор проверяют форму; Resolver различает E_REF_FORMAT, E_REF_COLLECTION, E_REF_MISSING, E_REF_UNPUBLISHED. Опубликованная карточка с недоступной целью блокирует build; preview показывает диагностику. Универсальные ссылки в данных коллекций проверяются и без использования в display, включая вложенные group/list/refs. Обычные ref/refs сохраняют slug и прежнюю семантику. Document schema предоставляет дополнительный choices.published_entries; generic datalist включает только эти записи, fixed datalist использует прежний choices.entries. Save/ETag/буфер не изменены. + +Collection теперь поддерживает необязательный `requires: [feature.<имя>]` (schema остаётся 1). Неизвестное требование — E_REQUIRES_UNKNOWN. При выключенной feature записи сохраняются в workspace, не публикуются, не попадают в query или generic choices и не требуют release-полноты. Маршрут такой записи недоступен для generic ref. Без requires поведение прежнее. В новом примере courses/posts связаны с features courses/blog. + +`examples/site-studio/` содержит адаптированные данные/ассеты/пять layouts с seo/assets hooks; штатный build создаёт 13 страниц и два редиректа. Сохранены 8 записей, 4 из которых draft. Намеренно отсутствующая обложка booking диагностируется в preview, не мешает live. Форма выполняет настоящий POST и показывает HTTP 501 без очистки ввода или перехода на thank-you. Нового FormService/доставки нет. + +Отдельный запуск — examples/site-studio/README.md; QA — scripts/qa_site_studio_002.py; результаты — [verification-stage-4.md](verification-stage-4.md). Рабочие SITE_ROOT/data не изменяются. + + +## Этап 5: Theme Manager, API и мастер первого входа + +Экран `/admin/theme` («Дизайн сайта») и `/admin/setup/theme` используют исходные HTML-композицию, CSS и контролы `design/theme-studio-antirion.html` / `design/assets/theme-studio.{css,js}`. Сохраняется принятый shell админки. Стили исходного экрана и его импортированные button/chip-примитивы ограничены `.theme-content`; публичные CSS остаются в iframe. Палитра темы сайта не меняет skin админки. Нативных browser dialogs и palette-localStorage нет. + +JSON API (внутренние credentials, существующая request-scoped авторизация UI): + +| Метод | `/admin/api/v1` | Результат | +|---|---|---| +| GET | `/theme` | ThemeSnapshot | +| GET | `/theme/presets` | 6 preset definitions, их документы/effective tokens, font catalog | +| PATCH | `/theme` | Save: `{document, if_match, revision}` → ThemeSnapshot | +| POST | `/theme/validate` | `{document, revision}` → ThemeSnapshot или 422 с diagnostics в error.issues | +| POST | `/theme/preview` | `{document, revision, target: sample\|page, page_id?, device: desktop\|phone, viewport_width?: 320..3840}` → immutable Preview | +| GET | `/theme/onboarding` | `{status, needs_setup, can_manage}` | +| POST | `/theme/onboarding/skip` | skipped | +| POST | `/theme/onboarding/restart` | in_progress | + +HTML-адаптер принимает обычные form POST с `csrf` и `payload` (JSON DTO): `/admin/theme/save|validate|preview`; workflow — `/admin/setup/theme/skip|restart`. Он возвращает JSON-проекцию результата внутреннего AdminApi, не обращаясь к сервису/файлам напрямую. Внешние credentials браузеру не выдаются. Вход в экран выполняется обычной навигацией; htmx-переход получает HX-Redirect для корректной загрузки исходных ресурсов. + +ThemeSnapshot: document, etag, effective_tokens, diagnostics, workspace_revision, live_build_id, revision; также path, yaml, css и contrast для UI. workspace_revision — хеш конфигурации сайта и ETag темы; это версия темы в workspace, не счётчик правок всех страниц. `revision` относится к состоянию текущей вкладки. Контракт экспортирован в `specs/001-antirion-admin/openapi.json` штатной командой export-openapi. + +Клиент получает пресеты/шрифты/effective tokens с backend. Он редактирует доступные поля, отправляет полный документ (полный overrides допустим и для обычных пресетов). Второго JS resolver/валидатора/CSS-генератора темы нет. После паузы ввода идут серверная проверка и preview; это не Save. Переключение шага сохраняет iframe и не записывает контент. Desktop/Mobile и выбор реальной страницы создают новый snapshot. Устаревшие ответы отбрасываются по sequence/revision/target/device; ошибочная revision ответа также отклоняется. Неверная тема оставляет последнее корректное превью с явным статусом. YAML/export формирует и проверяет сервер. + +Сохранение ограничено точным `site.yaml.theme.file`; разрешён отдельный относительный YAML внутри root без symlink alias/escape, не site.yaml. Если тема не настроена, используется minimal в памяти, target — theme.yaml. GET/preview не создают тему. Save получает `if_match: absent` при создании. ContentService.update_files под SiteLock перечитывает/проверяет версии и путь, валидирует весь документ, сохраняет историю и атомарно пишет файл. При первом Save также сохраняется ссылка в site.yaml с проверкой его версии. Все версии/валидация проверяются до записи; обычный отказ второго файла восстанавливает первый. Несколько rename не являются общей crash-atomic транзакцией: аварийное завершение процесса между ними может оставить несвязанный theme.yaml, который не применяется до появления ссылки. Настроенная тема сохраняется одним файлом. + +409 возвращает `error.current: ThemeSnapshot`. UI оставляет пользовательские значения и предлагает принять новую основу либо явно загрузить серверную тему. Принятие основы само не пишет файл; повторный Save снова проверяет ETag. 5xx/сеть/401/403 видимы с code/message/request_id. Сбой аудита или workflow после успешной записи возвращает 500 `theme_after_commit` с `error.committed`: UI учитывает новую версию и сообщает проблему. Неожиданные исключения логируются общей границей со стеком и request_id. + +PreviewStore хранит immutable HTML и необходимые ассеты вне canonical workspace. Стенд Hero/Buttons/Cards/Typography перенесён из исходника; его CSS использует core.theme.theme_css через алиасы переменных. Фактическая страница рендерится штатным Renderer с reg.theme overlay. Для стенда ассеты сайта не копируются. viewport_width передаёт только ширину окна редактора для responsive-правил оригинального стенда; числовые границы проверяются API, это не токен темы. Пассивный iframe не разрешает scripts; при настроенных разных origin действуют прежние signature/TTL/auth_epoch, CSP, nonce bridge, immutable assets. Скрипты сайта не исполняются. Текст/контролы админки не получают CSS публичной темы. + +OnboardingService атомарно хранит только `{schema: 1, status}` в SITE_STATE_DIR/theme-onboarding.json под SiteLock. Без state тема в конфигурации или live-релиз означают existing; без обоих — new и redirect с обзора на setup. Текущий single-admin имеет право управления. Skip → skipped, Repeat → in_progress и первый шаг, Save → completed. Skip/Repeat не меняют тему и live; workflow переживает рестарт. Сессия не создаёт персональный мастер для каждого редактора. Повтор доступен на экране дизайна из навигации настроек. + +Визуальная и функциональная приёмка — `scripts/qa_theme_manager_002.py`; серверные отказы/ETag/workflow/release — `tests/test_theme_manager.py`; отчёт — [verification-stage-5.md](verification-stage-5.md). Рабочий SITE_ROOT и live не переключались. diff --git a/specs/002-site-studio-theme/spec.md b/specs/002-site-studio-theme/spec.md new file mode 100644 index 0000000..8bd9d7a --- /dev/null +++ b/specs/002-site-studio-theme/spec.md @@ -0,0 +1,109 @@ +# 002 — Site Studio: категории фрагментов, тема и Theme Manager + +Дата: 2026-11-13. Статус: этапы 1–5 реализованы; пользователь принял этап 4 и разрешил этап 5. Theme Manager подготовлен к отдельной пользовательской приёмке; вся 002 ещё не закрыта. Связанные документы: [план](plan.md), [задачи](tasks.md), [проверка этапа 1](verification.md), [проверка этапов 2–3](verification-stages-2-3.md), [runtime](runtime.md), [проверка этапа 4](verification-stage-4.md), [проверка этапа 5](verification-stage-5.md). + +## 1. Цель и источники + +Перенести новый файловый пример `design/examples/site-studio/` на штатный движок, обновить общие фрагменты, добавить категории, файловую тему, ширину секций и полноценный Theme Manager. Сохранить схему версии **1** и существующую архитектуру: браузер/htmx → HTML UI → внутренний JSON FastAPI → сервисы → ядро/файлы. + +Источники оформления и поведения: + +- Theme Manager — `design/theme-studio-antirion.html`, `design/assets/theme-studio.css` и `theme-studio.js`. +- Настройки ширины в конструкторе — обновлённый `design/assets/builder.js` и соответствующий Antirion-макет. +- Публичный сайт — `design/examples/site-studio/`: шаблоны, стили, контент и подготовленные превью. +- Контекст — `design/docs/stage7/07_THEME_MANAGER.md`, `08_CONTAINER_LAYOUT.md`, `THEME_MANAGER_QA.md` и ADR-007. + +Разметка, CSS, композиция, контролы и сценарии Theme Manager переносятся из исходников. Замена mock-данных и хранилища на API не является поводом для самостоятельного редизайна. Браузерный прототип не заменяет сервисы, валидацию и публикацию. + +## 2. Исходное состояние + +Новый seed содержит 9 ручных страниц, 8 записей, 15 фрагментов, 5 layouts и 13 HTML-страниц автономного превью. Собственные проверки seed и контейнеров проходят. Штатные проверки workspace и release CMS до переноса обнаруживают суммарно 137 ошибок со встроенными фрагментами, включая 13 повторных ID; без builtin остаются 44 ошибки. Это исходная сверка, а не критерий совместимости после реализации. + +Загрузчик уже рекурсивно ищет `fragment.yaml`, но категория бралась только из YAML. Отдельный `preview.yaml`, `Block.layout` и внешний `theme.yaml` прежде не использовались. Темы работали через `site.yaml.theme.tokens`. Changeset, публичный приём заявок и расширенный RBAC не являются готовыми сервисами. + +## 3. Фрагменты и каталог + +**FR-01.** Одновременно поддерживаются плоское `fragments//fragment.yaml` и категоризированное `fragments///fragment.yaml` размещение, в том числе смешанное в одном сайте. Поиск рекурсивный; каталог без манифеста не становится фрагментом. Повреждённый найденный манифест даёт диагностику. + +**FR-02.** ID берётся из `fragment.yaml:id`, не из пути. Он глобально уникален, одинаково адресуется из Page, Display, Layout и slots. Категория не входит в ID. Дублирование builtin и локальных ID запрещено и возвращает `E_FRAGMENT_DUP`. + +**FR-03.** Если путь каталога фрагмента относительно `fragments/` содержит не менее двух компонентов, категория — первый компонент. Иначе применяется YAML `category` или `misc`. Каталог имеет приоритет над YAML; дополнительная вложенность не меняет категорию. Это правило одинаково для builtin и компонентов сайта. Дополнительные категории допустимы. + +**FR-04.** Встроенные фрагменты размещаются так: + +| Категория | Фрагменты этапа 1 | +|---|---| +| content | card_grid, columns, disclaimer, faq, richtext, section | +| data | collection_list, entry_header | +| forms | form | +| marketing | cta_banner, hero, page_header | +| media | image | +| system | site_header, site_footer | + +На этапе 1 меняется размещение и категория; шаблоны и ресурсы сохраняются. На этапе публичных компонентов добавляются общие `steps` и `entry_card`; `columns` и `page_header` остаются. + +**FR-05.** Соседний `preview.yaml` необязателен: `{name?: string, props: object}`. `props` переопределяют inline `fragment.yaml:preview` по верхним ключам; затем формы используют defaults полей. Значения `false`, `0` и явно заданные пустые значения не теряются. Имя preview не переименовывает фрагмент. API сохраняет плоский словарь `Fragment.preview`. Неверный YAML, форма envelope, неизвестные props и неверные типы дают диагностику с путём; ссылки в образце не разрешаются во время загрузки каталога. + +**FR-06.** Каталог сохраняет название и описание под ним, добавляет видимую категорию, поиск по ID/названию/описанию/категории и фильтры. Стандартные подписи: Контент, Данные, Формы, Маркетинг, Медиа, Системные; `misc` — Прочее. Неизвестные категории показываются по имени. API отдаёт исходную вычисленную категорию; только UI объединяет прежние русские подписи с новыми группами. «Компоновка» относится к content, «Первый экран»/«Конверсия» — к marketing, «Каркас» — к system. Остальные прежние подписи сопоставляются одноимённым категориям. + +**FR-07.** Ограничения allow региона/слота продолжают действовать независимо от фильтра. Фильтр и подсвеченная кнопка согласованы после обновления HTML. Добавление, выбор секции и preview не создают сохранённый черновик; запись страницы происходит только по Save. Формат новых ID остаётся `_<5 случайных символов>`. + +## 4. Принятое решение по теме + +**TH-01.** Для реализации 002 выбран файловый вариант ADR-007: `site.yaml.theme.file: theme.yaml`, отдельный документ `{schema: 1, preset, preset_version, overrides}`. Это решение пользователя уточняет Proposed ADR в исходниках дизайна; сами исходники дизайна не переписываются. Переход сразу на новый контракт: механизм миграции и совместимость с inline `theme.tokens` не создаются. Старый формат получает явную диагностику. Конфигурации примеров и фикстур обновляются в исходниках вместе с реализацией. + +**TH-02.** Отсутствие настройки темы у нового сайта означает безопасный preset minimal@1 без автоматической записи. Целевой файл по умолчанию — корневой `theme.yaml`; новые примеры задают ссылку явно. Явная ссылка на отсутствующий/некорректный файл диагностируется. Чтение и запись не выходят за root сайта. + +**TH-03.** Preset definitions minimal, dark, editorial, bold, natural, custom версии 1 переносятся из дизайна в пакет приложения. Опубликованные определения неизменяемы. Сервер вычисляет effective tokens через валидируемое глубокое объединение preset и overrides. Custom сохраняет полный набор overrides. Клиент получает каталог с сервера, отдельной канонической копии пресетов в JS/SQLite нет. + +**TH-04.** Типизированный контракт включает восемь `colors.*`, `type.pair/heading/body/scale/line/headingWeight`, `ui.radius/container/spacing/shadow/button`, `custom_colors` и `gradients`. Числовые ограничения и списки берутся из исходного дизайна: scale 0.85–1.3, line 1.3–1.9, radius 0–24 px, spacing 0.8–1.4; shadow none/soft/medium, button solid/outline. Heading weight — целое 100–900. Шрифты — системные стеки из разрешённого каталога дизайна; pair может быть custom при ручном выборе. Произвольные CSS, URL, Jinja и JS не принимаются. + +**TH-05.** Семантические цвета — HEX #RRGGBB. Дополнительных именованных цветов не более 24; имя `[a-z][a-z0-9_]{1,31}`, без конфликтов зарезервированных токенов. Градиенты выключены по умолчанию, не более 12 linear definitions, угол 0–360, 2–5 stop с HEX и строго возрастающими позициями 0–100. Применение именованных цветов и градиентов адресное; отключение градиентов возвращает однотонные fallback. + +**TH-06.** Неверный контракт блокирует сохранение/сборку. Недостаточный контраст — предупреждение в редакторе и публикации, а не блокировка релиза. Минимальные проверки: основной текст на background/surface и muted на surface; для градиентов диагностика не обещает полную проверку произвольного изображения или композиции. + +**TH-07.** Общий resolver ядра используется CLI, сервисами, API, preview и build. Ядро остаётся без обязательного Pydantic; API DTO не дублируют алгоритм разрешения. CSS темы не перекрывается более поздними значениями по умолчанию. Админка не наследует публичные токены. + +## 5. Ширина сайта и блоков + +**WD-01.** `overrides.ui.container` — объект: `mode: boxed|fluid|full`, `max_width` — целое 720–1920 px, `gutter.desktop/tablet/mobile` — целые 0–96 px. Breakpoints: desktop ≥1024, tablet 700–1023, mobile <700. Старый числовой container не является поддерживаемым production-форматом. + +**WD-02.** `Block.layout` содержит только `section_width` и `content_width`, значения `inherit|boxed|fluid|full`. Отсутствующий объект: hero, cta_banner, site_header, site_footer получают full/inherit; остальные — inherit/inherit. Явное inherit разрешается в глобальный mode. Ошибки не заменяются молча безопасными значениями. + +**WD-03.** Внешняя ширина управляет фоном секции, внутренняя — её содержимым. Boxed ограничен max_width и gutter, fluid сохраняет gutter без max_width, full заполняет доступную ширину без gutter. Внешняя секция ограничивает внутреннее содержимое. Вложенные блоки, сетки и sticky-header не ломаются от служебных wrappers или CSS предков. + +**WD-04.** Layout одинаково работает в Page, Display, fixed-блоках и вложенных slots. Инспектор использует контролы дизайна. Конструктор/Эксперт, изменение props, добавление, дублирование, сохранение и повторное открытие сохраняют layout. Не теряются выделение и scroll preview; выбор блока не требует сетевого запроса. + +## 6. Общие фрагменты и Site Studio + +**ST-01.** Оформление общего builtin переносится из seed с сохранением возможностей: типизированные actions/links/query, bindings, slots, неограниченные тремя элементами списки. Сопоставление: heading → title; card1…3/step1…3/FAQ → items; button/buttonUrl → actions; collection/sort/limit → source.query; Markdown body → `{bind: page.body}` / `{bind: entry.body}`. Нужные статические подписи из дизайна становятся данными, а не захардкоженными текстами всех сайтов. + +**ST-02.** `entry_header` получает необязательные summary, image и image_alt, сохраняя title/meta. `form` получает необязательные title/description, сохраняя ссылку form. `steps` использует существующий контракт title/items из ai-studio. `entry_card` использует title и обязательный entry типа ref с `to: '*'`, значение `collection/slug`. Фиксированные ref/refs сохраняют прежний контракт slug + to; универсальный ref проверяет collection, slug и доступность публикации. Встроенный каталог форм редактора даёт соответствующий выбор записей. + +**ST-03.** Рабочий результат размещается отдельно в `examples/site-studio/`. Данные и статусы из seed сохраняются, схемы адаптируются к CMS: полные fields/of/options/to, SEO bindings, ID страниц в меню, существующий формат redirects, поля формы с key. Выключенные courses/posts описываются согласованно с features/requires. Намеренно неполный draft booking не входит в релиз и не мешает публикации остальных материалов. + +**ST-04.** Layout использует seo_head(), assets_head(), assets_body() и region(). Не создаётся второй renderer или новая template API из mini-renderer. Повторные определения builtin из seed не копируются. При добавлении общего steps локальный дубликат ai-studio заменяется использованием builtin в том же изменении исходников; его контент и ID блоков сохраняются. + +**ST-05.** Формы переносятся как схема и оформление. Приём/хранение заявок, Telegram, outbox и новая модель ролей не входят в 002. Существующий HTTP 501 показывается честно, ложного успеха нет. Новый пример должен проходить штатные validate/build, воспроизводить 13 страниц seed и не выводить черновики в live. + +## 7. Theme Manager, API и сохранение + +**UI-01.** Переносится исходный Antirion Theme Manager: четыре шага, шесть карточек, палитра/дополнительные цвета/градиенты, типографика, токены и ширина, Desktop/Mobile, YAML/export, reset/skip/repeat, собственные dialogs и toast. Исходные HTML/CSS/JS остаются эталоном. Нативные alert/confirm/prompt/beforeunload из переносимого runtime исключены; frontend-сборка не добавляется. + +**API-01.** JSON API под `/admin/api/v1`: GET `/theme`, GET `/theme/presets`, PATCH `/theme`, POST `/theme/preview`, POST `/theme/validate`, GET `/theme/onboarding`, POST `/theme/onboarding/skip`, POST `/theme/onboarding/restart`. HTML: GET `/admin/theme`, GET `/admin/setup/theme`, POST `/admin/theme/save|preview|validate`, POST `/admin/setup/theme/skip|restart`. HTML runtime использует серверный API-клиент; прямого обхода сервисов нет. + +**API-02.** Snapshot темы содержит document, etag, effective_tokens, diagnostics, workspace_revision и live_build_id. PATCH передаёт полный document, if_match и revision; для отсутствующего файла используется существующий ABSENT. Preview передаёт документ и revision без записи; запоздалый ответ не заменяет новое состояние. Не добавляется скрытый auto-draft или canonical localStorage. + +**API-03.** Save использует ThemeService и ContentService с ограничением на целевой файл: SiteLock → reread/CAS → полная проверка → история → atomic_write → аудит. Конфликт 409 возвращает текущий ThemeSnapshot и сохраняет пользовательский ввод. Ошибки используют общий `{error:{code,message,request_id,…}}`, диагностические пути и логирование неожиданных исключений со стеком. UI показывает ошибку и не теряет введённую тему при 5xx/сети. + +**UI-02.** Preview использует серверный resolver и существующее изолированное preview-хранилище/origin. Стенд Hero/Buttons/Cards/Typography сохраняет композицию исходника; его токены формирует backend. Preview страницы строится тем же штатным renderer с overlay темы. Скрипты сайта в preview не исполняются; служебные токены не попадают в браузерный API-клиент. + +**UI-03.** В текущем single-admin режиме admin выполняет роль владельца. Состояние мастера хранится в `SITE_STATE_DIR/theme-onboarding.json`, отдельно от палитры. Новый сайт без настроенной темы и релиза получает setup при первом входе; существующий сайт с темой/релизом не получает принудительный redirect. Skip сохраняется между сессиями, успешный Save завершает настройку, Repeat открывает первый шаг без перезаписи рабочей темы. Перезапуск сервера не сбрасывает workflow. + +## 8. Публикация, границы и приёмка + +**RL-01.** Save изменяет только workspace. Build использует зафиксированную разрешённую тему, включает CSS и сведения preset/version/tokens в артефакт. Отпечаток сборки учитывает тему, preset definitions и используемые ресурсы рендера; одинаковый старый build_id не используется для перезаписи исторического релиза с другим оформлением. Rollback возвращает готовый релиз, не перезаписывая рабочую тему. + +**AC-01.** Приёмка идёт по этапам плана; следующий функциональный этап начинается после пользовательской приёмки предыдущего. Готовая документация не означает готовую функциональность. Рабочий SITE_ROOT не переключается автоматически; root `examples/` не включается в коммиты. Исходники дизайна и пользовательские данные не перезаписываются. + +**AC-02.** Проверки включают ядро, API/сервисы, установленный wheel, реальные FastAPI/preview процессы, сравнение с источниками в браузере и текущие регрессии. Theme Manager проверяется на 1440, 1280, 1024, 768, 390, 360 px: все действия, desktop/mobile, клавиатура/фокус, диалоги, отсутствие переполнения, JS/CSP-ошибок, потерянных правок и нативных диалогов. Снимки и ограничения среды прикладываются к отчёту каждого этапа. diff --git a/specs/002-site-studio-theme/tasks.md b/specs/002-site-studio-theme/tasks.md new file mode 100644 index 0000000..ee84817 --- /dev/null +++ b/specs/002-site-studio-theme/tasks.md @@ -0,0 +1,82 @@ +# Задачи 002 — Site Studio и Theme Manager + +Дата: 2026-11-13. Основание: [spec.md](spec.md), порядок и зависимости: [plan.md](plan.md), фактическая проверка этапа 1: [verification.md](verification.md). + +Отметка `[x]` означает выполненную работу. Пользовательская приёмка отмечается отдельной задачей; готовая спецификация не закрывает последующие этапы разработки. Следующий функциональный этап начинается после приёмки предыдущего, кроме явно разрешённого пользователем объединения этапов. Этапы 2–3 выполнены вместе по его поручению; ручная приёмка на сервере не подменяется разрешением продолжить. + +## Документация + +- [x] T001 Зафиксировать полный согласованный объём, источники дизайна и правила поэтапной приёмки. +- [x] T002 Зафиксировать решение theme.yaml/new-only без миграции, schema 1, отдельный Site Studio и формы только как схема/оформление. +- [x] T003 Описать архитектуру, API, состояния мастера, совместимость и проверки. + +## Этап 1 — Категории и каталог + +- [x] T010 Сохранить рекурсивное обнаружение по fragment.yaml и глобальные ID. +- [x] T011 Вычислять категорию по пути, сохранив flat/YAML/misc и смешанные каталоги. +- [x] T012 Добавить preview.yaml:props, приоритет по ключам, диагностику envelope/props/YAML, не менять имя фрагмента и форму API preview. +- [x] T013 Разложить 15 builtin по шести категориям, сохранить columns/page_header, сверить шаблоны и ресурсы с HEAD. +- [x] T014 Показать категории в каталоге, сохранить названия/описания/ID и ограничения allow. +- [x] T015 Добавить поиск по категории, объединить прежние русские подписи в UI, синхронизировать активный фильтр после HTML swap. +- [x] T016 Проверить плоский/вложенный/смешанный сайт, произвольные категории и глубину, несовпадение имени папки и ID, дубликаты и повреждённые файлы. +- [x] T017 Проверить API/HTML, sidecar false/0/defaults, add/preview без записи, save/reopen, ограничения slots/regions и экранирование. +- [x] T018 Проверить видимость повреждённого preview в JSON/publish/HTML и сохранность live при отказе. +- [x] T019 Проверить wheel с вложенными ресурсами и настоящий FastAPI/preview вне checkout. +- [x] T020 Проверить браузером desktop/mobile, фильтры/поиск/фокус, CSS в релизе, отсутствие JS/native-dialog/credential утечек; приложить скриншоты. +- [x] T021 Обновить AGENTS/README и отчёт о проверках; не менять дизайн и рабочие данные. +- [ ] T022 Пользовательская приёмка этапа 1 на новой сборке. + +## Этап 2 — Файловая тема и релиз (реализован по поручению пользователя) + +- [x] T030 Добавить ThemeDocument/EffectiveTheme, загрузку theme.file и диагностику старого inline-формата. +- [x] T031 Перенести шесть immutable preset@1 и разрешённые шрифты из дизайна в runtime-пакет. +- [x] T032 Реализовать единые validation/deep merge/Custom/CSS mapping с ограничениями токенов, цветов и градиентов. +- [x] T033 Реализовать безопасный default для нового сайта и ошибки явной плохой ссылки; не писать файл автоматически. +- [x] T034 Обновить конфигурации примеров и фикстур под новый формат в исходниках, сохранив контент. +- [x] T035 Подключить тему к bundle и всем preview, исключить перекрытие токенов defaults и влияние на админку. +- [x] T036 Зафиксировать тему/preset/version в релизе, расширить fingerprint ресурсами рендера, сохранить исторические релизы и rollback. +- [x] T037 Проверить все пресеты, Custom, воспроизводимость, контраст-warning, invalid input, installed wheel и отказ сборки без переключения current. +- [x] T038 Обновить runtime, документацию и отчёт о проверке этапа 2. +- [ ] T039 Пользовательская приёмка этапа 2 на новой сборке. + +## Этап 3 — Ширина сайта и секций (реализован вместе с этапом 2) + +- [x] T040 Добавить ContainerSettings и BlockLayout, строгие типы/enum/диапазоны/defaults и наследование. +- [x] T041 Провести layout через Page/Display/fixed/slots, снимки, API, формы и операции дерева. +- [x] T042 Перенести контролы инспектора из дизайна; сохранить Конструктор ↔ Эксперт, props edits, дублирование и YAML round-trip. +- [x] T043 Подключить рендер ширины без поломки вложенных блоков, sticky-header, anchors, preview markers и scroll. +- [x] T044 Проверить все режимы и пары ширины, gutters/breakpoints, mobile 360 px, отсутствие overflow и локальный выбор секции. +- [x] T045 Обновить runtime, OpenAPI и отчёт о проверке этапа 3. +- [ ] T046 Пользовательская приёмка этапа 3 на новой сборке. + +## Этап 4 — Общие фрагменты и Site Studio (реализован по отдельному поручению пользователя) + +- [x] T050 Перенести разметку/CSS публичных фрагментов из seed, сохранив ID, поля, описания, типизированные источники и slots. +- [x] T051 Добавить общий steps title/items, убрать локальный дубликат ai-studio и сохранить старый card_grid.variant:steps. +- [x] T052 Реализовать entry_card и generic ref to:'*' collection/slug в парсере, resolver, валидаторе и формах, не меняя фиксированные ref/refs. +- [x] T053 Дополнить entry_header и form необязательными полями из спецификации и подключить semantic tokens. +- [x] T054 Создать отдельный examples/site-studio с исходными данными/ассетами и адаптированными схемами, SEO, меню, формами и редиректами. +- [x] T055 Использовать штатные layout hooks, renderer/build; не копировать дубли builtin или mini-renderer. +- [x] T056 Проверить 13 страниц, статусы/битый draft, выключенные коллекции, ссылки/ассеты/redirects, схему форм и честный отказ отправки. +- [x] T057 Сравнить публичный сайт с design preview на desktop/mobile, проверить прежние примеры и списки более трёх элементов. +- [x] T058 Документировать отдельный запуск без переключения SITE_ROOT; обновить отчёт. +- [x] T059 Пользователь принял результат этапа 4 и разрешил этап 5: «Ну вот! Хоть какой то действительно хороший вариант получился. Давай теперь 5 этап.» + +## Этап 5 — Theme Manager и onboarding (реализован; ожидает пользовательской приёмки) + +- [x] T060 Реализовать ThemeService и OnboardingService, JSON endpoints/DTO и HTML-адаптер через текущий серверный API-клиент. +- [x] T061 Обеспечить Save через ContentService: точный путь, SiteLock/CAS/валидация/история/atomic write/аудит; создание с ABSENT. +- [x] T062 Реализовать ThemeSnapshot и ошибки 409 с текущим снимком, request_id, сохранением пользовательского ввода при 5xx/сети. +- [x] T063 Добавить overlay темы в изолированный PreviewStore, связать ответы с revision, сохранить CSP/origin/nonce и запрет JS сайта. +- [x] T064 Перенести Theme Manager из исходных HTML/CSS/JS Antirion: все четыре шага, пресеты, цвета/градиенты, шрифты/токены/ширину, desktop/mobile, YAML/export и диалоги. +- [x] T065 Заменить mock/localStorage API, исключить native alert/confirm/prompt/beforeunload, не создавать самостоятельный дизайн или frontend-сборку. +- [x] T066 Добавить серверный onboarding state, распознавание нового/существующего сайта, skip/restart/Save-complete и доступ текущего admin как владельца. +- [x] T067 Проверить два редактора/ETag/CSRF, рестарт/skip/repeat, сбои записи/аудита/сети, workspace/live/publish/rollback и отсутствие потери правок. +- [x] T068 Сверить UI с оригиналом на 1440/1280/1024/768/390/360 px, проверить клавиатуру/фокус, отсутствие переполнения, JS/CSP/HTTP-ошибок и влияния на skin админки. +- [x] T069a Проверить установленный пакет, полную регрессию, обновить OpenAPI/runtime/отчёт этапа 5. +- [ ] T069 Пользовательская приёмка Theme Manager на новой сборке. Проверки разработчика не заменяют её. + +## Завершение + +- [ ] T070 Сверить все FR/TH/WD/ST/UI/API/RL/AC требования с проверками и отметить ограничения без ложных заявлений. +- [ ] T071 Обновить документацию фактического runtime и статус 002 после всех приёмок. Не коммитить root examples и не публиковать/переключать рабочий сайт без отдельной задачи. diff --git a/specs/002-site-studio-theme/verification-stage-4.md b/specs/002-site-studio-theme/verification-stage-4.md new file mode 100644 index 0000000..81ed23c --- /dev/null +++ b/specs/002-site-studio-theme/verification-stage-4.md @@ -0,0 +1,78 @@ +# Проверка этапа 4 — публичные фрагменты и Site Studio + +Дата: 2026-11-13. Этап выполнен по отдельному поручению пользователя после этапов 2–3. Реализация готова к пользовательской приёмке; Theme Manager остаётся этапом 5. + +## Результат + +Отдельный `examples/site-studio/` перенесён из `design/examples/site-studio/` на штатные registry/validation/Jinja/build. Сохранены 9 ручных страниц, 8 записей, их статусы, тексты и изображения, пять layouts и два редиректа. Сборка создаёт **13 опубликованных страниц**. Локальных копий builtin, preview-dist и mini-renderer в новом примере нет. Независимый запуск описан в его README; рабочий SITE_ROOT не переключался. + +HTML и CSS общего builtin взяты из исходных фрагментов и assets/site.css. Общие примитивы находятся в builtin/base.css, компонентные правила — в style.css соответствующего фрагмента. Сохранены f-классы для совместимости локальных шаблонов и штатный механизм layout-маркеров без дополнительной обёртки вокруг sticky-header. Типографика, кнопки, цвета, карточки, границы и контейнеры используют токены. Отдельный короткий assets/site.css примера сохраняет вес крупных заголовков 750 из исходного дизайна; обычные заголовки используют вес темы. Shadow примера задан none, поскольку исходные карточки не имеют теней; общий builtin поддерживает изменение этого токена. + +Каталог содержит **17 встроенных фрагментов**. `content/steps` использует прежний title/items; локальная копия ai-studio удалена, данные и ID блоков не изменены. `data/entry_card` имеет обязательный generic ref `entry`, `to: '*'`, значение collection/slug. Фиксированные ref/refs сохраняют slug + to и прежнюю семантику. Generic picker получает только опубликованные записи включённых коллекций с публичными страницами; taxonomy без страницы исключается. Ссылки проверяются также во вложенных group/list/refs данных коллекции, даже если display их не использует. Resolver создаётся для workspace, а не заново для каждой записи. + +`entry_header` дополнен summary/image/image_alt; `form` — title/description. Неограниченные списки, typed actions/query/bindings, slots, columns/page_header и прежний card_grid.variant:steps работают. Дополнительные подписи Hero/Entry, описания списков и знак бренда заданы данными примера. + +Collection поддерживает `requires: [feature.<имя>]`, схема остаётся **1**. Выключенные courses/posts согласованы с features courses/blog; записи выключенной коллекции не попадают в query, релиз и generic picker. Некорректные/неизвестные requirements диагностируются. Структурная проверка workspace сохраняется; release-полнота отключённой коллекции не требуется. + +## Проверки + +| Проверка | Результат | +|---|---| +| Полная unittest-регрессия | **338 тестов, 0 ошибок, 0 падений, 0 пропусков** | +| Новые целевые тесты | 18: generic ref/refs, parser, published-target/feature checks, fixed compatibility, picker, taxonomy, сохранность current при отказе, вложенные ссылки, новый пример и списки длиннее трёх | +| Site Studio validate/build | 0 ошибок; **13 страниц**, два редиректа, все локальные ссылки и ассеты доступны | +| Предупреждение нового примера | Одно ожидаемое W_THEME_GRADIENT_CONTRAST; визуальная оценка градиентов остаётся необходимой | +| AI Studio | validate без ошибок/предупреждений; **14 страниц**, 18 сценариев QA, 70 проверок адаптивности | +| Тема/ширины после переноса CSS | Все 8 групп прежней browser QA: 6 пресетов, типографика/кнопки/градиенты, 243 геометрические комбинации, gutters, nested/sticky, конструктор/буфер/Save | +| Установленный wheel | Сборка, все пресеты, HTML/API, локальная статика и отдельный preview origin вне checkout, без design/ | +| Статические проверки | Ruff по изменённому Python и git diff --check прошли | + +Полная регрессия использует **HEAD-версию** examples/studio-site во временном каталоге с актуальными site.yaml/theme.yaml. Пользовательский examples/studio-site/pages/index.md не менялся ради тестов. Это проверка базовой фикстуры, не заявление о проверке текущей пользовательской композиции. Независимый новый пример и ai-studio проверены в актуальном состоянии. + +## Браузерная сверка с исходником + +`scripts/qa_site_studio_002.py` запускает настоящий FastAPI для изолированной копии нового примера и отдельный сервер исходного preview-dist. Chromium сравнивает 6 страниц (`/`, `/about/`, `/services/`, `/services/bots/`, `/request/`, `/privacy/`) на **1440/1280/1024/768/390/360 px**, всего **36 сравнений**. Для секций проверяются горизонтальная геометрия и фон; для страниц без расширенной формы также высоты и вертикальные координаты с допуском менее 1 px. Скриншоты desktop/mobile дополнительно просмотрены визуально. + +Проверены отсутствие горизонтального переполнения, открытие FAQ с клавиатуры, отсутствие JS-ошибок, native dialogs и неожиданных HTTP-ошибок. Админка открывает новый пример; добавление entry_card предлагает ровно четыре опубликованные цели, сохраняет изменение в буфере до Save и восстанавливает его после Save/reopen. + +Форма отличается от статического seed поведением и необходимым consent: используются настоящие action/method, версия схемы, honeypot и поле согласия со ссылкой на политику. Реальный POST возвращает **HTTP 501**, сообщение отображается рядом с формой; ввод сохраняется, перехода на thank-you нет. Backend приёма/доставки заявок не добавлялся. Статусы active/draft схем форм сохранены. Намеренно отсутствующая обложка draft booking видна как E_ASSET_MISSING в preview; черновик не блокирует релиз. + +Артефакты в `/tmp/site-engine-studio-002/`: browser.json, unittest.log, package.log, public/source-{home,about,services,services-bots,request,privacy}-{1440,390}.png, constructor-1440.png; результаты прежних проверок — ai-studio/ и theme-regression/. Финальная сборка — dist/current/. + +## Повторный запуск + +```bash +PYTHONPATH=src python -m site_engine.cli validate examples/site-studio +PYTHONPATH=src python -m site_engine.cli build examples/site-studio --out /tmp/site-studio-dist +PYTHONPATH=src:tests python -m unittest test_site_studio -v +PYTHONPATH=src python scripts/qa_site_studio_002.py +PYTHONPATH=src python scripts/qa_ai_studio.py +PYTHONPATH=src python scripts/qa_theme_002.py +PYTHONPATH=src python scripts/verify_package_001.py --site examples/site-studio +``` + +Для полной регрессии с сохранением пользовательского контента: + +```python +import sys +import tempfile +import unittest +from pathlib import Path + +sys.path[:0] = ['tests', 'scripts'] +import helpers +from qa_fragments_002 import baseline + +with tempfile.TemporaryDirectory() as tmp: + helpers.EXAMPLE = baseline(Path(tmp)) + suite = unittest.defaultTestLoader.discover('tests') + result = unittest.TextTestRunner(verbosity=2).run(suite) + if not result.wasSuccessful(): + raise SystemExit(1) +``` + +Запускать с PYTHONPATH=src после установки server/dev. В этом окружении shell запускался с эскалацией из-за недоступности bwrap namespace; проверки выполнялись локально, внешние сервисы не использовались. + +## Передача на приёмку + +Runtime-изменения требуют пересборки Docker-образа. Рабочие data/env, пользовательский design и страница studio-site не изменялись, live не публиковался. Коммитов этой работой нет; root examples остаются вне коммита. Пользовательская проверка на новой сборке — отдельная T059. После неё можно брать Theme Manager из исходных HTML/CSS/JS в этап 5. diff --git a/specs/002-site-studio-theme/verification-stage-5.md b/specs/002-site-studio-theme/verification-stage-5.md new file mode 100644 index 0000000..eebe4b1 --- /dev/null +++ b/specs/002-site-studio-theme/verification-stage-5.md @@ -0,0 +1,79 @@ +# Проверка этапа 5 — Theme Manager и onboarding + +Дата: 2026-11-13. Этап реализован по разрешению пользователя после приёмки этапа 4. Подготовлен к отдельной пользовательской проверке; T069 и закрытие всей 002 остаются открытыми. + +## Результат + +`/admin/theme` / «Дизайн сайта» и `/admin/setup/theme` предоставляют четыре шага исходного Antirion Theme Manager. Перенесены композиция/HTML/CSS/контролы из `design/theme-studio-antirion.html` и `design/assets/theme-studio.{css,js}`: шесть пресетов в исходном порядке, палитра, дополнительные цвета, роли/точки градиентов, пары и выбор шрифтов, scale/line/headingWeight, radius/spacing/shadow/button, контейнеры/gutters, desktop/mobile, YAML/export, reset/skip/repeat и собственные подтверждения. + +Сохраняется принятый shell админки. CSS исходного экрана и необходимые button/chip-примитивы ограничены `.theme-content`. Стенд Hero/Buttons/Cards/Typography перенесён в серверный шаблон; рядом доступна реальная страница сайта. Оба используют core resolver/theme_css и immutable PreviewStore. Ширина внешнего окна передаётся как проверяемая viewport-метаинформация, чтобы исходные responsive-правила стенда не переключались из-за узкого изолированного iframe. Высота окна не пересоздаёт snapshot. + +Backend: ThemeService, OnboardingService, восемь JSON endpoints, DTO и form/CSRF HTML adapter через AdminApi. Тема сохраняется через ContentService с точным путём, SiteLock/CAS, валидацией, историей, atomic write и аудитом. При первом Save добавляется ссылка из site.yaml. Ошибка после записи возвращает committed snapshot; 409 — current snapshot. Правки/preview не сохраняют файл; Save не публикует. Workflow хранится отдельно от палитры и переживает рестарт. Новому сайту предлагается setup, существующему — обычный обзор. + +## Серверные проверки + +Полная регрессия: **359 unittest-тестов**, успешно, без ошибок/пропусков. В этом этапе добавлен **21 тест** в `tests/test_theme_manager.py`: + +- Snapshot, каталог и все шесть пресетов совпадают с core resolver; YAML формирует backend. +- Validate, стенд и реальная страница не пишут canonical theme и workflow. +- Два редактора, CAS/409/current, история и аудит; новый файл только с ABSENT. +- Отдельный настроенный путь, его повторная проверка под блокировкой, запрет соседнего пути, site.yaml и symlink escape. +- Ошибки типов/цветов/контейнеров, NaN, контраст как warning с допустимым Save. +- Реальные ошибки записи и журнала: traceback/request_id, сохранность файла; committed snapshot при отказе аудита/workflow после записи. +- Обычный отказ записи site.yaml восстанавливает первый файл при первоначальном сохранении. +- Новый/существующий сайт, сайт с релизом без настройки, skip/restart/завершение и повторная инициализация сервиса/приложения. +- Авторизация, отзыв сессии, CSRF/origin, отказ внутреннего API без прямого fallback к сервису. +- Подпись/TTL/auth_epoch immutable preview и неизменность старого снимка после Save. +- Save → publish → rollback: опубликованная версия и рабочая тема независимы. +- Responsive-метаданные стенда и строгие границы viewport_width. + +Регрессия исходного `studio-site` запускалась на извлечённой из HEAD временной базовой фикстуре с текущим контрактом темы. Пользовательский `examples/studio-site/pages/index.md` не переписывался ради тестов. Новый Site Studio проверялся на отдельной временной копии. + +## Браузер и исходный дизайн + +`scripts/qa_theme_manager_002.py`: настоящий FastAPI, Chromium, отдельный static server оригинала, временная копия Site Studio. **9 групп приёмки**, **96 сравнений компонентов**: 4 шага × 6 ширин (1440/1280/1024/768/390/360) × 4 элемента. Сравниваются font-size, padding, border-radius заголовков, шагов, карточек/подзаголовков. Дополнительно сверяются responsive padding Hero и видимость его навигации с исходным стендом. Приложены парные полные снимки всех 24 состояний. + +Проверены: + +1. Все шаги и Desktop/Mobile на шести ширинах без горизонтального переполнения. +2. Все шесть пресетов, подтверждение замены, отсутствие автосохранения. +3. Запоздавший ответ preview не заменяет новое состояние; выбор шага сохраняет тот же DOM iframe. +4. Палитра/именованные цвета/градиенты/точки, шрифты, fluid/outline/нулевой gutter, overlay реальной страницы; клавиатура, замыкание фокуса, Escape. +5. Серверный YAML/export текущих несохранённых значений. +6. Невалидный ввод/восстановление; две реальные вкладки, конфликт, сохранность ввода, явное принятие основы и повторный Save без публикации. +7. HTTP 500 с request_id и обрыв транспорта: видимая ошибка, ввод и сохранённый файл не теряются. +8. Отмена перехода, повтор/пропуск мастера без перезаписи рабочей темы, сохранение workflow. +9. Пассивный и отдельный origin preview с nonce bridge; сохранённый skin админки; отсутствие palette-localStorage. + +Итог: **0 JS/CSP-ошибок, 0 native dialogs, 0 неожиданных HTTP-ошибок**. Преднамеренные 422/409/500 учитываются отдельно. Это сверка перенесённых компонентов и поведения, а не заявление о попиксельном равенстве двух целых экранов: runtime использует существующий shell, настоящие данные/статусы, серверную диагностику и изолированный iframe. Типографика и отключённые градиенты стенда подчиняются общему контракту темы, включая headingWeight и однотонный fallback; жёстко заданные обходы прототипа не создают второй resolver. + +Артефакты: `/tmp/site-engine-manager-002/`: + +- `browser.json`, `browser.log`, `unittest.log`, `package.log`; +- `manager-{width}-step{1..4}.png` и `source-{width}-step{1..4}.png`; +- `preset-{minimal,dark,editorial,bold,natural,custom}.png`; +- `manager-{width}-preview.png` — видимое превью в viewport (Chromium может не рисовать находящийся вне экрана пассивный iframe в full-page снимке); +- `real-page-overlay.png`, `conflict-keeps-input.png`, `separate-origin.png`. + +Desktop и mobile снимки просмотрены визуально; проверен загруженный стенд внутри iframe. + +## Установленный пакет и контракт + +`scripts/verify_package_001.py --site examples/site-studio`: wheel собран и установлен вне checkout, каталога design/ нет. Проверены все пресеты, штатная сборка, прежний конструктор/API/bridge, CSS/JS Theme Manager, серверный шаблон стенда, validate и отдельный preview origin. Runtime не читает исходники дизайна. Штатный CLI validate examples/site-studio: 0 ошибок, одно ожидаемое W_THEME_GRADIENT_CONTRAST. Ruff для изменённых Python и `git diff --check` проходят. OpenAPI обновлён штатным export-openapi. + +Воспроизведение: + +```bash +PYTHONPATH=src python -m unittest discover -s tests -p test_theme_manager.py -v +PYTHONPATH=src python scripts/qa_theme_manager_002.py +python scripts/verify_package_001.py --site examples/site-studio +site-engine export-openapi --out specs/001-antirion-admin/openapi.json +``` + +При пользовательском изменённом studio-site полный suite требует описанной выше базовой фикстуры, как на предыдущем этапе. + +## Границы передачи + +Рабочие data/.env/SITE_ROOT, live, пользовательские design/ и docker-run.sh не менялись. Коммит/переключение примера/публикация не выполнялись. Для просмотра runtime на сервере нужна пересборка контейнера. Ручная серверная приёмка пользователем остаётся открытой. + +Первый Save включает два отдельных atomic rename (theme.yaml и site.yaml) под одним SiteLock с восстановлением при обычном отказе. Это не общая crash-atomic транзакция нескольких файлов: при аварийном завершении процесса между rename может остаться несвязанный файл темы. Он не применяется без ссылки. Настроенная тема обновляется одним файлом. Отказ аудита/workflow после записи явно сообщает committed snapshot; запись не маскируется как неуспешная без последствий. diff --git a/specs/002-site-studio-theme/verification-stages-2-3.md b/specs/002-site-studio-theme/verification-stages-2-3.md new file mode 100644 index 0000000..1c053a2 --- /dev/null +++ b/specs/002-site-studio-theme/verification-stages-2-3.md @@ -0,0 +1,68 @@ +# Проверка 002 — этапы 2 и 3 + +Дата: 2026-11-13. Этапы выполнены вместе по прямому поручению пользователя. Реализация подготовлена к пользовательской приёмке; развёртывание на рабочем сервере и этапы 4–5 не выполнялись. Контракт — [runtime.md](runtime.md), задачи — [tasks.md](tasks.md). + +## Реализовано + +- Файловая тема через site.yaml.theme.file, schema 1, шесть точных preset@1 из исходного дизайна и каталог разрешённых шрифтов в runtime-пакете. Inline tokens получают явную ошибку; отсутствие настройки у нового сайта использует minimal@1 без записи. +- Единый resolver dataclass-ядра для валидации, CLI/build и обоих режимов preview. Глубокие overrides, строгие числовые диапазоны/типы, HEX, дополнительные цвета и линейные градиенты, полноценный Custom; диагностика контраста — warning. +- Семантические CSS-переменные подключены после defaults. Базовая типографика, кнопки, карточки, поверхности, подписи и границы используют токены. Градиенты Hero/button/CTA применяются адресно и отключаются к однотонному fallback; outline не становится solid. Палитра админки не изменяется. +- Manifest фиксирует document/effective_tokens, source_hash/render_hash/fingerprint. Воспроизводимый ID учитывает ресурсы движка и пресеты. Коллизия не перезаписывает исторический каталог, ошибки не переключают current, rollback не меняет workspace. +- ContainerSettings и BlockLayout: inherit/boxed/fluid/full, max_width, адаптивные gutters и границы 700/1024. Одно поведение для Page/Entry/Display/fixed/slots, собственные контейнеры вложенных блоков и sticky корни. +- Контролы ширины инспектора перенесены из design/assets/builder.js: те же подписи, варианты, классы и пояснение. Существующая цепочка htmx → HTML → JSON API → DocumentService сохраняется. API объявляет BlockLayoutDTO в OpenAPI. Обновление полей до Save не записывает страницу; props/duplicate/move/toggle и Конструктор ↔ Эксперт сохраняют layout. +- Исходные конфигурации studio-site и ai-studio переведены на theme.yaml с сохранением основных цветов и тёмного Hero. Пользовательские страницы и design не менялись этой работой. Новый examples/site-studio остаётся этапом 4. + +## Автоматические и интеграционные проверки + +Полная регрессия: **320 тестов, 0 ошибок, 0 падений, 0 пропусков**. Для старых тестов использован git HEAD `examples/studio-site`, извлечённый во временный каталог, с наложенными актуальными site.yaml/theme.yaml. Это исключает зависимость от пользовательских изменений рабочего pages/index.md. Новые проверки используют самостоятельный файловый сайт из tests/theme_fixture.py. + +Новые **21 проверки темы** охватывают все пресеты, независимость копий каталога, deep merge и Custom, invalid shapes/enums/ranges/boolean/NaN/Inf/огромные числа, запрещённые CSS/URL/Jinja/шрифты, limits/reserved names, stops и отключение градиентов, пути/YAML/symlink, контраст, общий CSS, manifest, воспроизводимость, изменение ресурсов без изменения source_hash, защиту live/истории и rollback. После исправления обработки огромных чисел эти 21 проверки запущены повторно. + +Ещё **11 проверок ширины и HTTP-интеграции** охватывают строгий BlockLayout, все режимы/наследование, отсутствие общих wrappers и утечек в nested containers, Page/Entry/Display/fixed/slots, схему snapshot/OpenAPI, операции дерева, явное сохранение и reopen, очистку nullable-полей, настоящий HTML → API transform, invalid widths, распространение ошибок темы в API/HTML/preview/publish без переключения live. + +Штатный validate актуального ai-studio: **0 ошибок, 0 предупреждений**; build: **14 страниц**. Отдельная базовая фикстура собирается и в установленном пакете. Проверки wheel подтверждают наличие containers.css, всех шести пресетов, fonts.json и вложенных фрагментов. Wheel установлен вне checkout и запущен без design/: разрешение всех пресетов, сборка, админская статика/шаблоны/API, ширина и отдельный preview origin с nonce bridge проходят. + +Ruff изменённых модулей и git diff --check проходят. Прежние broad assertRaises(Exception) в test_security.py не изменялись и проверены с исключением существующего правила B017; изменённая проверка инъекции использует новый theme.yaml/E_THEME_COLOR. OpenAPI повторно экспортирован в specs/001-antirion-admin/openapi.json. + +## Настоящий браузер + +`scripts/qa_theme_002.py` запускает изолированные FastAPI admin/public и отдельный preview origin; данные и учётная запись временные. **Chromium 158, 8 групп приёмки**: + +1. Все шесть пресетов: фактические background/text, heading weight, radius кнопки; применение и отключение градиента проверены через computed styles. +2. Три глобальных режима × девять пар section/content × девять ширин: **243 проверки геометрии пар** на 1440/1280/1024/1023/768/700/699/390/360 px. Проверены gutters, max-width, вложенная секция, sticky-header и отсутствие горизонтального overflow. Дополнительно gutters 0 и 96 на 360 px. +3. Контролы инспектора сверены с оригинальным design/builder-antirion.html: варианты/value/подписи и computed font/color/background/border/radius/height/padding совпадают. +4. Выбор секции в дереве локальный, без POST; в preview появляется выделение. +5. Изменение ширины обновляет immutable preview, сохраняя выбранную секцию и scroll (расхождение менее 3 px), файл страницы не записывается. +6. Конструктор ↔ Эксперт сохраняет исходник; изменение props сохраняет layout; Save и reload возвращают те же значения. +7. Админка проверена на 1440/1280/1024/768/390/360 px, без горизонтального overflow. +8. Нет неожиданных JS/console ошибок, нативных диалогов или внутренних API credentials в запросах браузера. + +Скриншоты desktop/mobile просмотрены: контролы соответствуют исходному дизайну, preview загружен и показывает выделение. Публичный тестовый сайт проверяет поведение движка; он не является переносом нового Site Studio и не подменяет визуальную приёмку этапа 4. + +## Артефакты и воспроизведение + +`/tmp/site-engine-theme-002/`: + +- browser.json — браузерный отчёт и измерения; +- constructor-1440.png, constructor-390.png, reference-controls-1440.png; +- public-1440.png, public-390.png, public-360.png; +- unittest.json и unittest.log — полная регрессия; +- ai-studio-dist/current/ — штатная сборка актуального примера; +- baseline/examples/studio-site/ — изолированная базовая фикстура с новыми конфигурациями темы. + +```bash +PYTHONPATH=src python -m unittest discover -s tests -p 'test_theme.py' -v +PYTHONPATH=src python -m unittest discover -s tests -p 'test_block_layout.py' -v +PYTHONPATH=src python scripts/qa_theme_002.py +PYTHONPATH=src python scripts/verify_package_001.py --site /path/to/isolated-site +PYTHONPATH=src python -m site_engine.cli validate examples/ai-studio +PYTHONPATH=src python -m site_engine.cli build examples/ai-studio --out /tmp/ai-studio-dist +``` + +В этой среде использовался `/tmp/flexly-cms-htmx-check/bin/python`. Обычный запуск полной регрессии использует рабочий пример; его результаты могут отличаться при пользовательских изменениях. Системный sandbox bwrap недоступен, поэтому команды выполнялись разрешённым инструментом вне bwrap; браузер работал с loopback и без прокси. + +## Пользовательская приёмка + +Для проверки на сервере нужна пересборка Docker-образа. Если рабочий сайт всё ещё содержит inline theme.tokens, конфигурацию нужно явно перевести на файловый контракт; автоматической миграции нет согласно принятому решению. Изменения текущих рабочих данных, переключение SITE_ROOT, публикация на сервер и коммиты не выполнялись. Root examples не коммитились. + +Проверить в конструкторе «Макет блока · ширина», пары Full/Boxed и Fluid/Full, вложенный блок, переключение Конструктор ↔ Эксперт, Save/reopen. Проверить файловую тему на своём контенте и отдельную публикацию/откат. Пользовательская приёмка отмечается отдельно; новый Site Studio и Theme Manager к этим этапам не относятся. diff --git a/specs/002-site-studio-theme/verification.md b/specs/002-site-studio-theme/verification.md new file mode 100644 index 0000000..73fb4a1 --- /dev/null +++ b/specs/002-site-studio-theme/verification.md @@ -0,0 +1,44 @@ +# Проверка 002 — этап 1: категории фрагментов + +Дата: 2026-11-13. Реализация этапа 1 подготовлена к пользовательской приёмке. Следующие этапы — тема, ширина блоков, перенос публичных компонентов, отдельный Site Studio и Theme Manager — этим отчётом не закрываются. + +Это отчёт состояния на момент завершения этапа 1. Последующая реализация темы и ширины описана отдельно в [проверке этапов 2–3](verification-stages-2-3.md); актуальный контракт — [runtime.md](runtime.md). + +## Реализованное поведение + +- Обнаружение рекурсивное, по `fragment.yaml`; имя каталога не подменяет ID манифеста. Плоское, категоризированное и смешанное размещение работают одновременно. +- Для вложенного фрагмента категория — первый каталог относительно `fragments/`, для плоского — YAML `category` или `misc`. Путь имеет приоритет над YAML, дополнительная вложенность категорию не меняет. Допустимы произвольные категории сайта. +- Все 15 builtin разложены по шести категориям: `content` (6), `data` (2), `forms` (1), `marketing` (3), `media` (1), `system` (2). Их ID, шаблоны, CSS и JS сохранены; побайтовое сравнение перемещённых шаблонов и ресурсов с HEAD прошло. `columns` и `page_header` сохранены. +- API продолжает отдавать строку `schema.fragments[id].category` и плоский словарь `preview`. Ссылки на фрагменты остаются без префиксов категорий; повторные ID запрещены. +- Необязательный соседний `preview.yaml` имеет форму `{name?: string, props: object}`. Его `props` переопределяют inline preview по ключам; отсутствующие значения берутся из defaults полей. `name` из preview не меняет имя фрагмента. Некорректные файлы дают диагностику с путями, а не исключения из `.get()` при рендере формы. +- В каталоге видны категория, название и назначение. Поиск учитывает ID, название, описание, код категории и прежнюю русскую подпись. Прежние категории объединяются со стандартными только при отображении: исходное значение API и файла сохраняется. +- Добавление блока и предпросмотр не записывают страницу. Явное сохранение, ETag, CSRF, ограничения регионов/слотов и формат новых ID сохранены. + +## Выполненные проверки + +1. Полный набор Python-проверок: **288 тестов, 0 ошибок, 0 падений, 0 пропусков**. Фикстура `examples/studio-site` взята из HEAD во временный каталог, поскольку рабочий `pages/index.md` изменён пользователем; исходный пример не менялся. Машиночитаемый результат: `/tmp/site-engine-fragments-002/unittest.json`, подробный лог — `unittest.log` в том же каталоге. +2. Новые проверки ядра: **23 теста** для обнаружения, приоритета категории, глобальных ID, дубликатов, preview и его диагностики. **7 интеграционных тестов** используют самостоятельную временную файловую модель и настоящую цепочку login → HTML → внутренний API, включая экранирование пользовательских категорий, диагностику повреждённого preview в workspace/JSON/HTML и сохранность опубликованного релиза при отказе. +3. Валидация текущего `examples/ai-studio`: **0 ошибок, 0 предупреждений**. Штатная сборка: **14 страниц** в `/tmp/site-engine-fragments-002/ai-studio-dist/current/`. +4. Проверка упаковки: wheel содержит все файлы вложенных builtin. Установка wheel во временный каталог и запуск FastAPI вне checkout прошли: статика, шаблоны, API, изолированное превью и bridge работают без каталога `design/`. +5. Браузер: настоящий FastAPI и отдельный preview origin, Chromium 158, **1440×960 и 390×844**, **8 групп приёмки**. Проверены категории, русские подписи, поиск, пустая выдача, ограничения региона/слота, клавиатурный фокус, sidecar defaults с `false`/`0`, добавление/превью без записи, согласованность активного фильтра после HTML swap, явное сохранение/повторное открытие, CSS вложенных и плоских фрагментов в опубликованном бандле. Неожиданных JS-ошибок, нативных диалогов и передачи внутренних credentials браузеру нет. +6. Проверены Ruff для изменённого Python-кода и `git diff --check`. + +Браузерный отчёт и скриншоты находятся в `/tmp/site-engine-fragments-002/`: `report.json`, `catalog-desktop.png`, `mobile.png`. При проверке ответы runtime `builder-adapter.css` и `builder.js` сравниваются с текущими исходниками; их SHA-256 записывается в отчёт. Скриншоты просмотрены: категории видимы, горизонтального переполнения каталога нет. + +## Воспроизведение + +```bash +PYTHONPATH=src python -m unittest discover -s tests -p 'test_fragment_catalog*.py' -v +PYTHONPATH=src python scripts/qa_fragments_002.py +PYTHONPATH=src python -m site_engine.cli validate examples/ai-studio +PYTHONPATH=src python -m site_engine.cli build examples/ai-studio --out /tmp/ai-studio-dist +PYTHONPATH=src python scripts/verify_package_001.py +``` + +Браузерный сценарий самостоятельно получает базовую фикстуру через `git archive HEAD`, не читая и не изменяя рабочий `examples/studio-site/pages/index.md`. Обычные команды полной проверки и `verify_package_001.py` используют рабочий пример: при наличии пользовательских изменений его результаты могут отличаться. Для описанной проверки установленного wheel использовалась временная копия актуальных `src/`, `pyproject.toml`, `README.md` и базовая фикстура из HEAD. + +## Развёртывание и приёмка + +Рабочий `SITE_ROOT`, файлы сайта и исходники `design/` не переключались и не менялись. Коммиты и публикация на сервер не выполнялись. Изменения builtin, загрузчика и админки требуют пересборки Docker-образа; bind-mount каталога сайта их не обновляет. + +После установки новой сборки открыть конструктор → «Добавить блок»: проверить подписи шести категорий, фильтрацию и существующие локальные фрагменты. Далее этап 1 принимает пользователь; переход к ядру темы выполняется после этой приёмки согласно согласованному плану. diff --git a/src/site_engine/build/pipeline.py b/src/site_engine/build/pipeline.py index d6073c2..a33dde8 100644 --- a/src/site_engine/build/pipeline.py +++ b/src/site_engine/build/pipeline.py @@ -21,11 +21,11 @@ from ..core.models import Block, Page from ..core.registry import BUILTIN_DIR, Registry, load_site from ..core.render import ASSETS_BODY, ASSETS_HEAD, PageView, Renderer from ..core.routes import RouteRef, build_route_table, route_to_output +from ..core.theme import theme_css from ..core.validate import validate_release, validate_workspace from ..errors import EngineError, Report BUILD_ID_RE = re.compile(r"^\d{8}T\d{6}-[0-9a-f]{8}$") -_TOKEN_VALUE_RE = re.compile(r"^[A-Za-z0-9#%.,()\s'\"/_+-]+$") _SKIP_DIRS = {"dist", ".engine", ".git", "__pycache__", "node_modules"} @@ -95,20 +95,9 @@ def make_views(reg: Registry, table: dict[str, RouteRef], report: Report, publis return views -def _token_css(tokens: dict, report: Report) -> str: - lines = [] - for key, value in tokens.items(): - name = "--" + str(key).replace(".", "-") - if not re.match(r"^--[a-z0-9-]+$", name) or not _TOKEN_VALUE_RE.match(str(value)): - report.add("E_THEME_TOKEN", f"недопустимый токен темы «{key}: {value}»", "site.yaml:theme.tokens") - continue - lines.append(f" {name}: {value};") - return ":root {\n" + "\n".join(lines) + "\n}\n" if lines else "" - - def _bundle(reg: Registry, used: set[str], report: Report) -> tuple[str, str]: base_css = (BUILTIN_DIR / "base.css").read_text(encoding="utf-8") - css = [_token_css(reg.site.theme_tokens, report), base_css] + css = [base_css] js: list[str] = [] for fid in sorted(used): fragment = reg.fragments[fid] @@ -116,9 +105,26 @@ def _bundle(reg: Registry, used: set[str], report: Report) -> tuple[str, str]: css.append(f"/* fragment: {fid} */\n{fragment.style}") if fragment.script: js.append(f"/* fragment: {fid} */\n{fragment.script}") + css.append(theme_css(reg.theme)) + css.append((BUILTIN_DIR / "containers.css").read_text(encoding="utf-8")) return "\n".join(css), "\n".join(js) +def render_fingerprint(reg: Registry) -> str: + """Include engine code, versioned presets and actual render resources in release identity.""" + digest = hashlib.sha256() + package = Path(__file__).resolve().parent.parent + for directory in ("core", "parsing", "builtin", "build"): + for path in sorted((package / directory).rglob("*")): + if not path.is_file() or "__pycache__" in path.parts or path.suffix == ".pyc": + continue + digest.update(path.relative_to(package).as_posix().encode() + b"\0" + path.read_bytes() + b"\0") + for name, fragment in sorted(reg.fragments.items()): + digest.update(json.dumps([name, fragment.template, fragment.style, fragment.script], ensure_ascii=False).encode()) + digest.update(json.dumps(reg.theme.snapshot(), sort_keys=True, ensure_ascii=False).encode()) + return digest.hexdigest() + + def _redirect_html(target: str) -> str: t = escape(target) return (f"Перенаправление" @@ -155,7 +161,7 @@ def prune_releases(dist: Path, keep: int) -> list[str]: def build_site(root: Path, out: Path, *, keep: int = 5, now: dt.datetime | None = None) -> BuildResult: root, out = Path(root), Path(out) - now = now or dt.datetime.now(dt.timezone.utc) + now = now or dt.datetime.now(dt.UTC) reg = load_site(root) report = Report() table_report = Report() @@ -163,6 +169,8 @@ def build_site(root: Path, out: Path, *, keep: int = 5, now: dt.datetime | None report.extend(validate_workspace(reg, table)) report.extend(table_report) report.extend(validate_release(reg, table)) + if report.errors: + raise EngineError(f"сборка остановлена: ошибок {len(report.errors)}", report) source_hash = hash_tree(root) # Only published Page sources: the public manifest must not reveal draft paths. @@ -170,7 +178,9 @@ def build_site(root: Path, out: Path, *, keep: int = 5, now: dt.datetime | None 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]}" + render_hash = render_fingerprint(reg) + fingerprint = hashlib.sha256(f"{source_hash}:{render_hash}".encode()).hexdigest() + build_id = f"{now.strftime('%Y%m%dT%H%M%S')}-{fingerprint[:8]}" views = make_views(reg, table, report) renderer = Renderer(reg, table, report, strict=True, now=now, build_id=build_id) @@ -228,13 +238,19 @@ def build_site(root: Path, out: Path, *, keep: int = 5, now: dt.datetime | None (staging / "robots.txt").write_text(f"User-agent: *\nAllow: /\nSitemap: {reg.site.base_url}/sitemap.xml\n", encoding="utf-8") (staging / "manifest.json").write_text(json.dumps({ "build_id": build_id, "source_hash": source_hash, "built_at": now.isoformat(), + "render_hash": render_hash, "fingerprint": fingerprint, + "theme": reg.theme.snapshot(), "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(): - shutil.rmtree(final) - os.rename(staging, final) + if hash_tree(final) != hash_tree(staging): + report.add("E_RELEASE_COLLISION", "существующий релиз с этим ID содержит другой результат", build_id) + raise EngineError("исторический релиз не перезаписан", report) + shutil.rmtree(staging) + else: + os.rename(staging, final) except BaseException: shutil.rmtree(staging, ignore_errors=True) raise @@ -247,6 +263,9 @@ def preview_page(root: Path, page_id: str, *, now: dt.datetime | None = None) -> """Рендер одной страницы из рабочего каталога, включая черновики (нестрогий режим).""" reg = load_site(root) report = Report() + report.extend(reg.report) + if report.errors: + raise EngineError("превью недоступно: ошибки загрузки сайта", report) table = build_route_table(reg, report) views = [v for v in make_views(reg, table, report, published_only=False) if v.id == page_id] if not views: diff --git a/src/site_engine/builtin/base.css b/src/site_engine/builtin/base.css index 2f0eb94..2ff5494 100644 --- a/src/site_engine/builtin/base.css +++ b/src/site_engine/builtin/base.css @@ -1,19 +1,44 @@ -/* Базовые стили движка. Оформление задаётся токенами темы: --color-primary и т.д. */ -*, *::before, *::after { box-sizing: border-box; } -body { - margin: 0; - font-family: var(--font-body, system-ui, sans-serif); - color: var(--color-text, #1a1a1a); - background: var(--color-bg, #fff); - line-height: 1.55; -} -img { max-width: 100%; height: auto; } -a { color: var(--color-primary, #0b5fff); } -.f-container { max-width: 72rem; margin: 0 auto; padding: 0 1rem; } -.f-btn { - display: inline-block; padding: .6rem 1.1rem; margin: 0 .5rem .5rem 0; border-radius: .4rem; - background: var(--color-primary, #0b5fff); color: #fff; text-decoration: none; border: 0; cursor: pointer; -} -.f-btn--secondary { background: transparent; color: var(--color-primary, #0b5fff); outline: 1px solid currentColor; } -.f-card { list-style: none; padding: 1rem; border: 1px solid #e2e2e2; border-radius: .6rem; } -.f-badge { font-size: .75rem; padding: .1rem .5rem; border-radius: 1rem; background: #eef3ff; } +/* Transferred from design/examples/site-studio/assets/site.css; theme/container runtime owns tokens and widths. */ + +*{box-sizing:border-box} +html{scroll-behavior:smooth} +body{margin:0;background:var(--color-background);color:var(--color-text);font:calc(14px * var(--type-scale,1))/var(--type-line,1.6) var(--font-body)} +a{color:inherit;text-decoration:none} +button{font:inherit} +input{font:inherit} +textarea{font:inherit} +.container{max-width:var(--container);padding:0 36px;margin:auto} +.btn,.f-btn{display:inline-flex;align-items:center;justify-content:center;background:var(--button-background);color:var(--button-text);border:0;border-radius:var(--radius);font-weight:750;padding:10px 16px;font-size:12px} +.section{padding:calc(58px * var(--spacing,1)) 0} +.section.alt{background:var(--color-secondary)} +.section h2{font:var(--heading-weight,700) 30px/1.2 var(--font-heading);letter-spacing:-.045em;margin:0 0 14px} +.section p{color:var(--color-muted)} +.section-lead{margin-top:-4px} +.cards{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:16px;margin-top:24px} +.card{display:block;padding:calc(22px * var(--spacing,1)) calc(20px * var(--spacing,1));background:var(--color-surface);border:1px solid var(--color-border);border-radius:var(--radius);box-shadow:var(--shadow,none);min-height:130px} +.card small{color:var(--color-card-label,#8174bd);font-weight:800;font-size:10px} +.card strong{display:block;font-size:16px;margin:14px 0 5px} +.card p{font-size:12px;margin:0} +.card.standalone{max-width:440px} +.steps{display:grid;grid-template-columns:repeat(3,1fr);gap:24px;margin-top:25px} +.steps div{border-top:1px solid var(--color-border);padding-top:14px} +.steps span{display:block;color:var(--color-step-label,#8c7ac9);font-size:11px} +.steps b{font-size:18px} +.prose{max-width:1080px} +.prose :is(p,ul){max-width:740px} +.prose a{color:var(--color-primary);text-decoration:underline} +.btn:focus-visible{outline:2px solid var(--color-primary);outline-offset:3px} +@media(max-width:700px){.container{padding:0 20px}} +@media(max-width:700px){.section{padding:calc(39px * var(--spacing,1)) 0}} +@media(max-width:700px){.cards{grid-template-columns:1fr}} +@media(max-width:700px){.steps{grid-template-columns:1fr}} +@media(max-width:700px){.card{min-height:auto}} +/* Production list semantics and keyboard/motion support. */ +.cards,.steps{padding:0;list-style:none}.cards{margin-bottom:0}.steps{margin-bottom:0;grid-template-columns:repeat(3,minmax(0,1fr))}.steps>li{border-top:1px solid var(--color-border);padding-top:14px;min-width:0}.cards>li{min-width:0}.f-btn{cursor:pointer}.f-badge{display:inline-block;font-size:11px;background:var(--color-secondary);border-radius:var(--radius);padding:2px 6px} +.f-container{width:100%;max-width:var(--container-max);padding-inline:var(--active-gutter);margin-inline:auto} +h1,h2,h3,h4,h5,h6{font-family:var(--font-heading);font-weight:var(--heading-weight)} +img{max-width:100%;height:auto}:focus-visible{outline:2px solid var(--color-primary);outline-offset:3px} +@media(max-width:700px){.steps{grid-template-columns:1fr}} +@media(prefers-reduced-motion:reduce){html{scroll-behavior:auto}} + +.f-btn--secondary{background:transparent;color:var(--color-primary);border:1px solid currentColor} diff --git a/src/site_engine/builtin/containers.css b/src/site_engine/builtin/containers.css new file mode 100644 index 0000000..7e7f218 --- /dev/null +++ b/src/site_engine/builtin/containers.css @@ -0,0 +1,28 @@ +/* Section background extent and its own content. Nested blocks carry their own markers. */ +:root { --active-gutter: var(--gutter-desktop); } +@media (max-width: 1023px) { :root { --active-gutter: var(--gutter-tablet); } } +@media (max-width: 699px) { :root { --active-gutter: var(--gutter-mobile); } } +[data-engine-block][data-section-width] { + width: 100%; max-width: none; min-width: 0; margin-inline: auto; +} +[data-engine-block][data-section-width="boxed"] { + width: max(0px, calc(100% - 2 * var(--active-gutter))); max-width: var(--container-max); +} +[data-engine-block][data-section-width="fluid"] { + width: max(0px, calc(100% - 2 * var(--active-gutter))); max-width: none; +} +[data-engine-container][data-engine-container] { + width: 100%; min-width: 0; margin-inline: auto; + max-width: var(--container-max); padding-inline: min(var(--active-gutter), 50%); + overflow-wrap: anywhere; +} +[data-engine-container="fluid"][data-engine-container], +[data-engine-container="full"][data-engine-container] { max-width: none; } +[data-engine-container="full"][data-engine-container] { padding-inline: 0; } +/* A legacy custom fragment may place .container on its root. Constrain both modes. */ +[data-engine-block][data-engine-container][data-section-width="boxed"] { + width: max(0px, calc(100% - 2 * var(--active-gutter))); max-width: var(--container-max); +} +[data-engine-block][data-engine-container][data-section-width="fluid"] { + width: max(0px, calc(100% - 2 * var(--active-gutter))); +} diff --git a/src/site_engine/builtin/fragments/card_grid/style.css b/src/site_engine/builtin/fragments/card_grid/style.css deleted file mode 100644 index 1ee263f..0000000 --- a/src/site_engine/builtin/fragments/card_grid/style.css +++ /dev/null @@ -1,4 +0,0 @@ -.f-card_grid { padding: 2rem 0; } -.f-card_grid__items { display: grid; grid-template-columns: repeat(auto-fit, minmax(14rem, 1fr)); gap: 1rem; padding: 0; margin: 0; } -.f-card_grid--steps .f-card_grid__items { counter-reset: step; } -.f-card_grid--steps .f-card::before { counter-increment: step; content: counter(step); font-weight: 700; color: var(--color-primary, #0b5fff); } diff --git a/src/site_engine/builtin/fragments/card_grid/template.html.j2 b/src/site_engine/builtin/fragments/card_grid/template.html.j2 deleted file mode 100644 index 325d4bb..0000000 --- a/src/site_engine/builtin/fragments/card_grid/template.html.j2 +++ /dev/null @@ -1,14 +0,0 @@ -
-
- {% if props.title %}

{{ props.title }}

{% endif %} - <{{ 'ol' if props.variant == 'steps' else 'ul' }} class='f-card_grid__items'> - {% for item in props.items %} -
  • - {% if item.badge %}{{ item.badge }}{% endif %} -

    {% if item.link %}{{ item.title }}{% else %}{{ item.title }}{% endif %}

    - {% if item.text %}
    {{ item.text|md_inline }}
    {% endif %} -
  • - {% endfor %} - -
    -
    diff --git a/src/site_engine/builtin/fragments/collection_list/style.css b/src/site_engine/builtin/fragments/collection_list/style.css deleted file mode 100644 index 16a6338..0000000 --- a/src/site_engine/builtin/fragments/collection_list/style.css +++ /dev/null @@ -1,7 +0,0 @@ -.f-collection_list { padding: 2rem 0; } -.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 deleted file mode 100644 index c8294fb..0000000 --- a/src/site_engine/builtin/fragments/collection_list/template.html.j2 +++ /dev/null @@ -1,20 +0,0 @@ -{% if props.source %} -
    -
    - {% if props.title %}

    {{ props.title }}

    {% endif %} -
      - {% 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 %} -
    • - {% endfor %} -
    -
    -
    -{% elif props.empty == 'message' %} -

    {{ props.empty_message }}

    -{% endif %} diff --git a/src/site_engine/builtin/fragments/columns/style.css b/src/site_engine/builtin/fragments/columns/style.css deleted file mode 100644 index fcdb12a..0000000 --- a/src/site_engine/builtin/fragments/columns/style.css +++ /dev/null @@ -1,5 +0,0 @@ -.f-columns { display: grid; gap: 1.5rem; } -.f-columns--2 { grid-template-columns: repeat(2, 1fr); } -.f-columns--3 { grid-template-columns: repeat(3, 1fr); } -.f-columns--4 { grid-template-columns: repeat(4, 1fr); } -@media (max-width: 700px) { .f-columns { grid-template-columns: 1fr; } } diff --git a/src/site_engine/builtin/fragments/card_grid/fragment.yaml b/src/site_engine/builtin/fragments/content/card_grid/fragment.yaml similarity index 98% rename from src/site_engine/builtin/fragments/card_grid/fragment.yaml rename to src/site_engine/builtin/fragments/content/card_grid/fragment.yaml index b408d6a..badeacf 100644 --- a/src/site_engine/builtin/fragments/card_grid/fragment.yaml +++ b/src/site_engine/builtin/fragments/content/card_grid/fragment.yaml @@ -1,6 +1,6 @@ id: card_grid name: Карточки -category: Контент +category: content version: 1 fields: - key: title diff --git a/src/site_engine/builtin/fragments/content/card_grid/style.css b/src/site_engine/builtin/fragments/content/card_grid/style.css new file mode 100644 index 0000000..bbd1002 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/card_grid/style.css @@ -0,0 +1,3 @@ +/* Site Studio source styles + engine schema extensions. */ + +.f-card_grid__items>.card strong:first-child{margin-top:0}.f-card_grid__items .f-card_grid__step{background:none;border-radius:0}.f-card_grid__items .f-card_grid__step p{margin-bottom:0} diff --git a/src/site_engine/builtin/fragments/content/card_grid/template.html.j2 b/src/site_engine/builtin/fragments/content/card_grid/template.html.j2 new file mode 100644 index 0000000..9fcea8a --- /dev/null +++ b/src/site_engine/builtin/fragments/content/card_grid/template.html.j2 @@ -0,0 +1,7 @@ +
    {% if props.title %}

    {{ props.title }}

    {% endif %} +<{{ 'ol' if props.variant == 'steps' else 'ul' }} class="{{ 'steps' if props.variant == 'steps' else 'cards' }} f-card_grid__items"> +{% for item in props.items %}
  • +{% if props.variant == 'steps' %}{% elif item.badge %}{{ item.badge }}{% endif %} +{% if props.variant == 'steps' %}{% else %}{% endif %}{% if item.link %}{{ item.title }}{% else %}{{ item.title }}{% endif %}{% if props.variant == 'steps' %}{% else %}{% endif %} +{% if item.text %}

    {{ item.text|md_inline }}

    {% endif %}
  • {% endfor %} +
    diff --git a/src/site_engine/builtin/fragments/columns/fragment.yaml b/src/site_engine/builtin/fragments/content/columns/fragment.yaml similarity index 93% rename from src/site_engine/builtin/fragments/columns/fragment.yaml rename to src/site_engine/builtin/fragments/content/columns/fragment.yaml index 5bb2a3b..25969ea 100644 --- a/src/site_engine/builtin/fragments/columns/fragment.yaml +++ b/src/site_engine/builtin/fragments/content/columns/fragment.yaml @@ -1,6 +1,6 @@ id: columns name: Колонки -category: Компоновка +category: content version: 1 fields: - key: count diff --git a/src/site_engine/builtin/fragments/content/columns/style.css b/src/site_engine/builtin/fragments/content/columns/style.css new file mode 100644 index 0000000..75b838c --- /dev/null +++ b/src/site_engine/builtin/fragments/content/columns/style.css @@ -0,0 +1,5 @@ +.f-columns { display: grid; gap: 1.5rem; } +.f-columns--2 { grid-template-columns: repeat(2, minmax(0, 1fr)); } +.f-columns--3 { grid-template-columns: repeat(3, minmax(0, 1fr)); } +.f-columns--4 { grid-template-columns: repeat(4, minmax(0, 1fr)); } +@media (max-width: 700px) { .f-columns { grid-template-columns: 1fr; } } diff --git a/src/site_engine/builtin/fragments/columns/template.html.j2 b/src/site_engine/builtin/fragments/content/columns/template.html.j2 similarity index 59% rename from src/site_engine/builtin/fragments/columns/template.html.j2 rename to src/site_engine/builtin/fragments/content/columns/template.html.j2 index bfc43be..3edad1f 100644 --- a/src/site_engine/builtin/fragments/columns/template.html.j2 +++ b/src/site_engine/builtin/fragments/content/columns/template.html.j2 @@ -1,5 +1,5 @@ -
    +
    {% for name in ['col_1', 'col_2', 'col_3', 'col_4'] %} {% if slots[name] %}
    {{ slots[name] }}
    {% endif %} {% endfor %} -
    +
    diff --git a/src/site_engine/builtin/fragments/disclaimer/fragment.yaml b/src/site_engine/builtin/fragments/content/disclaimer/fragment.yaml similarity index 93% rename from src/site_engine/builtin/fragments/disclaimer/fragment.yaml rename to src/site_engine/builtin/fragments/content/disclaimer/fragment.yaml index 4c67914..6acbf86 100644 --- a/src/site_engine/builtin/fragments/disclaimer/fragment.yaml +++ b/src/site_engine/builtin/fragments/content/disclaimer/fragment.yaml @@ -1,6 +1,6 @@ id: disclaimer name: Пояснение -category: Контент +category: content version: 1 fields: - key: variant diff --git a/src/site_engine/builtin/fragments/content/disclaimer/style.css b/src/site_engine/builtin/fragments/content/disclaimer/style.css new file mode 100644 index 0000000..bac3ba0 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/disclaimer/style.css @@ -0,0 +1,3 @@ +/* Site Studio source styles + engine schema extensions. */ +.disclaimer{border-top:1px solid var(--color-border);background:var(--color-disclaimer-surface,#fff2eb)} +.f-disclaimer--info{background:var(--color-secondary)} diff --git a/src/site_engine/builtin/fragments/content/disclaimer/template.html.j2 b/src/site_engine/builtin/fragments/content/disclaimer/template.html.j2 new file mode 100644 index 0000000..8365055 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/disclaimer/template.html.j2 @@ -0,0 +1 @@ + diff --git a/src/site_engine/builtin/fragments/faq/fragment.yaml b/src/site_engine/builtin/fragments/content/faq/fragment.yaml similarity index 96% rename from src/site_engine/builtin/fragments/faq/fragment.yaml rename to src/site_engine/builtin/fragments/content/faq/fragment.yaml index 57720a3..6eb8170 100644 --- a/src/site_engine/builtin/fragments/faq/fragment.yaml +++ b/src/site_engine/builtin/fragments/content/faq/fragment.yaml @@ -1,6 +1,6 @@ id: faq name: FAQ -category: Контент +category: content version: 1 fields: - key: title diff --git a/src/site_engine/builtin/fragments/content/faq/style.css b/src/site_engine/builtin/fragments/content/faq/style.css new file mode 100644 index 0000000..f6da301 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/faq/style.css @@ -0,0 +1,5 @@ +/* Site Studio source styles + engine schema extensions. */ +.faq{border-top:1px solid var(--color-border);border-bottom:1px solid var(--color-border);padding:14px 0} +.faq summary{font-weight:650;cursor:pointer} +.faq p{margin:10px 0} +/* Shared section/container primitives are in base.css. */ diff --git a/src/site_engine/builtin/fragments/content/faq/template.html.j2 b/src/site_engine/builtin/fragments/content/faq/template.html.j2 new file mode 100644 index 0000000..c2a5e89 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/faq/template.html.j2 @@ -0,0 +1 @@ +
    {% if props.title %}

    {{ props.title }}

    {% endif %}{% for item in props.items %}
    {{ item.q }}
    {{ item.a|md }}
    {% endfor %}
    diff --git a/src/site_engine/builtin/fragments/richtext/fragment.yaml b/src/site_engine/builtin/fragments/content/richtext/fragment.yaml similarity index 84% rename from src/site_engine/builtin/fragments/richtext/fragment.yaml rename to src/site_engine/builtin/fragments/content/richtext/fragment.yaml index 7c69312..f7d3e09 100644 --- a/src/site_engine/builtin/fragments/richtext/fragment.yaml +++ b/src/site_engine/builtin/fragments/content/richtext/fragment.yaml @@ -1,6 +1,6 @@ id: richtext name: Markdown body -category: Контент +category: content version: 1 fields: - key: content @@ -8,6 +8,9 @@ fields: required: true label: Текст в Markdown hint: Поддерживает Markdown. Для текста страницы используйте привязку page.body. +- key: title + type: text + label: Заголовок slots: {} preview: content: diff --git a/src/site_engine/builtin/fragments/content/richtext/style.css b/src/site_engine/builtin/fragments/content/richtext/style.css new file mode 100644 index 0000000..e4559a5 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/richtext/style.css @@ -0,0 +1,3 @@ +/* Site Studio source styles + engine schema extensions. */ + +.f-richtext .prose{max-width:var(--container-max)} diff --git a/src/site_engine/builtin/fragments/content/richtext/template.html.j2 b/src/site_engine/builtin/fragments/content/richtext/template.html.j2 new file mode 100644 index 0000000..fc2f260 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/richtext/template.html.j2 @@ -0,0 +1 @@ +
    {% if props.title %}

    {{ props.title }}

    {% endif %}{{ props.content|md }}
    diff --git a/src/site_engine/builtin/fragments/section/fragment.yaml b/src/site_engine/builtin/fragments/content/section/fragment.yaml similarity index 97% rename from src/site_engine/builtin/fragments/section/fragment.yaml rename to src/site_engine/builtin/fragments/content/section/fragment.yaml index fd90e14..d8821c4 100644 --- a/src/site_engine/builtin/fragments/section/fragment.yaml +++ b/src/site_engine/builtin/fragments/content/section/fragment.yaml @@ -1,6 +1,6 @@ id: section name: Текстовая секция -category: Контент +category: content version: 1 fields: - key: title diff --git a/src/site_engine/builtin/fragments/content/section/style.css b/src/site_engine/builtin/fragments/content/section/style.css new file mode 100644 index 0000000..6c939e9 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/section/style.css @@ -0,0 +1,3 @@ +/* Site Studio source styles + engine schema extensions. */ + +.f-section--primary{background:var(--color-primary);color:var(--primary-text)}.f-section--primary p{color:inherit}.f-section--narrow .f-section__text{max-width:740px}.f-section .f-steps,.f-section .f-richtext{padding-block:0} diff --git a/src/site_engine/builtin/fragments/content/section/template.html.j2 b/src/site_engine/builtin/fragments/content/section/template.html.j2 new file mode 100644 index 0000000..dffffc3 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/section/template.html.j2 @@ -0,0 +1 @@ +
    {% if props.title %}

    {{ props.title }}

    {% endif %}{% if props.text %}
    {{ props.text|md }}
    {% endif %}{{ slots.content }}
    diff --git a/src/site_engine/builtin/fragments/content/steps/fragment.yaml b/src/site_engine/builtin/fragments/content/steps/fragment.yaml new file mode 100644 index 0000000..474e4d1 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/steps/fragment.yaml @@ -0,0 +1,33 @@ +id: steps +name: Этапы +category: content +version: 1 +fields: +- key: title + type: text + label: Заголовок + hint: Например, «Как мы работаем». +- key: items + type: list + label: Этапы + hint: Порядок элементов задаёт последовательность и нумерацию этапов. + required: true + fields: + - key: title + type: text + label: Название этапа + required: true + - key: text + type: markdown + label: Описание этапа +slots: {} +preview: + title: Как мы работаем + items: + - title: Исследование + text: Разбираемся в задаче и ограничениях. + - title: Разработка + text: Собираем и проверяем решение. + - title: Внедрение + text: Подключаем системы и передаём документацию. +description: Три этапа реализации diff --git a/src/site_engine/builtin/fragments/content/steps/style.css b/src/site_engine/builtin/fragments/content/steps/style.css new file mode 100644 index 0000000..a0cc75d --- /dev/null +++ b/src/site_engine/builtin/fragments/content/steps/style.css @@ -0,0 +1,3 @@ +/* Site Studio source styles + engine schema extensions. */ + +.f-steps__items p{margin-bottom:0} diff --git a/src/site_engine/builtin/fragments/content/steps/template.html.j2 b/src/site_engine/builtin/fragments/content/steps/template.html.j2 new file mode 100644 index 0000000..3edf889 --- /dev/null +++ b/src/site_engine/builtin/fragments/content/steps/template.html.j2 @@ -0,0 +1,3 @@ +
    {% if props.title %}

    {{ props.title }}

    {% endif %}
      +{% for item in props.items %}
    1. {{ item.title }}{% if item.text %}

      {{ item.text|md_inline }}

      {% endif %}
    2. {% endfor %} +
    diff --git a/src/site_engine/builtin/fragments/cta_banner/style.css b/src/site_engine/builtin/fragments/cta_banner/style.css deleted file mode 100644 index 1307652..0000000 --- a/src/site_engine/builtin/fragments/cta_banner/style.css +++ /dev/null @@ -1 +0,0 @@ -.f-cta_banner { margin: 2rem 0; padding: 2.5rem 0; background: #f0f4ff; } diff --git a/src/site_engine/builtin/fragments/cta_banner/template.html.j2 b/src/site_engine/builtin/fragments/cta_banner/template.html.j2 deleted file mode 100644 index e0c748e..0000000 --- a/src/site_engine/builtin/fragments/cta_banner/template.html.j2 +++ /dev/null @@ -1,12 +0,0 @@ -
    -
    -

    {{ props.title }}

    - {% if props.text %}

    {{ props.text|md_inline }}

    {% endif %} -

    - {% if props.variant == 'contact' and site.contacts.get('telegram') %} - Написать в Telegram - {% endif %} - {% for a in props.actions %}{% if a %}{{ a.label }}{% endif %}{% endfor %} -

    -
    -
    diff --git a/src/site_engine/builtin/fragments/collection_list/fragment.yaml b/src/site_engine/builtin/fragments/data/collection_list/fragment.yaml similarity index 94% rename from src/site_engine/builtin/fragments/collection_list/fragment.yaml rename to src/site_engine/builtin/fragments/data/collection_list/fragment.yaml index 583cbb6..1f510c0 100644 --- a/src/site_engine/builtin/fragments/collection_list/fragment.yaml +++ b/src/site_engine/builtin/fragments/data/collection_list/fragment.yaml @@ -1,6 +1,6 @@ id: collection_list name: Список коллекций -category: Данные +category: data version: 1 fields: - key: title @@ -41,6 +41,9 @@ fields: type: text label: Сообщение для пустого списка hint: Текст при выборе варианта message. +- key: description + type: markdown + label: Описание списка slots: {} preview: title: Записи коллекции diff --git a/src/site_engine/builtin/fragments/data/collection_list/style.css b/src/site_engine/builtin/fragments/data/collection_list/style.css new file mode 100644 index 0000000..1ab4526 --- /dev/null +++ b/src/site_engine/builtin/fragments/data/collection_list/style.css @@ -0,0 +1,3 @@ +/* Site Studio source styles + engine schema extensions. */ + +.f-collection_list__items .card{height:100%}.f-collection_list--list .cards{grid-template-columns:1fr}.f-collection_list__cover{width:100%;aspect-ratio:16/9;object-fit:cover} diff --git a/src/site_engine/builtin/fragments/data/collection_list/template.html.j2 b/src/site_engine/builtin/fragments/data/collection_list/template.html.j2 new file mode 100644 index 0000000..2e9b1ad --- /dev/null +++ b/src/site_engine/builtin/fragments/data/collection_list/template.html.j2 @@ -0,0 +1,4 @@ +{% if props.source or props.empty == 'message' %}
    {% if props.title %}

    {{ props.title }}

    {% endif %}{% if props.description %}

    {{ props.description|md_inline }}

    {% endif %} +{% if props.source %}{% else %}

    {{ props.empty_message }}

    {% endif %}
    {% endif %} diff --git a/src/site_engine/builtin/fragments/data/entry_card/fragment.yaml b/src/site_engine/builtin/fragments/data/entry_card/fragment.yaml new file mode 100644 index 0000000..08252c9 --- /dev/null +++ b/src/site_engine/builtin/fragments/data/entry_card/fragment.yaml @@ -0,0 +1,17 @@ +id: entry_card +name: Карточка записи +description: Одна выбранная запись из любой коллекции +category: data +version: 1 +fields: +- key: title + type: text + label: Заголовок +- key: entry + type: ref + to: '*' + required: true + label: Запись + hint: Выберите collection/slug из списка опубликованных записей. +slots: {} +preview: {} diff --git a/src/site_engine/builtin/fragments/data/entry_card/style.css b/src/site_engine/builtin/fragments/data/entry_card/style.css new file mode 100644 index 0000000..425777e --- /dev/null +++ b/src/site_engine/builtin/fragments/data/entry_card/style.css @@ -0,0 +1,3 @@ +/* Site Studio source styles + engine schema extensions. */ + +.f-entry_card .standalone{max-width:440px} diff --git a/src/site_engine/builtin/fragments/data/entry_card/template.html.j2 b/src/site_engine/builtin/fragments/data/entry_card/template.html.j2 new file mode 100644 index 0000000..8f30b46 --- /dev/null +++ b/src/site_engine/builtin/fragments/data/entry_card/template.html.j2 @@ -0,0 +1 @@ +
    {% if props.title %}

    {{ props.title }}

    {% endif %}{% set item = props.entry %}{% if item %}{{ item.collection|upper }}{{ item.title }}{% if item.get('summary') %}

    {{ item.summary }}

    {% endif %}
    {% endif %}
    diff --git a/src/site_engine/builtin/fragments/entry_header/fragment.yaml b/src/site_engine/builtin/fragments/data/entry_header/fragment.yaml similarity index 53% rename from src/site_engine/builtin/fragments/entry_header/fragment.yaml rename to src/site_engine/builtin/fragments/data/entry_header/fragment.yaml index 2df009f..6d0da8e 100644 --- a/src/site_engine/builtin/fragments/entry_header/fragment.yaml +++ b/src/site_engine/builtin/fragments/data/entry_header/fragment.yaml @@ -1,6 +1,6 @@ id: entry_header name: Заголовок записи -category: Данные +category: data version: 1 fields: - key: title @@ -9,6 +9,18 @@ fields: - key: meta type: list of: text +- key: summary + type: markdown + label: Краткое описание +- key: image + type: asset + label: Обложка +- key: image_alt + type: text + label: Описание обложки +- key: eyebrow + type: text + label: Метка над заголовком slots: {} preview: title: Заголовок записи diff --git a/src/site_engine/builtin/fragments/data/entry_header/style.css b/src/site_engine/builtin/fragments/data/entry_header/style.css new file mode 100644 index 0000000..730018d --- /dev/null +++ b/src/site_engine/builtin/fragments/data/entry_header/style.css @@ -0,0 +1,8 @@ +/* Site Studio source styles + engine schema extensions. */ +.entry-intro .tag{color:var(--color-hero-tag,#c5d1e8);letter-spacing:.16em;font-size:10px;font-weight:700} +.entry-intro h1{font:var(--heading-weight,700) clamp(31px,4.2vw,54px)/1.12 var(--font-heading);letter-spacing:-.055em;max-width:720px;margin:18px 0} +.entry-cover{width:100%;max-width:850px;display:block;border-radius:var(--radius)} +.entry-intro{padding:72px 0 55px;background:var(--color-entry-surface,#1f2937);color:#fff} +.entry-intro p{max-width:660px;color:var(--color-entry-muted,#ccd4e2)} +.entry-cover{margin-top:20px} +.f-entry_header__meta{display:flex;flex-wrap:wrap;gap:12px} diff --git a/src/site_engine/builtin/fragments/data/entry_header/template.html.j2 b/src/site_engine/builtin/fragments/data/entry_header/template.html.j2 new file mode 100644 index 0000000..925bdd1 --- /dev/null +++ b/src/site_engine/builtin/fragments/data/entry_header/template.html.j2 @@ -0,0 +1 @@ +
    {% if props.eyebrow %}
    {{ props.eyebrow }}
    {% endif %}

    {{ props.title }}

    {% if props.summary %}

    {{ props.summary|md_inline }}

    {% endif %}{% if props.meta %}

    {% for m in props.meta if m %}{{ m }} {% endfor %}

    {% endif %}{% if props.image %}{{ props.image_alt or '' }}{% endif %}
    diff --git a/src/site_engine/builtin/fragments/disclaimer/style.css b/src/site_engine/builtin/fragments/disclaimer/style.css deleted file mode 100644 index 4d716d1..0000000 --- a/src/site_engine/builtin/fragments/disclaimer/style.css +++ /dev/null @@ -1,2 +0,0 @@ -.f-disclaimer { padding: .8rem 0; margin: 1rem 0; background: #fff8e1; border-left: 4px solid #f5b400; } -.f-disclaimer--info { background: #eef6ff; border-left-color: var(--color-primary, #0b5fff); } diff --git a/src/site_engine/builtin/fragments/disclaimer/template.html.j2 b/src/site_engine/builtin/fragments/disclaimer/template.html.j2 deleted file mode 100644 index a8dfedc..0000000 --- a/src/site_engine/builtin/fragments/disclaimer/template.html.j2 +++ /dev/null @@ -1,3 +0,0 @@ - diff --git a/src/site_engine/builtin/fragments/entry_header/style.css b/src/site_engine/builtin/fragments/entry_header/style.css deleted file mode 100644 index 197c713..0000000 --- a/src/site_engine/builtin/fragments/entry_header/style.css +++ /dev/null @@ -1,2 +0,0 @@ -.f-entry_header { padding: 2rem 0 .5rem; } -.f-entry_header__meta span { margin-right: .75rem; color: #666; } diff --git a/src/site_engine/builtin/fragments/entry_header/template.html.j2 b/src/site_engine/builtin/fragments/entry_header/template.html.j2 deleted file mode 100644 index e43dec2..0000000 --- a/src/site_engine/builtin/fragments/entry_header/template.html.j2 +++ /dev/null @@ -1,6 +0,0 @@ -
    -
    -

    {{ props.title }}

    - {% if props.meta %}

    {% for m in props.meta if m %}{{ m }} {% endfor %}

    {% endif %} -
    -
    diff --git a/src/site_engine/builtin/fragments/faq/style.css b/src/site_engine/builtin/fragments/faq/style.css deleted file mode 100644 index 05377a2..0000000 --- a/src/site_engine/builtin/fragments/faq/style.css +++ /dev/null @@ -1,3 +0,0 @@ -.f-faq { padding: 1.5rem 0; } -.f-faq details { border-bottom: 1px solid #e2e2e2; padding: .6rem 0; } -.f-faq summary { cursor: pointer; font-weight: 600; } diff --git a/src/site_engine/builtin/fragments/faq/template.html.j2 b/src/site_engine/builtin/fragments/faq/template.html.j2 deleted file mode 100644 index 580cb2a..0000000 --- a/src/site_engine/builtin/fragments/faq/template.html.j2 +++ /dev/null @@ -1,8 +0,0 @@ -
    -
    - {% if props.title %}

    {{ props.title }}

    {% endif %} - {% for i in props.items %} -
    {{ i.q }}
    {{ i.a|md }}
    - {% endfor %} -
    -
    diff --git a/src/site_engine/builtin/fragments/form/style.css b/src/site_engine/builtin/fragments/form/style.css deleted file mode 100644 index d80a675..0000000 --- a/src/site_engine/builtin/fragments/form/style.css +++ /dev/null @@ -1,5 +0,0 @@ -.f-form form { display: grid; gap: .8rem; max-width: 36rem; } -.f-form label { display: grid; gap: .25rem; } -.f-form input[type=text], .f-form textarea { padding: .5rem; font: inherit; } -.f-form__trap { position: absolute; left: -9999px; } -.f-form__consent { display: flex; gap: .5rem; align-items: start; } diff --git a/src/site_engine/builtin/fragments/form/template.html.j2 b/src/site_engine/builtin/fragments/form/template.html.j2 deleted file mode 100644 index 4d87e5b..0000000 --- a/src/site_engine/builtin/fragments/form/template.html.j2 +++ /dev/null @@ -1,23 +0,0 @@ -{% set f = forms.get(props.form) %} -{% if f %} -
    -
    -

    {{ f.title }}

    -
    - - - {% for field in f.fields %} - {% if field.type == 'consent' %} - - {% elif field.type == 'textarea' %} - - {% else %} - - {% endif %} - {% endfor %} - -
    -
    -
    -{% endif %} diff --git a/src/site_engine/builtin/fragments/form/fragment.yaml b/src/site_engine/builtin/fragments/forms/form/fragment.yaml similarity index 55% rename from src/site_engine/builtin/fragments/form/fragment.yaml rename to src/site_engine/builtin/fragments/forms/form/fragment.yaml index 0d805f4..d80347f 100644 --- a/src/site_engine/builtin/fragments/form/fragment.yaml +++ b/src/site_engine/builtin/fragments/forms/form/fragment.yaml @@ -1,11 +1,17 @@ id: form name: Форма -category: Конверсия +category: forms version: 1 fields: - key: form type: text required: true +- key: title + type: text + label: Заголовок +- key: description + type: markdown + label: Описание формы slots: {} preview: {} description: Поля формы по выбранной схеме diff --git a/src/site_engine/builtin/fragments/forms/form/script.js b/src/site_engine/builtin/fragments/forms/form/script.js new file mode 100644 index 0000000..a2bc917 --- /dev/null +++ b/src/site_engine/builtin/fragments/forms/form/script.js @@ -0,0 +1,24 @@ +/* Preserve input and display the actual HTTP result. The public endpoint currently returns 501. */ +document.querySelectorAll('.f-form form').forEach(form => { + form.addEventListener('submit', async event => { + event.preventDefault(); + const status = form.querySelector('[role="status"]'); + const button = form.querySelector('[type="submit"]'); + button.disabled = true; + status.textContent = 'Отправка…'; + try { + const response = await fetch(form.action, {method: 'POST', body: new FormData(form)}); + if (response.status === 501) { + status.textContent = 'Приём заявок пока не подключён (HTTP 501). Данные не сохранены.'; + } else if (!response.ok) { + status.textContent = `Не удалось отправить форму (HTTP ${response.status}). Повторите попытку позже.`; + } else { + status.textContent = 'Сервер вернул неожиданный ответ. Отправка не подтверждена.'; + } + } catch (_) { + status.textContent = 'Нет связи с сервером. Проверьте подключение и повторите попытку.'; + } finally { + button.disabled = false; + } + }); +}); diff --git a/src/site_engine/builtin/fragments/forms/form/style.css b/src/site_engine/builtin/fragments/forms/form/style.css new file mode 100644 index 0000000..2ddaba9 --- /dev/null +++ b/src/site_engine/builtin/fragments/forms/form/style.css @@ -0,0 +1,8 @@ +/* Site Studio source styles + engine schema extensions. */ +.demo-form{margin-top:20px;max-width:620px;display:grid;gap:14px} +.demo-form label{display:grid;gap:6px;font-size:12px;font-weight:600} +.demo-form :is(input,textarea){width:100%;border:1px solid var(--color-border);border-radius:var(--radius);background:white;padding:11px 12px} +.demo-form textarea{min-height:110px;resize:vertical} +.demo-form .btn{justify-self:start} +.form-feedback{font-size:11px!important;margin:0} +.f-form__trap{position:absolute;left:-10000px;width:1px;height:1px;overflow:hidden}.demo-form .f-form__consent{display:flex;flex-wrap:wrap;align-items:center}.demo-form .f-form__consent input{width:auto}.demo-form .f-form__consent a{color:var(--color-primary);text-decoration:underline} diff --git a/src/site_engine/builtin/fragments/forms/form/template.html.j2 b/src/site_engine/builtin/fragments/forms/form/template.html.j2 new file mode 100644 index 0000000..9ebaa95 --- /dev/null +++ b/src/site_engine/builtin/fragments/forms/form/template.html.j2 @@ -0,0 +1,4 @@ +{% set f = forms.get(props.form) %}{% if f %}

    {{ props.title or f.title }}

    {% if props.description %}

    {{ props.description|md_inline }}

    {% endif %}
    + +{% for field in f.fields %}{% if field.type == 'consent' %}{% elif field.type == 'textarea' %}{% else %}{% endif %}{% endfor %} +
    {% endif %} diff --git a/src/site_engine/builtin/fragments/hero/style.css b/src/site_engine/builtin/fragments/hero/style.css deleted file mode 100644 index 1d8cea1..0000000 --- a/src/site_engine/builtin/fragments/hero/style.css +++ /dev/null @@ -1,4 +0,0 @@ -.f-hero { padding: 4rem 0; } -.f-hero--dark { background: var(--color-dark, #14213d); color: #fff; } -.f-hero--dark a:not(.f-btn) { color: #fff; } -.f-hero h1 { font-size: 2.4rem; margin: 0 0 1rem; } diff --git a/src/site_engine/builtin/fragments/hero/template.html.j2 b/src/site_engine/builtin/fragments/hero/template.html.j2 deleted file mode 100644 index 3a460e5..0000000 --- a/src/site_engine/builtin/fragments/hero/template.html.j2 +++ /dev/null @@ -1,10 +0,0 @@ -
    -
    -

    {{ props.title }}

    - {% if props.subtitle %}

    {{ props.subtitle|md_inline }}

    {% endif %} - {% if props.actions %} -

    {% for a in props.actions %}{% if a %}{{ a.label }}{% endif %}{% endfor %}

    - {% endif %} - {% if props.image %}{{ props.image_alt or {% endif %} -
    -
    diff --git a/src/site_engine/builtin/fragments/image/style.css b/src/site_engine/builtin/fragments/image/style.css deleted file mode 100644 index 584151a..0000000 --- a/src/site_engine/builtin/fragments/image/style.css +++ /dev/null @@ -1 +0,0 @@ -.f-image figcaption { font-size: .85rem; color: #666; } diff --git a/src/site_engine/builtin/fragments/image/template.html.j2 b/src/site_engine/builtin/fragments/image/template.html.j2 deleted file mode 100644 index 9cde462..0000000 --- a/src/site_engine/builtin/fragments/image/template.html.j2 +++ /dev/null @@ -1,4 +0,0 @@ -
    - {{ props.alt }} - {% if props.caption %}
    {{ props.caption }}
    {% endif %} -
    diff --git a/src/site_engine/builtin/fragments/cta_banner/fragment.yaml b/src/site_engine/builtin/fragments/marketing/cta_banner/fragment.yaml similarity index 96% rename from src/site_engine/builtin/fragments/cta_banner/fragment.yaml rename to src/site_engine/builtin/fragments/marketing/cta_banner/fragment.yaml index dfce917..1c2cce8 100644 --- a/src/site_engine/builtin/fragments/cta_banner/fragment.yaml +++ b/src/site_engine/builtin/fragments/marketing/cta_banner/fragment.yaml @@ -1,6 +1,6 @@ id: cta_banner name: CTA-баннер -category: Конверсия +category: marketing version: 1 fields: - key: title diff --git a/src/site_engine/builtin/fragments/marketing/cta_banner/style.css b/src/site_engine/builtin/fragments/marketing/cta_banner/style.css new file mode 100644 index 0000000..dadb747 --- /dev/null +++ b/src/site_engine/builtin/fragments/marketing/cta_banner/style.css @@ -0,0 +1,8 @@ +/* Site Studio source styles + engine schema extensions. */ +.cta h2{font:700 30px/1.2 var(--font-heading);letter-spacing:-.045em;margin:0 0 14px} +.cta p{color:var(--color-muted)} +.cta{padding:55px 0;background:var(--cta-gradient)} +.cta h2{font-size:36px} +.cta .btn{background:var(--color-cta-button,#1d2432);color:#fff;margin-top:16px} +/* Shared section/container primitives are in base.css. */ +@media(max-width:700px){.cta h2{font-size:28px}} diff --git a/src/site_engine/builtin/fragments/marketing/cta_banner/template.html.j2 b/src/site_engine/builtin/fragments/marketing/cta_banner/template.html.j2 new file mode 100644 index 0000000..5d3bc3a --- /dev/null +++ b/src/site_engine/builtin/fragments/marketing/cta_banner/template.html.j2 @@ -0,0 +1,4 @@ +

    {{ props.title }}

    {% if props.text %}

    {{ props.text|md_inline }}

    {% endif %} +{% if props.variant == 'contact' and site.contacts.get('telegram') %}Написать в Telegram{% endif %} +{% for a in props.actions if a %}{{ a.label }}{% endfor %} +
    diff --git a/src/site_engine/builtin/fragments/hero/fragment.yaml b/src/site_engine/builtin/fragments/marketing/hero/fragment.yaml similarity index 92% rename from src/site_engine/builtin/fragments/hero/fragment.yaml rename to src/site_engine/builtin/fragments/marketing/hero/fragment.yaml index 5f2c76d..7e81e66 100644 --- a/src/site_engine/builtin/fragments/hero/fragment.yaml +++ b/src/site_engine/builtin/fragments/marketing/hero/fragment.yaml @@ -1,6 +1,6 @@ id: hero name: Hero -category: Первый экран +category: marketing version: 1 fields: - key: title @@ -33,6 +33,9 @@ fields: default: light label: Вариант оформления hint: Вариант меняет оформление; содержимое остаётся в полях блока. +- key: eyebrow + type: text + label: Метка над заголовком slots: {} preview: title: Заголовок страницы diff --git a/src/site_engine/builtin/fragments/marketing/hero/style.css b/src/site_engine/builtin/fragments/marketing/hero/style.css new file mode 100644 index 0000000..7d335be --- /dev/null +++ b/src/site_engine/builtin/fragments/marketing/hero/style.css @@ -0,0 +1,8 @@ +/* Site Studio source styles + engine schema extensions. */ +.hero{padding:85px 0 90px;background:var(--hero-gradient);color:#fff;min-height:330px} +.hero .tag{color:var(--color-hero-tag,#c5d1e8);letter-spacing:.16em;font-size:10px;font-weight:700} +.hero h1{font:var(--heading-weight,700) clamp(31px,4.2vw,54px)/1.12 var(--font-heading);letter-spacing:-.055em;max-width:720px;margin:18px 0} +.hero p{color:var(--color-hero-muted,#c5ccdc);max-width:590px;font-size:14px} +.hero .btn{margin-top:22px;background:var(--button-gradient);color:var(--color-hero-button,#242438)} +.f-hero{background:var(--color-secondary);color:var(--color-text)}.f-hero--dark{background:var(--hero-background);color:var(--color-hero-ink,#fff)}.f-hero:not(.f-hero--dark) :is(p,.tag){color:var(--color-muted)}.f-hero--split .container{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:20px}.f-hero--split img{grid-column:2;grid-row:1 / span 4}.hero .f-btn--secondary{background:transparent;color:inherit}.hero .btn{background:var(--button-background);color:var(--color-hero-button,var(--button-text))}@media(max-width:700px){.f-hero--split .container{display:block}} +@media(max-width:700px){.hero{padding:56px 0}} diff --git a/src/site_engine/builtin/fragments/marketing/hero/template.html.j2 b/src/site_engine/builtin/fragments/marketing/hero/template.html.j2 new file mode 100644 index 0000000..85eba5d --- /dev/null +++ b/src/site_engine/builtin/fragments/marketing/hero/template.html.j2 @@ -0,0 +1,6 @@ +
    +{% if props.eyebrow %}
    {{ props.eyebrow }}
    {% endif %} +

    {{ props.title }}

    {% if props.subtitle %}

    {{ props.subtitle|md_inline }}

    {% endif %} +{% for a in props.actions if a %}{{ a.label }}{% endfor %} +{% if props.image %}{{ props.image_alt or '' }}{% endif %} +
    diff --git a/src/site_engine/builtin/fragments/page_header/fragment.yaml b/src/site_engine/builtin/fragments/marketing/page_header/fragment.yaml similarity index 95% rename from src/site_engine/builtin/fragments/page_header/fragment.yaml rename to src/site_engine/builtin/fragments/marketing/page_header/fragment.yaml index d0d5a9e..6a471a5 100644 --- a/src/site_engine/builtin/fragments/page_header/fragment.yaml +++ b/src/site_engine/builtin/fragments/marketing/page_header/fragment.yaml @@ -1,6 +1,6 @@ id: page_header name: Заголовок страницы -category: Первый экран +category: marketing version: 1 fields: - key: title diff --git a/src/site_engine/builtin/fragments/page_header/style.css b/src/site_engine/builtin/fragments/marketing/page_header/style.css similarity index 82% rename from src/site_engine/builtin/fragments/page_header/style.css rename to src/site_engine/builtin/fragments/marketing/page_header/style.css index 686961a..883c26a 100644 --- a/src/site_engine/builtin/fragments/page_header/style.css +++ b/src/site_engine/builtin/fragments/marketing/page_header/style.css @@ -1,3 +1,3 @@ .f-page_header { padding: 2rem 0 1rem; } .f-page_header__crumbs { display: flex; gap: .5rem; list-style: none; padding: 0; margin: 0 0 .5rem; font-size: .9rem; } -.f-page_header__crumbs li + li::before { content: '/'; margin-right: .5rem; color: #888; } +.f-page_header__crumbs li + li::before { content: '/'; margin-right: .5rem; color: var(--color-muted, #888); } diff --git a/src/site_engine/builtin/fragments/page_header/template.html.j2 b/src/site_engine/builtin/fragments/marketing/page_header/template.html.j2 similarity index 93% rename from src/site_engine/builtin/fragments/page_header/template.html.j2 rename to src/site_engine/builtin/fragments/marketing/page_header/template.html.j2 index a328184..710f603 100644 --- a/src/site_engine/builtin/fragments/page_header/template.html.j2 +++ b/src/site_engine/builtin/fragments/marketing/page_header/template.html.j2 @@ -1,4 +1,4 @@ -
    +
    {% if props.breadcrumbs and breadcrumbs|length > 1 %}
    {% if conflict %}{% endif %} - diff --git a/src/site_engine/web/admin/templates/shell.html.j2 b/src/site_engine/web/admin/templates/shell.html.j2 index ec1a579..2d98c20 100644 --- a/src/site_engine/web/admin/templates/shell.html.j2 +++ b/src/site_engine/web/admin/templates/shell.html.j2 @@ -17,7 +17,8 @@ {% endfor %} - {% for glyph, label in [('structure','Структура'),('forms','Формы и заявки'),('settings','Настройки'),('journal','Журнал')] %}{% endfor %} + {{ icon('settings') }}Дизайн сайта + {% for glyph, label in [('structure','Структура'),('forms','Формы и заявки'),('journal','Журнал')] %}{% endfor %} @@ -25,7 +26,7 @@
    -
    {{ site_host }}/{{ {'dashboard':'Обзор','pages':'Страницы','content':'Контент','publish':'Публикация'}.get(section, 'Сообщение') }}
    +
    {{ site_host }}/{{ {'dashboard':'Обзор','pages':'Страницы','content':'Контент','publish':'Публикация','theme':'Настройки / Дизайн сайта'}.get(section, 'Сообщение') }}
    {% if nav.get('current') %}LIVE {{ nav.current|replace('build_', 'r') }}{% else %}НЕТ РЕЛИЗА{% endif %} diff --git a/src/site_engine/web/admin/templates/theme.html.j2 b/src/site_engine/web/admin/templates/theme.html.j2 new file mode 100644 index 0000000..8a7fe94 --- /dev/null +++ b/src/site_engine/web/admin/templates/theme.html.j2 @@ -0,0 +1,14 @@ +{% extends 'shell.html.j2' %} +{% block title %}Дизайн публичного сайта — Site Engine{% endblock %} +{% block styles %}{% endblock %} +{% block bodyattrs %}{% endblock %} +{% block contentclass %}design-content theme-content{% endblock %} +{% block content %} +
    + +
    +
    +
    +
    + +{% endblock %} diff --git a/src/site_engine/web/admin/templates/theme_sample.html.j2 b/src/site_engine/web/admin/templates/theme_sample.html.j2 new file mode 100644 index 0000000..37d21ff --- /dev/null +++ b/src/site_engine/web/admin/templates/theme_sample.html.j2 @@ -0,0 +1 @@ +Стенд темы
    ● AI / AUTOMATION / DEVELOPMENT

    Автоматизация,
    которая работает.

    Разрабатываем AI-системы, чат-ботов и цифровые продукты для вашего бизнеса.

    Обсудить проектПосмотреть кейсы
    01 / AI-ассистенты

    Клиентский сервис и продажи

    02 / Telegram-боты

    Коммуникации и процессы

    03 / Веб-разработка

    Сайты и CRM-системы

    © Studio · 2026Создано в Site Engine
    \ No newline at end of file diff --git a/src/site_engine/web/api/models.py b/src/site_engine/web/api/models.py index 7a493d7..1fe9502 100644 --- a/src/site_engine/web/api/models.py +++ b/src/site_engine/web/api/models.py @@ -3,6 +3,7 @@ from typing import Annotated, Any, Literal from pydantic import BaseModel, ConfigDict, Field, model_validator +from typing_extensions import TypedDict class DTO(BaseModel): @@ -49,10 +50,25 @@ class EntryFields(DTO): status: Literal["draft", "published", "archived"] | None = None +class BlockLayoutDTO(DTO): + section_width: Literal["inherit", "boxed", "fluid", "full"] = "inherit" + content_width: Literal["inherit", "boxed", "fluid", "full"] = "inherit" + + +class BlockValues(TypedDict, total=False): + __pydantic_config__ = ConfigDict(extra="forbid") + props: dict[str, Any] + hidden: bool + anchor: str | None + note: str | None + requires: list[str] + layout: BlockLayoutDTO + + class BlockAction(DTO): type: Literal["block", "delete", "toggle", "duplicate"] block_id: str - values: dict[str, Any] = Field(default_factory=dict) + values: BlockValues = Field(default_factory=dict) class Add(DTO): @@ -91,6 +107,50 @@ class Create(DTO): layout: str | None = None +class ThemeDiagnostics(DTO): + diagnostics: list[IssueDTO] = Field(default_factory=list) + + +class ThemeSnapshot(ThemeDiagnostics): + document: dict[str, Any] + etag: str + effective_tokens: dict[str, Any] | None + workspace_revision: str + live_build_id: str | None + revision: int = 0 + path: str + yaml: str + css: str + contrast: float | None + + +class ThemePreviewRequest(DTO): + document: dict[str, Any] + revision: int = Field(default=0, ge=0) + target: Literal["sample", "page"] = "sample" + page_id: str = Field(default="", max_length=200) + device: Literal["desktop", "phone"] = "desktop" + viewport_width: int = Field(default=1440, ge=320, le=3840, strict=True) + + +class ThemeUpdate(DTO): + document: dict[str, Any] + if_match: str = Field(min_length=1, max_length=80) + revision: int = Field(default=0, ge=0) + + +class ThemePresets(DTO): + presets: dict[str, Any] + fonts: dict[str, Any] + allowed_fonts: list[list[str]] + + +class OnboardingState(DTO): + status: Literal["new", "existing", "in_progress", "skipped", "completed"] + needs_setup: bool + can_manage: bool + + class ErrorBody(DTO): code: str message: str @@ -100,8 +160,8 @@ class ErrorBody(DTO): base_etag: str | None = None issues: list[IssueDTO] = Field(default_factory=list) submitted: Buffer | None = None - current: Snapshot | None = None - committed: Snapshot | None = None + current: Snapshot | ThemeSnapshot | None = None + committed: Snapshot | ThemeSnapshot | None = None buffer: Snapshot | None = None diff --git a/src/site_engine/web/api/routes.py b/src/site_engine/web/api/routes.py index 1cd1daa..9f093b6 100644 --- a/src/site_engine/web/api/routes.py +++ b/src/site_engine/web/api/routes.py @@ -16,6 +16,7 @@ from ...services.entries import EntryService from ...services.pages import PageService from ...services.preview import asset_path from ...services.publish import publish, rollback +from ...services.theme import OnboardingService, ThemeCommitError, ThemeService from ...services.workspace import entries, filter_pages, releases, workspace from ...storage.locks import SiteLock from ..error_handling import error_response, log, request_id @@ -25,11 +26,16 @@ from .models import ( Create, Entries, ErrorEnvelope, + OnboardingState, PageRow, Preview, Releases, Rollback, Snapshot, + ThemePresets, + ThemePreviewRequest, + ThemeSnapshot, + ThemeUpdate, Transform, Workspace, snapshot_dto, @@ -76,6 +82,9 @@ def install_api(app, auth, root, dist, previews): else EntryService(root, auth.audit, collection) ) + def themes(): + return ThemeService(root, dist, auth.state_dir, auth.audit) + def error(status, code, message, **extra): buffer = extra.get("submitted") or extra.get("buffer") or {} details = { @@ -125,6 +134,81 @@ def install_api(app, auth, root, dist, previews): except (ValueError, KeyError) as exc: return error(422, "invalid_operation", exc) + def theme_invoke(fn): + try: + return fn() + except ConflictError as exc: + return error(409, "conflict", exc, current=themes().get()) + except ThemeCommitError as exc: + log.exception("theme_after_commit request_id=%s", request_id()) + return error(500, "theme_after_commit", exc, committed=exc.snapshot) + except (EngineError, ValueError) as exc: + if isinstance(exc, UnsafePathError): + return error(403, "forbidden", exc) + return error( + 422, + "validation", + exc, + issues=[i.to_dict() for i in exc.report.issues] + if isinstance(exc, EngineError) + else [], + ) + + @router.get("/theme", response_model=ThemeSnapshot) + def theme_get(): + return theme_invoke(lambda: themes().get()) + + @router.get("/theme/presets", response_model=ThemePresets) + def theme_presets(): + return themes().list_presets() + + @router.patch("/theme", response_model=ThemeSnapshot) + def theme_save(body: ThemeUpdate, ctx: Ctx): + return theme_invoke(lambda: themes().save(body.document, body.if_match, ctx, body.revision)) + + @router.post("/theme/validate", response_model=ThemeSnapshot) + def theme_validate(body: ThemePreviewRequest): + def run(): + snapshot = themes().validate(body.document, body.revision) + if any(i["severity"] == "error" for i in snapshot["diagnostics"]): + return error( + 422, + "validation", + "Исправьте ошибки темы", + issues=snapshot["diagnostics"], + revision=body.revision, + ) + return snapshot + + return theme_invoke(run) + + @router.post("/theme/preview", response_model=Preview) + def theme_preview(body: ThemePreviewRequest, ctx: Ctx): + return theme_invoke( + lambda: previews.render_theme( + themes(), + body.document, + body.revision, + ctx.principal, + body.target, + body.page_id, + body.device, + body.viewport_width, + ) + ) + + @router.get("/theme/onboarding", response_model=OnboardingState) + def theme_onboarding(): + return theme_invoke(lambda: OnboardingService(themes()).status()) + + @router.post("/theme/onboarding/skip", response_model=OnboardingState) + def theme_skip(): + return theme_invoke(lambda: OnboardingService(themes()).skip()) + + @router.post("/theme/onboarding/restart", response_model=OnboardingState) + def theme_restart(): + return theme_invoke(lambda: OnboardingService(themes()).restart()) + @router.get("/site", response_model=Workspace) def site(): return invoke(lambda: workspace(root, dist, auth.state_dir)) @@ -267,7 +351,7 @@ def install_api(app, auth, root, dist, previews): 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 + *args, body.action.model_dump(exclude_unset=True), body.revision ) else: result = svc.validate_source(*args, body.revision) diff --git a/tests/test_block_layout.py b/tests/test_block_layout.py new file mode 100644 index 0000000..8acc6c9 --- /dev/null +++ b/tests/test_block_layout.py @@ -0,0 +1,232 @@ +"""Width contract through parsing, document operations and real HTTP boundaries.""" + +import os +import tempfile +import unittest +from dataclasses import asdict +from html.parser import HTMLParser +from pathlib import Path +from unittest.mock import patch + +from fastapi.testclient import TestClient +from test_fragment_catalog_ui import environment +from theme_fixture import seed, write + +from site_engine.build.pipeline import build_site, make_views +from site_engine.core.block_layout import BlockLayout, default_layout +from site_engine.core.layout_marks import apply_layout +from site_engine.core.models import parse_block +from site_engine.core.page_ops import find_block +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.core.validate import validate_workspace +from site_engine.errors import Report +from site_engine.parsing.yamlio import dump_yaml +from site_engine.services.auth import hash_password +from site_engine.services.documents import DocumentService, EditorContext + + +class Elements(HTMLParser): + def __init__(self, html): + super().__init__() + self.items = [] + self.feed(html) + + def handle_starttag(self, tag, attrs): + self.items.append((tag, dict(attrs))) + + +class BlockLayoutTest(unittest.TestCase): + def test_strict_shapes_modes_and_unknown_keys(self): + for raw in (None, False, [], "full", {"width": "boxed"}, {"section_width": []}, + {"section_width": "wide"}, {"content_width": 1080}, {"content_width": None}): + with self.subTest(layout=raw): + report = Report() + block = parse_block({"id": "test_block", "fragment": "hero", "layout": raw}, "test", report) + self.assertIsNone(block) + self.assertIn("E_BLOCK_LAYOUT", report.codes()) + self.assertTrue(all(".layout" in i.path for i in report.errors)) + + def test_all_modes_defaults_and_explicit_inheritance(self): + for fragment in ("hero", "cta_banner", "site_header", "site_footer", "richtext", "columns"): + block = parse_block({"id": "test_block", "fragment": fragment}, "test", Report()) + self.assertIsNone(block.layout) + expected = "full" if fragment in ("hero", "cta_banner", "site_header", "site_footer") else "inherit" + self.assertEqual(default_layout(fragment).section_width, expected) + for section in ("inherit", "boxed", "fluid", "full"): + for content in ("inherit", "boxed", "fluid", "full"): + report = Report() + block = parse_block({"id": "test_block", "fragment": "hero", "layout": {"section_width": section, "content_width": content}}, "test", report) + self.assertTrue(report.ok) + effective = block.layout.resolve("fluid") + self.assertEqual(effective.section_width, "fluid" if section == "inherit" else section) + self.assertEqual(effective.content_width, "fluid" if content == "inherit" else content) + + def test_layout_marks_do_not_change_roots_or_overwrite_nested_block_containers(self): + child = apply_layout('
    ', BlockLayout("boxed", "fluid")) + source = '
    ' + child + '
    ' + html = apply_layout(source, BlockLayout("full", "boxed")) + self.assertEqual(html.count("{{ props.title }}
    ") + return manifest + + def sidecar(self, manifest, raw): + self.write(manifest.with_name("preview.yaml"), dump_yaml(raw)) + + def load(self): + return load_site(self.site, builtin_dir=self.builtin) + + def assert_issues(self, reg, expected): + self.assertEqual([(i.code, i.path) for i in reg.report.issues], expected) + + def test_flat_discovery_keeps_yaml_category_and_misc(self): + self.fragment("folder", "flat", category="Legacy category") + self.fragment("no_category", "uncategorized") + self.fragment("", "root_fragment") + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + self.assertEqual( + {fid: f.category for fid, f in reg.fragments.items()}, + {"flat": "Legacy category", "uncategorized": "misc", "root_fragment": "misc"}, + ) + + def test_categorized_discovery_uses_first_arbitrary_folder(self): + self.fragment("Произвольная категория/card", "one", category="Ignored") + self.fragment("Second category/another", "two") + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + self.assertEqual(reg.fragments["one"].category, "Произвольная категория") + self.assertEqual(reg.fragments["two"].category, "Second category") + + def test_mixed_and_deeper_discovery_keeps_manifest_ids_and_assets(self): + self.fragment("flat", "legacy", category="Old") + manifest = self.fragment("marketing/subgroup/deeper/folder", "different_id") + self.write(manifest.with_name("style.css"), ".sample { color: red; }") + self.write(manifest.with_name("script.js"), "// sample script") + self.fragment("marketing/other", "other") + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + self.assertEqual(set(reg.fragments), {"legacy", "different_id", "other"}) + fragment = reg.fragments["different_id"] + self.assertEqual(fragment.category, "marketing") + self.assertEqual(fragment.dir, manifest.parent) + self.assertEqual(fragment.style, ".sample { color: red; }") + self.assertEqual(fragment.script, "// sample script") + self.assertIn("props.title", fragment.template) + self.assertFalse(fragment.builtin) + + def test_builtin_and_site_have_same_category_rules(self): + self.fragment("flat", "builtin_flat", builtin=True, category="Original") + self.fragment("New/deeper/folder", "builtin_nested", builtin=True, category="Old") + self.fragment("New/site", "site_nested", category="Old") + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + self.assertEqual(reg.fragments["builtin_flat"].category, "Original") + self.assertEqual(reg.fragments["builtin_nested"].category, "New") + self.assertEqual(reg.fragments["site_nested"].category, "New") + self.assertTrue(reg.fragments["builtin_nested"].builtin) + self.assertFalse(reg.fragments["site_nested"].builtin) + + def test_duplicate_ids_across_directories_are_errors(self): + first = self.fragment("A/one", "duplicate") + self.fragment("B/deeper/two", "duplicate") + reg = self.load() + self.assertEqual(reg.fragments["duplicate"].dir, first.parent) + self.assert_issues(reg, [("E_FRAGMENT_DUP", "fragments/B/deeper/two/fragment.yaml")]) + + def test_site_cannot_shadow_builtin_id_in_another_directory(self): + first = self.fragment("Builtin/deeper/folder", "duplicate", builtin=True) + self.fragment("Site/another", "duplicate") + reg = self.load() + self.assertEqual(reg.fragments["duplicate"].dir, first.parent) + self.assertTrue(reg.fragments["duplicate"].builtin) + self.assert_issues(reg, [("E_FRAGMENT_DUP", "fragments/Site/another/fragment.yaml")]) + + def test_duplicate_ids_between_builtin_directories_are_errors(self): + self.fragment("A/one", "duplicate", builtin=True) + self.fragment("B/two", "duplicate", builtin=True) + self.assert_issues(self.load(), [("E_FRAGMENT_DUP", "builtin/B/two/fragment.yaml")]) + + def test_only_manifests_are_discovered_but_malformed_ones_are_reported(self): + self.write(self.site / "fragments/unused/preview.yaml", "props: {}\n") + self.write(self.site / "fragments/unused/template.html.j2", "

    Unused

    ") + malformed = { + "empty": "", + "null": "null\n", + "scalar": "false\n", + "list": "- item\n", + "no_id": "name: Missing ID\n", + "yaml": "id: [\n", + } + for name, text in malformed.items(): + self.write(self.site / f"fragments/category/{name}/fragment.yaml", text) + reg = self.load() + self.assertEqual(reg.fragments, {}) + expected = { + ("E_FRAGMENT_ID" if name == "no_id" else + "E_YAML" if name == "yaml" else "E_FRAGMENT_SHAPE", + f"fragments/category/{name}/fragment.yaml") + for name in malformed + } + self.assertEqual({(i.code, i.path) for i in reg.report.issues}, expected) + self.assertEqual(len(reg.report.issues), len(malformed)) + + def test_missing_template_reports_discovered_nested_manifest(self): + manifest = self.fragment("Category/group/item") + manifest.with_name("template.html.j2").unlink() + self.assert_issues(self.load(), [ + ("E_FRAGMENT_TEMPLATE", "fragments/Category/group/item/fragment.yaml"), + ]) + + def test_inline_preview_compatibility_and_defaults_are_not_materialized(self): + self.fragment("flat", fields=[ + {"key": "title", "type": "text", "required": True}, + {"key": "variant", "type": "select", "options": ["light", "dark"], + "default": "light"}, + ], preview={"title": "Inline"}) + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + fragment = reg.fragments["sample"] + self.assertEqual(fragment.preview, {"title": "Inline"}) + self.assertEqual(fragment.fields[1].default, "light") + + def test_sidecar_merge_is_per_prop_and_name_does_not_rename_fragment(self): + manifest = self.fragment("Category/item", fields=[ + {"key": "title", "type": "text"}, + {"key": "keep", "type": "text"}, + {"key": "name", "type": "text"}, + {"key": "settings", "type": "group", "fields": [ + {"key": "a", "type": "number"}, {"key": "b", "type": "number"}, + ]}, + {"key": "enabled", "type": "boolean", "default": True}, + ], preview={"title": "Inline", "keep": "Kept", "settings": {"a": 1, "b": 2}}) + self.sidecar(manifest, {"name": "Preview label", "props": { + "title": "Sidecar", "name": "Name prop", "settings": {"a": 3}, "enabled": False, + }}) + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + fragment = reg.fragments["sample"] + self.assertEqual(fragment.name, "Catalog name") + self.assertEqual(fragment.preview, { + "title": "Sidecar", "keep": "Kept", "name": "Name prop", + "settings": {"a": 3}, "enabled": False, + }) + self.assertNotIn("props", fragment.preview) + self.assertTrue(fragment.fields[-1].default) + + def test_sidecar_without_name_or_inline_preview_for_builtin_and_site(self): + for builtin, fid in ((True, "builtin_sample"), (False, "site_sample")): + manifest = self.fragment("Category/item", fid, builtin=builtin, + fields=[{"key": "title", "type": "text"}]) + self.sidecar(manifest, {"props": {"title": fid}}) + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + for fid in ("builtin_sample", "site_sample"): + self.assertEqual(reg.fragments[fid].preview, {"title": fid}) + self.assertEqual(reg.fragments[fid].name, "Catalog name") + + def test_invalid_inline_preview_is_diagnosed_and_normalized_by_parser(self): + manifest = self.fragment("item") + for bad in (None, False, 0, "", "text", [], ["title"]): + with self.subTest(preview=bad): + report = Report() + fragment = parse_fragment({"id": "sample", "preview": bad}, + "fragments/item/fragment.yaml", manifest.parent, + False, report) + self.assertIsNotNone(fragment) + self.assertEqual(fragment.preview, {}) + self.assertEqual(fragment.preview.get("title"), None) + self.assertEqual([(i.code, i.path) for i in report.issues], [ + ("E_FRAGMENT_PREVIEW", "fragments/item/fragment.yaml:preview"), + ]) + + def test_invalid_inline_does_not_prevent_valid_sidecar_loading(self): + manifest = self.fragment("item", preview=["bad"], + fields=[{"key": "title", "type": "text"}]) + self.sidecar(manifest, {"props": {"title": "Valid"}}) + reg = self.load() + self.assertEqual(reg.fragments["sample"].preview, {"title": "Valid"}) + self.assert_issues(reg, [("E_FRAGMENT_PREVIEW", "fragments/item/fragment.yaml:preview")]) + + def test_invalid_sidecar_envelope_and_props_shapes(self): + manifest = self.fragment("Category/deeper/item", preview={"title": "Inline"}, + fields=[{"key": "title", "type": "text"}]) + rel = "fragments/Category/deeper/item/preview.yaml" + cases = [(None, rel), (False, rel), ("text", rel), ([], rel), + ({}, rel + ":props"), ({"name": "Only a label"}, rel + ":props")] + cases += [({"props": bad}, rel + ":props") + for bad in (None, False, 0, "", "text", [], ["item"])] + for raw, path in cases: + with self.subTest(raw=raw): + self.sidecar(manifest, raw) + reg = self.load() + self.assertEqual(reg.fragments["sample"].preview, {"title": "Inline"}) + self.assert_issues(reg, [("E_FRAGMENT_PREVIEW", path)]) + + def test_sidecar_name_and_unknown_keys_have_precise_paths(self): + manifest = self.fragment("item") + for name in (None, False, 12, [], {}): + with self.subTest(name=name): + self.sidecar(manifest, {"name": name, "props": {}}) + self.assert_issues(self.load(), [ + ("E_FRAGMENT_PREVIEW", "fragments/item/preview.yaml:name"), + ]) + self.sidecar(manifest, {"props": {}, "unknown": True}) + self.assert_issues(self.load(), [ + ("E_FRAGMENT_PREVIEW", "fragments/item/preview.yaml:unknown"), + ]) + + def test_sidecar_yaml_errors_use_existing_yaml_diagnostics(self): + manifest = self.fragment("Group/item", builtin=True, + fields=[{"key": "title", "type": "text"}], + preview={"title": "Inline"}) + for text in ("props: [\n", "props: {}\nprops: {}\n", "props: &x {}\nname: *x\n", ""): + with self.subTest(text=text): + self.write(manifest.with_name("preview.yaml"), text) + reg = self.load() + self.assertEqual(reg.fragments["sample"].preview, {"title": "Inline"}) + self.assert_issues(reg, [ + ("E_FRAGMENT_PREVIEW" if text == "" else "E_YAML", + "builtin/Group/item/preview.yaml"), + ]) + + def test_sidecar_read_errors_are_reported_without_swallowing_them(self): + manifest = self.fragment("item") + sidecar = manifest.with_name("preview.yaml") + self.sidecar(manifest, {"props": {}}) + read_text = Path.read_text + + def unreadable(path, *args, **kwargs): + if path == sidecar: + raise PermissionError("test read denied") + return read_text(path, *args, **kwargs) + + with patch.object(Path, "read_text", unreadable): + reg = self.load() + self.assert_issues(reg, [("E_YAML", "fragments/item/preview.yaml")]) + self.assertIn("test read denied", reg.report.issues[0].message) + self.assertEqual(reg.fragments["sample"].preview, {}) + sidecar.write_bytes(b"props: \xff") + self.assert_issues(self.load(), [("E_YAML", "fragments/item/preview.yaml")]) + + def test_preview_values_accept_core_types_without_resolving_references(self): + fields, props = [], {} + examples = { + "text": "Title", "textarea": "Paragraph", "markdown": "**Text**", + "slug": "a-slug", "color": "#fff", "icon": "star", "asset": "/missing.png", + "number": 2.5, "boolean": False, "date": "2026-11-13", + "datetime": "2026-11-13T10:00:00Z", "select": "one", "multiselect": ["one"], + "ref": "missing-entry", "refs": ["missing-entry"], + "link": {"page": "missing-page"}, + "query": {"query": {"collection": "missing-collection", "limit": 2}}, + "json": {"anything": [1, False]}, + } + for kind, value in examples.items(): + field = {"key": kind, "type": kind} + if kind in ("select", "multiselect"): + field["options"] = ["one", "two"] + if kind in ("ref", "refs"): + field["to"] = "missing-collection" + fields.append(field) + props[kind] = value + fields += [ + {"key": "group", "type": "group", "fields": [{"key": "x", "type": "number"}]}, + {"key": "list", "type": "list", "fields": [{"key": "x", "type": "boolean"}]}, + {"key": "strings", "type": "list", "of": "text"}, + {"key": "binding", "type": "text"}, + {"key": "omitted_required", "type": "text", "required": True}, + ] + props.update(group={"x": 1}, list=[{"x": True}], strings=["a", "b"], + binding={"bind": "entry.missing"}) + for source in ("inline", "sidecar"): + with self.subTest(source=source): + manifest = self.fragment("item", fields=fields, + **({"preview": props} if source == "inline" else {})) + if source == "sidecar": + self.sidecar(manifest, {"props": props}) + reg = self.load() + self.assertTrue(reg.report.ok, reg.report.issues) + self.assertEqual(reg.fragments["sample"].preview, props) + + def test_invalid_preview_values_use_core_schema_paths_for_both_sources(self): + cases = [ + ({"type": "text"}, 12, "", "E_TYPE"), + ({"type": "number"}, True, "", "E_TYPE"), + ({"type": "boolean"}, "true", "", "E_TYPE"), + ({"type": "select", "options": ["a", "b"]}, "c", "", "E_SELECT_VALUE"), + ({"type": "multiselect", "options": ["a"]}, ["b"], "", "E_SELECT_VALUE"), + ({"type": "date"}, 5, "", "E_TYPE"), + ({"type": "datetime"}, [], "", "E_TYPE"), + ({"type": "ref", "to": "missing"}, 12, "", "E_TYPE"), + ({"type": "refs", "to": "missing"}, [1], "", "E_TYPE"), + ({"type": "query"}, {"collection": "missing"}, "", "E_VALUE_SHAPE"), + ({"type": "link"}, {"page": 12}, "", "E_VALUE_SHAPE"), + ({"type": "text"}, {"bind": "unknown.x"}, "", "E_VALUE_SHAPE"), + ({"type": "text"}, "{{ page.title }}", "", "E_TEMPLATE_IN_DATA"), + ({"type": "group", "fields": [{"key": "n", "type": "number"}]}, + {"n": "bad"}, ".n", "E_TYPE"), + ({"type": "group", "fields": [{"key": "n", "type": "number"}]}, + {"unknown": 1}, ".unknown", "E_PROP_UNKNOWN"), + ({"type": "list", "of": "number"}, [1, "bad"], "[1]", "E_TYPE"), + ({"type": "list", "fields": [{"key": "flag", "type": "boolean"}]}, + [{"flag": "bad"}], "[0].flag", "E_TYPE"), + ] + for source in ("inline", "sidecar"): + for schema, value, suffix, code in cases: + with self.subTest(source=source, schema=schema, value=value): + manifest = self.fragment("item", fields=[{"key": "value", **schema}], + **({"preview": {"value": value}} + if source == "inline" else {})) + sidecar = manifest.with_name("preview.yaml") + if source == "inline": + sidecar.unlink(missing_ok=True) + else: + self.sidecar(manifest, {"props": {"value": value}}) + reg = self.load() + prefix = ("fragment.yaml:preview" if source == "inline" + else "preview.yaml:props") + self.assert_issues(reg, [(code, f"fragments/item/{prefix}.value{suffix}")]) + + def test_unknown_preview_props_are_diagnosed(self): + manifest = self.fragment("item", preview={"unknown_inline": True}) + self.sidecar(manifest, {"props": {"unknown_sidecar": True}}) + self.assert_issues(self.load(), [ + ("E_PROP_UNKNOWN", "fragments/item/fragment.yaml:preview.unknown_inline"), + ("E_PROP_UNKNOWN", "fragments/item/preview.yaml:props.unknown_sidecar"), + ]) + + def test_invalid_inline_value_is_reported_even_if_sidecar_overrides_it(self): + manifest = self.fragment("item", fields=[{"key": "title", "type": "text"}], + preview={"title": 42}) + self.sidecar(manifest, {"props": {"title": "Override"}}) + reg = self.load() + self.assertEqual(reg.fragments["sample"].preview, {"title": "Override"}) + self.assert_issues(reg, [("E_TYPE", "fragments/item/fragment.yaml:preview.title")]) + + def test_shipped_builtins_still_load_with_valid_flat_previews(self): + reg = load_site(self.site, builtin_dir=BUILTIN_DIR) + self.assertTrue(reg.report.ok, reg.report.issues) + self.assertEqual(len(reg.fragments), len(list((BUILTIN_DIR / "fragments").rglob("fragment.yaml")))) + self.assertTrue(reg.fragments) + for fragment in reg.fragments.values(): + self.assertTrue(fragment.builtin) + self.assertIsInstance(fragment.preview, dict) + + +if __name__ == "__main__": + unittest.main() diff --git a/tests/test_fragment_catalog_ui.py b/tests/test_fragment_catalog_ui.py new file mode 100644 index 0000000..7d48036 --- /dev/null +++ b/tests/test_fragment_catalog_ui.py @@ -0,0 +1,411 @@ +"""Stage 1: real login -> HTML adapter -> API, with an independent file fixture. + +Run: PYTHONPATH=src python -m unittest discover -s tests -p test_fragment_catalog_ui.py -v +The browser acceptance script reuses only the disposable fixture helpers below. +""" + +from __future__ import annotations + +import os +import tempfile +import unittest +from html.parser import HTMLParser +from pathlib import Path +from unittest.mock import patch + +from fastapi.testclient import TestClient + +from site_engine.build.pipeline import build_site +from site_engine.core.registry import load_site +from site_engine.parsing import frontmatter +from site_engine.parsing.yamlio import dump_yaml +from site_engine.services.auth import hash_password +from site_engine.web.app import create_app + +LABELS = { + "content": "Контент", "data": "Данные", "forms": "Формы", + "marketing": "Маркетинг", "media": "Медиа", "system": "Системные", "misc": "Прочее", +} +ALIASES = { + "Контент": "content", "Компоновка": "content", "Данные": "data", + "Первый экран": "marketing", "Конверсия": "marketing", "Медиа": "media", "Каркас": "system", + "Формы": "forms", "Маркетинг": "marketing", "Системные": "system", "Прочее": "misc", +} +PREVIEW = {"title": "Sidecar heading", "note": "Inline retained", "count": 0, "enabled": False} +PAGE_ID = "catalog-check" +NESTED_DIR = "fragments/marketing/deeper/qa_nested" + + +def write(site: Path, relative: str, text: str) -> None: + path = site / relative + path.parent.mkdir(parents=True, exist_ok=True) + path.write_text(text, encoding="utf-8") + + +def seed_catalog(site: Path) -> dict[str, tuple[str, str]]: + """Add local nested + legacy-flat fragments, aliases and restricted targets.""" + expected = {} + for index, (raw, group) in enumerate([*[(x, x) for x in LABELS], *ALIASES.items()]): + fid = f"qa_category_{index}" + write(site, f"fragments/{fid}/fragment.yaml", dump_yaml({ + "id": fid, "name": f"Category probe {index}", "category": raw, + "description": f"Category description {index}", "fields": [], "slots": {}, + })) + write(site, f"fragments/{fid}/template.html.j2", "

    Category probe

    ") + expected[fid] = (raw, group) + write(site, f"{NESTED_DIR}/fragment.yaml", dump_yaml({ + "id": "qa_nested", "name": "Nested catalog card", "description": "Sidecar defaults probe", + # The directory wins, while API category must keep its computed raw value. + "category": "Данные", "version": 1, + "fields": [ + {"key": "title", "type": "text", "required": True}, + {"key": "note", "type": "text"}, + {"key": "count", "type": "number"}, + {"key": "enabled", "type": "boolean"}, + {"key": "fallback", "type": "text", "default": "Schema fallback"}, + ], + "slots": {}, + "preview": {"title": "Inline heading", "note": PREVIEW["note"], "count": 7, "enabled": True}, + })) + write(site, f"{NESTED_DIR}/preview.yaml", dump_yaml({ + "name": "Preview metadata must not rename the fragment", + "props": {"title": PREVIEW["title"], "count": 0, "enabled": False}, + })) + write(site, f"{NESTED_DIR}/template.html.j2", """

    {{ props.title }}

    {{ props.note }}

    {{ props.count }}
    """) + write(site, f"{NESTED_DIR}/style.css", ".qa-nested { border-top: 7px solid rgb(17, 83, 149); }\n") + write(site, "fragments/qa_legacy/fragment.yaml", dump_yaml({ + "id": "qa_legacy", "name": "Legacy flat card", "category": "Контент", + "description": "Flat fragment stays usable", "fields": [], "slots": {}, + })) + write(site, "fragments/qa_legacy/template.html.j2", '

    Legacy flat content

    ') + write(site, "fragments/qa_legacy/style.css", ".qa-legacy { padding-top: 11px; }\n") + write(site, "fragments/content/qa_container/fragment.yaml", dump_yaml({ + "id": "qa_container", "name": "Restricted container", "category": "system", + "fields": [], "slots": {"body": {"allow": ["qa_nested"]}}, + })) + write(site, "fragments/content/qa_container/template.html.j2", '
    {{ slots.body }}
    ') + write(site, "layouts/qa_catalog/layout.yaml", dump_yaml({ + "id": "qa_catalog", "name": "Catalog checks", "regions": [ + {"id": "main", "allow": ["*"]}, {"id": "restricted", "allow": ["qa_legacy"]}, + ], + })) + write(site, "layouts/qa_catalog/layout.html.j2", """{{ seo_head() }}{{ assets_head() }}
    {{ region('main') }}
    {{ assets_body() }}""") + write(site, f"pages/{PAGE_ID}.md", frontmatter.dumps({ + "schema": 1, "title": "Catalog stage 1", "status": "published", "layout": "qa_catalog", + "regions": {"main": [ + {"id": "qa_container_block", "fragment": "qa_container", "slots": {"body": []}}, + {"id": "qa_legacy_block", "fragment": "qa_legacy"}, + ]}, + }, "")) + expected.update({"qa_nested": ("marketing", "marketing"), "qa_legacy": ("Контент", "content"), "qa_container": ("content", "content")}) + return expected + + +def minimal_site(site: Path) -> dict[str, tuple[str, str]]: + write(site, "site.yaml", dump_yaml({ + "schema": 1, "name": "Catalog integration fixture", "base_url": "https://catalog.example", + "default_locale": "ru", "locales": ["ru"], "defaults": {"layout": "qa_catalog"}, + })) + return seed_catalog(site) + + +def environment(site: Path, work: Path, password_hash: str) -> dict[str, str]: + return { + "SITE_ROOT": str(site), "SITE_DIST": str(work / "dist"), + "SITE_STATE_DIR": str(work / "state"), "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": password_hash, "SITE_SECRET_KEY": "fragments-002-temporary-secret-" * 2, + "SITE_COOKIE_SECURE": "0", "SITE_ADMIN_ORIGIN": "", "SITE_PREVIEW_ORIGIN": "", + } + + +class CatalogHTML(HTMLParser): + """Inspect server-rendered controls without a browser or HTML dependencies.""" + + def __init__(self, html: str): + super().__init__() + self.items, self.categories, self.forms = {}, {}, {} + self._item = self._category = self._form = None + self._badge_depth = 0 + self._textarea = None + self.feed(html) + + def handle_starttag(self, tag, attrs): + attrs = dict(attrs) + if tag == "button" and "data-fragment" in attrs: + self._item = attrs["data-fragment"] + self.items[self._item] = {"attrs": attrs, "text": "", "badge": ""} + if self._item and "data-fragment-category" in attrs: + self._badge_depth = 1 + elif self._badge_depth: + self._badge_depth += 1 + if tag == "button" and "data-catalog-category" in attrs: + self._category = attrs["data-catalog-category"] + self.categories[self._category] = "" + if tag == "form" and ("data-catalog-form" in attrs or attrs.get("id") == "buffer-form"): + self._form = attrs.get("data-catalog-form", "buffer-form") + self.forms[self._form] = {"attrs": attrs, "fields": {}} + if self._form and tag in ("input", "textarea") and "name" in attrs: + self.forms[self._form]["fields"][attrs["name"]] = attrs.get("value", "") + if tag == "textarea": + self._textarea = attrs["name"] + if self._form and tag == "select": + self._select = attrs.get("name") + if self._form and tag == "option" and "selected" in attrs: + self.forms[self._form]["fields"][self._select] = attrs.get("value", "") + + def handle_data(self, data): + if self._item: + self.items[self._item]["text"] += data + if self._badge_depth: + self.items[self._item]["badge"] += data + if self._category is not None: + self.categories[self._category] += data + if self._form and self._textarea: + self.forms[self._form]["fields"][self._textarea] += data + + def handle_endtag(self, tag): + if self._badge_depth: + self._badge_depth -= 1 + if tag == "button": + self._item = self._category = None + if tag == "form": + self._form = None + if tag == "textarea": + self._textarea = None + + +class FragmentCatalogUITests(unittest.TestCase): + @classmethod + def setUpClass(cls): + cls.password = "temporary catalog password" + cls.password_hash = hash_password(cls.password, n=2**10) + + def setUp(self): + temp = tempfile.TemporaryDirectory(prefix="catalog-002-test-") + self.addCleanup(temp.cleanup) + self.work = Path(temp.name) + self.site = self.work / "site" + self.expected = minimal_site(self.site) + env = patch.dict(os.environ, environment(self.site, self.work, self.password_hash)) + env.start() + self.addCleanup(env.stop) + self.app = create_app() + self.client = TestClient(self.app) + self.addCleanup(self.client.close) + self.assertEqual(self.client.get("/admin/login").status_code, 200) + response = self.client.post("/admin/login", data={"login": "admin", "password": self.password}, + headers={"Origin": "http://testserver"}, follow_redirects=False) + self.assertEqual(response.status_code, 303, response.text) + self.assertIn("se_session", self.client.cookies) + self.snapshots = [] + # Observe the actual internal HTTP responses, preserving ASGI auth and serialization. + original = self.app.state.api_calls + import httpx + send = httpx.AsyncClient.send + + async def observe(client, request, *args, **kwargs): + response = await send(client, request, *args, **kwargs) + if request.url.path == f"/admin/api/v1/pages/{PAGE_ID}/source" and response.status_code == 200: + self.snapshots.append(response.json()) + return response + + probe = patch.object(httpx.AsyncClient, "send", observe) + probe.start() + self.addCleanup(probe.stop) + self.response = self.client.get(f"/admin/pages/{PAGE_ID}") + self.assertEqual(self.response.status_code, 200, self.response.text[:2000]) + self.assertGreater(self.app.state.api_calls, original) + self.assertTrue(self.snapshots, "HTML must obtain the document over the internal API") + self.html = CatalogHTML(self.response.text) + self.source = self.snapshots[-1] + + def post(self, operation: str, fields: dict): + defaults = self.html.forms["buffer-form"]["fields"] + return self.client.post(f"/admin/editor/pages/{PAGE_ID}/{operation}", data={ + **{key: defaults[key] for key in ("csrf", "etag", "revision", "source")}, **fields, + }, headers={"Origin": "http://testserver", "HX-Request": "true"}) + + def test_raw_api_categories_and_localized_catalog_aliases(self): + fragments = self.source["schema"]["fragments"] + self.assertEqual({k: v.strip() for k, v in self.html.categories.items() if k}, LABELS) + for fid, (raw, group) in self.expected.items(): + with self.subTest(fragment=fid): + self.assertEqual(fragments[fid]["category"], raw) + item = self.html.items[fid] + self.assertEqual(item["attrs"]["data-category"], group) + self.assertEqual(item["badge"].strip(), LABELS[group]) + self.assertEqual(item["attrs"]["title"], fid) + self.assertIn(fragments[fid]["name"], item["text"]) + self.assertIn(fragments[fid]["description"], item["text"]) + for fid, (name, description) in { + "collection_list": ("Список коллекций", "Карточки, получаемые из collection"), + "section": ("Текстовая секция", "Заголовок и содержимое секции"), + "richtext": ("Markdown body", "Выводит Markdown из файла страницы"), + "card_grid": ("Карточки", "Сетка преимуществ"), + }.items(): + with self.subTest(builtin=fid): + self.assertEqual(fragments[fid]["name"], name) + self.assertEqual(fragments[fid]["description"], description) + self.assertIn(name, self.html.items[fid]["text"]) + self.assertIn(description, self.html.items[fid]["text"]) + self.assertEqual(self.app.state.api_credentials, {}) + self.assertEqual(self.client.get(f"/admin/api/v1/pages/{PAGE_ID}/source").status_code, 401) + + def test_sidecar_overrides_per_key_and_catalog_form_preserves_contract(self): + fragment = self.source["schema"]["fragments"]["qa_nested"] + self.assertEqual(fragment["preview"], PREVIEW) + self.assertEqual(fragment["name"], "Nested catalog card") + form = self.html.forms["qa_nested"] + self.assertEqual(form["attrs"]["method"], "post") + self.assertEqual(form["attrs"]["action"], f"/admin/editor/pages/{PAGE_ID}/transform") + for key, value in {"title": PREVIEW["title"], "note": PREVIEW["note"], "count": "0", "enabled": "false", "fallback": "Schema fallback"}.items(): + self.assertEqual(form["fields"]["p." + key], value, key) + # Builtins still use inline previews; adding a sidecar facility must preserve them. + inline = self.source["schema"]["fragments"]["hero"]["preview"] + self.assertTrue(inline["title"]) + self.assertEqual(self.html.forms["hero"]["fields"]["p.title"], inline["title"]) + for field in ("csrf", "etag", "source", "revision", "fragment", "region", "parent", "slot"): + self.assertIn(field, form["fields"]) + + def test_add_to_slot_buffers_then_save_and_reopen_nested_and_flat(self): + path = self.site / f"pages/{PAGE_ID}.md" + original = path.read_bytes() + fields = self.html.forms["qa_nested"]["fields"] + response = self.post("transform", {**fields, "region": "", "parent": "qa_container_block", "slot": "body"}) + self.assertEqual(response.status_code, 200, response.text[:2000]) + transformed = CatalogHTML(response.text) + source = transformed.forms["qa_nested"]["fields"]["source"] + self.assertEqual(path.read_bytes(), original) + self.assertFalse((self.site / ".engine/history").exists()) + meta, _ = frontmatter.parse(source) + blocks = meta["regions"]["main"] + added = blocks[0]["slots"]["body"][-1] + self.assertEqual(added["fragment"], "qa_nested") + self.assertRegex(added["id"], r"^qa_nested_[a-z0-9]{5}$") + self.assertEqual({key: added["props"][key] for key in PREVIEW}, PREVIEW) + self.assertEqual(blocks[1]["fragment"], "qa_legacy") + saved = self.post("save", {"source": source}) + self.assertEqual(saved.status_code, 200, saved.text[:2000]) + self.assertEqual(path.read_text(), source) + self.assertTrue(list((self.site / ".engine/history").rglob("*.md"))) + reopened = self.client.get(f"/admin/pages/{PAGE_ID}") + self.assertEqual(reopened.status_code, 200) + self.assertEqual(self.snapshots[-1]["source"], source) + self.assertEqual(self.snapshots[-1]["model"]["meta"]["regions"]["main"], blocks) + + def test_slot_and_region_restrictions_reject_forged_add_without_writing(self): + original = (self.site / f"pages/{PAGE_ID}.md").read_bytes() + for fid, target in [ + ("qa_legacy", {"region": "", "parent": "qa_container_block", "slot": "body"}), + ("qa_nested", {"region": "restricted", "parent": "", "slot": ""}), + ]: + with self.subTest(fragment=fid, target=target): + response = self.post("transform", {**self.html.forms[fid]["fields"], **target}) + self.assertEqual(response.status_code, 422, response.text[:2000]) + self.assertEqual((self.site / f"pages/{PAGE_ID}.md").read_bytes(), original) + + def test_invalid_sidecar_reaches_workspace_and_publish_preserves_current(self): + csrf = self.html.forms["buffer-form"]["fields"]["csrf"] + headers = {"Origin": "http://testserver"} + published = self.client.post("/admin/publish", data={"csrf": csrf}, headers=headers) + self.assertEqual(published.status_code, 200, published.text[:2000]) + dist = self.work / "dist" + current = dist / "current" + self.assertTrue(current.is_symlink()) + target = current.readlink() + public = (current / PAGE_ID / "index.html").read_bytes() + manifest = (current / "manifest.json").read_bytes() + releases = {path.name for path in dist.iterdir()} + document = (self.site / f"pages/{PAGE_ID}.md").read_bytes() + preview_path = f"{NESTED_DIR}/preview.yaml" + token = "catalog-test-credential" + self.app.state.api_credentials[token] = (self.client.cookies["se_session"], "testclient") + self.addCleanup(self.app.state.api_credentials.pop, token, None) + api_headers = {"Authorization": "Bearer " + token} + + for invalid, code, issue_path in ( + ("props: [unclosed\n", "E_YAML", preview_path), + ("props: []\n", "E_FRAGMENT_PREVIEW", preview_path + ":props"), + ): + with self.subTest(code=code): + write(self.site, preview_path, invalid) + workspace = self.client.get("/admin/api/v1/site", headers=api_headers) + self.assertEqual(workspace.status_code, 200, workspace.text) + matching = [issue for issue in workspace.json()["issues"] + if issue["code"] == code and issue["path"] == issue_path] + self.assertTrue(matching, workspace.json()["issues"]) + issue = matching[0] + self.assertEqual(issue["severity"], "error") + self.assertTrue(issue["message"]) + + rejected = self.client.post("/admin/api/v1/publish", headers=api_headers) + self.assertEqual(rejected.status_code, 422, rejected.text) + error = rejected.json()["error"] + self.assertEqual(error["code"], "validation") + self.assertEqual(error["request_id"], rejected.headers["x-request-id"]) + self.assertIn(issue, error["issues"]) + + visible = self.client.post("/admin/publish", data={"csrf": csrf}, headers=headers) + self.assertEqual(visible.status_code, 422, visible.text[:2000]) + self.assertEqual(visible.headers["x-error-code"], "validation") + self.assertIn("role='alert'", visible.text) + self.assertIn("Проблемы сборки", visible.text) + self.assertIn(code, visible.text) + self.assertIn(issue_path, visible.text) + self.assertIn(visible.headers["x-request-id"], visible.text) + self.assertEqual(current.readlink(), target) + self.assertEqual((current / PAGE_ID / "index.html").read_bytes(), public) + self.assertEqual((current / "manifest.json").read_bytes(), manifest) + self.assertEqual({path.name for path in dist.iterdir()}, releases) + self.assertEqual((self.site / f"pages/{PAGE_ID}.md").read_bytes(), document) + + def test_custom_category_text_is_escaped_in_catalog_markup(self): + category = ' & "special"' + write(self.site, "fragments/qa_legacy/fragment.yaml", dump_yaml({ + "id": "qa_legacy", "name": "Legacy flat card", "category": category, + "description": "Flat fragment stays usable", "fields": [], "slots": {}, + })) + response = self.client.get(f"/admin/pages/{PAGE_ID}") + self.assertEqual(response.status_code, 200, response.text[:2000]) + catalog = CatalogHTML(response.text) + self.assertEqual(self.snapshots[-1]["schema"]["fragments"]["qa_legacy"]["category"], category) + item = catalog.items["qa_legacy"] + self.assertEqual(item["attrs"]["data-category-source"], category) + self.assertEqual(item["attrs"]["data-category"], category) + self.assertEqual(item["badge"].strip(), category) + self.assertEqual(catalog.categories[category].strip(), category) + self.assertIn("<img", response.text) + self.assertNotIn("Telegram-боты —", html) + self.assertIn("content='Автоматизируем заявки", html) + + def test_intentionally_incomplete_booking_is_previewable_with_visible_diagnostic(self): + html, report = preview_page(self.site, "cases/booking") + self.assertIn("Бот для онлайн-записи", html) + self.assertIn("E_ASSET_MISSING", report.codes()) + + def test_shared_lists_render_more_than_three_without_truncation(self): + p = self.site / "pages/index.md" + meta, body = frontmatter.parse(p.read_text()) + for b in meta["regions"]["main"]: + if b["fragment"] in ("steps", "card_grid"): + b["props"]["items"] += [{"title": "Четвёртый"}, {"title": "Пятый"}] + p.write_text(frontmatter.dumps(meta, body)) + build_site(self.site, self.out) + html = (self.out / "current/index.html").read_text() + self.assertEqual(html.count("Пятый"), 2) + self.assertIn("aria-hidden='true'>05", html) + + def test_collection_list_renders_more_than_three_entries(self): + meta, body = frontmatter.parse((self.site / "content/services/bots.md").read_text()) + for i in range(4): + meta["slug"] = f"additional-{i}" + write(self.site, f"content/services/additional-{i}.md", frontmatter.dumps(meta, body)) + path = self.site / "pages/index.md" + meta, body = frontmatter.parse(path.read_text()) + meta["regions"]["main"][1]["props"]["source"]["query"]["limit"] = 10 + path.write_text(frontmatter.dumps(meta, body)) + build_site(self.site, self.out) + html = (self.out / "current/index.html").read_text() + self.assertEqual(html.count('class="f-collection_list__item"'), 6) + + def test_form_schema_has_keys_enabled_fields_consent_and_page_ids(self): + reg = load_site(self.site) + f = reg.forms["form_contact"] + self.assertEqual(f.success["page"], "thank-you") + self.assertNotIn("telegram", [v["key"] for v in f.fields]) + self.assertEqual(f.raw["status"], "active") + self.assertEqual(reg.forms["form_brief"].raw["status"], "draft") + self.assertTrue(any(v["key"] == "consent" and v["policy"] == "privacy" for v in f.fields)) + build_site(self.site, self.out) + html = (self.out / "current/request/index.html").read_text() + self.assertIn('type="email"', html) + self.assertIn('type="tel"', html) + self.assertIn('action="/forms/form_contact"', html) + self.assertIn("name='form_version'", html) + self.assertIn("Приём заявок пока не подключён", html) + + +if __name__ == "__main__": + unittest.main() diff --git a/tests/test_theme.py b/tests/test_theme.py new file mode 100644 index 0000000..bea0b61 --- /dev/null +++ b/tests/test_theme.py @@ -0,0 +1,263 @@ +"""File theme validation, shared CSS and immutable releases without editable examples.""" + +import datetime as dt +import json +import os +import tempfile +import unittest +from pathlib import Path +from unittest.mock import patch + +from theme_fixture import document, seed, write + +from site_engine.build.pipeline import build_site, preview_page +from site_engine.core.registry import load_site +from site_engine.core.theme import default_theme, preset_catalog, resolve_theme, theme_css +from site_engine.core.validate import validate_workspace +from site_engine.errors import EngineError, Report +from site_engine.parsing.yamlio import dump_yaml +from site_engine.services.publish import rollback + +NOW = dt.datetime(2026, 11, 13, 12, tzinfo=dt.UTC) + + +class ThemeTest(unittest.TestCase): + def resolve(self, overrides=None, preset="minimal"): + report = Report() + result = resolve_theme(document(preset, overrides), report) + return result, report + + def test_exact_design_presets_and_independent_catalog_copies(self): + expected = {"minimal": ("#4255b9", 1180), "dark": ("#a48bfa", 1240), + "editorial": ("#82563e", 1040), "bold": ("#df466f", 1280), + "natural": ("#49775c", 1140), "custom": ("#6554ce", 1180)} + for name, (color, width) in expected.items(): + with self.subTest(name=name): + overrides = {k: v for k, v in preset_catalog()[name].items() if k in ("colors", "type", "ui")} if name == "custom" else {} + theme, report = self.resolve(overrides, name) + self.assertTrue(report.ok, report.issues) + self.assertEqual(theme.tokens["colors"]["primary"], color) + self.assertEqual(theme.container.max_width, width) + catalog = preset_catalog() + catalog["dark"]["colors"]["primary"] = "modified" + self.assertEqual(preset_catalog()["dark"]["colors"]["primary"], "#a48bfa") + + def test_deep_overrides_preserve_other_tokens(self): + theme, report = self.resolve({"colors": {"primary": "#123456"}, "ui": {"container": {"mode": "fluid", "gutter": {"mobile": 0}}}}) + self.assertTrue(report.ok, report.issues) + self.assertEqual(theme.container.gutter.desktop, 32) + self.assertEqual(theme.container.gutter.mobile, 0) + self.assertEqual(theme.container.mode, "fluid") + self.assertEqual(theme.tokens["colors"]["surface"], "#ffffff") + self.assertIn("--color-primary: #123456;", theme_css(theme)) + + def test_custom_requires_complete_groups(self): + theme, report = self.resolve({"colors": {"primary": "#123456"}}, "custom") + self.assertIsNone(theme) + self.assertIn("E_THEME_CUSTOM", report.codes()) + values = {k: v for k, v in preset_catalog()["custom"].items() if k in ("colors", "type", "ui")} + del values["ui"]["container"]["gutter"]["mobile"] + self.assertIn("E_THEME_CUSTOM", self.resolve(values, "custom")[1].codes()) + + def test_invalid_document_versions_and_unknown_keys(self): + for values in ({"schema": True}, {"schema": 2}, {"preset": []}, {"preset": "missing"}, + {"preset_version": True}, {"preset_version": 2}, {"inline": {}}, {"overrides": None}): + with self.subTest(values=values): + report = Report() + self.assertIsNone(resolve_theme({**document(), **values}, report)) + self.assertFalse(report.ok) + + def test_invalid_group_shapes_report_instead_of_crashing(self): + for group in ("colors", "type", "ui", "custom_colors", "gradients"): + for value in (None, False, 0, [], "url(https://invalid)"): + with self.subTest(group=group, value=value): + theme, report = self.resolve({group: value}) + self.assertIsNone(theme) + self.assertTrue(any(i.path.startswith("theme.yaml.overrides." + group) for i in report.errors)) + + def test_numeric_boundaries_and_strict_types(self): + for group, key, valid, invalid in ( + ("type", "scale", [.85, 1.3], [.84, 1.31, True, "1", float("nan"), float("inf"), 10**1000]), + ("type", "line", [1.3, 1.9], [1.29, 1.91, None]), + ("type", "headingWeight", [100, 900], [99, 901, 700.0, True]), + ("ui", "radius", [0, 24], [-1, 25, "8px"]), + ("ui", "spacing", [.8, 1.4], [.79, 1.41, False]), + ): + for value in valid + invalid: + with self.subTest(group=group, key=key, value=value): + theme, report = self.resolve({group: {key: value}}) + self.assertEqual(theme is not None, value in valid and type(value) is not bool) + self.assertEqual(report.ok, theme is not None) + + def test_container_types_ranges_keys_and_legacy_numeric(self): + invalid = [1080, None, [], {"mode": "wide"}, {"mode": []}, {"max_width": 719}, + {"max_width": 1921}, {"max_width": 1080.0}, {"max_width": True}, + {"gutter": []}, {"gutter": {"mobile": -1}}, {"gutter": {"desktop": 97}}, + {"gutter": {"tablet": "24"}}, {"gutter": {"phone": 16}}, {"width": 1200}] + for cn in invalid: + with self.subTest(container=cn): + theme, report = self.resolve({"ui": {"container": cn}}) + self.assertIsNone(theme) + self.assertFalse(report.ok) + for mode in ("boxed", "fluid", "full"): + for width in (720, 1920): + theme, report = self.resolve({"ui": {"container": {"mode": mode, "max_width": width, "gutter": {"mobile": 0, "desktop": 96}}}}) + self.assertTrue(report.ok) + self.assertEqual(theme.container.max_width, width) + + def test_css_url_script_jinja_and_unapproved_font_are_rejected(self): + for override in ( + {"colors": {"primary": "red; }body{display:none}"}}, + {"colors": {"surface": "#fff"}}, {"colors": {"accent": "{{ x }}"}}, + {"type": {"body": "url(https://example.org/font)"}}, + {"type": {"heading": ""}}, + {"type": {"pair": "unknown"}}, {"ui": {"shadow": "anything"}}, + {"ui": {"button": "gradient"}}, {"ui": {"css": "color:red"}}, + ): + with self.subTest(override=override): + theme, report = self.resolve(override) + self.assertIsNone(theme) + self.assertFalse(report.ok) + + def test_named_colors_limits_and_reserved_names(self): + valid = {f"brand_{i}": "#123456" for i in range(24)} + theme, report = self.resolve({"custom_colors": valid}) + self.assertTrue(report.ok) + self.assertIn("--color-brand-0: #123456", theme_css(theme)) + for extra in ({**valid, "another": "#123456"}, {"primary": "#123456"}, + {"a": "#123456"}, {"Bad_Name": "#123456"}, {"font;body": "#123456"}, + {"brand": "url(x)"}, {1: "#123456"}): + with self.subTest(extra=extra): + self.assertFalse(self.resolve({"custom_colors": extra})[1].ok) + + def test_gradients_validate_all_stops_and_disable_with_solid_fallback(self): + definition = {"type": "linear", "angle": 145, "stops": [{"at": 0, "color": "#112233"}, {"at": 55, "color": "#445566"}, {"at": 100, "color": "#778899"}]} + theme, report = self.resolve({"gradients": {"enabled": True, "definitions": {"hero": definition}}}) + self.assertTrue(report.ok) + self.assertIn("W_THEME_GRADIENT_CONTRAST", report.codes()) + self.assertIn("--hero-gradient: linear-gradient(145deg, #112233 0%, #445566 55%, #778899 100%);", theme_css(theme)) + theme, _ = self.resolve({"gradients": {"enabled": False, "definitions": {"hero": definition}}}) + self.assertNotIn("linear-gradient", theme_css(theme)) + self.assertIn("--hero-gradient: #4255b9", theme_css(theme)) + for key, value in (("type", "radial"), ("angle", -1), ("angle", 361), ("angle", True), + ("stops", []), ("stops", [{"at": 0, "color": "#fff"}] * 2), + ("stops", [{"at": 20, "color": "#112233"}, {"at": 20, "color": "#445566"}]), + ("stops", [{"at": "0", "color": "#112233"}, {"at": 100, "color": "#445566"}])): + with self.subTest(key=key, value=value): + self.assertFalse(self.resolve({"gradients": {"definitions": {"hero": {**definition, key: value}}}})[1].ok) + self.assertFalse(self.resolve({"gradients": {"enabled": "true"}})[1].ok) + self.assertFalse(self.resolve({"gradients": {"definitions": {f"gradient_{i}": definition for i in range(13)}}})[1].ok) + + def test_contrast_is_warning_and_defaults_have_no_gradients(self): + theme, report = self.resolve({"colors": {"text": "#ffffff", "muted": "#ffffff", "surface": "#ffffff", "background": "#ffffff"}}) + self.assertIsNotNone(theme) + self.assertTrue(report.ok) + self.assertEqual(len(report.warnings), 3) + self.assertFalse(default_theme().tokens["gradients"]["enabled"]) + + +class ThemeReleaseTest(unittest.TestCase): + def setUp(self): + temp = tempfile.TemporaryDirectory() + self.addCleanup(temp.cleanup) + self.work = Path(temp.name) + self.site, self.out = self.work / "site", self.work / "dist" + seed(self.site) + + def test_no_theme_uses_safe_default_without_creating_file(self): + write(self.site, "site.yaml", "name: New site\n") + (self.site / "theme.yaml").unlink() + reg = load_site(self.site) + self.assertTrue(reg.report.ok) + self.assertEqual(reg.theme.document.preset, "minimal") + self.assertFalse((self.site / "theme.yaml").exists()) + + def test_bad_explicit_file_inline_config_and_malformed_yaml(self): + configs = [{"file": "missing.yaml"}, {"file": "../secret.yaml"}, {"file": "/tmp/secret"}, + {"file": None}, {"file": ""}, {"tokens": {"color.primary": "#123456"}}, [], False] + for config in configs: + with self.subTest(config=config): + write(self.site, "site.yaml", dump_yaml({"name": "Invalid theme", "theme": config})) + self.assertFalse(load_site(self.site).report.ok) + write(self.site, "site.yaml", dump_yaml({"name": "Invalid theme", "theme": {"file": "theme.yaml"}})) + for text in ("[", "", "schema: 1\nschema: 1", "schema: 1\npreset: &x minimal\npreset_version: *x", "- item"): + with self.subTest(text=text): + write(self.site, "theme.yaml", text) + self.assertFalse(load_site(self.site).report.ok) + + def test_theme_symlink_cannot_escape_site_root(self): + write(self.work, "outside.yaml", dump_yaml(document())) + (self.site / "theme.yaml").unlink() + (self.site / "theme.yaml").symlink_to(self.work / "outside.yaml") + self.assertIn("E_THEME_FILE", load_site(self.site).report.codes()) + + def test_all_presets_build_and_manifest_pins_effective_tokens(self): + for preset in preset_catalog(): + with self.subTest(preset=preset): + overrides = {k: v for k, v in preset_catalog()[preset].items() if k in ("colors", "type", "ui")} if preset == "custom" else {} + write(self.site, "theme.yaml", dump_yaml(document(preset, overrides))) + result = build_site(self.site, self.out, now=NOW, keep=10) + manifest = json.loads((result.output_dir / "manifest.json").read_text()) + self.assertEqual(manifest["theme"]["document"]["preset"], preset) + self.assertEqual(manifest["theme"]["document"]["preset_version"], 1) + self.assertTrue(manifest["render_hash"]) + css = next((result.output_dir / "assets").glob("site.*.css")).read_text() + expected = manifest["theme"]["effective_tokens"]["colors"]["primary"] + self.assertIn("--color-primary: " + expected, css) + self.assertNotIn("data-preview-", (result.output_dir / "index.html").read_text()) + + def test_public_and_passive_preview_share_css_and_override_defaults_last(self): + result = build_site(self.site, self.out, now=NOW) + css = next((result.output_dir / "assets").glob("site.*.css")).read_text() + html, report = preview_page(self.site, "index", now=NOW) + self.assertTrue(report.ok, report.issues) + self.assertIn(css, html) + self.assertGreater(css.index("--color-primary:"), css.index("/* fragment: hero */")) + + def test_contrast_warning_does_not_block_release(self): + write(self.site, "theme.yaml", dump_yaml(document(overrides={"colors": {"text": "#ffffff"}}))) + result = build_site(self.site, self.out, now=NOW) + self.assertIn("W_THEME_CONTRAST", result.report.codes()) + self.assertTrue(result.report.ok) + + def test_invalid_theme_preserves_live_and_is_visible_to_preview(self): + original = build_site(self.site, self.out, now=NOW) + write(self.site, "theme.yaml", dump_yaml(document(overrides={"ui": {"container": 1080}}))) + self.assertIn("E_THEME_SHAPE", validate_workspace(load_site(self.site)).codes()) + for action in (lambda: build_site(self.site, self.out, now=NOW), lambda: preview_page(self.site, "index")): + with self.assertRaises(EngineError) as caught: + action() + self.assertIn("E_THEME_SHAPE", caught.exception.report.codes()) + self.assertEqual(os.readlink(self.out / "current"), original.build_id) + + def test_reproducibility_and_rollback_do_not_change_workspace(self): + first = build_site(self.site, self.out, now=NOW) + original_bytes = (first.output_dir / "manifest.json").read_bytes() + again = build_site(self.site, self.out, now=NOW) + self.assertEqual(first.build_id, again.build_id) + write(self.site, "theme.yaml", dump_yaml(document("dark"))) + workspace = (self.site / "theme.yaml").read_bytes() + second = build_site(self.site, self.out, now=NOW) + self.assertNotEqual(first.build_id, second.build_id) + rollback(self.out, first.build_id) + self.assertEqual((self.site / "theme.yaml").read_bytes(), workspace) + self.assertEqual((self.out / "current/manifest.json").read_bytes(), original_bytes) + + def test_render_resource_change_changes_id_with_same_source(self): + first = build_site(self.site, self.out, now=NOW) + reg = load_site(self.site) + reg.fragments["hero"].style += "\n.f-hero { padding-top: 5rem; }" + with patch("site_engine.build.pipeline.load_site", return_value=reg): + second = build_site(self.site, self.out, now=NOW) + self.assertEqual(first.source_hash, second.source_hash) + self.assertNotEqual(first.build_id, second.build_id) + self.assertTrue(first.output_dir.exists()) + + def test_existing_release_is_never_overwritten_on_collision(self): + first = build_site(self.site, self.out, now=NOW) + (first.output_dir / "index.html").write_text("Historical content") + with self.assertRaises(EngineError) as caught: + build_site(self.site, self.out, now=NOW) + self.assertIn("E_RELEASE_COLLISION", caught.exception.report.codes()) + self.assertEqual((first.output_dir / "index.html").read_text(), "Historical content") + self.assertFalse(list(self.out.glob(".staging*"))) diff --git a/tests/test_theme_manager.py b/tests/test_theme_manager.py new file mode 100644 index 0000000..a8bbda9 --- /dev/null +++ b/tests/test_theme_manager.py @@ -0,0 +1,437 @@ +"""Theme contract: real HTML/API boundary, CAS, workflow and isolated previews.""" + +import datetime as dt +import json +import os +import tempfile +import unittest +from pathlib import Path +from unittest.mock import patch +from urllib.parse import parse_qs, urlsplit + +from fastapi.testclient import TestClient +from theme_fixture import document, seed, write + +from site_engine.build.pipeline import build_site +from site_engine.errors import ConflictError, EngineError, UnsafePathError +from site_engine.parsing.yamlio import dump_yaml, load_yaml +from site_engine.services.auth import hash_password +from site_engine.services.content import ABSENT, ContentService +from site_engine.services.documents import EditorContext +from site_engine.services.publish import rollback +from site_engine.services.theme import OnboardingService, ThemeCommitError, ThemeService +from site_engine.web.app import create_app + + +class ThemeManagerTests(unittest.TestCase): + @classmethod + def setUpClass(cls): + cls.password = "theme test password" + cls.password_hash = hash_password(cls.password, n=2**10) + + def setUp(self): + tmp = tempfile.TemporaryDirectory() + self.addCleanup(tmp.cleanup) + self.work = Path(tmp.name) + self.site, self.dist, self.state = ( + self.work / "site", + self.work / "dist", + self.work / "state", + ) + seed(self.site) + env = patch.dict( + os.environ, + { + "SITE_ROOT": str(self.site), + "SITE_DIST": str(self.dist), + "SITE_STATE_DIR": str(self.state), + "SITE_ADMIN_LOGIN": "admin", + "SITE_ADMIN_PASSWORD_HASH": self.password_hash, + "SITE_SECRET_KEY": "theme-integration-secret-" * 4, + "SITE_COOKIE_SECURE": "0", + "SITE_ADMIN_ORIGIN": "", + "SITE_PREVIEW_ORIGIN": "", + }, + ) + env.start() + self.addCleanup(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.app.state.api_credentials["test"] = (self.cookie, "testclient") + self.principal = self.app.state.auth.authenticate(self.cookie) + self.csrf = self.app.state.auth.csrf_token(self.principal) + self.context = EditorContext(self.principal, "testclient") + self.svc = ThemeService(self.site, self.dist, self.state, self.app.state.auth.audit) + + def api(self, method, path="/theme", data=None): + return self.client.request( + method, "/admin/api/v1" + path, json=data, headers={"Authorization": "Bearer test"} + ) + + def post(self, op, data=None, csrf=None, origin="http://testserver"): + return self.client.post( + "/admin/" + op, + data={"csrf": self.csrf if csrf is None else csrf, "payload": json.dumps(data or {})}, + headers={"Origin": origin, "HX-Request": "true"}, + ) + + def new_site(self): + raw = load_yaml((self.site / "site.yaml").read_text()) + del raw["theme"] + write(self.site, "site.yaml", dump_yaml(raw)) + (self.site / "theme.yaml").unlink() + + def test_snapshot_and_catalog_share_core(self): + snap = self.api("GET").json() + self.assertEqual( + { + "document", + "etag", + "effective_tokens", + "diagnostics", + "workspace_revision", + "live_build_id", + } + - snap.keys(), + set(), + ) + self.assertIsNone(snap["live_build_id"]) + self.assertEqual(snap["effective_tokens"]["ui"]["container"]["max_width"], 1080) + presets = self.api("GET", "/theme/presets") + self.assertEqual(presets.status_code, 200) + self.assertEqual(len(presets.json()["presets"]), 6) + for preset in presets.json()["presets"].values(): + result = self.api( + "POST", "/theme/validate", {"document": preset["document"], "revision": 9} + ) + self.assertEqual(result.status_code, 200, result.text) + self.assertEqual(result.json()["effective_tokens"], preset["effective_tokens"]) + + def test_validate_and_preview_never_save(self): + before = (self.site / "theme.yaml").read_bytes() + new = document("dark") + validated = self.post("theme/validate", {"document": new, "revision": 42}) + self.assertEqual(validated.status_code, 200, validated.text) + self.assertIn("preset: dark", validated.json()["yaml"]) + for target in ("sample", "page"): + result = self.post("theme/preview", {"document": new, "revision": 42, "target": target}) + self.assertEqual(result.status_code, 200, result.text) + self.assertEqual(result.json()["revision"], 42) + preview = self.client.get(result.json()["url"]) + self.assertEqual(preview.status_code, 200, preview.text) + self.assertIn("--color-primary: #a48bfa", preview.text) + self.assertIn("script-src 'none'", preview.headers["content-security-policy"]) + self.assertNotIn("{{ seo_head() }}{{ assets_head() }}{{ region('header') }}
    {{ region('main') }}
    {{ region('footer') }}{{ assets_body() }}""") + write(root, "assets/check.css", ".f-site_header{position:sticky;top:0;z-index:10;background:var(--color-surface)} .f-richtext p{overflow-wrap:anywhere}") + write(root, "pages/index.md", frontmatter.dumps({ + "schema": 1, "title": "Проверка ширины секций", "status": "published", + "regions": {"main": [ + {"id": "hero_home", "fragment": "hero", "props": {"title": "Файловая тема и ширина секций", "subtitle": "Общий контракт сборки и preview", "actions": [{"url": "https://example.org", "label": "Основная кнопка"}]}, + "layout": {"section_width": "full", "content_width": "boxed"}}, + {"id": "section_outer", "fragment": "section", "props": {"title": "Родительская секция", "text": "Ширина фона и содержимого настраиваются отдельно."}, + "layout": {"section_width": "fluid", "content_width": "full"}, "slots": {"content": [ + {"id": "richtext_child", "fragment": "richtext", "props": {"content": "## Вложенный блок\n\nСобственная ширина вложенного блока."}, + "layout": {"section_width": "boxed", "content_width": "fluid"}}, + ]}}, + {"id": "columns_grid", "fragment": "columns", "props": {"count": "2"}, "slots": {"col_1": [ + {"id": "richtext_column", "fragment": "richtext", "props": {"content": "Содержимое первой колонки"}}, + ]}}, + *[{"id": f"richtext_long_{i}", "fragment": "richtext", "props": {"content": "## Текстовая секция\n\n" + ("Проверка прокрутки. " * 60)}} for i in range(8)], + ]}, + })) + write(root, "collections/articles.yaml", dump_yaml({ + "id": "articles", "name": "Статьи", "route": "/articles/{slug}/", "body": "markdown", + "fields": [{"key": "title", "type": "text", "required": True}], + })) + write(root, "display/articles.yaml", dump_yaml({ + "layout": "default", "regions": {"main": [ + {"id": "display_text", "fragment": "richtext", "layout": {"section_width": "full", "content_width": "boxed"}, "props": {"content": {"bind": "entry.body"}}}, + ]}, + })) + write(root, "content/articles/first.md", frontmatter.dumps({ + "title": "Первая статья", "status": "published", "regions": {"main": [ + {"id": "entry_text", "fragment": "richtext", "layout": {"section_width": "fluid", "content_width": "full"}, "props": {"content": "Текст записи"}}, + ]}, + }, "Текст из Display."))