# omwairagade/campus360 architecture

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

- Interactive diagram: https://gitdiagram.com/omwairagade/campus360
- Repository: https://github.com/omwairagade/campus360

## Overview

Campus360 is a campus-management application for students, faculty, and administrators. Users enter through role-specific web pages, which make authenticated API requests; the backend routes those requests to academic, attendance, fee, and administrative operations backed by PostgreSQL through Prisma. The graph groups related screens and handlers to show the main workflow and major capabilities without enumerating every route. Source evidence is strongest for server mounting, enrollment, attendance, and database access; some broader capability links are therefore left out rather than inferred.

Main entry points: [`backend/src/routes`](https://github.com/omwairagade/campus360/tree/main/backend/src/routes) (API routes), [`backend/src/lib/prisma.js`](https://github.com/omwairagade/campus360/blob/main/backend/src/lib/prisma.js) (Prisma client), [`frontend/src/main.jsx`](https://github.com/omwairagade/campus360/blob/main/frontend/src/main.jsx) (Role-based app), [`frontend/src/api.js`](https://github.com/omwairagade/campus360/blob/main/frontend/src/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_webapp["Role-based app<br/>[main.jsx]"]
  node_studentpages["Student pages"]
  node_facultypages["Faculty pages"]
  node_adminpages["Admin pages"]
end

subgraph group_api["API and access"]
  node_clientapi["API client<br/>[api.js]"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth["Authentication<br/>[authMiddleware.js]"]
  node_roles["Role checks<br/>[roleMiddleware.js]"]
  node_routes["API routes"]
end

subgraph group_academics["Academic operations"]
  node_enrollment["Course enrollment"]
  node_adminenrollment["Admin enrollment"]
  node_attendance["Attendance"]
  node_assignments["Assignments"]
end

subgraph group_campus["Campus services"]
  node_studentadmin["Student administration"]
  node_timetableadmin["Timetable administration"]
  node_othercontrollers["Campus controllers"]
end

subgraph group_data["Persistence"]
  node_prisma["Prisma client<br/>[prisma.js]"]
  node_database[("PostgreSQL")]
end

node_users(("Students and staff"))

node_users -->|"use"| node_webapp
node_webapp -->|"routes to"| node_studentpages
node_webapp -->|"routes to"| node_facultypages
node_webapp -->|"routes to"| node_adminpages
node_studentpages -.->|"request data"| node_clientapi
node_facultypages -->|"request data"| node_clientapi
node_adminpages -->|"request data"| node_clientapi
node_clientapi -->|"HTTP requests"| node_server
node_server -->|"mounts"| node_routes
node_routes -->|"checks token"| node_auth
node_routes -->|"checks role"| node_roles
node_routes -->|"dispatches"| node_enrollment
node_routes -->|"dispatches"| node_adminenrollment
node_routes -->|"dispatches"| node_attendance
node_routes -->|"dispatches"| node_assignments
node_routes -.->|"dispatches"| node_studentadmin
node_routes -->|"dispatches"| node_timetableadmin
node_server -.->|"mounts routes"| node_othercontrollers
node_enrollment -->|"queries"| node_prisma
node_adminenrollment -->|"queries"| node_prisma
node_attendance -->|"queries"| node_prisma
node_assignments -->|"queries"| node_prisma
node_studentadmin -->|"queries"| node_prisma
node_timetableadmin -->|"queries"| node_prisma
node_prisma -->|"connects"| node_database

click node_webapp "https://github.com/omwairagade/campus360/blob/main/frontend/src/main.jsx"
click node_studentpages "https://github.com/omwairagade/campus360/tree/main/frontend/src/pages"
click node_facultypages "https://github.com/omwairagade/campus360/tree/main/frontend/src/pages"
click node_adminpages "https://github.com/omwairagade/campus360/tree/main/frontend/src/pages"
click node_clientapi "https://github.com/omwairagade/campus360/blob/main/frontend/src/api.js"
click node_server "https://github.com/omwairagade/campus360/blob/main/backend/src/server.js"
click node_auth "https://github.com/omwairagade/campus360/blob/main/backend/src/middleware/authMiddleware.js"
click node_roles "https://github.com/omwairagade/campus360/blob/main/backend/src/middleware/roleMiddleware.js"
click node_routes "https://github.com/omwairagade/campus360/tree/main/backend/src/routes"
click node_enrollment "https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/enrollmentController.js"
click node_adminenrollment "https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/adminEnrollmentController.js"
click node_attendance "https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/attendanceController.js"
click node_assignments "https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/assignmentController.js"
click node_studentadmin "https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/adminStudentController.js"
click node_timetableadmin "https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/adminTimetableController.js"
click node_othercontrollers "https://github.com/omwairagade/campus360/tree/main/backend/src/controllers"
click node_prisma "https://github.com/omwairagade/campus360/blob/main/backend/src/lib/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_webapp,node_studentpages,node_facultypages,node_adminpages toneBlue
class node_clientapi,node_server,node_auth,node_roles,node_routes toneAmber
class node_enrollment,node_adminenrollment,node_attendance,node_assignments toneMint
class node_studentadmin,node_timetableadmin,node_othercontrollers toneRose
class node_prisma,node_database,node_users toneIndigo
```

## Components

### Web application

- [Role-based app](https://github.com/omwairagade/campus360/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Student pages](https://github.com/omwairagade/campus360/tree/main/frontend/src/pages): `frontend/src/pages`
- [Faculty pages](https://github.com/omwairagade/campus360/tree/main/frontend/src/pages): `frontend/src/pages`
- [Admin pages](https://github.com/omwairagade/campus360/tree/main/frontend/src/pages): `frontend/src/pages`

### API and access

- [API client](https://github.com/omwairagade/campus360/blob/main/frontend/src/api.js): `frontend/src/api.js`
- [HTTP server](https://github.com/omwairagade/campus360/blob/main/backend/src/server.js): `backend/src/server.js`
- [Authentication](https://github.com/omwairagade/campus360/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`
- [Role checks](https://github.com/omwairagade/campus360/blob/main/backend/src/middleware/roleMiddleware.js): `backend/src/middleware/roleMiddleware.js`
- [API routes](https://github.com/omwairagade/campus360/tree/main/backend/src/routes): `backend/src/routes`

### Academic operations

- [Course enrollment](https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/enrollmentController.js): `backend/src/controllers/enrollmentController.js`
- [Admin enrollment](https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/adminEnrollmentController.js): `backend/src/controllers/adminEnrollmentController.js`
- [Attendance](https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/attendanceController.js): `backend/src/controllers/attendanceController.js`
- [Assignments](https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/assignmentController.js): `backend/src/controllers/assignmentController.js`

### Campus services

- [Student administration](https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/adminStudentController.js): `backend/src/controllers/adminStudentController.js`
- [Timetable administration](https://github.com/omwairagade/campus360/blob/main/backend/src/controllers/adminTimetableController.js): `backend/src/controllers/adminTimetableController.js`
- [Campus controllers](https://github.com/omwairagade/campus360/tree/main/backend/src/controllers): `backend/src/controllers`

### Persistence

- [Prisma client](https://github.com/omwairagade/campus360/blob/main/backend/src/lib/prisma.js): `backend/src/lib/prisma.js`
- **PostgreSQL**

### Other components

- **Students and staff**

## Connections

- Students and staff → Role-based app: use
- Role-based app → Student pages: routes to (evidence: `frontend/src/main.jsx`)
- Role-based app → Faculty pages: routes to (evidence: `frontend/src/main.jsx`)
- Role-based app → Admin pages: routes to (evidence: `frontend/src/main.jsx`)
- Student pages → API client: request data (evidence: `frontend/src/pages/AdminEnrollments.jsx`)
- Faculty pages → API client: request data (evidence: `frontend/src/pages/FacultyCourseDetails.jsx`)
- Admin pages → API client: request data (evidence: `frontend/src/pages/AdminEnrollments.jsx`)
- API client → HTTP server: HTTP requests (evidence: `frontend/src/api.js`)
- HTTP server → API routes: mounts (evidence: `backend/src/server.js`)
- API routes → Authentication: checks token (evidence: `backend/src/routes/enrollmentRoutes.js`)
- API routes → Role checks: checks role (evidence: `backend/src/routes/adminEnrollmentRoutes.js`)
- API routes → Course enrollment: dispatches (evidence: `backend/src/routes/enrollmentRoutes.js`)
- API routes → Admin enrollment: dispatches (evidence: `backend/src/routes/adminEnrollmentRoutes.js`)
- API routes → Attendance: dispatches (evidence: `backend/src/routes/attendanceRoutes.js`)
- API routes → Assignments: dispatches (evidence: `backend/src/routes/assignmentRoutes.js`)
- API routes → Student administration: dispatches
- API routes → Timetable administration: dispatches (evidence: `backend/src/routes/adminTimetableRoutes.js`)
- HTTP server → Campus controllers: mounts routes
- Course enrollment → Prisma client: queries (evidence: `backend/src/controllers/enrollmentController.js`)
- Admin enrollment → Prisma client: queries (evidence: `backend/src/controllers/adminEnrollmentController.js`)
- Attendance → Prisma client: queries (evidence: `backend/src/controllers/attendanceController.js`)
- Assignments → Prisma client: queries (evidence: `backend/src/controllers/assignmentController.js`)
- Student administration → Prisma client: queries (evidence: `backend/src/controllers/adminStudentController.js`)
- Timetable administration → Prisma client: queries (evidence: `backend/src/controllers/adminTimetableController.js`)
- Prisma client → PostgreSQL: connects (evidence: `backend/src/lib/prisma.js`)
