6.4 KiB
Глоссарий домена
T-Bank connection
Единственное принадлежащее User подключение к T-Bank Invest, содержащее зашифрованный token для server-side запросов.
Не использовать: аккаунт T-Bank, авторизация T-Bank.
Brokerage Account
Открытый поддерживаемый инвестиционный счёт T-Bank, доступный через T-Bank connection: брокерский счёт, ИИС, Инвесткопилка или фонд денежного рынка.
Не использовать: счёт T-Bank, банковский счёт.
Investment Account Type
Нормализованная категория Brokerage Account, независимая от upstream enum T-Bank.
Не использовать: тип аккаунта T-Bank, protobuf type.
Portfolio
Текущее нормализованное состояние инвестиций одного Brokerage Account, включающее позиции, доступные денежные остатки и итоги по каждой валюте.
Не использовать: общий портфель, баланс счёта.
Portfolio Position
Ненулевой обычный инвестиционный актив в составе Portfolio с количеством и доступными оценочными показателями.
Не использовать: валютная позиция, виртуальная позиция.
Instrument
Ценная бумага или иной торгуемый актив T-Bank, на который ссылается Portfolio Position через FIGI или instrument UID. Metadata Instrument обогащают отображение Position, но не определяют количество или стоимость.
Не использовать: бумага, тикер, актив позиции.
Instrument Logo
Имя файла бренда T-Bank для отображения Instrument в интерфейсе; presentation metadata, которая не влияет на количество или стоимость позиции. Изображение загружается frontend из публичного брендового CDN без авторизации; при отсутствии имени или ошибке загрузки используется фолбэк с первой буквой отображаемого имени.
Не использовать: аватар актива, иконка бумаги.
Cash Balance
Ненулевой доступный денежный остаток Portfolio в одной валюте; не является Portfolio Position.
Не использовать: валютная позиция, заблокированные средства.
Portfolio Snapshot
Полный успешно полученный состав Portfolio на определённый момент времени, который может быть свежим или устаревшим fallback-представлением.
Не использовать: история портфеля, snapshot для графика.
Client Cached Snapshot
Последний успешно полученный frontend-ответ React Query, который остаётся
видимым во время фонового обновления или после его ошибки. Не является
server-side fallback и не использует поле Portfolio.isStale.
Не использовать: устаревший Portfolio Snapshot, fallback портфеля.
Account Ledger
Упорядоченная read-only история исполненных операций одного Brokerage Account, отражающая фактические денежные и инструментальные движения без рыночной переоценки или расчёта остатка после операции.
Не использовать: история Portfolio, баланс счёта.
Ledger Entry
Нормализованное представление одной операции T-Bank в Account Ledger; хранит исходные суммы и доступные детали операции, не создавая синтетических записей для комиссии сделки.
Не использовать: проводка, рассчитанная операция.
Ledger Page Cache
Кэш страницы Account Ledger, отделённый от кэша отдельных операций.
Не использовать: operations cache, кэш отдельных операций.
Ledger Page Cache Key
Каноническая идентичность страницы Ledger Page Cache: User, Brokerage Account, нормализованные диапазон и categories, opaque upstream cursor и limit.
Не использовать: сырой URL query, ключ отдельной Ledger Entry.
Concurrent Refresh Attempt
Два или более перекрывающихся запроса с одним ещё действительным refresh token
одной Session; один становится Refresh Winner, остальные — Refresh Loser и
получают 401, не отзывая Session победителя.
Не использовать: повторное использование refresh token, последовательный refresh.
Superseded Refresh Token
Refresh token, который перестал быть действительным после успешной ротации
Session; его предъявление получает 401, но само по себе не отзывает Session.
Не использовать: активный refresh token, признак взлома сессии.
Future Cash Event
Прогнозируемое на ближайший период денежное или связанное корпоративное событие одного Brokerage Account, рассчитанное по текущей Portfolio Position; не является исполненной Ledger Entry.
Не использовать: будущая операция, гарантированная выплата.