# 424137-ship-it/college-event-management-system architecture

> Architecture diagram of the GitHub repository 424137-ship-it/college-event-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/424137-ship-it/college-event-management-system
- Repository: https://github.com/424137-ship-it/college-event-management-system

## Overview

HarshaX is a college event and community platform. Students browse events, register for QR passes, attend with verified check-in, and access certificates; organizers create events and manage attendance, budgets, and galleries, while administrators govern users and event approvals. The React client calls a Django REST API backed by MySQL. The graph preserves documented capabilities, but several backend and frontend modules were not sampled; their internal call paths are omitted where the evidence does not establish them.

Main entry points: [`frontend/src/services/api.js`](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/services/api.js) (API client), [`backend/events/views.py`](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/events/views.py) (Event API), [`backend/registrations/models.py`](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/registrations/models.py) (Registration and passes), [`backend/reports/views.py`](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/reports/views.py) (Analytics and reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App routing<br/>[App.jsx]"]
  node_auth_ui["Auth context<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_event_ui["Event experience<br/>[EventDetails.jsx]"]
  node_student_ui["Student dashboard"]
  node_organizer_ui["Organizer console"]
  node_admin_ui["Admin console<br/>[AdminDashboard.jsx]"]
end

subgraph group_identity["Identity and governance"]
  node_accounts["Accounts and roles<br/>[models.py]"]
  node_account_api["Account API<br/>[views.py]"]
end

subgraph group_events["Events and participation"]
  node_event_api["Event API<br/>[views.py]"]
  node_event_data["Event catalog<br/>[models.py]"]
  node_registrations["Registration and passes<br/>[models.py]"]
  node_registration_api["Registration API<br/>[views.py]"]
  node_attendance["QR attendance<br/>[views.py]"]
  node_certificates["Certificates<br/>[views.py]"]
end

subgraph group_operations["Organizer operations"]
  node_clubs["Clubs and communities<br/>[views.py]"]
  node_budgets["Budgets and expenses<br/>[views.py]"]
  node_gallery["Event gallery<br/>[views.py]"]
end

subgraph group_platform["Platform services"]
  node_notifications["Notifications<br/>[views.py]"]
  node_reports["Analytics and reports<br/>[views.py]"]
  node_mysql[("MySQL database")]
end

node_users(("Campus users"))

node_users -->|"use"| node_app
node_app -->|"routes to"| node_event_ui
node_app -->|"routes to"| node_organizer_ui
node_app -->|"routes to"| node_admin_ui
node_auth_ui -->|"calls auth API"| node_api
node_event_ui -->|"calls API"| node_api
node_organizer_ui -->|"calls API"| node_api
node_student_ui -.->|"calls API"| node_api
node_admin_ui -.->|"calls API"| node_api
node_api -->|"REST requests"| node_account_api
node_api -->|"REST requests"| node_event_api
node_event_api -->|"reads and writes"| node_event_data
node_event_api -->|"queries"| node_registrations
node_event_api -->|"creates"| node_notifications
node_registration_api -->|"reads and writes"| node_registrations
node_registration_api -->|"creates"| node_notifications
node_attendance -->|"verifies passes"| node_registrations
node_attendance -->|"checks event"| node_event_data
node_certificates -->|"checks participation"| node_registrations
node_reports -->|"aggregates"| node_event_data
node_reports -->|"aggregates"| node_registrations
node_reports -->|"aggregates"| node_attendance
node_account_api -.->|"uses account data"| node_accounts
node_event_api -->|"persists event data"| node_mysql
node_registration_api -->|"persists registrations"| node_mysql
node_attendance -->|"persists check-ins"| node_mysql
node_certificates -->|"stores credentials"| node_mysql
node_clubs -->|"stores communities"| node_mysql
node_budgets -->|"stores budgets"| node_mysql
node_gallery -->|"stores gallery data"| node_mysql
node_notifications -.->|"stores notifications"| node_mysql
node_reports -->|"queries metrics"| node_mysql

click node_app "https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/App.jsx"
click node_auth_ui "https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/services/api.js"
click node_event_ui "https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/EventDetails/EventDetails.jsx"
click node_student_ui "https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/dashboards/StudentDashboard.jsx"
click node_organizer_ui "https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/dashboards/OrganizerDashboard.jsx"
click node_admin_ui "https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/dashboards/AdminDashboard.jsx"
click node_accounts "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/accounts/models.py"
click node_account_api "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/accounts/views.py"
click node_event_api "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/events/views.py"
click node_event_data "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/events/models.py"
click node_registrations "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/registrations/models.py"
click node_registration_api "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/registrations/views.py"
click node_attendance "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/attendance/views.py"
click node_certificates "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/certificates/views.py"
click node_clubs "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/clubs/views.py"
click node_budgets "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/budgets/views.py"
click node_gallery "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/gallery/views.py"
click node_notifications "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/notifications/views.py"
click node_reports "https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/reports/views.py"

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_app,node_auth_ui,node_api,node_event_ui,node_student_ui,node_organizer_ui,node_admin_ui,node_users toneBlue
class node_accounts,node_account_api toneAmber
class node_event_api,node_event_data,node_registrations,node_registration_api,node_attendance,node_certificates toneMint
class node_clubs,node_budgets,node_gallery toneRose
class node_notifications,node_reports,node_mysql toneIndigo
```

## Components

### Web client

- [App routing](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth context](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Event experience](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/EventDetails/EventDetails.jsx): `frontend/src/pages/EventDetails/EventDetails.jsx`
- [Student dashboard](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/dashboards/StudentDashboard.jsx): `frontend/src/pages/dashboards/StudentDashboard.jsx`
- [Organizer console](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/dashboards/OrganizerDashboard.jsx): `frontend/src/pages/dashboards/OrganizerDashboard.jsx`
- [Admin console](https://github.com/424137-ship-it/college-event-management-system/blob/main/frontend/src/pages/dashboards/AdminDashboard.jsx): `frontend/src/pages/dashboards/AdminDashboard.jsx`

### Identity and governance

- [Accounts and roles](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/accounts/models.py): `backend/accounts/models.py`
- [Account API](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/accounts/views.py): `backend/accounts/views.py`

### Events and participation

- [Event API](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/events/views.py): `backend/events/views.py`
- [Event catalog](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/events/models.py): `backend/events/models.py`
- [Registration and passes](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/registrations/models.py): `backend/registrations/models.py`
- [Registration API](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/registrations/views.py): `backend/registrations/views.py`
- [QR attendance](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/attendance/views.py): `backend/attendance/views.py`
- [Certificates](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/certificates/views.py): `backend/certificates/views.py`

### Organizer operations

- [Clubs and communities](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/clubs/views.py): `backend/clubs/views.py`
- [Budgets and expenses](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/budgets/views.py): `backend/budgets/views.py`
- [Event gallery](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/gallery/views.py): `backend/gallery/views.py`

### Platform services

- [Notifications](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/notifications/views.py): `backend/notifications/views.py`
- [Analytics and reports](https://github.com/424137-ship-it/college-event-management-system/blob/main/backend/reports/views.py): `backend/reports/views.py`
- **MySQL database**

### Other components

- **Campus users**

## Connections

- Campus users → App routing: use (evidence: `README.md`)
- App routing → Event experience: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Organizer console: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Admin console: routes to (evidence: `frontend/src/App.jsx`)
- Auth context → API client: calls auth API (evidence: `frontend/src/context/AuthContext.jsx`)
- Event experience → API client: calls API (evidence: `frontend/src/pages/EventDetails/EventDetails.jsx`)
- Organizer console → API client: calls API (evidence: `frontend/src/pages/dashboards/OrganizerDashboard.jsx`)
- Student dashboard → API client: calls API
- Admin console → API client: calls API
- API client → Account API: REST requests (evidence: `README.md`)
- API client → Event API: REST requests (evidence: `README.md`)
- Event API → Event catalog: reads and writes (evidence: `backend/events/views.py`)
- Event API → Registration and passes: queries (evidence: `backend/events/views.py`)
- Event API → Notifications: creates (evidence: `backend/events/views.py`)
- Registration API → Registration and passes: reads and writes (evidence: `backend/registrations/views.py`)
- Registration API → Notifications: creates (evidence: `backend/registrations/views.py`)
- QR attendance → Registration and passes: verifies passes (evidence: `backend/attendance/views.py`)
- QR attendance → Event catalog: checks event (evidence: `backend/attendance/views.py`)
- Certificates → Registration and passes: checks participation (evidence: `backend/certificates/views.py`)
- Analytics and reports → Event catalog: aggregates (evidence: `backend/reports/views.py`)
- Analytics and reports → Registration and passes: aggregates (evidence: `backend/reports/views.py`)
- Analytics and reports → QR attendance: aggregates (evidence: `backend/reports/views.py`)
- Account API → Accounts and roles: uses account data
- Event API → MySQL database: persists event data (evidence: `README.md`)
- Registration API → MySQL database: persists registrations (evidence: `README.md`)
- QR attendance → MySQL database: persists check-ins (evidence: `README.md`)
- Certificates → MySQL database: stores credentials (evidence: `README.md`)
- Clubs and communities → MySQL database: stores communities (evidence: `README.md`)
- Budgets and expenses → MySQL database: stores budgets (evidence: `README.md`)
- Event gallery → MySQL database: stores gallery data (evidence: `README.md`)
- Notifications → MySQL database: stores notifications
- Analytics and reports → MySQL database: queries metrics (evidence: `README.md`)
