specs/openspec/changes/account-top-positions/analysis/research.md

Product Research

Problem Statement

[F] Change Owner просит рядом с вкладкой «Позиции» показать «Топ-5»: крупнейшие акции, облигации и секторы по денежной оценке, переключение критерия и distribution chart; отдельно спрашивает, какой ещё критерий полезен, и формулирует эстетическую цель «сделать что-то классное и красивое» [R0].

[F] Сейчас страница счёта уже содержит donut «Структура портфеля» по классам активов с выбором одной валюты, вкладки и внутри «Позиций» переключатель «Акции / Облигации / Прочее» [L1, L2, L3].

[I] Исследовательский вопрос: какой узкий набор критериев даст владельцу понятный ответ «где сконцентрированы деньги», не дублируя текущую структуру по классам активов и не смешивая несопоставимые валюты.

[I] Документ является входным контекстом для продуктового решения, а не набором требований, контрактов или проектных решений.

Target Audience

[F] Известная аудитория изменения — один владелец WealthLedger, использующий личный инвестиционный трекер поверх T-Bank Invest API [R0].

[H] Предположение о более широкой аудитории, частоте использования аналитики, размере портфеля, числе валют и уровне финансовой грамотности отсутствует: интервью, аналитика и обращения пользователей не предоставлены.

[I] Поэтому внешние продукты используются как источник кандидатов и паттернов, но не как доказательство спроса владельца WealthLedger.

Research Questions

[I] 1. Какие разрезы концентрации и аллокации действительно встречаются в публично описанных портфельных продуктах, а какие остаются непроверенными кандидатами?

[I] 2. Какие критерии можно вычислить из текущего Portfolio Snapshot, а для каких в нём нет данных даже при наличии полей в интеграции T-Bank?

[I] 3. Какие формы визуализации подходят для рейтинга и для долей целого, как представлять «Top-N + Прочее» и насколько полезны доля топ-5, HHI и эффективное число позиций частному инвестору?

[I] 4. Как сохранить канонический принцип «без валютной конвертации» при сравнении позиций и категорий?

[I] 5. Где разместить новый обзор относительно существующих «Позиций» и «Структуры портфеля», чтобы назначение экранов не дублировалось?

Existing Solutions and Alternatives

Вариант	Что делает	Сильные стороны	Слабые стороны	Источник
Оставить как есть	[F] Полный список позиций по типам и отдельный donut по классам активов уже доступны [L1, L2, L3].	[I] Базовая альтернатива без нового дублирования и без новых данных.	[I] Не даёт явного рейтинга топ-5 и секторного разреза из запроса владельца.	[F] [L1, L2, L3]
Т-Инвестиции: «Аналитика портфеля»	[F] Публичная справка описывает структуру по классам активов, секторам, валютам и компаниям; вкладка «Портфель» показывает доли компаний с акциями и облигациями одного эмитента вместе [E1].	[I] Подтверждает ценность не только сектора, но и валюты и сквозной концентрации на эмитента.	[F] На проверенной странице не описаны топ-5, сроки погашения, кредитные рейтинги или HHI [E1].	[F] [E1]
Т-Инвестиции: доходность и выплаты	[F] Справка описывает прирост стоимости, дивиденды и купоны, а также график будущих выплат и стоимость портфеля на графике [E2].	[I] Показывает соседний, но отличный от текущей концентрации сценарий — вклад в результат и доход.	[I] Эти данные не доказывают необходимость смешивания дохода и стоимости в одном переключателе «Топ-5».	[F] [E2]
Portfolio Performance	[F] Statement of Assets содержит классификации, долю, стоимость, donut и treemap; документация называет asset class, sector, region, industry среди возможных классификаций, а Performance содержит показатели по бумагам и выплаты по инструментам [E6, E7, E8, E9].	[I] Самый широкий проверенный набор разрезов и форм представления среди изученных источников.	[F] Taxonomy может требовать ручной классификации; публичная документация не доказывает, что все разрезы нужны данному владельцу [E7].	[F] [E6–E9]
Intelinvest	[F] Публичная продуктовая страница заявляет структуру по странам, секторам, регионам, компаниям и классам активов, а также аналитический доход по годам и месяцам [E3].	[I] Подтверждает распространённость географии, отраслей и дохода в российском портфельном продукте.	[I] Это маркетинговое описание; детали расчёта, топ-5, облигационные корзины и accessibility на странице не проверены.	[F] [E3]
Snowball Income	[F] Публичная страница описывает ребалансировку по секторам и типам активов с расхождением текущего и целевого распределения [E5].	[I] Подтверждает сценарий сравнения структуры с целью, а не только наблюдения за текущими долями.	[I] Наличие топ-5, эмитентской концентрации, maturity/rating и HHI на проверенной странице не подтверждено.	[F] [E5]
Sharesight, Morningstar X-ray, Kubera, Yahoo Finance, Finam	[I] Эти продукты рассматривались как кандидаты для выборки, но их конкретные критерии в доступных публичных страницах в ходе исследования не подтверждены.	[I] Не используются как доказательство «стандарта рынка».	[I] Не проверено; любые утверждения об их текущих разрезах потребуют отдельной проверки первичных источников.	[I] Нет подтверждённого источника по критериям
Простейший новый вариант: ranked bar/list	[I] Пять строк с названием, суммой и долей, при необходимости шестая строка «Прочее».	[I] Наглядно сохраняет ранг, точные подписи и доступное текстовое представление; не зависит только от различения цветов.	[I] Менее «эффектный» вид и ограниченная компактность при длинных названиях.	[I] Интерпретация на основе [L4, E10]
Donut «Top-5 + Прочее»	[F] Существующий виджет уже использует DonutChart, проценты/суммы в tooltip и текстовую легенду [L3].	[I] Знакомый паттерн для долей целого и меньший риск визуального разнобоя.	[I] При повторении для классов активов будет дублировать виджет над вкладками; малые сектора труднее сравнивать по углам, чем по длинам.	[I] [L3]
Treemap	[F] Portfolio Performance предоставляет treemap для иерархических классификаций активов [E6].	[I] Компактно показывает много категорий и может выглядеть выразительно.	[I] Для пяти категорий избыточен, а малые прямоугольники затрудняют подписи и точное сравнение.	[I] [E6]
Горизонтальная stacked bar	[I] Одна полоса показывает весь выбранный портфель и сегменты «Top-5 + Прочее».	[I] Компактная замена donut с явной общей суммой.	[I] Подписи малых сегментов и сравнение категорий остаются слабым местом; без текстовой легенды цвет становится единственным кодом.	[I] [E10]

Evidence & Sources

[F] Проверенное ядро разрезов. Текущие позиции, классы активов, секторы, география/регионы и валюты подтверждены хотя бы одним первичным продуктовым источником; эмитентская агрегация акций и облигаций дополнительно явно описана Т-Инвестициями [E1, E3, E6, E7].

[I] Не универсальный стандарт. Maturity buckets, кредитный рейтинг/risk level, вклад позиции в доход, top gainers/losers и HHI нельзя называть обязательным общим стандартом по этой выборке: либо найден только смежный отчёт, либо точный критерий не проверен.

[F] Позиции по стоимости. PortfolioPositionDto уже содержит type, quantity, currentValue, displayName, ticker и absoluteReturn; отдельных sector, country, issuer, maturityDate и rating в DTO нет [L4].

[I] Акции и облигации — высокая готовность данных. Рейтинг по currentValue внутри типа и выбранной валюты опирается на текущий snapshot; ограничения отсутствующих, нулевых или отрицательных оценок должны быть видимы, как и в существующей структуре [L3, L4].

[F] Сектор и страна. В интеграционных типах и proto T-Bank есть sector, countryOfRisk/country_of_risk и currency; sector присутствует у Share и Bond, а справка Т-Инвестиций предупреждает, что для российских бумаг встречаются отрасли и государственные ценные бумаги, а для иностранных — только отрасли [L5, L6, E1].

[I] Сектор — средняя уверенность. Поле существует upstream, но текущий Portfolio DTO его не exposes; полнота значений по реальным позициям владельца и применимость категории «государственные ценные бумаги» к секторному обзору не подтверждены [L4, L5, E1].

[I] Страна/регион — кандидат на потом. countryOfRisk доступен в интеграционных данных, но это страна риска, а не обязательно страна листинга, регистрации или валюты; регион потребует дополнительного смыслового отображения, которое в источниках не проверено [L5, L6].

[F] Валюта. Каноническая spec фиксирует Portfolio «без валютной конвертации» и итоги по валютам; существующая «Структура портфеля» уже показывает одну выбранную валюту за раз [L3, L8].

[I] Валютный выбор — наиболее согласованный вариант. Пер-валютный топ сохраняет сопоставимость сумм и существующий UX; единый топ или единый donut валютной аллокации по нескольким валютам требует общего знаменателя, то есть отдельного решения о конвертации и выхода за текущий узкий scope.

[F] Эмитент. В текущем DTO нет стабильного идентификатора эмитента; displayName, isin и ticker идентифицируют позицию/инструмент, но не доказывают принадлежность акции и облигации одной компании [L4].

[F] Источник идентичности эмитента вне Portfolio Snapshot. Полное описание актива T-Bank AssetFull.brand содержит бренд (uid, name, company, sector); у Share, Bond и Etf есть asset_uid, связывающий инструмент с активом. Краткое описание актива Asset бренда не содержит, а BrandData внутри инструментов хранит только данные логотипа [L9].

[I] Эмитентская агрегация — полезный кандидат, источник идентичности есть. Паттерн подтверждён Т-Инвестициями [E1]; бренд актива T-Bank (AssetFull.brand) даёт кандидата на идентичность эмитента вне текущего Portfolio Snapshot, где её нет [L4, L9]. Группировка по совпадающему имени остаётся ненадёжной эвристикой. Полнота бренда по позициям владельца не проверена [H].

[F] Погашение и риск облигаций. TbankBond содержит опциональные maturityDate и riskLevel; proto также описывает perpetual_flag, а текущий DTO этих полей не содержит [L4, L5, L6].

[I] Maturity buckets возможны только для облигаций и требуют отдельной трактовки бессрочных бумаг и отсутствующих дат; riskLevel является полем T-Bank, а не подтверждённым кредитным рейтингом агентства [L5, L6].

[F] Кредитный рейтинг. В проверенных текущих DTO, интеграционных типах и proto поле кредитного рейтинга не найдено; это наблюдение ограничено проверенными файлами, а не доказательством отсутствия любого рейтинга во всех продуктах T-Bank [L4, L5, L6].

[F] Доход и P&L. absoluteReturn уже есть у позиции, но текущий DTO не содержит дивидендный/купонный вклад; Portfolio Performance документирует отдельные performance и payments reports, а Т-Инвестиции отдельно описывают доходность и будущие выплаты [L4, E2, E8, E9].

[I] Top gainers/losers по absoluteReturn технически ближе к MVP, чем income contribution, но отвечает на вопрос «что дало результат», а не «где сейчас деньги»; готовая постатейная история выплат в этом исследовании не проверена.

[F] Доступность цвета. WCAG 2.2 SC 1.4.1 требует, чтобы цвет не был единственным визуальным средством передачи информации или различения элементов [E10].

[I] Текстовая альтернатива обязательна для смысла диаграммы. Название, сумма и доля в списке/легенде полезны не только для accessibility, но и для точного сравнения малых категорий [E10, L3].

[F] Концентрация как риск. FINRA описывает концентрацию как зависимость результата портфеля от одной позиции или группы связанных позиций и отмечает, что разные классы активов сами по себе не устраняют такую зависимость [E11].

[F] HHI. US DOJ определяет Herfindahl–Hirschman Index как сумму квадратов долей участников рынка; это источник математической формулы, а не нормы для личного инвестиционного портфеля [E12].

[I] Доля топ-5 понятнее HHI для первого экрана. Она прямо отвечает «сколько денег приходится на пять крупнейших позиций»; HHI и обратная величина 1 / Σw² могут служить «эффективным числом позиций», но не имеют проверенного здесь персонального порога действия и создают риск ложной точности.

[I] «Top-N + Прочее» сохраняет 100% выбранной совокупности и сокращает хвост, но скрывает состав «Прочего»; поэтому агрегат не заменяет полный список позиций.

[F] [R0] Формулировка Change Owner и AS-IS контекст: Issue WealthLedger/main#48 (30.10.2026).

[F] [L1] frontend/src/pages/account/ui/AccountPage/components/AccountPageLoaded.view.tsx — вкладки страницы счёта, размещение PortfolioStructure, PortfolioStructure.key, переключатель типов позиций.

[F] [L2] frontend/src/pages/account/model/positions.ts — виды секций stocks | bonds | other, отображение доли и результата позиции.

[F] [L3] frontend/src/widgets/portfolio-structure/ui/PortfolioStructure.view.tsx — DonutChart, выбор валюты, tooltip, легенда, обработка неполных/отрицательных/неоценённых данных.

[F] [L4] backend/src/modules/investments/portfolio/presentation/portfolio.dto.ts — поля позиции и структуры портфеля.

[F] [L5] backend/src/integrations/tbank/tbank-market.types.ts — sector, countryOfRisk, currency, maturityDate, riskLevel и другие поля инструментов.

[F] [L6] backend/src/integrations/tbank/proto/contracts/instruments.proto — описание полей Share, Bond и связанных инструментов T-Bank.

[F] [L7] backend/src/modules/investments/instruments/application/public-instrument.ts — использование instrument metadata в публичном каталоге акций/облигаций, включая sector, maturityDate, riskLevel.

[F] [L8] specs/openspec/specs/portfolio-view/spec.md — Portfolio Snapshot одного счёта, отсутствие валютной конвертации и итоги по валютам.

[F] [L9] backend/src/integrations/tbank/proto/contracts/instruments.proto — AssetFull.brand (~:1051-1067), Brand (:1220-1229), asset_uid у Share (:776), Bond (:543), Etf (:657); Asset (:1075-1080) без бренда; BrandData (common.proto:120) — только данные логотипа.

[F] [E1] Т-Банк, «Аналитика инвестиционного портфеля»: https://www.tbank.ru/invest/help/educate/yield-analysis/about/folio-lookup/ — структура портфеля по классам активов, секторам, валютам и компаниям.

[F] [E2] Т-Банк, «Доходность портфеля и аналитика в Т-Инвестициях»: https://www.tbank.ru/invest/help/educate/yield-analysis/ — стоимость, прирост, дивиденды, купоны и будущие выплаты.

[F] [E3] Intelinvest, официальная продуктовая страница: https://intelinvest.ru/ — заявленные разрезы структуры и аналитический доход; маркетинговый источник.

[F] [E5] Snowball Income, «Возможности»: https://snowball-income.com/overview — заявленная ребалансировка по секторам и типам активов; маркетинговый источник.

[F] [E6] Portfolio Performance Manual, «Statement of Assets»: https://help.portfolio-performance.info/en/reference/view/reports/statement/ — таблица, доли, donut, treemap и классификации.

[F] [E7] Portfolio Performance Manual, «Classifying your assets»: https://help.portfolio-performance.info/en/getting-started/classify-assets/ — taxonomy, asset class, sector, region, industry и ручная классификация.

[F] [E8] Portfolio Performance Manual, «Securities»: https://help.portfolio-performance.info/en/reference/view/reports/performance/securities/ — стоимость, прирост, прибыль/убыток и доходы по бумагам.

[F] [E9] Portfolio Performance Manual, «Payments»: https://help.portfolio-performance.info/en/reference/view/reports/performance/payments/ — выплаты по инструментам и суммы по типам платежей.

[F] [E10] W3C WAI, «Understanding SC 1.4.1: Use of Color»: https://www.w3.org/WAI/WCAG22/Understanding/use-of-color.html — цвет не должен быть единственным носителем смысла.

[F] [E11] FINRA, «Concentrate on Concentration Risk»: https://www.finra.org/investors/insights/concentration-risk — риск зависимости от позиции или связанных позиций.

[F] [E12] US Department of Justice, «Herfindahl-Hirschman Index»: https://www.justice.gov/atr/herfindahl-hirschman-index — формула HHI и её исходная предметная область.

Assumptions

[H] Под «крупнейшими» владелец имеет в виду наибольшую положительную currentValue, а не количество бумаг, прибыль, вес от всех счетов или целевую долю.

[H] Топ-5 рассматривается внутри одного Brokerage Account и одной выбранной валюты; включение cash и других счетов запросом не подтверждено.

[H] «Прочее» означает сумму позиций вне первых пяти, а не существующий тип позиций other; это разные понятия, которые нельзя смешивать без пояснения [L2].

[H] Владелец прежде всего хочет обзор текущей концентрации, а не рекомендации по ребалансировке, прогноз дохода или оценку кредитного качества.

[H] Фактическая полнота sector, countryOfRisk, maturityDate и riskLevel по позициям владельца неизвестна; реальных snapshot-данных в исследовании нет.

[H] Предпочтение «классное и красивое» не проверено отдельно; выбор конкретной диаграммы остаётся эстетической гипотезой, а не подтверждённой потребностью.

Risks

[I] Смешение валют. Общий рейтинг без конвертации сравнит несопоставимые денежные единицы; конвертация изменит смысл канонического portfolio-view и расширит решение за пределы отображения топ-5 [L8].

[I] Дублирование. Новый donut по классам активов повторит существующий PortfolioStructure; название «Структура» дополнительно сделает границу двух блоков неочевидной [L1, L3].

[I] Ложная полнота секторов. Отсутствующий sector, специальная категория госбумаг и неприменимость сектора к части типов могут исказить доли, если не показывать неизвестную категорию [E1, L4].

[I] Ошибочная идентичность эмитента. Объединение по названию или тикеру может разделить связанные бумаги или объединить разные инструменты; текущий snapshot не содержит issuer identity [L4]; кандидат на стабильную идентичность — AssetFull.brand [L9].

[I] Смешение задач. Стоимость, unrealized P&L, исторические выплаты и будущие купоны имеют разные знаменатели и временной смысл; один безымянный переключатель критериев может создать видимость сопоставимости [E2, E8, E9].

[I] Перегрузка MVP. Страны, эмитенты, сроки, риск, доход, HHI и несколько типов диаграмм одновременно увеличат число непроверенных решений без данных об их ценности для единственного владельца.

[I] HHI без действия. Перенос антимонопольных порогов HHI на личный портфель был бы необоснованным; даже корректное число не подсказывает владельцу, какая концентрация приемлема именно для него [E11, E12].

[I] Color-only и скрытый хвост. Диаграмма без подписей нарушит принцип WCAG 1.4.1, а «Прочее» без суммы/доли и доступа к полному списку скроет значимую часть риска [E10].

Conclusions

[I] Высокая уверенность: непосредственно запрошенные топ-5 акций и облигаций по текущей стоимости — самый обоснованный MVP: данные уже есть, результат не дублирует класс активов и решает конкретную задачу концентрации [L4].

[I] Средняя уверенность: секторный «Top-5 + Прочее» соответствует и запросу, и проверенным продуктовым паттернам, но качество зависит от непроверенной полноты upstream-данных [E1, E3, E6, L5].

[I] Высокая уверенность: выбор одной валюты за раз — единственный найденный вариант, который одновременно сохраняет текущий UX и каноническое отсутствие конвертации; общий мультивалютный топ без нового правила конвертации некорректен [L3, L8].

[I] Средняя уверенность: для топ-позиций ranked horizontal bar/list информативнее donut; donut допустим для секторных долей, если рядом есть текстовые суммы и доли, а существующий donut по классам активов не повторяется [L3, E10].

[I] Средняя уверенность: доля топ-5 — полезная простая метрика концентрации; HHI и эффективное число позиций лучше отложить, поскольку персональная интерпретируемость и порог действия не подтверждены [E11, E12].

[I] Средняя уверенность: следующими кандидатами логичны эмитентская концентрация и страна риска, а не кредитный рейтинг: первые подтверждены внешними паттернами и частично данными, второй не найден в проверенном текущем источнике [E1, E3, L4–L6].

[I] Низкая уверенность в широте «рыночного стандарта»: выборка первичных источников небольшая, несколько названных продуктов не проверены, а маркетинговые страницы описывают заявления производителей, а не фактическое использование.

[I] Размещение: рабочее имя «Концентрация» точнее охватывает позиции и секторы, чем «Топ-5»; «Структура» хуже из-за существующего одноимённого по смыслу виджета, а отдельная вкладка рядом с «Позициями» соответствует исходному запросу владельца [R0, L1, L3].

Recommendation

[I] Сузить scope до одного обзора текущей концентрации в выбранной валюте, а не строить универсальную аналитику портфеля. Уверенность: высокая для стоимостного топа, средняя для секторов, низкая для дополнительных разрезов.

[I] Must — рекомендуемый узкий MVP: топ-5 акций и топ-5 облигаций по currentValue; топ-5 секторов плюс «Прочее»; сумма и доля каждой строки; доля совокупного топ-5; выбор одной валюты; ranked bar/list с текстовыми подписями и одной distribution-визуализацией без повторения классов активов.

[I] Условие уверенности для секторов: если реальные данные окажутся слишком неполными, секторный критерий разумно перенести в later, не подменяя неизвестные значения догадками; сам стоимостной топ от этого не зависит [L4, L5].

[I] Later: страна риска; агрегация акций и облигаций одного эмитента (на момент research — после подтверждения issuer identity; позднее Change Owner перенёс в MVP, так как источник найден в AssetFull.brand [L9]); maturity buckets и riskLevel только для облигаций; top gainers/losers как отдельный смысловой режим; income contribution после подтверждения истории выплат; HHI/эффективное число позиций после проверки понятности владельцу.

[I] No для этого изменения: кредитный рейтинг как обещанный критерий; скрытая валютная конвертация; повтор donut по классам активов; treemap только ради визуального эффекта; одновременный запуск всех перечисленных критериев.

[I] Размещение: предпочтительна отдельная вкладка рядом с «Позициями» с рабочим названием «Концентрация»; решение изменится, если владелец хочет именно короткий рейтинг без секторов — тогда название «Топ-5» станет точнее.

[H] Открытый вопрос 1: секторы нужны только по акциям или по всем инструментам, для которых T-Bank возвращает sector, включая облигации и категорию государственных бумаг?

[H] Открытый вопрос 2: подтверждает ли владелец пер-валютный показ вместо единого рейтинга с конвертацией, и какая валюта должна выбираться первоначально?

[H] Открытый вопрос 3: входят ли в топ только позиции с известной положительной стоимостью и нужно ли отдельно показывать число неоценённых позиций?

[H] Открытый вопрос 4: достаточно ли пяти строк плюс «Прочее», или владельцу важно раскрывать хвост без возврата к полному списку?

[H] Открытый вопрос 5: новый блок должен оставаться отдельным от текущей «Структуры портфеля» или в перспективе заменить/поглотить её?

[H] Открытый вопрос 6: нужна ли сейчас только текущая концентрация, или владелец ожидает также top gainers/losers и вклад дивидендов/купонов?

[H] Открытый вопрос 7: какие секторы и категории реально присутствуют в snapshot владельца и какая доля стоимости остаётся без sector?