@fleetbase/fleetops-engine 0.6.48 → 0.6.49

package/server/tests/AnalyticsRoutesTest.php

@@ -0,0 +1,41 @@
+<?php
+
+test('analytics routes are registered alongside metrics routes', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    expect($routes)->toContain("['prefix' => 'analytics']");
+    expect($routes)->toContain("'AnalyticsController@operationsPulse'");
+    expect($routes)->toContain("'AnalyticsController@revenueTrend'");
+    expect($routes)->toContain("'AnalyticsController@ordersByStatus'");
+    expect($routes)->toContain("'AnalyticsController@onTimeDelivery'");
+    expect($routes)->toContain("'AnalyticsController@topDrivers'");
+    expect($routes)->toContain("'AnalyticsController@fuelEfficiency'");
+    expect($routes)->toContain("'AnalyticsController@issuesInsights'");
+    expect($routes)->toContain("'AnalyticsController@maintenanceOverview'");
+    expect($routes)->toContain("'AnalyticsController@geofenceViolations'");
+    expect($routes)->toContain("'AnalyticsController@liveFleet'");
+});
+
+test('per-slug metrics endpoint is registered', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    expect($routes)->toContain("\$router->get('{slug}', 'MetricsController@show');");
+});
+
+test('legacy metrics endpoint is preserved for backward compat', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    expect($routes)->toContain("\$router->get('/', 'MetricsController@all');");
+});
+
+test('analytics controller has one method per widget', function () {
+    $controller = file_get_contents(dirname(__DIR__) . '/src/Http/Controllers/Internal/v1/AnalyticsController.php');
+
+    foreach ([
+        'operationsPulse', 'revenueTrend', 'ordersByStatus', 'onTimeDelivery',
+        'topDrivers', 'fuelEfficiency', 'issuesInsights', 'maintenanceOverview',
+        'geofenceViolations', 'liveFleet',
+    ] as $method) {
+        expect($controller)->toContain("public function {$method}(");
+    }
+});

package/server/tests/MetricsRegistryTest.php

@@ -0,0 +1,88 @@
+<?php
+
+use Fleetbase\FleetOps\Support\Metrics\AbstractMetric;
+use Fleetbase\FleetOps\Support\Metrics\AvgOrderValueMetric;
+use Fleetbase\FleetOps\Support\Metrics\EarningsMetric;
+use Fleetbase\FleetOps\Support\Metrics\OpenIssuesMetric;
+use Fleetbase\FleetOps\Support\Metrics\OrdersInProgressMetric;
+use Fleetbase\FleetOps\Support\Metrics\Registry;
+use Fleetbase\FleetOps\Support\Metrics\ResolvedIssuesMetric;
+use Fleetbase\FleetOps\Support\Metrics\TotalTimeTraveledMetric;
+
+test('registry exposes every known metric slug', function () {
+    $slugs = Registry::slugs();
+
+    expect($slugs)->toContain('earnings');
+    expect($slugs)->toContain('fuel_costs');
+    expect($slugs)->toContain('total_distance_traveled');
+    expect($slugs)->toContain('total_time_traveled');
+    expect($slugs)->toContain('orders_completed');
+    expect($slugs)->toContain('orders_canceled');
+    expect($slugs)->toContain('orders_in_progress');
+    expect($slugs)->toContain('orders_scheduled');
+    expect($slugs)->toContain('active_live_orders');
+    expect($slugs)->toContain('drivers_online');
+    expect($slugs)->toContain('total_drivers');
+    expect($slugs)->toContain('total_customers');
+    expect($slugs)->toContain('open_issues');
+    expect($slugs)->toContain('resolved_issues');
+    expect($slugs)->toContain('avg_order_value');
+});
+
+test('registry resolves unknown slugs to null', function () {
+    expect(Registry::resolve('does_not_exist'))->toBeNull();
+});
+
+test('every registered metric extends the abstract base', function () {
+    foreach (Registry::all() as $slug => $class) {
+        expect(is_subclass_of($class, AbstractMetric::class))
+            ->toBeTrue("Metric class for slug '{$slug}' must extend AbstractMetric");
+        expect($class::slug())->toBe($slug);
+    }
+});
+
+test('open and resolved issue metrics scope to the constructor company (not session)', function () {
+    $sourceOpen = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/OpenIssuesMetric.php');
+    $sourceResolved = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/ResolvedIssuesMetric.php');
+
+    expect($sourceOpen)->not->toContain("session('company')");
+    expect($sourceOpen)->toContain('$this->company->uuid');
+    expect($sourceResolved)->not->toContain("session('company')");
+    expect($sourceResolved)->toContain('$this->company->uuid');
+});
+
+test('total_time_traveled metric sums the time column, not distance', function () {
+    $source = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/TotalTimeTraveledMetric.php');
+
+    expect($source)->toContain("\$query->sum('time')");
+    expect($source)->not->toContain("\$query->sum('distance')");
+    expect(TotalTimeTraveledMetric::slug())->toBe('total_time_traveled');
+});
+
+test('money metrics return float values to preserve cents', function () {
+    $earnings = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/EarningsMetric.php');
+    $fuelCosts = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/FuelCostsMetric.php');
+
+    expect($earnings)->toContain('(float) $query->sum');
+    expect($earnings)->not->toMatch('/\(int\)\s*\$query->sum/');
+    expect($fuelCosts)->toContain('(float) $query->sum');
+    expect($fuelCosts)->not->toMatch('/\(int\)\s*\$query->sum/');
+});
+
+test('money metrics filter by currency to avoid mixed-currency sums', function () {
+    $earnings = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/EarningsMetric.php');
+    $fuelCosts = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/FuelCostsMetric.php');
+    $aov = file_get_contents(dirname(__DIR__) . '/src/Support/Metrics/AvgOrderValueMetric.php');
+
+    expect($earnings)->toContain("->where('currency'");
+    expect($fuelCosts)->toContain("->where('currency'");
+    expect($aov)->toContain("->where('currency'");
+});
+
+test('ordersInProgress uses an explicit allowlist rather than an exclusion list', function () {
+    $statuses = OrdersInProgressMetric::IN_PROGRESS_STATUSES;
+    expect($statuses)->toBeArray();
+    expect($statuses)->not->toBeEmpty();
+    expect($statuses)->toContain('dispatched');
+    expect($statuses)->toContain('started');
+});

package/server/tests/VroomOrchestrationEngineTest.php

@@ -157,3 +157,94 @@ test('vroom capacity-only payload uses matrix indexes instead of coordinates', f
     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
@@ -1992,6 +2026,9 @@ orchestrator:
     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