Oasis Express: real-time medicine home delivery

export type DeliveryStatus =
  | 'pending'
  | 'assigned'
  | 'picked_up'
  | 'in_transit'
  | 'delivered'
  | 'cancelled';

export interface DeliveryOrder {
  id: string;
  pharmacy_id: string;           // Source pharmacy for this order
  patient_id?: string;           // Patient who placed the order
  delivery_driver_id?: string;   // Assigned driver (set on assign)
  status: DeliveryStatus;
  delivery_address: string;      // Human-readable delivery address
  delivery_lat: number;          // Patient's delivery latitude
  delivery_lng: number;          // Patient's delivery longitude
  pickup_address?: string;       // Pharmacy address (auto-populated)
  pickup_lat?: number;           // Pharmacy latitude
  pickup_lng?: number;           // Pharmacy longitude
  order_date: string;            // ISO datetime of order creation
  delivered_at?: string;         // ISO datetime of confirmed delivery
  notes?: string;                // Optional delivery instructions
  // Expanded relations (when requested)
  pharmacy?: Pharmacy;
  patient?: User;
  driver?: User;
  items?: DeliveryOrderItem[];
}

export interface CreateSaleRequest {
  items: SaleItemRequest[];      // Medicines and quantities being purchased
  patient_id?: string;           // UUID of the patient (optional for walk-in)
  prescription_id?: string;      // Link to an active prescription if applicable
  is_delivery: boolean;          // Set to true to trigger a DeliveryOrder
  delivery_address?: string;     // Required when is_delivery is true
  delivery_lat?: number;         // Required when is_delivery is true
  delivery_lng?: number;         // Required when is_delivery is true
  notes?: string;                // Delivery instructions for the driver
}

{
  "items": [
    { "medicine_id": "clx2j4k0e0002abcdmnop", "quantity": 30, "unit_price": 25.50 }
  ],
  "patient_id": "clx2j4k0e0000abcd1234efgh",
  "prescription_id": "clx2j4k0e0004abcduvwx",
  "is_delivery": true,
  "delivery_address": "Reparto San Juan, Calle Los Robles 47, Managua",
  "delivery_lat": 12.1095,
  "delivery_lng": -86.2814,
  "notes": "Leave with the doorman if not home"
}

// Schema: delivery_routes table
// deliveryOrderId  String  — parent order
// driverLat        Float   — latitude at moment of broadcast
// driverLng        Float   — longitude at moment of broadcast
// recordedAt       DateTime — server-side timestamp

GET /api/v1/delivery-orders/{id}/route

export interface DeliveryRoute {
  distance_meters: number;  // Total route length
  duration_seconds: number; // Estimated or actual travel time
  geometry: string;         // Encoded polyline or GeoJSON geometry
}

PATCH /api/v1/delivery-orders/{id}/assign

export interface AssignDriverRequest {
  driver_id: string; // UUID of an available delivery driver
}

GET /api/v1/delivery-orders