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

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/*.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.