docs(portfolio): document investment performance vs index (WealthLedger/main#54)

architecture/context.md

@@ -31,7 +31,8 @@ WealthLedger нормализует их для просмотра и сопос
 информацией об инструментах. [Интеграция T-Bank](../integrations/tbank.md)
 объясняет полномочия подключения и ограничения внешней зависимости.
 
-[MOEX ISS](../integrations/moex.md) поставляет публичные параметры и календарь выпусков облигаций.
+[MOEX ISS](../integrations/moex.md) поставляет публичные параметры и календарь выпусков облигаций,
+а также дневные закрытия индексов Мосбиржи для сравнения результата.
 [Реестр НКР](../integrations/nkr.md) используется для поиска кредитного рейтинга конкретного выпуска;
 рейтинг эмитента не подставляется вместо него. Отсутствие подходящей записи
 и недоступность источника имеют разный смысл. Правила интерпретации этих

architecture/http-api.md

@@ -72,6 +72,16 @@ Envelope несовместим с прежними bare-array ответами:
 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-границе.