moex-vibe/docs/roadmap.md

Roadmap

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

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

Аутентификация

• auth-system — полноценная регистрация, вход, JWT + refresh token, страницы login/register/profile, session provider.

Документация

• docusaurus-docs — 30+ страниц документации, ADR, диаграммы.
• russian-docs-and-architecture-diagrams — документация на русском, декомпозированные схемы архитектуры.

DevOps

• ci-cd — Gitea Actions: lint, test, build всех пакетов + Storybook.
• pre-commit-checks — Husky + lint-staged.

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

Backend Architecture

Цель: удерживать backend-архитектуру, security boundaries и published contracts в состоянии, пригодном для безопасного развития продукта.

• Backend Architecture Improvements — envelope DTO, screener TTL, domain exceptions, health checks, middleware DI, MoexClient split.
• Backend Architecture Refactor — refactor-only итерация: error masking, production config hardening, DTO validation, typed T-Bank boundary, cache metadata, backend docs sync.

Портфель брокера

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

• T-Bank broker portfolios — интеграция с gRPC, синхронизация счетов/позиций/операций.
• Отображение брокерского портфеля — таблицы позиций по классам, история операций с пагинацией.
• Разделы брокерского счёта — навигация по вкладкам, обзор/позиции/операции/события.
• Информативный обзор брокерских счетов — сводка по всем счетам с агрегацией.
• Календарь событий и прогноз будущих выплат — вкладка событий и прогноз выплат по диапазону дат.
• Исправление deadline и очереди T-Bank — deadline внутри PQueue, best-effort обогащение.
• Улучшение UI операций
• Пагинация и загрузка позиций
• Аналитика прибыльности брокерского счёта — endpoint и вкладка аналитики: вложения, дивиденды, купоны, доходность

Портфельная страница

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

• Portfolio CRUD — создание/редактирование ручных портфелей, добавление позиций.
• График распределения — SVG donut chart.
• Обогащение списка портфелей — batch MOEX обогащение (totalValue, positionCount).
• Оптимизация обогащения — batch-методы MoexClient.
• Аналитика портфеля — Phases 1–3: cost basis + PnL, дивидендный доход, target allocation.
• Пагинация и overlay загрузки — overlay + спиннер при переключении страниц во всех брокерских таблицах (Positions + Operations)

Контроль качества

• Покрытие frontend-тестами — Vitest + Testing Library + MSW, тесты в colocation.
• Quality gate и контрактная документация — docs обновлены, OpenAPI актуален, openapi-artifacts проверка добавлена.

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

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

Backend Architecture Improvements

• Shared envelope DTO — единый ApiResponseMeta вместо 6 дублирующихся классов
• Screener TTL — отдельный кеш-параметр CACHE_SCREENER_TTL (900s)
• Domain exception hierarchy — DomainException, EntityNotFoundException, MoexApiException, TBankApiException
• Health check прокачка — проверки Prisma, MOEX, T-Bank с детальным статусом
• RequestLoggingMiddleware — подключение через configure() в AppModule
• MoexClientService split — 6 клиентов вместо God Service, убран @Global()

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

Ниже опубликован canonical architecture backlog после architecture-quality-backlog. Старые granular заметки folded into these tracks и не должны вестись как параллельные независимые backlog-списки.

• Миграция таблиц на дизайн-систему — DividendsTable, ScreenerTable, SharePositionTable, BondPositionTable мигрированы на DataTable. Legacy shared/ui/Table и TableSkeleton удалены.
• T-Bank data isolation and ownership boundaries (P0/P1) — изоляция T-Bank данных по пользователям, ownership model и backend query boundary до следующих data-flow изменений
• Backend runtime and auth hardening (P1) — отдельная security/runtime policy итерация: rate limiting, auth surface hardening, explicit production rules
• Local T-Bank read-path (P1) — локальная persisted read-модель операций/истории вместо прямого read-through из T-Bank
• Session model for multiple surfaces (P1/P2) — device-level sessions, rotation, reuse detection, явный session contract для нескольких клиентских поверхностей
• Contract, type-safety, and frontend delivery hardening (P2/P3) — устранение остаточного as any, укрепление API/query boundaries, quality/performance gates и lazy-loading budgets
• Broker portfolio value history (P2/P3) — хранить снапшоты стоимости брокерского счёта и показать график динамики портфеля на дашборде
• Broker-events — UX доработки и смешанный календарь.