# kihyu/quant-learning-lab architecture

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

- Interactive diagram: https://gitdiagram.com/kihyu/quant-learning-lab
- Repository: https://github.com/kihyu/quant-learning-lab

## Overview

Quant Learning Lab is a self-paced quant-internship learning repository: learners study fundamentals, implement exercise stubs, check their work, and track progress. Its major branches include Python, C++, math, computer science, finance, portfolio projects, and interview preparation. The README documents the learning workflow and capabilities; sampled source confirms representative exercise modules and the C++ TODO/test helpers, but does not establish calls among the larger project and interview materials.

Main entry points: [`basics/cpp/common/todo.hpp`](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/common/todo.hpp) (TODO Marker), [`basics/cpp/01_basics/ex_basics.hpp`](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/01_basics/ex_basics.hpp) (C++ Basics), [`basics/cpp/02_stl/ex_stl.hpp`](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/02_stl/ex_stl.hpp) (C++ STL), [`basics/cpp/03_memory/ex_memory.hpp`](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/03_memory/ex_memory.hpp) (C++ Memory)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fundamentals["Fundamentals"]
  node_python["Python"]
  node_math["Math"]
  node_cs["Computer Science"]
  node_finance["Finance"]
end

subgraph group_cpp["C++ Exercises"]
  node_cpp_basics["C++ Basics<br/>[ex_basics.hpp]"]
  node_cpp_stl["C++ STL<br/>[ex_stl.hpp]"]
  node_cpp_memory["C++ Memory<br/>[ex_memory.hpp]"]
  node_cpp_templates["C++ Templates"]
  node_cpp_modern["Modern C++<br/>[ex_modern.hpp]"]
  node_cpp_concurrency["C++ Concurrency<br/>[ex_concurrency.hpp]"]
  node_cpp_todo["TODO Marker<br/>[todo.hpp]"]
  node_cpp_check["C++ Test Runner<br/>[check.hpp]"]
end

subgraph group_practice["Applied Practice"]
  node_projects["Portfolio Projects"]
  node_interview["Interview Training"]
  node_journal["Learning Journal"]
end

subgraph group_tracking["Progress Tracking"]
  node_python_checks["Python Exercise Checks<br/>[conftest.py]"]
  node_progress["Progress Overview<br/>[progress.py]"]
end

node_learner(("Learner"))

node_learner -->|"studies"| node_python
node_learner -->|"studies"| node_math
node_learner -->|"studies"| node_cs
node_learner -->|"studies"| node_finance
node_learner -->|"studies"| node_cpp_basics
node_learner -->|"studies"| node_cpp_stl
node_learner -->|"studies"| node_cpp_memory
node_learner -->|"studies"| node_cpp_templates
node_learner -->|"studies"| node_cpp_modern
node_learner -->|"studies"| node_cpp_concurrency
node_learner -->|"builds"| node_projects
node_learner -->|"trains with"| node_interview
node_learner -->|"reflects in"| node_journal
node_learner -->|"checks exercises with"| node_python_checks
node_learner -->|"checks exercises with"| node_cpp_check
node_learner -->|"reviews"| node_progress
node_cpp_basics -->|"marks stubs with"| node_cpp_todo
node_cpp_stl -->|"marks stubs with"| node_cpp_todo
node_cpp_memory -->|"marks stubs with"| node_cpp_todo
node_cpp_templates -->|"marks stubs with"| node_cpp_todo
node_cpp_modern -->|"marks stubs with"| node_cpp_todo
node_cpp_concurrency -->|"marks stubs with"| node_cpp_todo

click node_python "https://github.com/kihyu/quant-learning-lab/tree/main/basics/python"
click node_math "https://github.com/kihyu/quant-learning-lab/tree/main/basics/math"
click node_cs "https://github.com/kihyu/quant-learning-lab/tree/main/basics/cs"
click node_finance "https://github.com/kihyu/quant-learning-lab/tree/main/basics/finance"
click node_cpp_basics "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/01_basics/ex_basics.hpp"
click node_cpp_stl "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/02_stl/ex_stl.hpp"
click node_cpp_memory "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/03_memory/ex_memory.hpp"
click node_cpp_templates "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/04_oop_templates/ex_oop_templates.hpp"
click node_cpp_modern "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/05_modern/ex_modern.hpp"
click node_cpp_concurrency "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/06_concurrency/ex_concurrency.hpp"
click node_cpp_todo "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/common/todo.hpp"
click node_cpp_check "https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/common/check.hpp"
click node_projects "https://github.com/kihyu/quant-learning-lab/tree/main/projects"
click node_interview "https://github.com/kihyu/quant-learning-lab/tree/main/interview"
click node_journal "https://github.com/kihyu/quant-learning-lab/tree/main/journal"
click node_python_checks "https://github.com/kihyu/quant-learning-lab/blob/main/conftest.py"
click node_progress "https://github.com/kihyu/quant-learning-lab/blob/main/scripts/progress.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_python,node_math,node_cs,node_finance toneBlue
class node_cpp_basics,node_cpp_stl,node_cpp_memory,node_cpp_templates,node_cpp_modern,node_cpp_concurrency,node_cpp_todo,node_cpp_check toneAmber
class node_projects,node_interview,node_journal toneMint
class node_python_checks,node_progress toneRose
class node_learner toneIndigo
```

## Components

### Fundamentals

- [Python](https://github.com/kihyu/quant-learning-lab/tree/main/basics/python): `basics/python`
- [Math](https://github.com/kihyu/quant-learning-lab/tree/main/basics/math): `basics/math`
- [Computer Science](https://github.com/kihyu/quant-learning-lab/tree/main/basics/cs): `basics/cs`
- [Finance](https://github.com/kihyu/quant-learning-lab/tree/main/basics/finance): `basics/finance`

### C++ Exercises

- [C++ Basics](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/01_basics/ex_basics.hpp): `basics/cpp/01_basics/ex_basics.hpp`
- [C++ STL](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/02_stl/ex_stl.hpp): `basics/cpp/02_stl/ex_stl.hpp`
- [C++ Memory](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/03_memory/ex_memory.hpp): `basics/cpp/03_memory/ex_memory.hpp`
- [C++ Templates](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/04_oop_templates/ex_oop_templates.hpp): `basics/cpp/04_oop_templates/ex_oop_templates.hpp`
- [Modern C++](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/05_modern/ex_modern.hpp): `basics/cpp/05_modern/ex_modern.hpp`
- [C++ Concurrency](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/06_concurrency/ex_concurrency.hpp): `basics/cpp/06_concurrency/ex_concurrency.hpp`
- [TODO Marker](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/common/todo.hpp): `basics/cpp/common/todo.hpp`
- [C++ Test Runner](https://github.com/kihyu/quant-learning-lab/blob/main/basics/cpp/common/check.hpp): `basics/cpp/common/check.hpp`

### Applied Practice

- [Portfolio Projects](https://github.com/kihyu/quant-learning-lab/tree/main/projects): `projects`
- [Interview Training](https://github.com/kihyu/quant-learning-lab/tree/main/interview): `interview`
- [Learning Journal](https://github.com/kihyu/quant-learning-lab/tree/main/journal): `journal`

### Progress Tracking

- [Python Exercise Checks](https://github.com/kihyu/quant-learning-lab/blob/main/conftest.py): `conftest.py`
- [Progress Overview](https://github.com/kihyu/quant-learning-lab/blob/main/scripts/progress.py): `scripts/progress.py`

### Other components

- **Learner**

## Connections

- Learner → Python: studies (evidence: `README.md`)
- Learner → Math: studies (evidence: `README.md`)
- Learner → Computer Science: studies (evidence: `README.md`)
- Learner → Finance: studies (evidence: `README.md`)
- Learner → C++ Basics: studies (evidence: `README.md`)
- Learner → C++ STL: studies (evidence: `README.md`)
- Learner → C++ Memory: studies (evidence: `README.md`)
- Learner → C++ Templates: studies (evidence: `README.md`)
- Learner → Modern C++: studies (evidence: `README.md`)
- Learner → C++ Concurrency: studies (evidence: `README.md`)
- Learner → Portfolio Projects: builds (evidence: `README.md`)
- Learner → Interview Training: trains with (evidence: `README.md`)
- Learner → Learning Journal: reflects in (evidence: `README.md`)
- Learner → Python Exercise Checks: checks exercises with (evidence: `README.md`)
- Learner → C++ Test Runner: checks exercises with (evidence: `README.md`)
- Learner → Progress Overview: reviews (evidence: `README.md`)
- C++ Basics → TODO Marker: marks stubs with (evidence: `basics/cpp/01_basics/ex_basics.hpp`)
- C++ STL → TODO Marker: marks stubs with (evidence: `basics/cpp/02_stl/ex_stl.hpp`)
- C++ Memory → TODO Marker: marks stubs with (evidence: `basics/cpp/03_memory/ex_memory.hpp`)
- C++ Templates → TODO Marker: marks stubs with (evidence: `basics/cpp/04_oop_templates/ex_oop_templates.hpp`)
- Modern C++ → TODO Marker: marks stubs with (evidence: `basics/cpp/05_modern/ex_modern.hpp`)
- C++ Concurrency → TODO Marker: marks stubs with (evidence: `basics/cpp/06_concurrency/ex_concurrency.hpp`)
