Skip to content
This repository has been archived by the owner on Feb 24, 2024. It is now read-only.

Latest commit

 

History

History
363 lines (237 loc) · 9.54 KB

README.md

File metadata and controls

363 lines (237 loc) · 9.54 KB
Raw

Cinema-Booking

Movie ticket booking web application with MERN stack (MongoDB, Express, React, NodeJS) & Tailwind CSS

Demo: https://cinema-booking-client.vercel.app/

Table of Contents

Project Purpose

The purpose of this project is to improve my full-stack web development skills, learning front-end technologies like React and Tailwind CSS, and backend technologies like Node.js, Express, and MongoDB.

Technologies

  • React v18.2.0
  • React Router Dom v6.14.2
  • React Hook Form v7.45.4
  • Tailwind CSS v3.3.3
  • Vite v4.4.8
  • NodeJS
  • Mongoose v7.4.2
  • Express v4.18.2
  • MongoDB
  • And more...

Quick Tour

Home Page 🎥

Responsive Design 📱

Cinema Page 🏢

View Schedule 🕙

Book Seats 💺

View Tickets 🎫

Add a Movie 🍿

Search Showtimes 🔎

Manage Users 🕵️

Guide

🧩 Role / Feature

There are 3 roles on this website with corresponding permissions:

Role Permisson / Feature
👀 Viewer (Not logged in) 1. View released showtimes by choosing from
 - Movie in home page
 - Cinema's theater in cinema page
 - Cinema's schedule in schedule page
2. View released showtimes for today and the future
3. View seats for released showtimes on the showtime page
👤 User 1. All Viewer permissions
2. Purchase tickets on the showtime page
3. View purchased tickets on the ticket page
👑 Admin 1. All User permissions
2. View all showtimes for any date
3. Manage cinemas
4. Manage theaters
 - View theater's row, column, seats information
5. Manage showtimes
 - Search & filter & sort showtimes
 - View details of booked seats
6. Manage movies
7. Manage user & admin

👀 Viewer

Viewer have access to these pages for viewing released showtimes.

Home page
  1. Select a movie
  1. Select a date by either typing it into the input or selecting from the calendar to view showtimes
  1. Optionally, select a cinema to filter
  1. Click on a showtime to view seats
Cinema page
  1. Select a cinema
  1. Select a date to view its theaters and showtimes
  1. Click on a showtime to view seats
Schedule page
  1. Select a cinema
  1. Select a date to view its schedule for each theater
  1. Click on a showtime to view seats
Showtime page
  1. View available seats (white boxes) and unavailable seats (gray boxes)
  1. Viewer will be redirected to the login page if they click "Purchase"

👤 User

User have all viewer permission. Including, the ability to purchase and view their own tickets

Register / Login
  1. To create an user account, fill in a username, email, and password, then click "Register"
  1. To log in, fill in username and password, then click "Login"
Showtime page / Purchase tickets
  1. Select available seats
  1. Click the "Purchase" button and confirm to purchase tickets
Ticket page
  1. View purchased tickets

👑 Admin

Admin have all permission.

Create an admin account
  1. Register a new user.
  2. Access MongoDB and locate the user's data.
  3. Update the user's role to admin.
  4. The user will now become admin.

Note: After obtaining the first admin account, this user can assign admin roles to others using the User page.

Home page
  1. Admin can view theater's row, column, seats information.
  1. Admin can view all showtimes for any date
Cinema page


Add a new cinema

  1. Type the cinema's name.
  1. Click the "Add" button


Edit a cinema's name

  1. Click the "Edit" button
  1. Enter the new cinema name and click "Save"


Delete a cinema

  1. Click the "Delete" button and confirm by clicking "OK"


Add a theater to the cinema

  1. Fill the letter of the last row and the number of the last column seat, then click "Add"


Delete the last added theater

  1. Click the "Delete" button at the bottom of the page


Add showtimes

  1. Select a movie

  2. Fill in the following values:

    • Showtime: Movie start time
    • Repeat: For example, 1 means the showtime is added for today only, while 4 mean the showtime is added for today and the next 3 days.
    • Release now: Check to release this showtime for viewers and users to view or book

    Auto increase

    • Showtime: Check to automatically update the showtime value based on the ending time of this showtime, along with a specified gap. This is useful when adding consecutive movies, ensuring appropriate spacing between showtimes.
    • Date: Check to enable automatic increase of showtime to the next day if it exceeds 24 hours
    • Gap: The minimum duration between movie showtimes

    Rounding

    • 5-min: Round up the auto-increased showtime value to the nearest 5 minutes, e.g., 12:21 -> 12:25
    • 10-min: Round up the auto-increased showtime value to the nearest 10 minutes, e.g., 12:21 -> 12:30

  3. Click the "Add" button

  1. The new showtimes will added to the theater. An eye-slash icon indicates that this showtime is not yet released
Schedule page
Showtime page
  1. View details of booked seats
  2. Release, unrelease, or delete the showtime by clicking the button in the top-right corner
Movie page


Add a movie

  1. Fill in the movie name, URL of the poster, and the length in hours (optional) and minutes. Then, click "Add" to add the movie.


Delete a movie

  1. Click the "Delete" button and confirm by clicking "OK"
Search page
  1. Filter & sort showtime and select to release / unreleased / delete them
  2. Click a "View" button to view seats
User page
  1. View usernames, email addresses, roles, and tickets of users.
  2. Click the "View Tickets" button to see a user's purchased tickets.
  3. Click the "Set Admin" or "Set User" button to change the user's role.
  4. Click the "Delete" button to delete the account.

How to run the app

  1. Download the code
  2. Create .env file in /server
PORT=8080
DATABASE=<your MongoDB connection string URI>
JWT_SECRET=<any random JWT secret>
JWT_EXPIRE=30d
JWT_COOKIE_EXPIRE=30
  1. Start server side
cd server
npm install
npm start
  1. Start client side
cd client
npm install
npm run dev