# johnjeep/learning-cs-journey architecture

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

- Interactive diagram: https://gitdiagram.com/johnjeep/learning-cs-journey
- Repository: https://github.com/johnjeep/learning-cs-journey

## Overview

This repository is a maintained computer-science learning knowledge base, not a single application. Its main user journey is to enter through the README’s topic map, choose a subject, and read notes, diagrams, or code examples. The map spans hardware and embedded systems, programming languages, operating systems and networking, data structures, databases, cloud-native systems, and robotics. Sampled source confirms several concrete examples, but most repository content is documentation not represented in the supplied tree; those branches are therefore linked at the documented subject level.

Main entry points: [`README.md`](https://github.com/johnjeep/learning-cs-journey/blob/master/README.md) (Knowledge Base), [`Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h`](https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h) (Board Support), [`Cpp/code/class/my-vector/main.cpp`](https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/my-vector/main.cpp) (MyVector Demo), [`Cpp/code/class/circular_point`](https://github.com/johnjeep/learning-cs-journey/tree/master/Cpp/code/class/circular_point) (Circle and Point)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["Hardware Foundations"]
  node_embedded["Embedded Systems"]
  node_baremetal["Bare-Metal Example<br/>[main.c]"]
  node_bsp["Board Support<br/>[bsp.h]"]
  node_led["LED Support<br/>[led.h]"]
  node_cmsis["STM32 Definitions<br/>[stm32f4xx.h]"]
  node_appconfig["RTOS Configuration<br/>[app_cfg.h]"]
end

subgraph group_languages["Languages"]
  node_c["C Examples"]
  node_cpp["C++ Examples"]
  node_myvector["MyVector Template<br/>[MyVector.cpp]"]
  node_myvectorheader["MyVector Interface<br/>[MyVector.h]"]
  node_myvectormain["MyVector Demo<br/>[main.cpp]"]
  node_geometry["Circle and Point"]
  node_circleheader["Circle Interface<br/>[circular.h]"]
  node_pointheader["Point Interface<br/>[point.h]"]
  node_go["Go Examples"]
end

subgraph group_systems["Systems"]
  node_datastructures["Data Structures"]
  node_os["Operating Systems"]
  node_network["Networking"]
  node_mysql["MySQL Connection Pool"]
  node_poolheader["Pool Interface<br/>[ConnectionPool.h]"]
  node_mysqlheader["Connection Interface<br/>[MysqlConn.h]"]
  node_pooldemo["Pool Demo<br/>[main.cpp]"]
end

subgraph group_applications["Applications"]
  node_cloud["Cloud Native"]
  node_protobuf["Protobuf Schema<br/>[student.proto]"]
  node_grpc["gRPC Stream Example<br/>[StreamServer.cpp]"]
  node_grpcpb["Generated Protobuf Code"]
  node_designpatterns["Design Patterns"]
  node_robotics["Robotics"]
  node_qt["Qt Examples"]
  node_signalwidget["Signal Slot Widget<br/>[widget.h]"]
  node_studentheader["Student Interface<br/>[student.h]"]
  node_qtmain["Signal Slot Entry<br/>[main.cpp]"]
end

node_learner(("Learner"))
node_knowledge["Knowledge Base<br/>[README.md]"]

node_learner -->|"browses map"| node_knowledge
node_knowledge -->|"documents"| node_embedded
node_knowledge -->|"documents"| node_c
node_knowledge -->|"documents"| node_cpp
node_knowledge -->|"documents"| node_go
node_knowledge -->|"documents"| node_datastructures
node_knowledge -->|"documents"| node_os
node_knowledge -->|"documents"| node_network
node_knowledge -->|"documents"| node_mysql
node_knowledge -->|"documents"| node_cloud
node_knowledge -->|"documents"| node_designpatterns
node_knowledge -->|"documents"| node_robotics
node_knowledge -->|"documents"| node_qt
node_baremetal -->|"includes"| node_bsp
node_bsp -->|"includes"| node_led
node_bsp -->|"includes"| node_cmsis
node_bsp -->|"includes"| node_appconfig
node_myvectormain -->|"uses"| node_myvector
node_myvectormain -.->|"includes"| node_myvectorheader
node_geometry -->|"uses"| node_circleheader
node_geometry -->|"uses"| node_pointheader
node_pooldemo -->|"uses"| node_poolheader
node_pooldemo -->|"uses"| node_mysqlheader
node_qtmain -->|"creates"| node_signalwidget
node_signalwidget -->|"includes"| node_studentheader
node_grpc -.->|"implements"| node_protobuf
node_grpc -.->|"uses"| node_grpcpb

click node_knowledge "https://github.com/johnjeep/learning-cs-journey/blob/master/README.md"
click node_embedded "https://github.com/johnjeep/learning-cs-journey/tree/master/Embedded"
click node_baremetal "https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-bare-metal-template/F407ZGT6/Src/App/main.c"
click node_bsp "https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h"
click node_led "https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/led.h"
click node_cmsis "https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/Libraries/CMSIS/DeviceSupport/stm32f4xx.h"
click node_appconfig "https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/App/app_cfg.h"
click node_c "https://github.com/johnjeep/learning-cs-journey/tree/master/C/code"
click node_cpp "https://github.com/johnjeep/learning-cs-journey/tree/master/Cpp/code"
click node_myvector "https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/my-vector/MyVector.cpp"
click node_myvectorheader "https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/my-vector/MyVector.h"
click node_myvectormain "https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/my-vector/main.cpp"
click node_geometry "https://github.com/johnjeep/learning-cs-journey/tree/master/Cpp/code/class/circular_point"
click node_circleheader "https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/circular_point/circular.h"
click node_pointheader "https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/circular_point/point.h"
click node_go "https://github.com/johnjeep/learning-cs-journey/tree/master/Go"
click node_datastructures "https://github.com/johnjeep/learning-cs-journey/tree/master/DataStructure"
click node_os "https://github.com/johnjeep/learning-cs-journey/tree/master/OS"
click node_network "https://github.com/johnjeep/learning-cs-journey/tree/master/Network"
click node_mysql "https://github.com/johnjeep/learning-cs-journey/tree/master/MySQL/ConnectPool"
click node_poolheader "https://github.com/johnjeep/learning-cs-journey/blob/master/MySQL/ConnectPool/ConnectionPool.h"
click node_mysqlheader "https://github.com/johnjeep/learning-cs-journey/blob/master/MySQL/ConnectPool/MysqlConn.h"
click node_pooldemo "https://github.com/johnjeep/learning-cs-journey/blob/master/MySQL/ConnectPool/main.cpp"
click node_cloud "https://github.com/johnjeep/learning-cs-journey/tree/master/CloudNative"
click node_protobuf "https://github.com/johnjeep/learning-cs-journey/blob/master/CloudNative/Probobuf/src/student.proto"
click node_grpc "https://github.com/johnjeep/learning-cs-journey/blob/master/CloudNative/gRPC/code/StreamServer.cpp"
click node_grpcpb "https://github.com/johnjeep/learning-cs-journey/blob/master/CloudNative/gRPC/code/server_stream.pb.cc"
click node_designpatterns "https://github.com/johnjeep/learning-cs-journey/tree/master/DesignPattern"
click node_robotics "https://github.com/johnjeep/learning-cs-journey/tree/master/Robotics"
click node_qt "https://github.com/johnjeep/learning-cs-journey/tree/master/Qt/Code"
click node_signalwidget "https://github.com/johnjeep/learning-cs-journey/blob/master/Qt/Code/01_SignalSlots/widget.h"
click node_studentheader "https://github.com/johnjeep/learning-cs-journey/blob/master/Qt/Code/01_SignalSlots/student.h"
click node_qtmain "https://github.com/johnjeep/learning-cs-journey/blob/master/Qt/Code/01_SignalSlots/main.cpp"

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_embedded,node_baremetal,node_bsp,node_led,node_cmsis,node_appconfig toneBlue
class node_c,node_cpp,node_myvector,node_myvectorheader,node_myvectormain,node_geometry,node_circleheader,node_pointheader,node_go toneAmber
class node_datastructures,node_os,node_network,node_mysql,node_poolheader,node_mysqlheader,node_pooldemo toneMint
class node_cloud,node_protobuf,node_grpc,node_grpcpb,node_designpatterns,node_robotics,node_qt,node_signalwidget,node_studentheader,node_qtmain toneRose
class node_learner toneIndigo
class node_knowledge toneTeal
```

## Components

### Hardware Foundations

- [Embedded Systems](https://github.com/johnjeep/learning-cs-journey/tree/master/Embedded): `Embedded`
- [Bare-Metal Example](https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-bare-metal-template/F407ZGT6/Src/App/main.c): `Embedded/F407xx/00-bare-metal-template/F407ZGT6/Src/App/main.c`
- [Board Support](https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h): `Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h`
- [LED Support](https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/led.h): `Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/led.h`
- [STM32 Definitions](https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/Libraries/CMSIS/DeviceSupport/stm32f4xx.h): `Embedded/F407xx/00-uc-cos-iii-template/Src/Libraries/CMSIS/DeviceSupport/stm32f4xx.h`
- [RTOS Configuration](https://github.com/johnjeep/learning-cs-journey/blob/master/Embedded/F407xx/00-uc-cos-iii-template/Src/App/app_cfg.h): `Embedded/F407xx/00-uc-cos-iii-template/Src/App/app_cfg.h`

### Languages

- [C Examples](https://github.com/johnjeep/learning-cs-journey/tree/master/C/code): `C/code`
- [C++ Examples](https://github.com/johnjeep/learning-cs-journey/tree/master/Cpp/code): `Cpp/code`
- [MyVector Template](https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/my-vector/MyVector.cpp): `Cpp/code/class/my-vector/MyVector.cpp`
- [MyVector Interface](https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/my-vector/MyVector.h): `Cpp/code/class/my-vector/MyVector.h`
- [MyVector Demo](https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/my-vector/main.cpp): `Cpp/code/class/my-vector/main.cpp`
- [Circle and Point](https://github.com/johnjeep/learning-cs-journey/tree/master/Cpp/code/class/circular_point): `Cpp/code/class/circular_point`
- [Circle Interface](https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/circular_point/circular.h): `Cpp/code/class/circular_point/circular.h`
- [Point Interface](https://github.com/johnjeep/learning-cs-journey/blob/master/Cpp/code/class/circular_point/point.h): `Cpp/code/class/circular_point/point.h`
- [Go Examples](https://github.com/johnjeep/learning-cs-journey/tree/master/Go): `Go`

### Systems

- [Data Structures](https://github.com/johnjeep/learning-cs-journey/tree/master/DataStructure): `DataStructure`
- [Operating Systems](https://github.com/johnjeep/learning-cs-journey/tree/master/OS): `OS`
- [Networking](https://github.com/johnjeep/learning-cs-journey/tree/master/Network): `Network`
- [MySQL Connection Pool](https://github.com/johnjeep/learning-cs-journey/tree/master/MySQL/ConnectPool): `MySQL/ConnectPool`
- [Pool Interface](https://github.com/johnjeep/learning-cs-journey/blob/master/MySQL/ConnectPool/ConnectionPool.h): `MySQL/ConnectPool/ConnectionPool.h`
- [Connection Interface](https://github.com/johnjeep/learning-cs-journey/blob/master/MySQL/ConnectPool/MysqlConn.h): `MySQL/ConnectPool/MysqlConn.h`
- [Pool Demo](https://github.com/johnjeep/learning-cs-journey/blob/master/MySQL/ConnectPool/main.cpp): `MySQL/ConnectPool/main.cpp`

### Applications

- [Cloud Native](https://github.com/johnjeep/learning-cs-journey/tree/master/CloudNative): `CloudNative`
- [Protobuf Schema](https://github.com/johnjeep/learning-cs-journey/blob/master/CloudNative/Probobuf/src/student.proto): `CloudNative/Probobuf/src/student.proto`
- [gRPC Stream Example](https://github.com/johnjeep/learning-cs-journey/blob/master/CloudNative/gRPC/code/StreamServer.cpp): `CloudNative/gRPC/code/StreamServer.cpp`
- [Generated Protobuf Code](https://github.com/johnjeep/learning-cs-journey/blob/master/CloudNative/gRPC/code/server_stream.pb.cc): `CloudNative/gRPC/code/server_stream.pb.cc`
- [Design Patterns](https://github.com/johnjeep/learning-cs-journey/tree/master/DesignPattern): `DesignPattern`
- [Robotics](https://github.com/johnjeep/learning-cs-journey/tree/master/Robotics): `Robotics`
- [Qt Examples](https://github.com/johnjeep/learning-cs-journey/tree/master/Qt/Code): `Qt/Code`
- [Signal Slot Widget](https://github.com/johnjeep/learning-cs-journey/blob/master/Qt/Code/01_SignalSlots/widget.h): `Qt/Code/01_SignalSlots/widget.h`
- [Student Interface](https://github.com/johnjeep/learning-cs-journey/blob/master/Qt/Code/01_SignalSlots/student.h): `Qt/Code/01_SignalSlots/student.h`
- [Signal Slot Entry](https://github.com/johnjeep/learning-cs-journey/blob/master/Qt/Code/01_SignalSlots/main.cpp): `Qt/Code/01_SignalSlots/main.cpp`

### Other components

- **Learner**
- [Knowledge Base](https://github.com/johnjeep/learning-cs-journey/blob/master/README.md): `README.md`

## Connections

- Learner → Knowledge Base: browses map (evidence: `README.md`)
- Knowledge Base → Embedded Systems: documents (evidence: `README.md`)
- Knowledge Base → C Examples: documents (evidence: `README.md`)
- Knowledge Base → C++ Examples: documents (evidence: `README.md`)
- Knowledge Base → Go Examples: documents (evidence: `README.md`)
- Knowledge Base → Data Structures: documents (evidence: `README.md`)
- Knowledge Base → Operating Systems: documents (evidence: `README.md`)
- Knowledge Base → Networking: documents (evidence: `README.md`)
- Knowledge Base → MySQL Connection Pool: documents (evidence: `README.md`)
- Knowledge Base → Cloud Native: documents (evidence: `README.md`)
- Knowledge Base → Design Patterns: documents (evidence: `README.md`)
- Knowledge Base → Robotics: documents (evidence: `README.md`)
- Knowledge Base → Qt Examples: documents (evidence: `README.md`)
- Bare-Metal Example → Board Support: includes (evidence: `Embedded/F407xx/00-bare-metal-template/F407ZGT6/Src/App/main.c`)
- Board Support → LED Support: includes (evidence: `Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h`)
- Board Support → STM32 Definitions: includes (evidence: `Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h`)
- Board Support → RTOS Configuration: includes (evidence: `Embedded/F407xx/00-uc-cos-iii-template/Src/Bsp/bsp.h`)
- MyVector Demo → MyVector Template: uses (evidence: `Cpp/code/class/my-vector/main.cpp`)
- MyVector Demo → MyVector Interface: includes
- Circle and Point → Circle Interface: uses (evidence: `Cpp/code/class/circular_point/main.cpp`)
- Circle and Point → Point Interface: uses (evidence: `Cpp/code/class/circular_point/main.cpp`)
- Pool Demo → Pool Interface: uses (evidence: `MySQL/ConnectPool/main.cpp`)
- Pool Demo → Connection Interface: uses (evidence: `MySQL/ConnectPool/main.cpp`)
- Signal Slot Entry → Signal Slot Widget: creates (evidence: `Qt/Code/01_SignalSlots/main.cpp`)
- Signal Slot Widget → Student Interface: includes (evidence: `Qt/Code/01_SignalSlots/widget.h`)
- gRPC Stream Example → Protobuf Schema: implements
- gRPC Stream Example → Generated Protobuf Code: uses
