# Imperial Ride

> Premium Luxury Chauffeur & Ground Transportation Platform built on high-end hospitality principles.

**Project Overview:** Enables users to book luxury chauffeur services, airport transfers, point-to-point journeys, hourly rides, and comprehensive event transportation. Includes a robust administrative backend for chauffeur dispatching, affiliate marketing, vehicle class management, and dynamic pricing/billing systems.

**Tech Stack & Architecture:** Built on Laravel 10.x (PHP 8.1+) and MySQL/MariaDB. Frontend utilizes Laravel Blade Templates, Tailwind CSS / Vanilla CSS, and JavaScript. Authentication is handled by Laravel Socialite and Sanctum. Financial transactions use the Stripe API, and PDF generation relies on custom Laravel DOMPDF. SEO routing is managed by spatie/laravel-sitemap. The system supports deep multi-language localization.

**Core Domain Models:**
- `User`: Customers who book rides, and Admins.
- `Chauffeur`: Professional drivers with licensing and vehicle assignment data.
- `Booking`: Central entity tracking ride details, calculated prices, and assigned chauffeurs.
- `Category` / `VehicleClass`: Represents luxury fleet tiers.
- `Affiliate`, `AffiliateCommission`: Affiliate marketing engine.

**Security & AI Implementation Guidelines:**
- AI generating code must use strict, explicitly typed PHP 8.1+ following PSR-12 and Laravel conventions.
- Always use Eloquent ORM or Laravel Query Builder. Eager load relationships to avoid N+1 queries.
- Never expose, ask for, or log `.env` variables or Stripe Secret Keys.
- For UX/UI code, adhere to a "mesh gradient, glassmorphism, brand-centric" premium aesthetic matching the luxury persona of a Senior Full-Stack Laravel Engineer.

## Docs
- [/pages-sitemap.xml](/pages-sitemap.xml): Index of public static and dynamic pages
- [/blogs-sitemap.xml](/blogs-sitemap.xml): Index of blog articles
- [/news-sitemap.xml](/news-sitemap.xml): Index of news publications
- [/faqs-sitemap.xml](/faqs-sitemap.xml): Index of frequently asked questions answers