80 lines
9.2 KiB
Markdown
80 lines
9.2 KiB
Markdown
# Proposal
|
||
|
||
Issue: WealthLedger/main#47
|
||
|
||
## Why
|
||
|
||
В режиме «Все счета» события и операции показываются плоским списком: одна строка — одна запись одного счёта. Одна и та же бумага часто есть сразу на брокерском счёте и на ИИС. В этом случае выплаты по ней в один день разбросаны по отдельным строкам, и пользователю приходится самому связывать их и сравнивать суммы по счетам.
|
||
|
||
## What Changes
|
||
|
||
- В режиме «Все счета» записи с одним днём, одним Instrument и одним точным типом события или операции объединяются в одну визуальную группу.
|
||
- В заголовке группы — бумага, тип и итог. Итог — точная сумма записей группы, отдельно по каждой валюте и со знаком. Под заголовком всегда раскрыта разбивка: каждая запись остаётся отдельной строкой со своим счётом и суммой (например, «Брокерский — 200 ₽», «ИИС — 100 ₽»).
|
||
- Группировка применяется к предстоящим событиям и к исполненным операциям любой категории, если у записи есть identity Instrument.
|
||
- Группа образуется из двух и более записей с одинаковым ключом, даже если все они относятся к одному счёту.
|
||
- Группа стоит на месте своей первой записи в серверном порядке. Записи внутри группы и остальные строки сохраняют относительный серверный порядок.
|
||
- Режим одного счёта, записи без Instrument и одиночные записи не меняются.
|
||
- В нормативные specs журнала и аналитики дохода возвращается уже существующий режим «Все счета». Он был утрачен при синхронизации canonical specs; поведение при этом не меняется.
|
||
- Для «Выплат» в режиме «Все счета» вводится исключение из действующих запретов: группировочные карточки по Instrument и вычисление итога группы на клиенте разрешены. Аналитические итоги дохода по-прежнему приходят с сервера и не пересчитываются.
|
||
|
||
## Scope
|
||
|
||
### In Scope
|
||
|
||
- Страница предстоящих событий в режиме «Все счета».
|
||
- Страница журнала операций в режиме «Все счета».
|
||
- Превью ближайших событий и последних операций на обзоре в режиме «Все счета». Лимит считается по записям, как сейчас.
|
||
- Раздел «Выплаты» на странице доходов в режиме «Все счета».
|
||
- Восстановление в canonical specs журнала и дохода нормативного описания режима «Все счета» в его текущем поведении.
|
||
|
||
### Out of Scope / Non-Goals
|
||
|
||
- Режим одного счёта.
|
||
- Группировка за пределами одного дня, по эмитенту или между разными типами: покупка ≠ продажа, купон ≠ налог с купона, налог с купона ≠ налог с дивиденда.
|
||
- Изменение состава, фильтрации, серверного порядка, пагинации, лимитов превью или денежных значений, которые возвращает сервер.
|
||
- Записи без identity Instrument.
|
||
- Сворачивание групп и пометка, что группа может быть неполной.
|
||
- Аналитические итоги дохода и их пересчёт.
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
|
||
Нет.
|
||
|
||
### Modified Capabilities
|
||
|
||
- `specs/brokerage-account-upcoming-events/spec.md`: представление событий (страница и превью) в режиме «Все счета».
|
||
- `specs/brokerage-account-ledger/spec.md`: восстановление режима «Все счета», представление журнала и превью операций в этом режиме.
|
||
- `specs/brokerage-account-income-analytics/spec.md`: восстановление режима «Все счета», раздел «Выплаты» в этом режиме с исключением из запретов на группировку и клиентский итог.
|
||
|
||
## Impact
|
||
|
||
- Пользователи с несколькими счетами, которые смотрят режим «Все счета».
|
||
- Меняется только представление уже полученных данных. Источники данных, серверные ответы и интеграция с T-Bank остаются прежними.
|
||
- Вероятно затрагиваются клиентское представление списков и AS-IS документация экранов.
|
||
|
||
## Success Criteria
|
||
|
||
- Купоны по одной облигации за один день (200 ₽ на брокерском счёте и 100 ₽ на ИИС) в режиме «Все счета» видны одной группой с итогом 300 ₽ и отдельной строкой для каждого счёта.
|
||
- Записи разных типов или дней по одной бумаге не объединяются.
|
||
- Итог группы точен, показывается отдельно по каждой валюте и учитывает знак записей.
|
||
- В режиме одного счёта и для записей без Instrument списки выглядят как раньше.
|
||
|
||
## Evidence
|
||
|
||
- [F] В режиме «Все счета» страницы событий, операций, превью обзора и «Выплаты» показывают плоский список, по строке на запись, со счётом в каждой строке. Группировки по Instrument нет. Источник: AS-IS frontend, разбор кода 2026-10-29.
|
||
- [F] Canonical `brokerage-account-income-analytics` («Income payments remain traceable to exact Ledger Entries») запрещает группировочные карточки и subtotals по Instrument в «Выплатах» и пересчёт денежных итогов на frontend. Источник: canonical spec, archive `2026-10-14-unify-income-payment-cards`.
|
||
- [F] Режим «Все счета» для журнала и дохода описан в delta specs archive `2026-10-09-persist-tbank-data`, но отсутствует в текущих canonical specs `brokerage-account-ledger` и `brokerage-account-income-analytics`. В `brokerage-account-upcoming-events` он есть. Источник: specs store, G1 review 2026-10-29.
|
||
- [F] Потребность: одна облигация на брокерском счёте и ИИС, выплаты по ней в один день нужно видеть рядом с суммой по каждому счёту. Источник: запрос Change Owner, WealthLedger/main#47.
|
||
- [H] Сервер в режиме «Все счета» уже возвращает для каждой записи счёт, дату, тип, identity Instrument и точную сумму. Подтверждается в Design.
|
||
|
||
## Assumptions / Dependencies
|
||
|
||
- День записи берётся тот же, что строка уже показывает на этом экране. Часовой пояс отображения не меняется.
|
||
- Группа собирается только из записей, показанных на текущей странице журнала или в превью. При переходе на другую страницу группы собираются заново из её записей, поэтому группа на границе страницы может быть неполной.
|
||
|
||
## Open Decisions
|
||
|
||
Нет. Change Owner принял в текущей сессии: ключ (день как на экране, identity Instrument, точный тип), клиентский итог по валютам, позиция группы на месте первой записи, лимит превью по записям, неполная группа без пометки, строка на каждую запись, восстановление режима «Все счета» в этом change.
|