docs: update frontend overview for portfolio FSD migration

This commit is contained in:
Sergey Krylov 2026-06-20 21:07:53 +03:00
parent 4d6e6620d7
commit 697c4d708a

View File

@ -32,68 +32,51 @@ apps/frontend/src/
│ ├── AppLayout.tsx # Шапка + <Outlet/> │ ├── AppLayout.tsx # Шапка + <Outlet/>
│ └── index.ts │ └── index.ts
├── api/ ├── api/
│ ├── auth.ts # re-export shim → entities/session/api │ └── screener.ts # Screener API helpers (не мигрирован)
│ ├── client.ts # HTTP-клиент (fetch)
│ ├── portfolio.ts # Portfolio API helpers
│ ├── responses.ts # Типы ответов (ручные)
│ ├── screener.ts # Screener API helpers
│ └── types.ts # Типы из openapi-typescript
├── context/
│ └── AuthContext.tsx # re-export shim → app/providers/SessionProvider
├── hooks/ ├── hooks/
│ ├── useAuth.ts # re-export shim → entities/session/model │ └── useScreener.ts # Screener hook (не мигрирован)
│ ├── usePortfolio.ts
│ ├── usePortfolioAnalytics.ts
│ ├── usePortfolioMutations.ts
│ ├── usePortfolios.ts
│ ├── usePositionMutations.ts
│ ├── useScreener.ts
│ ├── useSearch.ts
│ ├── useStock.ts
│ ├── useStockCandles.ts
│ ├── useStockDividends.ts
│ ├── useBond.ts
│ └── useBondCandles.ts
├── components/ ├── components/
│ ├── Layout.tsx # re-export shim → app/layouts │ └── screener/ # Screener UI (не мигрирован)
│ ├── ProtectedRoute.tsx # re-export shim → app/routing ├── entities/ # FSD business entities
│ ├── SearchBar.tsx │ ├── session/ # Auth/session (api, model)
│ ├── PriceChart.tsx │ ├── stock/ # Акции (api, model)
│ ├── StockDetails.tsx │ ├── bond/ # Облигации (api, model)
│ ├── BondDetails.tsx │ ├── portfolio/ # Портфели (api, model)
│ └── portfolios/ │ └── search/ # Поиск (model)
├── entities/ ├── widgets/ # FSD compositional widgets
│ ├── session/ # FSD: auth/session (api, model/context + hook) │ ├── stock-details/ # Детальная карточка акции
│ ├── broker-account/ # FSD: account slice (api, model, ui) │ ├── bond-details/ # Детальная карточка облигации
│ ├── broker-position/ # FSD: position slice (api, model) │ ├── price-chart/ # График цены
│ └── broker-operation/ # FSD: operation slice (api, model) │ ├── dividends-table/ # Таблица дивидендов
├── widgets/ │ ├── search-bar/ # Поисковая строка
│ ├── broker-account-card/ # FSD: account card widget │ ├── portfolio-card/ # Карточка портфеля
│ ├── broker-accounts-summary/ # FSD: accounts summary widget │ ├── portfolio-form/ # Форма портфеля
│ ├── broker-allocation-chart/ # FSD: allocation chart widget │ ├── portfolio-summary/ # Сводка портфеля (график + стоимость)
│ └── broker-operations-table/ # FSD: operations table widget │ ├── portfolio-analytics/ # Метрики портфеля
├── pages/ │ ├── share-positions-table/ # Таблица позиций-акций
│ ├── HomePage.tsx │ └── bond-positions-table/ # Таблица позиций-облигаций
│ ├── StockPage.tsx ├── pages/ # FSD page entrypoints
│ ├── BondPage.tsx │ ├── home/ # Главная
│ ├── LoginPage.tsx │ ├── stock/ # Страница акции
│ ├── RegisterPage.tsx │ ├── bond/ # Страница облигации
│ ├── ProfilePage.tsx │ ├── login/ # Вход
│ ├── portfolios/ │ ├── register/ # Регистрация
│ ├── screener/ │ ├── profile/ # Профиль
│ ├── broker-accounts/ # FSD: page entrypoint │ ├── portfolios/ # Список и детальная портфеля
│ ├── broker-account/ # FSD: page entrypoint │ ├── screener/ # Скринер (не мигрирован)
│ ├── broker-positions/ # FSD: page entrypoint │ └── broker-*/ # Брокерские страницы
│ └── broker-operations/ # FSD: page entrypoint
├── test/ ├── test/
│ ├── factories.ts # Фабрики тестовых данных
│ ├── handlers.ts # MSW handlers │ ├── handlers.ts # MSW handlers
│ └── test-utils.tsx │ ├── server.ts # MSW server
│ ├── test-utils.tsx # Обёртка рендера
│ └── setup.ts # Настройка jsdom
└── styles.css └── styles.css
``` ```
## FSD-миграция ## FSD-миграция
### app-слой и session-сущность ### app-слой
Создан `app/` слой FSD, в который перенесены инфраструктурные модули: Создан `app/` слой FSD, в который перенесены инфраструктурные модули:
@ -102,21 +85,41 @@ apps/frontend/src/
- `app/layouts/` — AppLayout (шапка + Outlet) - `app/layouts/` — AppLayout (шапка + Outlet)
- `app/App.tsx` — BrowserRouter → AppRoutes - `app/App.tsx` — BrowserRouter → AppRoutes
Домен auth переведён в `entities/session/`: ### entities
- `entities/session/api/` — login, register, logout, refresh, getMe, updateProfile Домены бизнес-сущностей переведены в FSD:
- `entities/session/model/` — SessionContext, useSession
Старые файлы (`api/auth.ts`, `hooks/useAuth.ts`, `context/AuthContext.tsx`, `routes.tsx`, `components/Layout.tsx`, `components/ProtectedRoute.tsx`, `App.tsx`) сохранены как ре-экспорт шмы для обратной совместимости. | Сущность | api | model | ui |
|----------|-----|-------|----|
| `session` | login, register, refresh, logout, getMe, updateProfile | SessionContext, useSession | — |
| `stock` | getStock, getStockCandles, getStockDividends | useStock, useStockCandles, useStockDividends | — |
| `bond` | getBond, getBondCandles | useBond, useBondCandles | — |
| `portfolio` | CRUD портфелей и позиций, аналитика | usePortfolio, usePortfolios, usePortfolioAnalytics, usePortfolioMutations, usePositionMutations | — |
| `search` | — | useSearch | — |
### broker-домен (пилот) Каждая сущность имеет barrel-файл `index.ts`, реэкспортирующий публичное API.
Broker-домен переведён в пилотный FSD срез: ### widgets
- `pages/broker-*` — тонкие route entrypoints Композиционные блоки UI. Каждый виджет — директория с `index.ts` и `ui/`:
- `widgets/broker-*` — screen-level композиция
- `entities/broker-*` — доменные срезы (api, model, ui)
### Остальные домены - `stock-details`, `bond-details` — детальные карточки бумаг
- `price-chart`, `dividends-table` — графики и таблицы
- `search-bar` — поиск с автодополнением
- `portfolio-card`, `portfolio-form`, `portfolio-summary`, `portfolio-analytics` — UI портфелей
- `share-positions-table`, `bond-positions-table` — таблицы позиций
`portfolio`, `screener` пока остаются в исторической технической структуре. ### pages
Страницы-точки входа. FSD-страницы мигрированы: `home/`, `stock/`, `bond/`, `broker-*`. Временно не мигрированы: `portfolios/`, `screener/`, `LoginPage.tsx`, `RegisterPage.tsx`, `ProfilePage.tsx`.
### Не мигрировано
Скринер остаётся в исторической структуре:
- `api/screener.ts` — API-вызовы
- `hooks/useScreener.ts` — логика с URLSearchParams
- `components/screener/` — FilterPanel, FilterPanelBond, FilterPanelShare, ScreenerTable
- `pages/screener/ScreenerPage.tsx` — страница
ESLint-правила на границы импортов FSD пока не введены.