# chizy7/pinnaclemm architecture

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

- Interactive diagram: https://gitdiagram.com/chizy7/pinnaclemm
- Repository: https://github.com/chizy7/pinnaclemm

## Overview

PinnacleMM is a C++ market-making and trading system. The main workflow is to start a configured trading mode, obtain market data from a live venue or simulator, maintain an order book, run a strategy, apply risk controls, and route orders for execution. Separate branches provide historical backtesting, cross-venue arbitrage, persistence and recovery, and observability. Relationships are shown only where supported by the supplied README or source-index/excerpt references; some internal strategy and routing links are therefore omitted.

Main entry points: [`main.cpp`](https://github.com/chizy7/pinnaclemm/blob/main/main.cpp) (Runtime Entry), [`strategies/basic/MLEnhancedMarketMaker.cpp`](https://github.com/chizy7/pinnaclemm/blob/main/strategies/basic/MLEnhancedMarketMaker.cpp) (ML-Enhanced Strategy), [`core/orderbook/OrderBook.cpp`](https://github.com/chizy7/pinnaclemm/blob/main/core/orderbook/OrderBook.cpp) (Order Book), [`core/instrument/InstrumentManager.cpp`](https://github.com/chizy7/pinnaclemm/blob/main/core/instrument/InstrumentManager.cpp) (Instrument Lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Trading Runtime"]
  node_main["Runtime Entry<br/>[main.cpp]"]
  node_instruments["Instrument Lifecycle"]
  node_orders["Order Model<br/>[Order.cpp]"]
  node_book["Order Book<br/>[OrderBook.cpp]"]
  node_router["Order Router<br/>[OrderRouter.cpp]"]
end

subgraph group_venues["Market Connectivity"]
  node_feeds["Live Market Feed"]
  node_connectors["Venue Connectors"]
  node_fix["FIX Connectivity<br/>[FixConnector.cpp]"]
  node_simulator["Exchange Simulator"]
end

subgraph group_strategy["Strategies And Research"]
  node_maker["Market-Making Strategy"]
  node_mlmaker["ML-Enhanced Strategy"]
  node_analytics["Market Analytics"]
  node_regime["Regime Detection"]
  node_optimizer["Spread Optimization"]
  node_rl["RL Adaptation"]
  node_arb["Arbitrage Detection"]
  node_backtest["Backtesting<br/>[BacktestEngine.cpp]"]
end

subgraph group_safety["Risk And Recovery"]
  node_risk["Pre-Trade Risk<br/>[RiskManager.cpp]"]
  node_var["VaR Engine<br/>[VaREngine.cpp]"]
  node_breaker["Circuit Breaker<br/>[CircuitBreaker.cpp]"]
  node_alerts["Risk Alerts<br/>[AlertManager.cpp]"]
  node_persistence[("Persistence Manager")]
  node_snapshots[("Snapshot Recovery")]
end

subgraph group_ops["Monitoring"]
  node_audit["Audit Logging<br/>[AuditLogger.cpp]"]
  node_dashboard["Web Dashboard<br/>[WebServer.cpp]"]
end

node_user(("Operator"))

node_user -->|"starts mode"| node_main
node_main -->|"manages instruments"| node_instruments
node_main -->|"initializes"| node_persistence
node_main -->|"initializes"| node_risk
node_instruments -->|"manages strategy"| node_maker
node_instruments -->|"manages book"| node_book
node_instruments -->|"manages simulator"| node_simulator
node_feeds -.->|"provides market data"| node_book
node_simulator -->|"uses order book"| node_book
node_maker -.->|"uses market state"| node_book
node_mlmaker -.->|"uses predictions"| node_analytics
node_mlmaker -.->|"uses regimes"| node_regime
node_mlmaker -.->|"optimizes spreads"| node_optimizer
node_mlmaker -.->|"adapts parameters"| node_rl
node_router -->|"routes orders"| node_connectors
node_router -->|"routes orders"| node_fix
node_book -->|"journals state"| node_persistence
node_persistence -->|"manages snapshots"| node_snapshots
node_main -->|"selects backtest mode"| node_backtest
node_backtest -->|"can run strategy"| node_mlmaker
node_main -.->|"offers arbitrage capability"| node_arb
node_risk -.->|"applies risk controls"| node_breaker
node_risk -.->|"assesses exposure"| node_var
node_risk -.->|"raises alerts"| node_alerts
node_main -->|"initializes audit"| node_audit
node_user -.->|"views monitoring"| node_dashboard

click node_main "https://github.com/chizy7/pinnaclemm/blob/main/main.cpp"
click node_instruments "https://github.com/chizy7/pinnaclemm/blob/main/core/instrument/InstrumentManager.cpp"
click node_orders "https://github.com/chizy7/pinnaclemm/blob/main/core/orderbook/Order.cpp"
click node_book "https://github.com/chizy7/pinnaclemm/blob/main/core/orderbook/OrderBook.cpp"
click node_router "https://github.com/chizy7/pinnaclemm/blob/main/core/routing/OrderRouter.cpp"
click node_feeds "https://github.com/chizy7/pinnaclemm/blob/main/exchange/connector/WebSocketMarketDataFeed.cpp"
click node_connectors "https://github.com/chizy7/pinnaclemm/blob/main/exchange/connector/ExchangeConnectorFactory.cpp"
click node_fix "https://github.com/chizy7/pinnaclemm/blob/main/exchange/fix/FixConnector.cpp"
click node_simulator "https://github.com/chizy7/pinnaclemm/blob/main/exchange/simulator/ExchangeSimulator.cpp"
click node_maker "https://github.com/chizy7/pinnaclemm/blob/main/strategies/basic/BasicMarketMaker.cpp"
click node_mlmaker "https://github.com/chizy7/pinnaclemm/blob/main/strategies/basic/MLEnhancedMarketMaker.cpp"
click node_analytics "https://github.com/chizy7/pinnaclemm/blob/main/strategies/analytics/MarketImpactPredictor.cpp"
click node_regime "https://github.com/chizy7/pinnaclemm/blob/main/strategies/analytics/MarketRegimeDetector.cpp"
click node_optimizer "https://github.com/chizy7/pinnaclemm/blob/main/strategies/ml/MLSpreadOptimizer.cpp"
click node_rl "https://github.com/chizy7/pinnaclemm/blob/main/strategies/rl/RLParameterAdapter.cpp"
click node_arb "https://github.com/chizy7/pinnaclemm/blob/main/strategies/arbitrage/ArbitrageDetector.cpp"
click node_backtest "https://github.com/chizy7/pinnaclemm/blob/main/strategies/backtesting/BacktestEngine.cpp"
click node_risk "https://github.com/chizy7/pinnaclemm/blob/main/core/risk/RiskManager.cpp"
click node_var "https://github.com/chizy7/pinnaclemm/blob/main/core/risk/VaREngine.cpp"
click node_breaker "https://github.com/chizy7/pinnaclemm/blob/main/core/risk/CircuitBreaker.cpp"
click node_alerts "https://github.com/chizy7/pinnaclemm/blob/main/core/risk/AlertManager.cpp"
click node_persistence "https://github.com/chizy7/pinnaclemm/blob/main/core/persistence/PersistenceManager.cpp"
click node_snapshots "https://github.com/chizy7/pinnaclemm/blob/main/core/persistence/snapshot/SnapshotManager.cpp"
click node_audit "https://github.com/chizy7/pinnaclemm/blob/main/core/utils/AuditLogger.cpp"
click node_dashboard "https://github.com/chizy7/pinnaclemm/blob/main/visualization/WebServer.cpp"

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_main,node_instruments,node_orders,node_book,node_router toneBlue
class node_feeds,node_connectors,node_fix,node_simulator toneAmber
class node_maker,node_mlmaker,node_analytics,node_regime,node_optimizer,node_rl,node_arb,node_backtest toneMint
class node_risk,node_var,node_breaker,node_alerts,node_persistence,node_snapshots toneRose
class node_audit,node_dashboard,node_user toneIndigo
```

## Components

### Trading Runtime

- [Runtime Entry](https://github.com/chizy7/pinnaclemm/blob/main/main.cpp): `main.cpp`
- [Instrument Lifecycle](https://github.com/chizy7/pinnaclemm/blob/main/core/instrument/InstrumentManager.cpp): `core/instrument/InstrumentManager.cpp`
- [Order Model](https://github.com/chizy7/pinnaclemm/blob/main/core/orderbook/Order.cpp): `core/orderbook/Order.cpp`
- [Order Book](https://github.com/chizy7/pinnaclemm/blob/main/core/orderbook/OrderBook.cpp): `core/orderbook/OrderBook.cpp`
- [Order Router](https://github.com/chizy7/pinnaclemm/blob/main/core/routing/OrderRouter.cpp): `core/routing/OrderRouter.cpp`

### Market Connectivity

- [Live Market Feed](https://github.com/chizy7/pinnaclemm/blob/main/exchange/connector/WebSocketMarketDataFeed.cpp): `exchange/connector/WebSocketMarketDataFeed.cpp`
- [Venue Connectors](https://github.com/chizy7/pinnaclemm/blob/main/exchange/connector/ExchangeConnectorFactory.cpp): `exchange/connector/ExchangeConnectorFactory.cpp`
- [FIX Connectivity](https://github.com/chizy7/pinnaclemm/blob/main/exchange/fix/FixConnector.cpp): `exchange/fix/FixConnector.cpp`
- [Exchange Simulator](https://github.com/chizy7/pinnaclemm/blob/main/exchange/simulator/ExchangeSimulator.cpp): `exchange/simulator/ExchangeSimulator.cpp`

### Strategies And Research

- [Market-Making Strategy](https://github.com/chizy7/pinnaclemm/blob/main/strategies/basic/BasicMarketMaker.cpp): `strategies/basic/BasicMarketMaker.cpp`
- [ML-Enhanced Strategy](https://github.com/chizy7/pinnaclemm/blob/main/strategies/basic/MLEnhancedMarketMaker.cpp): `strategies/basic/MLEnhancedMarketMaker.cpp`
- [Market Analytics](https://github.com/chizy7/pinnaclemm/blob/main/strategies/analytics/MarketImpactPredictor.cpp): `strategies/analytics/MarketImpactPredictor.cpp`
- [Regime Detection](https://github.com/chizy7/pinnaclemm/blob/main/strategies/analytics/MarketRegimeDetector.cpp): `strategies/analytics/MarketRegimeDetector.cpp`
- [Spread Optimization](https://github.com/chizy7/pinnaclemm/blob/main/strategies/ml/MLSpreadOptimizer.cpp): `strategies/ml/MLSpreadOptimizer.cpp`
- [RL Adaptation](https://github.com/chizy7/pinnaclemm/blob/main/strategies/rl/RLParameterAdapter.cpp): `strategies/rl/RLParameterAdapter.cpp`
- [Arbitrage Detection](https://github.com/chizy7/pinnaclemm/blob/main/strategies/arbitrage/ArbitrageDetector.cpp): `strategies/arbitrage/ArbitrageDetector.cpp`
- [Backtesting](https://github.com/chizy7/pinnaclemm/blob/main/strategies/backtesting/BacktestEngine.cpp): `strategies/backtesting/BacktestEngine.cpp`

### Risk And Recovery

- [Pre-Trade Risk](https://github.com/chizy7/pinnaclemm/blob/main/core/risk/RiskManager.cpp): `core/risk/RiskManager.cpp`
- [VaR Engine](https://github.com/chizy7/pinnaclemm/blob/main/core/risk/VaREngine.cpp): `core/risk/VaREngine.cpp`
- [Circuit Breaker](https://github.com/chizy7/pinnaclemm/blob/main/core/risk/CircuitBreaker.cpp): `core/risk/CircuitBreaker.cpp`
- [Risk Alerts](https://github.com/chizy7/pinnaclemm/blob/main/core/risk/AlertManager.cpp): `core/risk/AlertManager.cpp`
- [Persistence Manager](https://github.com/chizy7/pinnaclemm/blob/main/core/persistence/PersistenceManager.cpp): `core/persistence/PersistenceManager.cpp`
- [Snapshot Recovery](https://github.com/chizy7/pinnaclemm/blob/main/core/persistence/snapshot/SnapshotManager.cpp): `core/persistence/snapshot/SnapshotManager.cpp`

### Monitoring

- [Audit Logging](https://github.com/chizy7/pinnaclemm/blob/main/core/utils/AuditLogger.cpp): `core/utils/AuditLogger.cpp`
- [Web Dashboard](https://github.com/chizy7/pinnaclemm/blob/main/visualization/WebServer.cpp): `visualization/WebServer.cpp`

### Other components

- **Operator**

## Connections

- Operator → Runtime Entry: starts mode (evidence: `README.md`)
- Runtime Entry → Instrument Lifecycle: manages instruments (evidence: `main.cpp`)
- Runtime Entry → Persistence Manager: initializes (evidence: `main.cpp`)
- Runtime Entry → Pre-Trade Risk: initializes (evidence: `main.cpp`)
- Instrument Lifecycle → Market-Making Strategy: manages strategy
- Instrument Lifecycle → Order Book: manages book
- Instrument Lifecycle → Exchange Simulator: manages simulator
- Live Market Feed → Order Book: provides market data
- Exchange Simulator → Order Book: uses order book
- Market-Making Strategy → Order Book: uses market state
- ML-Enhanced Strategy → Market Analytics: uses predictions
- ML-Enhanced Strategy → Regime Detection: uses regimes
- ML-Enhanced Strategy → Spread Optimization: optimizes spreads
- ML-Enhanced Strategy → RL Adaptation: adapts parameters
- Order Router → Venue Connectors: routes orders
- Order Router → FIX Connectivity: routes orders
- Order Book → Persistence Manager: journals state (evidence: `core/orderbook/OrderBook.cpp`)
- Persistence Manager → Snapshot Recovery: manages snapshots
- Runtime Entry → Backtesting: selects backtest mode (evidence: `README.md`)
- Backtesting → ML-Enhanced Strategy: can run strategy
- Runtime Entry → Arbitrage Detection: offers arbitrage capability (evidence: `README.md`)
- Pre-Trade Risk → Circuit Breaker: applies risk controls (evidence: `README.md`)
- Pre-Trade Risk → VaR Engine: assesses exposure (evidence: `README.md`)
- Pre-Trade Risk → Risk Alerts: raises alerts (evidence: `README.md`)
- Runtime Entry → Audit Logging: initializes audit (evidence: `main.cpp`)
- Operator → Web Dashboard: views monitoring (evidence: `README.md`)
