sync

DRAFT/level-2/terminology.md

@@ -28,6 +28,18 @@ Group, размещённая непосредственно в слое `domain
 
 `business` является единственным runtime-источником, через который приложение получает доменные данные, состояние и результаты сценариев. Он не зависит от конкретного фреймворка, среды или технической реализации.
 
+### Публичные фасеты business
+
+Три объявленных entry points одного логического публичного API модуля `business`:
+
+| Путь | Содержимое |
+|---|---|
+| `business` | Только public types, включая `DomainApi`, зависимости, factory type, DomainError и DomainErrorCode |
+| `business/factory` | Единственная runtime-фабрика `DomainApi` |
+| `business/error` | Runtime-коды и guards доменных ошибок |
+
+Фасеты не являются сегментами, вложенными модулями или самостоятельными узлами графа. Любой другой внешний путь внутрь `business` является deep import.
+
 ### Business-safe внешний пакет
 
 Внешняя библиотека, допустимая в import-графе `business`: детерминированная, environment-neutral, не выполняющая ввод-вывод и не владеющая изменяемым состоянием или runtime capability. SDK, generated client, storage, state manager, framework и техническая интеграция не становятся business-safe только из-за совместимости с несколькими средами.
@@ -46,17 +58,23 @@ Group, размещённая непосредственно в слое `domain
 
 ## Техническая сборка
 
+### Техническая зависимость
+
+Явная runtime-возможность, необходимая business-фабрике и требующая production-реализации поверх SDK, storage, API платформы, данных запроса или технического сервиса. Type-only cross-domain API dependency, неизменяемая конфигурация и аргумент отдельного предметного сценария не являются техническими зависимостями.
+
 ### Adapter
 
-Код, который связывает явную зависимость фабрики с SDK, storage, API платформы, данными запроса или техническим сервисом. Adapter может быть закрытым сегментом preset-модуля либо самостоятельным модулем в Group `adapters`.
+SLM-модуль в Group `adapters`, который реализует одну или несколько связанных технических зависимостей фабрики поверх SDK, storage, API платформы, данных запроса или технического сервиса. Каждая production-реализация принадлежит adapter-модулю и не размещается внутри preset или composition.
+
+Group `adapters` обязательна и непуста, если фабрика имеет техническую зависимость. Фабрика без технических зависимостей не требует создания этой Group.
 
 Точная обязательная форма технических портов пока не определена и остаётся открытым вопросом Level 2.
 
 ### Preset
 
-SLM-модуль в Group `presets`, который создаёт `DomainApi` для одного именованного контекста выполнения: браузера, запроса, server action или другого реального окружения. Он выбирает технические реализации и передаёт фабрике готовые runtime-зависимости.
+SLM-модуль в Group `presets`, который создаёт `DomainApi` для одного именованного контекста выполнения: браузера, запроса, server action или другого реального окружения. При наличии технических зависимостей он выбирает их adapter-модули и передаёт фабрике готовые runtime-зависимости.
 
-Архитектура не устанавливает минимальное или максимальное количество presets и не требует универсального изоморфного preset.
+Каждый доменный пакет содержит минимум один preset. Архитектура не ограничивает их максимальное количество и не требует универсального изоморфного preset.
 
 ## Framework binding
 
@@ -74,7 +92,7 @@ Framework binding module получает готовый `DomainApi`, не вы
 
 ### Место сборки графа
 
-Код модуля `composition`, точки входа `app`, request handler или test setup, который создаёт нужные экземпляры `DomainApi` в ацикличном порядке и передаёт уже созданные API последующим presets. Место сборки не становится владельцем предметных или технических ответственностей модулей. Подробный lifecycle собранного графа пока не нормирован Level 2.
+Код модуля `composition`, точки входа `app`, request handler или test setup, который создаёт нужные экземпляры `DomainApi` в ацикличном порядке и передаёт уже созданные API preset-модулям либо напрямую зависимым business-фабрикам. Место сборки не становится владельцем предметных или технических ответственностей модулей. Подробный lifecycle собранного графа пока не нормирован Level 2.
 
 ### Граница среды выполнения
 
@@ -88,9 +106,9 @@ SLM root
     └── доменный пакет
         ├── metadata
         ├── модуль business
-        ├── Group presets
+        ├── обязательная Group presets
         │   └── preset-модуль
-        ├── Group adapters
+        ├── Group adapters при наличии технических зависимостей
         │   └── adapter-модуль
         └── Framework Group react
             ├── модуль session