# dhyaa-km/task-manager-api architecture

> Architecture diagram of the GitHub repository dhyaa-km/task-manager-api, 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/dhyaa-km/task-manager-api
- Repository: https://github.com/dhyaa-km/task-manager-api

## Overview

Task Manager provides authenticated project and task management, personal progress dashboards, profile management, and administrator user oversight. Users register or sign in, then use protected screens to manage projects and their tasks or review dashboard/profile data; admins have separate guarded views for global statistics and user administration. The React client calls an Express REST API, whose controllers enforce domain operations and persist through Mongoose models in MongoDB. Routes and several central modules were sampled; unsampled features are represented where documented, with only README-supported client/API relationships.

Main entry points: [`client/src/App.tsx`](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/App.tsx) (Route application), [`client/src/services/api.ts`](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/api.ts) (HTTP client), [`server/src/server.js`](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/server.js) (Express API), [`client/src/context/AuthContext.tsx`](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/context/AuthContext.tsx) (Session state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_app["Route application<br/>[App.tsx]"]
  node_api["HTTP client<br/>[api.ts]"]
  node_dashboard["Personal dashboard<br/>[Dashboard.tsx]"]
  node_dashsvc["Dashboard calls"]
end

subgraph group_identity["Identity and access"]
  node_authctx["Session state<br/>[AuthContext.tsx]"]
  node_guards["Route guards<br/>[ProtectedRoute.tsx]"]
  node_adminguard["Admin guard"]
  node_authpages["Sign in/up<br/>[Login.tsx]"]
  node_authsvc["Authentication calls<br/>[authService.ts]"]
  node_profile["Profile management<br/>[Profile.tsx]"]
end

subgraph group_work["Project and task work"]
  node_projects["Project screens<br/>[Projects.tsx]"]
  node_projectdetails["Project details<br/>[ProjectDetails.tsx]"]
  node_projectforms["Project forms<br/>[CreateProject.tsx]"]
  node_projectsvc["Project calls<br/>[projectService.ts]"]
  node_taskpages["Task screens<br/>[TaskDetails.tsx]"]
  node_taskforms["Task forms<br/>[CreateTask.tsx]"]
  node_tasksvc["Task calls<br/>[taskService.ts]"]
end

subgraph group_admin["Admin operations"]
  node_users["Admin user screens<br/>[Users.tsx]"]
  node_userdetails["User details<br/>[UserDetails.tsx]"]
  node_admindash["Admin dashboard<br/>[AdminDashboard.tsx]"]
  node_adminsvc["Admin user calls"]
  node_adminstatsvc["Admin stats calls"]
end

subgraph group_backend["API and persistence"]
  node_server["Express API<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_useroutes["User routes<br/>[userRoutes.js]"]
  node_projectroutes["Project routes<br/>[projectRoutes.js]"]
  node_taskroutes["Task routes<br/>[taskRoutes.js]"]
  node_adminroutes["Admin routes<br/>[adminRoutes.js]"]
  node_authcontroller["Auth operations<br/>[authController.js]"]
  node_usercontroller["User operations<br/>[userController.js]"]
  node_dashboardcontroller["Dashboard stats"]
  node_projectcontroller["Project operations"]
  node_taskcontroller["Task operations<br/>[taskController.js]"]
end

node_person(("User"))

node_person -->|"uses"| node_app
node_app -->|"protects routes"| node_guards
node_app -->|"guards admin"| node_adminguard
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_projects
node_app -->|"routes to"| node_projectdetails
node_app -->|"routes to"| node_projectforms
node_app -->|"routes to"| node_taskpages
node_app -->|"routes to"| node_taskforms
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_admindash
node_app -->|"routes to"| node_users
node_app -->|"routes to"| node_userdetails
node_authctx -->|"calls"| node_authsvc
node_authctx -->|"sets token"| node_api
node_guards -->|"checks session"| node_authctx
node_adminguard -->|"checks role"| node_authctx
node_authpages -.->|"uses session"| node_authctx
node_profile -.->|"loads profile"| node_api
node_dashboard -.->|"loads stats"| node_dashsvc
node_projectdetails -->|"loads project"| node_projectsvc
node_projectdetails -->|"loads tasks"| node_tasksvc
node_projects -.->|"uses"| node_projectsvc
node_projectforms -.->|"uses"| node_projectsvc
node_taskpages -.->|"uses"| node_tasksvc
node_taskforms -.->|"uses"| node_tasksvc
node_users -.->|"uses"| node_adminsvc
node_userdetails -.->|"uses"| node_adminsvc
node_admindash -->|"loads stats"| node_adminstatsvc
node_authsvc -->|"sends requests"| node_api
node_projectsvc -->|"sends requests"| node_api
node_tasksvc -->|"sends requests"| node_api
node_adminsvc -->|"sends requests"| node_api
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_useroutes
node_server -->|"mounts"| node_projectroutes
node_server -->|"mounts"| node_taskroutes
node_server -->|"mounts"| node_adminroutes
node_authroutes -->|"dispatches"| node_authcontroller
node_useroutes -->|"dispatches"| node_usercontroller
node_useroutes -->|"dispatches"| node_dashboardcontroller
node_projectroutes -->|"dispatches"| node_projectcontroller
node_taskroutes -->|"dispatches"| node_taskcontroller
node_adminroutes -.->|"dispatches"| node_adminstatsvc

click node_app "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/App.tsx"
click node_authctx "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/context/AuthContext.tsx"
click node_guards "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/components/ProtectedRoute.tsx"
click node_adminguard "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/components/AdminProtectedRoute.tsx"
click node_authpages "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Login.tsx"
click node_authsvc "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/authService.ts"
click node_api "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/api.ts"
click node_dashboard "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Dashboard.tsx"
click node_dashsvc "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/dashboardService.ts"
click node_projects "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Projects.tsx"
click node_projectdetails "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/ProjectDetails.tsx"
click node_projectforms "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/CreateProject.tsx"
click node_projectsvc "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/projectService.ts"
click node_taskpages "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/TaskDetails.tsx"
click node_taskforms "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/CreateTask.tsx"
click node_tasksvc "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/taskService.ts"
click node_profile "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Profile.tsx"
click node_users "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Users.tsx"
click node_userdetails "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/UserDetails.tsx"
click node_admindash "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/AdminDashboard.tsx"
click node_adminsvc "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/adminUserService.ts"
click node_adminstatsvc "https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/adminDashboardService.ts"
click node_server "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/server.js"
click node_authroutes "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/authRoutes.js"
click node_useroutes "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/userRoutes.js"
click node_projectroutes "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/projectRoutes.js"
click node_taskroutes "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/taskRoutes.js"
click node_adminroutes "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/adminRoutes.js"
click node_authcontroller "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/authController.js"
click node_usercontroller "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/userController.js"
click node_dashboardcontroller "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/dashboardController.js"
click node_projectcontroller "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/projectController.js"
click node_taskcontroller "https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/taskController.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_api,node_dashboard,node_dashsvc,node_person toneBlue
class node_authctx,node_guards,node_adminguard,node_authpages,node_authsvc,node_profile toneAmber
class node_projects,node_projectdetails,node_projectforms,node_projectsvc,node_taskpages,node_taskforms,node_tasksvc toneMint
class node_users,node_userdetails,node_admindash,node_adminsvc,node_adminstatsvc toneRose
class node_server,node_authroutes,node_useroutes,node_projectroutes,node_taskroutes,node_adminroutes,node_authcontroller,node_usercontroller,node_dashboardcontroller,node_projectcontroller,node_taskcontroller toneIndigo
```

## Components

### Client experience

- [Route application](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/App.tsx): `client/src/App.tsx`
- [HTTP client](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/api.ts): `client/src/services/api.ts`
- [Personal dashboard](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Dashboard.tsx): `client/src/pages/Dashboard.tsx`
- [Dashboard calls](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/dashboardService.ts): `client/src/services/dashboardService.ts`

### Identity and access

- [Session state](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/context/AuthContext.tsx): `client/src/context/AuthContext.tsx`
- [Route guards](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/components/ProtectedRoute.tsx): `client/src/components/ProtectedRoute.tsx`
- [Admin guard](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/components/AdminProtectedRoute.tsx): `client/src/components/AdminProtectedRoute.tsx`
- [Sign in/up](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Login.tsx): `client/src/pages/Login.tsx`
- [Authentication calls](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/authService.ts): `client/src/services/authService.ts`
- [Profile management](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Profile.tsx): `client/src/pages/Profile.tsx`

### Project and task work

- [Project screens](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Projects.tsx): `client/src/pages/Projects.tsx`
- [Project details](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/ProjectDetails.tsx): `client/src/pages/ProjectDetails.tsx`
- [Project forms](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/CreateProject.tsx): `client/src/pages/CreateProject.tsx`
- [Project calls](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/projectService.ts): `client/src/services/projectService.ts`
- [Task screens](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/TaskDetails.tsx): `client/src/pages/TaskDetails.tsx`
- [Task forms](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/CreateTask.tsx): `client/src/pages/CreateTask.tsx`
- [Task calls](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/taskService.ts): `client/src/services/taskService.ts`

### Admin operations

- [Admin user screens](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/Users.tsx): `client/src/pages/Users.tsx`
- [User details](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/UserDetails.tsx): `client/src/pages/UserDetails.tsx`
- [Admin dashboard](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/pages/AdminDashboard.tsx): `client/src/pages/AdminDashboard.tsx`
- [Admin user calls](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/adminUserService.ts): `client/src/services/adminUserService.ts`
- [Admin stats calls](https://github.com/dhyaa-km/task-manager-api/blob/main/client/src/services/adminDashboardService.ts): `client/src/services/adminDashboardService.ts`

### API and persistence

- [Express API](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/server.js): `server/src/server.js`
- [Auth routes](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/authRoutes.js): `server/src/routes/api/authRoutes.js`
- [User routes](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/userRoutes.js): `server/src/routes/api/userRoutes.js`
- [Project routes](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/projectRoutes.js): `server/src/routes/api/projectRoutes.js`
- [Task routes](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/taskRoutes.js): `server/src/routes/api/taskRoutes.js`
- [Admin routes](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/routes/api/adminRoutes.js): `server/src/routes/api/adminRoutes.js`
- [Auth operations](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [User operations](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/userController.js): `server/src/controllers/userController.js`
- [Dashboard stats](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/dashboardController.js): `server/src/controllers/dashboardController.js`
- [Project operations](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/projectController.js): `server/src/controllers/projectController.js`
- [Task operations](https://github.com/dhyaa-km/task-manager-api/blob/main/server/src/controllers/taskController.js): `server/src/controllers/taskController.js`

### Other components

- **User**

## Connections

- User → Route application: uses
- Route application → Route guards: protects routes (evidence: `client/src/App.tsx`)
- Route application → Admin guard: guards admin (evidence: `client/src/App.tsx`)
- Route application → Sign in/up: routes to (evidence: `client/src/App.tsx`)
- Route application → Personal dashboard: routes to (evidence: `client/src/App.tsx`)
- Route application → Project screens: routes to (evidence: `client/src/App.tsx`)
- Route application → Project details: routes to (evidence: `client/src/App.tsx`)
- Route application → Project forms: routes to (evidence: `client/src/App.tsx`)
- Route application → Task screens: routes to (evidence: `client/src/App.tsx`)
- Route application → Task forms: routes to (evidence: `client/src/App.tsx`)
- Route application → Profile management: routes to (evidence: `client/src/App.tsx`)
- Route application → Admin dashboard: routes to (evidence: `client/src/App.tsx`)
- Route application → Admin user screens: routes to (evidence: `client/src/App.tsx`)
- Route application → User details: routes to (evidence: `client/src/App.tsx`)
- Session state → Authentication calls: calls (evidence: `client/src/context/AuthContext.tsx`)
- Session state → HTTP client: sets token (evidence: `client/src/context/AuthContext.tsx`)
- Route guards → Session state: checks session (evidence: `client/src/components/ProtectedRoute.tsx`)
- Admin guard → Session state: checks role (evidence: `client/src/components/AdminProtectedRoute.tsx`)
- Sign in/up → Session state: uses session
- Profile management → HTTP client: loads profile
- Personal dashboard → Dashboard calls: loads stats
- Project details → Project calls: loads project (evidence: `client/src/pages/ProjectDetails.tsx`)
- Project details → Task calls: loads tasks (evidence: `client/src/pages/ProjectDetails.tsx`)
- Project screens → Project calls: uses
- Project forms → Project calls: uses
- Task screens → Task calls: uses
- Task forms → Task calls: uses
- Admin user screens → Admin user calls: uses
- User details → Admin user calls: uses
- Admin dashboard → Admin stats calls: loads stats (evidence: `client/src/pages/AdminDashboard.tsx`)
- Authentication calls → HTTP client: sends requests (evidence: `client/src/services/authService.ts`)
- Project calls → HTTP client: sends requests (evidence: `client/src/services/projectService.ts`)
- Task calls → HTTP client: sends requests (evidence: `client/src/services/taskService.ts`)
- Admin user calls → HTTP client: sends requests (evidence: `client/src/services/adminUserService.ts`)
- Express API → Auth routes: mounts (evidence: `server/src/server.js`)
- Express API → User routes: mounts (evidence: `server/src/server.js`)
- Express API → Project routes: mounts (evidence: `server/src/server.js`)
- Express API → Task routes: mounts (evidence: `server/src/server.js`)
- Express API → Admin routes: mounts (evidence: `server/src/server.js`)
- Auth routes → Auth operations: dispatches (evidence: `server/src/routes/api/authRoutes.js`)
- User routes → User operations: dispatches (evidence: `server/src/routes/api/userRoutes.js`)
- User routes → Dashboard stats: dispatches (evidence: `server/src/routes/api/userRoutes.js`)
- Project routes → Project operations: dispatches (evidence: `server/src/routes/api/projectRoutes.js`)
- Task routes → Task operations: dispatches (evidence: `server/src/routes/api/taskRoutes.js`)
- Admin routes → Admin stats calls: dispatches
