Files
specs/openspec/changes/archive/2026-08-25-extend-instrument-logo-to-bonds/proposal.md
T
ksv741 678a671d23 feat(portfolio-view): sync delta spec and archive change
- Remove old combined requirement, add two focused requirements:
  'Состояния и ошибки Portfolio на клиенте' and
  'Представление карточек позиций на клиенте'
- Archive extend-instrument-logo-to-bonds change
2026-08-25 09:48:21 +03:00

4.4 KiB

extend-instrument-logo-to-bonds — Proposal

Why

Облигации в портфеле отображаются иначе, чем акции: без логотипа бренда инструмента, компактной плиткой в адаптивном grid и с текстовой подписью доходности. При этом имя файла логотипа бренда уже является частью данных позиции для всех типов инструментов — ограничение «показывать только акциям» существует исключительно на уровне отображения. Асимметрия выглядит как незавершённость недавней фичи логотипов и усложняет восприятие портфеля: однотипные карточки читаются по-разному.

What Changes

Клиент приводит карточки облигаций к полному визуальному паритету с карточками акций:

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

Non-goals:

  • визуальные логотипы для секций иных типов инструментов (фонды, валюты и др.) не вводятся;
  • состав данных и контракт API Portfolio не меняются: ни новых полей, ни новых эндпоинтов;
  • раздельные секции «Акции» и «Облигации», upstream-порядок позиций и все финансовые значения сохраняются;
  • доменный словарь не меняется: используется существующий термин Instrument Logo; понятие «эмитент» не вводится.

Capabilities

New Capabilities

(нет)

Modified Capabilities

  • portfolio-view: правила отображения карточек секции BOND меняются с «прежнего вида» (компактная плитка в адаптивном grid, абсолютный доход с текстовой подписью, без логотипа) на паритет с карточками STOCK: одна карточка в ряду, визуальный логотип бренда с фолбэком первой буквы идентификатора, доход со знаком без подписи. Сценарий «Секция облигаций сохраняет прежний вид» заменяется сценарием паритета облигаций с акциями; сценарии отображения логотипа, его фолбэка и подписи доходности обобщаются с STOCK на STOCK и BOND. Правила отображения общей секции иных типов сохраняются без изменений.

Impact

  • Пользователи: вид портфеля с облигациями меняется визуально — облигации отображаются в том же стиле, что и акции; данные, порядок и значения остаются прежними.
  • Система: изменение затрагивает только клиентское отображение портфеля; серверная часть и контракты не меняются.
  • Документация: as-built документация представления портфеля обновляется при реализации.