# lavank179/todo-app-kubernetes architecture

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

- Interactive diagram: https://gitdiagram.com/lavank179/todo-app-kubernetes
- Repository: https://github.com/lavank179/todo-app-kubernetes

## Overview

This is a to-do list application: users view, add, complete, and delete tasks in a React UI that calls the FastAPI task API, which persists task records through SQLAlchemy to PostgreSQL. The tree also contains a legacy Express/Mongoose implementation, plus video-streaming and CPU-stress endpoints. The graph shows the current Python path and legacy path separately; deployment files and unsampled integrations are omitted. Edges reflect only calls and routes visible in excerpts or the source index.

Main entry points: [`backend/app.py`](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/app.py) (API entry), [`backend/legacy-node/index.js`](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/index.js) (Express entry), [`backend/utils/db.py`](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/db.py) (DB sessions), [`backend/routers/task_router.py`](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/routers/task_router.py) (Task routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app["Task interface<br/>[App.js]"]
  node_task_logic["Task actions<br/>[Tasks.js]"]
  node_task_client["Task API client<br/>[taskServices.js]"]
end

subgraph group_python["FastAPI service"]
  node_fastapi_app["API entry<br/>[app.py]"]
  node_task_routes["Task routes<br/>[task_router.py]"]
  node_task_model["Task model<br/>[models.py]"]
  node_db_session["DB sessions<br/>[db.py]"]
end

subgraph group_legacy["Legacy Express service"]
  node_legacy_entry["Express entry<br/>[index.js]"]
  node_legacy_routes["Task routes<br/>[tasks.js]"]
  node_legacy_model["Task model<br/>[task.js]"]
  node_mongo_connection["Mongo connection<br/>[db.js]"]
  node_legacy_stress["CPU stress<br/>[stress.js]"]
  node_legacy_logger["Node logger<br/>[logger.js]"]
end

subgraph group_support["Runtime support"]
  node_config["Configuration<br/>[config.py]"]
  node_video["Video streamer<br/>[video_streamer.py]"]
  node_stress["CPU stress<br/>[stress.py]"]
  node_py_logger["Python logger<br/>[logger.py]"]
end

node_user(("User"))
node_postgres[("PostgreSQL")]
node_mongo[("MongoDB")]
node_video_client(("Video client"))
node_load_client(("Stress client"))

node_user -->|"uses"| node_app
node_app -->|"extends"| node_task_logic
node_task_logic -->|"calls"| node_task_client
node_task_client -.->|"HTTP requests"| node_fastapi_app
node_fastapi_app -->|"routes tasks"| node_task_routes
node_task_routes -->|"queries"| node_task_model
node_task_routes -->|"uses session"| node_db_session
node_task_model -->|"uses base"| node_db_session
node_db_session -->|"reads settings"| node_config
node_db_session -.->|"connects"| node_postgres
node_video_client -.->|"requests video"| node_fastapi_app
node_fastapi_app -->|"streams video"| node_video
node_load_client -.->|"requests stress"| node_fastapi_app
node_fastapi_app -->|"runs stress"| node_stress
node_fastapi_app -->|"logs errors"| node_py_logger
node_legacy_entry -->|"mounts routes"| node_legacy_routes
node_legacy_routes -->|"queries"| node_legacy_model
node_legacy_entry -->|"connects"| node_mongo_connection
node_mongo_connection -.->|"connects"| node_mongo
node_legacy_entry -->|"runs stress"| node_legacy_stress
node_legacy_entry -->|"logs startup"| node_legacy_logger
node_mongo_connection -->|"logs connection"| node_legacy_logger

click node_app "https://github.com/lavank179/todo-app-kubernetes/blob/main/frontend/src/App.js"
click node_task_logic "https://github.com/lavank179/todo-app-kubernetes/blob/main/frontend/src/Tasks.js"
click node_task_client "https://github.com/lavank179/todo-app-kubernetes/blob/main/frontend/src/services/taskServices.js"
click node_fastapi_app "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/app.py"
click node_task_routes "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/routers/task_router.py"
click node_task_model "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/models/models.py"
click node_db_session "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/db.py"
click node_config "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/config.py"
click node_video "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/video_streamer.py"
click node_stress "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/stress.py"
click node_py_logger "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/logger.py"
click node_legacy_entry "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/index.js"
click node_legacy_routes "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/routes/tasks.js"
click node_legacy_model "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/models/task.js"
click node_mongo_connection "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/utils/db.js"
click node_legacy_stress "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/utils/stress.js"
click node_legacy_logger "https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/utils/logger.js"

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,node_task_logic,node_task_client,node_user,node_video_client,node_load_client toneBlue
class node_fastapi_app,node_task_routes,node_task_model,node_db_session,node_postgres,node_mongo toneAmber
class node_legacy_entry,node_legacy_routes,node_legacy_model,node_mongo_connection,node_legacy_stress,node_legacy_logger toneMint
class node_config,node_video,node_stress,node_py_logger toneRose
```

## Components

### Web interface

- [Task interface](https://github.com/lavank179/todo-app-kubernetes/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Task actions](https://github.com/lavank179/todo-app-kubernetes/blob/main/frontend/src/Tasks.js): `frontend/src/Tasks.js`
- [Task API client](https://github.com/lavank179/todo-app-kubernetes/blob/main/frontend/src/services/taskServices.js): `frontend/src/services/taskServices.js`

### FastAPI service

- [API entry](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/app.py): `backend/app.py`
- [Task routes](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/routers/task_router.py): `backend/routers/task_router.py`
- [Task model](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/models/models.py): `backend/models/models.py`
- [DB sessions](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/db.py): `backend/utils/db.py`

### Legacy Express service

- [Express entry](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/index.js): `backend/legacy-node/index.js`
- [Task routes](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/routes/tasks.js): `backend/legacy-node/routes/tasks.js`
- [Task model](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/models/task.js): `backend/legacy-node/models/task.js`
- [Mongo connection](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/utils/db.js): `backend/legacy-node/utils/db.js`
- [CPU stress](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/utils/stress.js): `backend/legacy-node/utils/stress.js`
- [Node logger](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/legacy-node/utils/logger.js): `backend/legacy-node/utils/logger.js`

### Runtime support

- [Configuration](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/config.py): `backend/utils/config.py`
- [Video streamer](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/video_streamer.py): `backend/utils/video_streamer.py`
- [CPU stress](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/stress.py): `backend/utils/stress.py`
- [Python logger](https://github.com/lavank179/todo-app-kubernetes/blob/main/backend/utils/logger.py): `backend/utils/logger.py`

### Other components

- **User**
- **PostgreSQL**
- **MongoDB**
- **Video client**
- **Stress client**

## Connections

- User → Task interface: uses (evidence: `frontend/src/App.js`)
- Task interface → Task actions: extends (evidence: `frontend/src/App.js`)
- Task actions → Task API client: calls (evidence: `frontend/src/Tasks.js`)
- Task API client → API entry: HTTP requests (evidence: `frontend/src/services/taskServices.js`)
- API entry → Task routes: routes tasks (evidence: `backend/app.py`)
- Task routes → Task model: queries (evidence: `backend/routers/task_router.py`)
- Task routes → DB sessions: uses session (evidence: `backend/routers/task_router.py`)
- Task model → DB sessions: uses base (evidence: `backend/models/models.py`)
- DB sessions → Configuration: reads settings (evidence: `backend/utils/db.py`)
- DB sessions → PostgreSQL: connects
- Video client → API entry: requests video
- API entry → Video streamer: streams video (evidence: `backend/app.py`)
- Stress client → API entry: requests stress
- API entry → CPU stress: runs stress (evidence: `backend/app.py`)
- API entry → Python logger: logs errors (evidence: `backend/app.py`)
- Express entry → Task routes: mounts routes (evidence: `backend/legacy-node/index.js`)
- Task routes → Task model: queries (evidence: `backend/legacy-node/routes/tasks.js`)
- Express entry → Mongo connection: connects (evidence: `backend/legacy-node/index.js`)
- Mongo connection → MongoDB: connects
- Express entry → CPU stress: runs stress (evidence: `backend/legacy-node/index.js`)
- Express entry → Node logger: logs startup (evidence: `backend/legacy-node/index.js`)
- Mongo connection → Node logger: logs connection (evidence: `backend/legacy-node/utils/db.js`)
