docs: describe all-account row grouping (WealthLedger/main#47) (#59)

domains/income/overview.md

@@ -54,7 +54,7 @@
 - Только точные типы купона и дивиденда источника формируют результат. Суммы остаются точными десятичными строками в исходной валюте; отрицательные корректировки сохраняют знак. Налоги, комиссии, сделки, переводы, погашения и переводы дивидендов не входят в доход.
 - Итоги, временные интервалы и разбиение по инструментам не смешивают валюты и не создают общий конвертированный итог. Система не загружает другие периоды ради сравнения полученного дохода с выбранным.
 - Временные интервалы по-прежнему приходят с backend: дни для 1–45 дней, недели для 46–180 и месяцы для более длинного периода, включая пустые интервалы. Страница дохода не строит из них график или текстовую динамику; ответ API не меняется.
-- Раздел «Выплаты» показывает единый список карточек выплат в исходном порядке `entries`: одна карточка на каждую выплату. Внешних групп по инструментам или валютам, итогов и количества выплат инструмента нет. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой карточке; валюты разделены в итогах. Дополнительный запрос за составом не нужен.
+- Раздел «Выплаты» показывает карточки выплат в исходном порядке `entries`. В отдельном счёте каждая выплата — отдельная карточка. В режиме «Все счета» выплаты одного инструмента, дня и точного типа образуют группу, если их две и более ([правила группировки](../operations/overview.md#группировка-в-режиме-все-счета)). Группа стоит на месте первой выплаты; каждая строка счёта показывает название счёта и свою сумму со знаком. Визуальный итог группы — точная сумма по валютам по показанным выплатам; он скрыт, если полнота периода не `complete`, или у выплаты нет суммы, или сумма равна нулю. Это клиентский расчёт и не заменяет серверные итоги аналитики дохода, которые по-прежнему приходят из ответа API и не пересчитываются. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой выплате. Дополнительный запрос за составом не нужен.
 
 ## Полнота и принадлежность выплат
 
@@ -80,7 +80,7 @@ Backend обеспечивает принадлежность выплат, ва
 доверяет типизированному contract, не восстанавливает формулу идентификации
 и не выполняет второй consistency validator. Полностью пустой ответ допустим.
 Состав и исходный серверный порядок записей и знак сумм
-сохраняются, frontend не пересчитывает денежные итоги. Стабильный ID в пределах подключения и счёта определяет одну операцию:
+сохраняются; серверные денежные итоги frontend не пересчитывает (визуальный итог группы в режиме «Все счета» отдельный, см. выше). Стабильный ID в пределах подключения и счёта определяет одну операцию:
 повторная сверка обновляет её без двойного учёта. Одинаковые ID разных счетов
 остаются разными выплатами. Изменение источника логотипа позволяет заново
 показать изображение после буквенной заглушки.

domains/income/upcoming-events.md

@@ -71,7 +71,16 @@
 без замены периода и без запуска личной работы.
 Фильтрация на сервере предшествует сортировке и вычислению
 `incomeTotalsByCurrency`, включающего только купоны и дивиденды.
-Итоги остаются в ответе API; полный экран показывает список без общего итога.
+Итоги остаются в ответе API; полный экран показывает список без общего итога списка.
+
+В режиме «Все счета» события одного инструмента, даты, точного типа и `dateKind` образуют
+группу, если их две и более, в том числе одного счёта. Ключ дополнительно включает `dateKind`,
+поэтому дата реестра дивиденда и иная дата того же инструмента не объединяются. Группа стоит на месте первого
+события. Полный список группирует все полученные события; превью обзора сначала берёт пять
+событий и группирует только их. Каждая строка счёта остаётся отдельной и показывает название
+счёта и свою прогнозную сумму. Визуальный итог группы — точная сумма по валютам; он показывается
+только если полнота прогноза `complete` и у каждого события группы известна прогнозная сумма.
+Иначе итог скрыт, а строки остаются. Этот итог не равен итогам ответа API и не относится к полученному доходу.
 
 ## Получение и отказы