Ticket Booking API 🎟️

Overview

Welcome to the Ticket Booking API! 🚀 This API allows users to book and manage event tickets securely using JWT authentication and is built using Spring Boot with MongoDB as the database, Redis as a cache, Stripe as a gateway

Features

🔹 Admin Features:

• 🛠️ Create, update, delete, and view events.
• 📊 View all customer bookings.
• 👤 View all registered users.

🔹 User Features:

• 🎫 Book and cancel tickets.
• 💰 Add and remove balance from the wallet.
• 🔍 Filter events by various criteria (date, category, rating, etc.).
• 🔐 Secure authentication with JWT.
• ⏳ Rate limiting to prevent abuse.
• 🔔 Can receive notification on booking the ticket

Live API URL

Currently it is down, will be up soon.

API Documentation (Swagger)

Swagger UI is enabled for API testing and documentation.

👉 Swagger UI

Tech Stack 🛠️

• Spring Boot (Backend framework)
• MongoDB (NoSQL Database)
• Spring Security (JWT-based authentication)
• Stripe API (For payment processing)
• SpringDoc OpenAPI (For API documentation)

Installation & Setup ⚙️

1. Clone the Repository

$ git clone https://github.com/Progambler227788/TicketManagement-SpringBoot.git
$ cd TicketManagement-SpringBoot

2. Configure Environment Variables

Create a .env file in the root directory and set the required values:

SERVER_PORT=8080
MONGO_URI=mongodb+srv://your-username:[email protected]/ticketdb
SECRET_KEY=your-secret-key-for-jwt
STRIPE_SECRET=your-stripe-secret-key
STRIPE_API=your-stripe-api-key
REDIS_URI=your-redis-uri
REDIS_PASS=your-redis-password
REDIST_PORT=your-redis-port

3. Build & Run the Application

Using Maven:

$ mvn clean install
$ mvn spring-boot:run

The API will be accessible at http://localhost:8080

API Endpoints 📌

🔐 Authentication APIs

Method	Endpoint	Description
POST	/api/auth/signup	Register a new user
POST	/api/auth/login	Authenticate and get JWT token
PUT	/api/auth/updateProfile	Update user profile

👑 Admin APIs

Method	Endpoint	Description
POST	/api/admin/events/addEvent	Add a new event
GET	/api/admin/events/getAllEvents	Get all events
GET	/api/admin/users/getAllUsers	Get all registered users
GET	/api/admin/users/getAllBookings	Get all bookings
DELETE	/api/admin/events/{id}	Delete an event by ID
DELETE	/api/admin/events/deleteAllEvents	Delete all events

👤 User APIs

Method	Endpoint	Description
POST	/api/user/profile/bookTicket	Book a ticket
DELETE	/api/user/profile/cancelTicket	Cancel a ticket
GET	/api/user/profile/getBookings	Get user bookings
POST	/api/user/profile/wallet/addBalance	Add balance to wallet
POST	/api/user/profile/wallet/deductBalance	Deduct balance from wallet
GET	/api/user/profile/wallet/getUserBalance	Get wallet balance
GET	/api/user/profile/events/searchByCategory	Search events by category
GET	/api/user/profile/events/searchByDateRange	Search events by date range
GET	/api/user/profile/events/searchByLocation	Search events by location
GET	/api/user/profile/events/searchByTitleOrDescription	Search events by title or description

🔔 FCM Token Registration API

Method	Endpoint	Description
POST	/api/user/fcm/register	Register a Firebase Cloud Messaging (FCM) token for push notifications

Request Parameters

Parameter	Type	Description
userId	String	ID of the user
token	String	FCM device token

Response

Status Code	Description
200 OK	Token registered successfully
400 Bad Request	userId or token is missing/invalid
500 Internal Server Error	Token registration failed due to server error

Security 🛡️

• JWT Authentication: Secure endpoints require a valid JWT token.
• Role-Based Access Control (RBAC): Users must have ROLE_USER or ROLE_ADMIN to access specific endpoints.
• Rate Limiting: Protects against abuse by limiting API requests.

Contributing 🤝

Feel free to fork this project, create a feature branch, and submit a pull request. Contributions are always welcome!

---

Happy Coding! 🚀