chore: границы доменов

docs/architecture/layers.md

@@ -11,8 +11,8 @@ SLM определяет шесть ролей:
 | Слой | Роль |
 |---|---|
 | `app` | Связь приложения с фреймворком: запуск, маршруты, преобразование внешних входных данных и подключение готовых публичных API |
-| `compositions` | Сборка продуктового интерфейса: страницы, макеты, экраны, виджеты и другие композиции |
-| `domains` | Предметные модели, правила, сценарии и продуктовое состояние |
+| `compositions` | Представление и связывание готовых публичных API в страницы, макеты, экраны, виджеты и другие продуктовые композиции |
+| `domains` | Полная реализация предметных ответственностей и сценариев, включая их модели, правила, состояние, операции с продуктовыми данными и доменный UI |
 | `infra` | Технические сервисы и возможности приложения без собственной предметной модели |
 | `ui` | Универсальные интерфейсные модули без зависимости от конкретной продуктовой композиции |
 | `shared` | Детерминированный фундамент без знания о продукте, изменяемого состояния и ввода-вывода |
@@ -27,15 +27,19 @@ SLM определяет шесть ролей:
 
 ### Compositions
 
-`compositions` содержит владельцев продуктовых композиций: страниц, макетов, экранов, виджетов, результатов маршрутов и интерфейса, объединяющего несколько ответственностей.
+`compositions` содержит владельцев представления продуктовых композиций: страниц, макетов, экранов, виджетов, результатов маршрутов и интерфейса, объединяющего несколько готовых модульных возможностей. Композиция размещает и связывает публичные API доменных, инфраструктурных и UI-модулей, но не присваивает их ответственность.
+
+Модуль композиции может владеть структурой страницы, расположением частей интерфейса и состоянием, смысл которого существует только внутри этой композиции. Он не определяет, не реализует, не расширяет и не замещает доменный сценарий. Количество потребителей и использование сценария только на одной странице не меняют эту границу.
 
 Конкретная организация слоя определяется продуктом и фреймворком. Названия `pages`, `layouts`, `screens` и `widgets` могут использоваться как [группы](./groups.md), но не являются дополнительными слоями и не задают направление импортов.
 
 ### Domains
 
-`domains` содержит модули-владельцы предметных ответственностей: моделей, правил, сценариев и продуктового состояния.
+`domains` содержит модули-владельцы полных предметных ответственностей и доменных сценариев. Доменный модуль владеет не только моделями и бизнес-правилами, но и продуктовым состоянием, смыслом операций с продуктовыми данными, предметными исходами, доменным UI и framework-механизмами, которые обслуживают сценарий.
 
-Доменный модуль является обычным SLM-модулем. Ему не требуется отдельная архитектурная форма только потому, что он находится в `domains`.
+Домен является вертикальным владельцем ответственности, а не только каталогом независимой от интерфейса бизнес-логики. Внутри него могут находиться компоненты, Providers, hooks, stores, services и другой код, если он реализует принадлежащий домену результат. Универсальные визуальные элементы домен получает из `ui`, а технические возможности без предметной модели — из `infra`.
+
+Домен является специализированным SLM-модулем: он сохраняет обычную модульную форму и получает дополнительные требования к предметному контракту, адаптации источников и ошибкам. Полная модель описана в разделе [Домены](./domains.md).
 
 ### Infra
 
@@ -53,6 +57,28 @@ SLM определяет шесть ролей:
 
 В `shared` могут находиться обычные модули и небольшие немодульные ресурсы: чистые функции, общие типы, стили, декларативная конфигурация и статические файлы.
 
+## Граница доменов и композиций
+
+Граница определяется смыслом поведения, а не местом его вызова или отображения:
+
+| Код определяет | Слой-владелец |
+|---|---|
+| Продуктовую операцию, правило, переход, предметный исход или состояние | `domains` |
+| Получение или изменение продуктовых данных, параметры операции и смысл её ошибок | `domains` |
+| Форму, список, карточку, Guard или другой UI, выраженный в терминах одного домена | `domains` |
+| Расположение и связывание готовых публичных API на странице или экране | `compositions` |
+| Состояние панели, секции или раскладки, имеющее смысл только в одной композиции | `compositions` |
+| Универсальный визуальный элемент без предметного смысла | `ui` |
+| HTTP-транспорт, тему, локализацию или техническую доставку телеметрии | `infra` |
+
+Если для нового доменного сценария ещё нет подходящего владельца, сначала выбирается существующий или создаётся новый модуль в `domains`. Реализация сценария в `compositions` с намерением перенести её позже не является допустимым промежуточным архитектурным решением.
+
+Композиция может показать рядом несколько доменных возможностей и вызвать их готовые публичные операции. Если координация определяет продуктовый порядок действий, условия, общий предметный результат, политику ошибок или компенсацию между доменами, такая координация сама является доменным сценарием и требует владельца в `domains`.
+
+Разрешённая зависимость `compositions` от `infra` сохраняется. Композиция может использовать тему, локализацию, доставку метрик и другие технические возможности для собственной ответственности. Эта связь не разрешает получать или изменять продуктовые данные через HTTP-клиент, SDK или storage непосредственно из композиции: техническим механизмом владеет `infra`, а смысл такой операции и её продуктовый результат принадлежат домену.
+
+Смысл события метрики принадлежит владельцу наблюдаемого поведения. Домен определяет событие доменного сценария, композиция — событие показа или взаимодействия со своей раскладкой, `app` — событие запуска или маршрутизации, а `infra` отвечает за техническую доставку телеметрии.
+
 ## Направление зависимостей
 
 Слой ограничивает только межслойное направление. Модули одного слоя могут зависеть друг от друга через публичные API, если общий граф остаётся ацикличным.
@@ -77,5 +103,10 @@ SLM определяет шесть ролей:
 - [`SLM-LAYER-R001`](../rules/registry.md#slm-layer-r001)
 - [`SLM-LAYER-A002`](../rules/registry.md#slm-layer-a002)
 - [`SLM-LAYER-R003`](../rules/registry.md#slm-layer-r003)
+- [`SLM-DOMAIN-R022`](../rules/registry.md#slm-domain-r022)
+- [`SLM-DOMAIN-R023`](../rules/registry.md#slm-domain-r023)
+- [`SLM-DOMAIN-R024`](../rules/registry.md#slm-domain-r024)
+- [`SLM-DOMAIN-R025`](../rules/registry.md#slm-domain-r025)
+- [`SLM-DOMAIN-R026`](../rules/registry.md#slm-domain-r026)
 - [`SLM-GROUP-R007`](../rules/registry.md#slm-group-r007)
 - [`SLM-MODULE-R011`](../rules/registry.md#slm-module-r011)