Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gibranfsh/cinema-sea-fullstack
A fully functional cinema website that can order seats and tickets for available movies.
https://github.com/gibranfsh/cinema-sea-fullstack
cinema js laravel php react
Last synced: 7 days ago
JSON representation
A fully functional cinema website that can order seats and tickets for available movies.
- Host: GitHub
- URL: https://github.com/gibranfsh/cinema-sea-fullstack
- Owner: gibranfsh
- Created: 2023-07-06T11:27:44.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-08-12T13:17:28.000Z (over 1 year ago)
- Last Synced: 2023-08-12T14:48:47.027Z (over 1 year ago)
- Topics: cinema, js, laravel, php, react
- Language: PHP
- Homepage:
- Size: 2.15 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
## Introduction
Welcome to Cinema SEA, the rising star in the movie theater industry! With our app, you can effortlessly browse through an extensive collection of movies at your fingertips. Enjoy the convenience of selecting showtimes, choosing your preferred seats, and securing your reservations in a matter of seconds. Say goodbye to waiting in line and hello to a seamless moviegoing experience!
## Apology
First I want to say sorry because the front-end is not responsive yet because I started this project sooo late :(, I only have like 7 days to make this project (designing UI/UX using figma and also implementing the front-end and back-end side), so I hope you make natural of it xD
## BEFORE CONTINUING
This project was built using PHP, Laravel, and React, it is very recommended to ensure that you have PHP, Composer, Laravel, Node.js (for npm) properly installed and set up before proceeding with the project. There are various resources available in the internet that provide detailed instructions on installing these dependencies.
Please note that setting up the development environment may vary depending on your operating system and personal preferences. It is important to choose a method that aligns with your requirements and follow the appropriate installation instructions.
## Configuration for environment variables
You can follow my installation steps (after this section), I put the source-code of the `.env` files there.
## Installations
1. Clone the repository
```
git clone https://github.com/gibranfsh/cinema-sea-fullstack.git
```
2. Move to the folder
```
cd cinema-sea-fullstack
```
3. open with VSCode
```
code .
```
4. Open TWO terminals in VSCode
### Terminal 1 (root)
5. Before continuing, configure the environment variables (.env) file, you can copy and paste it or just simply delete ".example" from "env.example"
```
APP_NAME=Laravel
APP_ENV=local
APP_KEY=
APP_DEBUG=true
APP_URL=http://localhost
LOG_CHANNEL=stack
LOG_DEPRECATIONS_CHANNEL=null
LOG_LEVEL=debug
DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=main
# DB_USERNAME=root
# DB_PASSWORD=
BROADCAST_DRIVER=log
CACHE_DRIVER=file
FILESYSTEM_DISK=local
QUEUE_CONNECTION=sync
SESSION_DRIVER=file
SESSION_LIFETIME=120
MEMCACHED_HOST=127.0.0.1
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
MAIL_MAILER=smtp
MAIL_HOST=mailpit
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="[email protected]"
MAIL_FROM_NAME="${APP_NAME}"
AWS_ACCESS_KEY_ID=
AWS_SECRET_ACCESS_KEY=
AWS_DEFAULT_REGION=us-east-1
AWS_BUCKET=
AWS_USE_PATH_STYLE_ENDPOINT=false
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
PUSHER_HOST=
PUSHER_PORT=443
PUSHER_SCHEME=https
PUSHER_APP_CLUSTER=mt1
VITE_PUSHER_APP_KEY="${PUSHER_APP_KEY}"
VITE_PUSHER_HOST="${PUSHER_HOST}"
VITE_PUSHER_PORT="${PUSHER_PORT}"
VITE_PUSHER_SCHEME="${PUSHER_SCHEME}"
VITE_PUSHER_APP_CLUSTER="${PUSHER_APP_CLUSTER}"
```
6. Back to the terminal, install the node_modules and stuff
```
npm run dev
```
7. Run this to install the dependencies
```
composer install
```
#### ERROR SOLUTIONS
If you guys facing this error with a long red box saying :
```
Your lock file does not contain a compatible set of packages. Please run composer update
```
Then execute this command one by one, it may take awhile, for me its about 30 minutes :(, yeah I know im very sorry because I don't know this will be happen, but trust me it works!
```
composer install --ignore-platform-reqs
composer update --ignore-platform-req=ext-fileinfo
```
8. Then run the migration files
```
php artisan migrate
```
#### Error Solutions
If you guys facing the error saying this :
```
Illuminate\Database\QueryException
could not find driver (Connection: sqlite, SQL: PRAGMA foreign_keys = ON;)
```
First, check where the php.ini located in your machine by executing :
```
php --ini
```
For me the result is like this
```
Configuration File (php.ini) Path:
Loaded Configuration File: C:\Program Files\php-8.2.8\php.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed: (none)
```
Then, go to the directory where the Loaded Configuration File located (for me its C:\Program Files\php-8.2.8\php.ini) just use the basic windows file explorer!
After that, select the file named "php" with type file of "Configuration Settings" (NOT THE php.ini-development and NOT THE php.ini-production), and then right click and open with VSCode.
And then, change ";extension=pdo_sqlite" to "extension=pdo_sqlite" and ";extension=sqlite3" to "extension=sqlite3", JUST REMOVE THE SEMI-COLON (";"). After that, save the file (CTRL + S), if you cannot save the file, just click the "Retry as Admin..." at the showing popup at the right bottom of your screen.
```
";extension=pdo_sqlite" remove the /;/, it should look like this "extension=pdo_sqlite"
and
";extension=sqlite3" remove the /;/, it should look like this "extension=sqlite3"
```
After that, restart your VSCode, and then run the command again
```
php artisan migrate
```
But, if you guys got an error like this, it is fine, just continue the step. It is happening because its a migration file that got deleted and then I restored it again from recycle bin, it is okay nothing wrong keep going !
```
Illuminate\Database\QueryException
SQLSTATE[HY000]: General error: 1 duplicate column name: age (Connection: sqlite, SQL: alter table "users" add column "age" integer not null)
```
9. After that, please download a software to look inside the database, I recommend you using the "DB Browser for SQLite" its free and won't take long to download and install (3 to 5 minutes), after you finished installing it, open the DB Browser for SQLite, and then click the "Open Database" at the top left, and then select the "database.sqlite" file on this directory "..\cinema-sea-fullstack\database\database.sqlite". After that you can see a lot of Tables appearing :D
10. Back to the terminal, Run the Laravel backend service for your backend server
```
php artisan serve
```
### Terminal 2 (react folder)
11. Move to the react folder
```
cd react
```
12. Configure the environment variables (.env) file, you can copy and paste it or just simply delete ".example" from "env.example"
```
VITE_API_BASE_URL=http://localhost:8000
```
13. Install the dependencies
```
npm install
```
14. Run the client application
```
npm run dev
```
15. The application is ready to be used.
## Database
I use sqlite for the database, if you want to look inside the database you can use something like DB Browser for sqlite or DB Viewer, but I really recommend you to use DB Browser if you want to look inside the database (you can see tables, etc). You can open the database.sqlite (located inside the root database folder) file with it. But make sure you have configure your environment variables
# API Documentation
## Table of Contents
- [Authentication](#authentication)
- [Register a User](#register-a-user)
- [User Login](#user-login)
- [User Logout](#user-logout)
- [Users](#users)
- [Get User Details](#get-user-details)
- [Create a User](#create-a-user)
- [Seats](#seats)
- [Create a Seat](#create-a-seat)
- [Get Seats by Movie ID](#get-seats-by-movie-id)
- [Update a Seat](#update-a-seat)
- [Tickets](#tickets)
- [Create a Ticket](#create-a-ticket)
- [Get Tickets by User ID](#get-tickets-by-user-id)
- [Delete a Ticket](#delete-a-ticket)
## Authentication
### Register a User
- URL: `/register`
- Method: `POST`
- Description: Register a new user.
- Request Body:
- `name` (string): The name of the user.
- `email` (string): The email address of the user.
- `password` (string): The password for the user.
### User Login
- URL: `/login`
- Method: `POST`
- Description: Authenticate user and generate an access token.
- Request Body:
- `email` (string): The email address of the user.
- `password` (string): The password for the user.
### User Logout
- URL: `/logout`
- Method: `POST`
- Description: Invalidate the user's access token and log them out.
## Users
### Get User Details
- URL: `/users/{id}`
- Method: `GET`
- Description: Get details of a specific user.
- Request Parameters:
- `id` (integer): The ID of the user.
### Create a User
- URL: `/users`
- Method: `POST`
- Description: Create a new user.
- Request Body:
- `name` (string): The name of the user.
- `email` (string): The email address of the user.
- `password` (string): The password for the user.
## Seats
### Create a Seat
- URL: `/seats`
- Method: `POST`
- Description: Create a new seat.
- Request Body:
- `movie_id` (integer): The ID of the movie associated with the seat.
- `seat_number` (string): The seat number.
### Get Seats by Movie ID
- URL: `/seats/{movie_id}`
- Method: `GET`
- Description: Get all seats for a specific movie.
- Request Parameters:
- `movie_id` (integer): The ID of the movie.
### Update a Seat
- URL: `/seats/{movie_id}`
- Method: `PUT`
- Description: Update the details of a seat.
- Request Parameters:
- `movie_id` (integer): The ID of the movie associated with the seat.
- Request Body:
- `seat_number` (string): The updated seat number.
## Tickets
### Create a Ticket
- URL: `/tickets`
- Method: `POST`
- Description: Create a new ticket.
- Request Body:
- `user_id` (integer): The ID of the user who ordered the ticket.
- `movie_id` (integer): The ID of the movie associated with the ticket.
- `date` (string): The date of the ticket.
- `time` (string): The time of the ticket.
- `seats` (array): An array of seat numbers.
- `total_price` (numeric): The total price of the ticket.
### Get Tickets by User ID
- URL: `/tickets/{user_id}`
- Method: `GET`
- Description: Get all tickets for a specific user.
- Request Parameters:
- `user_id` (integer): The ID of the user.
### Delete a Ticket
- URL: `/tickets/{id}`
- Method: `DELETE`
- Description: Delete a specific ticket.
- Request Parameters:
- `id` (integer): The ID of the ticket.