Buss Booking System

About The Project
- Built With
Getting Started
- Prerequisites
- Installation
Usage
API
Database Digram
Testing
Images
Contributing
License

About The Project

Built With

Laravel V10.13.0
Filament V2.17.44
Bootstrap V5.3.0

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

This is an example of how to list things you need to Prepare.

Local Server Or Live Server
PHP Version 8.1.7
Composer Download From Here
Command Line and I prefer Git Bash You Can download it From Here

Installation

Clone the repo

git clone https://github.com/EGYWEB-Mohamed/Buss-booking-system.git

Install Required packages With composer
```
composer install
```
Copy .env.example file and rename it with .env
```
  cp .env.example .env
```
Generate Key
```
php artisan key:generate
```
Create Two Database
- Testing DB_TEST_DATABASE
- Live DB_DATABASE
Fill .env File With Important Data
```
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=
```

Then Run To Migrate All Database Also to seed with dummy data

php artisan migrate --seed

Account Credential

Admin

Email : admin@test.com
Password :  123456789

Client

Email : client@test.com
Password :  123456789

If your using local server don't forget to run php artisan serv or you can navigate from localhost correct installation path
Want To Test The Whole Application and functionality ? Easy Jump To This Part

Usage

Robusta studio wants to build a fleet-management system (bus-booking system) Having:

Egypt cities as stations [Cairo, Giza, AlFayyum, AlMinya, Asyut...]
Predefined trips between 2 stations that cross over in-between stations. ex: Cairo to Asyut trip that crosses over AlFayyum -firstly- then AlMinya.
Bus for each trip, each bus has 12 available seats to be booked by users, each seat has an unique id.
Users can book an available trip seat.

For example we have Cairo-Asyut trip that crosses over AlFayyum -firstly- then AlMinya: any user can book a seat for any of these criteria (Cairo to AlFayyum), (Cairo to AlMinya), (Cairo to Asyut), (AlFayyum to AlMinya), (AlFayyum to Asyut) or (AlMinya to Asyut) if there is an available seat, taking into consideration if the bus is full from Cairo to AlMinya, the user cannot book any seat from AlFayyum but he can book from AlMinya. We require the following: Implement a solution for this case using a Relational-Database and Laravel web app that provides 2 APIs for any consumer(ex: web app, mobile app,...)
- User can book a seat if there is an available seat.
- User can get a list of available seats to be booked for his trip by sending start and end stations.

Api

The System integrated with ready to use API. Just download This collection and open it with Postman.

Also, here's live Documentation.

Note Required Auth Directory is required Bearer Token So pass it

Digram

Images

Testing

When You Finish Setup the application you can easily run

php artisan test

You Got Green Pass So What you are waiting for 😂

Test Cases Coverage:

✔️ Check home page without auth if redirect to log in ?
✔️ is user can log in successfully ?
✔️ is user can see reservation from in home page ?
✔️ is search from work as expected ?
✔️ is reservation work ?

5 Test Case With 17 assertions

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

EGYWEB-Mohamed/Buss-booking-system