Files
flexly-cms/design/examples/site-studio/SOURCE_MAP.md
T
phelex 0d171915d7 Add Site Studio themes and Theme Manager
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.
2026-11-13 14:04:49 +03:00

27 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.