Миграция домена auth с Level 1

Проверочный пример перехода от доменного модуля к доменному пакету.

Связанное правило

SLM-L2-MIGRATION-A017

Исходная форма Level 1

domains/auth/                  # Доменный модуль
├── hooks/
├── services/
├── stores/
├── ui/
└── index.ts                  # Общий API модуля

Level 1 разрешает business-сценариям, framework hooks, state adapter и локальной сборке находиться внутри одного модуля.

Целевая форма Level 2

domains/auth/                  # Доменный пакет
├── README.md
├── business/                 # SLM-модуль
│   ├── errors/
│   ├── lib/
│   ├── services/
│   ├── types/
│   └── index.ts
├── presets/                  # Group
│   ├── browser/              # SLM-модуль
│   │   ├── adapters/
│   │   └── index.ts
│   └── request/              # SLM-модуль
│       └── index.ts
└── react/                    # Framework Group
    ├── session/              # SLM-модуль
    │   └── index.ts
    └── login-form/           # SLM-модуль
        └── index.ts

Корневой domains/auth/index.ts удаляется. Потребители переходят на публичные API конкретных модулей.

Перенос ответственности

Исходная часть	Владелец Level 2
Сценарии, предметные типы, единый API	`auth/business`
Коды, тип и guard ошибок	`auth/business`
Browser storage и HTTP adapters	`auth/presets/browser`
Cookies, request data и server adapters	`auth/presets/request`
Provider и session hooks	`auth/react/session`
Переиспользуемая форма	`auth/react/login-form`
Страница, текст и redirect	`compositions`

Новые импорты

import { authFactory, isAuthError } from '@/domains/auth/business'
import { createBrowserAuth } from '@/domains/auth/presets/browser'
import { AuthSessionProvider } from '@/domains/auth/react/session'
import { LoginForm } from '@/domains/auth/react/login-form'

Cross-domain граф

Если User зависит от Auth, оба связанных домена сначала переводятся в пакеты. Затем User получает только type-only контракт:

import type { AuthApi } from '@/domains/auth/business'

export type UserDeps = {
  auth: Pick<AuthApi, 'getSession'>
}

Место сборки графа создаёт экземпляры:

const authApi = createBrowserAuth()
const userApi = createBrowserUser({ authApi })

User не импортирует runtime-код Auth, а его React-модули не импортируют useAuthSession или Auth components.

Порядок перехода

Определить dependency-connected набор доменов, который нужно мигрировать вместе.
Выделить business и одну фабрику без environment-specific import-графа.
Зафиксировать DomainApi, error codes, error type и runtime guard.
Перенести browser/server wiring в нужные presets и adapters.
Разделить React-ответственности на модули внутри Group react.
Перенести страницы, redirects и multi-domain UI в compositions.
Перевести внешние импорты на module-specific paths.
Удалить старый root index.ts и проверить import-граф.

Простые доменные модули могут оставаться в SLM root только как временное миграционное состояние. Они не создают прямые runtime- или type-only зависимости с уже переведёнными пакетами.

4.3 KiB Raw Blame History Unescape Escape