# mathewpaul2109/nesa-task-management architecture

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

- Interactive diagram: https://gitdiagram.com/mathewpaul2109/nesa-task-management
- Repository: https://github.com/mathewpaul2109/nesa-task-management

## Overview

Nesa Task Management supports role-based project and task administration: users sign in, view assigned work or manage projects, update tasks and comments, and administrators handle users, logs, and archived records. The frontend routes pages through Redux feature state and an API client; the Express backend routes requests through controllers and domain services to MongoDB repositories. The README also documents email configuration. Several feature modules were not excerpted, so their internal call relationships are omitted; the frontend-to-backend HTTP link is shown as unverified.

Main entry points: [`frontend/src/app/store.js`](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/app/store.js) (Redux store), [`frontend/src/App.jsx`](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/App.jsx) (Route application), [`backend/services/TaskService.js`](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/TaskService.js) (Task service), [`backend/services/ProjectService.js`](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/ProjectService.js) (Project service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Route application<br/>[App.jsx]"]
  node_authpages["Sign-in pages<br/>[Login.jsx]"]
  node_adminpages["Admin workspace<br/>[AdminDashboard.jsx]"]
  node_userpages["User workspace<br/>[MyTasks.jsx]"]
  node_projectmodal["Project editor<br/>[ProjectModal.jsx]"]
  node_taskmodal["Task editor<br/>[TaskModal.jsx]"]
  node_store["Redux store<br/>[store.js]"]
  node_authslice["Auth state<br/>[authSlice.js]"]
  node_projectslice["Project state<br/>[projectSlice.js]"]
  node_taskslice["Task state<br/>[taskSlice.js]"]
  node_commentslice["Comment state<br/>[commentSlice.js]"]
  node_client["HTTP client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.js]"]
  node_routes["API routes<br/>[taskRoutes.js]"]
  node_authmw["Authentication gate<br/>[authMiddleware.js]"]
  node_taskcontroller["Task controller<br/>[taskController.js]"]
  node_projectcontroller["Project controller"]
  node_commentcontroller["Comment controller"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
end

subgraph group_domain["Work management"]
  node_taskservice["Task service<br/>[TaskService.js]"]
  node_projectservice["Project service<br/>[ProjectService.js]"]
  node_commentservice["Comment service<br/>[CommentService.js]"]
end

subgraph group_identity["Identity and audit"]
  node_authservice["Auth service<br/>[AuthService.js]"]
  node_logger["Action logger<br/>[logger.js]"]
end

subgraph group_persistence["MongoDB persistence"]
  node_taskrepo["Task repository<br/>[TaskRepository.js]"]
  node_projectrepo["Project repository"]
  node_userrepo["User repository<br/>[UserRepository.js]"]
  node_commentrepo["Comment repository"]
  node_logrepo["Log repository<br/>[LogRepository.js]"]
  node_taskmodel[("Task records<br/>[Task.js]")]
  node_projectmodel[("Project records<br/>[Project.js]")]
  node_usermodel[("User records<br/>[User.js]")]
end

node_visitor(("User / admin"))
node_mongodb[("MongoDB<br/>database")]

node_visitor -->|"opens"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_adminpages
node_app -->|"routes to"| node_userpages
node_adminpages -->|"opens"| node_projectmodal
node_adminpages -->|"opens"| node_taskmodal
node_userpages -->|"opens"| node_taskmodal
node_taskmodal -->|"dispatches"| node_commentslice
node_taskmodal -->|"dispatches"| node_taskslice
node_store -->|"registers"| node_authslice
node_store -->|"registers"| node_projectslice
node_store -->|"registers"| node_taskslice
node_store -->|"registers"| node_commentslice
node_authpages -->|"dispatches"| node_authslice
node_taskslice -->|"requests through"| node_client
node_client -.->|"HTTP requests"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -->|"dispatches"| node_taskcontroller
node_routes -->|"protects routes"| node_authmw
node_taskcontroller -->|"delegates"| node_taskservice
node_projectcontroller -->|"delegates"| node_projectservice
node_commentcontroller -->|"delegates"| node_commentservice
node_authcontroller -->|"delegates"| node_authservice
node_taskservice -->|"queries"| node_taskrepo
node_taskservice -->|"queries"| node_projectrepo
node_taskservice -->|"queries"| node_userrepo
node_projectservice -->|"queries"| node_projectrepo
node_projectservice -->|"queries"| node_taskrepo
node_projectservice -->|"queries"| node_userrepo
node_commentservice -->|"queries"| node_taskrepo
node_commentservice -->|"queries"| node_commentrepo
node_authservice -->|"queries"| node_userrepo
node_authservice -->|"records actions"| node_logger
node_logger -->|"writes logs"| node_logrepo
node_taskrepo -->|"reads / writes"| node_taskmodel
node_projectrepo -->|"reads / writes"| node_projectmodel
node_userrepo -->|"reads / writes"| node_usermodel
node_server -->|"connects"| node_mongodb

click node_app "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/App.jsx"
click node_authpages "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/Login.jsx"
click node_adminpages "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/admin/AdminDashboard.jsx"
click node_userpages "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/user/MyTasks.jsx"
click node_projectmodal "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/admin/ProjectModal.jsx"
click node_taskmodal "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/user/TaskModal.jsx"
click node_store "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/app/store.js"
click node_authslice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/auth/authSlice.js"
click node_projectslice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/projects/projectSlice.js"
click node_taskslice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/tasks/taskSlice.js"
click node_commentslice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/comments/commentSlice.js"
click node_client "https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/services/api.js"
click node_server "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/server.js"
click node_routes "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/routes/taskRoutes.js"
click node_authmw "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/middleware/authMiddleware.js"
click node_taskcontroller "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/taskController.js"
click node_taskservice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/TaskService.js"
click node_projectcontroller "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/projectController.js"
click node_projectservice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/ProjectService.js"
click node_commentcontroller "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/commentController.js"
click node_commentservice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/CommentService.js"
click node_authcontroller "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/authController.js"
click node_authservice "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/AuthService.js"
click node_logger "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/utils/logger.js"
click node_taskrepo "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/TaskRepository.js"
click node_projectrepo "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/ProjectRepository.js"
click node_userrepo "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/UserRepository.js"
click node_commentrepo "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/CommentRepository.js"
click node_logrepo "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/LogRepository.js"
click node_taskmodel "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/models/Task.js"
click node_projectmodel "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/models/Project.js"
click node_usermodel "https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/models/User.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_authpages,node_adminpages,node_userpages,node_projectmodal,node_taskmodal,node_store,node_authslice,node_projectslice,node_taskslice,node_commentslice,node_client,node_visitor toneBlue
class node_server,node_routes,node_authmw,node_taskcontroller,node_projectcontroller,node_commentcontroller,node_authcontroller,node_mongodb toneAmber
class node_taskservice,node_projectservice,node_commentservice toneMint
class node_authservice,node_logger toneRose
class node_taskrepo,node_projectrepo,node_userrepo,node_commentrepo,node_logrepo,node_taskmodel,node_projectmodel,node_usermodel toneIndigo
```

## Components

### Web application

- [Route application](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign-in pages](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Admin workspace](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/admin/AdminDashboard.jsx): `frontend/src/pages/admin/AdminDashboard.jsx`
- [User workspace](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/user/MyTasks.jsx): `frontend/src/pages/user/MyTasks.jsx`
- [Project editor](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/admin/ProjectModal.jsx): `frontend/src/pages/admin/ProjectModal.jsx`
- [Task editor](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/pages/user/TaskModal.jsx): `frontend/src/pages/user/TaskModal.jsx`
- [Redux store](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/app/store.js): `frontend/src/app/store.js`
- [Auth state](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/auth/authSlice.js): `frontend/src/features/auth/authSlice.js`
- [Project state](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/projects/projectSlice.js): `frontend/src/features/projects/projectSlice.js`
- [Task state](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/tasks/taskSlice.js): `frontend/src/features/tasks/taskSlice.js`
- [Comment state](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/features/comments/commentSlice.js): `frontend/src/features/comments/commentSlice.js`
- [HTTP client](https://github.com/mathewpaul2109/nesa-task-management/blob/master/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and access

- [Express server](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/server.js): `backend/server.js`
- [API routes](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/routes/taskRoutes.js): `backend/routes/taskRoutes.js`
- [Authentication gate](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Task controller](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/taskController.js): `backend/controllers/taskController.js`
- [Project controller](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/projectController.js): `backend/controllers/projectController.js`
- [Comment controller](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/commentController.js): `backend/controllers/commentController.js`
- [Auth controller](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/controllers/authController.js): `backend/controllers/authController.js`

### Work management

- [Task service](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/TaskService.js): `backend/services/TaskService.js`
- [Project service](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/ProjectService.js): `backend/services/ProjectService.js`
- [Comment service](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/CommentService.js): `backend/services/CommentService.js`

### Identity and audit

- [Auth service](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/services/AuthService.js): `backend/services/AuthService.js`
- [Action logger](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/utils/logger.js): `backend/utils/logger.js`

### MongoDB persistence

- [Task repository](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/TaskRepository.js): `backend/repositories/TaskRepository.js`
- [Project repository](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/ProjectRepository.js): `backend/repositories/ProjectRepository.js`
- [User repository](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/UserRepository.js): `backend/repositories/UserRepository.js`
- [Comment repository](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/CommentRepository.js): `backend/repositories/CommentRepository.js`
- [Log repository](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/repositories/LogRepository.js): `backend/repositories/LogRepository.js`
- [Task records](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/models/Task.js): `backend/models/Task.js`
- [Project records](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/models/Project.js): `backend/models/Project.js`
- [User records](https://github.com/mathewpaul2109/nesa-task-management/blob/master/backend/models/User.js): `backend/models/User.js`

### Other components

- **User / admin**
- **MongoDB**: database

## Connections

- User / admin → Route application: opens (evidence: `frontend/src/App.jsx`)
- Route application → Sign-in pages: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Admin workspace: routes to (evidence: `frontend/src/App.jsx`)
- Route application → User workspace: routes to (evidence: `frontend/src/App.jsx`)
- Admin workspace → Project editor: opens (evidence: `frontend/src/pages/admin/AdminDashboard.jsx`)
- Admin workspace → Task editor: opens (evidence: `frontend/src/pages/admin/AdminDashboard.jsx`)
- User workspace → Task editor: opens (evidence: `frontend/src/pages/user/MyTasks.jsx`)
- Task editor → Comment state: dispatches (evidence: `frontend/src/pages/user/TaskModal.jsx`)
- Task editor → Task state: dispatches (evidence: `frontend/src/pages/user/TaskModal.jsx`)
- Redux store → Auth state: registers (evidence: `frontend/src/app/store.js`)
- Redux store → Project state: registers (evidence: `frontend/src/app/store.js`)
- Redux store → Task state: registers (evidence: `frontend/src/app/store.js`)
- Redux store → Comment state: registers (evidence: `frontend/src/app/store.js`)
- Sign-in pages → Auth state: dispatches (evidence: `frontend/src/pages/Login.jsx`)
- Task state → HTTP client: requests through (evidence: `frontend/src/features/tasks/taskSlice.js`)
- HTTP client → Express server: HTTP requests
- Express server → API routes: mounts routes (evidence: `backend/server.js`)
- API routes → Task controller: dispatches (evidence: `backend/routes/taskRoutes.js`)
- API routes → Authentication gate: protects routes (evidence: `backend/routes/taskRoutes.js`)
- Task controller → Task service: delegates (evidence: `backend/controllers/taskController.js`)
- Project controller → Project service: delegates (evidence: `backend/controllers/projectController.js`)
- Comment controller → Comment service: delegates (evidence: `backend/controllers/commentController.js`)
- Auth controller → Auth service: delegates (evidence: `backend/controllers/authController.js`)
- Task service → Task repository: queries (evidence: `backend/services/TaskService.js`)
- Task service → Project repository: queries (evidence: `backend/services/TaskService.js`)
- Task service → User repository: queries (evidence: `backend/services/TaskService.js`)
- Project service → Project repository: queries (evidence: `backend/services/ProjectService.js`)
- Project service → Task repository: queries (evidence: `backend/services/ProjectService.js`)
- Project service → User repository: queries (evidence: `backend/services/ProjectService.js`)
- Comment service → Task repository: queries (evidence: `backend/services/CommentService.js`)
- Comment service → Comment repository: queries (evidence: `backend/services/CommentService.js`)
- Auth service → User repository: queries (evidence: `backend/services/AuthService.js`)
- Auth service → Action logger: records actions (evidence: `backend/services/AuthService.js`)
- Action logger → Log repository: writes logs (evidence: `backend/utils/logger.js`)
- Task repository → Task records: reads / writes (evidence: `backend/repositories/TaskRepository.js`)
- Project repository → Project records: reads / writes (evidence: `backend/repositories/ProjectRepository.js`)
- User repository → User records: reads / writes (evidence: `backend/repositories/UserRepository.js`)
- Express server → MongoDB: connects (evidence: `backend/server.js`)
