mirror of
https://github.com/gromlab-ru/slm-design.git
synced 2026-08-22 07:30:16 +03:00
76 lines
3.5 KiB
Markdown
76 lines
3.5 KiB
Markdown
|
---
|
|||
|
|
title: Сегменты
|
|||
|
|
status: draft
|
|||
|
|
normative: true
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# Сегменты
|
|||
|
|
|
|||
|
|
Segment группирует внутренние файлы module по устойчивой роли. Segment не является самостоятельным layer, module или domain.
|
|||
|
|
|
|||
|
|
## Базовые segments
|
|||
|
|
|
|||
|
|
| Segment | Роль |
|
|||
|
|
|---|---|
|
|||
|
|
| `ui/` | Presentation components текущего module |
|
|||
|
|
| `parts/` | Nested modules текущего module |
|
|||
|
|
| `hooks/` | Framework hooks текущей ответственности |
|
|||
|
|
| `providers/` | Provider implementations текущего module |
|
|||
|
|
| `stores/` | Concrete state runtime текущего owner |
|
|||
|
|
| `services/` | Scenario operations и service objects |
|
|||
|
|
| `mappers/` | Transformation на границе ответственности |
|
|||
|
|
| `types/` | Types текущего module |
|
|||
|
|
| `styles/` | Styles текущего module |
|
|||
|
|
| `lib/` | Небольшие internal utilities |
|
|||
|
|
| `config/` | Constants и configuration текущего module |
|
|||
|
|
| `tests/` | Tests публичной границы или составного runtime |
|
|||
|
|
|
|||
|
|
## Правила
|
|||
|
|
|
|||
|
|
**SLM-SEG-001 - МОЖЕТ.** Module может использовать любые необходимые segments и не обязан создавать остальные.
|
|||
|
|
|
|||
|
|
**SLM-SEG-002 - ЗАПРЕЩЕНО.** Нельзя создавать полный симметричный набор segments как scaffold без реального содержимого.
|
|||
|
|
|
|||
|
|
**SLM-SEG-003 - ОБЯЗАН.** Файл должен размещаться в segment согласно своей фактической роли, а не только расширению или имени.
|
|||
|
|
|
|||
|
|
**SLM-SEG-004 - ЗАПРЕЩЕНО.** Segment не имеет внешнего public API независимо от module owner.
|
|||
|
|
|
|||
|
|
**SLM-SEG-005 - ЗАПРЕЩЕНО.** Нельзя импортировать segment другого module через deep path.
|
|||
|
|
|
|||
|
|
## UI и Parts
|
|||
|
|
|
|||
|
|
`ui/` содержит presentation components без самостоятельного architectural ownership.
|
|||
|
|
|
|||
|
|
`parts/` содержит nested modules с собственной внутренней структурой и локальным public boundary.
|
|||
|
|
|
|||
|
|
**SLM-SEG-006 - ОБЯЗАН.** Сущность с самостоятельной ответственностью, внешними архитектурными dependencies или nested modules должна размещаться в `parts`, а не маскироваться как плоский component. Локальные presentation hooks/state сами по себе не требуют `parts`.
|
|||
|
|
|
|||
|
|
## Hooks
|
|||
|
|
|
|||
|
|
**SLM-SEG-007 - ОБЯЗАН.** Hook принадлежит тому module, чью ответственность и runtime он выражает.
|
|||
|
|
|
|||
|
|
Примеры:
|
|||
|
|
|
|||
|
|
- domain hook - `domains/{domain}/react/hooks`;
|
|||
|
|
- page-local hook - владеющая page composition;
|
|||
|
|
- reusable technical hook - соответствующий infra module;
|
|||
|
|
- product-agnostic UI hook - владеющий UI module.
|
|||
|
|
|
|||
|
|
## Domain zones и segments
|
|||
|
|
|
|||
|
|
**SLM-SEG-008 - ЗАПРЕЩЕНО.** Domain zones `business`, `react`, `adapters`, `client`, `server` нельзя трактовать как взаимозаменяемые generic segments.
|
|||
|
|
|
|||
|
|
Внутри zone могут существовать обычные segments:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
domain/
|
|||
|
|
├── business/
|
|||
|
|
│ ├── services/
|
|||
|
|
│ ├── types/
|
|||
|
|
│ └── mappers/
|
|||
|
|
└── react/
|
|||
|
|
├── hooks/
|
|||
|
|
├── providers/
|
|||
|
|
└── ui/
|
|||
|
|
```
|