SkyPulse Airline Management System ✈️

A modern airline management system with Multi-Guard authentication, and dual interface (API + Blade). Built with Laravel 11 and Tailwind CSS.

🌟 Key Features

Role-Based Access Control

• Admin Panel

  • Complete system administration
  • Flight management
  • User management
  • Booking oversight
  • Analytics dashboard
  • System configuration

• User Interface

  • Flight search and booking
  • Booking history
  • Profile management
  • Email notifications

• Guest Access

  • Read-only access

Advanced Security Features

• Multi-Guard Authentication
• CSRF Protection
• Rate Limiting
• Password Confirmation
• Session Management
• API Token Authentication

Modern Interface

• Responsive Design
• Real-time Updates
• Interactive Maps
• Dynamic Search
• Filtering System

📸 Application Screenshots

Public Pages

Home Page

Welcome to SkyPulse - Your Gateway to the Skies

Authentication

Login Page

Secure login interface for user

Login Page for Admin

Secure login interface for admin

User Dashboard

Main Dashboard

User's personalized dashboard with booking history

Flight Search

Advanced flight search interface

Flight Details

Detailed view of flight information

Admin Panel

Admin Dashboard

Comprehensive admin control panel

🛠 Technology Stack

Backend

• Laravel 11
• PHP 8.1+
• MySQL/PostgreSQL
• Laravel Sanctum
• Laravel Breeze

Frontend

• Blade Components
• Tailwind CSS
• Alpine.js
• Livewire

Development Tools

• PHPUnit
• Xdebug
• Composer
• NPM
• Git

🔎📝 Installation Requirements

System Requirements

• PHP >= 8.1
• MySQL >= 8.0
• Node.js >= 16.x
• Composer
• Git

Development Environment

• XAMPP/WAMP/MAMP
• VSCode/PhpStorm
• Postman/Insomnia
• Git
• xdebug (for test coverage)

🔧⚙️ Installation

1. Clone the repository:

git clone https://github.com/issamchlf/SkyPulse.git
cd SkyPulse

2. Install dependencies:

composer install
npm install

3. Environment setup:

cp .env.example .env
php artisan key:generate

4. Configure database in .env:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=SkyPulse
DB_USERNAME=your_username
DB_PASSWORD=your_password

5. Database setup:

php artisan migrate:fresh --seed

6. Start development servers:

# Terminal 1
npm run dev

# Terminal 2
php artisan serve

🏃‍♂️🧪 Running Tests

Test Coverage Setup

1. Uncomment the following lines in phpunit.xml:

<php>
    <ini name="xdebug.mode" value="coverage"/>
    <ini name="xdebug.start_with_request" value="1"/>
</php>

2. Run tests with coverage:

php artisan test --coverage

Current test coverage: 73.6%

📊📁 Database Structure

Key Relationships

• Users → Reservations (One-to-Many)
• Flights → Reservations (One-to-Many)
• Planes → Flights (One-to-Many)
• Airlines → Planes (One-to-Many)

📡🌐 API Documentation

Authentication Endpoints

POST /login
POST /logout
POST /register
POST /admin/login

Flight Management

GET    /api/flights
GET    /api/flights/{id}
POST   /api/flights
PUT    /api/flights/{id}
DELETE /api/flights/{id}

Plane Management

GET    /api/planes
GET    /api/planes/{id}
POST   /api/planes
PUT    /api/planes/{id}
DELETE /api/planes/{id}

🛠️🚀 Technologies & Tools

✍️🙍 Authors

| Issam Chellaf |

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📞 Support

For support, email [email protected] .