Book Ease System

A simple, lightweight, and modern Appointment & Service Booking system built using Laravel, MySQL, and Blade. This project is ready to be uploaded to GitHub and executed.

Features Included

1. Admin Authentication: Secure login/logout system (default admin account seeded).
2. Vendor Registry: Register service vendors with business name and specialty service (e.g. Doctor for Dental Checkup, Spa for Body Massage).
3. Appointment Booking: Add booking records specifying Customer Name, Date, and selecting the corresponding Vendor/Service.
4. Interactive Agenda & Calendar List: Beautiful dashboard schedule list and master agenda showing appointments grouped by dates. Filterable by date or booking status.
5. Booking Status management: Set bookings as Pending, Confirmed, or Cancelled. Direct action buttons to Confirm or Cancel a booking are pre-included.
6. Modern UI: Styled with Bootstrap 5 (via CDN) and FontAwesome icons. Includes responsive layouts and a fresh teal/teal-light color theme.
7. Pre-included Database Dump: A database SQL file is provided to quickly load structure and seed data.

---

Installation & Setup Instructions

To run this project locally, follow these simple steps:

Prerequisites

Make sure you have the following installed on your system:

• PHP (v8.1 or higher)
• Composer
• MySQL (via XAMPP, Laragon, or standalone)

---

Step-by-Step Run Guide

1. Extract the Project

Ensure the project is in a directory of your choice.

2. Install Dependencies

Open your terminal inside the book-ease-system folder and run:

composer install

3. Database Configuration

1. Open your MySQL database manager (e.g. phpMyAdmin, Laragon, or command line).
2. Create a new empty database named book_ease_system.
3. Open the .env file in the root directory of the project and ensure the database credentials match your local MySQL configuration:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=book_ease_system
   DB_USERNAME=root
   DB_PASSWORD=

4. Setup Database Tables

You can set up the database in one of two ways:

Option A: Run Migrations & Seeders (Recommended Laravel way)

Run the migrations along with the database seeder to create tables and set up the default admin account:

php artisan migrate --seed

Option B: Import Database Dump (Pre-included)

Import the SQL file located at: database/database.sql directly into your empty book_ease_system database. This will create the schema and populate the database with the default admin user, 4 services/vendors, and 4 mock bookings.

5. Start the Application

Start the Laravel development server:

php artisan serve

The application will be running at http://127.0.0.1:8000.

---

Default Login Credentials

Use the following credentials to log in as the Administrator:

• Email: admin@bookease.com
• Password: password

---

Uploading to GitHub

This repository is fully configured for Git. You can initialize a Git repository in this folder and push it directly to GitHub:

git init
git add .
git commit -m "Initial commit: Book Ease System"
git branch -M main
git remote add origin <YOUR_GITHUB_REPOSITORY_URL>
git push -u origin main

Note: The .gitignore file is pre-configured so that temporary files and vendor directories are not uploaded.