Vol Dashboard Diagrams
This folder documents the current Vol Dashboard data flows using Mermaid diagrams. The diagrams distinguish live Amberdata pass-through data, persisted snapshot analytics, Alpha trade-feed ingestion, and operator/admin paths.
The visible dashboard navigation groups those screens as Model, Market Setup, Measurement, and compact Reference help. The diagrams still use route names where useful, but labels should reflect current operator-facing names such as Model Explorer, Trade Book, and Reference.
Diagrams
| Diagram | Description |
|---|---|
| Runtime Trust Boundaries | Shows the deployed services, external systems, secrets, and browser trust boundaries. |
| Live Market Data Flow | Documents how live Amberdata data moves through the backend into dashboard screens. |
| Persisted Snapshot Analytics Flow | Shows how scheduled/manual snapshots populate Postgres tables and historical analytics. |
| Alpha Trade Feed Sync | Documents the live Alpha trade-feed ingestion path into internal_trades. |
| Trade Feed Sync Diagnostic Modes | Explains incremental delta vs full-scope sync diagnostic behavior; this is an ingestion/cache completeness check, not accounting reconciliation. |
| Screen To Data Source Map | Maps each major UI screen to its underlying source systems and stores. |
| Probability And Regime Calculation Flow | Shows how IV surface, spot, and gamma history feed probability calculations. |
| Probability Maths Flowchart | Provides a maths-first Mermaid flowchart and formulas for vanilla density, GEX conditioning, stationarity, touch probabilities, and candidate ranking. |
| Model Lab Scenario Flow | Shows how request-scoped scenario inputs compare production defaults against tuned probability-model parameters. |
| Model Diagnostics And Alerts Flow | Documents gamma, spot-vol, regime stationarity, alert generation, and Slack dispatch. |
| Trade Book Analytics Boundary | Shows the Alpha-synced trade-row workflow, current Performance analytics, and unsourced execution/outcome boundaries. |
| Data Accuracy Control Points | Summarizes validation, normalization, storage, and sync diagnostics used to protect numeric accuracy. |
Notes
- Cloud Run is the only deployment target for this project.
- Alpha trade sync is currently operator-triggered, not streaming.
- Full-scope diagnostics are the guardrail for confirming the selected Alpha feed scope is loaded before Performance interpretation.
- Performance currently scores opportunity alignment from Alpha trade-time context. Execution quality, forward outcome P&L, smile context, and realized P&L remain intentionally blank until trustworthy source inputs exist.