Files
specs/openspec/changes/archive/2026-10-14-unify-income-payment-cards/proposal.md
T
ksv741 6efb989ed9
Conventional commits / commits (pull_request) Successful in 13s
Specs security / security (pull_request) Successful in 8s
Specs verify / verify (pull_request) Successful in 12s
spec: archive three completed changes (main#33, frontend#63, screener)
2026-10-14 21:40:26 +03:00

7.1 KiB

Proposal

Why

Сравнения с предыдущим периодом и годом ранее не помогают пользователю решить основную задачу страницы «Пассивный доход»: увидеть фактически полученные купоны и дивиденды за выбранный период. Они усложняют экран и требуют получения данных за дополнительные периоды. Купоны и дивиденды в истории операций, прогнозах и календарях инструментов представлены разными карточками; сходный вид при этом не обеспечивает единого представления выплаты и ясной границы между полученными деньгами и ожидаемым событием.

What Changes

  • BREAKING: сравнения дохода с предыдущим периодом и годом ранее перестают рассчитываться, загружаться и предоставляться потребителям аналитики.
  • Страница «Пассивный доход» показывает выбранный период, итоги по исходным валютам и все включённые исполненные выплаты без блоков сравнений и их состояний.
  • Купоны и дивиденды во всех существующих местах показа выплат используют одно предметное представление. Оно явно различает исполненную выплату, прогноз и запись графика инструмента, сохраняя смысл дат и денежных величин.

Scope

In Scope

  • Аналитика дохода одного счёта и режима «Все счета»: удаление сравнения периодов из результата и связанных чтений, при сохранении дохода выбранного периода и самостоятельной сводки текущего месяца.
  • Карточки купонов и дивидендов в доходе, журнале и недавних операциях, личной истории инструмента, полном списке и превью будущих событий, календарях и истории выплат акций и облигаций.
  • Обновление нормативного поведения и согласование изменённого публичного контракта с потребителями.

Out of Scope / Non-Goals

  • Возврат графика динамики либо прогноза на страницу дохода; удаление иных исторических данных аналитики, не относящихся к сравнению периодов.
  • Изменение отбора исполненных операций, расчёта итогов, налоговой трактовки, прогноза или правил происхождения календарных событий.
  • Унификация карточек сделок, налогов, комиссий, погашений и оферт.

Capabilities

New Capabilities

  • specs/instrument-income-schedules/spec.md — различимое представление будущих и прошедших событий графиков выплат акций и облигаций, не выдаваемых за подтверждённое личное зачисление.

Modified Capabilities

  • specs/brokerage-account-income-analytics/spec.md — результат без сравнений и единое представление исполненных выплат.
  • specs/brokerage-account-ledger/spec.md — то же представление купонов и дивидендов в полном журнале, недавних операциях и истории инструмента.
  • specs/brokerage-account-upcoming-events/spec.md — то же представление прогнозных купонов и дивидендов на странице событий и в превью.

Impact

Пользователь видит более короткую страницу дохода и узнаваемую карточку купона или дивиденда на смежных экранах. Аналитика прекращает запрос дополнительных периодов для сравнения, меняется публичный ответ и его потребители. Исполненные операции, будущие события и графики инструментов сохраняют разные источники и статус достоверности. Затронуты поведение интерфейса, инвестиционная аналитика, публикация контракта и документация дохода и событий.

Success Criteria

  • На странице дохода нет сравнений и сообщений об их недоступности; выбранный период, итоги, налоговое пояснение и отдельная карточка каждой фактической выплаты доступны как прежде.
  • Чтение и синхронизация дохода не требуют периодов сравнения, а ответ аналитики их не предоставляет. Полнота выбранного периода и итоги сохраняются.
  • Купон и дивиденд на перечисленных экранах представлены одним предметным компонентом; полученная сумма имеет исходный знак и валюту, прогноз может не иметь суммы, а календарное событие не называется полученным доходом.
  • Остальные типы операций и будущих событий не теряют своего представления.

Assumptions / Dependencies

  • Изменение публичного ответа согласуется с его потребителями при поставке; удаление сравнений намеренно несовместимо с прежней формой ответа.
  • Одна карточка может показывать данные разной природы без ложного обещания зачисления: исполненная операция, прогноз и график остаются различимыми.
  • Планирование и реализация связаны с координирующей Issue WealthLedger/main#33.