docs: document income without comparisons and unified payouts (WealthLedger/main#33) (#40)
docs: document income without comparisons and unified payouts (WealthLedger/main#33)
This commit was merged in pull request #40.
This commit is contained in:
@@ -4,7 +4,7 @@
|
||||
купонами и дивидендами за выбранный период». Пользователь открывает
|
||||
`/accounts/:accountId/income` из обзора счёта или
|
||||
[общий доход](../portfolio/all-accounts.md) по доступным счетам.
|
||||
Экран показывает итоги по валютам, сравнение и отдельную карточку каждой
|
||||
Экран показывает итоги по валютам и отдельную карточку каждой
|
||||
включённой выплаты. Источником служат [исполненные операции](../operations/overview.md),
|
||||
а не изменение цены портфеля и не календарь будущих выплат.
|
||||
|
||||
@@ -38,7 +38,7 @@
|
||||
|
||||
При первой загрузке или новом периоде без сохранённых данных показан
|
||||
каркас страницы. Пустой результат объясняет отсутствие исполненных купонов и
|
||||
дивидендов, сохраняя фильтры, налоговое пояснение и сравнения. Ошибка запроса
|
||||
дивидендов, сохраняя фильтры и налоговое пояснение. Ошибка запроса
|
||||
или нарушение принадлежности выплат даёт локальное состояние с действием «Повторить».
|
||||
При фоновом обновлении того же периода сохранённый ответ и черновик
|
||||
остаются видимыми: загрузку обозначает индикатор, неуспешное обновление —
|
||||
@@ -51,32 +51,15 @@
|
||||
|
||||
- Backend проверяет доступ локально и читает сохранённые операции. Фоновая загрузка должна завершить все страницы; ошибка страницы или повреждённая цепочка курсоров не подтверждают полноту.
|
||||
- Только точные типы купона и дивиденда источника формируют результат. Суммы остаются точными десятичными строками в исходной валюте; отрицательные корректировки сохраняют знак. Налоги, комиссии, сделки, переводы, погашения и переводы дивидендов не входят в доход.
|
||||
- Итоги, сравнения, временные интервалы и разбиение по инструментам не смешивают валюты и не создают общий конвертированный итог. Страница показывает сравнения с предыдущим периодом и годом ранее, когда календарная дата и история счёта позволяют. Неполное сравнение имеет отдельное сообщение, без нулевой базы.
|
||||
- Итоги, временные интервалы и разбиение по инструментам не смешивают валюты и не создают общий конвертированный итог. Система не загружает другие периоды ради сравнения полученного дохода с выбранным.
|
||||
- Временные интервалы по-прежнему приходят с backend: дни для 1–45 дней, недели для 46–180 и месяцы для более длинного периода, включая пустые интервалы. Страница дохода не строит из них график или текстовую динамику; ответ API не меняется.
|
||||
- Раздел «Выплаты» показывает единый список карточек выплат в исходном порядке `entries`: одна карточка на каждую выплату. Внешних групп по инструментам или валютам, итогов и количества выплат инструмента нет. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой карточке; валюты по-прежнему разделены в итогах и сравнениях. Дополнительный запрос за составом не нужен.
|
||||
|
||||
Сравнение с непосредственно предыдущим периодом использует предыдущий полный
|
||||
месяц для полного выбранного месяца, иначе — непосредственно предшествующий
|
||||
интервал той же включительной длительности. Оно не подменяет сравнение годом
|
||||
ранее. Незагруженное сравнение и ошибка его источника отличаются от
|
||||
недоступности годового сравнения по календарю или дате открытия счёта.
|
||||
|
||||
Каждый раздел сравнения показывает цветные панели без общей белой подложки и
|
||||
внутренних отступов у внешнего блока. Точные периоды показаны в заголовках двух панелей с русским форматом диапазона
|
||||
и UTC для календарных дат.
|
||||
Отдельного заголовка с датами и валютного бейджа нет; валюта остаётся у каждой суммы.
|
||||
Панель «Разница» сохраняет серверную абсолютную разницу и дополняет итог, купоны
|
||||
и дивиденды процентом: абсолютная разница / сумма годом ранее × 100.
|
||||
Это округлённый показатель для отображения, а не пересчёт Money или инвестиционная
|
||||
доходность. Форматирование сохраняет знак и не более одного десятичного разряда.
|
||||
При нулевой или отрицательной базе либо непредставимом числовом отношении
|
||||
процентный бейдж не отображается; абсолютная разница остаётся видимой.
|
||||
- Раздел «Выплаты» показывает единый список карточек выплат в исходном порядке `entries`: одна карточка на каждую выплату. Внешних групп по инструментам или валютам, итогов и количества выплат инструмента нет. Описание, дата, доступные идентификаторы инструмента и сумма со знаком видны в каждой карточке; валюты разделены в итогах. Дополнительный запрос за составом не нужен.
|
||||
|
||||
## Полнота и принадлежность выплат
|
||||
|
||||
Доходы читают сохранённые операции и coverage в согласованной транзакции.
|
||||
Selected, previous и yearAgo имеют независимую готовность. Неполный selected
|
||||
не получает окончательных итогов; неполное сравнение не создаёт нулевую базу.
|
||||
Только выбранный период определяет готовность результата. Неполный период
|
||||
не получает окончательных итогов.
|
||||
Подтверждённый пустой период отличается от ещё не загруженного. При смене
|
||||
периода прежний snapshot не показывается под новым названием.
|
||||
|
||||
@@ -103,11 +86,12 @@ Backend обеспечивает принадлежность выплат, ва
|
||||
|
||||
## Будущие события и ограничения
|
||||
|
||||
На странице дохода нет блоков «Динамика» и «Ближайший прогноз». Она не запрашивает
|
||||
На странице дохода нет блоков «Динамика» и «Ближайший прогноз», блоков
|
||||
сравнения периодов и сообщений об их недоступности. Она не запрашивает
|
||||
`/events` и не зависит от его доступности. Самостоятельная страница
|
||||
[«Будущие события»](upcoming-events.md) по-прежнему доступна из обзора
|
||||
выбранного счёта и сохраняет прежнее поведение. Будущие выплаты
|
||||
не включаются в итоги полученного дохода или сравнения.
|
||||
не включаются в итоги полученного дохода.
|
||||
|
||||
Аналитика читает сохранённую историю операций и не рассчитывает налоги, инвестиционную эффективность, доходность, валютную конвертацию или общий мультивалютный итог.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user