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

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-границе.