# Roadmap

Roadmap отражает порядок продуктовой работы, но сам по себе не является основанием для реализации.
Требования и разрешение на реализацию определяются спецификацией конкретной фичи и текущей задачей
пользователя.

## Завершённые эпики

### [Аутентификация](epics/Authentication.md)

- [x] [auth-system](features/auth-system/spec.md) — полноценная регистрация, вход, JWT + refresh token,
  страницы login/register/profile, session provider.

### [Документация](epics/Documentation.md)

- [x] [docusaurus-docs](features/docusaurus-docs/spec.md) — 30+ страниц документации, ADR, диаграммы.
- [x] [russian-docs-and-architecture-diagrams](features/russian-docs-and-architecture-diagrams/spec.md) —
  документация на русском, декомпозированные схемы архитектуры.

### [DevOps](epics/DevOps.md)

- [x] [ci-cd](features/ci-cd/spec.md) — Gitea Actions: lint, test, build всех пакетов + Storybook.
- [x] [pre-commit-checks](features/pre-commit-checks/spec.md) — Husky + lint-staged.

## Активные эпики

### [Портфель брокера](epics/BrokerPortfolio.md)

Цель: дать пользователю целостный доступ к реальным брокерским счетам T-Bank.

- [x] [T-Bank broker portfolios](features/tbank-broker-portfolios/spec.md) — интеграция с gRPC,
  синхронизация счетов/позиций/операций.
- [x] [Отображение брокерского портфеля](features/broker-portfolio-display/spec.md) — таблицы позиций
  по классам, история операций с пагинацией.
- [x] [Разделы брокерского счёта](features/broker-account-sections/spec.md) — навигация по вкладкам,
  обзор/позиции/операции/события.
- [x] [Информативный обзор брокерских счетов](features/broker-accounts-overview/spec.md) —
  сводка по всем счетам с агрегацией.
- [x] [Календарь событий и прогноз будущих выплат](features/broker-events-and-payouts/spec.md) —
  вкладка событий и прогноз выплат по диапазону дат.
- [x] [Исправление deadline и очереди T-Bank](features/tbank-deadline-queue-fix/spec.md) — deadline
  внутри PQueue, best-effort обогащение.
- [~] [Улучшение UI операций](features/broker-operations-ui-improvements/spec.md) — черновик,
  `keepPreviousData` внедрён, `formatMoney` с префиксом не реализован.
- [~] [Пагинация и загрузка позиций](features/broker-positions-pagination-and-loading/spec.md) —
  черновик, пагинация и скелетоны есть, отдельная секция позиций не выделена.

### [Портфельная страница](epics/PortfolioDashboard.md)

Цель: страница управления портфелями — создание, аналитика, распределение.

- [x] [Portfolio CRUD](features/portfolio/spec.md) — создание/редактирование ручных портфелей,
  добавление позиций.
- [x] [График распределения](features/portfolio-allocation-chart/spec.md) — SVG donut chart.
- [x] [Обогащение списка портфелей](features/portfolio-list-enrichment/spec.md) — batch MOEX
  обогащение (totalValue, positionCount).
- [x] [Оптимизация обогащения](features/portfolio-enricher-optimization/spec.md) — batch-методы
  MoexClient.
- [~] [Аналитика портфеля](features/portfolio-analytics/spec.md) — Phase 1 (cost basis + PnL)
  реализован; Phase 2 (дивиденды) и Phase 3 (target allocation) частично.
- [~] [Пагинация и overlay загрузки](features/pagination-loading-overlay/spec.md) — черновик,
  `keepPreviousData` и `loading-spinner` есть, компонент `TableLoadingOverlay` не выделен.

### [Контроль качества](epics/QualityAssurance.md)

- [x] [Покрытие frontend-тестами](features/frontend-test-coverage/spec.md) — Vitest + Testing Library +
  MSW, тесты в colocation.
- [~] [Quality gate и контрактная документация](features/quality-gate-contract-docs/spec.md) —
  docs обновлены, OpenAPI актуален; некоторые AC в работе.

## Крупные завершённые работы (вне эпиков)

- [x] [FSD-миграция фронтенда](features/fsd-frontend-refactor/spec.md) — поэтапный переход на
  Feature-Sliced Design через 10+ features: entities, shared, market pages, broker pilot,
  portfolios, screener, app-auth, cleanup, final.
- [x] [Дизайн-система](features/design-system-foundation/spec.md) — `@moex-vibe/design-system`:
  три уровня токенов, MUI theme, DataTable, базовые компоненты, Storybook.
- [x] [Миграция брокерских разделов на DS](features/broker-account-sections-ds-migration/spec.md)
- [x] [Миграция страницы счетов на DS](features/broker-accounts-page-migration/spec.md)
- [x] [Pilot-миграция](features/pilot-migration/spec.md) — HomePage + SearchBar на DS.
- [x] [Security screener](features/security-screener/spec.md) — Phase 1: фильтры, таблица, backend.
- [x] [MVP](features/moex-vibe/spec.md) — поиск, карточки акций/облигаций, графики, дивиденды.
- [x] [Frontend debt audit and backlog](features/frontend-debt-audit/spec.md) — audit frontend-техдолга,
  разделение open items на 4 follow-up фичи, синхронизация inbox/roadmap
- [x] [frontend-docs-sync](features/frontend-docs-sync/spec.md) — синхронизация docs с состоянием кода
- [x] [frontend-infrastructure-hardening](features/frontend-infrastructure-hardening/spec.md) —
  browser mock mode, env validation, tooling consistency, contract freshness
- [x] [frontend-shared-boundary-cleanup](features/frontend-shared-boundary-cleanup/spec.md) —
  сужение shared/public API, устранение boundary ambiguity
- [x] [frontend-test-hygiene](features/frontend-test-hygiene/spec.md) — минимизация test helpers,
  нормализация conventions

## Кандидаты следующих фич

- [ ] [Миграция таблиц на дизайн-систему](features/table-migration/spec.md) — перевести legacy-таблицы
  на `DataTable` поверх `TanStack Table`.
- [ ] T-Bank data isolation and multi-tenancy (P0/P1) — изолировать данные T-Bank по пользователям,
    ownership модель
- [ ] API envelope runtime contract (P1) — устранить double-wrapping, унифицировать envelope
- [ ] Auth security hardening (P1) — production-секреты, CORS allowlist, error masking, rate limiting
- [ ] Local T-Bank read-path (P1) — чтение истории операций из локальной БД вместо прямого вызова T-Bank
- [ ] Session model for multiple surfaces (P1/P2) — device-level сессии, rotation, reuse detection
- [ ] Type safety hardening (P2) — включение `no-explicit-any`, устранение `as any` в gRPC/screener/tests
- [ ] Testing strategy expansion (P2) — coverage thresholds, contract tests, Playwright smoke
- [ ] Frontend delivery optimization (P3) — route-level lazy loading, performance budgets
- [ ] Аналитика портфеля Phases 2–3 — дивидендный доход, сравнение с target allocation.
- [ ] Quality gate — завершить оставшиеся AC.
- [ ] Broker-events — UX доработки и смешанный календарь.