feat: Добавить VitePress

2026-08-22 07:30:16 +03:00 · 2026-07-25 17:56:16 +03:00
parent cfcff10c58
commit 6f6e4896af
80 changed files with 4663 additions and 665 deletions
--- a/docs/ru/specification/modes/pro/domains/business.md
+++ b/docs/ru/specification/modes/pro/domains/business.md
@@ -0,0 +1,130 @@
+---
+title: Business в SLM Pro
+status: draft
+normative: true
+overlay: pro
+base: slm
+---
+
+# Business
+
+> Overlay: `SLM Pro`.
+
+`business` является framework-neutral зоной domain и единственным владельцем его продуктовой semantics.
+
+## Структура
+
+```text
+domains/{group...}/{domain}/business/
+├── {domain}.factory.ts
+├── index.ts
+├── types/
+├── ports/
+├── services/
+├── errors/
+├── mappers/
+├── selectors/
+├── validators/
+└── lib/
+```
+
+Конкретный набор внутренних segments определяется размером domain. Обязательны роль factory и public boundary, но не каждая папка из примера.
+
+## Factory boundary
+
+**SLM-PRO-BUS-001 - ОБЯЗАН.** Business должен создавать public runtime API через factory `{domain}Factory`.
+
+**SLM-PRO-BUS-002 - ОБЯЗАН.** Factory должна принимать все runtime capabilities через business-owned dependency contracts.
+
+**SLM-PRO-BUS-003 - ОБЯЗАН.** Factory должна возвращать framework-neutral DomainRuntime. Stateless logic API считается DomainRuntime и соблюдает тот же public boundary.
+
+**SLM-PRO-BUS-004 - ЗАПРЕЩЕНО.** Factory не может возвращать React hooks, components, Providers, layouts, route guards или framework boundaries.
+
+**SLM-PRO-BUS-005 - ЗАПРЕЩЕНО.** Factory constructor не может выполнять I/O, открывать socket, регистрировать subscription, запускать timer или читать hidden environment.
+
+## Public API
+
+**SLM-PRO-BUS-006 - ОБЯЗАН.** `business/index.ts` должен экспортировать единственное runtime value: factory.
+
+**SLM-PRO-BUS-007 - МОЖЕТ.** `business/index.ts` может экспортировать business-owned types через `export type`.
+
+```ts
+export { authFactory } from './auth.factory'
+
+export type {
+  AuthDeps,
+  AuthFactory,
+  AuthRuntime,
+  AuthState,
+} from './types'
+```
+
+**SLM-PRO-BUS-008 - ЗАПРЕЩЕНО.** Error classes, error guards, error code constants, selectors, validators, formatters, services, mappers и port implementations не экспортируются как отдельные runtime values.
+
+Если внешнему consumer нужна такая capability, она должна быть осмысленной частью factory runtime API, а не обходным direct export.
+
+## Runtime API
+
+DomainRuntime может предоставлять:
+
+- commands;
+- imperative queries;
+- snapshots;
+- subscriptions;
+- selectors через стабильные methods;
+- validation operations;
+- typed outcomes;
+- explicit lifecycle operations.
+
+**SLM-PRO-BUS-009 - ОБЯЗАН.** Runtime API должен говорить на языке domain и не повторять endpoint names, SDK tree или storage schema.
+
+**SLM-PRO-BUS-010 - ЗАПРЕЩЕНО.** Public contract не может раскрывать generated DTO, SDK client, query-library result, concrete store API, raw Context или adapter.
+
+## Dependencies и ports
+
+**SLM-PRO-BUS-011 - ОБЯЗАН.** Business-owned dependency описывает минимальную внешнюю возможность на языке domain.
+
+```ts
+export type AuthPhonePort = {
+  requestCode: (phone: string) => Promise<unknown>
+  verifyCode: (input: VerifyPhoneCodeInput) => Promise<unknown>
+}
+```
+
+**SLM-PRO-BUS-012 - ОБЯЗАН.** Ненадёжный внешний результат должен приниматься как `unknown`, если business обязан проверить его runtime-форму.
+
+**SLM-PRO-BUS-013 - ЗАПРЕЩЕНО.** Business dependency не может быть generated DTO, полный SDK client, `StoreApi`, QueryClient или framework hook.
+
+**SLM-PRO-BUS-014 - ОБЯЗАН.** Subscription port должен предоставлять cleanup contract.
+
+## Imports
+
+Business может runtime-импортировать:
+
+- собственные файлы;
+- детерминированный `shared`;
+- pure libraries без I/O, hidden state и public type leakage.
+
+Business может type-only импортировать стабильный public contract другого domain, если dependency невозможно корректно описать локальным port. Локальный consumer-owned port является предпочтительным вариантом.
+
+**SLM-PRO-BUS-015 - ЗАПРЕЩЕНО.** Business не импортирует React, query runtime, state manager, SDK, generated operation, HTTP client, storage implementation, browser API, infra, composition или assembly.
+
+Cross-domain imports дополнительно регулируются правилами `SLM-PRO-XDOM-*` в [Cross-domain boundary](./cross-domain-boundary.md).
+
+## Normalization и errors
+
+**SLM-PRO-BUS-017 - ОБЯЗАН.** External result должен быть нормализован в business-owned model до выхода из DomainRuntime.
+
+**SLM-PRO-BUS-018 - ОБЯЗАН.** Malformed successful response должен считаться нарушением runtime contract, а не валидным отсутствием данных.
+
+**SLM-PRO-BUS-019 - ОБЯЗАН.** Expected domain outcome и technical failure должны быть различимы в public contract.
+
+**SLM-PRO-BUS-020 - ЗАПРЕЩЕНО.** Source error, HTTP status, SDK error class, raw response и transport message не могут быть consumer contract.
+
+Business может выражать ожидаемые outcomes через typed result или domain error. Эта draft-версия не предписывает единственную форму обработки ожидаемых ошибок, но требует business-owned semantics и стабильных discriminants.
+
+## State
+
+**SLM-PRO-BUS-021 - ОБЯЗАН.** Business владеет domain state model, допустимыми transitions и semantics commands/selectors.
+
+Framework-neutral state runtime может быть создан самой factory или предоставлен через business-owned port. Concrete store implementation остаётся запрещённой dependency по [SLM-PRO-BUS-015](#imports) и не раскрывается в public API.
--- a/docs/ru/specification/modes/pro/domains/client-and-server.md
+++ b/docs/ru/specification/modes/pro/domains/client-and-server.md
@@ -0,0 +1,105 @@
+---
+title: Client и server assembly в SLM Pro
+status: draft
+normative: true
+overlay: pro
+base: slm
+---
+
+# Client и Server Assembly
+
+> Overlay: `SLM Pro`.
+
+`client` и `server` создают готовые runtime-specific instances одного domain поверх его business factory и adapters.
+
+## Client assembly
+
+```text
+domains/{group...}/{domain}/client/
+├── create-{domain}-client-runtime.ts
+└── index.ts
+```
+
+```ts
+export const createAuthClientRuntime = (): AuthRuntime => {
+  return authFactory({
+    phoneAuth: browserPhoneAuthAdapter,
+    session: browserSessionAdapter,
+  })
+}
+```
+
+Client technical inputs ограничены client environment/config и platform capabilities, необходимыми для создания adapters собственного domain. Runtime values другого domain technical input не являются.
+
+**SLM-PRO-ASM-001 - ОБЯЗАН.** Runtime imports client assembly должны ограничиваться собственной business factory, собственными client adapters, собственной React surface и необходимыми client technical inputs. Type-only foreign contracts допускаются по [SLM-PRO-XDOM-005](./cross-domain-boundary.md#type-only-contracts).
+
+**SLM-PRO-ASM-002 - ОБЯЗАН.** Client assembly должна возвращать готовый runtime собственного domain.
+
+Запрет на foreign runtime values определяется правилом [SLM-PRO-XDOM-001](./cross-domain-boundary.md#runtime-imports).
+
+**SLM-PRO-ASM-004 - МОЖЕТ.** Client или server assembly может принимать готовую внешнюю capability через собственный input contract.
+
+```ts
+createUserClientRuntime({ auth: auth.session })
+```
+
+Такой input не даёт user domain права создавать AuthRuntime или импортировать его client entrypoint.
+
+## Server assembly
+
+```text
+domains/{group...}/{domain}/server/
+├── create-{domain}-server-runtime.ts
+└── index.ts
+```
+
+Server technical inputs ограничены request/framework data, server environment/config и platform capabilities, необходимыми для создания server adapters собственного domain. Runtime values другого domain technical input не являются.
+
+**SLM-PRO-ASM-005 - ОБЯЗАН.** Server assembly должна создавать новый runtime в scope, соответствующем request или другой явно выбранной server lifetime.
+
+**SLM-PRO-ASM-006 - ЗАПРЕЩЕНО.** Server assembly не может повторно использовать adapter или runtime instance, захвативший request credentials, cookies, headers или user-specific state другого scope.
+
+**SLM-PRO-ASM-007 - ОБЯЗАН.** Framework/request input используется только для создания server adapters и не протекает как raw framework object в business API.
+
+**SLM-PRO-ASM-008 - ОБЯЗАН.** Server entrypoint должен иметь явный server-only marker, если framework предоставляет такой механизм.
+
+**SLM-PRO-ASM-016 - ОБЯЗАН.** Runtime imports server assembly должны ограничиваться собственной business factory, собственными server adapters и необходимыми server technical inputs; runtime import React/client surface запрещён. Type-only foreign contracts допускаются по [SLM-PRO-XDOM-005](./cross-domain-boundary.md#type-only-contracts).
+
+## Constructor и activation
+
+Assembly определяет способ создания, но не владеет полным cross-domain graph.
+
+Отсутствие product request, socket connection и background resource при вызове runtime creator определяется base-правилом `SLM-BASE-LIFE-002`.
+
+```text
+module import
+  → определяет creator
+
+creator call
+  → создаёт runtime instance
+
+explicit start
+  → запускает resources
+```
+
+**SLM-PRO-ASM-010 - ОБЯЗАН.** Resources запускает composition scope owner в выбранном scope согласно [lifecycle rules](../../../runtime-and-lifecycle.md).
+
+## Public entrypoints
+
+**SLM-PRO-CMP-004 - ЗАПРЕЩЕНО.** Composition не может повторять adapter wiring, если domain public assembly уже создаёт готовый runtime.
+
+**SLM-PRO-CMP-013 - ОБЯЗАН.** Composition должна использовать public client/server creator domain, если domain предоставляет runtime-specific assembly.
+
+**SLM-PRO-CMP-014 - МОЖЕТ.** Composition может вызвать public business factory напрямую только для universal domain, у которого нет external ports, concrete adapters и runtime-specific input.
+
+**SLM-PRO-ASM-011 - ОБЯЗАН.** Client и server assembly должны иметь разные public entrypoints.
+
+**SLM-PRO-ASM-012 - ЗАПРЕЩЕНО.** Общий domain barrel не может runtime-реэкспортировать одновременно client и server surfaces.
+
+## Server/client bridge
+
+Client и server runtimes являются разными instances над общей business semantics.
+
+Запрет на передачу DomainRuntime, functions, Context, store или query client через serializable server/client boundary определяется правилом [SLM-BASE-DATA-012](../../../state-and-data.md#serializable-boundaries).
+
+**SLM-PRO-ASM-014 - МОЖЕТ.** Server может передать client assembly только serializable business-owned bootstrap data без secrets и mutable runtime objects.
--- a/docs/ru/specification/modes/pro/domains/cross-domain-boundary.md
+++ b/docs/ru/specification/modes/pro/domains/cross-domain-boundary.md
@@ -0,0 +1,125 @@
+---
+title: Cross-domain boundary
+status: draft
+normative: true
+overlay: pro
+base: slm
+---
+
+# Cross-domain Boundary
+
+> Overlay: `SLM Pro`.
+
+Domains не образуют скрытый runtime graph внутри слоя `domains`. Граф связывается только graph owner в `compositions`.
+
+## Composition graph
+
+**SLM-PRO-CMP-001 - ОБЯЗАН.** Runtime graph нескольких domains должен собираться в composition, которая владеет его scope.
+
+```ts
+const auth = createAuthRuntime()
+const user = createUserRuntime({ auth: auth.session })
+const orders = createOrdersRuntime({ user: user.agreements })
+```
+
+**SLM-PRO-CMP-002 - ОБЯЗАН.** Composition должна создавать domain runtimes в явном ацикличном порядке.
+
+**SLM-PRO-CMP-003 - ОБЯЗАН.** Cross-domain dependency должна передаваться как готовая минимальная capability, а не разрешаться service locator или domain import.
+
+**SLM-PRO-CMP-012 - ОБЯЗАН.** App-specific graph type должен отражать только реально предоставленные runtimes; `Partial<Graph>` с последующим приведением к полному graph запрещён.
+
+## Runtime imports
+
+**SLM-PRO-XDOM-001 - ЗАПРЕЩЕНО.** Ни одна zone domain A не может импортировать, реэкспортировать, dynamic-import или разрешать через service locator runtime value domain B.
+
+Запрет включает foreign business API, hooks, Provider, Context, components, adapters, runtime creators и event emitters.
+
+Foreign runtime capability может поступить только argument-ом от composition согласно разделу [Runtime capability injection](#runtime-capability-injection).
+
+## Type-only contracts
+
+**SLM-PRO-API-008 - СЛЕДУЕТ.** Cross-domain capability следует описывать consumer-owned structural port вместо зависимости от полного foreign API type.
+
+**SLM-PRO-XDOM-014 - ЗАПРЕЩЕНО.** Public contract зависимого domain не может реэкспортировать полный foreign DomainRuntime type как собственную cross-domain dependency.
+
+**SLM-PRO-XDOM-005 - МОЖЕТ.** Business и client/server input contracts domain могут type-only импортировать минимальный стабильный business contract другого domain.
+
+Предпочтение consumer-owned port определяется правилом `SLM-PRO-API-008`.
+
+```ts
+export type UserAuthPort = {
+  getSessionSnapshot: () => SessionSnapshot
+  subscribeToSession: (listener: () => void) => () => void
+}
+```
+
+Type-only import не разрешает runtime import и не переносит ownership.
+
+**SLM-PRO-XDOM-012 - ЗАПРЕЩЕНО.** Type dependency cycle между domains запрещён, даже если не создаёт runtime cycle.
+
+## Runtime capability injection
+
+**SLM-PRO-XDOM-007 - МОЖЕТ.** Domain runtime creator может принять готовую structurally compatible capability, созданную другим domain и переданную composition.
+
+```ts
+const auth = createAuthClientRuntime()
+const user = createUserClientRuntime({ auth: auth.session })
+```
+
+User domain знает только свой input contract. Он не знает creator, Provider, adapters и scope AuthRuntime.
+
+**SLM-PRO-XDOM-008 - ОБЯЗАН.** Передаваемая capability должна быть минимальной и не раскрывать raw store, Context, SDK client или mutable internals foreign domain.
+
+**SLM-PRO-XDOM-013 - МОЖЕТ.** Structurally compatible foreign capability может реализовать consumer-owned port напрямую. Wrapper adapter создаётся только при необходимости преобразовать contracts или lifecycle.
+
+## React composition
+
+Если React-сущность использует runtime API двух domains, она принадлежит `compositions`.
+
+```tsx
+const ProtectedOrderForm = () => {
+  const auth = useAuth()
+  const order = useOrder()
+
+  return auth.isAuthenticated
+    ? <OrderForm order={order} />
+    : <AuthPrompt />
+}
+```
+
+**SLM-PRO-XDOM-009 - ОБЯЗАН.** Props, callbacks и slots, передаваемые из composition в domain UI, должны оставаться domain-local или presentation-neutral. Foreign domain semantics остаётся во владеющей composition.
+
+```tsx
+<AuthRequired>
+  <OrderForm />
+</AuthRequired>
+```
+
+Такое связывание выполняется в composition, а не внутри auth или orders.
+
+## Events
+
+Прямая подписка на event emitter другого domain через runtime import запрещена правилом `SLM-PRO-XDOM-001`.
+
+Composition может передать event capability через consumer-owned port:
+
+```ts
+const orders = createOrdersClientRuntime({
+  userEvents: {
+    subscribeToIdentity: user.identity.subscribe,
+  },
+})
+```
+
+## Cycles
+
+**SLM-PRO-XDOM-011 - ЗАПРЕЩЕНО.** Runtime dependency cycle между domains является нарушением границы и не может скрываться event bus, lazy resolution или two-way service locator.
+
+**SLM-PRO-LIFE-008 - ОБЯЗАН.** Cross-domain graph запускается в dependency order и освобождается в обратном порядке.
+
+Ненормативное пояснение: при обнаружении цикла следует пересмотреть один из вариантов:
+
+- пересмотреть границы domains;
+- перенести orchestration в composition;
+- выделить отдельную product responsibility;
+- инвертировать зависимость через consumer-owned port.
--- a/docs/ru/specification/modes/pro/domains/framework.md
+++ b/docs/ru/specification/modes/pro/domains/framework.md
@@ -0,0 +1,81 @@
+---
+title: Framework surface в SLM Pro
+status: draft
+normative: true
+overlay: pro
+base: slm
+---
+
+# Framework Surface
+
+> Overlay: `SLM Pro`.
+
+Framework surface адаптирует готовый DomainRuntime к execution model конкретного framework. В текущей структуре React surface располагается в `react/`.
+
+## Структура React surface
+
+```text
+domains/{group...}/{domain}/react/
+├── context/
+├── providers/
+├── hooks/
+├── ui/
+└── index.ts
+```
+
+Ни один segment не обязателен без реальной потребности.
+
+## Runtime access
+
+**SLM-PRO-FRM-001 - ОБЯЗАН.** Framework surface должна работать с конкретным DomainRuntime через domain-owned runtime access boundary.
+
+**SLM-PRO-FRM-002 - ЗАПРЕЩЕНО.** Framework hook или component не может самостоятельно вызывать business factory, создавать adapters или разрешать runtime из global service locator.
+
+**SLM-PRO-FRM-003 - ОБЯЗАН.** Runtime access boundary должна получать готовый DomainRuntime извне и не создавать параллельное domain state.
+
+Для React типичным механизмом является private Context, связывающий статически экспортированные hooks/components с переданным runtime instance. Это пояснение не предписывает точную форму или количество Providers в текущем draft.
+
+**Domain runtime Provider** - часть framework surface, получающая готовый DomainRuntime и предоставляющая его framework consumers одного domain. Provider не создаёт cross-domain graph автоматически.
+
+## Imports
+
+**SLM-PRO-FRM-004 - ОБЯЗАН.** React surface должна импортировать business runtime contracts только через `import type`.
+
+**SLM-PRO-FRM-005 - ЗАПРЕЩЕНО.** React surface не может runtime-импортировать business factory, private business services, selectors, validators, errors или constants.
+
+**SLM-PRO-FRM-006 - ЗАПРЕЩЕНО.** React surface не может импортировать domain adapters, SDK, product infra client или assembly.
+
+**SLM-PRO-FRM-007 - МОЖЕТ.** React surface может импортировать public API `ui`, `shared` и framework libraries, разрешённые её runtime profile.
+
+Cross-domain runtime imports framework surface запрещены правилом [SLM-PRO-XDOM-001](./cross-domain-boundary.md#runtime-imports).
+
+## Hooks
+
+**SLM-PRO-FRM-009 - ОБЯЗАН.** Domain hook должен получать product data и behavior только через текущий DomainRuntime.
+
+**SLM-PRO-FRM-010 - МОЖЕТ.** Hook может использовать framework query/cache runtime как private implementation поверх imperative DomainRuntime query.
+
+**SLM-PRO-FRM-011 - ЗАПРЕЩЕНО.** Query hook не может использовать adapter или SDK call как fetcher в обход DomainRuntime.
+
+**SLM-PRO-FRM-012 - ЗАПРЕЩЕНО.** Query-library types, cache keys и raw mutate API не могут становиться public business contract.
+
+## Domain UI
+
+Domain React UI может:
+
+- вызывать hooks своего domain;
+- использовать universal UI;
+- отображать domain-owned states и outcomes;
+- принимать callbacks, props и slots от composition.
+
+**SLM-PRO-FRM-013 - ЗАПРЕЩЕНО.** Domain UI не может импортировать runtime другого domain или оркестрировать route/page flow.
+
+Владение React UI, использующим несколько domains, определено base-правилом [SLM-BASE-CMP-006](../../../layers/compositions.md#product-ui).
+
+## Client boundary
+
+**SLM-PRO-FRM-015 - ОБЯЗАН.** Entry point React hooks, Context и interactive UI должен быть явно отмечен как client runtime согласно правилам используемого framework.
+
+**SLM-PRO-FRM-016 - ЗАПРЕЩЕНО.** Server-compatible React export не может попадать в client entrypoint только из-за нахождения рядом с client hooks или Provider.
+
+React не является синонимом client runtime; environment profile определяется фактическими dependencies export.
--- a/docs/ru/specification/modes/pro/domains/index.md
+++ b/docs/ru/specification/modes/pro/domains/index.md
@@ -0,0 +1,158 @@
+---
+title: Domains в SLM Pro
+status: draft
+normative: true
+overlay: pro
+base: slm
+---
+
+# Domains в SLM Pro
+
+> Overlay: `SLM Pro`. Base: [SLM](../../../index.md).
+
+Domain является изолированным вертикальным product module с одной предметной ответственностью, явным public boundary и строгими внутренними dependency zones.
+
+## Domain и group
+
+**SLM-PRO-DOM-001 - ОБЯЗАН.** Конечный Pro domain должен располагаться непосредственно в `domains` или внутри одной или нескольких навигационных groups.
+
+```text
+domains/{domain}
+domains/{group}/{domain}
+domains/{group}/{nested-group}/{domain}
+```
+
+**SLM-PRO-DOM-002 - ОБЯЗАН.** Узел domain tree с собственным public API, state, integration, assembly или runtime должен классифицироваться как конечный domain, а не domain group.
+
+```text
+domains/
+├── navigation/               # domain
+└── knv/                      # group
+    ├── auth/                 # domain
+    ├── user/                 # domain
+    └── orders/               # domain
+```
+
+**SLM-PRO-DOM-003 - ОБЯЗАН.** Первой архитектурной единицей в group tree является конечная папка, владеющая самостоятельной product responsibility.
+
+## Ownership
+
+**SLM-PRO-DOM-004 - ОБЯЗАН.** Pro domain должен владеть одной сформулированной product responsibility и предоставлять её внешним consumers через собственные public entrypoints.
+
+Pro domain может владеть:
+
+- product model и value objects;
+- scenarios и operations;
+- domain state и transitions;
+- normalization и product errors;
+- business-owned ports;
+- concrete integrations собственных ports;
+- framework hooks и UI одного domain;
+- client/server runtime assembly.
+
+**SLM-PRO-DOM-005 - ЗАПРЕЩЕНО.** Domain не может владеть framework route entry, page/layout composition, UI нескольких самостоятельных product responsibilities, universal technical capability или product-agnostic UI primitive.
+
+Public entrypoints Pro domain следуют base-правилам `SLM-BASE-API-001` и `SLM-BASE-API-002`; Pro-главы вводят дополнительные ограничения exports.
+
+**SLM-PRO-DOM-007 - ЗАПРЕЩЕНО.** Если product responsibility получила Pro domain owner, app, composition или infra не могут создавать параллельную модель этой ответственности либо обходить её public boundary.
+
+**SLM-PRO-DOM-008 - ОБЯЗАН.** Для domain-owned responsibility это правило заменяет base-правило `SLM-BASE-CMP-001`: business владеет product logic, а composition владеет application flow и runtime graph.
+
+Product responsibility считается устойчивой, если имеет самостоятельную product model или transitions, используется несколькими application flows либо владеет external integration/lifecycle contract.
+
+**SLM-PRO-DOM-017 - ОБЯЗАН.** Каждая устойчивая product responsibility должна иметь Pro domain owner; route/page-local presentation flow остаётся ответственностью composition.
+
+## Внутренние zones
+
+```text
+domains/{group...}/{domain}/
+├── business/
+├── react/
+├── adapters/
+├── client/
+└── server/
+```
+
+| Zone | Статус | Ответственность |
+|---|---|---|
+| [`business`](./business.md) | Обязательная | Product model, factory, ports, scenarios, errors |
+| [`react`](./framework.md) | Опциональная | React runtime access, hooks, Providers, domain UI |
+| [`adapters`](./ports-and-adapters.md) | Опциональная | Concrete реализации business-owned ports |
+| [`client`](./client-and-server.md) | Опциональная | Browser/client assembly одного domain |
+| [`server`](./client-and-server.md) | Опциональная | Server/request assembly одного domain |
+
+**SLM-PRO-DOM-009 - ОБЯЗАН.** Каждый Pro domain должен содержать `business` как единственного владельца product model и business semantics.
+
+**SLM-PRO-DOM-010 - СЛЕДУЕТ.** Опциональную zone следует добавлять только при наличии реального runtime consumer и самостоятельной ответственности.
+
+**SLM-PRO-DOM-011 - ЗАПРЕЩЕНО.** Нельзя создавать пустые симметричные `react`, `adapters`, `client` или `server` на будущее.
+
+**SLM-PRO-DOM-012 - ОБЯЗАН.** Domain zones должны соблюдать внутреннюю dependency direction, даже если физически находятся под одним владельцем.
+
+**SLM-PRO-MOD-001 - ОБЯЗАН.** `business`, `react`, `adapters`, `client` и `server` являются внутренними zones одного domain, а не самостоятельными верхнеуровневыми modules.
+
+**SLM-PRO-SEG-001 - ЗАПРЕЩЕНО.** Domain zones нельзя трактовать как взаимозаменяемые generic segments.
+
+Внутри каждой zone могут использоваться обычные base SLM segments по фактической необходимости.
+
+## Внутреннее направление
+
+```text
+business -> shared | pure libraries
+react -> ui | shared | framework libraries
+adapters -> infra | SDK | platform runtime
+client -> own business factory | own client adapters | own framework surface | client technical inputs
+server -> own business factory | own server adapters | server technical inputs
+```
+
+Матрица описывает runtime imports. React surface может type-only импортировать собственные business contracts, adapters - собственные business ports/types, а client/server inputs - разрешённые cross-domain contracts.
+
+## Путь данных
+
+```text
+composition
+  -> domain client/server assembly при наличии runtime-specific setup
+     или напрямую business factory для universal domain
+  -> DomainRuntime
+  -> business scenario
+  -> business-owned port
+  -> domain adapter
+  -> infra / SDK / storage / external source
+```
+
+**SLM-PRO-DOM-013 - ОБЯЗАН.** DomainRuntime, созданный business factory, должен быть единственным product gateway своего Pro domain для runtime consumers.
+
+Stateless logic API также является DomainRuntime, если он создан factory и соблюдает тот же public boundary.
+
+## Product UI
+
+**SLM-PRO-DOM-014 - МОЖЕТ.** Product UI одной Pro domain responsibility может принадлежать framework surface этого domain.
+
+UI нескольких самостоятельных responsibilities остаётся в `compositions` согласно base-правилу `SLM-BASE-CMP-006`.
+
+## Cross-domain graph
+
+```text
+composition
+  -> создаёт несколько domain runtimes
+  -> передаёт готовые capabilities
+```
+
+Pro domain не создаёт runtime другого domain и не импортирует его runtime surface. Точные правила определены в [Cross-domain boundary](./cross-domain-boundary.md).
+
+**Graph owner** - composition, являющаяся scope owner нескольких DomainRuntime, связанных направленными dependencies в одном ацикличном graph, и определяющая порядок их создания, activation и cleanup.
+
+## Monorepo boundary
+
+**SLM-PRO-DOM-015 - ОБЯЗАН.** Pro domain должен оставаться внутри `apps/{app}/src/domains` до принятия отдельной package-модели.
+
+**SLM-PRO-DOM-016 - ЗАПРЕЩЕНО.** Workspace package не может называться Pro Domain для целей Specification, если он не соответствует application path и ownership этой главы.
+
+## Главы Pro Domain Specification
+
+- [Business](./business.md)
+- [Framework surface](./framework.md)
+- [Ports и adapters](./ports-and-adapters.md)
+- [Client и server assembly](./client-and-server.md)
+- [Cross-domain boundary](./cross-domain-boundary.md)
+- [Тестирование Pro domains](./testing.md)
--- a/docs/ru/specification/modes/pro/domains/ports-and-adapters.md
+++ b/docs/ru/specification/modes/pro/domains/ports-and-adapters.md
@@ -0,0 +1,100 @@
+---
+title: Ports и adapters в SLM Pro
+status: draft
+normative: true
+overlay: pro
+base: slm
+---
+
+# Ports и Adapters
+
+> Overlay: `SLM Pro`.
+
+Port определяет потребность business. Adapter связывает эту потребность с concrete runtime.
+
+## Ownership
+
+```text
+domain/
+├── business/
+│   └── ports/
+└── adapters/
+```
+
+**SLM-PRO-ADP-001 - ОБЯЗАН.** Port должен принадлежать `business` того domain, который потребляет capability.
+
+**SLM-PRO-ADP-002 - ОБЯЗАН.** Concrete adapter должен принадлежать тому же domain, но находиться вне `business`.
+
+**SLM-PRO-ADP-003 - ЗАПРЕЩЕНО.** Infra или external SDK не могут объявлять business port от имени domain.
+
+**SLM-PRO-ADP-014 - ОБЯЗАН.** External technical capability из infra, SDK, storage или platform runtime должна реализовывать business port через adapter собственного domain, а этот adapter должен подключаться assembly того же domain. Готовая capability другого DomainRuntime может удовлетворять consumer-owned port напрямую только по правилу [SLM-PRO-XDOM-013](./cross-domain-boundary.md#runtime-capability-injection).
+
+## Adapter contract
+
+**SLM-PRO-ADP-004 - ОБЯЗАН.** Responsibilities adapter должны ограничиваться применимыми integration operations:
+
+- импортировать type-only business port и domain input types;
+- импортировать public infra API, SDK или platform runtime;
+- переводить domain arguments в transport arguments;
+- возвращать raw/unknown source result для business normalization;
+- подписываться на concrete event source через явный lifecycle contract.
+
+**SLM-PRO-ADP-005 - ЗАПРЕЩЕНО.** Adapter не может выполнять следующие domain/framework responsibilities:
+
+- создавать domain error;
+- выбирать domain fallback;
+- реализовывать business rule;
+- объявлять domain model;
+- экспортировать concrete client consumer-коду;
+- вызывать framework hook;
+- runtime-импортировать или самостоятельно разрешать другой domain runtime.
+
+Adapter может работать с минимальной foreign capability, явно переданной composition, только для преобразования contract или lifecycle согласно `SLM-PRO-XDOM-013`.
+
+**SLM-PRO-ADP-006 - ОБЯЗАН.** Adapter должен реализовывать ровно тот port contract, который необходим business.
+
+**SLM-PRO-ADP-007 - ЗАПРЕЩЕНО.** Нельзя передавать полный client, если port требует ограниченный набор capabilities.
+
+**SLM-PRO-ADP-008 - ЗАПРЕЩЕНО.** Adapter integration logic не должна писаться inline в composition или runtime assembly.
+
+## Client и server adapters
+
+Adapters могут быть разделены по runtime:
+
+```text
+adapters/
+├── client/
+│   ├── browser-session.adapter.ts
+│   └── websocket-orders.adapter.ts
+└── server/
+    ├── request-session.adapter.ts
+    └── server-orders-api.adapter.ts
+```
+
+**SLM-PRO-ADP-009 - ОБЯЗАН.** Client adapter не должен попадать в server graph, а server adapter - в client graph.
+
+**SLM-PRO-ADP-010 - ОБЯЗАН.** Runtime-specific adapter должен иметь явный environment marker, если framework предоставляет такой механизм.
+
+## Event sources
+
+Socket, subscription и event listener реализуют event port:
+
+```ts
+export type OrdersEventsPort = {
+  subscribe: (listener: (event: unknown) => void) => () => void
+}
+```
+
+**SLM-PRO-ADP-011 - ОБЯЗАН.** Event adapter должен возвращать cleanup и не открывать connection при module import.
+
+**SLM-PRO-ADP-012 - ОБЯЗАН.** Wire event проходит business normalization до изменения domain state или передачи consumer-коду.
+
+**SLM-PRO-LIFE-013 - МОЖЕТ.** Один physical transport может обслуживать adapters нескольких domains, если transport остаётся domain-agnostic, а adapters получают суженные channels.
+
+## Public boundary
+
+**SLM-PRO-API-014 - ЗАПРЕЩЕНО.** Public business, framework, client или server entrypoint не может реэкспортировать concrete adapter внешним consumers.
+
+**SLM-PRO-ADP-013 - ЗАПРЕЩЕНО.** `adapters` не имеет внешнего public API для app, compositions или других domains.
+
+Adapters доступны только assembly собственного domain и собственным contract tests.
--- a/docs/ru/specification/modes/pro/domains/testing.md
+++ b/docs/ru/specification/modes/pro/domains/testing.md
@@ -0,0 +1,63 @@
+---
+title: Тестирование Pro domains
+status: draft
+normative: true
+overlay: pro
+base: slm
+---
+
+# Тестирование Pro Domains
+
+> Overlay: `SLM Pro`.
+
+Общие правила [тестирования и соответствия](../../../testing-and-conformance.md) дополняются проверками строгих business, adapter, assembly и framework boundaries.
+
+## Business factory tests
+
+**SLM-PRO-TEST-001 - ОБЯЗАН.** Каждый public method runtime API, возвращаемого factory, должен иметь factory-level tests.
+
+Factory-level tests должны проверять применимые случаи:
+
+- happy path;
+- malformed external result;
+- rejected dependency;
+- синхронное исключение dependency;
+- domain outcome/error semantics;
+- side-effect order;
+- state transition;
+- отсутствие constructor-time I/O;
+- public API shape.
+
+**SLM-PRO-TEST-002 - ОБЯЗАН.** Factory-level test должен создавать runtime через public `business` entrypoint, а не deep-import factory internals.
+
+## Adapter tests
+
+**SLM-PRO-TEST-003 - ОБЯЗАН.** Adapter с mapping, transport payload, error channel или lifecycle должен иметь contract tests на применимые responsibilities.
+
+**SLM-PRO-TEST-004 - ЗАПРЕЩЕНО.** Adapter test не должен дублировать business scenario tests или утверждать domain fallback/error semantics.
+
+## Assembly tests
+
+**SLM-PRO-TEST-005 - ОБЯЗАН.** Client/server assembly tests должны проверять корректную передачу ports, runtime profile isolation и отсутствие I/O при creation.
+
+**SLM-PRO-TEST-006 - ОБЯЗАН.** Server assembly с request data должен иметь isolation test для параллельных scopes.
+
+## Framework tests
+
+**SLM-PRO-TEST-007 - ОБЯЗАН.** Framework surface tests должны проверять runtime access boundary, предсказуемую ошибку при отсутствии runtime boundary, mapping public outcomes и lifecycle integration.
+
+## Composition tests
+
+**SLM-PRO-TEST-009 - ОБЯЗАН.** Tests cross-domain composition должны проверять topology, точный graph contract, переданные capabilities и lifecycle cleanup.
+
+**SLM-PRO-TEST-010 - ОБЯЗАН.** Scope с неполным набором domains не должен типизироваться как полный application graph.
+
+## Architecture checks
+
+**SLM-PRO-TEST-019 - ОБЯЗАН.** Pro repository checks должны проверять применимые строгие domain boundaries:
+
+- client/server markers;
+- forbidden runtime imports между domains;
+- private adapters;
+- business entrypoint shape;
+- zone dependency direction.