@fleetbase/fleetops-engine 0.6.47 → 0.6.49

package/server/tests/VroomOrchestrationEngineTest.php

@@ -0,0 +1,250 @@
+<?php
+
+use Fleetbase\FleetOps\Orchestration\Engines\VroomOrchestrationEngine;
+
+test('vroom maps multi stop route tasks to shipments', function () {
+    $engine  = new VroomOrchestrationEngine();
+    $method  = new ReflectionMethod($engine, 'mapTaskToShipment');
+    $reverse = [];
+
+    $method->setAccessible(true);
+
+    $shipment = $method->invokeArgs($engine, [[
+        'id'          => 'order_gkATxX2U3P',
+        'stops'       => [
+            ['role' => 'pickup', 'location' => [103.85, 1.28]],
+            ['role' => 'waypoint', 'location' => [103.87, 1.30]],
+            ['role' => 'dropoff', 'location' => [103.90, 1.31]],
+        ],
+        'service'     => 300,
+        'amount'      => [1, 0, 0, 1],
+        'description' => 'order_gkATxX2U3P',
+    ], &$reverse]);
+
+    expect($shipment)->toHaveKeys(['pickup', 'delivery', 'amount']);
+    expect($shipment)->not->toHaveKey('location');
+    expect($shipment['pickup']['location'])->toBe([103.85, 1.28]);
+    expect($shipment['delivery']['location'])->toBe([103.90, 1.31]);
+    expect($shipment['delivery']['service'])->toBe(300);
+    expect(array_values($reverse))->toBe(['order_gkATxX2U3P', 'order_gkATxX2U3P']);
+});
+
+test('vroom maps single stop route tasks to jobs without pickup coordinates', function () {
+    $engine  = new VroomOrchestrationEngine();
+    $method  = new ReflectionMethod($engine, 'mapTaskToVroomJob');
+    $reverse = [];
+
+    $method->setAccessible(true);
+
+    $job = $method->invokeArgs($engine, [[
+        'id'          => 'order_waypointOnly',
+        'stops'       => [
+            ['role' => 'waypoint', 'location' => [103.86, 1.29]],
+        ],
+        'service'     => 300,
+        'amount'      => [1, 0, 0, 1],
+        'description' => 'order_waypointOnly',
+    ], &$reverse]);
+
+    expect($job)->toMatchArray([
+        'location'    => [103.86, 1.29],
+        'description' => 'order_waypointOnly',
+        'service'     => 300,
+        'amount'      => [1, 0, 0, 1],
+    ]);
+    expect($job)->not->toHaveKey('pickup');
+    expect(array_values($reverse))->toBe(['order_waypointOnly']);
+});
+
+test('vroom dedupes unassigned pickup and delivery task ids to one order id', function () {
+    $engine = new VroomOrchestrationEngine();
+    $method = new ReflectionMethod($engine, 'mapVroomResponse');
+
+    $method->setAccessible(true);
+
+    $result = $method->invoke($engine, [
+        'routes'     => [],
+        'unassigned' => [
+            ['id' => 1001],
+            ['id' => 1002],
+        ],
+        'summary' => ['routes' => 0],
+    ], [
+        1001 => 'order_gkATxX2U3P',
+        1002 => 'order_gkATxX2U3P',
+    ]);
+
+    expect($result['unassigned'])->toBe(['order_gkATxX2U3P']);
+});
+
+test('vroom maps shipment delivery steps back to fleetops assignments', function () {
+    $engine = new VroomOrchestrationEngine();
+    $method = new ReflectionMethod($engine, 'mapVroomResponse');
+
+    $method->setAccessible(true);
+
+    $result = $method->invoke($engine, [
+        'routes' => [
+            [
+                'description' => json_encode(['vehicle_id' => 'vehicle_w747Bat', 'driver_id' => null]),
+                'steps'       => [
+                    ['type' => 'start'],
+                    ['type' => 'pickup', 'id' => 1001],
+                    ['type' => 'delivery', 'id' => 1002, 'arrival' => 1778918400, 'duration' => 900, 'distance' => 4200],
+                    ['type' => 'end'],
+                ],
+            ],
+        ],
+        'unassigned' => [],
+        'summary'    => ['routes' => 1],
+    ], [
+        1001 => 'order_gkATxX2U3P',
+        1002 => 'order_gkATxX2U3P',
+    ]);
+
+    expect($result['assignments'])->toHaveCount(1);
+    expect($result['assignments'][0])->toMatchArray([
+        'order_id'   => 'order_gkATxX2U3P',
+        'vehicle_id' => 'vehicle_w747Bat',
+        'driver_id'  => null,
+        'sequence'   => 1,
+        'arrival'    => 1778918400,
+        'duration'   => 900,
+        'distance'   => 4200,
+    ]);
+    expect($result['summary'])->toBe(['routes' => 1]);
+});
+
+test('vroom capacity-only payload uses matrix indexes instead of coordinates', function () {
+    $engine  = new VroomOrchestrationEngine();
+    $method  = new ReflectionMethod($engine, 'buildCapacityOnlyPayload');
+    $reverse = [];
+
+    $method->setAccessible(true);
+
+    $payload = $method->invokeArgs($engine, [[
+        [
+            'id'          => 'order_capacity',
+            'description' => 'order_capacity',
+            'amount'      => [100, 250, 1, 2],
+            'skills'      => [123],
+        ],
+    ], [
+        [
+            'id'        => 'vehicle_capacity',
+            'driver_id' => null,
+            'capacity'  => [500, 1000, 4, 20],
+            'skills'    => [123],
+            'max_tasks' => 3,
+        ],
+    ], [], &$reverse]);
+
+    expect($payload['vehicles'][0])->toMatchArray([
+        'profile'     => 'capacity_only',
+        'start_index' => 0,
+        'capacity'    => [500, 1000, 4, 20],
+        'skills'      => [123],
+        'max_tasks'   => 3,
+    ]);
+    expect($payload['vehicles'][0])->not->toHaveKey('start');
+    expect($payload['jobs'][0])->toMatchArray([
+        'location_index' => 1,
+        'delivery'       => [100, 250, 1, 2],
+        'skills'         => [123],
+    ]);
+    expect($payload['jobs'][0])->not->toHaveKey('location');
+    expect($payload['jobs'][0])->not->toHaveKey('pickup');
+    expect($payload['matrices']['capacity_only']['durations'])->toHaveCount(2);
+    expect(array_values($reverse))->toBe(['order_capacity']);
+});
+
+test('vroom capacity-only payload minimizes vehicles by default', function () {
+    $engine  = new VroomOrchestrationEngine();
+    $method  = new ReflectionMethod($engine, 'buildCapacityOnlyPayload');
+    $reverse = [];
+
+    $method->setAccessible(true);
+
+    $payload = $method->invokeArgs($engine, [[
+        ['id' => 'order_a', 'description' => 'order_a', 'amount' => [100, 250, 1, 2]],
+        ['id' => 'order_b', 'description' => 'order_b', 'amount' => [80, 100, 0, 1]],
+    ], [
+        ['id' => 'vehicle_large', 'driver_id' => null, 'capacity' => [500, 1000, 4, 20]],
+        ['id' => 'vehicle_spare', 'driver_id' => null, 'capacity' => [500, 1000, 4, 20]],
+    ], [], &$reverse]);
+
+    expect($payload['vehicles'][0]['costs'])->toBe(['fixed' => 100000]);
+    expect($payload['vehicles'][1]['costs'])->toBe(['fixed' => 100000]);
+    expect($payload['jobs'])->toHaveCount(2);
+    expect($payload['jobs'][0]['delivery'])->toBe([100, 250, 1, 2]);
+    expect($payload['jobs'][1]['delivery'])->toBe([80, 100, 0, 1]);
+});
+
+test('vroom capacity-only payload accepts custom minimize vehicles fixed cost', function () {
+    $engine  = new VroomOrchestrationEngine();
+    $method  = new ReflectionMethod($engine, 'buildCapacityOnlyPayload');
+    $reverse = [];
+
+    $method->setAccessible(true);
+
+    $payload = $method->invokeArgs($engine, [[
+        ['id' => 'order_a', 'description' => 'order_a', 'amount' => [100, 250, 1, 2]],
+    ], [
+        ['id' => 'vehicle_large', 'driver_id' => null, 'capacity' => [500, 1000, 4, 20]],
+    ], [
+        'vehicle_packing'    => 'minimize_vehicles',
+        'vehicle_fixed_cost' => 50000,
+    ], &$reverse]);
+
+    expect($payload['vehicles'][0]['costs'])->toBe(['fixed' => 50000]);
+});
+
+test('vroom capacity-only payload can disable vehicle packing bias', function (string $packing) {
+    $engine  = new VroomOrchestrationEngine();
+    $method  = new ReflectionMethod($engine, 'buildCapacityOnlyPayload');
+    $reverse = [];
+
+    $method->setAccessible(true);
+
+    $payload = $method->invokeArgs($engine, [[
+        ['id' => 'order_a', 'description' => 'order_a', 'amount' => [100, 250, 1, 2]],
+    ], [
+        ['id' => 'vehicle_large', 'driver_id' => null, 'capacity' => [500, 1000, 4, 20]],
+    ], [
+        'vehicle_packing' => $packing,
+    ], &$reverse]);
+
+    expect($payload['vehicles'][0])->not->toHaveKey('costs');
+})->with(['balanced', 'none']);
+
+test('vroom capacity-only response can assign multiple orders to one large vehicle', function () {
+    $engine = new VroomOrchestrationEngine();
+    $method = new ReflectionMethod($engine, 'mapVroomResponse');
+
+    $method->setAccessible(true);
+
+    $result = $method->invoke($engine, [
+        'routes' => [
+            [
+                'description' => json_encode(['vehicle_id' => 'vehicle_large', 'driver_id' => null]),
+                'steps'       => [
+                    ['type' => 'start'],
+                    ['type' => 'job', 'id' => 1001],
+                    ['type' => 'job', 'id' => 1002],
+                    ['type' => 'job', 'id' => 1003],
+                    ['type' => 'end'],
+                ],
+            ],
+        ],
+        'unassigned' => [],
+        'summary'    => ['routes' => 1],
+    ], [
+        1001 => 'order_a',
+        1002 => 'order_b',
+        1003 => 'order_c',
+    ]);
+
+    expect($result['assignments'])->toHaveCount(3);
+    expect(collect($result['assignments'])->pluck('vehicle_id')->unique()->values()->all())->toBe(['vehicle_large']);
+    expect(collect($result['assignments'])->pluck('order_id')->all())->toBe(['order_a', 'order_b', 'order_c']);
+});

package/translations/en-us.yaml

@@ -435,6 +435,7 @@ driver:
         vendor: Vendor
         select-vendor: Select Vendor
         driver-license: Drivers License
+        license-expiry: License Expiry
         no-vehicle-assigned: No Vehicle Assigned
     actions:
         assign-order: Assign Order to Driver
@@ -1653,6 +1654,39 @@ modals:
         description-zone: Description of Zone
 
 widget:
+    refresh: Refresh
+    kpi-earnings:
+        title: Earnings
+    kpi-distance:
+        title: Distance Travelled
+    kpi-aov:
+        title: Avg Order Value
+    kpi-active-orders:
+        title: Active Orders
+    kpi-drivers-online:
+        title: Drivers Online
+    kpi-open-issues:
+        title: Open Issues
+    operations-pulse:
+        title: Operations Pulse
+    revenue-trend:
+        title: Revenue Trend
+    orders-by-status:
+        title: Order Volume by Status
+    on-time-delivery:
+        title: On-Time Delivery
+    top-drivers:
+        title: Top Drivers
+    fuel-efficiency:
+        title: Fuel Cost & Efficiency
+    issues-insights:
+        title: Issues Insights
+    maintenance-overview:
+        title: Maintenance Overview
+    geofence-violations:
+        title: Geofence Violations
+    live-fleet:
+        title: Live Fleet Map
     fleet-ops-quickstart:
         message: Let's see what you can do to jumpstart operations...
         start-task: Start Task
@@ -1989,6 +2023,12 @@ orchestrator:
     mode-allocate: Allocate Orders
     mode-optimize: Optimize Routes
     engine: Engine
+    allocation-strategy: Allocation Strategy
+    allocation-strategy-route-aware: Route + Capacity
+    allocation-strategy-capacity-only: Capacity Only
+    vehicle-packing: Vehicle Packing
+    vehicle-packing-minimize-vehicles: Minimize Vehicles
+    vehicle-packing-balanced: Balanced
     respect-skills: Respect Skills
     respect-capacity: Respect Capacity
     return-to-depot: Return to Depot
@@ -2029,6 +2069,7 @@ orchestrator:
     no-search-results: No results match your search.
     search-drivers: Search drivers...
     search-vehicles: Search vehicles...
+    no-position: No position
     filter-online: Online
     filter-offline: Offline
     filter-on-shift: On Job