# anubhavxdev/event-management-system-main architecture

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

- Interactive diagram: https://gitdiagram.com/anubhavxdev/event-management-system-main
- Repository: https://github.com/anubhavxdev/event-management-system-main

## Overview

EventOne is a full-stack event-management platform: users discover events, register and check in, then leave reviews; organizers create and manage events, while admins moderate them. The React app routes users to role-specific dashboards and the Express API exposes the corresponding domain endpoints. Registration handles capacity, QR codes, notifications, and email; event and review controllers persist domain data. The map combines sampled calls with README capabilities and SOURCE INDEX references; some frontend-to-API interactions and unsampled features are shown only as unverified links.

Main entry points: [`backend/src/app.js`](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/app.js) (HTTP API), [`Frontendd/src/App.jsx`](https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/App.jsx) (Web router), [`backend/src/controllers/registrationController.js`](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/registrationController.js) (Registration and check-in), [`backend/src/models`](https://github.com/anubhavxdev/event-management-system-main/tree/main/backend/src/models) (Domain records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_webapp["Web router<br/>[App.jsx]"]
  node_authstate["Authentication state<br/>[AuthContext.jsx]"]
  node_attendeedash["Attendee dashboard"]
  node_organizerdash["Organizer dashboard"]
  node_admindash["Admin dashboard<br/>[AdminDashboard.jsx]"]
end

subgraph group_api["API and access"]
  node_apiapp["HTTP API<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_eventroutes["Event routes<br/>[eventRoutes.js]"]
  node_registrationroutes["Registration routes"]
  node_reviewroutes["Review routes<br/>[reviewRoutes.js]"]
end

subgraph group_domain["Event workflows"]
  node_eventlogic["Event management<br/>[eventController.js]"]
  node_registrationlogic["Registration and check-in"]
  node_reviewlogic["Event reviews"]
  node_adminlogic["Moderation<br/>[adminController.js]"]
  node_notifylogic["Notifications"]
end

subgraph group_integrations["Persistence and services"]
  node_models[("Domain records")]
  node_socket["Realtime updates<br/>[socket.js]"]
  node_email["Email delivery<br/>[email.js]"]
  node_qrcode["QR generation<br/>[qrcode.js]"]
  node_cloudinary["Poster storage<br/>[cloudinary.js]"]
end

node_visitors(("Attendees"))
node_organizers(("Organizers"))
node_admins(("Administrators"))

node_visitors -->|"browse and register"| node_webapp
node_organizers -->|"manage events"| node_webapp
node_admins -->|"moderate events"| node_webapp
node_webapp -->|"checks identity"| node_authstate
node_webapp -->|"routes attendees"| node_attendeedash
node_webapp -->|"routes organizers"| node_organizerdash
node_webapp -->|"routes admins"| node_admindash
node_authstate -.->|"fetches user"| node_apiapp
node_attendeedash -.->|"uses event services"| node_apiapp
node_organizerdash -.->|"uses event services"| node_apiapp
node_admindash -.->|"uses admin services"| node_apiapp
node_apiapp -->|"mounts routes"| node_authroutes
node_apiapp -->|"mounts routes"| node_eventroutes
node_apiapp -->|"mounts routes"| node_registrationroutes
node_apiapp -->|"mounts routes"| node_reviewroutes
node_eventroutes -->|"dispatches requests"| node_eventlogic
node_registrationroutes -->|"dispatches requests"| node_registrationlogic
node_reviewroutes -->|"dispatches requests"| node_reviewlogic
node_eventlogic -->|"reads and writes"| node_models
node_registrationlogic -->|"reads and writes"| node_models
node_reviewlogic -->|"reads and writes"| node_models
node_reviewlogic -->|"updates event rating"| node_models
node_adminlogic -->|"moderates records"| node_models
node_registrationlogic -->|"generates codes"| node_qrcode
node_registrationlogic -->|"sends confirmations"| node_email
node_registrationlogic -->|"emits count"| node_socket
node_registrationlogic -->|"creates notices"| node_notifylogic
node_notifylogic -->|"publishes updates"| node_socket
node_adminlogic -->|"creates notices"| node_notifylogic
node_adminlogic -->|"sends rejection mail"| node_email
node_eventlogic -->|"manages posters"| node_cloudinary

click node_webapp "https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/App.jsx"
click node_authstate "https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/context/AuthContext.jsx"
click node_attendeedash "https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/pages/dashboard/CustomerDashboard.jsx"
click node_organizerdash "https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/pages/dashboard/OrganizerDashboard.jsx"
click node_admindash "https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/pages/dashboard/AdminDashboard.jsx"
click node_apiapp "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/app.js"
click node_authroutes "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/authRoutes.js"
click node_eventroutes "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/eventRoutes.js"
click node_registrationroutes "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/registrationRoutes.js"
click node_reviewroutes "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/reviewRoutes.js"
click node_eventlogic "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/eventController.js"
click node_registrationlogic "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/registrationController.js"
click node_reviewlogic "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/reviewController.js"
click node_adminlogic "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/adminController.js"
click node_notifylogic "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/notificationController.js"
click node_models "https://github.com/anubhavxdev/event-management-system-main/tree/main/backend/src/models"
click node_socket "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/services/socket.js"
click node_email "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/utils/email.js"
click node_qrcode "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/utils/qrcode.js"
click node_cloudinary "https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/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_webapp,node_authstate,node_attendeedash,node_organizerdash,node_admindash toneBlue
class node_apiapp,node_authroutes,node_eventroutes,node_registrationroutes,node_reviewroutes toneAmber
class node_eventlogic,node_registrationlogic,node_reviewlogic,node_adminlogic,node_notifylogic toneMint
class node_models,node_socket,node_email,node_qrcode,node_cloudinary toneRose
class node_visitors,node_organizers,node_admins toneIndigo
```

## Components

### Web application

- [Web router](https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/App.jsx): `Frontendd/src/App.jsx`
- [Authentication state](https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/context/AuthContext.jsx): `Frontendd/src/context/AuthContext.jsx`
- [Attendee dashboard](https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/pages/dashboard/CustomerDashboard.jsx): `Frontendd/src/pages/dashboard/CustomerDashboard.jsx`
- [Organizer dashboard](https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/pages/dashboard/OrganizerDashboard.jsx): `Frontendd/src/pages/dashboard/OrganizerDashboard.jsx`
- [Admin dashboard](https://github.com/anubhavxdev/event-management-system-main/blob/main/Frontendd/src/pages/dashboard/AdminDashboard.jsx): `Frontendd/src/pages/dashboard/AdminDashboard.jsx`

### API and access

- [HTTP API](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication routes](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Event routes](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/eventRoutes.js): `backend/src/routes/eventRoutes.js`
- [Registration routes](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/registrationRoutes.js): `backend/src/routes/registrationRoutes.js`
- [Review routes](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/routes/reviewRoutes.js): `backend/src/routes/reviewRoutes.js`

### Event workflows

- [Event management](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/eventController.js): `backend/src/controllers/eventController.js`
- [Registration and check-in](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/registrationController.js): `backend/src/controllers/registrationController.js`
- [Event reviews](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/reviewController.js): `backend/src/controllers/reviewController.js`
- [Moderation](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/adminController.js): `backend/src/controllers/adminController.js`
- [Notifications](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/controllers/notificationController.js): `backend/src/controllers/notificationController.js`

### Persistence and services

- [Domain records](https://github.com/anubhavxdev/event-management-system-main/tree/main/backend/src/models): `backend/src/models`
- [Realtime updates](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/services/socket.js): `backend/src/services/socket.js`
- [Email delivery](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/utils/email.js): `backend/src/utils/email.js`
- [QR generation](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/utils/qrcode.js): `backend/src/utils/qrcode.js`
- [Poster storage](https://github.com/anubhavxdev/event-management-system-main/blob/main/backend/src/config/cloudinary.js): `backend/src/config/cloudinary.js`

### Other components

- **Attendees**
- **Organizers**
- **Administrators**

## Connections

- Attendees → Web router: browse and register
- Organizers → Web router: manage events
- Administrators → Web router: moderate events (evidence: `Frontendd/src/App.jsx`)
- Web router → Authentication state: checks identity (evidence: `Frontendd/src/App.jsx`)
- Web router → Attendee dashboard: routes attendees (evidence: `Frontendd/src/App.jsx`)
- Web router → Organizer dashboard: routes organizers (evidence: `Frontendd/src/App.jsx`)
- Web router → Admin dashboard: routes admins (evidence: `Frontendd/src/App.jsx`)
- Authentication state → HTTP API: fetches user
- Attendee dashboard → HTTP API: uses event services
- Organizer dashboard → HTTP API: uses event services
- Admin dashboard → HTTP API: uses admin services
- HTTP API → Authentication routes: mounts routes (evidence: `backend/src/app.js`)
- HTTP API → Event routes: mounts routes (evidence: `backend/src/app.js`)
- HTTP API → Registration routes: mounts routes (evidence: `backend/src/app.js`)
- HTTP API → Review routes: mounts routes (evidence: `backend/src/app.js`)
- Event routes → Event management: dispatches requests (evidence: `backend/src/routes/eventRoutes.js`)
- Registration routes → Registration and check-in: dispatches requests (evidence: `backend/src/routes/registrationRoutes.js`)
- Review routes → Event reviews: dispatches requests (evidence: `backend/src/routes/reviewRoutes.js`)
- Event management → Domain records: reads and writes (evidence: `backend/src/controllers/eventController.js`)
- Registration and check-in → Domain records: reads and writes (evidence: `backend/src/controllers/registrationController.js`)
- Event reviews → Domain records: reads and writes (evidence: `backend/src/controllers/reviewController.js`)
- Event reviews → Domain records: updates event rating (evidence: `backend/src/controllers/reviewController.js`)
- Moderation → Domain records: moderates records (evidence: `backend/src/controllers/adminController.js`)
- Registration and check-in → QR generation: generates codes (evidence: `backend/src/controllers/registrationController.js`)
- Registration and check-in → Email delivery: sends confirmations (evidence: `backend/src/controllers/registrationController.js`)
- Registration and check-in → Realtime updates: emits count (evidence: `backend/src/controllers/registrationController.js`)
- Registration and check-in → Notifications: creates notices (evidence: `backend/src/controllers/registrationController.js`)
- Notifications → Realtime updates: publishes updates (evidence: `backend/src/controllers/notificationController.js`)
- Moderation → Notifications: creates notices (evidence: `backend/src/controllers/adminController.js`)
- Moderation → Email delivery: sends rejection mail (evidence: `backend/src/controllers/adminController.js`)
- Event management → Poster storage: manages posters (evidence: `backend/src/controllers/eventController.js`)
