🎬 CineTicket - Movie Review & Reservation System

A modern, secure, and scalable RESTful API for movie reviews and theater seat reservations

🌐 Live Demo: https://cineticket.onrender.com

Overview • Features • Demo • Architecture • Installation • API Reference • Security • Documentation • Contributing • Contact

📋 Overview

CineTicket is an enterprise-grade Spring Boot application that provides a comprehensive solution for movie enthusiasts. It seamlessly integrates movie reviews with theater seat reservations, offering a complete platform for users to discover movies, share opinions, and book seats for upcoming shows.

Built with modern Java and Spring technologies, this API implements industry best practices including JWT authentication, role-based access control, Stripe payment integration, PDF receipt generation, email notifications, rate limiting, and comprehensive API documentation.

The system is deployed and fully functional at https://cineticket.onrender.com.

🖥️ Frontend Demo

👨‍💼 Admin Dashboard	🧑‍💻 User Experience
Manage movies, theaters, showtimes, and view reservation data	Browse movies, read reviews, select seats, and complete the reservation process

✨ Key Features

🎬 Movie Platform	🎟️ Reservation System	🔒 Enterprise Security
• Browse & search movies• Rate & review movies• Manage user reviews• Movie recommendations	• Theater management• Showtime scheduling• Seat selection & booking• Stripe payment integration• PDF receipt generation• Email notifications	• JWT authentication• Role-based access control• Rate limiting protection• Secure transactions

🌟 Advanced Features

💳 Payment Processing	📧 Email Notifications	🎫 Reservation Management
• Stripe integration• Checkout sessions• Webhook handling• Receipt generation	• Confirmation emails• PDF attachments• Branded templates	• Interactive seat selection• Status tracking• Concurrent booking protection

🏗️ Architecture

Technology Stack

• Backend: Java 17, Spring Boot 3.2.3, Spring Data JPA
• Database: MySQL 8.0
• Security: Spring Security, JJWT 0.12.6
• API Documentation: Swagger OpenAPI 3.0
• Payment Processing: Stripe API 22.0.0
• PDF Generation: iText 5.5.13.3
• Email Service: Spring Mail
• Utilities: Lombok, Resilience4j, MessageSource
• Testing: JUnit 5, Mockito

🔍 Installation

Prerequisites

• Java 17 or higher
• Maven 3.6+
• MySQL 8.0+

Quick Start Guide

1. Clone the repository

git clone https://github.com/lakshay1341/Movie-Review-System-API.git
cd Movie-Review-System-API

2. Configure the database

CREATE DATABASE moviereviewdbupdated;

3. Configure application properties

Update src/main/resources/application.properties with your database credentials, JWT configuration, and Stripe API keys.

⚠️ Security Note: Generate a secure JWT secret using openssl rand -base64 64 and never commit it to version control.

4. Set up environment variables

Create a .env file based on the provided .env.example with your configuration.

# Copy the example file
cp .env.example .env

# Edit the .env file with your actual values
# For security, generate a new JWT secret:
openssl rand -base64 64

5. Build and run the application

mvn clean install
mvn spring-boot:run

6. Access the application

• API: http://localhost:8080
• Swagger UI: http://localhost:8080/swagger-ui/index.html

Default Credentials

The system automatically creates two users on startup:

Role	Username	Password
Admin	admin	password
User	user	password

🔥 API Reference

API Categories

🔑 Authentication

🎬 Movies

⭐ Reviews

🏛️ Theaters

📅 Showtimes