101: EMC Perps - show Phoenix TWAP progress and time until next suborder

2026-10-24 19:30:20 +02:00
parent 28640f3203
commit 2f30712004
21 changed files with 712 additions and 32 deletions
@@ -7,11 +7,11 @@ Let the owner inspect Evelyn perpetual positions grouped by wallet and venue in
 ## Requirements

 ### Requirement: Perps overview displays a collapsible position hierarchy
-The Perps tab SHALL display Position, Direction, Margin, Collateral, Leverage, Exposure, Value and uPnL in that order beneath the visible Perpetual Contracts root. Isolated hierarchy SHALL be wallet → venue → position; each Phoenix Cross account SHALL add a Cross group above its positions. Groups SHALL show applicable totals, leave direction/aggregate ratios blank, and be expanded by default.
+The Perps tab SHALL display Position, Direction, Margin, Collateral, Leverage, Exposure, Value, uPnL and TWAP in that order beneath the visible Perpetual Contracts root. Isolated hierarchy SHALL be wallet → venue → position; each Phoenix Cross account SHALL add a Cross group above its positions. Groups SHALL show applicable totals, leave direction/aggregate ratios and TWAP blank, and be expanded by default.

 #### Scenario: Open either environment's Perps tab
 - **WHEN** the owner opens Perps in Production or Test
- **THEN** all eight columns, root totals and the account-aware hierarchy are visible
+- **THEN** all nine columns, root totals and the account-aware hierarchy are available, with horizontal scrolling where required

 #### Scenario: Collapse and expand groups
 - **WHEN** the owner collapses and expands a wallet, venue or Cross account
@@ -89,3 +89,21 @@ EMC SHALL hide venue rows with neither positions nor Cross accounts and show the
 - **WHEN** a childless venue has never been read successfully and its first read is pending or failed
 - **THEN** the heading is hidden and its read status is available on the wallet tooltip
 - **AND** required totals remain unavailable rather than reporting zero
+
+### Requirement: TWAP cells show execution progress and snapshot duration
+Matching filled Phoenix TWAPs SHALL show a progressbar using executed/total child counts and an overlaid estimated duration to the next child in unbounded hours, minutes and seconds. Other cells SHALL be empty. Updates SHALL follow existing snapshots without a live timer. Failed retained observations SHALL be labeled retained; due or unknown schedules SHALL not show negative or wrapped times or imply execution.
+
+#### Scenario: Long interval
+- **WHEN** the snapshot's estimated wait is 28 hours 32 minutes 10 seconds, or 128 hours 32 minutes 10 seconds
+- **THEN** the text is approximately 28:32:10 or 128:32:10 respectively
+
+#### Scenario: Failed or due observation
+- **WHEN** the venue read fails or the latest observed next slot is already due
+- **THEN** the cell communicates retained or awaiting-update status without advancing progress
+
+### Requirement: TWAP tooltip distinguishes estimates from fills
+TWAP tooltips SHALL show executed/total progress, Estimated completion, total size, next child size, filled quantity and observation time. Sizes SHALL include their symbol and approximate USD values from Phoenix mark prices where available. Distinct regular/dust sizes and periodic nominal-slot timing assumptions SHALL be explained. Unknown values SHALL remain unknown; expiry SHALL never be presented as completion.
+
+#### Scenario: Missing price or smaller next child
+- **WHEN** the mark price is unavailable or the next child is a smaller rest order
+- **THEN** token amounts remain visible with unknown USD values, or the next size reflects that rest order respectively