docs: align investment domain terminology

architecture/domain-glossary.md

@@ -3,8 +3,8 @@
 ## User
 
 Локальный владелец данных WealthLedger, идентифицируемый `id` и
-нормализованным email. User владеет Session, T-Bank connection и видит только
-свои Brokerage Accounts.
+нормализованным email. User владеет Session и T-Bank connection и видит только
+Brokerage Accounts, доступные через его текущее T-Bank connection.
 
 _Не использовать_: клиент T-Bank, инвестор T-Bank.
 
@@ -21,7 +21,9 @@ _Не использовать_: T-Bank сессия, browser session.
 
 Денежная сумма в одной ISO-валюте, передаваемая как `{ currency, value }`, где
 `value` — decimal string без экспоненциальной записи. Backend выполняет точные
-операции, frontend форматирует Money для отображения.
+операции, frontend форматирует Money для отображения. Неизвестное или
+неприменимое денежное значение передаётся как `null`, а не как ноль и не как
+раздельные `amount`/`currency`.
 
 _Не использовать_: number amount, MoneyDto как доменный термин.
 
@@ -34,8 +36,10 @@ _Не использовать_: аккаунт T-Bank, авторизация T
 
 ## Brokerage Account
 
-Открытый поддерживаемый инвестиционный счёт T-Bank, доступный через T-Bank
-connection: брокерский счёт, ИИС, Инвесткопилка или фонд денежного рынка.
+Открытый поддерживаемый инвестиционный счёт T-Bank, доступный через текущее
+T-Bank connection User: брокерский счёт, ИИС, Инвесткопилка или фонд денежного
+рынка. WealthLedger не хранит Brokerage Account как долговременный объект
+владения независимо от T-Bank connection.
 
 _Не использовать_: счёт T-Bank, банковский счёт.
 
@@ -57,7 +61,8 @@ _Не использовать_: общий портфель, баланс сч
 ## Portfolio Position
 
 Ненулевой обычный инвестиционный актив в составе Portfolio с количеством и
-доступными оценочными показателями.
+доступными оценочными показателями. Portfolio Position не является Cash
+Balance, даже когда её type равен `CURRENCY`.
 
 _Не использовать_: валютная позиция, виртуальная позиция.
 
@@ -69,11 +74,20 @@ instrument type: `STOCK`, `BOND`, `FUND`, `CURRENCY`, `FUTURE`, `OPTION`,
 
 _Не использовать_: upstream instrument type как доменный enum.
 
+## Currency Instrument Position
+
+Portfolio Position с type `CURRENCY`, представляющая торгуемый валютный
+Instrument. Она остаётся в `positions` и не объединяется с Cash Balance той же
+валюты.
+
+_Не использовать_: денежный остаток, cash balance.
+
 ## Instrument
 
 Ценная бумага или иной торгуемый актив T-Bank, на который ссылается Portfolio
-Position через FIGI или instrument UID. Metadata Instrument обогащают
-отображение Position, но не определяют количество или стоимость.
+Position или Future Cash Event через FIGI или instrument UID. Metadata
+Instrument обогащают отображение Position или Event, но не определяют
+количество, стоимость или факт события.
 
 _Не использовать_: бумага, тикер, актив позиции.
 
@@ -101,6 +115,9 @@ _Не использовать_: валютная позиция, заблоки
 
 _Не использовать_: история портфеля, snapshot для графика.
 
+Следующие термины описывают runtime/cache-механизмы. Они не являются
+самостоятельными бизнес-сущностями.
+
 ## Client Cached Snapshot
 
 Последний успешно полученный frontend-ответ React Query, который остаётся
@@ -167,9 +184,12 @@ _Не использовать_: активный refresh token, признак
 
 Прогнозируемое на ближайший период денежное или связанное корпоративное
 событие одного Brokerage Account, рассчитанное по текущей Portfolio Position;
-не является исполненной Ledger Entry. API/code сохраняют legacy names
-`UpcomingEventDto`, `UpcomingEventsDto`, `/events` и frontend `BrokerageEvent`;
-в доменной документации primary term — Future Cash Event.
+не является исполненной Ledger Entry. Прогнозная сумма события передаётся как
+nullable Money: известные coupon, dividend и maturity содержат Money в исходной
+валюте, offer или неизвестные денежные условия передаются как `null`.
+API/code сохраняют legacy names `UpcomingEventDto`, `UpcomingEventsDto`,
+`/events` и frontend `BrokerageEvent`; в доменной документации primary term —
+Future Cash Event.
 
 _Не использовать_: будущая операция, гарантированная выплата.
 

architecture/system-overview.md

@@ -28,8 +28,9 @@ WealthLedger — локальное приложение для просмотр
   генерируется штатным workflow.
 - Поставка остаётся локальной: deployment, Docker, CI/CD и облачные сервисы не
   входят в текущие границы.
-- Snapshot Portfolio и кэш Ledger существуют только в runtime-памяти; система
-  не предоставляет историческое хранилище портфеля.
+- Portfolio Snapshot, Future Cash Events и Ledger pages существуют как
+  read-only наблюдения текущего T-Bank connection; система не хранит историю
+  портфеля, будущих событий или брокерских счетов как долговременные агрегаты.
 
 ## Поток auth/session