Support categorized fragments, theme presets, block widths, and server-backed theme editing with onboarding and preview. Include Site Studio, design sources, specification and verification reports; remove the legacy studio-site example.
27 lines
4.8 KiB
Markdown
27 lines
4.8 KiB
Markdown
# Source map — HTML-прототипы → файловая модель Site Studio
|
||
|
||
> Таблица объясняет, откуда взяты данные и как они нормализованы. **HTML-прототипы админки на момент создания seed не читают эти файлы напрямую**: исходные UI-модули используют разные mock/localStorage stores. В будущей реализации все они должны читать один сервисный слой поверх перечисленных документов.
|
||
|
||
| Экран / источник | Канонические файлы примера | Что перенесено |
|
||
|---|---|---|
|
||
| Builder / Главная (`builder.js`, page `home`) | `pages/index.md`, `layouts/landing/`, `fragments/marketing/hero/`, `fragments/data/collection_list/`, `fragments/content/{card_grid,steps}/`, `fragments/marketing/cta_banner/` | Тексты Hero, услуги из `services`, преимущества, этапы, CTA, стабильные Block ID |
|
||
| Builder / Услуги | `pages/services/index.md`, `collections/services.yaml` | Hero, список услуг, FAQ |
|
||
| Builder / О компании | `pages/about.md`, `fragments/content/richtext/`, `fragments/media/image/` | Hero, Markdown body, картинка команды |
|
||
| Builder / Контакты, Заявка | `pages/contacts.md`, `pages/request.md`, `forms/form_contact.yaml` | Ссылки, CTA, форма; заявки не сохраняются |
|
||
| Страницы обзорного CMS shell | `pages/privacy.md`, `pages/thank-you.md`, `pages/cases/index.md`, `pages/scenarios/index.md` | Юридический и служебный контент, страницы коллекций |
|
||
| Content Editor / `services`, `scenarios`, `cases` | `content/{services,scenarios,cases}/*.md`, `collections/*.yaml`, `display/*.yaml` | Структурированные Entry, статусы, поля, Markdown, relations, шаблоны отображения |
|
||
| Content Editor / `courses`, `posts` | `collections/{courses,posts}.yaml`, `display/{courses,posts}.yaml` | Схемы остаются, содержимое пустое/отключено |
|
||
| Structure / Layouts & Fragments | `layouts/*/layout.{yaml,html.j2}`, `fragments/*/*/{fragment.yaml,template.html.j2,preview.yaml}` | Фиксированные шапка/футер, ограничения регионов, типы полей |
|
||
| Media / Assets | `assets/*`, `assets/manifest.yaml` | Визуальные локальные заглушки вместо реальных отсутствовавших картинок, alt/caption |
|
||
| Structure / Меню | `menus/main.yaml`, `menus/footer.yaml` | Навигация и маршруты |
|
||
| Forms / Настройки | `forms/*.yaml`, `data/company.yaml`, `redirects.yaml`, `site.yaml` | Настраиваемые поля, контакты-демо, редиректы, общие данные |
|
||
| Theme Manager / пресеты + Custom | `theme.yaml`, `site.yaml.theme.file`, `assets/site.css` | Базовые цветовые токены, именованные дополнительные цвета, градиенты Hero/Button/CTA, fallback без градиента |
|
||
|
||
## Специально нормализованные различия
|
||
|
||
- В JS-моках страницы и записи часто имеют разные подписи, ассеты `media/*.webp` vs `assets/*.webp`, а Layout называется `standard` или `default`. В seed используется **один** `assets/` и Layout `default`.
|
||
- В моках часть записей помечена «published», но это не равно реальному live. Статические HTML-страницы из `preview-dist/` создаются только для записей со статусом `published`, и никакой `ReleaseService` при этом не исполняется.
|
||
- `content/cases/booking.md` содержит намеренную ссылку на отсутствующий `assets/missing-cover.webp`; это тест предупреждения при редактировании **черновика**, а не опубликованный маршрут.
|
||
- Путь `theme.yaml` — проектное решение, ожидающее формального утверждения ADR-007. В прежнем ТЗ дизайн-токены находились в `site.yaml`.
|
||
- Сборщик `tools/render_preview.py` лишь визуализирует пример для проверки переносимости. При реализации CMS нужен отдельный типизированный engine renderer и безопасный publication pipeline.
|