69 lines
5.5 KiB
Markdown
69 lines
5.5 KiB
Markdown
## Why
|
|
|
|
После нескольких итераций вокруг счетов, Portfolio, операций и будущих
|
|
денежных событий в модели появились близкие, но не полностью согласованные
|
|
формулировки. Одни документы говорят о принадлежности Brokerage Account User,
|
|
другие — о доступности счёта через текущее подключение брокера. Денежные
|
|
значения в части потоков описаны как единый Money, а в будущих событиях
|
|
разделены на сумму и валюту. Валютная позиция инструмента и Cash Balance также
|
|
легко смешиваются в чтении, хотя в поведении системы они имеют разные роли.
|
|
|
|
Эти расхождения уже затрагивают публичное понимание продукта: разработчик,
|
|
агент или downstream consumer может по-разному интерпретировать доступность
|
|
счёта, свежесть Portfolio, денежные прогнозы и связь Instrument с событиями.
|
|
Исправить это стоит сейчас, пока область T-Bank-инвестиций ещё компактна и до
|
|
следующих расширений по операциям, прогнозам и аналитике.
|
|
|
|
## What Changes
|
|
|
|
- Согласовать канонический язык вокруг Brokerage Account: система описывает
|
|
счёт как доступный User через его текущее подключение брокера, не как
|
|
долговременно принадлежащий User объект внутри WealthLedger.
|
|
- Согласовать денежные значения во всех инвестиционных read-моделях вокруг
|
|
единого Money-представления с явной валютой и отсутствующим значением как
|
|
неизвестностью, а не нулём.
|
|
- Уточнить различие между Currency Instrument Position и Cash Balance: первая
|
|
является позицией по торгуемому инструменту, вторая — денежным остатком на
|
|
счёте.
|
|
- Сделать язык Portfolio Snapshot явным там, где речь идёт о результате
|
|
наблюдения Portfolio на конкретный момент с признаком свежести.
|
|
- Расширить доменный смысл Instrument так, чтобы он охватывал не только
|
|
Portfolio Position, но и связанные события по инструменту.
|
|
- Структурировать domain glossary так, чтобы доменные термины не смешивались с
|
|
runtime/cache-механизмами, сохранив последние как технические ограничения
|
|
текущего поведения.
|
|
- **Non-goals:** не менять физическую модульную структуру приложения, не
|
|
вводить новое долговременное хранение Portfolio, событий или счетов, не
|
|
переименовывать массово существующие пользовательские маршруты и не менять
|
|
брокерскую интеграцию сверх необходимого согласования observable contract.
|
|
|
|
## Capabilities
|
|
|
|
### New Capabilities
|
|
|
|
_Нет._
|
|
|
|
### Modified Capabilities
|
|
|
|
- `brokerage-accounts`: требования к счетам должны использовать единый язык
|
|
доступности через текущее подключение брокера и не создавать ложное
|
|
ожидание долговременного владения счётом внутри WealthLedger.
|
|
- `portfolio-view`: требования к Portfolio должны явно различать Portfolio
|
|
Snapshot, Cash Balance и позиции по валютным инструментам, а также
|
|
согласованно описывать Money и Instrument.
|
|
- `brokerage-account-upcoming-events`: требования к будущим событиям должны
|
|
использовать тот же язык доступности счёта, Money и Instrument, что и
|
|
Portfolio.
|
|
- `project-documentation`: glossary и durable documentation должны закрепить
|
|
единый доменный язык и отделить его от runtime/cache терминов.
|
|
|
|
## Impact
|
|
|
|
Затрагиваются пользователи и разработчики, которые читают инвестиционные
|
|
экраны, API contract, OpenSpec requirements и as-built документацию по
|
|
T-Bank-счетам, Portfolio и будущим денежным событиям. Изменение является
|
|
контрактным для финансовых read-моделей и потребует синхронного обновления
|
|
SDD, backend contract, frontend consumer types, пользовательских состояний и
|
|
документации. Долговременная модель хранения User, Session и T-Bank connection
|
|
не расширяется.
|