docs: describe concentration tab and stored instrument classification (WealthLedger/main#48) (#60)

2026-11-01 19:29:01 +03:00
parent abe5b16241
commit 37430da4c9
13 changed files with 242 additions and 10 deletions
@@ -14,8 +14,17 @@ WealthLedger обращается к Invest API на сервере по gRPC ov
 | Портфель и денежные остатки | Показать текущий состав инвестиций и итоги по исходным валютам |
 | Исполненные операции | Построить журнал и выделить полученные купоны и дивиденды |
 | Инструменты и рынок | Имена, идентификаторы, цены, свечи, параметры акций и облигаций |
+| Классификация инструментов | Сектор акций, облигаций и фондов и бренд актива для разрезов [концентрации](../domains/portfolio/concentration.md) |
 | Купоны и дивиденды | Построить будущие события по текущим позициям и календарь инструмента |

+Сектор получается из описаний инструмента (отдельные описания для акций,
+облигаций и фондов, поиск по UID, затем по FIGI); эмитент — из описания актива
+по `asset_uid` инструмента: его uid и название бренда. Эмитент не выводится из
+названия, тикера или ISIN. Классификация хранится как последнее известное
+значение с обновлением не чаще раза в сутки ([ADR
+022](../adr/022-stored-instrument-classification.md)); все вызовы проходят
+через общий лимитер запросов T-Bank.
+
 T-Bank определяет исходные данные и права token. Backend проверяет локальную
 сессию, выбирает подключение её пользователя и устанавливает доступ к счёту.
 Наличие идентификатора счёта в URL этого доступа не подтверждает.
@@ -41,7 +50,9 @@ Backend передаёт имя файла `logoName` из метаданных

 Логотипы используются в портфеле, операциях, будущих событиях, поиске и
 страницах инструментов. Отсутствующее имя или ошибка изображения оставляют
-буквенную заглушку и не меняют финансовые значения. Правило построения URL
+буквенную заглушку и не меняют финансовые значения. Логотип — это metadata
+инструмента; он не равен эмитенту из [концентрации](../domains/portfolio/concentration.md),
+который берётся из бренда актива. Правило построения URL
 принадлежит [форматированию frontend](https://git.personal.ksv741.ru/WealthLedger/frontend/src/commit/9f7e342333b80bfacfd5bc394a2dcd0613d33ff3/src/shared/lib/display.ts).

 ## Проверка и сохранение подключения