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.
4.8 KiB
4.8 KiB
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/*.webpvsassets/*.webp, а Layout называетсяstandardилиdefault. В seed используется одинassets/и Layoutdefault. - В моках часть записей помечена «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.