30 lines
1.9 KiB
Markdown
30 lines
1.9 KiB
Markdown
# Proposal
|
|
|
|
## Why
|
|
|
|
The owner cannot assess Evelyn's committed capital and risk from direction and size alone. Issue #100 adds a first inspectable, read-only valuation overview for existing wallets, directly supporting safe Evelyn operation.
|
|
|
|
## What Changes
|
|
|
|
- Show Position, Direction, Margin, Collateral, Leverage, Exposure, Value and uPnL beneath a visible Perpetual Contracts root.
|
|
- **BREAKING**: Extend snapshot and Phoenix result record contracts to represent shared Cross accounts separately from isolated positions, retaining funded empty Cross accounts.
|
|
- Publish precise venue valuations and complete gross exposure, dollar uPnL and closing-value totals without counting shared capital twice. Unsupported metrics remain explicitly unavailable.
|
|
- Add an overview-only Jupiter REST reader; preserve the existing trading, signing, alarm and entry-price integration.
|
|
- Preserve background refresh timing, independent last-success retention, immutable snapshots and stable UI reconciliation; explain retained or incomplete data.
|
|
|
|
## Capabilities
|
|
|
|
### New Capabilities
|
|
|
|
- `jupiter-perps-overview`: Validated read-only Jupiter position metrics, independent of transaction operations.
|
|
|
|
### Modified Capabilities
|
|
|
|
- `evelyn-perps-service`: Account-aware immutable metrics and complete, field-specific aggregation with independent refresh status.
|
|
- `evelyn-perps-overview`: Eight columns, Cross hierarchy, totals, formatting and definitions.
|
|
- `phoenix-perps-service`: Shared balances, exact price PnL, initial margin and account closing-value estimates.
|
|
|
|
## Impact
|
|
|
|
Changes are limited to `.tjava` integration/service/presentation code, passive Hub wiring, OpenSpec and applicable project/shared documentation. No new dependencies, configuration system, trading operations, live Hub restart, commits or pushes. Verification uses the normal build and temporary focused/read-only JavaFX harnesses.
|