DIONYSUS in the TRINITY architecture
How ATHENA analysis, Firestore, DIONYSUS, IRIS, and ATLAS connect for portfolio optimization—without hype.
Data flows in one paragraph
ATHENA produces stage analysis, signals, SATA, Mansfield RS, and related fields. Those results land in TRINITY’s shared analysis store (the same records IRIS shows on symbol pages). DIONYSUS reads that store, ranks symbols, and allocates capital under your risk settings and constraint packs, then publishes a proposed book back through the platform so you see weights, sizes, and diagnostics in Optimize portfolio / TRINITY Optimized Portfolios. IRIS keeps you signed in and renders those proposals—you stay in the browser workflow rather than calling services directly.
Technical note (storage & callers)
Symbol analyses are stored in Firestore documents. DIONYSUS writes portfolios and positions aligned with ATLAS semantics. IRIS acts as the BFF: it authenticates users, calls DIONYSUS with service identity in production, and surfaces responses in the UI.
Why Firestore sits in the middle
Shared storage avoids slow per-symbol HTTP fan-out from the optimizer to ATHENA at optimize time. Batch reads keep latency manageable when thousands of symbols are in scope.
DIONYSUS vs ARTEMIS
| Concern | Typical owner |
|---|---|
| New-book optimization from analysis universe | DIONYSUS |
| Hunt / Cash Hunt, ongoing portfolio UX APIs | ARTEMIS |
Product direction may converge scoring over time (see internal integration notes); treat documentation + release notes as current truth when outputs differ.
Authentication in production (operators & integrators)
DIONYSUS on Cloud Run expects authenticated callers (e.g. IRIS with OIDC ID tokens). Do not expose optimization endpoints as anonymous public APIs.
CLIO / backtest provenance (optional)
When a CLIO config is present in the deployment environment, DIONYSUS may stamp config hash / run id on created portfolios for reproducibility of research workflows—consult ops docs if your workspace uses this.
Further reading
Progress is saved in this browser. Cloud sync requires PUBLIC_IRIS_API_BASE, IRIS CORS allowlist,
and window.__trinityIdToken.