mirror of
https://github.com/gromlab-ru/slm-design.git
synced 2026-08-22 07:30:16 +03:00
102 lines
4.3 KiB
Markdown
102 lines
4.3 KiB
Markdown
# Миграция домена auth с Level 1
|
||
|
||
> Проверочный пример перехода от доменного модуля к доменному пакету.
|
||
|
||
## Связанное правило
|
||
|
||
- [`SLM-L2-MIGRATION-A017`](../../rules/level-2.md#slm-l2-migration-a017)
|
||
|
||
## Исходная форма Level 1
|
||
|
||
```text
|
||
domains/auth/ # Доменный модуль
|
||
├── hooks/
|
||
├── services/
|
||
├── stores/
|
||
├── ui/
|
||
└── index.ts # Общий API модуля
|
||
```
|
||
|
||
Level 1 разрешает business-сценариям, framework hooks, state adapter и локальной сборке находиться внутри одного модуля.
|
||
|
||
## Целевая форма Level 2
|
||
|
||
```text
|
||
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` |
|
||
|
||
## Новые импорты
|
||
|
||
```ts
|
||
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 контракт:
|
||
|
||
```ts
|
||
import type { AuthApi } from '@/domains/auth/business'
|
||
|
||
export type UserDeps = {
|
||
auth: Pick<AuthApi, 'getSession'>
|
||
}
|
||
```
|
||
|
||
Место сборки графа создаёт экземпляры:
|
||
|
||
```ts
|
||
const authApi = createBrowserAuth()
|
||
const userApi = createBrowserUser({ authApi })
|
||
```
|
||
|
||
User не импортирует runtime-код Auth, а его React-модули не импортируют `useAuthSession` или Auth components.
|
||
|
||
## Порядок перехода
|
||
|
||
1. Определить dependency-connected набор доменов, который нужно мигрировать вместе.
|
||
2. Выделить `business` и одну фабрику без environment-specific import-графа.
|
||
3. Зафиксировать `DomainApi`, error codes, error type и runtime guard.
|
||
4. Перенести browser/server wiring в нужные presets и adapters.
|
||
5. Разделить React-ответственности на модули внутри Group `react`.
|
||
6. Перенести страницы, redirects и multi-domain UI в `compositions`.
|
||
7. Перевести внешние импорты на module-specific paths.
|
||
8. Удалить старый root `index.ts` и проверить import-граф.
|
||
|
||
Простые доменные модули могут оставаться в SLM root только как временное миграционное состояние. Они не создают прямые runtime- или type-only зависимости с уже переведёнными пакетами.
|