1. How Bookings Arrive

Bookings come from 3 channels:

• Customer website — via /transfer-booking/ form or AI chat assistant
• Phone call — dispatcher creates booking via New Booking page
• AI voice — automated phone booking (booking_source = AI)

The system auto-assigns the best vehicle across the entire fleet — customer doesn't choose. Before confirming, it verifies: no time overlap, driver can physically reach the pickup (GPS + road distance + 15 min buffer), and vehicle has enough seats.

2. Ride Status Flow

Note: Steps must follow order — driver can't skip from "En Route" to "Complete". If customer cancels mid-ride, driver is automatically released back to Available.

3. Assigning a Driver

Click "Assign" on any unassigned ride. The system validates the driver is actually available before assigning.

• Assign Directly — instant assignment, driver sees it immediately
• Offer — driver gets Accept/Reject buttons. If rejected, system automatically offers to the next best driver.

4. AI Smart Dispatch

In the assign modal, use AI Best Driver for automatic scoring:

5. Profit Analysis

Click Profit Analysis in the assign modal to see:

• Grade (A-F) — overall booking quality based on Net Profit Per Hour
• Net Profit — fare minus vehicle cost (fuel + maintenance + depreciation) minus driver cost
• Margin % — profit as percentage of fare
• Dead KM % — empty driving (pickup deadhead + estimated return)
• Chain Rides — if another booking exists near the dropoff, same vehicle can take it (saves deadhead)
• Vehicle recommendation — which vehicle maximizes profit for this ride

6. Dispatch New Booking (Phone Calls)

Click New Booking to create a booking during a phone call:

• Search existing customers or create new ones
• Enter pickup/dropoff with geocoding, date, time, passengers
• System shows fare + profit analysis + vehicle recommendation
• Dispatcher can override the price (loyalty discount, premium quote)
• Phone scripts provided for common scenarios
• Booking created with source = PHONE for tracking

7. Vehicle Tracking & Management

• Fleet map — live GPS positions (green = available, red = busy, grey = offline)
• Shift tracking — drivers record odometer at shift start/end. System detects km discrepancies (personal use).
• Vehicle costs — each vehicle has a cost/km (auto from type or custom). Used for profit calculations.
• Damage reports — drivers mark damage on a car diagram during inspections.
• Maintenance log — service history, costs, next-due alerts.

8. Pricing

Configured in the Transfer Service Wizard (4 steps):

• Fixed routes — predefined A-to-B prices (e.g. Airport → City = €50)
• Per-km metered — base fare + €/km (for custom routes)
• Surcharges — airport fee, extra stops, child seats, night %
• Fare is server-calculated — customer can't tamper with the price

9. Customer Experience

• Booking page — clean form at /transfer-booking/, no vehicle selection (auto-assigned)
• AI chat — customer can book via conversation ("I need a ride from airport to hotel tomorrow at 3pm")
• Live tracking — customer sees driver position, ETA, vehicle details
• Alternative times — if unavailable, system suggests the earliest slot where a driver can actually reach the pickup