Property Management System (PMS) & Booking Platform
booking platformAbout the Project
**فندق سدرة الفاخر (Sidra Luxury Hotel)** is an enterprise-grade **Property Management System (PMS)** and **Direct Guest Booking Platform** built with **Laravel 13**, **Livewire 4**, and **Flux UI**.
Designed with a high-end luxury aesthetic, the system provides a unified solution for hotel operations: from public guest reservations and real-time front desk management to isolated event hall booking, room asset inspection, housekeeping task orchestration, and a strict double-entry financial ledger.
The application natively supports **Bilingual Operations (Arabic default & English)** with seamless **RTL/LTR dynamic layouts** tailored to Saudi and international hospitality compliance.
---
## ✨ Key Features & Modules | المزايا والوحدات الرئيسية
### 1. 🌐 Public Guest Portal & Booking Engine
* **Luxury Showcase**: Interactive guest landing page presenting room tiers, executive suites, and banquet event halls.
* **Smart Filter & Search**: Instant filtering by room type (Standard, Suite, Deluxe), floor level, capacity, and price per night.
* **Event Hall Discovery**: Detailed breakdown of venue capacities, morning/evening rates, and multimedia equipment.
* **Add-On Services Catalog**: Optional guest add-ons including Airport Transfer, Laundry, Deep Tissue Spa, Guided City Tours, Catering, and Floral Decoration.
* **Direct Booking & Inquiries**: Guest registration flow with automated reservation alerts sent to front desk staff.
* **Language Switcher**: Instant switching between Arabic (العربية - RTL) and English (LTR).
### 2. 🛎️ Front Desk Operations Board (Smart Booking Hub)
* **Real-Time Room Occupancy Grid**: Visual interactive floor-by-floor room grid with live color-coded status badges:
* 🟢 **Available (متاح)**: Ready for guest allocation.
* 🔴 **Occupied (مشغول)**: Currently hosting checked-in guests.
* 🟡 **Dirty (بحاجة لتنظيف)**: Checked-out and queued for housekeeping.
* ⚪ **Maintenance (صيانة)**: Taken offline for technician work.
* 🟠 **Reserved (محجوز)**: Booked for incoming guest arrivals.
* **Instant Walk-In Guest Check-in**:
* Guest legal identity registration (National ID Card / Passport).
* Check-in / check-out scheduling with automatic price computation.
* Flexible settlement choices: Cash, Credit Card POS Terminal, Bank Deposit, or Pay at Checkout.
* **Stay Extensions**: Fast stay renewal with automatic date conflict validation and incremental billing.
* **Check-Out Settlement**: Quick check-out processing, folio settlement, and automated room transition to "Dirty".
* **Room Assets Viewer**: Inspect inventory per room (Beds, Wardrobes, Mini-fridges) with physical condition indicators.
### 3. 🏛️ Event Halls & Venue Calendar
* **Isolated Day/Night Time Slots**:
* 🌅 **Morning Slot**: `08:00 - 14:00`
* 🌃 **Evening Slot**: `16:00 - 22:00`
* **Double-Booking Prevention**: Strict database validation preventing overlapping bookings for the same hall and slot.
* **Integrated Event Services**: Bundle luxury DJ systems, floral decorations, and banquet catering directly into hall contracts.
### 4. 📅 Daily Bookings & Online Verification Center
* **Timeline Operations**: Comprehensive view of all reservations (Rooms, Event Halls, and Combined Packages).
* **Online Booking Verification**: One-click review and activation workflow for guests who booked online via the landing page.
* **Filter by Status**: Easily filter across `confirmed`, `active`, `completed`, and `cancelled` bookings.
### 5. 🛠️ Housekeeping & Maintenance Tracking (Room Reports)
* **Task Board**: Log and monitor routine room cleanings and emergency technician repairs.
* **Staff Assignment**: Assign tasks to designated housekeepers and technicians.
* **Cost & Expense Accounting**: Log repair expenses (e.g., AC repairs, plumbing) directly linked to the financial ledger as debit entries.
* **Status Lifecycle**: `assigned` ➔ `in_progress` ➔ `completed`.
### 6. 💰 Financial Ledger & Vault (الدفتر المالي)
* **Double-Entry Accounting Model**:
* 📥 **Credit Entries**: Revenue from room nights, event hall bookings, and extra service sales.
* 📤 **Debit Entries**: Operational expenses, maintenance costs, and facility repairs.
* **Multi-Bank Account Management**: Support for designated commercial bank accounts (Al Rajhi Bank, SNB Al Ahli, Riyad Bank) with IBAN tracking.
* **Payment Methods Reconciliation**: Cash transactions, Credit Card POS, and Online Gateways.
* **Real-Time Financial Metrics**: Instant calculation of total revenues, expenditures, and net vault balances.
### 7. 🔔 Interactive Notifications & Overstay Alerts
* **Stay Expiration Alerts**: Alerts for guests nearing check-out time with one-click extension shortcuts.
* **Online Booking Notifications**: Notification bell with deep-link redirection to the verification screen.
* **Bulk Operations**: One-click "Mark All as Read" for staff.
### 8. 🛡️ Role-Based Access Control (RBAC)
Configured using **Spatie Laravel Permission**:
* **Admin (General Manager)**: Full system access across all modules, configuration, and financials.
* **Receptionist**: Front desk check-in/out, daily bookings, hall scheduling, and guest management.
* **Housekeeper**: Room cleaning log view and execution.
* **Technician**: Maintenance log view and repair execution.
Technologies Used
[Laravel 13](https://laravel.com) (PHP 8.3+)
[Livewire Flux UI v2](https://fluxui.dev)
[Tailwind CSS v4](https://tailwindcss.com)
[Alpine.js](https://alpinejs.dev)
[Spatie Laravel Permission v7](https://spatie.be/docs/laravel-permission)
SQLite (Default for rapid development) / MySQL 8.0+ ready