# ndleah/python-mini-project architecture

> Architecture diagram of the GitHub repository ndleah/python-mini-project, 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/ndleah/python-mini-project
- Repository: https://github.com/ndleah/python-mini-project

## Overview

This repository is a learning playground of independent Python mini-projects, not one integrated application. Its README describes contributors adding projects, while the source tree shows standalone games, utilities, and small apps with separate entry points. The graph highlights sampled end-to-end workflows and preserves the documented collection breadth without implying shared runtime infrastructure. Some branches are represented only at their exact project directory because their source was not sampled; no relationships are inferred for them.

Main entry points: [`GK_Maestro/main.py`](https://github.com/ndleah/python-mini-project/blob/main/GK_Maestro/main.py) (GK Maestro), [`Othello-Reversi-Game/main.py`](https://github.com/ndleah/python-mini-project/blob/main/Othello-Reversi-Game/main.py) (Othello game UI), [`digit-recognizer/app/routes.py`](https://github.com/ndleah/python-mini-project/blob/main/digit-recognizer/app/routes.py) (Prediction routes), [`Firebase_Authentication_Using_Flask/main.py`](https://github.com/ndleah/python-mini-project/blob/main/Firebase_Authentication_Using_Flask/main.py) (Authentication app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Games and learning"]
  node_collection["Python projects"]
  node_gk["GK Maestro<br/>[main.py]"]
  node_questions["Question bank<br/>[question_bank.py]"]
  node_answers["Answer bank<br/>[answer_bank.py]"]
  node_othello["Othello game UI<br/>[main.py]"]
  node_board["Board rules<br/>[Board.py]"]
  node_other_games["Other games"]
end

subgraph group_apps["Interactive apps"]
  node_flash_app["Flashcard UI<br/>[app.py]"]
  node_flash_other["Flashcard app"]
  node_digit_routes["Prediction routes<br/>[routes.py]"]
  node_predictors["Digit predictors<br/>[predictors.py]"]
  node_auth_app["Authentication app<br/>[main.py]"]
  node_firebase["Firebase auth client<br/>[db.py]"]
  node_rss_app["RSS web app<br/>[main.py]"]
  node_rss_utils["Feed operations<br/>[utils.py]"]
  node_other_apps["Other applications"]
end

subgraph group_tools["Utilities and data"]
  node_ip_menu["IP locator menu<br/>[main.py]"]
  node_ip_tools["IP lookup tools<br/>[LocateIP.py]"]
  node_other_tools["Other utilities<br/>[converter.py]"]
end

node_contributor(("Project contributor"))

node_contributor -->|"adds projects"| node_collection
node_collection -->|"includes"| node_gk
node_collection -->|"includes"| node_othello
node_collection -->|"includes games"| node_other_games
node_collection -->|"includes"| node_flash_app
node_collection -->|"includes"| node_digit_routes
node_collection -->|"includes"| node_auth_app
node_collection -->|"includes"| node_rss_app
node_collection -->|"includes apps"| node_other_apps
node_collection -->|"includes"| node_ip_menu
node_collection -->|"includes utilities"| node_other_tools
node_gk -->|"selects questions"| node_questions
node_gk -->|"checks answers"| node_answers
node_othello -->|"queries and updates"| node_board
node_ip_menu -->|"dispatches lookups"| node_ip_tools
node_auth_app -->|"authenticates users"| node_firebase
node_digit_routes -->|"requests predictions"| node_predictors
node_rss_app -->|"manages feeds"| node_rss_utils

click node_gk "https://github.com/ndleah/python-mini-project/blob/main/GK_Maestro/main.py"
click node_questions "https://github.com/ndleah/python-mini-project/blob/main/GK_Maestro/question_bank.py"
click node_answers "https://github.com/ndleah/python-mini-project/blob/main/GK_Maestro/answer_bank.py"
click node_othello "https://github.com/ndleah/python-mini-project/blob/main/Othello-Reversi-Game/main.py"
click node_board "https://github.com/ndleah/python-mini-project/blob/main/Othello-Reversi-Game/Board.py"
click node_other_games "https://github.com/ndleah/python-mini-project/tree/main/Snake_game"
click node_flash_app "https://github.com/ndleah/python-mini-project/blob/main/Chinese_FlashCard/app/app.py"
click node_flash_other "https://github.com/ndleah/python-mini-project/tree/main/Chinese_FlashCard/app"
click node_digit_routes "https://github.com/ndleah/python-mini-project/blob/main/digit-recognizer/app/routes.py"
click node_predictors "https://github.com/ndleah/python-mini-project/blob/main/digit-recognizer/app/predictors.py"
click node_auth_app "https://github.com/ndleah/python-mini-project/blob/main/Firebase_Authentication_Using_Flask/main.py"
click node_firebase "https://github.com/ndleah/python-mini-project/blob/main/Firebase_Authentication_Using_Flask/db.py"
click node_rss_app "https://github.com/ndleah/python-mini-project/blob/main/RSS_Manager/main.py"
click node_rss_utils "https://github.com/ndleah/python-mini-project/blob/main/RSS_Manager/utils.py"
click node_other_apps "https://github.com/ndleah/python-mini-project/blob/main/website-builder/app/routes/portfolio_routes.py"
click node_ip_menu "https://github.com/ndleah/python-mini-project/blob/main/IP_Locator/main.py"
click node_ip_tools "https://github.com/ndleah/python-mini-project/blob/main/IP_Locator/LocateIP.py"
click node_other_tools "https://github.com/ndleah/python-mini-project/blob/main/Converter/converter.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_collection,node_gk,node_questions,node_answers,node_othello,node_board,node_other_games toneBlue
class node_flash_app,node_flash_other,node_digit_routes,node_predictors,node_auth_app,node_firebase,node_rss_app,node_rss_utils,node_other_apps toneAmber
class node_ip_menu,node_ip_tools,node_other_tools toneMint
class node_contributor toneIndigo
```

## Components

### Games and learning

- **Python projects**
- [GK Maestro](https://github.com/ndleah/python-mini-project/blob/main/GK_Maestro/main.py): `GK_Maestro/main.py`
- [Question bank](https://github.com/ndleah/python-mini-project/blob/main/GK_Maestro/question_bank.py): `GK_Maestro/question_bank.py`
- [Answer bank](https://github.com/ndleah/python-mini-project/blob/main/GK_Maestro/answer_bank.py): `GK_Maestro/answer_bank.py`
- [Othello game UI](https://github.com/ndleah/python-mini-project/blob/main/Othello-Reversi-Game/main.py): `Othello-Reversi-Game/main.py`
- [Board rules](https://github.com/ndleah/python-mini-project/blob/main/Othello-Reversi-Game/Board.py): `Othello-Reversi-Game/Board.py`
- [Other games](https://github.com/ndleah/python-mini-project/tree/main/Snake_game): `Snake_game`

### Interactive apps

- [Flashcard UI](https://github.com/ndleah/python-mini-project/blob/main/Chinese_FlashCard/app/app.py): `Chinese_FlashCard/app/app.py`
- [Flashcard app](https://github.com/ndleah/python-mini-project/tree/main/Chinese_FlashCard/app): `Chinese_FlashCard/app`
- [Prediction routes](https://github.com/ndleah/python-mini-project/blob/main/digit-recognizer/app/routes.py): `digit-recognizer/app/routes.py`
- [Digit predictors](https://github.com/ndleah/python-mini-project/blob/main/digit-recognizer/app/predictors.py): `digit-recognizer/app/predictors.py`
- [Authentication app](https://github.com/ndleah/python-mini-project/blob/main/Firebase_Authentication_Using_Flask/main.py): `Firebase_Authentication_Using_Flask/main.py`
- [Firebase auth client](https://github.com/ndleah/python-mini-project/blob/main/Firebase_Authentication_Using_Flask/db.py): `Firebase_Authentication_Using_Flask/db.py`
- [RSS web app](https://github.com/ndleah/python-mini-project/blob/main/RSS_Manager/main.py): `RSS_Manager/main.py`
- [Feed operations](https://github.com/ndleah/python-mini-project/blob/main/RSS_Manager/utils.py): `RSS_Manager/utils.py`
- [Other applications](https://github.com/ndleah/python-mini-project/blob/main/website-builder/app/routes/portfolio_routes.py): `website-builder/app/routes/portfolio_routes.py`

### Utilities and data

- [IP locator menu](https://github.com/ndleah/python-mini-project/blob/main/IP_Locator/main.py): `IP_Locator/main.py`
- [IP lookup tools](https://github.com/ndleah/python-mini-project/blob/main/IP_Locator/LocateIP.py): `IP_Locator/LocateIP.py`
- [Other utilities](https://github.com/ndleah/python-mini-project/blob/main/Converter/converter.py): `Converter/converter.py`

### Other components

- **Project contributor**

## Connections

- Project contributor → Python projects: adds projects (evidence: `README.md`)
- Python projects → GK Maestro: includes (evidence: `README.md`)
- Python projects → Othello game UI: includes (evidence: `README.md`)
- Python projects → Other games: includes games (evidence: `README.md`)
- Python projects → Flashcard UI: includes (evidence: `README.md`)
- Python projects → Prediction routes: includes (evidence: `README.md`)
- Python projects → Authentication app: includes (evidence: `README.md`)
- Python projects → RSS web app: includes (evidence: `README.md`)
- Python projects → Other applications: includes apps (evidence: `README.md`)
- Python projects → IP locator menu: includes (evidence: `README.md`)
- Python projects → Other utilities: includes utilities (evidence: `README.md`)
- GK Maestro → Question bank: selects questions (evidence: `GK_Maestro/main.py`)
- GK Maestro → Answer bank: checks answers (evidence: `GK_Maestro/main.py`)
- Othello game UI → Board rules: queries and updates (evidence: `Othello-Reversi-Game/main.py`)
- IP locator menu → IP lookup tools: dispatches lookups (evidence: `IP_Locator/main.py`)
- Authentication app → Firebase auth client: authenticates users (evidence: `Firebase_Authentication_Using_Flask/main.py`)
- Prediction routes → Digit predictors: requests predictions (evidence: `digit-recognizer/app/routes.py`)
- RSS web app → Feed operations: manages feeds (evidence: `RSS_Manager/main.py`)
