Frontend FSD Shared Layer

Дата: 2026-06-20 Статус: спецификация

Контекст

Broker FSD pilot завершён: broker-домен работает в FSD-слоях entities/widgets/pages. Следующий шаг миграции — нормализация shared-инфраструктуры. Сейчас общий код размазан по техническим каталогам (api/, components/, context/, hooks/), и FSD-сущности вынуждены импортировать из них через длинные относительные пути (../../../api/client). Это мешает введению import boundaries и усложняет дальнейшую миграцию доменов.

Цель

Создать FSD-слой shared/ с явным public API, в который переносится truly shared инфраструктурный код: базовый HTTP-клиент, типы ответов API, переиспользуемые UI-примитивы без доменной логики.

Область изменений

Входит

Перенос api/client.ts, api/responses.ts, api/types.ts в shared/api/
Перенос компонентов без доменных зависимостей (SkeletonBlock, TableSkeleton) в shared/ui/
Превращение исходных файлов в re-export shims (стратегия coexistence, как в broker pilot)
Переключение импортов в FSD-сущностях и legacy hooks на @/shared/api/...

Не входит

Layout и ProtectedRoute — остаются в components/ (зависят от доменного кода SearchBar, useAuth)
SearchBar, StockDetails, BondDetails, PriceChart — доменные компоненты, остаются на месте
AuthContext — остаётся в context/ (будет перенесён при миграции auth-домена или app-слоя)
Все доменные API-функции (getShare, getBond, searchSecurities и т.д.) — остаются в api/client.ts как есть, будут вынесены при миграции соответствующих доменов
Все доменные типы (ShareResponse, Portfolio, ScreenerItem и т.д.) — остаются в api/responses.ts как есть
Import guards, ESLint boundaries — отложены до стабилизации слоёв

Требования

1. shared/api/ содержит базовую HTTP-инфраструктуру

shared/api/client.ts включает:

Базовый HTTP-клиент (request, setAccessToken, getAccessToken, setOnUnauthorized)
Все доменные API-функции (как временная мера до миграции доменов)

shared/api/responses.ts включает все типы ответов API (как временная мера).

shared/api/types.ts — generated OpenAPI types.

2. shared/ui/ содержит только truly generic UI-компоненты

В shared/ui/ попадают только компоненты без импортов доменного кода:

SkeletonBlock — примитивный скелетон (нет зависимостей)
TableSkeleton — табличный скелетон (зависит только от SkeletonBlock)

Layout и ProtectedRoute остаются в legacy components/, так как импортируют SearchBar и useAuth.

3. Coexistence через shims

Исходные файлы в api/ и components/ превращаются в re-export shims.

4. FSD-сущности импортируют через @/shared/

Импорты в entities/widgets/pages меняются с относительных на @/shared/api/....

Acceptance Criteria

src/shared/api/client.ts, responses.ts, types.ts существуют и экспортируют всё, что экспортировали исходные файлы
src/shared/ui/SkeletonBlock.tsx и src/shared/ui/TableSkeleton.tsx существуют
Исходные файлы api/client.ts, api/responses.ts, api/types.ts стали re-export shims
Исходные файлы components/SkeletonBlock.tsx, components/TableSkeleton.tsx стали re-export shims
Все FSD entity импорты ../../../api/... заменены на @/shared/api/...
Все legacy hooks используют @/shared/api/... вместо ../api/...
npm test -w apps/frontend — PASS
npm run lint -w apps/frontend — PASS
npm run build -w apps/frontend — PASS

Ограничения

Никаких изменений поведения UI
Не меняется структура ответов API
Layout, ProtectedRoute, AuthContext остаются на месте
Не затрагиваются backend, docs, CI

5.0 KiB Raw Blame History Unescape Escape