docs: document income without comparisons and unified payouts (WealthLedger/main#33) (#40)

docs: document income without comparisons and unified payouts (WealthLedger/main#33)
2026-10-13 18:16:59 +03:00
parent 803f0843f8
commit 03fb045a9e
7 changed files with 44 additions and 37 deletions
@@ -61,6 +61,17 @@ Envelope несовместим с прежними bare-array ответами:
 поставляются согласованной парой. Финальный artifact передаётся явно;
 локальная генерация и CI frontend читают только собственный snapshot.

+## Income analytics
+
+`GET /api/v1/brokerage-accounts/{accountId}/income-analytics` и общий маршрут
+`all` возвращают результат только выбранного периода: итоги по исходным
+валютам, точные записи выплат, разбиение по инструментам и временные
+интервалы. Данных сравнения с предыдущим периодом или годом ранее в ответе
+нет — ни в теле, ни среди зависимостей `meta.dependencies`, роль которых
+ограничена значением `selected`. Публичную машинную схему задаёт
+backend-generated OpenAPI; frontend получает её обновлённый snapshot отдельно.
+Точную семантику поведения описывает [доход](../domains/income/overview.md).
+
 ## Validation и identity

 Backend преобразует и проверяет входные данные на общей HTTP-границе.