From b02ee9cd74cbbe814b0fb36e9a83530031af5a95 Mon Sep 17 00:00:00 2001
From: Sergey Krylov <ksv741@mail.ru>
Date: Sat, 20 Jun 2026 13:03:42 +0300
Subject: [PATCH] docs: document broker fsd pilot completion

---
 apps/docs/docs/frontend/overview.md           | 25 ++++++++++++++++++-
 .../frontend-fsd-broker-pilot/tasks.md        | 12 ++++-----
 2 files changed, 30 insertions(+), 7 deletions(-)

diff --git a/apps/docs/docs/frontend/overview.md b/apps/docs/docs/frontend/overview.md
index 38010da..a9e192b 100644
--- a/apps/docs/docs/frontend/overview.md
+++ b/apps/docs/docs/frontend/overview.md
@@ -50,6 +50,15 @@ apps/frontend/src/
 │   ├── StockDetails.tsx
 │   ├── BondDetails.tsx
 │   └── portfolios/
+├── entities/
+│   ├── broker-account/        # FSD pilot: account slice (api, model, ui)
+│   ├── broker-position/       # FSD pilot: position slice (api, model)
+│   └── broker-operation/      # FSD pilot: operation slice (api, model)
+├── widgets/
+│   ├── broker-account-card/         # FSD pilot: account card widget
+│   ├── broker-accounts-summary/     # FSD pilot: accounts summary widget
+│   ├── broker-allocation-chart/     # FSD pilot: allocation chart widget
+│   └── broker-operations-table/     # FSD pilot: operations table widget
 ├── pages/
 │   ├── HomePage.tsx
 │   ├── StockPage.tsx
@@ -58,13 +67,27 @@ apps/frontend/src/
 │   ├── RegisterPage.tsx
 │   ├── ProfilePage.tsx
 │   ├── portfolios/
-│   └── screener/
+│   ├── screener/
+│   ├── broker-accounts/      # FSD pilot: page entrypoint
+│   ├── broker-account/       # FSD pilot: page entrypoint
+│   ├── broker-positions/     # FSD pilot: page entrypoint
+│   └── broker-operations/    # FSD pilot: page entrypoint
 ├── test/
 │   ├── handlers.ts           # MSW handlers
 │   └── test-utils.tsx
 └── styles.css
 ```
 
+## FSD-пилот: broker-домен
+
+Broker-домен переведён в пилотный [Feature-Sliced Design](https://feature-sliced.design/) срез:
+
+- `pages/broker-*` — тонкие route entrypoints без экранной логики
+- `widgets/broker-*` — screen-level композиция (карточки, таблицы, графики)
+- `entities/broker-*` — доменные срезы: account, position, operation (api, model/hooks, ui)
+
+Остальные домены (`portfolio`, `screener`, `auth`) пока остаются в исторической технической структуре.
+
 ## Точка входа
 
 `main.tsx` рендерит `App.tsx`, который содержит `BrowserRouter` → `AppRoutes`.
diff --git a/docs/features/frontend-fsd-broker-pilot/tasks.md b/docs/features/frontend-fsd-broker-pilot/tasks.md
index 7e815e4..ccaff9f 100644
--- a/docs/features/frontend-fsd-broker-pilot/tasks.md
+++ b/docs/features/frontend-fsd-broker-pilot/tasks.md
@@ -25,13 +25,13 @@
 
 ## 4. Broker operation slice
 
-- [ ] Перенести operations query и filter guards в `entities/broker-operation`.
-- [ ] Вынести operations table в widget.
-- [ ] Перенести account layout shell в FSD-структуру и обновить broker nested routes.
+- [x] Перенести operations query и filter guards в `entities/broker-operation`.
+- [x] Вынести operations table в widget.
+- [x] Перенести account layout shell в FSD-структуру и обновить broker nested routes.
 
 ## 5. Cleanup и документация
 
-- [ ] Оставить только безопасные shim/re-export файлы или удалить старые broker entrypoints после
+- [x] Оставить только безопасные shim/re-export файлы или удалить старые broker entrypoints после
   переключения импортов.
-- [ ] Обновить `apps/docs/docs/frontend/overview.md` с описанием broker FSD pilot.
-- [ ] Прогнать frontend tests, lint, build и Docusaurus build.
+- [x] Обновить `apps/docs/docs/frontend/overview.md` с описанием broker FSD pilot.
+- [x] Прогнать frontend tests, lint, build и Docusaurus build.