mirror of
https://github.com/gromlab-ru/slm-design.git
synced 2026-08-22 07:30:16 +03:00
55 lines
4.3 KiB
Markdown
55 lines
4.3 KiB
Markdown
|
# Терминология Level 2
|
|||
|
|
|
|||
|
|
> Нормативные определения рабочего черновика. Этот раздел не объявляет правила.
|
|||
|
|
|
|||
|
|
Level 2 наследует терминологию Level 1 и добавляет определения, необходимые слою `domains`. Структурные сущности Level 1 не меняют смысл.
|
|||
|
|
|
|||
|
|
## Нормативный порядок слоёв
|
|||
|
|
|
|||
|
|
Для Level 2 нормативным является полный порядок:
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
app → compositions → domains → infra → ui → shared
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Нижним считается любой слой справа от исходного. Промежуточный слой не является обязательным посредником.
|
|||
|
|
|
|||
|
|
## Слой `domains`
|
|||
|
|
|
|||
|
|
Слой предметных областей приложения. Он содержит доменные модули и Groups, которые классифицируют эти модули.
|
|||
|
|
|
|||
|
|
Код слоя выражает продуктовые понятия, правила, сценарии или продуктовое состояние, которые не принадлежат устройству одной конкретной страницы, маршрута или визуальной композиции.
|
|||
|
|
|
|||
|
|
## Доменная ответственность
|
|||
|
|
|
|||
|
|
Связная предметная область приложения, которая может включать собственные модели, правила, сценарии и продуктовое состояние. Наличие каждого из этих элементов не является обязательным.
|
|||
|
|
|
|||
|
|
Количество экранов, endpoint-ов, хуков или файлов само по себе не определяет границу доменной ответственности.
|
|||
|
|
|
|||
|
|
## Доменный модуль
|
|||
|
|
|
|||
|
|
Обычный SLM-модуль слоя `domains`, представляющий одну доменную ответственность. Его ближайшей внешней структурной границей является слой `domains` или Group этого слоя, а не другой модуль.
|
|||
|
|
|
|||
|
|
Доменный модуль подчиняется всем правилам модулей Level 1: имеет отдельную папку, одного владельца, единый публичный API, собственный узел графа зависимостей и определённый жизненный цикл ресурсов.
|
|||
|
|
|
|||
|
|
Доменный модуль может содержать корневые файлы, сегменты, компоненты и вложенные модули. Вложенный модуль внутри него остаётся обычным вложенным модулем и не становится самостоятельным доменным модулем.
|
|||
|
|
|
|||
|
|
## Group слоя `domains`
|
|||
|
|
|
|||
|
|
Обычная Group Level 1, которая классифицирует доменные модули по принадлежности к бизнес-приложению, продуктовой области или другому понятному проекту признаку.
|
|||
|
|
|
|||
|
|
Такая Group не является доменом, владельцем ответственности или узлом графа зависимостей. Она не задаёт отдельного направления импортов и не изолирует содержащиеся в ней модули от других Groups.
|
|||
|
|
|
|||
|
|
## Структурная модель
|
|||
|
|
|
|||
|
|
```text
|
|||
|
|
SLM root
|
|||
|
|
└── domains
|
|||
|
|
├── доменный модуль
|
|||
|
|
│ ├── сегменты
|
|||
|
|
│ └── вложенные модули
|
|||
|
|
└── доменный модуль
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Путь помогает определить структурную границу, но не доказывает корректность предметной декомпозиции. Решение о том, является ли ответственность самостоятельным доменом, требует понимания продукта.
|