# clayandthepotter/ai-gold-scalper architecture

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

- Interactive diagram: https://gitdiagram.com/clayandthepotter/ai-gold-scalper
- Repository: https://github.com/clayandthepotter/ai-gold-scalper

## Overview

AI Gold Scalper is an XAUUSD-focused algorithmic trading system. Its intended workflow is to process market data, analyze market conditions and generate model-based signals, manage trading risk, then evaluate trades and performance through logging, analysis, and a dashboard. The repository also includes model training, historical backtesting, and strategy research. The README establishes these product capabilities, but sampled code does not show the complete live signal-to-execution path; uncertain runtime connections are therefore omitted. Several internal links are supported by the source index rather than inspected call sites.

Main entry points: [`scripts/integration/phase4_integration.py`](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/integration/phase4_integration.py) (Phase 4 Controller), [`dashboard/trading_dashboard.py`](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/dashboard/trading_dashboard.py) (Trading Dashboard), [`scripts/integration/backtesting_integration.py`](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/integration/backtesting_integration.py) (Backtesting Integration), [`scripts/ai/model_registry.py`](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/model_registry.py) (Model Registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["System Runtime"]
  node_orchestrator["System Orchestrator"]
  node_ai_server["AI Server"]
  node_market_data["Market Data Processing"]
  node_schemas[("Database Schemas")]
end

subgraph group_intelligence["AI Intelligence"]
  node_regime["Regime Detection"]
  node_ensemble["Ensemble Models<br/>[ensemble_models.py]"]
  node_model_registry[("Model Registry<br/>[model_registry.py]")]
  node_adaptive_learning["Adaptive Learning"]
  node_phase4["Phase 4 Controller"]
end

subgraph group_research["Training &amp; Research"]
  node_trainer["Automated Training"]
  node_backtester["Historical Backtesting"]
  node_backtest_integration["Backtesting Integration"]
  node_strategy_generator["Strategy Research"]
end

subgraph group_operations["Monitoring &amp; Analysis"]
  node_risk_optimizer["Risk Optimization"]
  node_trade_logger[("Trade Logging")]
  node_postmortem["Trade Postmortems"]
  node_dashboard["Trading Dashboard"]
  node_task_watcher["Task Watcher"]
end

node_user(("Operator"))
node_gpt["OpenAI GPT"]

node_user -->|"starts system"| node_orchestrator
node_user -->|"views metrics"| node_dashboard
node_orchestrator -->|"references integration"| node_backtest_integration
node_phase4 -->|"detects regime"| node_regime
node_phase4 -->|"selects models"| node_ensemble
node_phase4 -->|"uses registry"| node_model_registry
node_phase4 -->|"uses learning"| node_adaptive_learning
node_backtest_integration -->|"runs backtests"| node_backtester
node_backtest_integration -->|"uses controller"| node_phase4
node_trainer -->|"manages models"| node_model_registry
node_dashboard -->|"imports processor"| node_market_data
node_dashboard -->|"controls training"| node_trainer
node_dashboard -->|"imports registry"| node_model_registry
node_dashboard -->|"imports controller"| node_phase4
node_postmortem -->|"reads trade data"| node_trade_logger
node_risk_optimizer -->|"references logs"| node_trade_logger
node_risk_optimizer -->|"references analysis"| node_postmortem
node_ai_server -.->|"uses GPT"| node_gpt

click node_orchestrator "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/core/system_orchestrator_enhanced.py"
click node_ai_server "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/core/enhanced_ai_server_consolidated.py"
click node_market_data "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/data/market_data_processor.py"
click node_schemas "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/core/database_schemas.py"
click node_regime "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/market_regime_detector.py"
click node_ensemble "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/ensemble_models.py"
click node_model_registry "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/model_registry.py"
click node_adaptive_learning "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/adaptive_learning.py"
click node_phase4 "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/integration/phase4_integration.py"
click node_trainer "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/training/automated_model_trainer.py"
click node_backtester "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/backtesting/comprehensive_backtester.py"
click node_backtest_integration "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/integration/backtesting_integration.py"
click node_strategy_generator "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/research/strategy_generator.py"
click node_risk_optimizer "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/analysis/risk_parameter_optimizer.py"
click node_trade_logger "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/monitoring/enhanced_trade_logger.py"
click node_postmortem "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/monitoring/trade_postmortem_analyzer.py"
click node_dashboard "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/dashboard/trading_dashboard.py"
click node_task_watcher "https://github.com/clayandthepotter/ai-gold-scalper/blob/main/utils/task_pending_watcher.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_orchestrator,node_ai_server,node_market_data,node_schemas toneBlue
class node_regime,node_ensemble,node_model_registry,node_adaptive_learning,node_phase4 toneAmber
class node_trainer,node_backtester,node_backtest_integration,node_strategy_generator toneMint
class node_risk_optimizer,node_trade_logger,node_postmortem,node_dashboard,node_task_watcher toneRose
class node_user,node_gpt toneIndigo
```

## Components

### System Runtime

- [System Orchestrator](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/core/system_orchestrator_enhanced.py): `core/system_orchestrator_enhanced.py`
- [AI Server](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/core/enhanced_ai_server_consolidated.py): `core/enhanced_ai_server_consolidated.py`
- [Market Data Processing](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/data/market_data_processor.py): `scripts/data/market_data_processor.py`
- [Database Schemas](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/core/database_schemas.py): `core/database_schemas.py`

### AI Intelligence

- [Regime Detection](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/market_regime_detector.py): `scripts/ai/market_regime_detector.py`
- [Ensemble Models](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/ensemble_models.py): `scripts/ai/ensemble_models.py`
- [Model Registry](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/model_registry.py): `scripts/ai/model_registry.py`
- [Adaptive Learning](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/ai/adaptive_learning.py): `scripts/ai/adaptive_learning.py`
- [Phase 4 Controller](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/integration/phase4_integration.py): `scripts/integration/phase4_integration.py`

### Training & Research

- [Automated Training](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/training/automated_model_trainer.py): `scripts/training/automated_model_trainer.py`
- [Historical Backtesting](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/backtesting/comprehensive_backtester.py): `scripts/backtesting/comprehensive_backtester.py`
- [Backtesting Integration](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/integration/backtesting_integration.py): `scripts/integration/backtesting_integration.py`
- [Strategy Research](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/research/strategy_generator.py): `scripts/research/strategy_generator.py`

### Monitoring & Analysis

- [Risk Optimization](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/analysis/risk_parameter_optimizer.py): `scripts/analysis/risk_parameter_optimizer.py`
- [Trade Logging](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/monitoring/enhanced_trade_logger.py): `scripts/monitoring/enhanced_trade_logger.py`
- [Trade Postmortems](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/scripts/monitoring/trade_postmortem_analyzer.py): `scripts/monitoring/trade_postmortem_analyzer.py`
- [Trading Dashboard](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/dashboard/trading_dashboard.py): `dashboard/trading_dashboard.py`
- [Task Watcher](https://github.com/clayandthepotter/ai-gold-scalper/blob/main/utils/task_pending_watcher.py): `utils/task_pending_watcher.py`

### Other components

- **Operator**
- **OpenAI GPT**

## Connections

- Operator → System Orchestrator: starts system (evidence: `README.md`)
- Operator → Trading Dashboard: views metrics (evidence: `README.md`)
- System Orchestrator → Backtesting Integration: references integration (evidence: `core/system_orchestrator_enhanced.py`)
- Phase 4 Controller → Regime Detection: detects regime (evidence: `scripts/integration/phase4_integration.py`)
- Phase 4 Controller → Ensemble Models: selects models (evidence: `scripts/integration/phase4_integration.py`)
- Phase 4 Controller → Model Registry: uses registry (evidence: `scripts/integration/phase4_integration.py`)
- Phase 4 Controller → Adaptive Learning: uses learning (evidence: `scripts/integration/phase4_integration.py`)
- Backtesting Integration → Historical Backtesting: runs backtests (evidence: `scripts/integration/backtesting_integration.py`)
- Backtesting Integration → Phase 4 Controller: uses controller (evidence: `scripts/integration/backtesting_integration.py`)
- Automated Training → Model Registry: manages models (evidence: `scripts/training/automated_model_trainer.py`)
- Trading Dashboard → Market Data Processing: imports processor (evidence: `dashboard/trading_dashboard.py`)
- Trading Dashboard → Automated Training: controls training (evidence: `dashboard/trading_dashboard.py`)
- Trading Dashboard → Model Registry: imports registry (evidence: `dashboard/trading_dashboard.py`)
- Trading Dashboard → Phase 4 Controller: imports controller (evidence: `dashboard/trading_dashboard.py`)
- Trade Postmortems → Trade Logging: reads trade data (evidence: `scripts/monitoring/trade_postmortem_analyzer.py`)
- Risk Optimization → Trade Logging: references logs (evidence: `scripts/analysis/risk_parameter_optimizer.py`)
- Risk Optimization → Trade Postmortems: references analysis (evidence: `scripts/analysis/risk_parameter_optimizer.py`)
- AI Server → OpenAI GPT: uses GPT (evidence: `README.md`)
