# william-eng/three-tier-kubernetes-app architecture

> Architecture diagram of the GitHub repository william-eng/three-tier-kubernetes-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/william-eng/three-tier-kubernetes-app
- Repository: https://github.com/william-eng/three-tier-kubernetes-app

## Overview

This is a small task manager whose principal workflow is to submit, list, and delete tasks in a React SPA; requests pass through the frontend’s Nginx proxy to FastAPI, which reads or mutates MySQL. The backend separates routing, endpoint logic, database sessions, models, and schemas. Kubernetes manifests document a second major capability: deploying the tiers with configuration, secrets, and persistent MySQL storage. The source excerpts support application-level calls; deployment relationships are based on the README. Monitoring configuration is not mapped because its behavior is not described in the supplied evidence.

Main entry points: [`backend/app/api/v1/endpoints/items.py`](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/api/v1/endpoints/items.py) (Items API), [`frontend/src/pages/Home.jsx`](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/pages/Home.jsx) (Task page), [`backend/app/core/database.py`](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/core/database.py) (DB engine), [`frontend/src/services/apiClient.js`](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/services/apiClient.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app_entry["React entry<br/>[main.jsx]"]
  node_app["App<br/>[App.jsx]"]
  node_home["Task page<br/>[Home.jsx]"]
  node_task_form["Task form<br/>[TaskForm.jsx]"]
  node_task_list["Task list<br/>[TaskList.jsx]"]
  node_task_card["Task card<br/>[TaskCard.jsx]"]
  node_task_state["Task state<br/>[useTasks.js]"]
  node_task_service["Task service<br/>[taskService.js]"]
  node_api_client["API client<br/>[apiClient.js]"]
  node_api_config["API config<br/>[api.js]"]
  node_nginx["Nginx proxy"]
end

subgraph group_backend["Backend"]
  node_backend_api["Items API<br/>[items.py]"]
  node_api_router["API router<br/>[router.py]"]
  node_backend_app["FastAPI app<br/>[main.py]"]
  node_db_dependency["DB session<br/>[dependencies.py]"]
  node_task_schema["Task schema<br/>[task.py]"]
end

subgraph group_data["Data"]
  node_task_model["Task model<br/>[task.py]"]
  node_db_core["DB engine<br/>[database.py]"]
  node_mysql[("MySQL")]
end

subgraph group_deployment["Kubernetes deployment"]
  node_fe_workload["Frontend workload<br/>[deployment.yml]"]
  node_fe_service["Frontend service<br/>[service.yml]"]
  node_be_workload["Backend workload<br/>[deployment.yml]"]
  node_be_service["Backend service<br/>[service.yml]"]
  node_backend_config["Backend config<br/>[ConfigMap.yml]"]
  node_mysql_workload["MySQL StatefulSet<br/>[statefulset.yml]"]
  node_mysql_service["MySQL service"]
  node_mysql_storage[("MySQL storage<br/>[pv.yml]")]
  node_mysql_secret["MySQL secret<br/>[secret.yml]"]
end

node_browser(("Browser"))

node_browser -->|"opens"| node_fe_service
node_fe_service -->|"routes to"| node_fe_workload
node_fe_workload -->|"serves"| node_nginx
node_app_entry -->|"renders"| node_app
node_app -->|"renders"| node_home
node_home -->|"uses"| node_task_state
node_home -->|"renders"| node_task_form
node_home -->|"renders"| node_task_list
node_task_list -->|"renders"| node_task_card
node_task_state -->|"calls"| node_task_service
node_task_service -->|"calls"| node_api_client
node_api_client -->|"reads"| node_api_config
node_api_client -->|"sends API requests"| node_nginx
node_nginx -->|"proxies API"| node_be_service
node_be_service -->|"routes to"| node_be_workload
node_backend_app -->|"registers"| node_api_router
node_api_router -->|"routes to"| node_backend_api
node_backend_api -->|"requests session"| node_db_dependency
node_db_dependency -->|"creates session from"| node_db_core
node_backend_api -->|"queries and mutates"| node_task_model
node_backend_api -->|"validates input with"| node_task_schema
node_task_model -->|"uses base"| node_db_core
node_backend_api -->|"creates tables with"| node_db_core
node_db_core -->|"connects to"| node_mysql
node_mysql_workload -->|"exposed by"| node_mysql_service
node_mysql_workload -->|"persists on"| node_mysql_storage
node_backend_config -.->|"configures"| node_be_workload
node_mysql_secret -.->|"provides credentials to"| node_be_workload
node_mysql_secret -.->|"provides credentials to"| node_mysql_workload

click node_app_entry "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/main.jsx"
click node_app "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/pages/Home.jsx"
click node_task_form "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/components/tasks/TaskForm.jsx"
click node_task_list "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/components/tasks/TaskList.jsx"
click node_task_card "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/components/tasks/TaskCard.jsx"
click node_task_state "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/hooks/useTasks.js"
click node_task_service "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/services/taskService.js"
click node_api_client "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/services/apiClient.js"
click node_api_config "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/constants/api.js"
click node_nginx "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/nginx.conf.template"
click node_backend_api "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/api/v1/endpoints/items.py"
click node_api_router "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/api/v1/router.py"
click node_backend_app "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/main.py"
click node_db_dependency "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/dependencies.py"
click node_task_schema "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/schemas/task.py"
click node_task_model "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/models/task.py"
click node_db_core "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/core/database.py"
click node_fe_workload "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/frontend/deployment.yml"
click node_fe_service "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/frontend/service.yml"
click node_be_workload "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/backend/deployment.yml"
click node_be_service "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/backend/service.yml"
click node_backend_config "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/backend/ConfigMap.yml"
click node_mysql_workload "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/statefulset.yml"
click node_mysql_service "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/headless-service.yml"
click node_mysql_storage "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/pv.yml"
click node_mysql_secret "https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/secret.yml"

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_app_entry,node_app,node_home,node_task_form,node_task_list,node_task_card,node_task_state,node_task_service,node_api_client,node_api_config,node_nginx,node_browser toneBlue
class node_backend_api,node_api_router,node_backend_app,node_db_dependency,node_task_schema toneAmber
class node_task_model,node_db_core,node_mysql toneMint
class node_fe_workload,node_fe_service,node_be_workload,node_be_service,node_backend_config,node_mysql_workload,node_mysql_service,node_mysql_storage,node_mysql_secret toneRose
```

## Components

### Frontend

- [React entry](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [App](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Task page](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/pages/Home.jsx): `frontend/src/pages/Home.jsx`
- [Task form](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/components/tasks/TaskForm.jsx): `frontend/src/components/tasks/TaskForm.jsx`
- [Task list](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/components/tasks/TaskList.jsx): `frontend/src/components/tasks/TaskList.jsx`
- [Task card](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/components/tasks/TaskCard.jsx): `frontend/src/components/tasks/TaskCard.jsx`
- [Task state](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/hooks/useTasks.js): `frontend/src/hooks/useTasks.js`
- [Task service](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/services/taskService.js): `frontend/src/services/taskService.js`
- [API client](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/services/apiClient.js): `frontend/src/services/apiClient.js`
- [API config](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/src/constants/api.js): `frontend/src/constants/api.js`
- [Nginx proxy](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/frontend/nginx.conf.template): `frontend/nginx.conf.template`

### Backend

- [Items API](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/api/v1/endpoints/items.py): `backend/app/api/v1/endpoints/items.py`
- [API router](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`
- [FastAPI app](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/main.py): `backend/app/main.py`
- [DB session](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/dependencies.py): `backend/app/dependencies.py`
- [Task schema](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/schemas/task.py): `backend/app/schemas/task.py`

### Data

- [Task model](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/models/task.py): `backend/app/models/task.py`
- [DB engine](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- **MySQL**

### Kubernetes deployment

- [Frontend workload](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/frontend/deployment.yml): `K8s/frontend/deployment.yml`
- [Frontend service](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/frontend/service.yml): `K8s/frontend/service.yml`
- [Backend workload](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/backend/deployment.yml): `K8s/backend/deployment.yml`
- [Backend service](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/backend/service.yml): `K8s/backend/service.yml`
- [Backend config](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/backend/ConfigMap.yml): `K8s/backend/ConfigMap.yml`
- [MySQL StatefulSet](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/statefulset.yml): `K8s/mysql/statefulset.yml`
- [MySQL service](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/headless-service.yml): `K8s/mysql/headless-service.yml`
- [MySQL storage](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/pv.yml): `K8s/mysql/pv.yml`
- [MySQL secret](https://github.com/william-eng/three-tier-kubernetes-app/blob/main/K8s/mysql/secret.yml): `K8s/mysql/secret.yml`

### Other components

- **Browser**

## Connections

- Browser → Frontend service: opens (evidence: `README.md`)
- Frontend service → Frontend workload: routes to (evidence: `README.md`)
- Frontend workload → Nginx proxy: serves (evidence: `README.md`)
- React entry → App: renders (evidence: `frontend/src/main.jsx`)
- App → Task page: renders (evidence: `frontend/src/App.jsx`)
- Task page → Task state: uses (evidence: `frontend/src/pages/Home.jsx`)
- Task page → Task form: renders (evidence: `frontend/src/pages/Home.jsx`)
- Task page → Task list: renders (evidence: `frontend/src/pages/Home.jsx`)
- Task list → Task card: renders (evidence: `frontend/src/components/tasks/TaskList.jsx`)
- Task state → Task service: calls (evidence: `frontend/src/hooks/useTasks.js`)
- Task service → API client: calls (evidence: `frontend/src/services/taskService.js`)
- API client → API config: reads (evidence: `frontend/src/services/apiClient.js`)
- API client → Nginx proxy: sends API requests (evidence: `README.md`)
- Nginx proxy → Backend service: proxies API (evidence: `README.md`)
- Backend service → Backend workload: routes to (evidence: `README.md`)
- FastAPI app → API router: registers (evidence: `backend/app/main.py`)
- API router → Items API: routes to (evidence: `backend/app/api/v1/router.py`)
- Items API → DB session: requests session (evidence: `backend/app/api/v1/endpoints/items.py`)
- DB session → DB engine: creates session from (evidence: `backend/app/dependencies.py`)
- Items API → Task model: queries and mutates (evidence: `backend/app/api/v1/endpoints/items.py`)
- Items API → Task schema: validates input with (evidence: `backend/app/api/v1/endpoints/items.py`)
- Task model → DB engine: uses base (evidence: `backend/app/models/task.py`)
- Items API → DB engine: creates tables with (evidence: `backend/app/api/v1/endpoints/items.py`)
- DB engine → MySQL: connects to (evidence: `README.md`)
- MySQL StatefulSet → MySQL service: exposed by (evidence: `README.md`)
- MySQL StatefulSet → MySQL storage: persists on (evidence: `README.md`)
- Backend config → Backend workload: configures (evidence: `README.md`)
- MySQL secret → Backend workload: provides credentials to (evidence: `README.md`)
- MySQL secret → MySQL StatefulSet: provides credentials to (evidence: `README.md`)
