38 lines
4.4 KiB
Markdown
38 lines
4.4 KiB
Markdown
# Proposal: add-instrument-logos
|
|
|
|
## Why
|
|
|
|
Список акций в портфеле сейчас полностью текстовый: позиции распознаются по имени и ISIN, что замедляет визуальный поиск нужной бумаги, когда позиций много. Брендовые логотипы инструментов уже предоставляются upstream T-Bank в составе metadata инструмента, поэтому узнаваемость позиций можно повысить без новых интеграций. Заодно карточки акций получают больше места: переход на одну карточку в ряд улучшает читаемость ключевых метрик и даёт логотипу естественное место в композиции.
|
|
|
|
## What Changes
|
|
|
|
- В секции «Акции» портфеля каждая карточка позиции показывает визуальный логотип бренда инструмента; если логотипа нет или он недоступен, вместо него показывается текстовый фолбэк (первая буква названия).
|
|
- Карточки позиций в секции «Акции» отображаются по одной в ряду.
|
|
- В карточке акции абсолютная доходность показывается как значение с явным знаком (`+`/`-`, ноль — без знака) и существующей цветовой индикацией знака, без текстовой подписи «Доход:».
|
|
- Ответ Portfolio дополняется опциональной metadata позиции — именем файла логотипа бренда инструмента, когда оно есть upstream; клиенты решают сами, где её показывать.
|
|
|
|
**Non-goals:**
|
|
|
|
- Облигации и «прочие» типы позиций не меняются: текущая адаптивная многоколоночная сетка, состав метрик и подпись доходности сохраняются.
|
|
- События счёта (предстоящие и недавние) и история операций не затрагиваются.
|
|
- Собственный хостинг или проксирование изображений не вводятся; изображения загружаются клиентом напрямую из публичного источника бренда T-Bank.
|
|
- Финансовые расчёты, нормализация значений и агрегаты Portfolio не меняются.
|
|
|
|
## Capabilities
|
|
|
|
### New Capabilities
|
|
|
|
<!-- none -->
|
|
|
|
### Modified Capabilities
|
|
|
|
- `portfolio-view`: в требования к нормализованному составу Portfolio добавляется опциональная metadata логотипа бренда Portfolio Position (nullable, не влияет на успешность и свежесть Snapshot); в требованиях к отображению на клиенте секция «Акции» получает одноколоночную раскладку, логотип бренда с текстовым фолбэком и доходность со знаком без подписи. Требования для секций облигаций и прочих типов сохраняются без изменений.
|
|
|
|
## Impact
|
|
|
|
- **Пользователи**: новый вид списка акций в портфеле (логотипы, одна карточка в ряду, доходность со знаком); облигации и прочие типы выглядят как раньше.
|
|
- **Публичный контракт Portfolio**: новое необязательное nullable поле metadata позиции; обратно совместимо.
|
|
- **Backend**: обогащение metadata инструмента именем файла бренда из upstream.
|
|
- **Frontend**: отображение секции «Акции» портфеля; обновление snapshot контракта.
|
|
- **Docs**: новый термин «Instrument Logo» в доменном глоссарии; as-built описание портфеля.
|