# abdulwasim-s/event-management-system architecture

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

## Overview

This is a Spring-based event management API. Users browse events, register or sign in, create bookings with Razorpay, confirm payment, and receive QR-code tickets by email or through their ticket listing. Admin endpoints manage events and users and expose booking/dashboard statistics. The graph follows evidenced controller/service calls and the sampled persistence and payment logic; some controllers, security configuration, and service internals were not excerpted, so uncertain links are omitted.

Main entry points: [`src/main/java/com/management/event_management_system/service/BookingService.java`](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/BookingService.java) (Booking and payment), [`src/main/java/com/management/event_management_system/service/UserService.java`](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/UserService.java) (User accounts), [`src/main/java/com/management/event_management_system/repository/UserRepository.java`](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/UserRepository.java) (User repository), [`src/main/java/com/management/event_management_system/repository/EventRepository.java`](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/EventRepository.java) (Event repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API workflows"]
  node_auth_api["Auth endpoints"]
  node_event_api["Event endpoints"]
  node_booking_api["Booking endpoints"]
  node_user_api["User endpoints"]
  node_admin_api["Admin endpoints"]
  node_dtos["Request and response DTOs"]
end

subgraph group_services["Domain services"]
  node_user_service["User accounts<br/>[UserService.java]"]
  node_event_service["Event catalog<br/>[EventService.java]"]
  node_booking_service["Booking and payment"]
  node_dashboard_service["Dashboard statistics"]
  node_qr_util["QR generation<br/>[QRCodeUtil.java]"]
end

subgraph group_security["Authentication"]
  node_jwt_util["JWT utilities<br/>[JwtUtil.java]"]
  node_jwt_filter["JWT filter"]
  node_user_details["User lookup"]
  node_security_config["Security rules"]
  node_scheduler["Self-ping scheduler"]
end

subgraph group_persistence["Mongo persistence"]
  node_user_repo[("User repository")]
  node_event_repo[("Event repository")]
  node_booking_repo[("Booking repository")]
  node_user_model["User record<br/>[User.java]"]
  node_event_model["Event record<br/>[Event.java]"]
  node_booking_model["Booking record<br/>[Booking.java]"]
end

subgraph group_integrations["External integrations"]
  node_razorpay["Razorpay"]
  node_email["Email service"]
end

node_client(("API client"))
node_admin_actor(("Administrator"))

node_client -->|"sends requests"| node_auth_api
node_client -->|"browses events"| node_event_api
node_client -->|"books events"| node_booking_api
node_client -->|"requests account"| node_user_api
node_admin_actor -->|"manages platform"| node_admin_api
node_auth_api -->|"delegates auth"| node_user_service
node_event_api -->|"delegates events"| node_event_service
node_booking_api -->|"delegates bookings"| node_booking_service
node_user_api -->|"delegates users"| node_user_service
node_admin_api -->|"loads statistics"| node_dashboard_service
node_admin_api -->|"manages users"| node_user_service
node_admin_api -->|"loads bookings"| node_booking_service
node_auth_api -->|"accepts login DTO"| node_dtos
node_booking_api -->|"accepts booking DTOs"| node_dtos
node_event_api -->|"accepts event DTO"| node_dtos
node_user_service -->|"reads and writes"| node_user_repo
node_user_service -->|"searches events"| node_event_repo
node_user_service -->|"loads tickets"| node_booking_repo
node_user_service -->|"issues tokens"| node_jwt_util
node_user_service -->|"generates ticket QR"| node_qr_util
node_event_service -->|"stores events"| node_event_repo
node_booking_service -->|"loads event"| node_event_repo
node_booking_service -->|"resolves attendee"| node_user_repo
node_booking_service -->|"stores bookings"| node_booking_repo
node_booking_service -->|"reads token"| node_jwt_util
node_booking_service -->|"creates payment order"| node_razorpay
node_booking_service -->|"sends ticket"| node_email
node_dashboard_service -->|"counts and loads"| node_event_repo
node_dashboard_service -->|"aggregates bookings"| node_booking_repo
node_dashboard_service -->|"counts users"| node_user_repo
node_jwt_filter -->|"validates tokens"| node_jwt_util
node_user_details -->|"loads account"| node_user_repo
node_user_repo -->|"persists"| node_user_model
node_event_repo -->|"persists"| node_event_model
node_booking_repo -->|"persists"| node_booking_model

click node_auth_api "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/AuthController.java"
click node_event_api "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/EventController.java"
click node_booking_api "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/BookingController.java"
click node_user_api "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/UserController.java"
click node_admin_api "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/AdminController.java"
click node_user_service "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/UserService.java"
click node_event_service "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/EventService.java"
click node_booking_service "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/BookingService.java"
click node_dashboard_service "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/DashboardService.java"
click node_qr_util "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/util/QRCodeUtil.java"
click node_jwt_util "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/JwtUtil.java"
click node_jwt_filter "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/JwtAuthenticationFilter.java"
click node_user_details "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/CustomUserDetailsService.java"
click node_security_config "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/SecurityConfig.java"
click node_user_repo "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/UserRepository.java"
click node_event_repo "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/EventRepository.java"
click node_booking_repo "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/BookingRepository.java"
click node_user_model "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/model/User.java"
click node_event_model "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/model/Event.java"
click node_booking_model "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/model/Booking.java"
click node_dtos "https://github.com/abdulwasim-s/event-management-system/tree/main/src/main/java/com/management/event_management_system/dto"
click node_scheduler "https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/SelfPingScheduler.java"

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_auth_api,node_event_api,node_booking_api,node_user_api,node_admin_api,node_dtos,node_client toneBlue
class node_user_service,node_event_service,node_booking_service,node_dashboard_service,node_qr_util toneAmber
class node_jwt_util,node_jwt_filter,node_user_details,node_security_config,node_scheduler toneMint
class node_user_repo,node_event_repo,node_booking_repo,node_user_model,node_event_model,node_booking_model toneRose
class node_razorpay,node_email,node_admin_actor toneIndigo
```

## Components

### API workflows

- [Auth endpoints](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/AuthController.java): `src/main/java/com/management/event_management_system/controller/AuthController.java`
- [Event endpoints](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/EventController.java): `src/main/java/com/management/event_management_system/controller/EventController.java`
- [Booking endpoints](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/BookingController.java): `src/main/java/com/management/event_management_system/controller/BookingController.java`
- [User endpoints](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/UserController.java): `src/main/java/com/management/event_management_system/controller/UserController.java`
- [Admin endpoints](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/controller/AdminController.java): `src/main/java/com/management/event_management_system/controller/AdminController.java`
- [Request and response DTOs](https://github.com/abdulwasim-s/event-management-system/tree/main/src/main/java/com/management/event_management_system/dto): `src/main/java/com/management/event_management_system/dto`

### Domain services

- [User accounts](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/UserService.java): `src/main/java/com/management/event_management_system/service/UserService.java`
- [Event catalog](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/EventService.java): `src/main/java/com/management/event_management_system/service/EventService.java`
- [Booking and payment](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/BookingService.java): `src/main/java/com/management/event_management_system/service/BookingService.java`
- [Dashboard statistics](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/service/DashboardService.java): `src/main/java/com/management/event_management_system/service/DashboardService.java`
- [QR generation](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/util/QRCodeUtil.java): `src/main/java/com/management/event_management_system/util/QRCodeUtil.java`

### Authentication

- [JWT utilities](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/JwtUtil.java): `src/main/java/com/management/event_management_system/config/JwtUtil.java`
- [JWT filter](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/JwtAuthenticationFilter.java): `src/main/java/com/management/event_management_system/config/JwtAuthenticationFilter.java`
- [User lookup](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/CustomUserDetailsService.java): `src/main/java/com/management/event_management_system/config/CustomUserDetailsService.java`
- [Security rules](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/SecurityConfig.java): `src/main/java/com/management/event_management_system/config/SecurityConfig.java`
- [Self-ping scheduler](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/config/SelfPingScheduler.java): `src/main/java/com/management/event_management_system/config/SelfPingScheduler.java`

### Mongo persistence

- [User repository](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/UserRepository.java): `src/main/java/com/management/event_management_system/repository/UserRepository.java`
- [Event repository](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/EventRepository.java): `src/main/java/com/management/event_management_system/repository/EventRepository.java`
- [Booking repository](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/repository/BookingRepository.java): `src/main/java/com/management/event_management_system/repository/BookingRepository.java`
- [User record](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/model/User.java): `src/main/java/com/management/event_management_system/model/User.java`
- [Event record](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/model/Event.java): `src/main/java/com/management/event_management_system/model/Event.java`
- [Booking record](https://github.com/abdulwasim-s/event-management-system/blob/main/src/main/java/com/management/event_management_system/model/Booking.java): `src/main/java/com/management/event_management_system/model/Booking.java`

### External integrations

- **Razorpay**
- **Email service**

### Other components

- **API client**
- **Administrator**

## Connections

- API client → Auth endpoints: sends requests (evidence: `src/main/java/com/management/event_management_system/controller/AuthController.java`)
- API client → Event endpoints: browses events (evidence: `src/main/java/com/management/event_management_system/controller/EventController.java`)
- API client → Booking endpoints: books events (evidence: `src/main/java/com/management/event_management_system/controller/BookingController.java`)
- API client → User endpoints: requests account (evidence: `src/main/java/com/management/event_management_system/controller/UserController.java`)
- Administrator → Admin endpoints: manages platform (evidence: `src/main/java/com/management/event_management_system/controller/AdminController.java`)
- Auth endpoints → User accounts: delegates auth (evidence: `src/main/java/com/management/event_management_system/controller/AuthController.java`)
- Event endpoints → Event catalog: delegates events (evidence: `src/main/java/com/management/event_management_system/controller/EventController.java`)
- Booking endpoints → Booking and payment: delegates bookings (evidence: `src/main/java/com/management/event_management_system/controller/BookingController.java`)
- User endpoints → User accounts: delegates users (evidence: `src/main/java/com/management/event_management_system/controller/UserController.java`)
- Admin endpoints → Dashboard statistics: loads statistics (evidence: `src/main/java/com/management/event_management_system/controller/AdminController.java`)
- Admin endpoints → User accounts: manages users (evidence: `src/main/java/com/management/event_management_system/controller/AdminController.java`)
- Admin endpoints → Booking and payment: loads bookings (evidence: `src/main/java/com/management/event_management_system/controller/AdminController.java`)
- Auth endpoints → Request and response DTOs: accepts login DTO (evidence: `src/main/java/com/management/event_management_system/controller/AuthController.java`)
- Booking endpoints → Request and response DTOs: accepts booking DTOs (evidence: `src/main/java/com/management/event_management_system/controller/BookingController.java`)
- Event endpoints → Request and response DTOs: accepts event DTO (evidence: `src/main/java/com/management/event_management_system/controller/EventController.java`)
- User accounts → User repository: reads and writes (evidence: `src/main/java/com/management/event_management_system/service/UserService.java`)
- User accounts → Event repository: searches events (evidence: `src/main/java/com/management/event_management_system/service/UserService.java`)
- User accounts → Booking repository: loads tickets (evidence: `src/main/java/com/management/event_management_system/service/UserService.java`)
- User accounts → JWT utilities: issues tokens (evidence: `src/main/java/com/management/event_management_system/service/UserService.java`)
- User accounts → QR generation: generates ticket QR (evidence: `src/main/java/com/management/event_management_system/service/UserService.java`)
- Event catalog → Event repository: stores events (evidence: `src/main/java/com/management/event_management_system/service/EventService.java`)
- Booking and payment → Event repository: loads event (evidence: `src/main/java/com/management/event_management_system/service/BookingService.java`)
- Booking and payment → User repository: resolves attendee (evidence: `src/main/java/com/management/event_management_system/service/BookingService.java`)
- Booking and payment → Booking repository: stores bookings (evidence: `src/main/java/com/management/event_management_system/service/BookingService.java`)
- Booking and payment → JWT utilities: reads token (evidence: `src/main/java/com/management/event_management_system/service/BookingService.java`)
- Booking and payment → Razorpay: creates payment order (evidence: `src/main/java/com/management/event_management_system/service/BookingService.java`)
- Booking and payment → Email service: sends ticket (evidence: `src/main/java/com/management/event_management_system/service/BookingService.java`)
- Dashboard statistics → Event repository: counts and loads (evidence: `src/main/java/com/management/event_management_system/service/DashboardService.java`)
- Dashboard statistics → Booking repository: aggregates bookings (evidence: `src/main/java/com/management/event_management_system/service/DashboardService.java`)
- Dashboard statistics → User repository: counts users (evidence: `src/main/java/com/management/event_management_system/service/DashboardService.java`)
- JWT filter → JWT utilities: validates tokens (evidence: `src/main/java/com/management/event_management_system/config/JwtAuthenticationFilter.java`)
- User lookup → User repository: loads account (evidence: `src/main/java/com/management/event_management_system/config/CustomUserDetailsService.java`)
- User repository → User record: persists (evidence: `src/main/java/com/management/event_management_system/repository/UserRepository.java`)
- Event repository → Event record: persists (evidence: `src/main/java/com/management/event_management_system/repository/EventRepository.java`)
- Booking repository → Booking record: persists (evidence: `src/main/java/com/management/event_management_system/repository/BookingRepository.java`)
