# clement-bbier/apex architecture

> Architecture diagram of the GitHub repository clement-bbier/apex, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/clement-bbier/apex
- Repository: https://github.com/clement-bbier/apex

## Overview

APEX is an autonomous quantitative trading system. Its principal workflow takes market data through signal generation, regime assessment, fusion, risk approval, and execution; analytics, macro context, feedback, and monitoring support that trading loop. The README documents the service sequence, while the source index confirms several internal service dependencies and shared infrastructure. The graph also preserves the documented backtesting capability. Some service internals and cross-service transport details were not sampled, so edges show only documented relationships rather than inferred call chains.

Main entry points: [`services/fusion_engine/service.py`](https://github.com/clement-bbier/apex/blob/main/services/fusion_engine/service.py) (Fusion engine), [`services/data_ingestion`](https://github.com/clement-bbier/apex/tree/main/services/data_ingestion) (Data ingestion), [`services/signal_engine/pipeline.py`](https://github.com/clement-bbier/apex/blob/main/services/signal_engine/pipeline.py) (Signal engine), [`services/risk_manager/service.py`](https://github.com/clement-bbier/apex/blob/main/services/risk_manager/service.py) (Risk manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_market_data["Market data"]
  node_ingestion["Data ingestion"]
  node_data_store[("Timescale data")]
  node_panels["Data panels<br/>[service.py]"]
end

subgraph group_trading["Trading workflow"]
  node_signals["Signal engine<br/>[pipeline.py]"]
  node_regime["Regime detector<br/>[regime_engine.py]"]
  node_strategies["Strategies"]
  node_fusion["Fusion engine<br/>[service.py]"]
  node_portfolio["Strategy allocator<br/>[service.py]"]
  node_risk["Risk manager<br/>[service.py]"]
  node_execution["Execution<br/>[order_manager.py]"]
end

subgraph group_support["Research and analytics"]
  node_analytics["Quant analytics<br/>[service.py]"]
  node_macro["Macro intelligence<br/>[service.py]"]
  node_feedback["Trade feedback<br/>[service.py]"]
end

subgraph group_platform["Platform and operations"]
  node_console["Operator console<br/>[app.py]"]
  node_bus_state["Messaging and state<br/>[base_service.py]"]
  node_monitoring["Monitoring<br/>[alert_engine.py]"]
end

subgraph group_simulation["Backtesting"]
  node_backtesting["Backtesting<br/>[engine.py]"]
  node_results["Backtest reports<br/>[report.py]"]
end

node_operator(("Operator"))
node_market_sources(("Market sources"))

node_market_sources -.->|"provide data"| node_ingestion
node_ingestion -->|"feeds workflow"| node_signals
node_ingestion -.->|"persists data"| node_data_store
node_data_store -.->|"supplies data"| node_panels
node_signals -->|"precedes"| node_regime
node_regime -->|"precedes"| node_fusion
node_strategies -.->|"feeds workflow"| node_fusion
node_fusion -->|"precedes"| node_risk
node_portfolio -.->|"supports allocation"| node_risk
node_risk -->|"precedes"| node_execution
node_analytics -->|"supports workflow"| node_fusion
node_macro -->|"supports workflow"| node_fusion
node_execution -->|"feeds feedback"| node_feedback
node_operator -->|"operates"| node_console
node_console -.->|"views operations"| node_monitoring
node_signals -.->|"uses shared services"| node_bus_state
node_operator -->|"runs backtests"| node_backtesting
node_backtesting -.->|"produces reports"| node_results

click node_ingestion "https://github.com/clement-bbier/apex/tree/main/services/data_ingestion"
click node_data_store "https://github.com/clement-bbier/apex/blob/main/core/data/timescale_repository.py"
click node_panels "https://github.com/clement-bbier/apex/blob/main/services/data/panels/service.py"
click node_signals "https://github.com/clement-bbier/apex/blob/main/services/signal_engine/pipeline.py"
click node_regime "https://github.com/clement-bbier/apex/blob/main/services/regime_detector/regime_engine.py"
click node_strategies "https://github.com/clement-bbier/apex/tree/main/services/strategies"
click node_fusion "https://github.com/clement-bbier/apex/blob/main/services/fusion_engine/service.py"
click node_portfolio "https://github.com/clement-bbier/apex/blob/main/services/portfolio/strategy_allocator/service.py"
click node_risk "https://github.com/clement-bbier/apex/blob/main/services/risk_manager/service.py"
click node_execution "https://github.com/clement-bbier/apex/blob/main/services/execution/order_manager.py"
click node_analytics "https://github.com/clement-bbier/apex/blob/main/services/quant_analytics/service.py"
click node_macro "https://github.com/clement-bbier/apex/blob/main/services/macro_intelligence/service.py"
click node_feedback "https://github.com/clement-bbier/apex/blob/main/services/feedback_loop/service.py"
click node_backtesting "https://github.com/clement-bbier/apex/blob/main/backtesting/engine.py"
click node_console "https://github.com/clement-bbier/apex/blob/main/services/command_center/console/app.py"
click node_bus_state "https://github.com/clement-bbier/apex/blob/main/core/base_service.py"
click node_monitoring "https://github.com/clement-bbier/apex/blob/main/services/command_center/alert_engine.py"
click node_results "https://github.com/clement-bbier/apex/blob/main/backtesting/metrics/report.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_ingestion,node_data_store,node_panels toneBlue
class node_signals,node_regime,node_strategies,node_fusion,node_portfolio,node_risk,node_execution toneAmber
class node_analytics,node_macro,node_feedback toneMint
class node_console,node_bus_state,node_monitoring toneRose
class node_backtesting,node_results,node_operator,node_market_sources toneIndigo
```

## Components

### Market data

- [Data ingestion](https://github.com/clement-bbier/apex/tree/main/services/data_ingestion): `services/data_ingestion`
- [Timescale data](https://github.com/clement-bbier/apex/blob/main/core/data/timescale_repository.py): `core/data/timescale_repository.py`
- [Data panels](https://github.com/clement-bbier/apex/blob/main/services/data/panels/service.py): `services/data/panels/service.py`

### Trading workflow

- [Signal engine](https://github.com/clement-bbier/apex/blob/main/services/signal_engine/pipeline.py): `services/signal_engine/pipeline.py`
- [Regime detector](https://github.com/clement-bbier/apex/blob/main/services/regime_detector/regime_engine.py): `services/regime_detector/regime_engine.py`
- [Strategies](https://github.com/clement-bbier/apex/tree/main/services/strategies): `services/strategies`
- [Fusion engine](https://github.com/clement-bbier/apex/blob/main/services/fusion_engine/service.py): `services/fusion_engine/service.py`
- [Strategy allocator](https://github.com/clement-bbier/apex/blob/main/services/portfolio/strategy_allocator/service.py): `services/portfolio/strategy_allocator/service.py`
- [Risk manager](https://github.com/clement-bbier/apex/blob/main/services/risk_manager/service.py): `services/risk_manager/service.py`
- [Execution](https://github.com/clement-bbier/apex/blob/main/services/execution/order_manager.py): `services/execution/order_manager.py`

### Research and analytics

- [Quant analytics](https://github.com/clement-bbier/apex/blob/main/services/quant_analytics/service.py): `services/quant_analytics/service.py`
- [Macro intelligence](https://github.com/clement-bbier/apex/blob/main/services/macro_intelligence/service.py): `services/macro_intelligence/service.py`
- [Trade feedback](https://github.com/clement-bbier/apex/blob/main/services/feedback_loop/service.py): `services/feedback_loop/service.py`

### Platform and operations

- [Operator console](https://github.com/clement-bbier/apex/blob/main/services/command_center/console/app.py): `services/command_center/console/app.py`
- [Messaging and state](https://github.com/clement-bbier/apex/blob/main/core/base_service.py): `core/base_service.py`
- [Monitoring](https://github.com/clement-bbier/apex/blob/main/services/command_center/alert_engine.py): `services/command_center/alert_engine.py`

### Backtesting

- [Backtesting](https://github.com/clement-bbier/apex/blob/main/backtesting/engine.py): `backtesting/engine.py`
- [Backtest reports](https://github.com/clement-bbier/apex/blob/main/backtesting/metrics/report.py): `backtesting/metrics/report.py`

### Other components

- **Operator**
- **Market sources**

## Connections

- Market sources → Data ingestion: provide data
- Data ingestion → Signal engine: feeds workflow (evidence: `README.md`)
- Data ingestion → Timescale data: persists data (evidence: `services/data_ingestion/serving/app.py`)
- Timescale data → Data panels: supplies data
- Signal engine → Regime detector: precedes (evidence: `README.md`)
- Regime detector → Fusion engine: precedes (evidence: `README.md`)
- Strategies → Fusion engine: feeds workflow
- Fusion engine → Risk manager: precedes (evidence: `README.md`)
- Strategy allocator → Risk manager: supports allocation
- Risk manager → Execution: precedes (evidence: `README.md`)
- Quant analytics → Fusion engine: supports workflow (evidence: `README.md`)
- Macro intelligence → Fusion engine: supports workflow (evidence: `README.md`)
- Execution → Trade feedback: feeds feedback (evidence: `README.md`)
- Operator → Operator console: operates (evidence: `README.md`)
- Operator console → Monitoring: views operations
- Signal engine → Messaging and state: uses shared services
- Operator → Backtesting: runs backtests (evidence: `README.md`)
- Backtesting → Backtest reports: produces reports
