# Разделы брокерского счёта

Дата: 2026-06-18
Статус: реализовано
Эпик: [Портфель брокера](../../epics/BrokerPortfolio.md)

## Цель

Сделать страницу конкретного брокерского счёта кратким и понятным обзором, а подробные позиции и
операции разнести по самостоятельным разделам, не теряя контекст выбранного счёта.

## Пользовательский результат

Пользователь может:

- быстро увидеть полную стоимость счёта, денежный остаток и текущую структуру активов;
- понять, сколько разных акций и выпусков облигаций находится на счёте;
- перейти к отдельной таблице акций или облигаций;
- увидеть последние операции на overview и открыть всю доступную историю;
- отфильтровать историю по одному точному типу операции, например только по выплатам купонов или
  только по обычному налогу.

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

Фича изменяет опыт работы с конкретным брокерским счётом и включает:

- обзор счёта;
- общую навигацию разделов счёта;
- отдельный раздел акций;
- отдельный раздел облигаций;
- отдельный раздел операций;
- данные сводки, необходимые для точных счётчиков позиций.

## Требования

### 1. Общая навигация

- Разделы `Обзор`, `Акции`, `Облигации` и `Операции` принадлежат одному выбранному брокерскому счёту.
- На широком экране разделы доступны через постоянное боковое меню.
- На узком экране боковое меню заменяется горизонтальными прокручиваемыми вкладками.
- Активный раздел визуально и семантически обозначен.
- Переход между разделами не меняет выбранный брокерский счёт.

### 2. Обзор счёта

Overview показывает:

- название счёта;
- полную стоимость портфеля;
- денежный остаток;
- существующие показатели дневной и ожидаемой доходности;
- круговую диаграмму структуры портфеля;
- карточку акций с количеством разных позиций, стоимостью и долей;
- карточку облигаций с количеством разных выпусков, стоимостью и долей;
- пять последних доступных операций;
- переход ко всей доступной истории операций.

Карточки акций и облигаций ведут в соответствующие разделы счёта.

### 3. Распределение портфеля

- Проценты рассчитываются от полной стоимости счёта, включая денежный остаток.
- Диаграмма поддерживает срезы `Акции`, `Облигации`, `ETF/фонды`, `Деньги` и `Прочие`.
- `Прочие` объединяет остальные и неизвестные классы инструментов.
- Срез с нулевым значением не отображается.
- Отрицательное значение не отображается как сектор диаграммы и показывается текстом рядом со
  сводкой.
- Легенда показывает название среза, денежную стоимость и процент.
- Информация остаётся понятной без различения цветов.

### 4. Счётчики позиций

- Количество акций означает число разных позиций акций, а не сумму штук всех акций.
- Количество облигаций означает число разных выпусков облигаций, а не сумму штук всех облигаций.
- Счётчики отражают полный состав счёта и не зависят от текущей страницы таблицы.

### 5. Раздел акций

- Раздел показывает только позиции типа `share`.
- Первая версия содержит таблицу с существующими колонками: тикер, название, количество, текущая
  цена и текущая стоимость.
- Тикер ведёт на страницу акции, когда маршрут инструмента может быть определён.
- Таблица сохраняет cursor-пагинацию по 10 позиций.
- При отсутствии акций показывается отдельное пустое состояние.

### 6. Раздел облигаций

- Раздел показывает только позиции типа `bond`.
- Первая версия содержит таблицу с существующими колонками: тикер, название, количество, текущая
  цена и текущая стоимость.
- Тикер ведёт на страницу облигации, когда маршрут инструмента может быть определён.
- Таблица сохраняет cursor-пагинацию по 10 позиций.
- При отсутствии облигаций показывается отдельное пустое состояние.

### 7. Последние операции на overview

- Overview показывает не более пяти последних операций доступного по умолчанию периода.
- Отображение операции сохраняет дату, русское название типа, инструмент и сумму.
- Блок содержит переход к полному разделу операций.
- Если операций нет, блок показывает спокойное пустое состояние и сохраняет переход к полной
  истории.

### 8. Раздел операций

- Раздел показывает cursor-пагинированную историю по 10 операций.
- Без отдельного фильтра дат раздел использует существующий период по умолчанию: с начала текущего
  календарного года до текущего момента.
- Под всей доступной историей в рамках первой версии понимаются все cursor-страницы этого периода,
  а не операции за всё время существования счёта.
- Пользователь может выбрать ровно один точный тип операции либо значение `Все операции`.
- Типы с разным финансовым смыслом не объединяются. В частности, `Налог`, `Налог по облигациям` и
  `Налог на дивиденды` являются отдельными значениями.
- В интерфейсе показываются русские названия известных типов, а не технические enum-значения.
- Выбор нового типа начинает просмотр результатов с первой cursor-страницы.
- Выбранный фильтр сохраняется в адресе страницы и восстанавливается при открытии ссылки.
- Значение `Все операции` удаляет фильтр типа.
- Фильтр по датам, инструменту и выбор нескольких типов не входят в первую версию.

### 9. Загрузка, ошибки и пустые состояния

- Первичная загрузка сводки и таблиц показывает skeleton соответствующей формы.
- При переходе между cursor-страницами текущие строки не исчезают; поверх таблицы показывается
  состояние обновления.
- Ошибка одного раздела не скрывает общую навигацию счёта.
- Для пустых акций, пустых облигаций и отсутствия операций выбранного типа используются отдельные
  понятные сообщения.
- Недоступные отдельные значения отображаются как `—` и не подменяются нулём.

## Ограничения

- Backend остаётся единственным клиентом T-Bank.
- Денежные значения форматируются в валюте, указанной в данных.
- Точная структура портфеля и счётчики не должны требовать загрузки всех cursor-страниц на frontend.
- Существующая cursor-пагинация позиций и операций сохраняется.
- Фича не добавляет отдельные страницы для ETF, фондов и прочих инструментов.
- Фича не добавляет новую аналитику доходности, риска или прогнозов.

## Acceptance Criteria

- На широком экране у счёта есть боковая навигация `Обзор`, `Акции`, `Облигации`, `Операции`.
- На узком экране те же разделы доступны через горизонтальные прокручиваемые вкладки.
- Overview не содержит полных таблиц позиций и полной истории операций.
- Overview показывает полную стоимость, деньги, существующую доходность, диаграмму, карточки акций
  и облигаций и не более пяти последних операций.
- Диаграмма рассчитывает доли от полной стоимости счёта вместе с деньгами.
- Диаграмма имеет текстовую легенду со стоимостью и процентом каждого ненулевого среза.
- Карточки акций и облигаций показывают количество разных позиций, а не сумму штук.
- Количество позиций корректно для портфеля, содержащего больше одной cursor-страницы.
- Раздел акций содержит только акции и сохраняет пагинацию по 10 строк.
- Раздел облигаций содержит только облигации и сохраняет пагинацию по 10 строк.
- Раздел операций содержит пагинацию по 10 строк и фильтр по одному точному типу.
- Без параметров дат раздел операций показывает доступный период с начала текущего календарного года.
- Фильтры `Выплата купона`, `Налог`, `Налог по облигациям` и `Налог на дивиденды` дают независимые
  результаты.
- После смены типа операций открывается первая страница отфильтрованной истории.
- Выбранный тип восстанавливается из URL после перезагрузки.
- Загрузка, обновление, ошибка и пустое состояние каждого раздела отображаются согласно требованиям.

## Вне области фичи

- страницы ETF, фондов, валют, деривативов и прочих инструментов;
- multi-select типов операций;
- продуктовые группы операций;
- UI-фильтры операций по датам и инструментам;
- изменение правил расчёта доходности;
- экспорт позиций или операций.