# tnickel/mt5-backtester architecture

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

- Interactive diagram: https://gitdiagram.com/tnickel/mt5-backtester
- Repository: https://github.com/tnickel/mt5-backtester

## Overview

MT5 Backtester is a Java desktop platform for configuring and automating MetaTrader tests, then comparing and validating strategy results. Users can run individual or sequential batch tests, optimize parameters, inspect robustness, and follow a guided seven-step path from optimization through out-of-sample validation and export. The map also includes EA configuration, run history, reporting, and optional Dukascopy data and local-LLM analysis. Workflow orchestration links are supported by the source index; README documents product capabilities. Several detailed stage-to-stage implementation links are not shown in the excerpts and are therefore omitted.

Main entry points: [`src/main/java/com/backtester/engine/WorkflowEngine.java`](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/WorkflowEngine.java) (Workflow engine), [`src/main/java/com/backtester/ui/javafx/AppLauncher.java`](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/AppLauncher.java) (Desktop UI), [`src/main/java/com/backtester/ui/javafx/WorkflowView.java`](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/WorkflowView.java) (Workflow UI), [`src/main/java/com/backtester/engine/BacktestRunner.java`](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/BacktestRunner.java) (Backtest runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_app["Application entry<br/>[Main.java]"]
  node_desktop["Desktop UI<br/>[AppLauncher.java]"]
  node_single_ui["Single backtest UI<br/>[BacktestView.java]"]
  node_multi_ui["Batch test UI"]
  node_optimizer_ui["Optimizer UI"]
  node_workflow_ui["Workflow UI<br/>[WorkflowView.java]"]
end

subgraph group_execution["Test execution"]
  node_backtest["Backtest runner"]
  node_optimization["Optimization runner"]
  node_multi_runner["Batch runner"]
end

subgraph group_analysis["Strategy analysis"]
  node_sensitivity["Sensitivity runner"]
  node_robustness["Robustness runner"]
  node_reports["Report parsing and output<br/>[ReportParser.java]"]
  node_llm["Local LLM analysis"]
end

subgraph group_workflow["Guided workflow"]
  node_project_runner["Project workflow runner"]
  node_engine["Workflow engine"]
  node_guided["Guided optimization"]
  node_gate_analysis["Filter gate analysis"]
  node_lineage["Strategy lineage"]
  node_export["Validated strategy export"]
end

subgraph group_platform["Configuration and data"]
  node_ea_config["EA parameters and presets"]
  node_config["Application configuration<br/>[AppConfig.java]"]
  node_database[("SQLite persistence")]
  node_history["Run history<br/>[HistoryRun.java]"]
  node_dukascopy["Dukascopy data"]
end

node_user(("User"))
node_mt5["MetaTrader 5"]

node_user -->|"starts"| node_app
node_app -->|"launches"| node_desktop
node_desktop -->|"offers"| node_single_ui
node_desktop -->|"offers"| node_multi_ui
node_desktop -->|"offers"| node_optimizer_ui
node_desktop -->|"offers"| node_workflow_ui
node_workflow_ui -->|"runs project pipeline"| node_project_runner
node_project_runner -->|"invokes"| node_engine
node_engine -->|"calls"| node_backtest
node_engine -->|"calls"| node_optimization
node_engine -->|"calls"| node_sensitivity
node_workflow_ui -->|"guides selection"| node_guided
node_workflow_ui -->|"supports gate analysis"| node_gate_analysis
node_workflow_ui -->|"shows strategy lineage"| node_lineage
node_single_ui -->|"configures test"| node_backtest
node_multi_ui -->|"starts sequential runs"| node_multi_runner
node_optimizer_ui -->|"configures optimization"| node_optimization
node_optimizer_ui -->|"edits parameters"| node_ea_config
node_backtest -->|"runs tests"| node_mt5
node_optimization -->|"optimizes"| node_mt5
node_multi_runner -->|"runs sequentially"| node_mt5
node_robustness -->|"sweeps parameters"| node_sensitivity
node_engine -.->|"parses results"| node_reports
node_engine -->|"requests scoring"| node_llm
node_llm -->|"uses persisted data"| node_database
node_backtest -.->|"produces results"| node_reports
node_database -->|"stores run history"| node_history
node_desktop -->|"manages configuration"| node_database
node_user -->|"requests downloads"| node_dukascopy
node_workflow_ui -->|"exports validated strategies"| node_export
node_engine -->|"writes parameter presets"| node_ea_config
node_engine -->|"persists workflow state"| node_database

click node_app "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/Main.java"
click node_desktop "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/AppLauncher.java"
click node_single_ui "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/BacktestView.java"
click node_multi_ui "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/MultiBacktestView.java"
click node_optimizer_ui "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/OptimizationView.java"
click node_workflow_ui "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/WorkflowView.java"
click node_project_runner "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/ProjectWorkflowPipelineRunner.java"
click node_engine "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/WorkflowEngine.java"
click node_guided "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/workflow/GuidedOptimizationService.java"
click node_gate_analysis "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/workflow/FilterGateAnalysisService.java"
click node_lineage "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/workflow/MasterStrategyLineageService.java"
click node_backtest "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/BacktestRunner.java"
click node_optimization "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/OptimizationRunner.java"
click node_multi_runner "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/MultiBacktestRunner.java"
click node_sensitivity "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/SensitivityRunner.java"
click node_robustness "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/RobustnessRunner.java"
click node_reports "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/report/ReportParser.java"
click node_llm "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/LlmAnalysisService.java"
click node_ea_config "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/config/EaParameterManager.java"
click node_config "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/config/AppConfig.java"
click node_database "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/database/DatabaseManager.java"
click node_history "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/database/HistoryRun.java"
click node_dukascopy "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/dukascopy/DukascopyDownloader.java"
click node_export "https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/tools/StrategyExporter.java"

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_app,node_desktop,node_single_ui,node_multi_ui,node_optimizer_ui,node_workflow_ui,node_user toneBlue
class node_backtest,node_optimization,node_multi_runner toneAmber
class node_sensitivity,node_robustness,node_reports,node_llm toneMint
class node_project_runner,node_engine,node_guided,node_gate_analysis,node_lineage,node_export toneRose
class node_ea_config,node_config,node_database,node_history,node_dukascopy,node_mt5 toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/Main.java): `src/main/java/com/backtester/Main.java`
- [Desktop UI](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/AppLauncher.java): `src/main/java/com/backtester/ui/javafx/AppLauncher.java`
- [Single backtest UI](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/BacktestView.java): `src/main/java/com/backtester/ui/javafx/BacktestView.java`
- [Batch test UI](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/MultiBacktestView.java): `src/main/java/com/backtester/ui/javafx/MultiBacktestView.java`
- [Optimizer UI](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/OptimizationView.java): `src/main/java/com/backtester/ui/javafx/OptimizationView.java`
- [Workflow UI](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/WorkflowView.java): `src/main/java/com/backtester/ui/javafx/WorkflowView.java`

### Test execution

- [Backtest runner](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/BacktestRunner.java): `src/main/java/com/backtester/engine/BacktestRunner.java`
- [Optimization runner](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/OptimizationRunner.java): `src/main/java/com/backtester/engine/OptimizationRunner.java`
- [Batch runner](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/MultiBacktestRunner.java): `src/main/java/com/backtester/engine/MultiBacktestRunner.java`

### Strategy analysis

- [Sensitivity runner](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/SensitivityRunner.java): `src/main/java/com/backtester/engine/SensitivityRunner.java`
- [Robustness runner](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/RobustnessRunner.java): `src/main/java/com/backtester/engine/RobustnessRunner.java`
- [Report parsing and output](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/report/ReportParser.java): `src/main/java/com/backtester/report/ReportParser.java`
- [Local LLM analysis](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/LlmAnalysisService.java): `src/main/java/com/backtester/engine/LlmAnalysisService.java`

### Guided workflow

- [Project workflow runner](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/ui/javafx/ProjectWorkflowPipelineRunner.java): `src/main/java/com/backtester/ui/javafx/ProjectWorkflowPipelineRunner.java`
- [Workflow engine](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/engine/WorkflowEngine.java): `src/main/java/com/backtester/engine/WorkflowEngine.java`
- [Guided optimization](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/workflow/GuidedOptimizationService.java): `src/main/java/com/backtester/workflow/GuidedOptimizationService.java`
- [Filter gate analysis](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/workflow/FilterGateAnalysisService.java): `src/main/java/com/backtester/workflow/FilterGateAnalysisService.java`
- [Strategy lineage](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/workflow/MasterStrategyLineageService.java): `src/main/java/com/backtester/workflow/MasterStrategyLineageService.java`
- [Validated strategy export](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/tools/StrategyExporter.java): `src/main/java/com/backtester/tools/StrategyExporter.java`

### Configuration and data

- [EA parameters and presets](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/config/EaParameterManager.java): `src/main/java/com/backtester/config/EaParameterManager.java`
- [Application configuration](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/config/AppConfig.java): `src/main/java/com/backtester/config/AppConfig.java`
- [SQLite persistence](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/database/DatabaseManager.java): `src/main/java/com/backtester/database/DatabaseManager.java`
- [Run history](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/database/HistoryRun.java): `src/main/java/com/backtester/database/HistoryRun.java`
- [Dukascopy data](https://github.com/tnickel/mt5-backtester/blob/master/src/main/java/com/backtester/dukascopy/DukascopyDownloader.java): `src/main/java/com/backtester/dukascopy/DukascopyDownloader.java`

### Other components

- **User**
- **MetaTrader 5**

## Connections

- User → Application entry: starts
- Application entry → Desktop UI: launches (evidence: `src/main/java/com/backtester/Main.java`)
- Desktop UI → Single backtest UI: offers
- Desktop UI → Batch test UI: offers
- Desktop UI → Optimizer UI: offers
- Desktop UI → Workflow UI: offers
- Workflow UI → Project workflow runner: runs project pipeline
- Project workflow runner → Workflow engine: invokes (evidence: `src/main/java/com/backtester/ui/javafx/ProjectWorkflowPipelineRunner.java`)
- Workflow engine → Backtest runner: calls (evidence: `src/main/java/com/backtester/engine/WorkflowEngine.java`)
- Workflow engine → Optimization runner: calls (evidence: `src/main/java/com/backtester/engine/WorkflowEngine.java`)
- Workflow engine → Sensitivity runner: calls (evidence: `src/main/java/com/backtester/engine/WorkflowEngine.java`)
- Workflow UI → Guided optimization: guides selection
- Workflow UI → Filter gate analysis: supports gate analysis
- Workflow UI → Strategy lineage: shows strategy lineage
- Single backtest UI → Backtest runner: configures test
- Batch test UI → Batch runner: starts sequential runs
- Optimizer UI → Optimization runner: configures optimization
- Optimizer UI → EA parameters and presets: edits parameters
- Backtest runner → MetaTrader 5: runs tests
- Optimization runner → MetaTrader 5: optimizes
- Batch runner → MetaTrader 5: runs sequentially
- Robustness runner → Sensitivity runner: sweeps parameters
- Workflow engine → Report parsing and output: parses results
- Workflow engine → Local LLM analysis: requests scoring (evidence: `src/main/java/com/backtester/engine/WorkflowEngine.java`)
- Local LLM analysis → SQLite persistence: uses persisted data (evidence: `src/main/java/com/backtester/engine/LlmAnalysisService.java`)
- Backtest runner → Report parsing and output: produces results (evidence: `src/main/java/com/backtester/engine/BacktestRunner.java`)
- SQLite persistence → Run history: stores run history (evidence: `src/main/java/com/backtester/database/DatabaseManager.java`)
- Desktop UI → SQLite persistence: manages configuration
- User → Dukascopy data: requests downloads
- Workflow UI → Validated strategy export: exports validated strategies
- Workflow engine → EA parameters and presets: writes parameter presets (evidence: `src/main/java/com/backtester/engine/WorkflowEngine.java`)
- Workflow engine → SQLite persistence: persists workflow state (evidence: `src/main/java/com/backtester/engine/WorkflowEngine.java`)
