@fleetbase/fleetops-engine 0.6.52 → 0.6.54

package/server/src/Console/Commands/SyncTelematics.php

@@ -0,0 +1,89 @@
+<?php
+
+namespace Fleetbase\FleetOps\Console\Commands;
+
+use Fleetbase\FleetOps\Jobs\SyncTelematicDevicesJob;
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Support\Telematics\TelematicProviderRegistry;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\Cache;
+
+class SyncTelematics extends Command
+{
+    protected $signature = 'fleetops:sync-telematics
+        {--provider=* : Limit polling to one or more provider keys}
+        {--limit=500 : Maximum provider units to fetch per page}
+        {--sync-webhook-providers : Include providers that support webhooks}
+        {--no-lock : Skip process locking}';
+
+    protected $description = 'Poll active telematics providers for device snapshots and positional telemetry.';
+
+    public function handle(TelematicProviderRegistry $registry): int
+    {
+        $useLock = !$this->option('no-lock');
+        $lock    = null;
+
+        if ($useLock) {
+            $lock = Cache::lock('fleetops:sync-telematics', 600);
+            if (!$lock->get()) {
+                $this->warn('Another telematics sync run appears to be in progress.');
+
+                return self::SUCCESS;
+            }
+        }
+
+        try {
+            $providerKeys = $this->pollableProviderKeys($registry);
+            if (empty($providerKeys)) {
+                $this->info('No pollable telematics providers found.');
+
+                return self::SUCCESS;
+            }
+
+            $query = Telematic::withoutGlobalScopes()
+                ->whereIn('provider', $providerKeys)
+                ->whereIn('status', ['active', 'connected'])
+                ->whereNotNull('company_uuid');
+
+            $queued = 0;
+            $query->orderBy('id')->chunkById(100, function ($telematics) use (&$queued) {
+                foreach ($telematics as $telematic) {
+                    SyncTelematicDevicesJob::dispatch($telematic, [
+                        'limit' => (int) $this->option('limit'),
+                    ]);
+                    $queued++;
+                }
+            });
+
+            $this->info("Queued {$queued} telematics sync job(s).");
+
+            return self::SUCCESS;
+        } finally {
+            if ($lock) {
+                $lock->release();
+            }
+        }
+    }
+
+    protected function pollableProviderKeys(TelematicProviderRegistry $registry): array
+    {
+        $requestedProviders      = array_filter((array) $this->option('provider'));
+        $includeWebhookProviders = (bool) $this->option('sync-webhook-providers');
+
+        return $registry->all()
+            ->filter(function ($descriptor) use ($requestedProviders, $includeWebhookProviders) {
+                if (!empty($requestedProviders) && !in_array($descriptor->key, $requestedProviders, true)) {
+                    return false;
+                }
+
+                if (!$descriptor->supportsDiscovery) {
+                    return false;
+                }
+
+                return $includeWebhookProviders || !$descriptor->supportsWebhooks;
+            })
+            ->keys()
+            ->values()
+            ->all();
+    }
+}

package/server/src/Exceptions/TelematicProviderException.php

@@ -2,8 +2,6 @@
 
 namespace Fleetbase\FleetOps\Exceptions;
 
-use Exception;
-
 /**
  * Class TelematicProviderException.
  *
@@ -11,4 +9,17 @@ use Exception;
  */
 class TelematicProviderException extends \Exception
 {
+    protected array $context;
+
+    public function __construct(string $message = '', array $context = [], int $code = 0, ?\Throwable $previous = null)
+    {
+        parent::__construct($message, $code, $previous);
+
+        $this->context = $context;
+    }
+
+    public function context(): array
+    {
+        return $this->context;
+    }
 }

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

@@ -3,7 +3,6 @@
 namespace Fleetbase\FleetOps\Http\Controllers\Api\v1;
 
 use Fleetbase\FleetOps\Events\OrderDispatchFailed;
-use Fleetbase\FleetOps\Events\OrderReady;
 use Fleetbase\FleetOps\Events\OrderStarted;
 use Fleetbase\FleetOps\Exceptions\CustomerUserConflictException;
 use Fleetbase\FleetOps\Exceptions\UserAlreadyExistsException;
@@ -14,6 +13,7 @@ use Fleetbase\FleetOps\Http\Requests\UpdateOrderRequest;
 use Fleetbase\FleetOps\Http\Resources\v1\DeletedResource;
 use Fleetbase\FleetOps\Http\Resources\v1\Order as OrderResource;
 use Fleetbase\FleetOps\Http\Resources\v1\Proof as ProofResource;
+use Fleetbase\FleetOps\Jobs\FinalizeApiOrderCreation;
 use Fleetbase\FleetOps\Models\Contact;
 use Fleetbase\FleetOps\Models\Driver;
 use Fleetbase\FleetOps\Models\Entity;
@@ -335,26 +335,11 @@ class OrderController extends Controller
         // Determine if order should be dispatched on creation
         $shouldDispatch = $request->boolean('dispatch') && $integratedVendorOrder === null;
 
-        // Run background processes on queue
-        dispatch(function () use ($order, $serviceQuote, $shouldDispatch): void {
-            // notify driver if assigned
-            $order->notifyDriverAssigned();
-
-            // set driving distance and time
-            $order->setPreliminaryDistanceAndTime();
-
-            // if service quote attached purchase
-            $order->purchaseServiceQuote($serviceQuote);
-
-            // dispatch if flagged true
-            if ($shouldDispatch) {
-                $order->dispatchWithActivity();
-            }
-
-            // Trigger order created event
-            event(new OrderReady($order));
-        })
-        ->afterCommit();
+        FinalizeApiOrderCreation::dispatch(
+            $order->uuid,
+            $serviceQuote instanceof ServiceQuote ? $serviceQuote->uuid : null,
+            $shouldDispatch
+        )->afterCommit();
 
         // response the driver resource
         return new OrderResource($order);

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

@@ -5,8 +5,10 @@ namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Models\Device;
 use Fleetbase\FleetOps\Models\Vehicle;
+use Fleetbase\FleetOps\Support\Utils;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
 
 class DeviceController extends FleetOpsController
 {
@@ -42,6 +44,31 @@ class DeviceController extends FleetOpsController
         if ($request->filled('device_id')) {
             $query->where('device_id', 'like', '%' . $request->input('device_id') . '%');
         }
+
+        if ($request->filled('connection_status')) {
+            $statuses = Utils::arrayFrom($request->input('connection_status'));
+
+            $query->where(function ($statusQuery) use ($statuses) {
+                foreach ($statuses as $status) {
+                    match ($status) {
+                        'online'           => $statusQuery->orWhere('last_online_at', '>=', now()->subMinutes(10)),
+                        'recently_offline' => $statusQuery->orWhereBetween('last_online_at', [now()->subMinutes(60), now()->subMinutes(10)]),
+                        'offline'          => $statusQuery->orWhereBetween('last_online_at', [now()->subDay(), now()->subMinutes(60)]),
+                        'long_offline'     => $statusQuery->orWhere('last_online_at', '<', now()->subDay()),
+                        'never_connected'  => $statusQuery->orWhereNull('last_online_at'),
+                        default            => null,
+                    };
+                }
+            });
+        }
+
+        if ($request->filled('last_online_at')) {
+            static::applyDateFilter($query, 'last_online_at', $request->input('last_online_at'));
+        }
+
+        if ($request->filled('updated_at')) {
+            static::applyDateFilter($query, 'updated_at', $request->input('updated_at'));
+        }
     }
 
     /**
@@ -64,11 +91,30 @@ class DeviceController extends FleetOpsController
             'vehicle' => 'required_without:attachable_uuid|nullable|string',
         ]);
 
-        $device  = $this->findDevice($id);
-        $vehicle = $this->findVehicle($request->input('vehicle') ?? $request->input('attachable_uuid'));
+        $vehicleId = $request->input('vehicle') ?? $request->input('attachable_uuid');
+        $device    = $this->resolveDevice($id);
+        $vehicle   = $this->resolveVehicle($vehicleId);
+
+        if (!$device) {
+            $this->logDeviceAttachmentLookupFailure('attach', 'device', $id, $vehicleId);
+
+            return response()->error('Device not found or not available for this organization.', 404);
+        }
+
+        if (!$vehicle) {
+            $this->logDeviceAttachmentLookupFailure('attach', 'vehicle', $id, $vehicleId);
+
+            return response()->error('Vehicle not found or not available for this organization.', 404);
+        }
 
-        $device->attachTo($vehicle);
-        $device->load(['telematic', 'warranty', 'attachable']);
+        try {
+            $device->attachTo($vehicle);
+            $device->load(['telematic', 'warranty', 'attachable']);
+        } catch (\Throwable $e) {
+            $this->logDeviceAttachmentFailure('attach', $device, $vehicle, $e);
+
+            return response()->error('Unable to attach device to vehicle. Please try again or contact support.', 500);
+        }
 
         return response()->json([
             'status' => 'ok',
@@ -81,9 +127,22 @@ class DeviceController extends FleetOpsController
      */
     public function detach(string $id): JsonResponse
     {
-        $device = $this->findDevice($id);
-        $device->detach();
-        $device->load(['telematic', 'warranty', 'attachable']);
+        $device = $this->resolveDevice($id);
+
+        if (!$device) {
+            $this->logDeviceAttachmentLookupFailure('detach', 'device', $id, null);
+
+            return response()->error('Device not found or not available for this organization.', 404);
+        }
+
+        try {
+            $device->detach();
+            $device->load(['telematic', 'warranty', 'attachable']);
+        } catch (\Throwable $e) {
+            $this->logDeviceAttachmentFailure('detach', $device, null, $e);
+
+            return response()->error('Unable to detach device from vehicle. Please try again or contact support.', 500);
+        }
 
         return response()->json([
             'status' => 'ok',
@@ -91,21 +150,63 @@ class DeviceController extends FleetOpsController
         ]);
     }
 
-    protected function findDevice(string $id): Device
+    protected function resolveDevice(string $id): ?Device
     {
         return Device::where(function ($query) use ($id) {
             $query->where('uuid', $id)->orWhere('public_id', $id);
         })
             ->where('company_uuid', session('company'))
-            ->firstOrFail();
+            ->first();
     }
 
-    protected function findVehicle(?string $id): Vehicle
+    protected function resolveVehicle(?string $id): ?Vehicle
     {
+        if (!$id) {
+            return null;
+        }
+
         return Vehicle::where(function ($query) use ($id) {
             $query->where('uuid', $id)->orWhere('public_id', $id);
         })
             ->where('company_uuid', session('company'))
-            ->firstOrFail();
+            ->first();
+    }
+
+    protected static function applyDateFilter($query, string $column, string|array $value): void
+    {
+        $dates = Utils::dateRange($value);
+
+        if (is_array($dates)) {
+            $query->whereBetween($column, $dates);
+        } else {
+            $query->whereDate($column, $dates);
+        }
+    }
+
+    protected function logDeviceAttachmentLookupFailure(string $action, string $missingResource, string $deviceId, ?string $vehicleId): void
+    {
+        Log::warning('Device attachment lookup failed', [
+            'action'           => $action,
+            'missing_resource' => $missingResource,
+            'device_id'        => $deviceId,
+            'vehicle_id'       => $vehicleId,
+            'company_uuid'     => session('company'),
+            'request_id'       => request()->headers->get('X-Request-ID') ?? request()->headers->get('X-Correlation-ID'),
+        ]);
+    }
+
+    protected function logDeviceAttachmentFailure(string $action, Device $device, ?Vehicle $vehicle, \Throwable $exception): void
+    {
+        Log::error('Device attachment failed', [
+            'action'          => $action,
+            'device_uuid'     => $device->uuid,
+            'device_id'       => $device->public_id,
+            'vehicle_uuid'    => $vehicle?->uuid,
+            'vehicle_id'      => $vehicle?->public_id,
+            'company_uuid'    => session('company'),
+            'request_id'      => request()->headers->get('X-Request-ID') ?? request()->headers->get('X-Correlation-ID'),
+            'exception_class' => get_class($exception),
+            'exception'       => $exception->getMessage(),
+        ]);
     }
 }

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

@@ -4,6 +4,7 @@ namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Models\DeviceEvent;
+use Fleetbase\FleetOps\Support\Utils;
 use Illuminate\Http\JsonResponse;
 
 class DeviceEventController extends FleetOpsController
@@ -32,11 +33,21 @@ class DeviceEventController extends FleetOpsController
         }
 
         if ($request->filled('processed')) {
-            match ($request->input('processed')) {
-                'processed'   => $query->whereNotNull('processed_at'),
-                'unprocessed' => $query->whereNull('processed_at'),
-                default       => null,
-            };
+            $states = Utils::arrayFrom($request->input('processed'));
+
+            if (!$states) {
+                return;
+            }
+
+            $query->where(function ($query) use ($states) {
+                foreach ($states as $state) {
+                    match ($state) {
+                        'processed'   => $query->orWhereNotNull('processed_at'),
+                        'unprocessed' => $query->orWhereNull('processed_at'),
+                        default       => null,
+                    };
+                }
+            });
         }
     }
 

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

@@ -11,6 +11,7 @@ use Fleetbase\FleetOps\Models\Fleet;
 use Fleetbase\FleetOps\Models\FleetDriver;
 use Fleetbase\FleetOps\Models\FleetVehicle;
 use Fleetbase\FleetOps\Models\Vehicle;
+use Fleetbase\FleetOps\Support\LiveCacheService;
 use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
 use Illuminate\Http\Request;
@@ -121,6 +122,8 @@ class FleetController extends FleetOpsController
             'driver_uuid' => $driver->uuid,
         ])->delete();
 
+        LiveCacheService::invalidate('operations-monitor');
+
         return response()->json([
             'status'  => 'ok',
             'deleted' => $deleted,
@@ -153,6 +156,8 @@ class FleetController extends FleetOpsController
             ]);
         }
 
+        LiveCacheService::invalidate('operations-monitor');
+
         return response()->json([
             'status' => 'ok',
             'exists' => $exists,
@@ -178,6 +183,8 @@ class FleetController extends FleetOpsController
             'vehicle_uuid' => $vehicle->uuid,
         ])->delete();
 
+        LiveCacheService::invalidate('operations-monitor');
+
         return response()->json([
             'status'  => 'ok',
             'deleted' => $deleted,
@@ -210,6 +217,8 @@ class FleetController extends FleetOpsController
             ]);
         }
 
+        LiveCacheService::invalidate('operations-monitor');
+
         return response()->json([
             'status' => 'ok',
             'exists' => $exists,