# trivikramrajurkar/campuscomplaint architecture

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

- Interactive diagram: https://gitdiagram.com/trivikramrajurkar/campuscomplaint
- Repository: https://github.com/trivikramrajurkar/campuscomplaint

## Overview

The Campus Complaint and Feedback Portal moves student reports through coordinator verification, automatic department routing, department resolution, and student feedback, with admin oversight. The graph separates role-facing screens, API transport, server workflow, and persistence/security. README documentation supports the product capabilities and frontend-to-API boundary; sampled server and controller excerpts show route dispatch and key workflow calls. Several frontend and backend modules are indexed but unsampled, so their internal wiring is not inferred.

Main entry points: [`backend/middleware/auth.js`](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/middleware/auth.js) (Authentication and roles), [`backend/config/prisma.js`](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/config/prisma.js) (Prisma client), [`backend/server.js`](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/server.js) (REST server), [`frontend/src/services/index.js`](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/frontend/src/services/index.js) (Role API services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Role-based portal"]
  node_student_pages["Student complaints"]
  node_coordinator_pages["Coordinator review"]
  node_department_pages["Department resolution"]
  node_admin_pages["Admin oversight"]
  node_auth_pages["Sign in and register"]
  node_frontend_auth["Session and route guards<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_api_services["Role API services<br/>[index.js]"]
end

subgraph group_server["API and workflow"]
  node_express["REST server<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_complaint_routes["Complaint routes<br/>[complaintRoutes.js]"]
  node_coordinator_routes["Coordinator routes"]
  node_department_routes["Department routes"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_complaint_workflow["Complaint submission and feedback"]
  node_coordinator_review["Verification and rejection"]
  node_auto_routing["Category routing"]
  node_department_workflow["Progress and resolution"]
  node_admin_workflow["Assignment and oversight<br/>[adminController.js]"]
end

subgraph group_platform["Identity and persistence"]
  node_auth_controller["Authentication logic<br/>[authController.js]"]
  node_auth_middleware["Authentication and roles<br/>[auth.js]"]
  node_jwt["JWT utilities<br/>[jwt.js]"]
  node_prisma_client["Prisma client<br/>[prisma.js]"]
  node_postgres[("PostgreSQL")]
end

node_students(("Students"))
node_coordinators(("Coordinators"))
node_department_staff(("Department staff"))
node_admins(("Admins"))

node_students -->|"submit and track"| node_student_pages
node_coordinators -->|"review reports"| node_coordinator_pages
node_department_staff -->|"resolve reports"| node_department_pages
node_admins -->|"oversee reports"| node_admin_pages
node_students -->|"register and sign in"| node_auth_pages
node_auth_pages -.->|"establish session"| node_frontend_auth
node_student_pages -.->|"request operations"| node_api_services
node_coordinator_pages -.->|"request operations"| node_api_services
node_department_pages -.->|"request operations"| node_api_services
node_admin_pages -.->|"request operations"| node_api_services
node_api_services -.->|"use client"| node_api_client
node_api_client -->|"REST requests"| node_express
node_express -->|"mounts routes"| node_auth_routes
node_express -->|"mounts routes"| node_complaint_routes
node_express -->|"mounts routes"| node_coordinator_routes
node_express -->|"mounts routes"| node_department_routes
node_express -->|"mounts routes"| node_admin_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_complaint_routes -->|"dispatches"| node_complaint_workflow
node_coordinator_routes -->|"dispatches"| node_coordinator_review
node_department_routes -->|"dispatches"| node_department_workflow
node_admin_routes -->|"dispatches"| node_admin_workflow
node_coordinator_review -->|"routes verified report"| node_auto_routing
node_auth_routes -->|"authenticates requests"| node_auth_middleware
node_complaint_routes -->|"authenticates requests"| node_auth_middleware
node_coordinator_routes -->|"authorizes role"| node_auth_middleware
node_department_routes -->|"authorizes role"| node_auth_middleware
node_admin_routes -->|"authorizes role"| node_auth_middleware
node_auth_middleware -->|"verifies token"| node_jwt
node_auth_middleware -->|"loads user"| node_prisma_client
node_auth_controller -->|"queries records"| node_prisma_client
node_complaint_workflow -->|"reads and writes"| node_prisma_client
node_coordinator_review -->|"reads and writes"| node_prisma_client
node_department_workflow -->|"reads and writes"| node_prisma_client
node_admin_workflow -->|"reads and writes"| node_prisma_client
node_prisma_client -->|"persists data"| node_postgres

click node_student_pages "https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/student"
click node_coordinator_pages "https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/coordinator"
click node_department_pages "https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/department"
click node_admin_pages "https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/admin"
click node_auth_pages "https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/auth"
click node_frontend_auth "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/frontend/src/context/AuthContext.jsx"
click node_api_client "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/frontend/src/services/api.js"
click node_api_services "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/frontend/src/services/index.js"
click node_express "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/server.js"
click node_auth_routes "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/authRoutes.js"
click node_complaint_routes "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/complaintRoutes.js"
click node_coordinator_routes "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/coordinatorRoutes.js"
click node_department_routes "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/departmentRoutes.js"
click node_admin_routes "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/adminRoutes.js"
click node_complaint_workflow "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/complaintController.js"
click node_coordinator_review "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/coordinatorController.js"
click node_auto_routing "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/services/complaintRoutingService.js"
click node_department_workflow "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/departmentController.js"
click node_admin_workflow "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/adminController.js"
click node_auth_controller "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/authController.js"
click node_auth_middleware "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/middleware/auth.js"
click node_jwt "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/utils/jwt.js"
click node_prisma_client "https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/config/prisma.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_pages,node_coordinator_pages,node_department_pages,node_admin_pages,node_auth_pages,node_frontend_auth,node_api_client,node_api_services toneBlue
class node_express,node_auth_routes,node_complaint_routes,node_coordinator_routes,node_department_routes,node_admin_routes,node_complaint_workflow,node_coordinator_review,node_auto_routing,node_department_workflow,node_admin_workflow toneAmber
class node_auth_controller,node_auth_middleware,node_jwt,node_prisma_client,node_postgres toneMint
class node_students,node_coordinators,node_department_staff,node_admins toneIndigo
```

## Components

### Role-based portal

- [Student complaints](https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/student): `frontend/src/pages/student`
- [Coordinator review](https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/coordinator): `frontend/src/pages/coordinator`
- [Department resolution](https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/department): `frontend/src/pages/department`
- [Admin oversight](https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Sign in and register](https://github.com/trivikramrajurkar/campuscomplaint/tree/main/frontend/src/pages/auth): `frontend/src/pages/auth`
- [Session and route guards](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Role API services](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/frontend/src/services/index.js): `frontend/src/services/index.js`

### API and workflow

- [REST server](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/server.js): `backend/server.js`
- [Authentication routes](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Complaint routes](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/complaintRoutes.js): `backend/routes/complaintRoutes.js`
- [Coordinator routes](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/coordinatorRoutes.js): `backend/routes/coordinatorRoutes.js`
- [Department routes](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/departmentRoutes.js): `backend/routes/departmentRoutes.js`
- [Admin routes](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Complaint submission and feedback](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/complaintController.js): `backend/controllers/complaintController.js`
- [Verification and rejection](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/coordinatorController.js): `backend/controllers/coordinatorController.js`
- [Category routing](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/services/complaintRoutingService.js): `backend/services/complaintRoutingService.js`
- [Progress and resolution](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/departmentController.js): `backend/controllers/departmentController.js`
- [Assignment and oversight](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`

### Identity and persistence

- [Authentication logic](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Authentication and roles](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/middleware/auth.js): `backend/middleware/auth.js`
- [JWT utilities](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/utils/jwt.js): `backend/utils/jwt.js`
- [Prisma client](https://github.com/trivikramrajurkar/campuscomplaint/blob/main/backend/config/prisma.js): `backend/config/prisma.js`
- **PostgreSQL**

### Other components

- **Students**
- **Coordinators**
- **Department staff**
- **Admins**

## Connections

- Students → Student complaints: submit and track (evidence: `README.md`)
- Coordinators → Coordinator review: review reports (evidence: `README.md`)
- Department staff → Department resolution: resolve reports (evidence: `README.md`)
- Admins → Admin oversight: oversee reports (evidence: `README.md`)
- Students → Sign in and register: register and sign in (evidence: `README.md`)
- Sign in and register → Session and route guards: establish session
- Student complaints → Role API services: request operations
- Coordinator review → Role API services: request operations
- Department resolution → Role API services: request operations
- Admin oversight → Role API services: request operations
- Role API services → API client: use client
- API client → REST server: REST requests (evidence: `README.md`)
- REST server → Authentication routes: mounts routes (evidence: `backend/server.js`)
- REST server → Complaint routes: mounts routes (evidence: `backend/server.js`)
- REST server → Coordinator routes: mounts routes (evidence: `backend/server.js`)
- REST server → Department routes: mounts routes (evidence: `backend/server.js`)
- REST server → Admin routes: mounts routes (evidence: `backend/server.js`)
- Authentication routes → Authentication logic: dispatches (evidence: `backend/routes/authRoutes.js`)
- Complaint routes → Complaint submission and feedback: dispatches (evidence: `backend/routes/complaintRoutes.js`)
- Coordinator routes → Verification and rejection: dispatches (evidence: `backend/routes/coordinatorRoutes.js`)
- Department routes → Progress and resolution: dispatches (evidence: `backend/routes/departmentRoutes.js`)
- Admin routes → Assignment and oversight: dispatches (evidence: `backend/routes/adminRoutes.js`)
- Verification and rejection → Category routing: routes verified report (evidence: `backend/controllers/coordinatorController.js`)
- Authentication routes → Authentication and roles: authenticates requests (evidence: `backend/routes/authRoutes.js`)
- Complaint routes → Authentication and roles: authenticates requests (evidence: `backend/routes/complaintRoutes.js`)
- Coordinator routes → Authentication and roles: authorizes role (evidence: `backend/routes/coordinatorRoutes.js`)
- Department routes → Authentication and roles: authorizes role (evidence: `backend/routes/departmentRoutes.js`)
- Admin routes → Authentication and roles: authorizes role (evidence: `backend/routes/adminRoutes.js`)
- Authentication and roles → JWT utilities: verifies token (evidence: `backend/middleware/auth.js`)
- Authentication and roles → Prisma client: loads user (evidence: `backend/middleware/auth.js`)
- Authentication logic → Prisma client: queries records (evidence: `backend/controllers/authController.js`)
- Complaint submission and feedback → Prisma client: reads and writes (evidence: `backend/controllers/complaintController.js`)
- Verification and rejection → Prisma client: reads and writes (evidence: `backend/controllers/coordinatorController.js`)
- Progress and resolution → Prisma client: reads and writes (evidence: `backend/controllers/departmentController.js`)
- Assignment and oversight → Prisma client: reads and writes (evidence: `backend/controllers/adminController.js`)
- Prisma client → PostgreSQL: persists data (evidence: `README.md`)
