# kans23-cloud/task_management_website architecture

> Architecture diagram of the GitHub repository kans23-cloud/task_management_website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kans23-cloud/task_management_website
- Repository: https://github.com/kans23-cloud/task_management_website

## Overview

This is a MERN task-management application. Users register or log in, reach a protected dashboard, and create, view, edit, and delete tasks with status and priority; task changes are also broadcast to connected clients. The graph separates the React experience, HTTP/API handling, authentication and persistence, and real-time updates. Edges are limited to relationships shown in excerpts or documented in the README; unsampled implementation details are not inferred.

Main entry points: [`client/src/App.jsx`](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/App.jsx) (Route application), [`server/server.js`](https://github.com/kans23-cloud/task_management_website/blob/main/server/server.js) (Express server), [`client/src/services/api.js`](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/services/api.js) (API client), [`client/src/pages/Dashboard.jsx`](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/pages/Dashboard.jsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.jsx]"]
  node_protected["Protected route<br/>[ProtectedRoute.jsx]"]
  node_login["Login page<br/>[Login.jsx]"]
  node_register["Register page<br/>[Register.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_navbar["Navigation bar<br/>[Navbar.jsx]"]
  node_taskform["Task form<br/>[TaskForm.jsx]"]
  node_tasklist["Task list<br/>[TaskList.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["HTTP API"]
  node_server["Express server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_taskroutes["Task routes<br/>[taskRoutes.js]"]
end

subgraph group_data["Auth and persistence"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
  node_taskcontroller["Task controller<br/>[taskController.js]"]
  node_authmiddleware["JWT middleware<br/>[authMiddleware.js]"]
  node_user_model[("User model<br/>[User.js]")]
  node_task_model[("Task model<br/>[Task.js]")]
  node_db["Database connector<br/>[db.js]"]
end

subgraph group_realtime["Real-time updates"]
  node_socket_client["Socket client<br/>[socket.js]"]
  node_socket_hub["Socket.IO hub<br/>[server.js]"]
end

node_user(("User"))
node_mongodb[("MongoDB")]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"guards dashboard"| node_protected
node_app -->|"routes to"| node_dashboard
node_login -->|"calls"| node_api_client
node_register -->|"calls"| node_api_client
node_dashboard -->|"renders"| node_navbar
node_dashboard -->|"renders"| node_taskform
node_dashboard -->|"renders"| node_tasklist
node_taskform -->|"creates or updates"| node_api_client
node_tasklist -->|"loads or deletes"| node_api_client
node_api_client -->|"sends API requests"| node_server
node_server -->|"connects"| node_db
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_taskroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_taskroutes -->|"protects routes"| node_authmiddleware
node_taskroutes -->|"dispatches"| node_taskcontroller
node_authcontroller -->|"reads or creates"| node_user_model
node_taskcontroller -->|"manages tasks"| node_task_model
node_db -->|"connects"| node_mongodb
node_server -->|"initializes"| node_socket_hub
node_taskcontroller -->|"emits task events"| node_socket_hub
node_tasklist -->|"subscribes"| node_socket_client
node_socket_client -.->|"receives broadcasts"| node_socket_hub

click node_app "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/App.jsx"
click node_protected "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/ProtectedRoute.jsx"
click node_login "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/pages/Login.jsx"
click node_register "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/pages/Register.jsx"
click node_dashboard "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/pages/Dashboard.jsx"
click node_navbar "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/Navbar.jsx"
click node_taskform "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/TaskForm.jsx"
click node_tasklist "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/TaskList.jsx"
click node_api_client "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/services/api.js"
click node_socket_client "https://github.com/kans23-cloud/task_management_website/blob/main/client/src/socket.js"
click node_server "https://github.com/kans23-cloud/task_management_website/blob/main/server/server.js"
click node_authroutes "https://github.com/kans23-cloud/task_management_website/blob/main/server/routes/authRoutes.js"
click node_taskroutes "https://github.com/kans23-cloud/task_management_website/blob/main/server/routes/taskRoutes.js"
click node_authcontroller "https://github.com/kans23-cloud/task_management_website/blob/main/server/controllers/authController.js"
click node_taskcontroller "https://github.com/kans23-cloud/task_management_website/blob/main/server/controllers/taskController.js"
click node_authmiddleware "https://github.com/kans23-cloud/task_management_website/blob/main/server/middleware/authMiddleware.js"
click node_user_model "https://github.com/kans23-cloud/task_management_website/blob/main/server/models/User.js"
click node_task_model "https://github.com/kans23-cloud/task_management_website/blob/main/server/models/Task.js"
click node_db "https://github.com/kans23-cloud/task_management_website/blob/main/server/config/db.js"
click node_socket_hub "https://github.com/kans23-cloud/task_management_website/blob/main/server/server.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_protected,node_login,node_register,node_dashboard,node_navbar,node_taskform,node_tasklist,node_api_client,node_user toneBlue
class node_server,node_authroutes,node_taskroutes,node_mongodb toneAmber
class node_authcontroller,node_taskcontroller,node_authmiddleware,node_user_model,node_task_model,node_db toneMint
class node_socket_client,node_socket_hub toneRose
```

## Components

### React client

- [Route application](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Protected route](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/ProtectedRoute.jsx): `client/src/components/ProtectedRoute.jsx`
- [Login page](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Register page](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/pages/Register.jsx): `client/src/pages/Register.jsx`
- [Dashboard](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Navigation bar](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/Navbar.jsx): `client/src/components/Navbar.jsx`
- [Task form](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/TaskForm.jsx): `client/src/components/TaskForm.jsx`
- [Task list](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/components/TaskList.jsx): `client/src/components/TaskList.jsx`
- [API client](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/services/api.js): `client/src/services/api.js`

### HTTP API

- [Express server](https://github.com/kans23-cloud/task_management_website/blob/main/server/server.js): `server/server.js`
- [Auth routes](https://github.com/kans23-cloud/task_management_website/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Task routes](https://github.com/kans23-cloud/task_management_website/blob/main/server/routes/taskRoutes.js): `server/routes/taskRoutes.js`

### Auth and persistence

- [Auth controller](https://github.com/kans23-cloud/task_management_website/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Task controller](https://github.com/kans23-cloud/task_management_website/blob/main/server/controllers/taskController.js): `server/controllers/taskController.js`
- [JWT middleware](https://github.com/kans23-cloud/task_management_website/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [User model](https://github.com/kans23-cloud/task_management_website/blob/main/server/models/User.js): `server/models/User.js`
- [Task model](https://github.com/kans23-cloud/task_management_website/blob/main/server/models/Task.js): `server/models/Task.js`
- [Database connector](https://github.com/kans23-cloud/task_management_website/blob/main/server/config/db.js): `server/config/db.js`

### Real-time updates

- [Socket client](https://github.com/kans23-cloud/task_management_website/blob/main/client/src/socket.js): `client/src/socket.js`
- [Socket.IO hub](https://github.com/kans23-cloud/task_management_website/blob/main/server/server.js): `server/server.js`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Route application: uses (evidence: `README.md`)
- Route application → Login page: routes to (evidence: `client/src/App.jsx`)
- Route application → Register page: routes to (evidence: `client/src/App.jsx`)
- Route application → Protected route: guards dashboard (evidence: `client/src/App.jsx`)
- Route application → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Login page → API client: calls (evidence: `client/src/pages/Login.jsx`)
- Register page → API client: calls (evidence: `client/src/pages/Register.jsx`)
- Dashboard → Navigation bar: renders (evidence: `client/src/pages/Dashboard.jsx`)
- Dashboard → Task form: renders (evidence: `client/src/pages/Dashboard.jsx`)
- Dashboard → Task list: renders (evidence: `client/src/pages/Dashboard.jsx`)
- Task form → API client: creates or updates (evidence: `client/src/components/TaskForm.jsx`)
- Task list → API client: loads or deletes (evidence: `client/src/components/TaskList.jsx`)
- API client → Express server: sends API requests (evidence: `README.md`)
- Express server → Database connector: connects (evidence: `server/server.js`)
- Express server → Auth routes: mounts (evidence: `server/server.js`)
- Express server → Task routes: mounts (evidence: `server/server.js`)
- Auth routes → Auth controller: dispatches (evidence: `server/routes/authRoutes.js`)
- Task routes → JWT middleware: protects routes (evidence: `server/routes/taskRoutes.js`)
- Task routes → Task controller: dispatches (evidence: `server/routes/taskRoutes.js`)
- Auth controller → User model: reads or creates (evidence: `server/controllers/authController.js`)
- Task controller → Task model: manages tasks (evidence: `server/controllers/taskController.js`)
- Database connector → MongoDB: connects (evidence: `server/config/db.js`)
- Express server → Socket.IO hub: initializes (evidence: `server/server.js`)
- Task controller → Socket.IO hub: emits task events (evidence: `server/controllers/taskController.js`)
- Task list → Socket client: subscribes (evidence: `client/src/components/TaskList.jsx`)
- Socket client → Socket.IO hub: receives broadcasts (evidence: `README.md`)
