@fleetbase/fleetops-engine 0.6.55 → 0.6.57

package/server/src/Support/Telematics/TelematicService.php

@@ -194,19 +194,30 @@ class TelematicService
     {
         $device = $this->linkDevice($telematic, $provider->normalizeDevice($payload));
 
-        $event = null;
+        $event  = null;
+        $events = [];
         try {
-            $eventData = $provider->normalizeEvent($payload);
-            if ($this->hasEventSignal($eventData)) {
-                $event = $this->storeDeviceEvent($telematic, $eventData, $device);
+            $eventPayloads = method_exists($provider, 'normalizeEvents') ? $provider->normalizeEvents($payload) : [];
+            if (empty($eventPayloads)) {
+                $eventPayloads = [$provider->normalizeEvent($payload)];
+            }
+
+            foreach ($eventPayloads as $eventData) {
+                if ($this->hasEventSignal($eventData)) {
+                    $storedEvent = $this->storeDeviceEvent($telematic, $eventData, $device);
+                    $events[]    = $storedEvent;
+                    $event ??= $storedEvent;
+                }
             }
         } catch (\Throwable) {
-            $event = null;
+            $event  = null;
+            $events = [];
         }
 
         return [
             'device'  => $device,
             'event'   => $event,
+            'events'  => $events,
             'sensors' => $this->storeSnapshotSensors($telematic, $provider, $payload, $device),
         ];
     }
@@ -663,6 +674,10 @@ class TelematicService
             $vehicle->altitude = $eventData['altitude'];
         }
 
+        if (array_key_exists('odometer', $eventData) && $eventData['odometer'] !== null) {
+            $vehicle->odometer = $eventData['odometer'];
+        }
+
         $vehicle->telematics = array_merge($vehicle->telematics ?? [], [
             'last_event_uuid'     => $event->uuid,
             'last_event_id'       => $event->public_id,
@@ -757,13 +772,17 @@ class TelematicService
         return collect($rawSensors)
             ->map(function ($sensor, $name) {
                 if (is_array($sensor)) {
-                    return array_merge(['name' => $name], $sensor);
+                    return array_merge([
+                        'sensor_key' => $name,
+                        'name'       => $name,
+                    ], $sensor);
                 }
 
                 return [
-                    'name'  => $name,
-                    'type'  => $name,
-                    'value' => $sensor,
+                    'sensor_key' => $name,
+                    'name'       => $name,
+                    'type'       => $name,
+                    'value'      => $sensor,
                 ];
             })
             ->values()

package/server/src/Support/Utils.php

@@ -248,6 +248,10 @@ class Utils extends FleetbaseUtils
             $coordinates = static::extractPointWktFromQueryExpression($coordinates) ?? $coordinates;
         }
 
+        if ($geoJsonPoint = static::pointFromGeoJson($coordinates)) {
+            return $geoJsonPoint;
+        }
+
         if ($coordinates instanceof Point) {
             $latitude  = $coordinates->getLat();
             $longitude = $coordinates->getLng();
@@ -452,6 +456,10 @@ class Utils extends FleetbaseUtils
             return $coordinates;
         }
 
+        if ($geoJsonPoint = static::pointFromGeoJson($coordinates)) {
+            return $geoJsonPoint;
+        }
+
         if (static::isGeoJson($coordinates)) {
             $coordinatesJson = null;
 
@@ -541,6 +549,10 @@ class Utils extends FleetbaseUtils
             $coordinates = $coordinates->location;
         }
 
+        if ($geoJsonPoint = static::pointFromGeoJson($coordinates)) {
+            $coordinates = $geoJsonPoint;
+        }
+
         if ($coordinates instanceof Point) {
             $latitude  = $coordinates->getLat();
             $longitude = $coordinates->getLng();
@@ -639,6 +651,10 @@ class Utils extends FleetbaseUtils
             return $coordinates;
         }
 
+        if ($geoJsonPoint = static::pointFromGeoJson($coordinates)) {
+            return $geoJsonPoint;
+        }
+
         if (is_null($coordinates) || !static::isCoordinates($coordinates)) {
             return new Point(0, 0);
         }
@@ -649,6 +665,42 @@ class Utils extends FleetbaseUtils
         return new Point($latitude, $longitude);
     }
 
+    /**
+     * Resolve direct GeoJSON Point values and Feature-wrapped Point values.
+     */
+    protected static function pointFromGeoJson($coordinates): ?Point
+    {
+        if (is_string($coordinates) && static::isJson($coordinates)) {
+            $coordinates = json_decode($coordinates, true);
+        }
+
+        if (!is_array($coordinates) && !is_object($coordinates)) {
+            return null;
+        }
+
+        if (data_get($coordinates, 'type') === 'Feature') {
+            $coordinates = data_get($coordinates, 'geometry');
+        }
+
+        if (data_get($coordinates, 'type') !== 'Point') {
+            return null;
+        }
+
+        $pointCoordinates = data_get($coordinates, 'coordinates');
+        if (!is_array($pointCoordinates) || count($pointCoordinates) < 2) {
+            return null;
+        }
+
+        $longitude = $pointCoordinates[0];
+        $latitude  = $pointCoordinates[1];
+
+        if (!is_numeric($latitude) || !is_numeric($longitude)) {
+            return null;
+        }
+
+        return new Point((float) $latitude, (float) $longitude);
+    }
+
     /**
      * Converts a point to a WKT (Well-Known Text) representation for SQL insert.
      *

package/server/src/routes.php

@@ -105,6 +105,61 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                 $router->put('{id}', 'FuelReportController@update');
                 $router->delete('{id}', 'FuelReportController@delete');
             });
+            // fuel-transactions routes
+            $router->group(['prefix' => 'fuel-transactions'], function () use ($router) {
+                $router->post('/', 'FuelTransactionController@create');
+                $router->get('/', 'FuelTransactionController@query');
+                $router->get('{id}', 'FuelTransactionController@find');
+                $router->put('{id}', 'FuelTransactionController@update');
+                $router->delete('{id}', 'FuelTransactionController@delete');
+                $router->post('{id}/match-vehicle', 'FuelTransactionController@matchVehicle');
+                $router->post('{id}/match-order', 'FuelTransactionController@matchOrder');
+                $router->post('{id}/reprocess', 'FuelTransactionController@reprocess');
+                $router->post('{id}/review', 'FuelTransactionController@review');
+            });
+            // equipment routes
+            $router->group(['prefix' => 'equipment'], function () use ($router) {
+                $router->post('/', 'EquipmentController@create');
+                $router->get('/', 'EquipmentController@query');
+                $router->get('{id}', 'EquipmentController@find');
+                $router->put('{id}', 'EquipmentController@update');
+                $router->delete('{id}', 'EquipmentController@delete');
+            });
+            // parts routes
+            $router->group(['prefix' => 'parts'], function () use ($router) {
+                $router->post('/', 'PartController@create');
+                $router->get('/', 'PartController@query');
+                $router->get('{id}', 'PartController@find');
+                $router->put('{id}', 'PartController@update');
+                $router->delete('{id}', 'PartController@delete');
+            });
+            // work-orders routes
+            $router->group(['prefix' => 'work-orders'], function () use ($router) {
+                $router->post('/', 'WorkOrderController@create');
+                $router->get('/', 'WorkOrderController@query');
+                $router->get('{id}', 'WorkOrderController@find');
+                $router->put('{id}', 'WorkOrderController@update');
+                $router->delete('{id}', 'WorkOrderController@delete');
+                $router->post('{id}/send', 'WorkOrderController@send');
+            });
+            // devices routes
+            $router->group(['prefix' => 'devices'], function () use ($router) {
+                $router->post('/', 'DeviceController@create');
+                $router->get('/', 'DeviceController@query');
+                $router->get('{id}', 'DeviceController@find');
+                $router->put('{id}', 'DeviceController@update');
+                $router->delete('{id}', 'DeviceController@delete');
+                $router->post('{id}/attach', 'DeviceController@attach');
+                $router->post('{id}/detach', 'DeviceController@detach');
+            });
+            // sensors routes
+            $router->group(['prefix' => 'sensors'], function () use ($router) {
+                $router->post('/', 'SensorController@create');
+                $router->get('/', 'SensorController@query');
+                $router->get('{id}', 'SensorController@find');
+                $router->put('{id}', 'SensorController@update');
+                $router->delete('{id}', 'SensorController@delete');
+            });
             // orders routes
             $router->group(['prefix' => 'orders', 'middleware' => []], function () use ($router) {
                 $router->post('/', 'OrderController@create');
@@ -315,7 +370,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->get('facilitators/{id}', $controller('getAsFacilitator'));
                                 $router->get('customers/{id}', $controller('getAsCustomer'));
                                 $router->post('{id}/convert-to-vendor', $controller('convertToVendor'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -330,7 +384,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->post('{id}/assign-vehicle', $controller('assignVehicle'));
                                 $router->post('{id}/unassign-vehicle', $controller('unassignVehicle'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->post('import', $controller('import'));
                                 // Driver scheduling endpoints
                                 $router->get('{id}/schedule-items', $controller('scheduleItems'));
@@ -349,7 +402,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->post('remove-vehicle', $controller('removeVehicle'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -357,7 +409,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             function ($router, $controller) {
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -385,14 +436,12 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             function ($router, $controller) {
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
                             'integrated-vendors',
                             function ($router, $controller) {
                                 $router->get('supported', $controller('getSupported'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -421,7 +470,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->patch('start', $controller('start'));
                                 // Scheduler: set scheduled_at + driver without triggering dispatch
                                 $router->patch('schedule', $controller('scheduleOrder'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                             }
                         );
@@ -434,7 +482,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->get('lookup', $controller('geocode'))->middleware(['cache.headers:private;max_age=3600']);
                                 $router->get('avatars', $controller('avatars'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->post('import', $controller('import'));
                             }
                         );
@@ -449,7 +496,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             'service-areas',
                             function ($router, $controller) {
                                 $router->match(['get', 'post'], 'export', $controller('export'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->group(
@@ -473,7 +519,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                         $router->fleetbaseRoutes(
                             'service-rates',
                             function ($router, $controller) {
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->get('for-route', $controller('getServicesForRoute'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                             }
@@ -493,7 +538,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->post('{id}/detach-device', $controller('detachDevice'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes('vehicle-devices');
@@ -509,18 +553,22 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->delete('{id}/personnels/{contact}', $controller('removeVendorPersonnel'));
                                 $router->post('{id}/assign-driver', $controller('assignDriver'));
                                 $router->post('{id}/remove-driver', $controller('removeDriver'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->post('import', $controller('import'));
                             }
                         );
-                        $router->fleetbaseRoutes('devices');
+                        $router->fleetbaseRoutes('devices', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
+                        });
                         $router->post('devices/{id}/attach', 'DeviceController@attach');
                         $router->post('devices/{id}/detach', 'DeviceController@detach');
                         $router->fleetbaseRoutes('device-events', function ($router, $controller) {
                             $router->post('{id}/mark-processed', $controller('markProcessed'));
                         });
-                        $router->fleetbaseRoutes('sensors');
+                        $router->fleetbaseRoutes('sensors', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
+                        });
                         $router->fleetbaseRoutes('telematics', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->get('providers', $controller('providers'));
                             $router->get('{id}/logs', $controller('logs'));
                             $router->get('{id}/devices', $controller('devices'));
@@ -530,6 +578,7 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             $router->post('{key}/test-credentials', $controller('testCredentials'));
                         });
                         $router->fleetbaseRoutes('maintenance-schedules', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                             $router->post('{id}/pause', $controller('pause'));
                             $router->post('{id}/resume', $controller('resume'));
@@ -538,19 +587,23 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             $router->get('{id}/ical', $controller('ical'));
                         });
                         $router->fleetbaseRoutes('work-orders', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                             $router->post('{id}/send', $controller('sendEmail'));
                         });
                         $router->fleetbaseRoutes('maintenances', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                             $router->post('{id}/line-items', $controller('addLineItem'));
                             $router->put('{id}/line-items/{index}', $controller('updateLineItem'));
                             $router->delete('{id}/line-items/{index}', $controller('removeLineItem'));
                         });
                         $router->fleetbaseRoutes('equipment', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                         });
                         $router->fleetbaseRoutes('parts', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                         });
                         $router->fleetbaseRoutes('warranties');

package/server/tests/AiCreateOrderPreviewCapabilityTest.php

@@ -0,0 +1,131 @@
+<?php
+
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Support\Ai\Capabilities\CreateOrderPreviewCapability;
+use Fleetbase\LaravelMysqlSpatial\Types\Point as SpatialPoint;
+use Illuminate\Support\Carbon;
+
+function fleetopsAiCreateOrderCapability()
+{
+    return (new ReflectionClass(CreateOrderPreviewCapability::class))->newInstanceWithoutConstructor();
+}
+
+function fleetopsAiCreateOrderProtectedMethod(string $method): ReflectionMethod
+{
+    $reflection = new ReflectionClass(CreateOrderPreviewCapability::class);
+    $method     = $reflection->getMethod($method);
+    $method->setAccessible(true);
+
+    return $method;
+}
+
+test('create order preview parser extracts pickup and dropoff labels', function (string $prompt, array $expected) {
+    $capability = fleetopsAiCreateOrderCapability();
+    $method     = fleetopsAiCreateOrderProtectedMethod('addressPairFromPrompt');
+
+    expect($method->invoke($capability, $prompt))->toBe($expected);
+})->with([
+    'pickup comma and dropoff' => [
+        'Create an order with the pickup 16 simon walk singapore, and the dropoff 18 hougang ave',
+        ['16 simon walk singapore', '18 hougang ave'],
+    ],
+    'pickup at and drop off to' => [
+        'Create an order pickup at 16 simon walk singapore and drop off to 18 hougang ave',
+        ['16 simon walk singapore', '18 hougang ave'],
+    ],
+    'from to' => [
+        'Create an order from 16 simon walk singapore to 18 hougang ave',
+        ['16 simon walk singapore', '18 hougang ave'],
+    ],
+]);
+
+test('create order preview keeps unresolved addresses as provisional places', function () {
+    $capability = fleetopsAiCreateOrderCapability();
+    $method     = fleetopsAiCreateOrderProtectedMethod('provisionalPlace');
+
+    expect($method->invoke($capability, '16 simon walk singapore'))->toMatchArray([
+        'uuid'      => null,
+        'name'      => '16 simon walk singapore',
+        'address'   => '16 simon walk singapore',
+        'latitude'  => null,
+        'longitude' => null,
+        'source'    => 'unresolved',
+    ]);
+});
+
+test('create order preview serializes coordinates from place location', function () {
+    $capability = fleetopsAiCreateOrderCapability();
+    $method     = fleetopsAiCreateOrderProtectedMethod('serializePlace');
+    $place      = new Place([
+        'name'        => '16 Simon Walk',
+        'street1'     => '16 Simon Walk',
+        'city'        => 'Singapore',
+        'postal_code' => '545870',
+        'location'    => new SpatialPoint(1.3621663, 103.8845049),
+    ]);
+
+    expect($method->invoke($capability, $place, '16 simon walk singapore'))->toMatchArray([
+        'latitude'  => 1.3621663,
+        'longitude' => 103.8845049,
+    ]);
+});
+
+test('create order preview route preview excludes return stops', function () {
+    $capability = fleetopsAiCreateOrderCapability();
+    $method     = fleetopsAiCreateOrderProtectedMethod('routePreview');
+
+    $preview = $method->invoke($capability, [
+        'payload' => [
+            'pickup'  => ['address' => '16 Simon Walk', 'latitude' => 1.3621663, 'longitude' => 103.8845049],
+            'dropoff' => ['address' => '18 Hougang Avenue 8', 'latitude' => 1.3701, 'longitude' => 103.8912],
+            'return'  => ['address' => 'Ignored return', 'latitude' => 1.3, 'longitude' => 103.8],
+        ],
+    ]);
+
+    expect(collect($preview['stops'])->pluck('role')->all())
+        ->toBe(['pickup', 'dropoff'])
+        ->and($preview['coordinates'])->toHaveCount(2);
+});
+
+test('create order apply draft removes embedded places when endpoint uuids exist', function () {
+    $capability = new class extends CreateOrderPreviewCapability {
+        public function sanitizeForTest(array $draft): array
+        {
+            return $this->sanitizeDraftForApply($draft);
+        }
+
+        protected function hasExistingPlaceUuid($uuid): bool
+        {
+            return in_array($uuid, ['pickup_uuid_test', 'dropoff_uuid_test'], true);
+        }
+    };
+
+    $draft = $capability->sanitizeForTest([
+        'payload' => [
+            'pickup_uuid'  => 'pickup_uuid_test',
+            'dropoff_uuid' => 'dropoff_uuid_test',
+            'pickup'       => ['uuid' => 'pickup_uuid_test', 'location' => ['type' => 'Point', 'coordinates' => [103.851, 1.2816]]],
+            'dropoff'      => ['uuid' => 'dropoff_uuid_test', 'location' => ['type' => 'Point', 'coordinates' => [103.8318, 1.3048]]],
+            'return'       => ['location' => ['type' => 'Point', 'coordinates' => [103.8, 1.3]]],
+        ],
+    ]);
+
+    expect($draft['payload'])->toHaveKeys(['pickup_uuid', 'dropoff_uuid', 'return'])
+        ->and($draft['payload'])->not->toHaveKeys(['pickup', 'dropoff']);
+});
+
+test('create order preview resolves relative schedule phrases', function () {
+    $timezone = date_default_timezone_get();
+    date_default_timezone_set('Asia/Singapore');
+    Carbon::setTestNow(Carbon::parse('2026-06-30 15:00:00', 'Asia/Singapore'));
+
+    try {
+        $capability = fleetopsAiCreateOrderCapability();
+        $method     = fleetopsAiCreateOrderProtectedMethod('scheduledAtFromPrompt');
+
+        expect($method->invoke($capability, 'Create an order scheduled for 3 days from now'))->toBe('2026-07-03T15:00:00+08:00');
+    } finally {
+        Carbon::setTestNow();
+        date_default_timezone_set($timezone);
+    }
+});

package/server/tests/AiOperationalQueryCapabilityTest.php

@@ -0,0 +1,75 @@
+<?php
+
+use Fleetbase\Ai\Support\AiQueryRegistry;
+use Fleetbase\FleetOps\Support\Ai\Capabilities\AssetStatusCapability;
+use Fleetbase\FleetOps\Support\Ai\Capabilities\OperationalQueryCapability;
+use Fleetbase\FleetOps\Support\Ai\FleetOpsAiQueryResources;
+use Illuminate\Support\Carbon;
+
+function fleetopsAiOperationalCapability()
+{
+    return (new ReflectionClass(OperationalQueryCapability::class))->newInstanceWithoutConstructor();
+}
+
+function fleetopsAiOperationalProtectedMethod(string $method): ReflectionMethod
+{
+    $reflection = new ReflectionClass(OperationalQueryCapability::class);
+    $method     = $reflection->getMethod($method);
+    $method->setAccessible(true);
+
+    return $method;
+}
+
+test('fleet-ops registers safe ai query resources', function () {
+    $registry = new AiQueryRegistry();
+
+    FleetOpsAiQueryResources::register($registry);
+
+    expect($registry->find('drivers')->key)->toBe('fleet-ops.drivers')
+        ->and($registry->find('orders')->hasField('driver_assigned_uuid'))->toBeTrue()
+        ->and($registry->find('devices')->hasField('online'))->toBeTrue()
+        ->and($registry->find('service area')->key)->toBe('fleet-ops.service_areas');
+});
+
+test('operational query capability matches common fleet-ops data questions', function (string $prompt) {
+    $capability = fleetopsAiOperationalCapability();
+    $method     = fleetopsAiOperationalProtectedMethod('matchesPrompt');
+
+    expect($method->invoke($capability, strtolower($prompt)))->toBeTrue();
+})->with([
+    'How many drivers are currently online?',
+    'Where are most of my drivers located?',
+    'How many vehicles were online yesterday?',
+    'Which service area has the most online drivers?',
+    'Show me drivers without vehicles.',
+    'How many active orders have no assigned driver?',
+    'Break down orders by status for this month.',
+]);
+
+test('asset status capability includes driver online prompts', function () {
+    $capability = (new ReflectionClass(AssetStatusCapability::class))->newInstanceWithoutConstructor();
+    $method     = (new ReflectionClass(AssetStatusCapability::class))->getMethod('matchesPrompt');
+    $method->setAccessible(true);
+
+    expect($method->invoke($capability, 'how many drivers are online'))->toBeTrue();
+});
+
+test('operational query date filters use resolved local windows', function () {
+    $timezone = date_default_timezone_get();
+    date_default_timezone_set('Asia/Singapore');
+    Carbon::setTestNow(Carbon::parse('2026-06-30 15:00:00', 'Asia/Singapore'));
+
+    try {
+        $capability = fleetopsAiOperationalCapability();
+        $method     = fleetopsAiOperationalProtectedMethod('orderDateFilters');
+        $filters    = $method->invoke($capability, 'How many orders were created last week?');
+
+        expect($filters)->toHaveCount(2)
+            ->and($filters[0])->toMatchArray(['field' => 'created_at', 'operator' => '>='])
+            ->and($filters[0]['value']->toIso8601String())->toBe('2026-06-22T00:00:00+08:00')
+            ->and($filters[1]['value']->toIso8601String())->toBe('2026-06-28T23:59:59+08:00');
+    } finally {
+        Carbon::setTestNow();
+        date_default_timezone_set($timezone);
+    }
+});

package/server/tests/ExportCoverageTest.php

@@ -0,0 +1,79 @@
+<?php
+
+use Fleetbase\FleetOps\Exports\DeviceExport;
+use Fleetbase\FleetOps\Exports\MaintenanceExport;
+use Fleetbase\FleetOps\Exports\MaintenanceScheduleExport;
+use Fleetbase\FleetOps\Exports\VehicleExport;
+use Fleetbase\FleetOps\Exports\WorkOrderExport;
+
+test('expanded export headings include important operational fields', function () {
+    expect((new VehicleExport())->headings())
+        ->toContain('Plate Number')
+        ->toContain('VIN')
+        ->toContain('Fuel Card Number')
+        ->toContain('Status')
+        ->toContain('Body Type')
+        ->toContain('Usage Type')
+        ->toContain('Transmission')
+        ->toContain('Measurement System')
+        ->toContain('Engine Number')
+        ->toContain('Engine Size (L)')
+        ->toContain('Payload Capacity (kg)')
+        ->toContain('Payload Volume (m3)')
+        ->toContain('DPF Equipped')
+        ->toContain('Insurance Value')
+        ->toContain('Loan Amount')
+        ->toContain('Vehicle Skills')
+        ->toContain('Updated At');
+
+    expect((new WorkOrderExport())->headings())
+        ->toContain('Assignee')
+        ->toContain('Target')
+        ->toContain('Due At')
+        ->toContain('Completion Percentage');
+
+    expect((new DeviceExport())->headings())
+        ->toContain('Connection Status')
+        ->toContain('Attached To')
+        ->toContain('Telematic Provider')
+        ->toContain('Last Seen');
+});
+
+test('relationship exports use readable name columns', function () {
+    expect((new VehicleExport())->headings())
+        ->toContain('Driver')
+        ->toContain('Vendor');
+
+    expect((new WorkOrderExport())->headings())
+        ->toContain('Assignee')
+        ->toContain('Target');
+
+    expect((new MaintenanceExport())->headings())
+        ->toContain('Asset')
+        ->toContain('Performed By');
+
+    expect((new MaintenanceScheduleExport())->headings())
+        ->toContain('Subject')
+        ->toContain('Default Assignee');
+});
+
+test('vehicle export helpers format spreadsheet friendly values', function () {
+    $export = new VehicleExport();
+    $helper = fn (string $method, ...$arguments) => (new ReflectionMethod($export, $method))->invoke($export, ...$arguments);
+
+    expect($helper('yesNo', true))->toBe('Yes')
+        ->and($helper('yesNo', false))->toBe('No')
+        ->and($helper('yesNo', null))->toBeNull()
+        ->and($helper('joinSkills', ['hazmat', 'refrigerated']))->toBe('hazmat, refrigerated')
+        ->and($helper('joinSkills', []))->toBeNull();
+});
+
+test('resources with visible export actions have backend export routes', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    foreach (['devices', 'sensors', 'telematics', 'maintenance-schedules', 'work-orders', 'maintenances', 'equipment', 'parts'] as $resource) {
+        expect($routes)->toContain("\$router->fleetbaseRoutes('{$resource}'");
+    }
+
+    expect(substr_count($routes, "\$router->match(['get', 'post'], 'export', \$controller('export'));"))->toBeGreaterThanOrEqual(19);
+});

package/server/tests/FleetHierarchyResourceTest.php

@@ -0,0 +1,12 @@
+<?php
+
+test('fleet resource expands subfleet drivers and vehicles for hierarchy payloads', function () {
+    $resource = file_get_contents(__DIR__ . '/../src/Http/Resources/v1/Fleet.php');
+
+    expect($resource)
+        ->toContain("if (in_array('subfleets', \$with, true))")
+        ->toContain("if (in_array('drivers', \$with, true))")
+        ->toContain("\$this->loadMissing('subFleets.drivers')")
+        ->toContain("if (in_array('vehicles', \$with, true))")
+        ->toContain("\$this->loadMissing('subFleets.vehicles')");
+});