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

2026-11-01 19:13:12 +03:00
25 changed files with 114 additions and 406 deletions
@@ -1,22 +1,5 @@
 # Changelog
 ## [0.1.8](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.7...v0.1.8) (2026-11-06)
 ### Maintenance
 * **deps:** set Renovate release age, PR limit and update groups (WealthLedger/main[#6](https://git.personal.ksv741.ru/WealthLedger/docs/issues/6)) ([#64](https://git.personal.ksv741.ru/WealthLedger/docs/issues/64)) ([6d7d4c7](https://git.personal.ksv741.ru/WealthLedger/docs/commit/6d7d4c7b286535b7338d7e398d2daf7d8137a501))
 ## [0.1.7](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.6...v0.1.7) (2026-11-01)
 ### Documentation
 * describe all-account row grouping (WealthLedger/main[#47](https://git.personal.ksv741.ru/WealthLedger/docs/issues/47)) ([#59](https://git.personal.ksv741.ru/WealthLedger/docs/issues/59)) ([dcb528f](https://git.personal.ksv741.ru/WealthLedger/docs/commit/dcb528fa9f76f0d7aa98bd827cc7ee39024dbb13))
 * describe concentration tab and stored instrument classification (WealthLedger/main[#48](https://git.personal.ksv741.ru/WealthLedger/docs/issues/48)) ([#60](https://git.personal.ksv741.ru/WealthLedger/docs/issues/60)) ([37430da](https://git.personal.ksv741.ru/WealthLedger/docs/commit/37430da4c99cb571ef5bc0676cad7b3a47bcb6f0))
 ### Maintenance
 * **deps:** resolve markdownlint audit advisory (WealthLedger/main[#49](https://git.personal.ksv741.ru/WealthLedger/docs/issues/49)) ([#61](https://git.personal.ksv741.ru/WealthLedger/docs/issues/61)) ([abe5b16](https://git.personal.ksv741.ru/WealthLedger/docs/commit/abe5b16241d3002baa5d39c2a12949f23a75b968))
 ## [0.1.6](https://git.personal.ksv741.ru/WealthLedger/docs/compare/v0.1.5...v0.1.6) (2026-10-24)
 ### Maintenance
@@ -1,93 +0,0 @@
 # 023. Результат инвестирования относительно индекса Мосбиржи
 **Status:** Accepted. **Date:** 2026-11-07. Дополняет [ADR
 019](019-hourly-reads-and-online-instrument-reference.md) исключением для
 публичной истории закрытий индексов MOEX (по образцу
 [ADR 022](022-stored-instrument-classification.md)). Решение оформлено в
 [Issue WealthLedger/main#54](https://git.personal.ksv741.ru/WealthLedger/main/issues/54)
 и утверждённом change `specs/openspec/changes/2026-11-07-investment-performance-vs-index/`
 в репозитории specs.
 ## Context
 Вкладка «Результат» должна показать, как счёт или «Все счета» справились с
 деньгами, которые в него внесли, и сравнить это с вложением тех же денег в
 индекс. Простая доходность «стоимость / вложено − 1» искажает оценку, когда
 пополнения и выводы распределены во времени. Доходность по времени (TWR)
 требует истории стоимости на каждую дату потока, а её в системе нет: хранится
 только последний Portfolio.
 Сравнение с ценовым IMOEX не отвечает на вопрос пользователя: IMOEX не
 включает дивиденды и купоны, а эталон должен учитывать их так же, как
 портфель. ADR 019 запрещает хранить справочные данные как долговременный
 источник; индексы — публичные временные ряды, для которых онлайн-запрос при
 каждом открытии вкладки неприемлем по задержке и лимитам внешнего сервиса.
 ## Decision
 - **«Доходность» для «Результата инвестирования» — money-weighted return (XIRR)**
  по внешним денежным потокам счёта и текущей оценке Portfolio. Термин
  «доходность» снимается с запрета только для этого понятия; прочие понятия
  «не доходность» сохраняют прежний текст.
 - **Сравнение — теневой портфель в индексе.** Те же внешние потоки
  конвертируются в единицы индекса по закрытию дня потока (или ближайшего
  предыдущего торгового дня) и оцениваются по закрытию на дату расчёта.
  Эталон — полный доходный индекс MCFTRR; XIRR индекса считается на тех же
  потоках. Это идея PME по Long–Nickels; в интерфейсе — «те же деньги в
  индексе Мосбиржи».
 - **IMOEX — только справочный индекс.** Он показывается рядом, но не
  участвует в «опережении» и не является базой сравнения.
 - **Только RUB.** Пополнения и выводы в другой валюте не учитываются,
  нерублёвые позиции отфильтрованы на входе; конвертация валют не
  выполняется (WealthLedger/main#55).
 - **Период** начинается с первого внешнего потока, не с открытия счёта.
  Короче года — «за N дн.» без annualization; `basis = annual` только если
  деньги вложены от 365 дней.
 - **Хранение закрытий индексов.** Пара (индекс, торговый день по Москве) →
  CLOSE хранится локально с upsert. Это исключение из ADR 019: публичная
  история индекса, не привязанная к пользователю или подключению, хранится
  как долговременные данные. Остальные справочные сведения ADR 019 не
  меняются.
 ### Отклонённые варианты
 - **Простой ROI** (`стоимость / вложено − 1`): искажён моментами пополнений
  и выводов, поэтому не сравнивается с индексом на тех же деньгах.
 - **TWR (time-weighted return):** требует стоимости портфеля на каждую дату
  потока; история оценок в системе отсутствует. Сохранение такой истории
  вне этого решения.
 - **Ценовой IMOEX как ориентир:** не учитывает дивиденды и купоны, поэтому
  сравнение с портфелем, где они учтены, смещено.
 - **Конвертация валют (FX):** потребовала бы исторических курсов и
  отдельного решения о методике; не нужна для личного RUB-учёта.
 ## Consequences
 - Результат зависит от сохранённых операций T-Bank и последнего полного
  Portfolio: неполная история или неполная оценка дают `data: null` или
  `completeness: incomplete` по правилам change, а не подменяются оценкой.
 - Первая загрузка индекса догружает историю от `from − 10 дней`; при
  недостатке закрытий появляется `INDEX_HISTORY_UNAVAILABLE`. Фоновая
  синхронизация индексов не вводится.
 - Исключение из ADR 019 ограничено закрытиями индексов MOEX.
 ### Оговорки и условия источника
 - **Налоги.** MCFTRR при расчёте дивидендов и купонов использует ставки для
  организаций, а не НДФЛ физического лица. Индекс — ориентир альтернативы,
  а не точная модель налогов пользователя. Оговорка фиксируется в методике
  («Как считали»).
 - **Данные MOEX ISS.** ISS бесплатно отдаёт данные «для ознакомления».
  Приложение личное и локальное, данные не распространяются; источник
  указывается в «Как считали».
 - **Переводы между счетами.** Совпадение суммы и времени операций ещё не
  доказывает внутренний перевод. Пока нет подтверждённой связи, такие счета
  исключаются из рассчитанной части «Все счета» с явной причиной неполноты.
 - **Несколько решений XIRR.** Процент не показывается: нельзя выбрать
  произвольную ставку. Прибыль в рублях остаётся видна.
 ## Links
 - Issue: [WealthLedger/main#54](https://git.personal.ksv741.ru/WealthLedger/main/issues/54)
 - Change: `specs/openspec/changes/2026-11-07-investment-performance-vs-index/`
  (proposal, system-analysis «Расчёт» и «Индексы MOEX», design, Decisions backend 3, 5)
@@ -27,4 +27,3 @@
 - [020 — Evidence for hourly sync read boundaries](020-hourly-sync-verification-evidence.md)
 - [021 — Тихое чтение и редкие подтверждения](021-quiet-reading-and-rare-confirmations.md)
 - [022 — Хранимая классификация инструментов T-Bank](022-stored-instrument-classification.md)
 - [023 — Результат инвестирования относительно индекса Мосбиржи](023-investment-performance-vs-index.md)
@@ -31,8 +31,7 @@ WealthLedger нормализует их для просмотра и сопос
 информацией об инструментах. [Интеграция T-Bank](../integrations/tbank.md)
 объясняет полномочия подключения и ограничения внешней зависимости.
-[MOEX ISS](../integrations/moex.md) поставляет публичные параметры и календарь выпусков облигаций,
+[MOEX ISS](../integrations/moex.md) поставляет публичные параметры и календарь выпусков облигаций.
 а также дневные закрытия индексов Мосбиржи для сравнения результата.
 [Реестр НКР](../integrations/nkr.md) используется для поиска кредитного рейтинга конкретного выпуска;
 рейтинг эмитента не подставляется вместо него. Отсутствие подходящей записи
 и недоступность источника имеют разный смысл. Правила интерпретации этих
@@ -64,23 +64,14 @@ Envelope несовместим с прежними bare-array ответами:
 ## Income analytics
 `GET /api/v1/brokerage-accounts/{accountId}/income-analytics` и общий маршрут
-`all` возвращают результат только выбранного периода: итоги в RUB, точные записи выплат, разбиение по инструментам и временные
+`all` возвращают результат только выбранного периода: итоги по исходным
 валютам, точные записи выплат, разбиение по инструментам и временные
 интервалы. Данных сравнения с предыдущим периодом или годом ранее в ответе
 нет — ни в теле, ни среди зависимостей `meta.dependencies`, роль которых
 ограничена значением `selected`. Публичную машинную схему задаёт
 backend-generated OpenAPI; frontend получает её обновлённый snapshot отдельно.
 Точную семантику поведения описывает [доход](../domains/income/overview.md).
 ## Investment performance
 `GET /api/v1/brokerage-accounts/{accountId}/performance` и общий маршрут
 `all` возвращают [результат инвестирования](../domains/portfolio/investment-performance.md)
 за всё время. Недоступность расчёта — не HTTP-ошибка: ответ `200` с
 `data: null` и причинами в `meta.unavailable`. Неполная сводка «Все счета»
 имеет `completeness: incomplete` и `excludedAccounts`. Доли передаются
 десятичной строкой (`0.151` = 15,1 %), `return.basis` различает годовую
 ставку и ставку за период. Схему задаёт backend-generated OpenAPI.
 ## Validation и identity
 Backend преобразует и проверяет входные данные на общей HTTP-границе.
@@ -66,7 +66,7 @@ compatibility re-exports `shared/theme` и `shared/ui` удалены.
 Фоновое обновление сохраняет доступные данные с локальным индикатором.
 Подробные правила — в [состояниях интерфейса](../architecture/cross-cutting/ui-resilience.md).
-Финансовые значения сохраняют валюту (RUB), знак и различие между нулём и
+Финансовые значения сохраняют валюту, знак и различие между нулём и
 неизвестной суммой. Предметные представления раскрыты в
 [портфеле](../domains/portfolio/overview.md), [операциях](../domains/operations/overview.md)
 и [банковских картах](../domains/cards/overview.md).
@@ -33,12 +33,12 @@
 | Состояние `portfolioSummary` | Что оно означает |
 | --- | --- |
-| Доступный итог | Текущие стоимости позиций и деньги сложены точно в RUB |
+| Доступные валютные итоги | Текущие стоимости позиций и деньги сложены точно в исходной валюте |
-| Доступная сводка без итога | Портфель получен, но итоговой суммы нет; это не ошибка загрузки |
+| Доступная сводка с пустыми итогами | Портфель получен, но валютных итогов нет; это не ошибка загрузки |
 | `null` | Финансовая сводка этого счёта временно недоступна; метаданные и переход на счёт сохраняются |
-Позиции и деньги в валютах, отличных от RUB, не участвуют в итоге. Деньги уже входят
+Валюты не конвертируются и не объединяются в общую сумму. Деньги уже входят
-в итог; они не образуют второй самостоятельный итог. Правила
+в валютный итог; они не образуют второй самостоятельный итог. Правила
 неизвестных стоимостей совпадают со [справочником портфеля](../portfolio/data-reference.md).
 Сводка также сообщает число ненулевых обычных позиций акций и облигаций
@@ -66,7 +66,7 @@
 - Неизвестная ошибка: то же состояние недоступности без действия повтора.
 - Успешный пустой ответ: штатное состояние отсутствия инвестиционных счетов.
-Карточка ведёт на `/accounts/:accountId` по всей области и доступна с клавиатуры. Карточки расположены в одну колонку при любой ширине. Карточка показывает название, локализованный тип, крупный итог в RUB, дату открытия без времени и видимое действие открытия. Отдельные цветные блоки «Акции» и «Облигации» показывают количество наименований бумаг. Недоступная или пустая сводка отображается локально; отсутствие сумм не скрывает известные количества бумаг, а недоступная сводка не подменяет их нулями. Наведение и видимый клавиатурный фокус подчёркивают переход; настройка уменьшения движения отключает анимацию.
+Карточка ведёт на `/accounts/:accountId` по всей области и доступна с клавиатуры. Карточки расположены в одну колонку при любой ширине. Карточка показывает название, локализованный тип, крупный валютный итог и вторую валюту при наличии, число остальных валют, дату открытия без времени и видимое действие открытия. Отдельные цветные блоки «Акции» и «Облигации» показывают количество наименований бумаг. Недоступная или пустая сводка отображается локально; отсутствие сумм не скрывает известные количества бумаг, а недоступная сводка не подменяет их нулями. Наведение и видимый клавиатурный фокус подчёркивают переход; настройка уменьшения движения отключает анимацию.
 ## Свежесть и границы
@@ -4,7 +4,7 @@
 купонами и дивидендами за выбранный период». Пользователь открывает
 `/accounts/:accountId/income` из обзора счёта или
 [общий доход](../portfolio/all-accounts.md) по доступным счетам.
-Экран показывает итоги в RUB и отдельную карточку каждой
+Экран показывает итоги по валютам и отдельную карточку каждой
 включённой выплаты. Источником служат [исполненные операции](../operations/overview.md),
 а не изменение цены портфеля и не календарь будущих выплат.
@@ -51,10 +51,10 @@
 ## Какие выплаты входят в результат
 - Backend проверяет доступ локально и читает сохранённые операции. Фоновая загрузка должна завершить все страницы; ошибка страницы или повреждённая цепочка курсоров не подтверждают полноту.
- Только точные типы купона и дивиденда источника формируют результат. Суммы остаются точными десятичными строками в RUB; отрицательные корректировки сохраняют знак. Выплаты в других валютах не участвуют. Налоги, комиссии, сделки, переводы, погашения и переводы дивидендов не входят в доход.
+- Только точные типы купона и дивиденда источника формируют результат. Суммы остаются точными десятичными строками в исходной валюте; отрицательные корректировки сохраняют знак. Налоги, комиссии, сделки, переводы, погашения и переводы дивидендов не входят в доход.
- Итоги, временные интервалы и разбиение по инструментам считаются только в RUB. Система не загружает другие периоды ради сравнения полученного дохода с выбранным.
+- Итоги, временные интервалы и разбиение по инструментам не смешивают валюты и не создают общий конвертированный итог. Система не загружает другие периоды ради сравнения полученного дохода с выбранным.
 - Временные интервалы по-прежнему приходят с backend: дни для 1–45 дней, недели для 46–180 и месяцы для более длинного периода, включая пустые интервалы. Страница дохода не строит из них график или текстовую динамику; ответ API не меняется.
- Раздел «Выплаты» показывает карточки выплат в исходном порядке `entries`. В отдельном счёте каждая выплата — отдельная карточка. В режиме «Все счета» выплаты одного инструмента, дня и точного типа образуют группу, если их две и более ([правила группировки](../operations/overview.md#группировка-в-режиме-все-счета)). Группа стоит на месте первой выплаты; каждая строка счёта показывает название счёта и свою сумму со знаком. Визуальный итог группы — точная сумма в RUB по показанным выплатам; он скрыт, если полнота периода не `complete`, или у выплаты нет суммы, или сумма равна нулю. Это клиентский расчёт и не заменяет серверные итоги аналитики дохода, которые по-прежнему приходят из ответа API и не пересчитываются. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой выплате. Дополнительный запрос за составом не нужен.
+- Раздел «Выплаты» показывает карточки выплат в исходном порядке `entries`. В отдельном счёте каждая выплата — отдельная карточка. В режиме «Все счета» выплаты одного инструмента, дня и точного типа образуют группу, если их две и более ([правила группировки](../operations/overview.md#группировка-в-режиме-все-счета)). Группа стоит на месте первой выплаты; каждая строка счёта показывает название счёта и свою сумму со знаком. Визуальный итог группы — точная сумма по валютам по показанным выплатам; он скрыт, если полнота периода не `complete`, или у выплаты нет суммы, или сумма равна нулю. Это клиентский расчёт и не заменяет серверные итоги аналитики дохода, которые по-прежнему приходят из ответа API и не пересчитываются. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой выплате. Дополнительный запрос за составом не нужен.
 ## Полнота и принадлежность выплат
@@ -71,11 +71,11 @@
 Каждая запись `income-analytics.entries` содержит обязательный `instrumentKey`,
 равный `key` соответствующей строки `instruments`. Backend вычисляет этот ключ
 один раз при подготовке записей дохода и использует его же для группировки.
-Приоритет UID, FIGI, ticker/type и ID операции остаётся
+Приоритет UID, FIGI, ticker/type и ID операции с разделением по валюте остаётся
 серверным правилом; клиент воспринимает ключ как непрозрачную строку.
 Это поле принадлежит ответу аналитики; общий журнал операций его не требует.
-Backend обеспечивает принадлежность выплат и receipt count при
+Backend обеспечивает принадлежность выплат, валюту и receipt count при
 построении entries и instrument groups из одного набора данных. Frontend
 доверяет типизированному contract, не восстанавливает формулу идентификации
 и не выполняет второй consistency validator. Полностью пустой ответ допустим.
@@ -94,7 +94,7 @@ Backend обеспечивает принадлежность выплат и re
 выбранного счёта и сохраняет прежнее поведение. Будущие выплаты
 не включаются в итоги полученного дохода.
-Аналитика читает сохранённую историю операций и не рассчитывает налоги, доходность (её показывает [результат инвестирования](../portfolio/investment-performance.md)), или итоги по нескольким валютам.
+Аналитика читает сохранённую историю операций и не рассчитывает налоги, инвестиционную эффективность, доходность, валютную конвертацию или общий мультивалютный итог.
 Основное проверяемое поведение — в [спецификации дохода](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-income-analytics/spec.md),
 точная форма ответа — в [HTTP API](../../architecture/http-api.md).
@@ -56,8 +56,8 @@
 «сумма неизвестна» и не превращается в ноль или полученные деньги.
 Дата дивиденда обозначена как дата реестра. Offer и погашение сохраняют своё
 значение без суммы выплаты. У каждой строки видны тип,
-инструмент, дата и доступная сумма в RUB. Список не имеет
+инструмент, дата и доступная сумма в исходной валюте. Список не имеет
-пагинации. Пустой результат означает отсутствие
+пагинации и не конвертирует валюты. Пустой результат означает отсутствие
 известных поддерживаемых событий в выбранном окне, а не доказательство
 отсутствия всех будущих выплат. Инструмент без поддерживаемых данных
 не получает искусственную строку «нет данных».
@@ -70,7 +70,7 @@
 несуществующая дата дают `400`; обратный период — `400 INVALID_EVENTS_PERIOD`
 без замены периода и без запуска личной работы.
 Фильтрация на сервере предшествует сортировке и вычислению
-итога прогноза в RUB, включающего только купоны и дивиденды.
+`incomeTotalsByCurrency`, включающего только купоны и дивиденды.
 Итоги остаются в ответе API; полный экран показывает список без общего итога списка.
 В режиме «Все счета» события одного инструмента, даты, точного типа и `dateKind` образуют
@@ -78,7 +78,7 @@
 поэтому дата реестра дивиденда и иная дата того же инструмента не объединяются. Группа стоит на месте первого
 события. Полный список группирует все полученные события; превью обзора сначала берёт пять
 событий и группирует только их. Каждая строка счёта остаётся отдельной и показывает название
-счёта и свою прогнозную сумму. Визуальный итог группы — точная сумма в RUB; он показывается
+счёта и свою прогнозную сумму. Визуальный итог группы — точная сумма по валютам; он показывается
 только если полнота прогноза `complete` и у каждого события группы известна прогнозная сумма.
 Иначе итог скрыт, а строки остаются. Этот итог не равен итогам ответа API и не относится к полученному доходу.
@@ -31,9 +31,9 @@
 завершённой дневной свечи до московской даты котировки; база ищется за 20 дней.
 Денежная оценка без НКД равна цене в процентах, умноженной на текущий номинал
 и делённой на 100. Она округляется до девяти десятичных знаков. Оценка с НКД
-добавляет текущий накопленный купонный доход.
+добавляет текущий накопленный купонный доход только при совпадении валют.
 Это ориентир без комиссии: котировка может быть старше текущего номинала и НКД.
-Первоначальный номинал не заменяет текущий.
+FX-конвертация не выполняется, первоначальный номинал не заменяет текущий.
 Условия выпуска: текущий и первоначальный номинал, погашение, оферта,
 количество купонов в год, лот. Отдельно отмечены плавающий купон,
@@ -49,7 +49,7 @@
 Текущая купонная доходность — ближайший купон × 365 / длительность его периода
 в днях / денежная цена без НКД × 100 %. Decimal-расчёт округляется до четырёх
 знаков. Требуются известная неотрицательная выплата, положительные цена и
-период. Это годовая оценка при сохранении
+период и одинаковая валюта выплаты и цены. Это годовая оценка при сохранении
 размера купона и номинала, без налогов, комиссий и реинвестирования; она не
 является доходностью к погашению. Время котировки показывается отдельно.
@@ -79,7 +79,7 @@ HTML-источник, общий кэш и поведение при измен
 Позиция агрегирует только `BOND` с точным UID по доступным счетам, используя
 [снимок портфеля](../portfolio/overview.md) и decimal-арифметику. Средняя покупка взвешена
-по количеству. Неполные суммы недоступны; общая средняя
+по количеству. Неполные или разновалютные суммы недоступны; общая средняя
 и процент доступны только при положительных включённых позициях. Для
 коротких позиций и сочетания длинных с короткими эти показатели не синтезируются.
 Результат открытой позиции не включает выплаченные купоны и продажи и не
@@ -30,7 +30,7 @@
 Раздел «Акции» в боковой и мобильной навигации ведёт на `/stocks`: скринер
 запускается кнопкой «Найти» с необязательным названием или тикером, сектором,
-типом акции, площадкой, страной риска и максимальным размером
+типом акции, валютой расчётов, площадкой, страной риска и максимальным размером
 лота. Он использует полный полученный каталог и показывает только акции, для
 которых каталог подтверждает доступность покупки и торговли через API. Это не
 гарантирует, что конкретная заявка пользователя будет исполнена прямо сейчас.
@@ -90,10 +90,10 @@ UID включён в ключ кэша и подпись общего курс
 восстанавливается переходом на первую страницу с повторным запросом.
 [Портфель](../portfolio/overview.md) остаётся владельцем снимков и оценки позиций. Сводка
-фильтрует `STOCK` по точному UID и использует точную десятичную арифметику, в RUB.
+фильтрует `STOCK` по точному UID и использует точную десятичную арифметику, без конвертации валют.
 Средняя цена равна сумме количеств, умноженных на средние цены, делённой на
 общее количество; она округляется сервером до девяти знаков, проценты — до шести.
-Неполные денежные итоги недоступны. Общая средняя и процент доступны только если все включённые позиции
+Неполные или разновалютные денежные итоги недоступны. Общая средняя и процент доступны только если все включённые позиции
 положительны; для нулевого количества, коротких позиций и сочетания
 длинных с короткими они не синтезируются.
 Результат открытой позиции исключает продажи и дивиденды и не называется полной
@@ -13,7 +13,7 @@
 Исполненная операция содержит тип события, его категорию, описание,
 момент совершения, доступные сведения об инструменте и денежное движение.
 Запросы отменённых или ожидающих исполнения поручений не образуют этот журнал.
-Суммы остаются точными десятичными строками в RUB. Frontend
+Суммы остаются точными десятичными строками в исходной валюте. Frontend
 форматирует их и считает визуальный итог группы по показанным записям
 (см. [группировку](#группировка-в-режиме-все-счета)). Положительное и отрицательное
 движение сохраняют знак. Отсутствие `payment` означает «Без движения денег», а не нулевую сумму.
@@ -31,7 +31,7 @@
 затем группирует только их. Полный журнал группирует страницу, уже загруженную
 курсором; группы не переносятся между страницами. Курсор и порядок записей не меняются.
-Итог группы — точная сумма в RUB. Он показывается только
+Итог группы — точная сумма по каждой валюте, без конвертации. Он показывается только
 если полнота журнала `complete`, у каждой записи группы есть `payment`, и ни одна сумма
 не равна нулю. Иначе итог скрыт, а строки счетов остаются.
@@ -48,7 +48,7 @@
 но их недоступность не меняет финансовое событие.
 Журнал не вычисляет остаток после операции, историческую стоимость портфеля,
-совокупный налог. Изменение рыночной цены не становится
+совокупный налог или валютную конвертацию. Изменение рыночной цены не становится
 операцией. Переводы между счетами не схлопываются в одну запись; одинаковые
 ID операций разных счетов не означают дубликат.
@@ -30,13 +30,12 @@ Backend публикует статические маршруты под `/api/
 У них те же формы данных и фильтры, что у соответствующих разделов отдельного
 счёта. Позиции, операции (включая выплаты дохода) и события сохраняют источник
 в поле `account: { id, name }`; в ответах одного счёта это поле отсутствует.
-Итоги и деньги агрегированы в RUB. Точную форму транспорта задаёт
+Валютные итоги и деньги агрегированы. Точную форму транспорта задаёт
 [OpenAPI backend](../../architecture/http-api.md).
- Портфель и доступные денежные остатки суммируются сервером точно, в RUB,
+- Портфель и доступные денежные остатки суммируются сервером точно, по исходной
-  с точной десятичной арифметикой. Позиции и деньги в других валютах не
+  валюте, с точной десятичной арифметикой. FX-конвертации нет; правила
-  участвуют; правила неизвестных значений и состава сумм наследуются от
+  неизвестных значений и состава сумм наследуются от [портфеля](data-reference.md).
  [портфеля](data-reference.md).
 - Одинаковые бумаги разных счетов показаны одной карточкой с общим названием
  и идентификатором. Внутри всегда видны строки счетов: ссылка на портфель,
  количество, доступная стоимость, результат, средняя цена и доля позиции.
@@ -49,7 +48,7 @@ Backend публикует статические маршруты под `/api/
  API сохраняет позиции каждого счёта; объединяется только их представление.
  Порядок карточек задаёт первое вхождение
  бумаги; порядок счетов внутри карточки сохраняется. Одиночные позиции
-  используют прежнюю карточку. Доля относится к позициям
+  используют прежнюю карточку. Доля относится к позициям той же валюты
  во всём показанном портфеле, без денежных остатков.
 - Журнал объединяет операции по убыванию времени, при равном времени использует
  порядок идентификаторов счетов и операций. ID
@@ -60,12 +59,6 @@ Backend публикует статические маршруты под `/api/
  состав счетов влияет только на фактические выплаты выбранного периода.
 - Будущие события сортируются по дате и сохраняют отдельную строку каждого счёта.
  Прогноз не включается в реализованные доходы.
 - [Результат инвестирования](investment-performance.md) складывает потоки и
  стоимость только рублёвых счетов с полной историей. Счёт с причиной
  недоступности исключается, сводка помечается неполной. Похожие на перевод
  между своими счетами операции без подтверждённой связи исключают оба счёта
  (`UNCONFIRMED_TRANSFER`). Если оценки оставшихся счетов сделаны в разные
  московские дни, сводка недоступна: стоимости разных дат не складываются.
 ## Полнота, свежесть и доступ
@@ -46,10 +46,21 @@
 полный перечень остальных элементов, каждый со своей суммой и долей; топ-5
 и диаграмма при этом не меняются.
-Доли считаются от суммы стоимостей позиций разреза и
+Доли считаются от суммы стоимостей позиций разреза в выбранной валюте и
 в сумме дают ровно 100 %; округление — до десятой доли процента, очень малые
 доли показываются как «< 0,1 %». Отрицательные и нулевые стоимости, а также
-позиции без оценки в разрез не входят.
+позиции без оценки в разрез не входят. Конвертации валют нет: каждая позиция
 входит только в валюту своей оценки.
 ## Валюта
 У вкладки свой список валют — валюты оценок позиций акций, облигаций и фондов,
 отсортированные по ISO-коду, — и свой выбор, независимый от «Структуры
 портфеля». По умолчанию выбрана первая валюта списка. При одной валюте
 переключатель не показывается. Общего итога по нескольким валютам нет.
 Выбранные разрез и валюта сохраняются, пока пользователь остаётся на странице
 счёта, включая переключение её вкладок, и сбрасываются при новом заходе и при
 смене счёта.
 ## Диаграмма и неполные данные
@@ -58,7 +69,7 @@
 отмечен как неполный (`completeness: "incomplete"` — часть позиций не имеет
 оценки), над разрезом появляется предупреждение «Данные неполные», а под
 списком — сноска «Не учтено позиций: N» с числом позиций, не вошедших в разрез.
-Пустой разрез (нет позиций с положительной оценкой)
+Пустой разрез (нет позиций с положительной оценкой в выбранной валюте)
 показывает текстовое состояние вместо диаграммы.
 ## Откуда берутся сектор и эмитент
@@ -9,7 +9,6 @@
 Деньги представлены значением Money: ISO-код валюты и десятичная строка,
 например `{ "currency": "RUB", "value": "12500.5" }` — условный пример.
 Валюта всегда `RUB`: система работает только с рублями.
 Количества также передаются десятичными строками. Backend выполняет
 десятичную арифметику без промежуточного `Number`, нормализует отрицательные
 целую и дробную части и убирает незначащие конечные нули. Экспоненциальной
@@ -19,7 +18,7 @@
 `null` означает, что показатель нельзя определить из доступных данных.
 Это не ноль. Известная нулевая цена отличается от отсутствующей;
 позиция с ненулевым количеством и неизвестной стоимостью остаётся в составе.
-Позиции и деньги в валютах, отличных от RUB, отфильтровываются при получении из T-Bank и не участвуют ни в одном итоге.
+Несколько валют никогда не складываются в одну общую стоимость.
 ## Состав и денежные показатели
@@ -27,37 +26,25 @@
 | --- | --- | --- |
 | Позиция | Ненулевое количество обычного инструмента из `GetPortfolio.positions` | Виртуальные позиции не включаются; порядок источника сохраняется |
 | `quantity` | Количество из текущей позиции брокера | Допустимы дробные и отрицательные количества; это не число лотов |
-| `currentValue` | Количество × текущая цена из `GetPortfolio` | `null`, если цена недоступна |
+| `currentValue` | Количество × текущая цена из `GetPortfolio` | `null`, если цена или её валюта недоступны |
 | `averagePurchasePrice` | Средняя цена позиции, переданная брокером | Это цена единицы, а не сумма затрат или рассчитанная приложением история покупок |
-| `absoluteReturn` | Количество × (текущая цена − средняя цена) | Требует обеих цен; не включает продажи, купоны и дивиденды |
+| `absoluteReturn` | Количество × (текущая цена − средняя цена) | Требует обеих цен в одной известной валюте; не включает продажи, купоны и дивиденды |
-| Cash Balance | Суммы RUB из `GetPositions.money`, объединённые в один остаток | Заблокированные деньги не прибавляются; торгуемый инструмент `CURRENCY` остаётся позицией |
+| Cash Balance | Суммы из `GetPositions.money`, объединённые по валюте | Заблокированные деньги не прибавляются; торгуемый инструмент `CURRENCY` остаётся позицией |
-| Итог Portfolio | Стоимости позиций + Cash Balance в RUB | Не включает невычислимую стоимость; не обещает полную оценку портфеля |
+| `totalsByCurrency` | Стоимости позиций + доступные деньги той же валюты | Не включает невычислимую стоимость; не обещает полную оценку портфеля |
 | `lastSuccessfulAt` | Время формирования успешного снимка, UTC | Не является временем каждой котировки; запасной снимок сохраняет исходное время |
 | `isStale` | Истёк часовой срок свежести сохранённого portfolio source | Не описывает состояние клиентского кэша или ошибку фонового запроса |
 | `sector` | Сектор инструмента в том виде, как его определяет T-Bank, с обрезанными пробелами | Только для позиций `STOCK`, `BOND` и `FUND`; значение из одних пробел считается отсутствующим. Во всех остальных случаях — `null` |
 | `issuer` | Бренд актива инструмента по данным T-Bank: `{ id, name }` | Только для позиций `STOCK`, `BOND` и `FUND`, когда у актива известны uid и название бренда. Во всех остальных случаях — `null`. Не влияет на количество, стоимость и свежесть снимка; используется вкладкой [«Концентрация»](concentration.md) |
-Ненулевые денежные остатки суммируются в один Cash Balance. Позиции одинаковых
+Ненулевые денежные остатки одной валюты суммируются. Позиции одинаковых
 инструментов в ответе отдельного счёта не объединяются; визуальная группировка
 между счетами описана [отдельно](all-accounts.md#данные-и-вычисления).
 Сводка уже включает Cash Balance: прибавление денег к ней второй раз неверно.
 При отсутствии вычислимой стоимости у части позиций известный итог остаётся
 полезен, но представляет только оценённую часть. Известные нулевые итоги
-отдельного счёта не создают отдельную итоговую карточку. Если итог Portfolio
+отдельного счёта не создают валютные карточки. Если `totalsByCurrency` пуст,
-отсутствует, но позиции или деньги присутствуют, это не пустой портфель.
+но позиции или деньги присутствуют, это не пустой портфель.
 ## Результат инвестирования
 | Поле | Смысл | Ограничение |
 | --- | --- | --- |
 | `netInvested`, `currentValue`, `profit` | Чистые внешние потоки, сумма RUB-оценок, их разность | Только RUB, копейки |
 | `return.value` | Доля XIRR (`0.151` = 15,1 %) | `null` с `unavailableReason`; при `basis = period` — за весь период |
 | `benchmark`, `reference` | Те же потоки в MCFTRR и IMOEX | IMOEX только справка |
 | `outperformance` | Разница долей и стоимостей с MCFTRR | `null`, если любая сторона недоступна |
 | `series` | Точки торговых дней MCFTRR | Пусто без истории индекса |
 Подробнее — [результат инвестирования](investment-performance.md).
 ## Идентификация и оформление инструмента
@@ -82,32 +69,33 @@ ISIN, тикер и `logoName` могут быть `null`. `logoName` — имя
 облигации (`BOND`), прочие инструменты (`OTHER`) и деньги (`CASH`).
 Торгуемые валютные инструменты входят в `OTHER`; денежные остатки — в `CASH`.
 Сервер строит структуру из позиций и денег, без повторного добавления
-итога Portfolio.
+`totalsByCurrency`.
 Доля категории — её стоимость / известная стоимость позиций и денег
-× 100. Backend округляет процент до шести знаков;
+в выбранной валюте × 100. Backend округляет процент до шести знаков;
 frontend показывает до сотых. Положительное значение меньше 0,01%
 отображается как «< 0,01 %», если серверное округление не превратило его в ноль.
 В геометрию диаграммы передаются только числовые проценты; суммы в списке
 и подсказке форматируются из исходных точных строк.
 Доля на карточке отдельной позиции использует другой знаменатель:
-сумму стоимостей всех отображаемых позиций **без денег**. Это приблизительный
+сумму стоимостей всех позиций той же валюты **без денег**. Это приблизительный
 показатель для отображения, рассчитанный frontend. Он не изменяет Money.
 В режиме всех счетов знаменатель охватывает все показанные счета.
 | Состояние | Доступное представление |
 | --- | --- |
-| Все составляющие оценены, неотрицательны, итог положителен | Суммы, доли и кольцевая диаграмма |
+| Все составляющие оценены, неотрицательны, итог положителен | Суммы, доли и кольцевая диаграмма выбранной валюты |
-| Есть позиция без оценки | `unvaluedCategories` содержит её категорию и количество; суммы известной части остаются, доли и кольцо недоступны |
+| Есть позиция без оценки | `unvaluedCategories` содержит её категорию и количество; суммы известной части остаются, доли и кольцо недоступны для всех валют |
-| Есть отрицательная составляющая | Суммы со знаком остаются; доли и кольцо отключены, даже если итог категории положителен |
+| Есть отрицательная составляющая | Суммы со знаком остаются; доли и кольцо отключены для её валюты, даже если итог категории положителен |
 | Состав пуст или имеет нулевую стоимость | Текстовое состояние вместо кольца |
-В общем портфеле проверка
+Неоценённой позиции нельзя достоверно назначить валюту по её стоимости,
 поэтому ограничение долей действует на все валюты. В общем портфеле проверка
 отрицательных денег выполняется по остаткам счетов до взаимозачёта.
 Нормативные основы: [нормализованный состав](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-нормализованный-состав-portfolio)
-и [точные значения и итоговая сумма в RUB](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-точные-значения-и-итоговая-сумма-в-rub).
+и [точные значения и валютные агрегаты](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-точные-значения-и-валютные-агрегаты).
 Структура и общий режим подтверждены реализацией и её проверками;
 отдельных требований к ним в основной спецификации портфеля пока нет.
 Поля транспорта следует сверять с [HTTP API](../../architecture/http-api.md),
@@ -7,7 +7,7 @@
 базы для разбора не нужны; не переносите их в документацию или отчёт.
 1. **Определите предмет сравнения.** Запишите, открыт отдельный счёт или
-   «Все счета» и какой показатель расходится. Текущая стоимость,
+   «Все счета», какая валюта и какой показатель расходятся. Текущая стоимость,
   свободные деньги, результат открытой позиции и полученный доход — разные
   величины. Убедитесь, что сравниваемые значения относятся к одному составу
   счетов и инструменту. Название или тикер сами по себе не доказывают
@@ -19,9 +19,9 @@
   автоматически, поэтому расхождение проверяйте по показанному состоянию
   источника, а не по результату ручного обновления. Перезагрузка backend
   сохраняет последний полный снимок в SQLite, но не создаёт историю стоимости.
-3. **Проверьте состав суммы.** Итог складывается из вычислимых стоимостей
+3. **Проверьте состав суммы.** Для одной валюты итог складывается из
-   позиций и доступных денег в RUB. Не добавляйте деньги второй раз и не
+   вычислимых стоимостей позиций и доступных денег. Не добавляйте деньги
-   включайте заблокированные средства.
+   второй раз, не складывайте валюты и не включайте заблокированные средства.
   Ненулевая позиция с `currentValue: null` делает оценку неполной, но не
   даёт нулевой вклад в смысле полной стоимости. `CURRENCY` участвует
   в суммах, хотя текущий интерфейс скрывает её карточку —
@@ -1,67 +0,0 @@
 # Результат инвестирования
 Вкладка «Результат» на странице брокерского счёта и в режиме
 [«Все счета»](all-accounts.md) отвечает на два вопроса:
 - сколько заработали вложенные деньги;
 - обогнал ли пользователь рынок.
 Результат считается за всё время истории счёта, только в рублях. Решение и
 отклонённые альтернативы описаны в
 [ADR 023](../../adr/023-investment-performance-vs-index.md).
 ## Показатели
 | Показатель | Смысл |
 | --- | --- |
 | Вложено (нетто) | Сумма пополнений минус сумма выводов рублей |
 | Прибыль | Текущая стоимость портфеля минус чистые вложения |
 | Доходность | Ставка XIRR с учётом сумм и дат пополнений и выводов |
 | Те же деньги в индексе Мосбиржи | Стоимость и доходность тех же пополнений и выводов, вложенных в индекс полной доходности MCFTRR (с дивидендами после налогов) |
 | Опережение или отставание рынка | Разница доходностей в процентных пунктах и разница стоимостей в рублях |
 Ценовой индекс IMOEX не учитывает дивиденды. Он показан на графике только
 для справки и в сравнении не участвует.
 Период начинается с первого пополнения, а не с открытия счёта. Если деньги
 вложены меньше 365 дней, проценты показаны за фактическое число дней и не
 пересчитываются в годовые.
 ## Какие операции считаются потоками
 Внешние потоки — только пополнения и выводы рублей (типы T-Bank `INPUT`,
 `INPUT_ACQUIRING`, `INPUT_SWIFT`, `INP_MULTI` и соответствующие `OUTPUT`).
 Сделки, купоны, дивиденды, погашения, налоги и комиссии уже отражены в
 текущей стоимости и потоками не являются. Учитываются только операции до
 момента последней полной оценки портфеля.
 ## Когда результата нет
 Число не подменяется нулём: вместо него показывается причина.
 | Причина | Когда возникает |
 | --- | --- |
 | `HISTORY_START_UNKNOWN` | Неизвестна дата открытия счёта |
 | `OPERATIONS_HISTORY_INCOMPLETE` | История операций не получена полностью до момента оценки |
 | `PORTFOLIO_VALUATION_INCOMPLETE` | Нет полной оценки портфеля |
 | `UNVALUED_SECURITIES_TRANSFER` | Бумаги введены или выведены без денежной оценки |
 | `UNCONFIRMED_TRANSFER` | В «Все счета» есть похожие на перевод между своими счетами операции, связь которых источник не подтверждает |
 | `ACCOUNT_VALUATION_DATES_DIFFER` | В «Все счета» последние оценки счетов сделаны в разные московские дни |
 | `NO_SOLUTION` | Уравнение доходности не имеет решения; прибыль остаётся |
 | `AMBIGUOUS_RETURN` | Потоки меняют знак больше одного раза, и единственность ставки не доказана; прибыль остаётся |
 | `INDEX_HISTORY_UNAVAILABLE` | Нет истории индекса за период; прибыль и доходность остаются, сравнения нет |
 В «Все счета» счёт с причиной исключается, а результат помечается
 неполным со списком исключённых счетов. Если считать не по чему, результат
 недоступен целиком.
 ## График
 На графике показаны ступенчатая линия чистых вложений, стоимость тех же
 денег в индексе по закрытиям торговых дней, справочная линия индекса без
 дивидендов и отметка текущей стоимости портфеля на конец периода. Линии
 прошлой стоимости портфеля нет: такая история пока не хранится.
 Нормативное поведение задаёт change
 `2026-11-07-investment-performance-vs-index` в репозитории specs, форму
 ответа — [HTTP API](../../architecture/http-api.md#investment-performance).
@@ -10,10 +10,9 @@
 ## Снимок и связанные области
 Снимок состоит из позиций по инструментам, доступных денежных остатков,
-итоговой суммы в RUB и структуры активов. Позиция означает ненулевое количество
+валютных итогов и структуры активов. Позиция означает ненулевое количество
 обычного инструмента в брокерском портфеле. Торгуемая валютная позиция
-`CURRENCY` и свободные деньги имеют разный смысл и передаются раздельно;
+`CURRENCY` и свободные деньги имеют разный смысл и передаются раздельно.
 в итоге учитываются только деньги в RUB.
 Точный смысл сумм и неизвестных значений раскрыт в
 [справочнике данных](data-reference.md).
@@ -30,20 +29,21 @@ Backend получает данные через серверную
 самостоятельно: его ошибка или отсутствие данных не скрывает основной
 портфель. Полученные выплаты и прогноз не добавляются к текущей стоимости
 повторно и не превращают результат открытой позиции в полную доходность.
 Полную доходность с учётом пополнений и выводов показывает вкладка
 [«Результат»](investment-performance.md).
 ## Как читать экран
-Сводка показывает одну карточку с итоговой суммой в RUB. Деньги уже включены
+Валютная сводка показывает отдельную карточку для каждого полученного итога.
-в итог. Сумма обозначена ₽; вспомогательным технологиям доступны полное
+Деньги уже включены в итог своей валюты. RUB, USD и EUR обозначены ₽, $ и €;
 другие валюты сохраняют ISO-код. Вспомогательным технологиям доступны полное
 значение и название валюты. Суммы сохраняют все исходные цифры, знак и
 дробные позиции, включая `-0,5`; длинные значения переносятся без обрезания.
-Карточка не интерактивна. Отсутствующая итоговая сумма не получает искусственный
+Карточки не интерактивны и занимают одну колонку на узком экране,
-ноль. Пустой итог не скрывает доступный состав портфеля.
+две или три на широком. Отсутствующая валюта не получает искусственную
 нулевую карточку. Пустые итоги не скрывают доступный состав портфеля.
 Структура после сводки распределяет известную стоимость по акциям,
-облигациям, другим активам и свободным деньгам в RUB.
+облигациям, другим активам и свободным деньгам. При нескольких валютах
 пользователь выбирает одну; при одной отдельного переключателя нет.
 Кольцевая диаграмма дополнена текстовым списком сумм и долей и подсказкой;
 на узком экране список расположен под ней. Неизвестная оценка, отрицательные
 составляющие или нулевой итог ограничивают возможность показать доли —
@@ -71,14 +71,14 @@ Backend получает данные через серверную
 Существует расхождение: [согласованная спецификация представления позиций](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/portfolio-view/spec.md#requirement-представление-карточек-позиций-на-клиенте)
 требует доступности всех иных типов в отдельной секции, а текущие frontend
 и его проверка исключают `CURRENCY` только из списка карточек. Такие позиции
-остаются в ответе, но не входят в итоговую сумму, структуру; их учёт в знаменателе
+остаются в ответе, валютных итогах, структуре и знаменателе долей остальных
-долей остальных позиций требует проверки. Выбор между изменением интерфейса и
+позиций. Это описание фактического ограничения; выбор между изменением
-согласованием требований остаётся отдельной задачей.
+интерфейса и согласованием требований остаётся отдельной задачей.
 ## Свежесть и границы
 При первом запросе экран показывает каркас заголовка, сводки и разделов.
-Каркас итоговой карточки не обещает наличие суммы.
+Три формы валютных карточек в каркасе не обещают наличие трёх валют.
 Загрузка обозначена для вспомогательных технологий; декоративные элементы
 не содержат данных и не получают фокус. При обычном фоновом обновлении
 сохраняются предыдущие суммы и время успешного получения в UTC.
@@ -93,9 +93,10 @@ Backend получает данные через серверную
 Правила времени и ошибок приведены в [потоке загрузки](flows/portfolio-loading.md).
 Отдельного чтения истории стоимости нет, но каждый полный снимок
-сохраняет точку оценки по счёту в RUB для будущих поддерживаемых
+сохраняет точку оценки по счёту и валюте для будущих поддерживаемых
 представлений; публичного графика в текущем решении нет. Нет также
-учёта виртуальных позиций или заблокированных средств. Последний полный снимок сохраняется после перезапуска;
+валютной конвертации, учёта виртуальных позиций или заблокированных
 средств. Последний полный снимок сохраняется после перезапуска;
 обновлением личных данных владеет часовой обход, рассчитанный на один
 экземпляр backend. Действие «Обновить» выполняет только локальное
 перечитывание открытого экрана и не запускает работу с T-Bank.
@@ -91,7 +91,7 @@ _Не использовать_: тип аккаунта T-Bank, protobuf type.
 ## Portfolio
 Текущее нормализованное состояние инвестиций одного Brokerage Account,
-включающее позиции, доступный денежный остаток и итоговую сумму в RUB.
+включающее позиции, доступные денежные остатки и итоги по каждой валюте.
 _Не использовать_: общий портфель, баланс счёта.
@@ -123,7 +123,7 @@ _Не использовать_: денежный остаток, cash balance.
 Вкладка страницы одного Brokerage Account, показывающая, какие акции,
 облигации, секторы и эмитенты занимают наибольшую часть текущей оценки
-Portfolio в RUB. Отличается от [структуры
+Portfolio, без валютной конвертации. Отличается от [структуры
 портфеля](domains/portfolio/data-reference.md#структура-и-доли): в её разрезах
 деньги не входят в знаменатель долей.
@@ -188,8 +188,8 @@ _Не использовать_: аватар актива, иконка бум
 ## Cash Balance
-Ненулевой доступный денежный остаток Portfolio в RUB; не является
+Ненулевой доступный денежный остаток Portfolio в одной валюте; не является
-Portfolio Position и передаётся отдельно от `positions`.
+Portfolio Position и передаётся отдельно от `positions` в `cashBalances`.
 _Не использовать_: валютная позиция, заблокированные средства.
@@ -202,13 +202,12 @@ _Не использовать_: история портфеля, snapshot дл
 ## Точка истории стоимости портфеля
-Полная оценка одного Brokerage Account в RUB на момент успешного
+Полная оценка одного Brokerage Account в одной валюте на момент успешного
 обновления Portfolio; последовательность таких точек описывает изменение
 оценки во времени, включая неторговые дни. Не является Portfolio Snapshot
-или [Результатом инвестирования](#результат-инвестирования); отсутствие цены
+или инвестиционной доходностью; отсутствие цены позиции не приравнивается к нулю.
 позиции не приравнивается к нулю.
-_Не использовать_: снимок состава портфеля.
+_Не использовать_: снимок состава портфеля, доходность.
 ## Client Cached Snapshot
@@ -293,7 +292,8 @@ _Не использовать_: активный refresh token, признак
 Прогнозируемое на ближайший период денежное или связанное корпоративное
 событие одного Brokerage Account, рассчитанное по текущей Portfolio Position;
 не является исполненной Ledger Entry. Прогнозная сумма события передаётся как
-nullable Money: известные coupon, dividend и maturity содержат Money в RUB, offer или неизвестные денежные условия передаются как `null`.
+nullable Money: известные coupon, dividend и maturity содержат Money в исходной
 валюте, offer или неизвестные денежные условия передаются как `null`.
 В публичном API прогноз доступен через маршруты `/events`; в доменной
 документации событие называется Future Cash Event.
@@ -309,49 +309,10 @@ _Не использовать_: upstream dividend type, MOEX row name.
 ## Realized Income Analytics
 Результат анализа исполненных купонов и дивидендов по счёту за календарный
-период включительно в часовом поясе Europe/Moscow. Сохраняет знаки денежных выплат,
+период включительно в часовом поясе Europe/Moscow. Сохраняет исходные валюты
-переданных брокером, в RUB. Это не налоговый расчёт,
+и знаки денежных выплат, переданных брокером. Это не налоговый расчёт,
-прогноз или [Результат инвестирования](#результат-инвестирования); правила
+прогноз или инвестиционная доходность; правила расчёта объясняет
-расчёта объясняет [область дохода](domains/income/overview.md).
+[область дохода](domains/income/overview.md).
-_Не использовать_: доходность выплат, общий доход в нескольких валютах,
+_Не использовать_: доходность, общий доход в одной валюте, гарантированный
-гарантированный доход.
+доход.
 ## Результат инвестирования
 Прибыль, доходность и сравнение с индексом Мосбиржи для счёта или «Все
 счета» за всё время в рублях. Правила описаны в
 [результате инвестирования](domains/portfolio/investment-performance.md),
 решение — в [ADR 023](adr/023-investment-performance-vs-index.md).
 _Не использовать_: нереализованный результат, доход.
 ## Внешний денежный поток
 Пополнение (положительный поток) или вывод (отрицательный поток) рублей со
 счёта. Сделки, выплаты, налоги и комиссии внешними потоками не являются.
 _Не использовать_: операция, выплата.
 ## Доходность (XIRR)
 Годовая ставка, при которой дисконтированные по фактическим дням внешние
 потоки и текущая стоимость в сумме дают ноль. При истории короче года
 показывается доходность за период. Единственное значение термина
 «доходность» для личного результата.
 _Не использовать_: доходность к погашению, рост цены позиции.
 ## Те же деньги в индексе Мосбиржи
 Стоимость и доходность тех же внешних потоков, вложенных в индекс полной
 доходности MCFTRR по закрытию дня потока. Ценовой IMOEX — только справка.
 _Не использовать_: бенчмарк IMOEX, теневой портфель (в интерфейсе).
 ## Опережение рынка
 Разница доходности пользователя и тех же денег в индексе в процентных пунктах
 и разница стоимостей в рублях; отрицательное значение называется отставанием.
 _Не использовать_: альфа.
@@ -1,7 +1,6 @@
 # Интеграция с MOEX ISS
-MOEX ISS дополняет данные T-Bank публичной информацией об облигациях и
+MOEX ISS дополняет данные T-Bank публичной информацией об облигациях.
 дневными закрытиями индексов Мосбиржи.
 Backend получает её по HTTPS в JSON с `iss.moex.com`; запросы содержат
 идентификаторы выпуска, без token T-Bank и идентификатора брокерского счёта.
 MOEX не определяет доступ пользователя к инвестициям и не подтверждает
@@ -48,32 +47,6 @@ HTTP-запрос ограничен таймаутом. Сеть, неуспе
 [странице облигации](../domains/instruments/bonds.md#получение-данных-и-восстановление).
 Наличие успешного HTTP-ответа не гарантирует котировку без задержки.
 ## Индексы
 Для [результата инвестирования](../domains/portfolio/investment-performance.md)
 backend читает дневные закрытия MCFTRR (полная доходность после налогов) и
 IMOEX (ценовой, справка) из
 `/iss/history/engines/stock/markets/index/securities/{SECID}.json` с
 `history.columns=TRADEDATE,CLOSE`, постранично по `history.cursor`.
 Любая некорректная страница считается сбоем: частичная история не
 сохраняется.
 Закрытия и подтверждённый диапазон покрытия хранятся локально в SQLite
 (исключение из ADR 019, см. [ADR 023](../adr/023-investment-performance-vs-index.md)).
 Догрузка выполняется при чтении результата одной одновременной загрузкой на
 индекс: расширение диапазона назад — сразу, проверка ещё не опубликованного
 закрытия и повтор после сбоя — не чаще раза в час. Недоступность
 MOEX не возвращается как HTTP-ошибка: при достаточной сохранённой истории
 результат считается по ней, иначе сравнение помечается
 `INDEX_HISTORY_UNAVAILABLE`. События лога —
 `integration.moex.index_history.succeeded` и `.failed`, без данных
 пользователя.
 ISS бесплатно отдаёт данные для ознакомления; приложение личное и не
 распространяет их, источник указан в пояснении «Как считали».
 ## Ссылки
 Условия обработки источника в прогнозе закреплены в
 [спецификации будущих событий](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/9e227a563dda67620f0ad78228aa8a4c18bf35a0/openspec/specs/brokerage-account-upcoming-events/spec.md#requirement-upcoming-events-use-complete-source-results).
 Точный механизм транспорта, разбора и сопоставления реализован в
@@ -11,7 +11,7 @@ WealthLedger обращается к Invest API на сервере по gRPC ov
 | Категория | Для чего используется |
 | --- | --- |
 | Открытые счета | Определить доступный состав счетов и проверить доступ к конкретному счёту |
-| Портфель и денежные остатки | Показать текущий состав инвестиций и итоговую сумму в RUB |
+| Портфель и денежные остатки | Показать текущий состав инвестиций и итоги по исходным валютам |
 | Исполненные операции | Построить журнал и выделить полученные купоны и дивиденды |
 | Инструменты и рынок | Имена, идентификаторы, цены, свечи, параметры акций и облигаций |
 | Классификация инструментов | Сектор акций, облигаций и фондов и бренд актива для разрезов [концентрации](../domains/portfolio/concentration.md) |
@@ -19,7 +19,7 @@ WealthLedger — локальное приложение для частного
 | --- | --- |
 | Найти свой инвестиционный счёт | [Список счетов](domains/accounts/overview.md), их типы и доступные сводки |
 | Вести банковские карты | [Ручной учёт](domains/cards/overview.md): независимые балансы, расходы, пополнения, переводы, возвраты и месячные сводки |
-| Понять текущий состав инвестиций | [Портфель](domains/portfolio/overview.md): позиции, денежные остатки и итоговая сумма в RUB |
+| Понять текущий состав инвестиций | [Портфель](domains/portfolio/overview.md): позиции, денежные остатки и итоги по валютам |
 | Увидеть, где сконцентрированы деньги | [Концентрация](domains/portfolio/concentration.md): крупнейшие бумаги, секторы и эмитенты счёта |
 | Разобрать уже совершённые движения | [Журнал операций](domains/operations/overview.md): исполненные операции с фильтрами и последовательной загрузкой истории |
 | Посчитать полученные выплаты | [Пассивный доход](domains/income/overview.md): исполненные купоны и дивиденды за календарный период |
@@ -41,14 +41,12 @@ WealthLedger — локальное приложение для частного
 Портфель отвечает на вопрос «что есть сейчас», журнал — «что исполнено»,
 аналитика дохода — «какие выплаты уже получены», будущие события — «что
-ожидается», [результат инвестирования](domains/portfolio/investment-performance.md) —
+ожидается». Прогноз не подтверждает фактическое зачисление. Полученные купоны
-«как сработали вложенные деньги и обогнал ли я индекс Мосбиржи». Прогноз не
+и дивиденды не равны инвестиционной доходности или результату после налогов.
 подтверждает фактическое зачисление. Полученные купоны и дивиденды сами по
 себе не равны доходности или результату после налогов.
-Система работает только с рублями (RUB): данные в других валютах отфильтровываются
+Денежная сумма всегда относится к одной валюте. Недоступное значение
-при получении из T-Bank и MOEX и не участвуют в итогах. Недоступное значение
+отличается от нуля, а объединение счетов не означает автоматическую
-отличается от нуля, а объединение счетов не означает конвертацию. Краткие определения собраны в [глоссарии](glossary.md).
+конвертацию всех валют. Краткие определения собраны в [глоссарии](glossary.md).
 ## Источники и границы продукта
@@ -1,12 +1,12 @@
 {
  "name": "wealth-ledger-docs",
-  "version": "0.1.8",
+  "version": "0.1.6",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "wealth-ledger-docs",
-      "version": "0.1.8",
+      "version": "0.1.6",
      "devDependencies": {
        "@commitlint/cli": "21.2.4",
        "@commitlint/config-conventional": "21.2.4",
@@ -1,6 +1,6 @@
 {
  "name": "wealth-ledger-docs",
-  "version": "0.1.8",
+  "version": "0.1.6",
  "private": true,
  "engines": {
    "node": "24.22.1"
@@ -2,8 +2,7 @@
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": [
    "config:recommended",
-    ":semanticCommitTypeAll(chore)",
+    ":semanticCommitTypeAll(chore)"
    "security:minimumReleaseAgeNpm"
  ],
  "timezone": "Europe/Moscow",
  "labels": [
@@ -11,13 +10,6 @@
  ],
  "dependencyDashboard": true,
  "rangeStrategy": "pin",
  "prConcurrentLimit": 5,
  "lockFileMaintenance": {
    "enabled": true,
    "schedule": [
      "before 4am on the first day of the month"
    ]
  },
  "packageRules": [
    {
      "matchUpdateTypes": [
@@ -26,27 +18,6 @@
      ],
      "groupName": "non-major dependencies"
    },
    {
      "matchManagers": [
        "github-actions"
      ],
      "matchUpdateTypes": [
        "minor",
        "patch"
      ],
      "groupName": "non-major github actions"
    },
    {
      "matchManagers": [
        "docker-compose",
        "dockerfile"
      ],
      "matchUpdateTypes": [
        "minor",
        "patch"
      ],
      "groupName": "non-major container images"
    },
    {
      "matchUpdateTypes": [
        "major"