# tradegunlugum/discretionary-backtester architecture

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

- Interactive diagram: https://gitdiagram.com/tradegunlugum/discretionary-backtester
- Repository: https://github.com/tradegunlugum/discretionary-backtester

## Overview

This is a small discretionary-trading backtester. Its demonstrated workflow loads dated price bars, selects a bar for a position, derives stop-loss and take-profit levels, then scans later bars for an exit. The README describes win-rate calculation, but the sampled implementation prints exit outcomes and does not show a win-rate summary. The graph reflects the shown entry point and core runtime; it does not assume unsampled behavior.

Main entry points: [`main.py`](https://github.com/tradegunlugum/discretionary-backtester/blob/main/main.py) (Backtest entry), [`TradeInfoManager.py`](https://github.com/tradegunlugum/discretionary-backtester/blob/main/TradeInfoManager.py) (Bar loading and exit scan), [`Position.py`](https://github.com/tradegunlugum/discretionary-backtester/blob/main/Position.py) (Position setup), [`PositionManager.py`](https://github.com/tradegunlugum/discretionary-backtester/blob/main/PositionManager.py) (Position collection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Backtest runtime"]
  node_main["Backtest entry<br/>[main.py]"]
  node_positions["Position setup<br/>[Position.py]"]
  node_position_manager["Position collection<br/>[PositionManager.py]"]
  node_trade_manager["Bar loading and exit scan"]
end

subgraph group_marketdata["Market data"]
  node_trade_info["Bar parsing<br/>[TradeInfo.py]"]
  node_sample_data["EURUSD bars"]
end

node_user(("Strategy user"))

node_user -->|"runs backtest"| node_main
node_main -->|"loads bars"| node_trade_manager
node_trade_manager -->|"reads bars"| node_sample_data
node_trade_manager -->|"parses rows"| node_trade_info
node_main -->|"looks up bar"| node_trade_manager
node_main -->|"builds position"| node_positions
node_main -->|"creates collection"| node_position_manager
node_main -->|"starts trades"| node_position_manager
node_trade_manager -->|"checks levels"| node_positions
node_positions -->|"uses entry bar"| node_trade_info

click node_main "https://github.com/tradegunlugum/discretionary-backtester/blob/main/main.py"
click node_positions "https://github.com/tradegunlugum/discretionary-backtester/blob/main/Position.py"
click node_position_manager "https://github.com/tradegunlugum/discretionary-backtester/blob/main/PositionManager.py"
click node_trade_manager "https://github.com/tradegunlugum/discretionary-backtester/blob/main/TradeInfoManager.py"
click node_trade_info "https://github.com/tradegunlugum/discretionary-backtester/blob/main/TradeInfo.py"
click node_sample_data "https://github.com/tradegunlugum/discretionary-backtester/blob/main/EURUSD_5min_sample.txt"

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_positions,node_position_manager,node_trade_manager,node_user toneBlue
class node_trade_info,node_sample_data toneAmber
```

## Components

### Backtest runtime

- [Backtest entry](https://github.com/tradegunlugum/discretionary-backtester/blob/main/main.py): `main.py`
- [Position setup](https://github.com/tradegunlugum/discretionary-backtester/blob/main/Position.py): `Position.py`
- [Position collection](https://github.com/tradegunlugum/discretionary-backtester/blob/main/PositionManager.py): `PositionManager.py`
- [Bar loading and exit scan](https://github.com/tradegunlugum/discretionary-backtester/blob/main/TradeInfoManager.py): `TradeInfoManager.py`

### Market data

- [Bar parsing](https://github.com/tradegunlugum/discretionary-backtester/blob/main/TradeInfo.py): `TradeInfo.py`
- [EURUSD bars](https://github.com/tradegunlugum/discretionary-backtester/blob/main/EURUSD_5min_sample.txt): `EURUSD_5min_sample.txt`

### Other components

- **Strategy user**

## Connections

- Strategy user → Backtest entry: runs backtest (evidence: `README.md`)
- Backtest entry → Bar loading and exit scan: loads bars (evidence: `main.py`)
- Bar loading and exit scan → EURUSD bars: reads bars (evidence: `TradeInfoManager.py`)
- Bar loading and exit scan → Bar parsing: parses rows (evidence: `TradeInfoManager.py`)
- Backtest entry → Bar loading and exit scan: looks up bar (evidence: `main.py`)
- Backtest entry → Position setup: builds position (evidence: `main.py`)
- Backtest entry → Position collection: creates collection (evidence: `main.py`)
- Backtest entry → Position collection: starts trades (evidence: `main.py`)
- Bar loading and exit scan → Position setup: checks levels (evidence: `TradeInfoManager.py`)
- Position setup → Bar parsing: uses entry bar (evidence: `main.py`)
