@fleetbase/fleetops-engine 0.6.56 → 0.6.57

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

@@ -24,8 +24,14 @@ class Fleet extends FleetbaseResource
 
             $this->load($with);
 
-            if (in_array('subfleets', $with, true) && in_array('vehicles', $with, true)) {
-                $this->loadMissing('subFleets.vehicles');
+            if (in_array('subfleets', $with, true)) {
+                if (in_array('drivers', $with, true)) {
+                    $this->loadMissing('subFleets.drivers');
+                }
+
+                if (in_array('vehicles', $with, true)) {
+                    $this->loadMissing('subFleets.vehicles');
+                }
             }
         }
 

package/server/src/Models/Driver.php

@@ -278,6 +278,8 @@ class Driver extends Model
             'photo_uuid',
             'avatar_url',
             'public_id',
+            'name',
+            'internal_id',
             'location',
             'online',
             'updated_at',
@@ -288,6 +290,10 @@ class Driver extends Model
             'year',
             'make',
             'model',
+            'class',
+            'color',
+            'call_sign',
+            'status',
             'specs',
             'vin_data',
             'telematics',

package/server/src/Models/Order.php

@@ -849,7 +849,7 @@ class Order extends Model
             $attributes['type'] = $this->type;
         }
 
-        if (isset($attributes['pickup']) && is_array($attributes['pickup'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'pickup')) {
             $pickup = Place::createFromMixed($attributes['pickup']);
 
             if ($pickup instanceof Place) {
@@ -857,7 +857,7 @@ class Order extends Model
             }
         }
 
-        if (isset($attributes['dropoff']) && is_array($attributes['dropoff'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'dropoff')) {
             $dropoff = Place::createFromMixed($attributes['dropoff']);
 
             if ($dropoff instanceof Place) {
@@ -865,7 +865,7 @@ class Order extends Model
             }
         }
 
-        if (isset($attributes['return']) && is_array($attributes['return'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'return')) {
             $return = Place::createFromMixed($attributes['return']);
 
             if ($return instanceof Place) {
@@ -897,19 +897,19 @@ class Order extends Model
             $attributes['type'] = $this->type;
         }
 
-        if (isset($attributes['pickup']) && is_array($attributes['pickup'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'pickup')) {
             $pickupId = Place::insertFromMixed($attributes['pickup']);
 
             $attributes['pickup_uuid'] = $pickupId;
         }
 
-        if (isset($attributes['dropoff']) && is_array($attributes['dropoff'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'dropoff')) {
             $dropoffId = Place::insertFromMixed($attributes['dropoff']);
 
             $attributes['dropoff_uuid'] = $dropoffId;
         }
 
-        if (isset($attributes['return']) && is_array($attributes['return'])) {
+        if ($this->shouldResolvePayloadPlace($attributes, 'return')) {
             $returnId = Place::insertFromMixed($attributes['return']);
 
             $attributes['return_uuid'] = $returnId;
@@ -947,6 +947,18 @@ class Order extends Model
         return $payload;
     }
 
+    protected function shouldResolvePayloadPlace(?array $attributes, string $role): bool
+    {
+        return !$this->hasExistingPayloadPlaceUuid($attributes, $role) && isset($attributes[$role]) && is_array($attributes[$role]);
+    }
+
+    protected function hasExistingPayloadPlaceUuid(?array $attributes, string $role): bool
+    {
+        $uuid = data_get($attributes, "{$role}_uuid");
+
+        return is_string($uuid) && Str::isUuid($uuid) && Place::where('uuid', $uuid)->exists();
+    }
+
     /**
      * Retrieves the payload associated with the order.
      * If the payload is not already loaded, it loads the payload relationship.

package/server/src/Models/Place.php

@@ -471,9 +471,17 @@ class Place extends Model
             return null;
         }
 
-        $postalCode = static::normalizePlaceValue(data_get($place, 'postal_code'));
-        $street2    = static::normalizePlaceValue(data_get($place, 'street2'));
-        $location   = Utils::getPointFromMixed(data_get($place, 'location'));
+        $postalCode    = static::normalizePlaceValue(data_get($place, 'postal_code'));
+        $street2       = static::normalizePlaceValue(data_get($place, 'street2'));
+        $locationValue = data_get($place, 'location');
+        $location      = new SpatialPoint(0, 0);
+        if (!empty($locationValue)) {
+            try {
+                $location = Utils::getPointFromMixed($locationValue);
+            } catch (\Throwable $e) {
+                $location = new SpatialPoint(0, 0);
+            }
+        }
 
         $existingPlace = static::query()
             ->where('company_uuid', $companyUuid)

package/server/src/Providers/FleetOpsServiceProvider.php

@@ -145,6 +145,7 @@ class FleetOpsServiceProvider extends CoreServiceProvider
             $schedule->command('fleetops:sync-telematics')->everyMinute()->withoutOverlapping()->storeOutputInDb();
         });
         $this->registerNotifications();
+        $this->registerAiCapabilities();
         $this->registerExpansionsFrom(__DIR__ . '/../Expansions');
 
         // Register built-in orchestration engines.
@@ -234,4 +235,29 @@ class FleetOpsServiceProvider extends CoreServiceProvider
             'dynamic:facilitator',
         ]);
     }
+
+    protected function registerAiCapabilities(): void
+    {
+        if (!Utils::classExists(\Fleetbase\Ai\Support\AiCapabilityRegistry::class)) {
+            return;
+        }
+
+        if (Utils::classExists(\Fleetbase\Ai\Support\AiQueryRegistry::class)) {
+            $this->callAfterResolving(\Fleetbase\Ai\Support\AiQueryRegistry::class, function (\Fleetbase\Ai\Support\AiQueryRegistry $registry) {
+                \Fleetbase\FleetOps\Support\Ai\FleetOpsAiQueryResources::register($registry);
+            });
+        }
+
+        $this->callAfterResolving(\Fleetbase\Ai\Support\AiCapabilityRegistry::class, function (\Fleetbase\Ai\Support\AiCapabilityRegistry $registry) {
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\SearchResourcesCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\OperationalQueryCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\OrderInsightsCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\AssetStatusCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\DocsHelpCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\ConsoleNavigationCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\CreateOrderPreviewCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\OptimizeOrderRouteCapability());
+            $registry->register(new \Fleetbase\FleetOps\Support\Ai\Capabilities\ImportOrdersPreviewCapability());
+        });
+    }
 }

package/server/src/Support/Ai/Capabilities/AbstractFleetOpsAICapability.php

@@ -0,0 +1,88 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Ai\Capabilities;
+
+use Fleetbase\Ai\Contracts\AIContextCapabilityInterface;
+use Fleetbase\Ai\Models\AiTask;
+use Fleetbase\Ai\Support\Capabilities\AbstractAICapability;
+use Fleetbase\Support\Auth;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Support\Str;
+
+abstract class AbstractFleetOpsAICapability extends AbstractAICapability implements AIContextCapabilityInterface
+{
+    public function module(): string
+    {
+        return 'fleet-ops';
+    }
+
+    public function shouldResolve(AiTask $task): bool
+    {
+        return $this->matchesPrompt($this->prompt($task));
+    }
+
+    abstract protected function matchesPrompt(string $prompt): bool;
+
+    protected function prompt(AiTask $task): string
+    {
+        return Str::lower(trim((string) $task->prompt));
+    }
+
+    protected function containsAny(string $prompt, array $terms): bool
+    {
+        foreach ($terms as $term) {
+            if (str_contains($prompt, Str::lower($term))) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    protected function can(string $permission): bool
+    {
+        $user = Auth::getUserFromSession();
+
+        if ($user?->isAdmin()) {
+            return true;
+        }
+
+        return Auth::can($permission);
+    }
+
+    protected function canAll(array $permissions): bool
+    {
+        foreach ($permissions as $permission) {
+            if (!$this->can($permission)) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+
+    protected function searchTerms(string $prompt): array
+    {
+        preg_match_all('/[A-Z]{2,}[-_][A-Z0-9-_]+|[A-Za-z0-9][A-Za-z0-9-_]{2,}/', (string) $prompt, $matches);
+
+        $terms = collect($matches[0] ?? [])
+            ->reject(fn ($term) => in_array(Str::lower($term), ['find', 'show', 'open', 'order', 'orders', 'vehicle', 'vehicles', 'driver', 'drivers', 'work', 'status', 'about', 'fleet', 'ops'], true))
+            ->unique()
+            ->take(6)
+            ->values()
+            ->all();
+
+        return empty($terms) ? [trim((string) $prompt)] : $terms;
+    }
+
+    protected function whereLikeAny(Builder $builder, array $columns, array $terms): void
+    {
+        $builder->where(function (Builder $query) use ($columns, $terms) {
+            foreach ($columns as $column) {
+                foreach ($terms as $term) {
+                    $query->orWhere($column, 'like', '%' . $term . '%');
+                }
+            }
+        });
+    }
+}

package/server/src/Support/Ai/Capabilities/AssetStatusCapability.php

@@ -0,0 +1,108 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Ai\Capabilities;
+
+use Fleetbase\Ai\Models\AiTask;
+use Fleetbase\FleetOps\Models\Device;
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Sensor;
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Models\Vehicle;
+
+class AssetStatusCapability extends AbstractFleetOpsAICapability
+{
+    public function key(): string
+    {
+        return 'fleet-ops.asset_status';
+    }
+
+    public function label(): string
+    {
+        return 'Fleet-Ops asset status';
+    }
+
+    public function description(): string
+    {
+        return 'Summarizes Fleet-Ops vehicle, device, sensor, and telematic status counts.';
+    }
+
+    public function permissions(): array
+    {
+        return ['fleet-ops see vehicle', 'fleet-ops see device', 'fleet-ops see sensor', 'fleet-ops see telematic'];
+    }
+
+    public function resolve(AiTask $task): array
+    {
+        return [
+            'drivers'    => $this->driverStatus(),
+            'vehicles'   => $this->statusCounts(Vehicle::class, 'fleet-ops see vehicle'),
+            'devices'    => $this->deviceStatus(),
+            'sensors'    => $this->statusCounts(Sensor::class, 'fleet-ops see sensor'),
+            'telematics' => $this->statusCounts(Telematic::class, 'fleet-ops see telematic'),
+        ];
+    }
+
+    protected function matchesPrompt(string $prompt): bool
+    {
+        return $this->containsAny($prompt, ['offline', 'online', 'asset status', 'driver status', 'vehicle status', 'device status', 'sensor status', 'telematic status', 'drivers down', 'devices down', 'vehicles down']);
+    }
+
+    protected function statusCounts(string $modelClass, string $permission): array
+    {
+        if (!$this->can($permission)) {
+            return ['authorized' => false];
+        }
+
+        return [
+            'authorized'       => true,
+            'total'            => $modelClass::where('company_uuid', session('company'))->count(),
+            'counts_by_status' => $modelClass::where('company_uuid', session('company'))
+                ->selectRaw('status, count(*) as aggregate')
+                ->groupBy('status')
+                ->pluck('aggregate', 'status')
+                ->all(),
+        ];
+    }
+
+    protected function deviceStatus(): array
+    {
+        if (!$this->can('fleet-ops see device')) {
+            return ['authorized' => false];
+        }
+
+        return [
+            'authorized'       => true,
+            'total'            => Device::where('company_uuid', session('company'))->count(),
+            'online'           => Device::where('company_uuid', session('company'))->where('online', true)->count(),
+            'offline'          => Device::where('company_uuid', session('company'))->where(function ($query) {
+                $query->where('online', false)->orWhereNull('online');
+            })->count(),
+            'counts_by_status' => Device::where('company_uuid', session('company'))
+                ->selectRaw('status, count(*) as aggregate')
+                ->groupBy('status')
+                ->pluck('aggregate', 'status')
+                ->all(),
+        ];
+    }
+
+    protected function driverStatus(): array
+    {
+        if (!$this->can('fleet-ops see driver')) {
+            return ['authorized' => false];
+        }
+
+        return [
+            'authorized'       => true,
+            'total'            => Driver::where('company_uuid', session('company'))->count(),
+            'online'           => Driver::where('company_uuid', session('company'))->where('online', true)->count(),
+            'offline'          => Driver::where('company_uuid', session('company'))->where(function ($query) {
+                $query->where('online', false)->orWhereNull('online');
+            })->count(),
+            'counts_by_status' => Driver::where('company_uuid', session('company'))
+                ->selectRaw('status, count(*) as aggregate')
+                ->groupBy('status')
+                ->pluck('aggregate', 'status')
+                ->all(),
+        ];
+    }
+}

package/server/src/Support/Ai/Capabilities/ConsoleNavigationCapability.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Ai\Capabilities;
+
+use Fleetbase\Ai\Models\AiTask;
+
+class ConsoleNavigationCapability extends SearchResourcesCapability
+{
+    public function key(): string
+    {
+        return 'fleet-ops.console_navigation';
+    }
+
+    public function label(): string
+    {
+        return 'Fleet-Ops console navigation preview';
+    }
+
+    public function description(): string
+    {
+        return 'Returns preview-only console route suggestions for Fleet-Ops resources.';
+    }
+
+    public function type(): string
+    {
+        return 'ui';
+    }
+
+    public function mode(): string
+    {
+        return 'navigation_preview';
+    }
+
+    public function resolve(AiTask $task): array
+    {
+        $search = parent::resolve($task);
+        $items  = collect(data_get($search, 'results', []))
+            ->flatten(1)
+            ->filter(fn ($result) => is_array($result) && isset($result['route']))
+            ->take(5)
+            ->values()
+            ->all();
+
+        return [
+            'preview_only' => true,
+            'message'      => 'Fleetbase AI can suggest where to navigate, but this pilot does not directly open panels yet.',
+            'suggestions'  => $items,
+        ];
+    }
+
+    protected function matchesPrompt(string $prompt): bool
+    {
+        return $this->containsAny($prompt, ['open', 'show me', 'go to', 'navigate', 'take me to']) && parent::matchesPrompt($prompt);
+    }
+}