# tuanbt/metatrader architecture

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

- Interactive diagram: https://gitdiagram.com/tuanbt/metatrader
- Repository: https://github.com/tuanbt/metatrader

## Overview

This repository supports MetaTrader 5 trading through remote backtesting, a trade-monitoring workflow, and regime-based parameter generation for EAs. The principal monitor workflow is CLI → health check and log collection → local trade records → analysis report. Backtests and regime analysis are separate capabilities. The tree does not include the EA implementations or most generated/runtime data, so those are shown only as external actors or outputs; connections are limited to README statements and the excerpts provided.

Main entry points: [`monitor/collector.py`](https://github.com/tuanbt/metatrader/blob/main/monitor/collector.py) (Log collector), [`monitor/monitor.py`](https://github.com/tuanbt/metatrader/blob/main/monitor/monitor.py) (Monitor CLI), [`monitor/ssh_helper.py`](https://github.com/tuanbt/metatrader/blob/main/monitor/ssh_helper.py) (SSH access), [`monitor/health_check.py`](https://github.com/tuanbt/metatrader/blob/main/monitor/health_check.py) (Health checks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_monitor["Trade monitoring"]
  node_monitor_cli["Monitor CLI<br/>[monitor.py]"]
  node_health["Health checks<br/>[health_check.py]"]
  node_collector["Log collector<br/>[collector.py]"]
  node_ssh["SSH access<br/>[ssh_helper.py]"]
  node_monitor_config["Monitor config<br/>[config.py]"]
  node_trade_data[("Trade records")]
  node_analyzer["Trade analysis<br/>[analyzer.py]"]
  node_report["Analysis report<br/>[analyzer.py]"]
end

subgraph group_backtest["Strategy backtesting"]
  node_backtest_suite["Backtest scripts"]
  node_quick_backtest["Quick backtest"]
  node_full_backtest["Full backtest"]
  node_auto_backtest["Upload and verify"]
  node_optimize["Parameter optimizer"]
  node_medio_session["MST session tests"]
  node_grid_test["Grid backtest<br/>[bt_grid_usdjpy.py]"]
end

subgraph group_regime["Regime analysis"]
  node_regime_tool["Regime analyzer<br/>[regime_analyzer.py]"]
  node_panel_regime["Panel analyzer<br/>[regime_analyzer.py]"]
end

node_operator(("Operator"))
node_mt5_server["MT5 server"]
node_ea_logs["EA logs"]
node_market_data[("MT5 price history")]
node_ea(("Trading EA"))
node_regime_config["Regime INI"]

node_operator -->|"runs commands"| node_monitor_cli
node_monitor_cli -->|"checks status"| node_health
node_monitor_cli -->|"collects logs"| node_collector
node_monitor_cli -->|"generates report"| node_analyzer
node_health -->|"runs remote checks"| node_ssh
node_collector -->|"reads remote logs"| node_ssh
node_ssh -->|"loads connection settings"| node_monitor_config
node_health -->|"loads server settings"| node_monitor_config
node_collector -->|"loads log settings"| node_monitor_config
node_mt5_server -.->|"writes logs"| node_ea_logs
node_ssh -->|"connects remotely"| node_mt5_server
node_collector -->|"pulls and parses"| node_ea_logs
node_collector -->|"saves events"| node_trade_data
node_trade_data -->|"reads events"| node_analyzer
node_analyzer -->|"formats report"| node_report
node_operator -->|"runs test"| node_quick_backtest
node_operator -->|"runs test"| node_full_backtest
node_operator -->|"optimizes parameters"| node_optimize
node_operator -->|"uploads and verifies"| node_auto_backtest
node_operator -->|"runs grid test"| node_grid_test
node_operator -->|"runs session tests"| node_medio_session
node_medio_session -->|"runs remote tests"| node_mt5_server
node_operator -->|"starts analysis"| node_regime_tool
node_operator -->|"starts analysis"| node_panel_regime
node_regime_tool -->|"fetches price history"| node_market_data
node_panel_regime -->|"fetches price history"| node_market_data
node_regime_tool -->|"writes parameters"| node_regime_config
node_panel_regime -->|"writes parameters"| node_regime_config
node_regime_config -->|"EA reads config"| node_ea

click node_monitor_cli "https://github.com/tuanbt/metatrader/blob/main/monitor/monitor.py"
click node_health "https://github.com/tuanbt/metatrader/blob/main/monitor/health_check.py"
click node_collector "https://github.com/tuanbt/metatrader/blob/main/monitor/collector.py"
click node_ssh "https://github.com/tuanbt/metatrader/blob/main/monitor/ssh_helper.py"
click node_monitor_config "https://github.com/tuanbt/metatrader/blob/main/monitor/config.py"
click node_trade_data "https://github.com/tuanbt/metatrader/tree/main/monitor/data"
click node_analyzer "https://github.com/tuanbt/metatrader/blob/main/monitor/analyzer.py"
click node_report "https://github.com/tuanbt/metatrader/blob/main/monitor/analyzer.py"
click node_backtest_suite "https://github.com/tuanbt/metatrader/tree/main/backtest"
click node_quick_backtest "https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_quick_backtest.py"
click node_full_backtest "https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_full_backtest.py"
click node_auto_backtest "https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_auto_backtest.py"
click node_optimize "https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_optimize_medio.py"
click node_medio_session "https://github.com/tuanbt/metatrader/blob/main/backtest/bt_mst_medio_h1_session.py"
click node_grid_test "https://github.com/tuanbt/metatrader/blob/main/backtest/bt_grid_usdjpy.py"
click node_regime_tool "https://github.com/tuanbt/metatrader/blob/main/tools/regime_analyzer.py"
click node_panel_regime "https://github.com/tuanbt/metatrader/blob/main/MQL5/Trading%20Panel/regime_analyzer.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_monitor_cli,node_health,node_collector,node_ssh,node_monitor_config,node_trade_data,node_analyzer,node_report toneBlue
class node_backtest_suite,node_quick_backtest,node_full_backtest,node_auto_backtest,node_optimize,node_medio_session,node_grid_test,node_market_data toneAmber
class node_regime_tool,node_panel_regime,node_mt5_server toneMint
class node_operator,node_ea_logs,node_ea,node_regime_config toneIndigo
```

## Components

### Trade monitoring

- [Monitor CLI](https://github.com/tuanbt/metatrader/blob/main/monitor/monitor.py): `monitor/monitor.py`
- [Health checks](https://github.com/tuanbt/metatrader/blob/main/monitor/health_check.py): `monitor/health_check.py`
- [Log collector](https://github.com/tuanbt/metatrader/blob/main/monitor/collector.py): `monitor/collector.py`
- [SSH access](https://github.com/tuanbt/metatrader/blob/main/monitor/ssh_helper.py): `monitor/ssh_helper.py`
- [Monitor config](https://github.com/tuanbt/metatrader/blob/main/monitor/config.py): `monitor/config.py`
- [Trade records](https://github.com/tuanbt/metatrader/tree/main/monitor/data): `monitor/data`
- [Trade analysis](https://github.com/tuanbt/metatrader/blob/main/monitor/analyzer.py): `monitor/analyzer.py`
- [Analysis report](https://github.com/tuanbt/metatrader/blob/main/monitor/analyzer.py): `monitor/analyzer.py`

### Strategy backtesting

- [Backtest scripts](https://github.com/tuanbt/metatrader/tree/main/backtest): `backtest`
- [Quick backtest](https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_quick_backtest.py): `backtest/mt5_quick_backtest.py`
- [Full backtest](https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_full_backtest.py): `backtest/mt5_full_backtest.py`
- [Upload and verify](https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_auto_backtest.py): `backtest/mt5_auto_backtest.py`
- [Parameter optimizer](https://github.com/tuanbt/metatrader/blob/main/backtest/mt5_optimize_medio.py): `backtest/mt5_optimize_medio.py`
- [MST session tests](https://github.com/tuanbt/metatrader/blob/main/backtest/bt_mst_medio_h1_session.py): `backtest/bt_mst_medio_h1_session.py`
- [Grid backtest](https://github.com/tuanbt/metatrader/blob/main/backtest/bt_grid_usdjpy.py): `backtest/bt_grid_usdjpy.py`

### Regime analysis

- [Regime analyzer](https://github.com/tuanbt/metatrader/blob/main/tools/regime_analyzer.py): `tools/regime_analyzer.py`
- [Panel analyzer](https://github.com/tuanbt/metatrader/blob/main/MQL5/Trading%20Panel/regime_analyzer.py): `MQL5/Trading Panel/regime_analyzer.py`

### Other components

- **Operator**
- **MT5 server**
- **EA logs**
- **MT5 price history**
- **Trading EA**
- **Regime INI**

## Connections

- Operator → Monitor CLI: runs commands (evidence: `README.md`)
- Monitor CLI → Health checks: checks status (evidence: `monitor/monitor.py`)
- Monitor CLI → Log collector: collects logs (evidence: `monitor/monitor.py`)
- Monitor CLI → Trade analysis: generates report (evidence: `monitor/monitor.py`)
- Health checks → SSH access: runs remote checks (evidence: `monitor/health_check.py`)
- Log collector → SSH access: reads remote logs (evidence: `monitor/collector.py`)
- SSH access → Monitor config: loads connection settings (evidence: `monitor/ssh_helper.py`)
- Health checks → Monitor config: loads server settings (evidence: `monitor/health_check.py`)
- Log collector → Monitor config: loads log settings (evidence: `monitor/collector.py`)
- MT5 server → EA logs: writes logs (evidence: `README.md`)
- SSH access → MT5 server: connects remotely (evidence: `monitor/ssh_helper.py`)
- Log collector → EA logs: pulls and parses (evidence: `monitor/collector.py`)
- Log collector → Trade records: saves events (evidence: `monitor/collector.py`)
- Trade records → Trade analysis: reads events (evidence: `monitor/analyzer.py`)
- Trade analysis → Analysis report: formats report (evidence: `monitor/analyzer.py`)
- Operator → Quick backtest: runs test (evidence: `README.md`)
- Operator → Full backtest: runs test (evidence: `README.md`)
- Operator → Parameter optimizer: optimizes parameters (evidence: `README.md`)
- Operator → Upload and verify: uploads and verifies (evidence: `README.md`)
- Operator → Grid backtest: runs grid test (evidence: `README.md`)
- Operator → MST session tests: runs session tests (evidence: `backtest/bt_mst_medio_h1_session.py`)
- MST session tests → MT5 server: runs remote tests (evidence: `backtest/bt_mst_medio_h1_session.py`)
- Operator → Regime analyzer: starts analysis (evidence: `tools/regime_analyzer.py`)
- Operator → Panel analyzer: starts analysis (evidence: `MQL5/Trading Panel/regime_analyzer.py`)
- Regime analyzer → MT5 price history: fetches price history (evidence: `tools/regime_analyzer.py`)
- Panel analyzer → MT5 price history: fetches price history (evidence: `MQL5/Trading Panel/regime_analyzer.py`)
- Regime analyzer → Regime INI: writes parameters (evidence: `tools/regime_analyzer.py`)
- Panel analyzer → Regime INI: writes parameters (evidence: `MQL5/Trading Panel/regime_analyzer.py`)
- Regime INI → Trading EA: EA reads config (evidence: `README.md`)
