@fleetbase/fleetops-engine 0.6.47 → 0.6.49

package/server/src/Http/Controllers/Internal/v1/OrderController.php

@@ -26,16 +26,17 @@ use Fleetbase\FleetOps\Models\Proof;
 use Fleetbase\FleetOps\Models\ServiceQuote;
 use Fleetbase\FleetOps\Models\TrackingStatus;
 use Fleetbase\FleetOps\Models\Waypoint;
+use Fleetbase\FleetOps\Notifications\OrderPing;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\Internal\BulkActionRequest;
 use Fleetbase\Models\File;
 use Fleetbase\Models\Type;
+use Fleetbase\Support\Auth;
 use Fleetbase\Support\TemplateString;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Illuminate\Database\QueryException;
 use Illuminate\Http\Request;
-use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Validator;
 use Illuminate\Support\Str;
@@ -111,17 +112,23 @@ class OrderController extends FleetOpsController
                         $input['integrated_vendor_order'] = $integratedVendorOrder;
                     }
 
-                    // Normalize order config + type onto the company transport
-                    // config when an explicit config was not provided.
-                    $resolvedOrderConfig = null;
-                    if (!empty($input['order_config_uuid']) || !empty($input['type'])) {
-                        $resolvedOrderConfig = OrderConfig::resolveFromIdentifier([$input['order_config_uuid'] ?? null, $input['type'] ?? null]);
+                    // Normalize order config + type. Invalid explicit configs must
+                    // not silently fall back to the default transport config.
+                    $hasExplicitOrderConfig = !empty($input['order_config_uuid']);
+                    $hasExplicitOrderType   = !empty($input['type']);
+                    $resolvedOrderConfig    = OrderConfig::resolveFromIdentifier([$input['order_config_uuid'] ?? null, $input['type'] ?? null]);
+
+                    if (!$resolvedOrderConfig && $hasExplicitOrderConfig) {
+                        throw new FleetbaseRequestValidationException(['order_config_uuid' => 'The selected order config is invalid.']);
+                    }
+
+                    if (!$resolvedOrderConfig && !$hasExplicitOrderType) {
+                        $resolvedOrderConfig = OrderConfig::defaultOrCreate();
                     }
-                    $resolvedOrderConfig ??= OrderConfig::defaultOrCreate();
 
                     if ($resolvedOrderConfig) {
                         $input['order_config_uuid'] = $resolvedOrderConfig->uuid;
-                        $input['type'] = $resolvedOrderConfig->key;
+                        $input['type']              = $resolvedOrderConfig->key;
                     } elseif (!isset($input['type'])) {
                         $input['type'] = 'transport';
                     }
@@ -762,7 +769,7 @@ class OrderController extends FleetOpsController
             return response()->error('No order found.');
         }
 
-        $waypoint   = $request->filled('waypoint') ? Waypoint::findByPlace($request->input('waypoint'), $order) : null;
+        $waypoint    = $request->filled('waypoint') ? Waypoint::findByPlace($request->input('waypoint'), $order) : null;
         $orderConfig = $order->ensureOrderConfig();
         if (!$orderConfig) {
             return response()->error('No order config found for order.');
@@ -792,33 +799,57 @@ class OrderController extends FleetOpsController
      *
      * @return \Illuminate\Http\Response
      */
-    public function trackerInfo(string $id)
+    public function trackerInfo(Request $request, string $id)
     {
         $order = Order::findById($id);
         if (!$order) {
             return response()->error('No order found.');
         }
 
-        // Cache tracker data for 30 seconds with order-specific key
-        $cacheKey    = "order:{$order->uuid}:tracker";
-        $trackerInfo = Cache::remember($cacheKey, 30, function () use ($order) {
-            return $order->tracker()->toArray();
-        });
-
-        return response()->json($trackerInfo);
+        return response()->json($order->tracker()->toArray($request->only(['provider', 'fallbacks', 'traffic_enabled'])));
     }
 
-    public function waypointEtas(string $id)
+    public function waypointEtas(Request $request, string $id)
     {
         $order = Order::findById($id);
         if (!$order) {
             return response()->error('No order found.');
         }
 
-        // Get order tracker
-        $eta = $order->tracker()->eta();
+        return response()->json($order->tracker()->eta($request->only(['provider', 'fallbacks', 'traffic_enabled'])));
+    }
+
+    /**
+     * Ping the assigned driver to refresh/order attention in the driver app.
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function pingDriver(string $id)
+    {
+        if (!Auth::can('fleet-ops update order')) {
+            return response()->error('Unauthorized.', 403);
+        }
 
-        return response()->json($eta);
+        try {
+            $order = Order::findByIdOrFail($id, ['driverAssigned']);
+        } catch (ModelNotFoundException $e) {
+            return response()->error('Order resource not found.', 404);
+        }
+
+        if (!$order->driverAssigned) {
+            return response()->error('Order does not have an assigned driver.', 422);
+        }
+
+        try {
+            $order->driverAssigned->notify(new OrderPing($order));
+
+            return response()->json([
+                'status'  => 'ok',
+                'message' => 'Driver app ping sent.',
+            ]);
+        } catch (\Throwable $e) {
+            return response()->error('Unable to ping driver app.', 500);
+        }
     }
 
     /**

package/server/src/Http/Controllers/Internal/v1/ServiceQuoteController.php

@@ -226,7 +226,7 @@ class ServiceQuoteController extends FleetOpsController
         $entities  = collect($entities)->mapInto(Entity::class);
 
         // should all be Place like
-        $waypoints = collect([$pickup, ...$waypoints, $dropoff])->filter();
+        $waypoints     = collect([$pickup, ...$waypoints, $dropoff])->filter();
         $endpointCount = (int) ($pickup instanceof Place) + (int) ($dropoff instanceof Place);
 
         // if facilitator is an integrated partner resolve service quotes from bridge

package/server/src/Http/Controllers/Internal/v1/SettingController.php

@@ -2,6 +2,7 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Tracking\TrackingProviderRegistry;
 use Fleetbase\Http\Controllers\Controller;
 use Fleetbase\Models\Setting;
 use Fleetbase\Support\Auth;
@@ -211,12 +212,12 @@ class SettingController extends Controller
     {
         $routingSettings = Setting::lookupCompany('routing', ['router' => 'osrm', 'unit' => 'km']);
 
-        $displayEngine = data_get($routingSettings, 'display_engine', data_get($routingSettings, 'routing_display_engine', data_get($routingSettings, 'router', 'osrm')));
-        $optimizationEngine = data_get($routingSettings, 'optimization_engine', data_get($routingSettings, 'routing_optimization_engine', $displayEngine));
-        $routingSettings['router'] = $displayEngine;
-        $routingSettings['display_engine'] = $displayEngine;
-        $routingSettings['optimization_engine'] = $optimizationEngine;
-        $routingSettings['routing_display_engine'] = $displayEngine;
+        $displayEngine                                  = data_get($routingSettings, 'display_engine', data_get($routingSettings, 'routing_display_engine', data_get($routingSettings, 'router', 'osrm')));
+        $optimizationEngine                             = data_get($routingSettings, 'optimization_engine', data_get($routingSettings, 'routing_optimization_engine', $displayEngine));
+        $routingSettings['router']                      = $displayEngine;
+        $routingSettings['display_engine']              = $displayEngine;
+        $routingSettings['optimization_engine']         = $optimizationEngine;
+        $routingSettings['routing_display_engine']      = $displayEngine;
         $routingSettings['routing_optimization_engine'] = $optimizationEngine;
 
         // always default to km if no unit is set
@@ -227,6 +228,91 @@ class SettingController extends Controller
         return response()->json($routingSettings);
     }
 
+    /**
+     * Save order tracking intelligence settings.
+     *
+     * @param Request $request the HTTP request object containing tracking settings
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function saveTrackingSettings(Request $request)
+    {
+        $config    = $this->trackingDefaults();
+        $fallbacks = $request->input('fallbacks', data_get($config, 'fallbacks', ['osrm', 'calculated']));
+        if (is_string($fallbacks)) {
+            $fallbacks = array_values(array_filter(array_map('trim', explode(',', $fallbacks))));
+        }
+
+        Setting::configureCompany('tracking', [
+            'provider'                         => $request->input('provider', data_get($config, 'provider', 'google_routes')),
+            'fallbacks'                        => $fallbacks,
+            'traffic_enabled'                  => $request->boolean('traffic_enabled', data_get($config, 'traffic_enabled', true)),
+            'cache_ttl_seconds'                => (int) $request->input('cache_ttl_seconds', data_get($config, 'cache_ttl_seconds', 60)),
+            'route_cache_ttl_seconds'          => (int) $request->input('route_cache_ttl_seconds', data_get($config, 'route_cache_ttl_seconds', 600)),
+            'stale_location_threshold_seconds' => (int) $request->input('stale_location_threshold_seconds', data_get($config, 'stale_location_threshold_seconds', 300)),
+            'default_vehicle_speed_kph'        => (float) $request->input('default_vehicle_speed_kph', data_get($config, 'default_vehicle_speed_kph', 35)),
+            'alerts'                           => $this->normalizeTrackingAlertSettings((array) $request->input('alerts', data_get($config, 'alerts', []))),
+        ]);
+
+        return response()->json([
+            'status'  => 'ok',
+            'message' => 'Tracking settings succesfully saved.',
+        ]);
+    }
+
+    /**
+     * Retrieve order tracking intelligence settings.
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function getTrackingSettings()
+    {
+        $config           = $this->trackingDefaults();
+        $trackingSettings = Setting::lookupCompany('tracking', [
+            'provider'                         => data_get($config, 'provider', 'google_routes'),
+            'fallbacks'                        => data_get($config, 'fallbacks', ['osrm', 'calculated']),
+            'traffic_enabled'                  => data_get($config, 'traffic_enabled', true),
+            'cache_ttl_seconds'                => data_get($config, 'cache_ttl_seconds', 60),
+            'route_cache_ttl_seconds'          => data_get($config, 'route_cache_ttl_seconds', 600),
+            'stale_location_threshold_seconds' => data_get($config, 'stale_location_threshold_seconds', 300),
+            'default_vehicle_speed_kph'        => data_get($config, 'default_vehicle_speed_kph', 35),
+            'alerts'                           => data_get($config, 'alerts', $this->trackingAlertDefaults()),
+        ]);
+        $trackingSettings['alerts']    = $this->normalizeTrackingAlertSettings(data_get($trackingSettings, 'alerts', []));
+        $trackingSettings['providers'] = $this->trackingProviderOptions();
+
+        return response()->json($trackingSettings);
+    }
+
+    public function getAdminTrackingSettings()
+    {
+        return response()->json(array_merge($this->trackingDefaults(), [
+            'providers' => $this->trackingProviderOptions(),
+        ]));
+    }
+
+    public function saveAdminTrackingSettings(Request $request)
+    {
+        $config    = config('fleetops.tracking', []);
+        $fallbacks = $request->input('fallbacks', data_get($config, 'fallbacks', ['osrm', 'calculated']));
+        if (is_string($fallbacks)) {
+            $fallbacks = array_values(array_filter(array_map('trim', explode(',', $fallbacks))));
+        }
+
+        Setting::configure('fleet-ops.tracking-settings', [
+            'provider'                         => $request->input('provider', data_get($config, 'provider', 'google_routes')),
+            'fallbacks'                        => $fallbacks,
+            'traffic_enabled'                  => $request->boolean('traffic_enabled', data_get($config, 'traffic_enabled', true)),
+            'cache_ttl_seconds'                => (int) $request->input('cache_ttl_seconds', data_get($config, 'cache_ttl_seconds', 60)),
+            'route_cache_ttl_seconds'          => (int) $request->input('route_cache_ttl_seconds', data_get($config, 'route_cache_ttl_seconds', 600)),
+            'stale_location_threshold_seconds' => (int) $request->input('stale_location_threshold_seconds', data_get($config, 'stale_location_threshold_seconds', 300)),
+            'default_vehicle_speed_kph'        => (float) $request->input('default_vehicle_speed_kph', data_get($config, 'default_vehicle_speed_kph', 35)),
+            'alerts'                           => $this->normalizeTrackingAlertSettings((array) $request->input('alerts', data_get($config, 'alerts', []))),
+        ]);
+
+        return response()->json($this->getAdminTrackingSettings()->getData(true));
+    }
+
     /**
      * Retrieve and return the map provider settings for the current company.
      *
@@ -244,15 +330,15 @@ class SettingController extends Controller
             'mapProvider' => 'leaflet',
         ];
 
-        $systemMapSettings = Setting::lookup('fleet-ops.map-settings', []);
-        $mapSettings = Setting::lookupFromCompany('fleet-ops.map-settings', $defaults);
+        $systemMapSettings          = Setting::lookup('fleet-ops.map-settings', []);
+        $mapSettings                = Setting::lookupFromCompany('fleet-ops.map-settings', $defaults);
         $mapSettings['mapProvider'] = data_get($mapSettings, 'mapProvider') ?: data_get($systemMapSettings, 'mapProvider', 'leaflet');
 
         // Source the Google Maps API key from the system-level services config
         // that is managed by the core-api admin settings panel. This ensures a
         // single source of truth and avoids duplicating key management.
         $mapSettings['googleMapsApiKey'] = config('services.google_maps.api_key', env('GOOGLE_MAPS_API_KEY', ''));
-        $mapSettings['googleMapsMapId'] = data_get($systemMapSettings, 'googleMapsMapId', '');
+        $mapSettings['googleMapsMapId']  = data_get($systemMapSettings, 'googleMapsMapId', '');
 
         return response()->json($mapSettings);
     }
@@ -289,7 +375,7 @@ class SettingController extends Controller
     public function getAdminMapSettings()
     {
         $defaults = [
-            'mapProvider' => 'leaflet',
+            'mapProvider'     => 'leaflet',
             'googleMapsMapId' => '',
         ];
 
@@ -299,13 +385,13 @@ class SettingController extends Controller
     public function saveAdminMapSettings(Request $request)
     {
         $allowedProviders = ['leaflet', 'google'];
-        $mapProvider = $request->input('mapProvider', 'leaflet');
+        $mapProvider      = $request->input('mapProvider', 'leaflet');
         if (!in_array($mapProvider, $allowedProviders)) {
             $mapProvider = 'leaflet';
         }
 
         $settings = [
-            'mapProvider' => $mapProvider,
+            'mapProvider'     => $mapProvider,
             'googleMapsMapId' => (string) $request->input('googleMapsMapId', ''),
         ];
 
@@ -431,4 +517,70 @@ class SettingController extends Controller
             'settings' => $normalized,
         ]);
     }
+
+    protected function trackingDefaults(): array
+    {
+        $config         = config('fleetops.tracking', []);
+        $systemSettings = Setting::lookup('fleet-ops.tracking-settings', []);
+
+        $defaults = array_merge($config, is_array($systemSettings) ? $systemSettings : []);
+        $defaults['alerts'] = $this->normalizeTrackingAlertSettings(data_get($defaults, 'alerts', []));
+
+        return $defaults;
+    }
+
+    protected function trackingAlertDefaults(): array
+    {
+        return [
+            'late_departures' => [
+                'enabled'              => true,
+                'grace_period_minutes' => 15,
+            ],
+            'route_deviations' => [
+                'enabled'                    => true,
+                'distance_threshold_meters'  => 500,
+            ],
+            'prolonged_stoppages' => [
+                'enabled'                  => true,
+                'duration_threshold_minutes' => 30,
+            ],
+        ];
+    }
+
+    protected function normalizeTrackingAlertSettings(array $alerts): array
+    {
+        $defaults = $this->trackingAlertDefaults();
+
+        return [
+            'late_departures' => [
+                'enabled'              => (bool) data_get($alerts, 'late_departures.enabled', data_get($defaults, 'late_departures.enabled')),
+                'grace_period_minutes' => max(0, (int) data_get($alerts, 'late_departures.grace_period_minutes', data_get($defaults, 'late_departures.grace_period_minutes'))),
+            ],
+            'route_deviations' => [
+                'enabled'                   => (bool) data_get($alerts, 'route_deviations.enabled', data_get($defaults, 'route_deviations.enabled')),
+                'distance_threshold_meters' => max(0, (int) data_get($alerts, 'route_deviations.distance_threshold_meters', data_get($defaults, 'route_deviations.distance_threshold_meters'))),
+            ],
+            'prolonged_stoppages' => [
+                'enabled'                    => (bool) data_get($alerts, 'prolonged_stoppages.enabled', data_get($defaults, 'prolonged_stoppages.enabled')),
+                'duration_threshold_minutes' => max(0, (int) data_get($alerts, 'prolonged_stoppages.duration_threshold_minutes', data_get($defaults, 'prolonged_stoppages.duration_threshold_minutes'))),
+            ],
+        ];
+    }
+
+    protected function trackingProviderOptions(): array
+    {
+        $registry = app(TrackingProviderRegistry::class);
+
+        return collect($registry->all())->map(function ($provider, $key) {
+            $label = $key === 'osrm' ? 'OSRM' : str($key)->replace('_', ' ')->title()->toString();
+
+            return [
+                'key'          => $key,
+                'name'         => $label,
+                'value'        => $key,
+                'label'        => $label,
+                'capabilities' => $provider->capabilities()->toArray(),
+            ];
+        })->values()->all();
+    }
 }

package/server/src/Http/Resources/v1/Driver.php

@@ -38,6 +38,7 @@ class Driver extends FleetbaseResource
             'email'                         => $this->email,
             'phone'                         => $this->phone,
             'drivers_license_number'        => $this->drivers_license_number,
+            'license_expiry'                => $this->license_expiry,
             'photo_url'                     => $this->photo_url,
             'avatar_url'                    => $this->avatar_url,
             'avatar_value'                  => $this->when(Http::isInternalRequest(), $this->getOriginal('avatar_url')),
@@ -94,6 +95,7 @@ class Driver extends FleetbaseResource
             'email'                  => $this->email,
             'phone'                  => $this->phone,
             'photo_url'              => $this->photo_url,
+            'license_expiry'         => $this->license_expiry,
             'vehicle'                => data_get($this, 'vehicle.public_id'),
             'current_job'            => data_get($this, 'currentJob.public_id'),
             'vendor'                 => data_get($this, 'vendor.public_id'),

package/server/src/Http/Resources/v1/Fleet.php

@@ -23,6 +23,10 @@ class Fleet extends FleetbaseResource
             }, $request->array('with'));
 
             $this->load($with);
+
+            if (in_array('subfleets', $with, true) && in_array('vehicles', $with, true)) {
+                $this->loadMissing('subFleets.vehicles');
+            }
         }
 
         return $this->withCustomFields([

package/server/src/Http/Resources/v1/Index/Driver.php

@@ -33,6 +33,7 @@ class Driver extends FleetbaseResource
             'current_job_uuid'=> $this->when($isInternal, $this->current_job_uuid),
             'name'            => $this->name,
             'vehicle_name'    => $this->when($isInternal, $this->vehicle_name),
+            'email'           => $this->email,
             'phone'           => $this->phone,
             'photo_url'       => $this->photo_url,
             'status'          => $this->status,
@@ -41,6 +42,53 @@ class Driver extends FleetbaseResource
             'altitude'        => (int) data_get($this, 'altitude', 0),
             'speed'           => (int) data_get($this, 'speed', 0),
             'online'          => data_get($this, 'online', false),
+            'meta'            => [
+                '_index_resource'         => true,
+                'location_coordinates'    => $this->locationCoordinates(),
+                'current_order_reference' => $this->currentOrderReference(),
+                'speed_label'             => $this->speedLabel(),
+                'heading_label'           => $this->headingLabel(),
+                'status_label'            => $this->statusLabel(),
+            ],
         ];
     }
+
+    protected function currentOrderReference(): ?string
+    {
+        $this->loadMissing('currentOrder');
+        $order = data_get($this, 'currentOrder');
+
+        return data_get($order, 'tracking') ?? data_get($order, 'public_id');
+    }
+
+    protected function locationCoordinates(): ?string
+    {
+        $location = Utils::castPoint($this->location);
+
+        return $location ? $this->formatCoordinate($location->getLat()) . ' ' . $this->formatCoordinate($location->getLng()) : null;
+    }
+
+    protected function speedLabel(): string
+    {
+        $speed = data_get($this, 'speed');
+
+        return is_numeric($speed) ? ((int) $speed) . ' km/h' : '-';
+    }
+
+    protected function headingLabel(): string
+    {
+        $heading = data_get($this, 'heading');
+
+        return is_numeric($heading) ? ((int) $heading) . ' deg' : '-';
+    }
+
+    protected function statusLabel(): ?string
+    {
+        return $this->status ? str($this->status)->replace(['_', '-'], ' ')->headline()->toString() : null;
+    }
+
+    protected function formatCoordinate(float $coordinate): string
+    {
+        return (string) round($coordinate, 4);
+    }
 }

package/server/src/Http/Resources/v1/Index/Payload.php

@@ -19,8 +19,8 @@ class Payload extends FleetbaseResource
     public function toArray($request): array
     {
         $isInternal = Http::isInternalRequest();
-        $pickup = $this->index_pickup_place;
-        $dropoff = $this->index_dropoff_place;
+        $pickup     = $this->index_pickup_place;
+        $dropoff    = $this->index_dropoff_place;
 
         return [
             'id'           => $this->when($isInternal, $this->id, $this->public_id),

package/server/src/Http/Resources/v1/Index/Vehicle.php

@@ -2,6 +2,7 @@
 
 namespace Fleetbase\FleetOps\Http\Resources\v1\Index;
 
+use Fleetbase\FleetOps\Models\Order;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Http\Resources\FleetbaseResource;
 use Fleetbase\Support\Http;
@@ -28,8 +29,12 @@ class Vehicle extends FleetbaseResource
             'company_uuid'    => $this->when($isInternal, $this->company_uuid),
             'vendor_uuid'     => $this->when($isInternal, $this->vendor_uuid),
             'photo_uuid'      => $this->when($isInternal, $this->photo_uuid),
+            'internal_id'     => $this->internal_id,
             'display_name'    => $this->display_name,
+            'driver_name'     => $this->driver_name,
             'plate_number'    => $this->plate_number,
+            'serial_number'   => $this->serial_number,
+            'vin'             => $this->vin,
             'make'            => $this->make,
             'model'           => $this->model,
             'year'            => $this->year,
@@ -43,8 +48,76 @@ class Vehicle extends FleetbaseResource
 
             // Meta flag to indicate this is an index resource
             'meta'            => [
-                '_index_resource' => true,
+                '_index_resource'          => true,
+                'current_order_reference'  => $this->currentOrderReference(),
+                'location_coordinates'     => $this->locationCoordinates(),
+                'speed_label'              => $this->speedLabel(),
+                'heading_label'            => $this->headingLabel(),
+                'status_label'             => $this->statusLabel(),
             ],
         ];
     }
+
+    protected function currentOrderReference(): ?string
+    {
+        $this->loadMissing('driver.currentOrder');
+        $order = data_get($this, 'driver.currentOrder') ?? $this->currentPositionOrder() ?? $this->currentVehicleOrder();
+
+        return data_get($order, 'tracking') ?? data_get($order, 'public_id');
+    }
+
+    protected function locationCoordinates(): ?string
+    {
+        $location = Utils::castPoint($this->location);
+
+        return $location ? $this->formatCoordinate($location->getLat()) . ' ' . $this->formatCoordinate($location->getLng()) : null;
+    }
+
+    protected function speedLabel(): string
+    {
+        $speed = data_get($this->lastKnownPosition(), 'speed', data_get($this, 'speed'));
+
+        return is_numeric($speed) ? ((int) $speed) . ' km/h' : '-';
+    }
+
+    protected function headingLabel(): string
+    {
+        $heading = data_get($this->lastKnownPosition(), 'heading', data_get($this, 'heading'));
+
+        return is_numeric($heading) ? ((int) $heading) . ' deg' : '-';
+    }
+
+    protected function statusLabel(): ?string
+    {
+        return $this->status ? str($this->status)->replace(['_', '-'], ' ')->headline()->toString() : null;
+    }
+
+    protected function currentPositionOrder(): ?Order
+    {
+        $orderUuid = data_get($this->lastKnownPosition(), 'order_uuid');
+
+        return $orderUuid ? Order::where('uuid', $orderUuid)->first() : null;
+    }
+
+    protected function currentVehicleOrder(): ?Order
+    {
+        return Order::where('vehicle_assigned_uuid', $this->uuid)
+            ->whereNotIn('status', ['completed', 'canceled', 'cancelled'])
+            ->latest()
+            ->first();
+    }
+
+    protected function lastKnownPosition()
+    {
+        if (!$this->resource->relationLoaded('last_known_position')) {
+            $this->resource->setRelation('last_known_position', $this->getLastKnownPosition());
+        }
+
+        return $this->resource->getRelation('last_known_position');
+    }
+
+    protected function formatCoordinate(float $coordinate): string
+    {
+        return (string) round($coordinate, 4);
+    }
 }