moex-vibe/docs/features/frontend-fsd-market-pages/spec.md

Frontend FSD Market Pages

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

Контекст

Предыдущие FSD-итерации мигрировали broker-домен (frontend-fsd-broker-pilot), shared-слой (frontend-fsd-shared-layer), entities stock/bond/portfolio (fsd-entities-migration) и app-слой с auth (frontend-fsd-app-auth).

Рыночные страницы (StockPage, BondPage, HomePage) и их компоненты (StockDetails, BondDetails, PriceChart, SearchBar) остались в исторической технической структуре (components/, hooks/, плоские pages/). Это единственный крупный блок кода вне FSD-структуры, который активно используется пользователями.

Иерархия источников

• Текущая задача пользователя: завершить FSD-миграцию рыночных страниц.
• docs/inbox.md: направление на постепенную FSD-миграцию.
• docs/features/frontend-fsd-broker-pilot/spec.md: эталонный FSD-шаблон.

Цель

Перевести рыночные страницы (stock, bond, home) и связанные компоненты в FSD-структуру, следуя паттерну, установленному broker-пилотом — через widgets, entities и page entrypoints с совместимыми shim-файлами.

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

Фича охватывает только frontend-код рыночных страниц:

• StockPage, BondPage, HomePage — миграция из плоских pages/ в pages/stock/, pages/bond/, pages/home/ с FSD-структурой;
• StockDetails, BondDetails — миграция из components/ в widgets/stock-details/, widgets/bond-details/;
• PriceChart — миграция из components/ в widgets/price-chart/;
• SearchBar + useSearch — миграция в widgets/search-bar/ + новый entity entities/search/;
• таблица дивидендов — вынос из StockPage в новый виджет widgets/dividends-table/;
• shim-файлы для обратной совместимости;
• обновление роутинга и layout для импортов из новых FSD-точек входа.

Требования

1. Все компоненты следуют FSD-слоям

• entities — data-слой (API + query hooks). Новый: entities/search/.
• widgets — бизнес-композиция UI. Новые: widgets/stock-details/, widgets/bond-details/, widgets/price-chart/, widgets/search-bar/, widgets/dividends-table/.
• pages — тонкие entrypoints. Новые: pages/stock/, pages/bond/, pages/home/.

1.1 Ownership данных остаётся у pages и entities

• pages/stock и pages/bond владеют route params и orchestration загрузки данных через существующие entity hooks (useStock, useBond, useStockCandles, useBondCandles, useStockDividends).
• widgets/stock-details, widgets/bond-details, widgets/price-chart, widgets/dividends-table остаются презентационно-композиционными и получают готовые данные через props.
• widgets/search-bar владеет локальным UI-состоянием поиска (input, debounced query, dropdown), а query-hook useSearch размещается в entities/search/model/.
• pages/home остаётся статическим page entrypoint без новой data-логики.

2. Границы срезов явные через public API

Каждый widget и entity имеет index.ts barrel с контролируемым экспортом.

Внешний код импортирует market pages/widgets/entities только через их public API (@/pages/stock, @/widgets/search-bar, @/entities/search и т.д.). Deep imports во внутренние model/, api/, ui/ директории не считаются контрактом для внешних потребителей.

3. Поведение UI не меняется

Миграция не добавляет новую функциональность и не пересматривает UX.

4. Совместимость через shim-файлы

Старые пути (components/StockDetails.tsx, hooks/useSearch.ts, pages/StockPage.tsx) становятся re-export shim-файлами, импортирующими из новых FSD-точек входа.

5. Тесты следуют новым границам

Тесты перемещаются вместе с компонентами в соответствующие widget/page/ui-директории.

6. Общая инфраструктура остаётся в shared

HTTP-клиент и типы остаются в shared/api/. PriceChart использует lightweight-charts непосредственно, без дополнительных абстракций.

Ограничения

• Изменения ограничены frontend-пакетом.
• Допускаются связанные обновления опубликованной frontend-документации и ADR, если они отражают новую FSD-структуру market pages.
• Не вводятся ESLint import boundaries или import guards.
• Не мигрируются portfolio и screener страницы.
• Не удаляется мёртвый код (old pages/broker/, api/broker.ts).
• Не меняется backend API, Swagger, codegen.

Acceptance Criteria

• StockDetails доступен через widgets/stock-details.
• BondDetails доступен через widgets/bond-details.
• PriceChart доступен через widgets/price-chart.
• SearchBar доступен через widgets/search-bar и использует query/public API из entities/search.
• DividendsTable вынесен из StockPage в widgets/dividends-table.
• StockPage доступен через pages/stock.
• BondPage доступен через pages/bond.
• HomePage доступен через pages/home.
• Все старые пути (components/*, hooks/useSearch, pages/StockPage/BondPage/HomePage) — re-export shims, импортирующие из новых FSD-точек входа.
• app/routing/AppRoutes.tsx и app/layouts/AppLayout.tsx импортируют из новых FSD-точек входа.
• pages/stock и pages/bond сохраняют orchestration загрузки market data и передают widgets готовые props без переноса route/query orchestration внутрь widgets.
• Frontend lint, tests и build проходят.
• Пользовательское поведение эквивалентно.
• ADR и документация обновлены.

Не цели

• Миграция portfolio, screener и остальных доменов.
• Введение жёстких правил импортов.
• Удаление мёртвого кода (old pages/broker/, api/broker.ts).
• Переписывание стилей или визуального дизайна.
• Добавление новой функциональности.