# xingwudao/xquant-beginner architecture

> Architecture diagram of the GitHub repository xingwudao/xquant-beginner, 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/xingwudao/xquant-beginner
- Repository: https://github.com/xingwudao/xquant-beginner

## Overview

XQuant Beginner is an open educational book, not a quant-trading application. Its central reader journey is to turn an investment idea into a clear strategy specification, use AI and Python to run a backtest, and assess whether the results are credible. The book then covers execution, monitoring, iteration, and factor research. Chapter relationships and capabilities below are based on the README; chapter source files are named in the tree but their contents were not sampled.

Main entry points: [`book/getting-started.md`](https://github.com/xingwudao/xquant-beginner/blob/main/book/getting-started.md) (Tools and Python), [`book/q1-how-to-profit.md`](https://github.com/xingwudao/xquant-beginner/blob/main/book/q1-how-to-profit.md) (Strategy Basics), [`book/q2-what-to-buy.md`](https://github.com/xingwudao/xquant-beginner/blob/main/book/q2-what-to-buy.md) (Asset Selection), [`book/q3-how-much.md`](https://github.com/xingwudao/xquant-beginner/blob/main/book/q3-how-much.md) (Position Sizing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_start["Getting Started"]
  node_setup["Tools and Python<br/>[getting-started.md]"]
end

subgraph group_research["Strategy Research"]
  node_profit["Strategy Basics"]
  node_universe["Asset Selection<br/>[q2-what-to-buy.md]"]
  node_sizing["Position Sizing<br/>[q3-how-much.md]"]
  node_rules["Trading Rules"]
end

subgraph group_practice["Validation and Practice"]
  node_validation["Backtest Evaluation"]
  node_overfitting["Bias Checks"]
  node_execution["Trade Execution<br/>[q7-execution.md]"]
  node_iteration["Monitoring and Iteration<br/>[q8-iteration.md]"]
  node_daily["Daily Research<br/>[q9-daily-work.md]"]
end

node_reader(("Reader"))
node_companion["Practice Materials"]

node_reader -->|"starts with"| node_setup
node_setup -->|"continues to"| node_profit
node_profit -->|"continues to"| node_universe
node_universe -->|"continues to"| node_sizing
node_sizing -->|"continues to"| node_rules
node_rules -->|"continues to"| node_validation
node_validation -->|"continues to"| node_overfitting
node_overfitting -->|"continues to"| node_execution
node_execution -->|"continues to"| node_iteration
node_iteration -->|"continues to"| node_daily
node_reader -.->|"uses exercises"| node_companion

click node_setup "https://github.com/xingwudao/xquant-beginner/blob/main/book/getting-started.md"
click node_profit "https://github.com/xingwudao/xquant-beginner/blob/main/book/q1-how-to-profit.md"
click node_universe "https://github.com/xingwudao/xquant-beginner/blob/main/book/q2-what-to-buy.md"
click node_sizing "https://github.com/xingwudao/xquant-beginner/blob/main/book/q3-how-much.md"
click node_rules "https://github.com/xingwudao/xquant-beginner/blob/main/book/q4-when-to-trade.md"
click node_validation "https://github.com/xingwudao/xquant-beginner/blob/main/book/q5-how-to-validate.md"
click node_overfitting "https://github.com/xingwudao/xquant-beginner/blob/main/book/q6-avoid-overfitting.md"
click node_execution "https://github.com/xingwudao/xquant-beginner/blob/main/book/q7-execution.md"
click node_iteration "https://github.com/xingwudao/xquant-beginner/blob/main/book/q8-iteration.md"
click node_daily "https://github.com/xingwudao/xquant-beginner/blob/main/book/q9-daily-work.md"

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_setup toneBlue
class node_profit,node_universe,node_sizing,node_rules toneAmber
class node_validation,node_overfitting,node_execution,node_iteration,node_daily toneMint
class node_reader,node_companion toneIndigo
```

## Components

### Getting Started

- [Tools and Python](https://github.com/xingwudao/xquant-beginner/blob/main/book/getting-started.md): `book/getting-started.md`

### Strategy Research

- [Strategy Basics](https://github.com/xingwudao/xquant-beginner/blob/main/book/q1-how-to-profit.md): `book/q1-how-to-profit.md`
- [Asset Selection](https://github.com/xingwudao/xquant-beginner/blob/main/book/q2-what-to-buy.md): `book/q2-what-to-buy.md`
- [Position Sizing](https://github.com/xingwudao/xquant-beginner/blob/main/book/q3-how-much.md): `book/q3-how-much.md`
- [Trading Rules](https://github.com/xingwudao/xquant-beginner/blob/main/book/q4-when-to-trade.md): `book/q4-when-to-trade.md`

### Validation and Practice

- [Backtest Evaluation](https://github.com/xingwudao/xquant-beginner/blob/main/book/q5-how-to-validate.md): `book/q5-how-to-validate.md`
- [Bias Checks](https://github.com/xingwudao/xquant-beginner/blob/main/book/q6-avoid-overfitting.md): `book/q6-avoid-overfitting.md`
- [Trade Execution](https://github.com/xingwudao/xquant-beginner/blob/main/book/q7-execution.md): `book/q7-execution.md`
- [Monitoring and Iteration](https://github.com/xingwudao/xquant-beginner/blob/main/book/q8-iteration.md): `book/q8-iteration.md`
- [Daily Research](https://github.com/xingwudao/xquant-beginner/blob/main/book/q9-daily-work.md): `book/q9-daily-work.md`

### Other components

- **Reader**
- **Practice Materials**

## Connections

- Reader → Tools and Python: starts with (evidence: `README.md`)
- Tools and Python → Strategy Basics: continues to (evidence: `README.md`)
- Strategy Basics → Asset Selection: continues to (evidence: `README.md`)
- Asset Selection → Position Sizing: continues to (evidence: `README.md`)
- Position Sizing → Trading Rules: continues to (evidence: `README.md`)
- Trading Rules → Backtest Evaluation: continues to (evidence: `README.md`)
- Backtest Evaluation → Bias Checks: continues to (evidence: `README.md`)
- Bias Checks → Trade Execution: continues to (evidence: `README.md`)
- Trade Execution → Monitoring and Iteration: continues to (evidence: `README.md`)
- Monitoring and Iteration → Daily Research: continues to (evidence: `README.md`)
- Reader → Practice Materials: uses exercises (evidence: `README.md`)
