sync

docs/architecture/segments.md

@@ -0,0 +1,92 @@
+# Сегменты
+
+Сегмент организует внутреннее содержимое одного модуля по назначению. Он помогает ориентироваться в реализации владельца, но не создаёт новую ответственность или архитектурную границу.
+
+## Место в модели
+
+Сегмент появляется только внутри уже определённого модуля:
+
+```text
+Слой → [Группа*] → Модуль → [Сегмент*]
+```
+
+Группа классифицирует несколько модулей внутри слоя. Сегмент классифицирует код одного модуля. Ни группа, ни сегмент не являются владельцами.
+
+Все файлы, компоненты, состояние, зависимости и код жизненного цикла сегмента принадлежат родительскому модулю. Исключением является только вложенный модуль, который начинает собственную границу владения.
+
+## Назначение
+
+Сегмент используется, когда группировка внутренних файлов по назначению упрощает навигацию. Набор и названия сегментов определяет проект.
+
+Возможная структура:
+
+```text
+profile/
+├── index.ts
+├── profile.tsx
+├── hooks/          # Возможный сегмент
+├── services/       # Возможный сегмент
+├── stores/         # Возможный сегмент
+├── types/          # Возможный сегмент
+└── ui/             # Возможный сегмент
+```
+
+Ни один из показанных сегментов не обязателен. Маленький модуль может хранить реализацию в корне без дополнительных каталогов.
+
+Сегмент:
+
+- не имеет самостоятельной ответственности;
+- не предоставляет публичный API;
+- не владеет состоянием или жизненным циклом;
+- не является узлом графа зависимостей;
+- не импортируется внешним кодом как отдельная архитектурная сущность.
+
+Локальный `index.ts` может использоваться во внутренней единице сегмента, например в каталоге компонента. Он не превращает эту единицу или сегмент в модульную границу.
+
+## Компоненты и вложенные модули
+
+Сегмент может содержать компоненты и вспомогательные файлы родительского модуля. Компонент вправе иметь локальные `styles/`, `types/`, `tests/` и внутренний `index.ts`; всё это остаётся реализацией ближайшего модуля.
+
+```text
+header/                         # Модуль
+└── components/                 # Сегмент
+    └── button-submit/          # Компонент
+        ├── button-submit.tsx
+        ├── styles/
+        │   └── button-submit.module.css
+        ├── types/
+        │   └── button-submit.types.ts
+        └── index.ts            # Внутренняя точка входа
+```
+
+Внешний код не импортирует `components/button-submit`. Если компонент нужен снаружи, модуль-владелец реэкспортирует его через собственный публичный фасет.
+
+Сегмент также может содержать вложенные модули. В отличие от остальных файлов сегмента, каждый вложенный модуль сам владеет отдельной ответственностью и имеет публичный API и границу зависимостей.
+
+```text
+landing/                  # Родительский модуль
+└── parts/                # Сегмент
+    └── hero/             # Вложенный модуль
+        ├── hero.tsx
+        └── index.ts
+```
+
+Имя `parts` является примером, а не обязательным соглашением SLM.
+
+## Выбор границы
+
+| Ситуация | Решение |
+|---|---|
+| Код относится к существующему владельцу и группируется только по назначению | Сегмент |
+| Части нужна собственная ответственность, API, зависимости, состояние или область жизни | Модуль |
+| Несколько модулей слоя нужно классифицировать для навигации | Группа |
+| Нескольким файлам не нужна отдельная группировка | Оставить в корне модуля |
+
+Размер каталога и количество файлов не определяют выбор между сегментом и модулем.
+
+## Связанные правила
+
+- [`SLM-SEGMENT-R008`](../rules/registry.md#slm-segment-r008)
+- [`SLM-MODULE-A004`](../rules/registry.md#slm-module-a004)
+- [`SLM-COMPONENT-R009`](../rules/registry.md#slm-component-r009)
+- [`SLM-NESTED_MODULE-A010`](../rules/registry.md#slm-nested_module-a010)