docs(specs): archive stock ticker change
This commit is contained in:
@@ -22,7 +22,7 @@ Portfolio Snapshot является результатом наблюдения
|
||||
### Requirement: Нормализованный состав Portfolio
|
||||
Система MUST возвращать только обычные Portfolio Position с ненулевым количеством и доступные Cash Balance с ненулевой суммой. Cash Balance MUST быть отдельным от Portfolio Position элементом и агрегироваться до одного значения на валюту. Portfolio Position с типом `CURRENCY` MUST означать позицию по торгуемому валютному Instrument и MUST NOT смешиваться с Cash Balance. Порядок Portfolio Position и Cash Balance MUST соответствовать upstream-порядку; система MUST NOT сортировать или объединять Portfolio Position с одинаковым FIGI. Виртуальные позиции и заблокированные денежные остатки MUST NOT входить в Portfolio.
|
||||
|
||||
Каждая Portfolio Position MUST содержать нормализованный тип `STOCK`, `BOND`, `FUND`, `CURRENCY`, `FUTURE`, `OPTION`, `STRUCTURED_NOTE`, `DIGITAL_FINANCIAL_ASSET` либо `OTHER`, строковое `quantity`, nullable `currentValue`, nullable `averagePurchasePrice`, nullable `absoluteReturn`, nullable `isin` и nullable `logoName` — имя файла логотипа бренда инструмента. Имя файла логотипа MUST заполняться из metadata инструмента, когда upstream предоставляет бренд с непустым именем файла логотипа; во всех остальных случаях оно MUST быть `null`. Логотип является presentation metadata: он не влияет на количество, стоимость, агрегаты, успешность или свежесть Portfolio Snapshot. Система MUST искать metadata по instrument UID при его наличии, затем по FIGI. Отображаемый идентификатор MUST предпочитать name, затем ticker, а при недоступности metadata использовать FIGI, не скрывая финансовые значения.
|
||||
Каждая Portfolio Position MUST содержать нормализованный тип `STOCK`, `BOND`, `FUND`, `CURRENCY`, `FUTURE`, `OPTION`, `STRUCTURED_NOTE`, `DIGITAL_FINANCIAL_ASSET` либо `OTHER`, строковое `quantity`, nullable `currentValue`, nullable `averagePurchasePrice`, nullable `absoluteReturn`, nullable `isin`, nullable `ticker` и nullable `logoName` — имя файла логотипа бренда инструмента. Имя файла логотипа MUST заполняться из metadata инструмента, когда upstream предоставляет бренд с непустым именем файла логотипа; во всех остальных случаях оно MUST быть `null`. Логотип является presentation metadata: он не влияет на количество, стоимость, агрегаты, успешность или свежесть Portfolio Snapshot. Система MUST искать metadata по instrument UID при его наличии, затем по FIGI. Отображаемый идентификатор MUST предпочитать name, затем ticker, а при недоступности metadata использовать FIGI, не скрывая финансовые значения.
|
||||
|
||||
#### Scenario: Позиция с неизвестным upstream-типом
|
||||
- **WHEN** upstream возвращает обычную ненулевую позицию с нераспознанным типом инструмента
|
||||
@@ -52,6 +52,14 @@ Portfolio Snapshot является результатом наблюдения
|
||||
- **WHEN** у инструмента позиции нет ISIN либо metadata недоступна
|
||||
- **THEN** система возвращает позицию с `isin: null`, не скрывая финансовые значения
|
||||
|
||||
#### Scenario: Тикер инструмента доступен
|
||||
- **WHEN** metadata инструмента позиции содержит непустой `ticker`
|
||||
- **THEN** система возвращает его в поле `ticker` позиции
|
||||
|
||||
#### Scenario: Тикер инструмента отсутствует
|
||||
- **WHEN** у инструмента позиции нет ticker либо metadata недоступна
|
||||
- **THEN** система возвращает позицию с `ticker: null`, не скрывая финансовые значения
|
||||
|
||||
#### Scenario: Имя файла логотипа бренда доступно
|
||||
- **WHEN** metadata инструмента позиции содержит бренд с непустым именем файла логотипа
|
||||
- **THEN** система возвращает его в поле `logoName` позиции
|
||||
@@ -124,7 +132,7 @@ Portfolio Snapshot является результатом наблюдения
|
||||
|
||||
Карточки секций `STOCK` и `BOND` MUST отображаться по одной в ряду при любой ширине экрана. Карточка акции или облигации MUST показывать визуальный логотип бренда инструмента рядом с отображаемым идентификатором позиции; при отсутствии имени файла логотипа либо неудачной загрузке изображения вместо логотипа MUST отображаться первая буква отображаемого идентификатора позиции. Абсолютный доход в карточке акции или облигации MUST отображаться значением с явным знаком (`+` для положительного, `-` для отрицательного, без знака при нуле) с цветовой индикацией знака и без текстовой подписи доходности.
|
||||
|
||||
Карточки общей секции иных типов MUST сохранять прежнее поведение: компактная плитка в адаптивном grid (одна колонка на узком экране, несколько колонок на широком), абсолютный доход с текстовой подписью доходности и цветовой индикацией знака, без визуального логотипа. Плитки всех секций MUST показывать отображаемый идентификатор позиции, количество, `currentValue` как главную метрику, `absoluteReturn`, `averagePurchasePrice`, долю позиции среди позиций той же валюты и `isin`. Отсутствующие метрики MUST быть скрыты, а не отображаться заглушкой. При форматировании денежных значений в русской локали клиент MUST отображать RUB как символ `₽`; другие валюты MUST сохранять понятное обозначение.
|
||||
Карточка `STOCK` MUST показывать только `ticker` под отображаемым идентификатором позиции, если тикер доступен; при `ticker: null` она MUST сохранять текущее отображение `isin` как fallback. Карточки `BOND` и общей секции иных типов MUST сохранять отображение `isin`. Карточки общей секции иных типов MUST сохранять прежнее поведение: компактная плитка в адаптивном grid (одна колонка на узком экране, несколько колонок на широком), абсолютный доход с текстовой подписью доходности и цветовой индикацией знака, без визуального логотипа. Плитки всех секций MUST показывать отображаемый идентификатор позиции, количество, `currentValue` как главную метрику, `absoluteReturn`, `averagePurchasePrice` и долю позиции среди позиций той же валюты. Отсутствующие метрики MUST быть скрыты, а не отображаться заглушкой. При форматировании денежных значений в русской локали клиент MUST отображать RUB как символ `₽`; другие валюты MUST сохранять понятное обозначение.
|
||||
|
||||
#### Scenario: Отдельные акции и облигации
|
||||
- **WHEN** Portfolio содержит позиции `STOCK` и `BOND`
|
||||
@@ -134,9 +142,21 @@ Portfolio Snapshot является результатом наблюдения
|
||||
- **WHEN** User открывает загруженный Portfolio на узком экране
|
||||
- **THEN** клиент сохраняет читаемое одноколоночное отображение агрегатов, позиций и Cash Balance
|
||||
|
||||
#### Scenario: Карточка акции с доступным тикером
|
||||
- **WHEN** позиция `STOCK` имеет непустой `ticker` и ISIN
|
||||
- **THEN** клиент показывает под отображаемым идентификатором только тикер и не показывает ISIN
|
||||
|
||||
#### Scenario: Карточка акции без тикера
|
||||
- **WHEN** позиция `STOCK` имеет `ticker: null` и непустой ISIN
|
||||
- **THEN** клиент показывает ISIN под отображаемым идентификатором
|
||||
|
||||
#### Scenario: Карточка облигации сохраняет ISIN
|
||||
- **WHEN** позиция `BOND` имеет доступные ticker и ISIN
|
||||
- **THEN** клиент показывает ISIN и не заменяет его тикером
|
||||
|
||||
#### Scenario: Карточка позиции отображает доступные метрики
|
||||
- **WHEN** позиция имеет значение текущей стоимости, абсолютного дохода, средней цены покупки и ISIN
|
||||
- **THEN** клиент показывает идентификатор, количество, текущую стоимость, абсолютный доход, среднюю цену покупки, долю среди позиций той же валюты и ISIN
|
||||
- **WHEN** позиция, не относящаяся к `STOCK`, имеет значение текущей стоимости, абсолютного дохода, средней цены покупки и ISIN
|
||||
- **THEN** клиент показывает идентификатор, количество, текущую стоимость, абсолютный доход, среднюю цену покупки, долю позиции среди позиций той же валюты и ISIN
|
||||
|
||||
#### Scenario: Отсутствующие метрики скрыты
|
||||
- **WHEN** у позиции отсутствует значение текущей стоимости, средней цены покупки или дохода
|
||||
|
||||
Reference in New Issue
Block a user