# soumyadip2412/project_management architecture

> Architecture diagram of the GitHub repository soumyadip2412/project_management, 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/soumyadip2412/project_management
- Repository: https://github.com/soumyadip2412/project_management

## Overview

ProjectCamp is a project-management app for software teams. Its principal workflow runs from a browser client through a versioned REST API, where authentication, scope-based authorization, validation, auditing, and a domain controller govern workspace, project, task, and sprint operations; results are persisted in MongoDB and may trigger in-app notifications. The client exposes task boards and project views alongside accounts, dashboards, and workspace management. The README documents the API pipeline; sampled source and the SOURCE INDEX support the cited component links. Unsampled capability links are limited to documented relationships.

Main entry points: [`backend/src/routes/project.routes.js`](https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/project.routes.js) (Project routes), [`backend/src/routes/task.routes.js`](https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/task.routes.js) (Task routes), [`backend/src/models`](https://github.com/soumyadip2412/project_management/tree/main/backend/src/models) (Domain models), [`frontend/src/lib/api.js`](https://github.com/soumyadip2412/project_management/blob/main/frontend/src/lib/api.js) (REST client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_spa["React application<br/>[main.jsx]"]
  node_authctx["Session context<br/>[AuthContext.jsx]"]
  node_taskui["Task views<br/>[Tasks.jsx]"]
  node_projectui["Project views<br/>[ProjectTasks.jsx]"]
  node_api_client["REST client<br/>[api.js]"]
end

subgraph group_api["API request pipeline"]
  node_app["Express API<br/>[app.js]"]
  node_auth["JWT verification<br/>[auth.middleware.js]"]
  node_scope["Scope authorization"]
  node_validation["Request validation"]
  node_audit["Mutation audit"]
  node_permissions["Permission matrix<br/>[permissions.js]"]
  node_authroutes["Account routes<br/>[auth.routes.js]"]
  node_projectroutes["Project routes<br/>[project.routes.js]"]
  node_taskroutes["Task routes<br/>[task.routes.js]"]
end

subgraph group_domain["Project work"]
  node_authlogic["Account operations"]
  node_projects["Project operations"]
  node_tasks["Task operations<br/>[task.controller.js]"]
  node_sprints["Sprint operations"]
  node_dashboard["Dashboard data"]
end

subgraph group_state["Persistence and signals"]
  node_mongo[("MongoDB")]
  node_models["Domain models"]
  node_notifications["Notification service"]
  node_mail["Email delivery<br/>[mail.js]"]
end

node_user(("Team member"))

node_user -->|"uses"| node_spa
node_spa -->|"requests"| node_api_client
node_authctx -->|"uses"| node_api_client
node_api_client -->|"calls REST"| node_app
node_app -->|"mounts routes"| node_authroutes
node_app -->|"mounts routes"| node_projectroutes
node_app -->|"mounts routes"| node_taskroutes
node_authroutes -->|"verifies session"| node_auth
node_authroutes -->|"dispatches"| node_authlogic
node_projectroutes -->|"verifies session"| node_auth
node_projectroutes -->|"guards scope"| node_scope
node_projectroutes -->|"validates input"| node_validation
node_projectroutes -->|"audits mutations"| node_audit
node_projectroutes -->|"dispatches"| node_projects
node_taskroutes -->|"verifies session"| node_auth
node_taskroutes -->|"guards scope"| node_scope
node_taskroutes -->|"validates input"| node_validation
node_taskroutes -->|"audits mutations"| node_audit
node_taskroutes -->|"dispatches"| node_tasks
node_scope -->|"checks roles"| node_permissions
node_projects -->|"reads and writes"| node_models
node_tasks -->|"reads and writes"| node_models
node_authlogic -->|"manages accounts"| node_models
node_dashboard -->|"aggregates records"| node_models
node_models -.->|"persists data"| node_mongo
node_tasks -->|"notifies changes"| node_notifications
node_projects -->|"notifies members"| node_notifications
node_authlogic -->|"sends account email"| node_mail
node_taskui -->|"loads task data"| node_api_client
node_projectui -->|"loads project data"| node_api_client
node_sprints -->|"reads and writes"| node_models

click node_spa "https://github.com/soumyadip2412/project_management/blob/main/frontend/src/main.jsx"
click node_authctx "https://github.com/soumyadip2412/project_management/blob/main/frontend/src/context/AuthContext.jsx"
click node_taskui "https://github.com/soumyadip2412/project_management/blob/main/frontend/src/pages/Tasks.jsx"
click node_projectui "https://github.com/soumyadip2412/project_management/blob/main/frontend/src/components/project/ProjectTasks.jsx"
click node_api_client "https://github.com/soumyadip2412/project_management/blob/main/frontend/src/lib/api.js"
click node_app "https://github.com/soumyadip2412/project_management/blob/main/backend/src/app.js"
click node_auth "https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/auth.middleware.js"
click node_scope "https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/authorize.middleware.js"
click node_validation "https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/validator.middleware.js"
click node_audit "https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/audit.middleware.js"
click node_permissions "https://github.com/soumyadip2412/project_management/blob/main/backend/src/utils/permissions.js"
click node_authroutes "https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/auth.routes.js"
click node_projectroutes "https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/project.routes.js"
click node_taskroutes "https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/task.routes.js"
click node_authlogic "https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/auth.controllers.js"
click node_projects "https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/project.controller.js"
click node_tasks "https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/task.controller.js"
click node_sprints "https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/sprint.controller.js"
click node_dashboard "https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/dashboard.controller.js"
click node_mongo "https://github.com/soumyadip2412/project_management/blob/main/backend/src/db/databaseconnection.js"
click node_models "https://github.com/soumyadip2412/project_management/tree/main/backend/src/models"
click node_notifications "https://github.com/soumyadip2412/project_management/blob/main/backend/src/services/notification.service.js"
click node_mail "https://github.com/soumyadip2412/project_management/blob/main/backend/src/utils/mail.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_spa,node_authctx,node_taskui,node_projectui,node_api_client toneBlue
class node_app,node_auth,node_scope,node_validation,node_audit,node_permissions,node_authroutes,node_projectroutes,node_taskroutes toneAmber
class node_authlogic,node_projects,node_tasks,node_sprints,node_dashboard toneMint
class node_mongo,node_models,node_notifications,node_mail toneRose
class node_user toneIndigo
```

## Components

### React client

- [React application](https://github.com/soumyadip2412/project_management/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Session context](https://github.com/soumyadip2412/project_management/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Task views](https://github.com/soumyadip2412/project_management/blob/main/frontend/src/pages/Tasks.jsx): `frontend/src/pages/Tasks.jsx`
- [Project views](https://github.com/soumyadip2412/project_management/blob/main/frontend/src/components/project/ProjectTasks.jsx): `frontend/src/components/project/ProjectTasks.jsx`
- [REST client](https://github.com/soumyadip2412/project_management/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`

### API request pipeline

- [Express API](https://github.com/soumyadip2412/project_management/blob/main/backend/src/app.js): `backend/src/app.js`
- [JWT verification](https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/auth.middleware.js): `backend/src/middlewares/auth.middleware.js`
- [Scope authorization](https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/authorize.middleware.js): `backend/src/middlewares/authorize.middleware.js`
- [Request validation](https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/validator.middleware.js): `backend/src/middlewares/validator.middleware.js`
- [Mutation audit](https://github.com/soumyadip2412/project_management/blob/main/backend/src/middlewares/audit.middleware.js): `backend/src/middlewares/audit.middleware.js`
- [Permission matrix](https://github.com/soumyadip2412/project_management/blob/main/backend/src/utils/permissions.js): `backend/src/utils/permissions.js`
- [Account routes](https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/auth.routes.js): `backend/src/routes/auth.routes.js`
- [Project routes](https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/project.routes.js): `backend/src/routes/project.routes.js`
- [Task routes](https://github.com/soumyadip2412/project_management/blob/main/backend/src/routes/task.routes.js): `backend/src/routes/task.routes.js`

### Project work

- [Account operations](https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/auth.controllers.js): `backend/src/controllers/auth.controllers.js`
- [Project operations](https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/project.controller.js): `backend/src/controllers/project.controller.js`
- [Task operations](https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/task.controller.js): `backend/src/controllers/task.controller.js`
- [Sprint operations](https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/sprint.controller.js): `backend/src/controllers/sprint.controller.js`
- [Dashboard data](https://github.com/soumyadip2412/project_management/blob/main/backend/src/controllers/dashboard.controller.js): `backend/src/controllers/dashboard.controller.js`

### Persistence and signals

- [MongoDB](https://github.com/soumyadip2412/project_management/blob/main/backend/src/db/databaseconnection.js): `backend/src/db/databaseconnection.js`
- [Domain models](https://github.com/soumyadip2412/project_management/tree/main/backend/src/models): `backend/src/models`
- [Notification service](https://github.com/soumyadip2412/project_management/blob/main/backend/src/services/notification.service.js): `backend/src/services/notification.service.js`
- [Email delivery](https://github.com/soumyadip2412/project_management/blob/main/backend/src/utils/mail.js): `backend/src/utils/mail.js`

### Other components

- **Team member**

## Connections

- Team member → React application: uses
- React application → REST client: requests
- Session context → REST client: uses (evidence: `frontend/src/context/AuthContext.jsx`)
- REST client → Express API: calls REST
- Express API → Account routes: mounts routes (evidence: `backend/src/app.js`)
- Express API → Project routes: mounts routes (evidence: `backend/src/app.js`)
- Express API → Task routes: mounts routes (evidence: `backend/src/app.js`)
- Account routes → JWT verification: verifies session (evidence: `backend/src/routes/auth.routes.js`)
- Account routes → Account operations: dispatches (evidence: `backend/src/routes/auth.routes.js`)
- Project routes → JWT verification: verifies session (evidence: `backend/src/routes/project.routes.js`)
- Project routes → Scope authorization: guards scope (evidence: `backend/src/routes/project.routes.js`)
- Project routes → Request validation: validates input (evidence: `backend/src/routes/project.routes.js`)
- Project routes → Mutation audit: audits mutations (evidence: `backend/src/routes/project.routes.js`)
- Project routes → Project operations: dispatches (evidence: `backend/src/routes/project.routes.js`)
- Task routes → JWT verification: verifies session (evidence: `backend/src/routes/task.routes.js`)
- Task routes → Scope authorization: guards scope (evidence: `backend/src/routes/task.routes.js`)
- Task routes → Request validation: validates input (evidence: `backend/src/routes/task.routes.js`)
- Task routes → Mutation audit: audits mutations (evidence: `backend/src/routes/task.routes.js`)
- Task routes → Task operations: dispatches (evidence: `backend/src/routes/task.routes.js`)
- Scope authorization → Permission matrix: checks roles (evidence: `backend/src/middlewares/authorize.middleware.js`)
- Project operations → Domain models: reads and writes (evidence: `backend/src/controllers/project.controller.js`)
- Task operations → Domain models: reads and writes (evidence: `backend/src/controllers/task.controller.js`)
- Account operations → Domain models: manages accounts (evidence: `backend/src/controllers/auth.controllers.js`)
- Dashboard data → Domain models: aggregates records (evidence: `backend/src/controllers/dashboard.controller.js`)
- Domain models → MongoDB: persists data
- Task operations → Notification service: notifies changes (evidence: `backend/src/controllers/task.controller.js`)
- Project operations → Notification service: notifies members (evidence: `backend/src/controllers/project.controller.js`)
- Account operations → Email delivery: sends account email (evidence: `backend/src/controllers/auth.controllers.js`)
- Task views → REST client: loads task data (evidence: `frontend/src/pages/Tasks.jsx`)
- Project views → REST client: loads project data (evidence: `frontend/src/components/project/ProjectTasks.jsx`)
- Sprint operations → Domain models: reads and writes (evidence: `backend/src/controllers/sprint.controller.js`)
