packages/fleet-routing/
├── src/
│   ├── truck-packing.ts    # calculateTruckPacking, TRUCK_PRESETS, TruckSpecification
│   ├── vrp-optimizer.ts    # optimizeDeliveryRoute, calculateHaversineDistanceKm
│   ├── fuel-calculator.ts  # estimateRouteFuel, reconcileFuelReceipt, DEFAULT_FUEL_BENCHMARKS
│   ├── epod-signer.ts      # signElectronicProofOfDelivery, verifyEpodIntegrity, generateEpodCertificateMarkdown
│   └── index.ts            # SSoT Unified Barrel

import {
  calculateTruckPacking,
  optimizeDeliveryRoute,
  estimateRouteFuel,
  reconcileFuelReceipt,
  signElectronicProofOfDelivery,
  verifyEpodIntegrity,
  TRUCK_PRESETS,
  type CargoItem,
  type LocationCoordinate,
} from '@kido/fleet-routing';

// 1. 3D Truck Cargo Packing Verification (2.5-Ton Truck)
const cargoToPack: CargoItem[] = [
  { id: 'PALLET-01', name: 'Thùng Dầu Nhớt Công Nghiệp', weightKg: 1200, lengthM: 1.2, widthM: 1.0, heightM: 1.4, quantity: 1, stackable: false },
  { id: 'BOX-CARTON', name: 'Phụ Tùng Cơ Khí', weightKg: 15, lengthM: 0.4, widthM: 0.3, heightM: 0.3, quantity: 40, stackable: true },
];

const packingResult = calculateTruckPacking(cargoToPack, TRUCK_PRESETS.TRUCK_2_5T);
console.log('Truck Packing Status:', {
  fitsInTruck: packingResult.fitsInTruck,
  totalWeightKg: `${packingResult.totalWeightKg} kg / ${packingResult.maxPayloadKg} kg`,
  volumeUtilization: `${packingResult.volumeUtilizationPercent}%`,
  remainingPayloadKg: `${packingResult.remainingPayloadKg} kg`,
});

// 2. Multi-Stop VRP Route Optimization (Depot + 4 Drop-off Points in Da Nang)
const centralDepot: LocationCoordinate = {
  id: 'DEPOT-HOAKHANH',
  name: 'Kho Tổng KCN Hòa Khánh',
  latitude: 16.0825,
  longitude: 108.1492,
};

const deliveryStops: LocationCoordinate[] = [
  { id: 'STOP-01', name: 'Đại Lý Hải Châu', latitude: 16.0678, longitude: 108.2208 },
  { id: 'STOP-02', name: 'Công Trình Ngũ Hành Sơn', latitude: 16.0125, longitude: 108.2562 },
  { id: 'STOP-03', name: 'Xưởng Cơ Khí Thanh Khê', latitude: 16.0612, longitude: 108.1812 },
  { id: 'STOP-04', name: 'Kho Trung Chuyển Sơn Trà', latitude: 16.0950, longitude: 108.2420 },
];

const optimizedRoute = optimizeDeliveryRoute(centralDepot, deliveryStops);
console.log('2-Opt Route Optimization:', {
  initialDistanceKm: `${optimizedRoute.initialDistanceKm.toFixed(2)} km`,
  optimizedDistanceKm: `${optimizedRoute.optimizedDistanceKm.toFixed(2)} km`,
  distanceSavedKm: `${optimizedRoute.distanceSavedKm.toFixed(2)} km`,
  stopSequence: optimizedRoute.stops.map(s => s.name),
});

// 3. Fuel Reconciliation Audit
const fuelEstimate = estimateRouteFuel({
  truckType: 'TRUCK_2_5T',
  distanceKm: optimizedRoute.optimizedDistanceKm,
  cargoWeightKg: packingResult.totalWeightKg,
  trafficCondition: 'MODERATE',
  isAirConditioned: true,
});

// Driver claims 18.5 Liters of diesel
const fuelAudit = reconcileFuelReceipt(18.5, {
  truckType: 'TRUCK_2_5T',
  distanceKm: optimizedRoute.optimizedDistanceKm,
  cargoWeightKg: packingResult.totalWeightKg,
  trafficCondition: 'MODERATE',
  isAirConditioned: true,
});

console.log('Fuel Audit Report:', {
  expectedLiters: fuelEstimate.expectedFuelLiters.toFixed(2),
  actualClaimedLiters: fuelAudit.actualLiters,
  variancePercent: `${fuelAudit.variancePercent.toFixed(1)}%`,
  status: fuelAudit.status, // 'NORMAL' or 'WARNING_HIGH'
});

// 4. Issue Cryptographic Electronic Proof of Delivery (e-POD)
const epod = signElectronicProofOfDelivery({
  orderId: 'ORD-VN-99218',
  deliveryAddress: '123 Hùng Vương, Hải Châu, Đà Nẵng',
  recipientName: 'Trần Văn Long',
  recipientPhone: '0905998877',
  cargoCondition: 'INTACT',
  deliveredAt: new Date(),
  latitude: 16.0678,
  longitude: 108.2208,
  signatureDataUri: 'data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==',
  photoProofUrls: ['https://cdn.kido.vn/epod/proof-ord-99218.jpg'],
});

console.log('Generated e-POD:', {
  certificateId: epod.id,
  sha256Hash: epod.integrityHash,
  isValid: verifyEpodIntegrity(epod).isValid,
});