# csvarshini2967/campus-event-management-system architecture

> Architecture diagram of the GitHub repository csvarshini2967/campus-event-management-system, 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/csvarshini2967/campus-event-management-system
- Repository: https://github.com/csvarshini2967/campus-event-management-system

## Overview

This is a reference campus event management system, not a complete working product. Its intended user workflow is authentication, event discovery, registration, and event administration; the README also names clubs, venues, attendance, and feedback. The sampled backend wires auth, event, and registration routes to placeholder controllers; only event listing visibly queries MySQL. The frontend entry currently renders a minimal placeholder rather than the listed dashboards. Unwired capabilities are included as documented subsystems, without inferred runtime connections.

Main entry points: [`backend/server.js`](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/server.js) (Express server), [`backend/routes/authRoutes.js`](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/authRoutes.js) (Auth routes), [`backend/routes/eventRoutes.js`](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/eventRoutes.js) (Event routes), [`backend/routes/registrationRoutes.js`](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/registrationRoutes.js) (Registration routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API routing"]
  node_server["Express server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_event_routes["Event routes<br/>[eventRoutes.js]"]
  node_registration_routes["Registration routes"]
end

subgraph group_domain["Event operations"]
  node_auth["Authentication<br/>[authController.js]"]
  node_events["Event management<br/>[eventController.js]"]
  node_registrations["Event registration"]
  node_clubs["Club management<br/>[clubController.js]"]
  node_venues["Venue management<br/>[venueController.js]"]
  node_attendance["Attendance"]
  node_feedback["Feedback"]
end

subgraph group_data["Persistence"]
  node_db_pool["MySQL connection pool<br/>[db.js]"]
  node_mysql[("MySQL database")]
end

subgraph group_client["Frontend experience"]
  node_entry["Frontend entry<br/>[main.jsx]"]
  node_student_ui["Student pages"]
  node_admin_ui["Admin pages"]
  node_auth_ui["Login and register UI"]
  node_services["API service modules"]
end

node_student(("Student"))
node_admin(("Admin or faculty"))

node_server -->|"mounts auth"| node_auth_routes
node_server -->|"mounts events"| node_event_routes
node_server -->|"mounts registrations"| node_registration_routes
node_auth_routes -->|"dispatches"| node_auth
node_event_routes -->|"dispatches"| node_events
node_registration_routes -->|"dispatches"| node_registrations
node_events -->|"queries"| node_db_pool
node_db_pool -->|"connects"| node_mysql

click node_server "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/server.js"
click node_auth_routes "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/authRoutes.js"
click node_event_routes "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/eventRoutes.js"
click node_registration_routes "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/registrationRoutes.js"
click node_auth "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/authController.js"
click node_events "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/eventController.js"
click node_registrations "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/registrationController.js"
click node_clubs "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/clubController.js"
click node_venues "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/venueController.js"
click node_attendance "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/attendanceController.js"
click node_feedback "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/feedbackController.js"
click node_db_pool "https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/config/db.js"
click node_entry "https://github.com/csvarshini2967/campus-event-management-system/blob/main/frontend/src/main.jsx"
click node_student_ui "https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/pages/student"
click node_admin_ui "https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/pages/Admin"
click node_auth_ui "https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/pages/Auth"
click node_services "https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/services"

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_server,node_auth_routes,node_event_routes,node_registration_routes toneBlue
class node_auth,node_events,node_registrations,node_clubs,node_venues,node_attendance,node_feedback toneAmber
class node_db_pool,node_mysql toneMint
class node_entry,node_student_ui,node_admin_ui,node_auth_ui,node_services toneRose
class node_student,node_admin toneIndigo
```

## Components

### API routing

- [Express server](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/server.js): `backend/server.js`
- [Auth routes](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Event routes](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/eventRoutes.js): `backend/routes/eventRoutes.js`
- [Registration routes](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/routes/registrationRoutes.js): `backend/routes/registrationRoutes.js`

### Event operations

- [Authentication](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Event management](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/eventController.js): `backend/controllers/eventController.js`
- [Event registration](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/registrationController.js): `backend/controllers/registrationController.js`
- [Club management](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/clubController.js): `backend/controllers/clubController.js`
- [Venue management](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/venueController.js): `backend/controllers/venueController.js`
- [Attendance](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/attendanceController.js): `backend/controllers/attendanceController.js`
- [Feedback](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/controllers/feedbackController.js): `backend/controllers/feedbackController.js`

### Persistence

- [MySQL connection pool](https://github.com/csvarshini2967/campus-event-management-system/blob/main/backend/config/db.js): `backend/config/db.js`
- **MySQL database**

### Frontend experience

- [Frontend entry](https://github.com/csvarshini2967/campus-event-management-system/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Student pages](https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/pages/student): `frontend/src/pages/student`
- [Admin pages](https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/pages/Admin): `frontend/src/pages/Admin`
- [Login and register UI](https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/pages/Auth): `frontend/src/pages/Auth`
- [API service modules](https://github.com/csvarshini2967/campus-event-management-system/tree/main/frontend/src/services): `frontend/src/services`

### Other components

- **Student**
- **Admin or faculty**

## Connections

- Express server → Auth routes: mounts auth (evidence: `backend/server.js`)
- Express server → Event routes: mounts events (evidence: `backend/server.js`)
- Express server → Registration routes: mounts registrations (evidence: `backend/server.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- Event routes → Event management: dispatches (evidence: `backend/routes/eventRoutes.js`)
- Registration routes → Event registration: dispatches (evidence: `backend/routes/registrationRoutes.js`)
- Event management → MySQL connection pool: queries (evidence: `backend/controllers/eventController.js`)
- MySQL connection pool → MySQL database: connects (evidence: `backend/config/db.js`)
