slm-design/docs2/specification/modules-and-groups.md

---
title: Модули и группы
status: draft
normative: true
---

# Модули и Группы

## Module

Module является минимальным самостоятельным владельцем ответственности и предоставляет public boundary внешнему коду.

**SLM-MOD-001 - ОБЯЗАН.** Module должен иметь одну сформулированную ответственность и одного архитектурного owner.

**SLM-MOD-002 - ОБЯЗАН.** Внешний consumer взаимодействует с module только через его public API.

**SLM-MOD-003 - СЛЕДУЕТ.** Module следует ограничивать только теми внутренними parts и segments, которые необходимы текущей ответственности.

Типичные modules:

- page, layout, screen или widget в `compositions`;
- technical service в `infra`;
- reusable UI module в `ui`.

`app` содержит framework entries и не обязан организовываться как SLM modules. `shared` может содержать небольшие public units, но не runtime modules.

## Group

Group классифицирует modules и другие groups, но не владеет поведением.

**SLM-MOD-004 - ЗАПРЕЩЕНО.** Group не может иметь `index.ts`, public API, state, runtime, dependencies или assembly.

**SLM-MOD-005 - ЗАПРЕЩЕНО.** Внешний код не может импортировать group path.

**SLM-MOD-006 - МОЖЕТ.** Group может содержать другие groups и конечные modules.

```text
compositions/
└── pages/               # group
    ├── home/            # composition module
    └── profile/         # composition module
```

## Component

Component является presentation unit внутри module и не считается самостоятельным архитектурным owner.

**SLM-MOD-008 - ЗАПРЕЩЕНО.** Component не может самостоятельно выбирать application-level product source, выполнять module wiring или оркестрировать несколько самостоятельных modules.

**SLM-MOD-009 - МОЖЕТ.** Component может владеть локальной presentation mechanics и рендерить другие components, разрешённые слоем владельца.

**SLM-MOD-010 - ОБЯЗАН.** Presentation unit с самостоятельной ответственностью, внешними архитектурными dependencies или внутренней modular structure должна оформляться как module или nested module. Сам факт локального hook/state не делает component модулем.

## Nested module

Самостоятельная часть родительского module может быть оформлена nested module, если имеет собственную ответственность и public boundary только внутри родителя.

```text
compositions/pages/home/
└── parts/
    └── hero-section/
        ├── hero-section.tsx
        └── index.ts
```

**SLM-MOD-011 - ЗАПРЕЩЕНО.** Nested module не может использоваться для сокрытия ответственности, которой фактически владеет другой module или layer.

## Scope evolution

**SLM-MOD-012 - СЛЕДУЕТ.** Код следует поднимать из локального owner в более широкий module только после появления реального совместного consumer или общей ответственности.

**SLM-MOD-013 - ЗАПРЕЩЕНО.** Физическое повторение само по себе не доказывает общий ownership.