Proposal: add-instrument-logos

Why

Список акций в портфеле сейчас полностью текстовый: позиции распознаются по имени и ISIN, что замедляет визуальный поиск нужной бумаги, когда позиций много. Брендовые логотипы инструментов уже предоставляются upstream T-Bank в составе metadata инструмента, поэтому узнаваемость позиций можно повысить без новых интеграций. Заодно карточки акций получают больше места: переход на одну карточку в ряд улучшает читаемость ключевых метрик и даёт логотипу естественное место в композиции.

What Changes

В секции «Акции» портфеля каждая карточка позиции показывает визуальный логотип бренда инструмента; если логотипа нет или он недоступен, вместо него показывается текстовый фолбэк (первая буква названия).
Карточки позиций в секции «Акции» отображаются по одной в ряду.
В карточке акции абсолютная доходность показывается как значение с явным знаком (+/-, ноль — без знака) и существующей цветовой индикацией знака, без текстовой подписи «Доход:».
Ответ Portfolio дополняется опциональной metadata позиции — именем файла логотипа бренда инструмента, когда оно есть upstream; клиенты решают сами, где её показывать.

Non-goals:

Облигации и «прочие» типы позиций не меняются: текущая адаптивная многоколоночная сетка, состав метрик и подпись доходности сохраняются.
События счёта (предстоящие и недавние) и история операций не затрагиваются.
Собственный хостинг или проксирование изображений не вводятся; изображения загружаются клиентом напрямую из публичного источника бренда T-Bank.
Финансовые расчёты, нормализация значений и агрегаты Portfolio не меняются.

Capabilities

New Capabilities

Modified Capabilities

portfolio-view: в требования к нормализованному составу Portfolio добавляется опциональная metadata логотипа бренда Portfolio Position (nullable, не влияет на успешность и свежесть Snapshot); в требованиях к отображению на клиенте секция «Акции» получает одноколоночную раскладку, логотип бренда с текстовым фолбэком и доходность со знаком без подписи. Требования для секций облигаций и прочих типов сохраняются без изменений.

Impact

Пользователи: новый вид списка акций в портфеле (логотипы, одна карточка в ряду, доходность со знаком); облигации и прочие типы выглядят как раньше.
Публичный контракт Portfolio: новое необязательное nullable поле metadata позиции; обратно совместимо.
Backend: обогащение metadata инструмента именем файла бренда из upstream.
Frontend: отображение секции «Акции» портфеля; обновление snapshot контракта.
Docs: новый термин «Instrument Logo» в доменном глоссарии; as-built описание портфеля.

4.4 KiB Raw Blame History