# mohit-gaur75/campusfix architecture

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

- Interactive diagram: https://gitdiagram.com/mohit-gaur75/campusfix
- Repository: https://github.com/mohit-gaur75/campusfix

## Overview

CampusFix lets students report and track campus issues while campus authorities prioritize, assign, and resolve them. The student workflow runs from report entry through upload and issue processing to a trackable issue; authorities use separate issue-management, user, and analytics views. Authentication and role-protected routes serve both experiences. The README identifies MongoDB Atlas and JWT, while sampled backend code shows issue deduplication, priority calculation, workflow operations, and notifications. Some feature modules were not sampled, so their internal connections are omitted; the browser-to-server API link is shown as unverified.

Main entry points: [`server/src/app.js`](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/app.js) (Express API), [`client/src/App.jsx`](https://github.com/mohit-gaur75/campusfix/blob/main/client/src/App.jsx) (Route composition), [`server/src/services/issue.service.js`](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/issue.service.js) (Issue processing), [`server/src/services/workflow.service.js`](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/workflow.service.js) (Issue workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student["Student experience"]
  node_student["Student pages"]
  node_report["Issue reporting<br/>[ReportIssue.jsx]"]
  node_authui["Web authentication<br/>[AuthContext.jsx]"]
  node_clientapi["Client API"]
end

subgraph group_authority["Authority experience"]
  node_authorityui["Authority views"]
  node_analyticsui["Analytics views<br/>[Analytics.jsx]"]
end

subgraph group_backend["API and access"]
  node_app["Route composition<br/>[App.jsx]"]
  node_server["Express API<br/>[app.js]"]
  node_issue_routes["Issue routes<br/>[issue.routes.js]"]
  node_authority_routes["Authority routes"]
  node_feature_routes["Other API routes"]
  node_issue_controller["Issue handlers"]
  node_authority_controller["Authority handlers"]
  node_analytics["Analytics subsystem"]
  node_access["Identity and access<br/>[authenticate.js]"]
end

subgraph group_domain["Issue domain"]
  node_issue_service["Issue processing<br/>[issue.service.js]"]
  node_workflow["Issue workflow"]
  node_priority["Priority scoring"]
  node_upload["Photo uploads<br/>[upload.service.js]"]
  node_notifications["Notifications"]
end

subgraph group_data["Persistence and services"]
  node_models[("Issue and report data<br/>[Issue.js]")]
  node_user_model[("User data<br/>[User.js]")]
  node_mongo[("MongoDB<br/>[db.js]")]
  node_cloudinary["Cloudinary storage<br/>[cloudinary.js]"]
end

node_visitor(("Campus users"))

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_student
node_app -->|"routes to"| node_report
node_app -->|"routes to"| node_authorityui
node_app -->|"provides auth"| node_authui
node_authui -->|"calls"| node_clientapi
node_report -->|"submits via"| node_clientapi
node_analyticsui -.->|"requests data"| node_clientapi
node_clientapi -.->|"HTTP requests"| node_server
node_server -->|"mounts"| node_issue_routes
node_server -->|"mounts"| node_authority_routes
node_server -->|"mounts"| node_feature_routes
node_issue_routes -->|"dispatches"| node_issue_controller
node_authority_routes -->|"dispatches"| node_authority_controller
node_issue_routes -->|"protects"| node_access
node_authority_routes -->|"protects"| node_access
node_issue_controller -->|"calls"| node_issue_service
node_issue_controller -->|"uploads files"| node_upload
node_authority_controller -->|"delegates"| node_workflow
node_authority_controller -->|"computes priority"| node_priority
node_issue_service -->|"reads and writes"| node_models
node_issue_service -->|"scores issues"| node_priority
node_issue_service -->|"notifies reporters"| node_notifications
node_workflow -->|"updates records"| node_models
node_workflow -->|"recalculates"| node_priority
node_workflow -->|"notifies users"| node_notifications
node_upload -->|"uses storage"| node_cloudinary
node_access -->|"loads user"| node_user_model
node_access -->|"verifies tokens"| node_server
node_analytics -.->|"queries issue data"| node_models
node_server -->|"connects"| node_mongo

click node_student "https://github.com/mohit-gaur75/campusfix/tree/main/client/src/pages/student"
click node_report "https://github.com/mohit-gaur75/campusfix/blob/main/client/src/pages/student/ReportIssue.jsx"
click node_authui "https://github.com/mohit-gaur75/campusfix/blob/main/client/src/context/AuthContext.jsx"
click node_clientapi "https://github.com/mohit-gaur75/campusfix/tree/main/client/src/api"
click node_authorityui "https://github.com/mohit-gaur75/campusfix/tree/main/client/src/pages/authority"
click node_analyticsui "https://github.com/mohit-gaur75/campusfix/blob/main/client/src/pages/authority/Analytics.jsx"
click node_app "https://github.com/mohit-gaur75/campusfix/blob/main/client/src/App.jsx"
click node_server "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/app.js"
click node_issue_routes "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/routes/issue.routes.js"
click node_authority_routes "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/routes/authority.routes.js"
click node_feature_routes "https://github.com/mohit-gaur75/campusfix/tree/main/server/src/routes"
click node_issue_controller "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/controllers/issue.controller.js"
click node_authority_controller "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/controllers/authority.controller.js"
click node_analytics "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/controllers/analytics.controller.js"
click node_access "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/middleware/authenticate.js"
click node_issue_service "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/issue.service.js"
click node_workflow "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/workflow.service.js"
click node_priority "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/priority.service.js"
click node_upload "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/upload.service.js"
click node_notifications "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/notification.service.js"
click node_models "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/models/Issue.js"
click node_user_model "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/models/User.js"
click node_mongo "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/config/db.js"
click node_cloudinary "https://github.com/mohit-gaur75/campusfix/blob/main/server/src/config/cloudinary.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_student,node_report,node_authui,node_clientapi,node_visitor toneBlue
class node_authorityui,node_analyticsui toneAmber
class node_app,node_server,node_issue_routes,node_authority_routes,node_feature_routes,node_issue_controller,node_authority_controller,node_analytics,node_access toneMint
class node_issue_service,node_workflow,node_priority,node_upload,node_notifications toneRose
class node_models,node_user_model,node_mongo,node_cloudinary toneIndigo
```

## Components

### Student experience

- [Student pages](https://github.com/mohit-gaur75/campusfix/tree/main/client/src/pages/student): `client/src/pages/student`
- [Issue reporting](https://github.com/mohit-gaur75/campusfix/blob/main/client/src/pages/student/ReportIssue.jsx): `client/src/pages/student/ReportIssue.jsx`
- [Web authentication](https://github.com/mohit-gaur75/campusfix/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [Client API](https://github.com/mohit-gaur75/campusfix/tree/main/client/src/api): `client/src/api`

### Authority experience

- [Authority views](https://github.com/mohit-gaur75/campusfix/tree/main/client/src/pages/authority): `client/src/pages/authority`
- [Analytics views](https://github.com/mohit-gaur75/campusfix/blob/main/client/src/pages/authority/Analytics.jsx): `client/src/pages/authority/Analytics.jsx`

### API and access

- [Route composition](https://github.com/mohit-gaur75/campusfix/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Express API](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/app.js): `server/src/app.js`
- [Issue routes](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/routes/issue.routes.js): `server/src/routes/issue.routes.js`
- [Authority routes](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/routes/authority.routes.js): `server/src/routes/authority.routes.js`
- [Other API routes](https://github.com/mohit-gaur75/campusfix/tree/main/server/src/routes): `server/src/routes`
- [Issue handlers](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/controllers/issue.controller.js): `server/src/controllers/issue.controller.js`
- [Authority handlers](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/controllers/authority.controller.js): `server/src/controllers/authority.controller.js`
- [Analytics subsystem](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/controllers/analytics.controller.js): `server/src/controllers/analytics.controller.js`
- [Identity and access](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/middleware/authenticate.js): `server/src/middleware/authenticate.js`

### Issue domain

- [Issue processing](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/issue.service.js): `server/src/services/issue.service.js`
- [Issue workflow](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/workflow.service.js): `server/src/services/workflow.service.js`
- [Priority scoring](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/priority.service.js): `server/src/services/priority.service.js`
- [Photo uploads](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/upload.service.js): `server/src/services/upload.service.js`
- [Notifications](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/services/notification.service.js): `server/src/services/notification.service.js`

### Persistence and services

- [Issue and report data](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/models/Issue.js): `server/src/models/Issue.js`
- [User data](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/models/User.js): `server/src/models/User.js`
- [MongoDB](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/config/db.js): `server/src/config/db.js`
- [Cloudinary storage](https://github.com/mohit-gaur75/campusfix/blob/main/server/src/config/cloudinary.js): `server/src/config/cloudinary.js`

### Other components

- **Campus users**

## Connections

- Campus users → Route composition: uses (evidence: `client/src/App.jsx`)
- Route composition → Student pages: routes to (evidence: `client/src/App.jsx`)
- Route composition → Issue reporting: routes to (evidence: `client/src/App.jsx`)
- Route composition → Authority views: routes to (evidence: `client/src/App.jsx`)
- Route composition → Web authentication: provides auth (evidence: `client/src/App.jsx`)
- Web authentication → Client API: calls (evidence: `client/src/context/AuthContext.jsx`)
- Issue reporting → Client API: submits via (evidence: `client/src/pages/student/ReportIssue.jsx`)
- Analytics views → Client API: requests data
- Client API → Express API: HTTP requests
- Express API → Issue routes: mounts (evidence: `server/src/app.js`)
- Express API → Authority routes: mounts (evidence: `server/src/app.js`)
- Express API → Other API routes: mounts (evidence: `server/src/app.js`)
- Issue routes → Issue handlers: dispatches (evidence: `server/src/routes/issue.routes.js`)
- Authority routes → Authority handlers: dispatches (evidence: `server/src/routes/authority.routes.js`)
- Issue routes → Identity and access: protects (evidence: `server/src/routes/issue.routes.js`)
- Authority routes → Identity and access: protects (evidence: `server/src/routes/authority.routes.js`)
- Issue handlers → Issue processing: calls (evidence: `server/src/controllers/issue.controller.js`)
- Issue handlers → Photo uploads: uploads files (evidence: `server/src/controllers/issue.controller.js`)
- Authority handlers → Issue workflow: delegates (evidence: `server/src/controllers/authority.controller.js`)
- Authority handlers → Priority scoring: computes priority (evidence: `server/src/controllers/authority.controller.js`)
- Issue processing → Issue and report data: reads and writes (evidence: `server/src/services/issue.service.js`)
- Issue processing → Priority scoring: scores issues (evidence: `server/src/services/issue.service.js`)
- Issue processing → Notifications: notifies reporters (evidence: `server/src/services/issue.service.js`)
- Issue workflow → Issue and report data: updates records (evidence: `server/src/services/workflow.service.js`)
- Issue workflow → Priority scoring: recalculates (evidence: `server/src/services/workflow.service.js`)
- Issue workflow → Notifications: notifies users (evidence: `server/src/services/workflow.service.js`)
- Photo uploads → Cloudinary storage: uses storage (evidence: `server/src/services/upload.service.js`)
- Identity and access → User data: loads user (evidence: `server/src/middleware/authenticate.js`)
- Identity and access → Express API: verifies tokens (evidence: `server/src/middleware/authenticate.js`)
- Analytics subsystem → Issue and report data: queries issue data
- Express API → MongoDB: connects (evidence: `server/src/server.js`)
