# puloksingha/managex architecture

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

- Interactive diagram: https://gitdiagram.com/puloksingha/managex
- Repository: https://github.com/puloksingha/managex

## Overview

ManageX is a college assignment-management platform. Users register and verify email, then authenticate into role-specific student, department/teacher, or admin workflows. Students browse assignments and submit files; department staff create assignments, review submissions, and grade them. Admins manage accounts and academic structures, while all roles can manage profiles. The React client calls the Express API, whose controllers implement domain workflows over MongoDB and file storage. README capabilities are included where source excerpts were unavailable; those links are documented rather than inferred from unsampled code.

Main entry points: [`server/src/app.js`](https://github.com/puloksingha/managex/blob/main/server/src/app.js) (Express API), [`server/src/models/Assignment.js`](https://github.com/puloksingha/managex/blob/main/server/src/models/Assignment.js) (Domain records), [`client/src/App.jsx`](https://github.com/puloksingha/managex/blob/main/client/src/App.jsx) (Route selection), [`server/src/utils/storage.js`](https://github.com/puloksingha/managex/blob/main/server/src/utils/storage.js) (File storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_react["Role dashboards"]
  node_teacher["Department dashboard"]
  node_adminui["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_authui["Auth and profile pages<br/>[LoginPage.jsx]"]
  node_router["Route selection<br/>[App.jsx]"]
  node_apiclient["API client<br/>[client.js]"]
end

subgraph group_identity["Identity and profiles"]
  node_authstate["Session state<br/>[AuthContext.jsx]"]
  node_authroutes["Auth endpoints<br/>[authRoutes.js]"]
  node_authlogic["Auth workflows<br/>[authController.js]"]
  node_profilelogic["Profile management"]
end

subgraph group_academic["Assignments and grading"]
  node_assignui["Student assignment view"]
  node_teacherui["Assignment and grading UI"]
  node_assignroutes["Assignment endpoints"]
  node_assignlogic["Assignment workflows"]
  node_subroutes["Submission endpoints"]
  node_sublogic["Submission and grading"]
end

subgraph group_administration["Administration"]
  node_adminroutes["Admin endpoints<br/>[adminRoutes.js]"]
  node_adminlogic["Admin workflows<br/>[adminController.js]"]
  node_metaroutes["Academic lookup data<br/>[metaRoutes.js]"]
end

subgraph group_platform["API and persistence"]
  node_models["Domain records<br/>[Assignment.js]"]
  node_mongo[("MongoDB")]
  node_fileops["File storage<br/>[storage.js]"]
  node_localfiles[("Local uploads")]
  node_cloudinary["Cloudinary"]
  node_api["Express API<br/>[app.js]"]
end

node_visitor(("User"))

node_visitor -->|"opens app"| node_router
node_router -->|"routes auth"| node_authui
node_router -->|"routes roles"| node_react
node_router -->|"routes department"| node_teacher
node_router -->|"routes admin"| node_adminui
node_authui -.->|"uses session"| node_authstate
node_react -.->|"requests data"| node_apiclient
node_teacher -->|"requests data"| node_apiclient
node_adminui -->|"requests data"| node_apiclient
node_authstate -->|"calls API"| node_apiclient
node_apiclient -.->|"HTTP requests"| node_api
node_api -->|"mounts routes"| node_authroutes
node_api -->|"mounts routes"| node_assignroutes
node_api -->|"mounts routes"| node_subroutes
node_api -->|"mounts routes"| node_adminroutes
node_api -->|"mounts routes"| node_metaroutes
node_api -.->|"routes profiles"| node_profilelogic
node_authroutes -->|"dispatches to"| node_authlogic
node_authlogic -->|"reads and writes"| node_models
node_authlogic -.->|"persists sessions"| node_mongo
node_authlogic -->|"sends verification mail"| node_visitor
node_assignroutes -->|"dispatches to"| node_assignlogic
node_assignlogic -->|"reads and writes"| node_models
node_assignlogic -->|"uploads attachments"| node_fileops
node_subroutes -->|"dispatches to"| node_sublogic
node_sublogic -->|"reads and writes"| node_models
node_sublogic -->|"uploads submissions"| node_fileops
node_adminroutes -->|"dispatches to"| node_adminlogic
node_adminlogic -->|"manages records"| node_models
node_metaroutes -->|"reads lookups"| node_models
node_profilelogic -.->|"updates profile"| node_models
node_profilelogic -.->|"uploads avatar"| node_fileops
node_models -.->|"stores records"| node_mongo
node_fileops -->|"writes files"| node_localfiles
node_fileops -->|"uploads optionally"| node_cloudinary

click node_react "https://github.com/puloksingha/managex/blob/main/client/src/pages/StudentDashboard.jsx"
click node_teacher "https://github.com/puloksingha/managex/blob/main/client/src/pages/TeacherDashboard.jsx"
click node_adminui "https://github.com/puloksingha/managex/blob/main/client/src/pages/AdminDashboard.jsx"
click node_authui "https://github.com/puloksingha/managex/blob/main/client/src/pages/LoginPage.jsx"
click node_router "https://github.com/puloksingha/managex/blob/main/client/src/App.jsx"
click node_authstate "https://github.com/puloksingha/managex/blob/main/client/src/context/AuthContext.jsx"
click node_apiclient "https://github.com/puloksingha/managex/blob/main/client/src/api/client.js"
click node_authroutes "https://github.com/puloksingha/managex/blob/main/server/src/routes/authRoutes.js"
click node_authlogic "https://github.com/puloksingha/managex/blob/main/server/src/controllers/authController.js"
click node_profilelogic "https://github.com/puloksingha/managex/blob/main/server/src/controllers/profileController.js"
click node_assignui "https://github.com/puloksingha/managex/blob/main/client/src/pages/StudentDashboard.jsx"
click node_teacherui "https://github.com/puloksingha/managex/blob/main/client/src/pages/TeacherDashboard.jsx"
click node_assignroutes "https://github.com/puloksingha/managex/blob/main/server/src/routes/assignmentRoutes.js"
click node_assignlogic "https://github.com/puloksingha/managex/blob/main/server/src/controllers/assignmentController.js"
click node_subroutes "https://github.com/puloksingha/managex/blob/main/server/src/routes/submissionRoutes.js"
click node_sublogic "https://github.com/puloksingha/managex/blob/main/server/src/controllers/submissionController.js"
click node_adminroutes "https://github.com/puloksingha/managex/blob/main/server/src/routes/adminRoutes.js"
click node_adminlogic "https://github.com/puloksingha/managex/blob/main/server/src/controllers/adminController.js"
click node_metaroutes "https://github.com/puloksingha/managex/blob/main/server/src/routes/metaRoutes.js"
click node_models "https://github.com/puloksingha/managex/blob/main/server/src/models/Assignment.js"
click node_fileops "https://github.com/puloksingha/managex/blob/main/server/src/utils/storage.js"
click node_api "https://github.com/puloksingha/managex/blob/main/server/src/app.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_react,node_teacher,node_adminui,node_authui,node_router,node_apiclient,node_visitor toneBlue
class node_authstate,node_authroutes,node_authlogic,node_profilelogic toneAmber
class node_assignui,node_teacherui,node_assignroutes,node_assignlogic,node_subroutes,node_sublogic toneMint
class node_adminroutes,node_adminlogic,node_metaroutes toneRose
class node_models,node_mongo,node_fileops,node_localfiles,node_cloudinary,node_api toneIndigo
```

## Components

### Web client

- [Role dashboards](https://github.com/puloksingha/managex/blob/main/client/src/pages/StudentDashboard.jsx): `client/src/pages/StudentDashboard.jsx`
- [Department dashboard](https://github.com/puloksingha/managex/blob/main/client/src/pages/TeacherDashboard.jsx): `client/src/pages/TeacherDashboard.jsx`
- [Admin dashboard](https://github.com/puloksingha/managex/blob/main/client/src/pages/AdminDashboard.jsx): `client/src/pages/AdminDashboard.jsx`
- [Auth and profile pages](https://github.com/puloksingha/managex/blob/main/client/src/pages/LoginPage.jsx): `client/src/pages/LoginPage.jsx`
- [Route selection](https://github.com/puloksingha/managex/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [API client](https://github.com/puloksingha/managex/blob/main/client/src/api/client.js): `client/src/api/client.js`

### Identity and profiles

- [Session state](https://github.com/puloksingha/managex/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Auth endpoints](https://github.com/puloksingha/managex/blob/main/server/src/routes/authRoutes.js): `server/src/routes/authRoutes.js`
- [Auth workflows](https://github.com/puloksingha/managex/blob/main/server/src/controllers/authController.js): `server/src/controllers/authController.js`
- [Profile management](https://github.com/puloksingha/managex/blob/main/server/src/controllers/profileController.js): `server/src/controllers/profileController.js`

### Assignments and grading

- [Student assignment view](https://github.com/puloksingha/managex/blob/main/client/src/pages/StudentDashboard.jsx): `client/src/pages/StudentDashboard.jsx`
- [Assignment and grading UI](https://github.com/puloksingha/managex/blob/main/client/src/pages/TeacherDashboard.jsx): `client/src/pages/TeacherDashboard.jsx`
- [Assignment endpoints](https://github.com/puloksingha/managex/blob/main/server/src/routes/assignmentRoutes.js): `server/src/routes/assignmentRoutes.js`
- [Assignment workflows](https://github.com/puloksingha/managex/blob/main/server/src/controllers/assignmentController.js): `server/src/controllers/assignmentController.js`
- [Submission endpoints](https://github.com/puloksingha/managex/blob/main/server/src/routes/submissionRoutes.js): `server/src/routes/submissionRoutes.js`
- [Submission and grading](https://github.com/puloksingha/managex/blob/main/server/src/controllers/submissionController.js): `server/src/controllers/submissionController.js`

### Administration

- [Admin endpoints](https://github.com/puloksingha/managex/blob/main/server/src/routes/adminRoutes.js): `server/src/routes/adminRoutes.js`
- [Admin workflows](https://github.com/puloksingha/managex/blob/main/server/src/controllers/adminController.js): `server/src/controllers/adminController.js`
- [Academic lookup data](https://github.com/puloksingha/managex/blob/main/server/src/routes/metaRoutes.js): `server/src/routes/metaRoutes.js`

### API and persistence

- [Domain records](https://github.com/puloksingha/managex/blob/main/server/src/models/Assignment.js): `server/src/models/Assignment.js`
- **MongoDB**
- [File storage](https://github.com/puloksingha/managex/blob/main/server/src/utils/storage.js): `server/src/utils/storage.js`
- **Local uploads**
- **Cloudinary**
- [Express API](https://github.com/puloksingha/managex/blob/main/server/src/app.js): `server/src/app.js`

### Other components

- **User**

## Connections

- User → Route selection: opens app (evidence: `client/src/App.jsx`)
- Route selection → Auth and profile pages: routes auth (evidence: `client/src/App.jsx`)
- Route selection → Role dashboards: routes roles (evidence: `client/src/App.jsx`)
- Route selection → Department dashboard: routes department (evidence: `client/src/App.jsx`)
- Route selection → Admin dashboard: routes admin (evidence: `client/src/App.jsx`)
- Auth and profile pages → Session state: uses session
- Role dashboards → API client: requests data
- Department dashboard → API client: requests data (evidence: `client/src/pages/TeacherDashboard.jsx`)
- Admin dashboard → API client: requests data (evidence: `client/src/pages/AdminDashboard.jsx`)
- Session state → API client: calls API (evidence: `client/src/context/AuthContext.jsx`)
- API client → Express API: HTTP requests (evidence: `README.md`)
- Express API → Auth endpoints: mounts routes (evidence: `server/src/app.js`)
- Express API → Assignment endpoints: mounts routes (evidence: `server/src/app.js`)
- Express API → Submission endpoints: mounts routes (evidence: `server/src/app.js`)
- Express API → Admin endpoints: mounts routes (evidence: `server/src/app.js`)
- Express API → Academic lookup data: mounts routes (evidence: `server/src/app.js`)
- Express API → Profile management: routes profiles
- Auth endpoints → Auth workflows: dispatches to (evidence: `server/src/routes/authRoutes.js`)
- Auth workflows → Domain records: reads and writes (evidence: `server/src/controllers/authController.js`)
- Auth workflows → MongoDB: persists sessions
- Auth workflows → User: sends verification mail (evidence: `server/src/controllers/authController.js`)
- Assignment endpoints → Assignment workflows: dispatches to (evidence: `server/src/routes/assignmentRoutes.js`)
- Assignment workflows → Domain records: reads and writes (evidence: `server/src/controllers/assignmentController.js`)
- Assignment workflows → File storage: uploads attachments (evidence: `server/src/controllers/assignmentController.js`)
- Submission endpoints → Submission and grading: dispatches to (evidence: `server/src/routes/submissionRoutes.js`)
- Submission and grading → Domain records: reads and writes (evidence: `server/src/controllers/submissionController.js`)
- Submission and grading → File storage: uploads submissions (evidence: `server/src/controllers/submissionController.js`)
- Admin endpoints → Admin workflows: dispatches to (evidence: `server/src/routes/adminRoutes.js`)
- Admin workflows → Domain records: manages records (evidence: `server/src/controllers/adminController.js`)
- Academic lookup data → Domain records: reads lookups (evidence: `server/src/routes/metaRoutes.js`)
- Profile management → Domain records: updates profile
- Profile management → File storage: uploads avatar (evidence: `server/src/controllers/profileController.js`)
- Domain records → MongoDB: stores records
- File storage → Local uploads: writes files (evidence: `server/src/utils/storage.js`)
- File storage → Cloudinary: uploads optionally (evidence: `server/src/utils/storage.js`)
