mirror of
https://github.com/gromlab-ru/slm-design.git
synced 2026-08-22 07:30:16 +03:00
84 lines
3.6 KiB
Markdown
84 lines
3.6 KiB
Markdown
---
|
||
title: Структуры compositions
|
||
description: Примеры организации слоя compositions под разные способы сборки React-приложения
|
||
---
|
||
|
||
# Структуры compositions
|
||
|
||
Раздел показывает, что SLM не фиксирует жёсткую структуру внутри `compositions`. Команда выбирает организацию под фреймворк, роутинг, CMS и продуктовую задачу.
|
||
|
||
## Базовая рекомендация
|
||
|
||
Подходит для большинства приложений, где есть явные страницы, layouts, screens и переиспользуемые композиционные блоки.
|
||
|
||
```text
|
||
src/compositions/
|
||
├── business/
|
||
│ ├── auth/
|
||
│ └── user/
|
||
├── pages/
|
||
│ ├── home/
|
||
│ └── profile/
|
||
├── layouts/
|
||
│ ├── main/
|
||
│ └── dashboard/
|
||
├── screens/
|
||
│ ├── home/
|
||
│ └── profile/
|
||
└── widgets/
|
||
├── page-heading/
|
||
└── promo-banner/
|
||
```
|
||
|
||
`business`, `pages`, `layouts`, `screens` и `widgets` здесь не являются отдельными SLM-слоями. Это группы composition modules внутри одного слоя `compositions`.
|
||
|
||
`compositions/business/{domain}` используется для runtime-сборки business-фабрик. Он не заменяет `business/{domain}` и не содержит доменную логику.
|
||
|
||
Только эта группа integration modules знает одновременно business dependency contract и concrete product runtime. Остальные composition modules являются graph owners или consumers готовых business API.
|
||
|
||
## Entry-points и blocks
|
||
|
||
Подходит для проектов, где точка сборки не всегда является страницей: CMS registry, embedded UI, route entries, feature entries.
|
||
|
||
```text
|
||
src/compositions/
|
||
├── entry-points/
|
||
│ ├── cms-profile/
|
||
│ └── embedded-checkout/
|
||
├── pages/
|
||
│ └── profile/
|
||
├── layouts/
|
||
│ └── profile-main/
|
||
├── screens/
|
||
│ └── profile/
|
||
└── blocks/
|
||
├── profile-summary/
|
||
└── recommended-products/
|
||
```
|
||
|
||
## Группировка вокруг продукта
|
||
|
||
Подходит, когда удобнее держать все части одной крупной области рядом.
|
||
|
||
```text
|
||
src/compositions/
|
||
└── profile/
|
||
├── page/
|
||
├── layout/
|
||
├── screen/
|
||
└── blocks/
|
||
```
|
||
|
||
## Главное правило
|
||
|
||
Любая структура допустима, если соблюдаются границы слоя:
|
||
|
||
- `app` подключает готовые composition modules к фреймворку.
|
||
- `compositions` может импортировать `business`, `infra`, `ui`, `shared`.
|
||
- `compositions/business/{domain}` отдельными adapters собирает конкретную business-фабрику с runtime-зависимостями.
|
||
- Page/layout/screen/widget получают product data только через `{Domain}Api`.
|
||
- Graph owner импортирует builders, но не raw product SDK/client/event для досборки домена.
|
||
- `business`, `infra`, `ui`, `shared` не импортируют `compositions`.
|
||
- Импорты между composition modules идут только через public API.
|
||
- Deep imports внутрь composition modules запрещены.
|