# gamaleldin11/ai-journey-written-course architecture

> Architecture diagram of the GitHub repository gamaleldin11/ai-journey-written-course, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gamaleldin11/ai-journey-written-course
- Repository: https://github.com/gamaleldin11/ai-journey-written-course

## Overview

This repository supports a machine-learning course presented as a website. Learners enter through the course page and progress through the ordered stages defined in `learning_path.py`. The available excerpt documents a Markdown-to-HTML build and figure copying; the Markdown course files are not present in the supplied tree, and `index.html` behavior was not sampled, so details of the page's interactive features and content are uncertain.

Main entry points: [`index.html`](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/index.html) (Course website), [`build_site.py`](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/build_site.py) (Site builder), [`learning_path.py`](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py) (Stage ordering), [`update_md_nav.py`](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/update_md_nav.py) (Markdown navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_course["Course experience"]
  node_index["Course website<br/>[index.html]"]
  node_toolkit["Toolkit<br/>[learning_path.py]"]
  node_data_stats["Data &amp; statistics<br/>[learning_path.py]"]
  node_classical_ml["Classical ML<br/>[learning_path.py]"]
  node_applied_ml["Applied ML<br/>[learning_path.py]"]
  node_deep_learning["Deep learning<br/>[learning_path.py]"]
  node_modern_ai["Modern AI<br/>[learning_path.py]"]
  node_interview_beyond["Interview &amp; beyond<br/>[learning_path.py]"]
end

subgraph group_site["Site generation"]
  node_builder["Site builder<br/>[build_site.py]"]
  node_head_template["Head template<br/>[template_head.html]"]
  node_body_template["Body template<br/>[template_body.html]"]
  node_figures["Course figures"]
end

subgraph group_path["Learning path"]
  node_path_config["Stage ordering<br/>[learning_path.py]"]
  node_nav_updater["Markdown navigation<br/>[update_md_nav.py]"]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_index
node_index -->|"presents stage"| node_toolkit
node_index -->|"presents stage"| node_data_stats
node_index -->|"presents stage"| node_classical_ml
node_index -->|"presents stage"| node_applied_ml
node_index -->|"presents stage"| node_deep_learning
node_index -->|"presents stage"| node_modern_ai
node_index -->|"presents stage"| node_interview_beyond
node_path_config -->|"supplies ordering"| node_builder
node_nav_updater -->|"imports sequence"| node_path_config
node_builder -->|"uses template"| node_head_template
node_builder -->|"uses template"| node_body_template
node_builder -->|"copies figures"| node_figures
node_builder -->|"generates page"| node_index

click node_index "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/index.html"
click node_toolkit "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_data_stats "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_classical_ml "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_applied_ml "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_deep_learning "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_modern_ai "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_interview_beyond "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_builder "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/build_site.py"
click node_head_template "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/template_head.html"
click node_body_template "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/template_body.html"
click node_figures "https://github.com/gamaleldin11/ai-journey-written-course/tree/main/figures"
click node_path_config "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py"
click node_nav_updater "https://github.com/gamaleldin11/ai-journey-written-course/blob/main/update_md_nav.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_index,node_toolkit,node_data_stats,node_classical_ml,node_applied_ml,node_deep_learning,node_modern_ai,node_interview_beyond toneBlue
class node_builder,node_head_template,node_body_template,node_figures toneAmber
class node_path_config,node_nav_updater toneMint
class node_learner toneIndigo
```

## Components

### Course experience

- [Course website](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/index.html): `index.html`
- [Toolkit](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`
- [Data & statistics](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`
- [Classical ML](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`
- [Applied ML](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`
- [Deep learning](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`
- [Modern AI](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`
- [Interview & beyond](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`

### Site generation

- [Site builder](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/build_site.py): `build_site.py`
- [Head template](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/template_head.html): `template_head.html`
- [Body template](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/template_body.html): `template_body.html`
- [Course figures](https://github.com/gamaleldin11/ai-journey-written-course/tree/main/figures): `figures`

### Learning path

- [Stage ordering](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/learning_path.py): `learning_path.py`
- [Markdown navigation](https://github.com/gamaleldin11/ai-journey-written-course/blob/main/update_md_nav.py): `update_md_nav.py`

### Other components

- **Learner**

## Connections

- Learner → Course website: opens
- Course website → Toolkit: presents stage
- Course website → Data & statistics: presents stage
- Course website → Classical ML: presents stage
- Course website → Applied ML: presents stage
- Course website → Deep learning: presents stage
- Course website → Modern AI: presents stage
- Course website → Interview & beyond: presents stage
- Stage ordering → Site builder: supplies ordering
- Markdown navigation → Stage ordering: imports sequence
- Site builder → Head template: uses template
- Site builder → Body template: uses template
- Site builder → Course figures: copies figures
- Site builder → Course website: generates page