@fleetbase/fleetops-engine 0.6.20 → 0.6.21

package/server/src/Http/Filter/PositionFilter.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Filter;
+
+use Fleetbase\FleetOps\Support\Utils;
+use Fleetbase\Http\Filter\Filter;
+
+class PositionFilter extends Filter
+{
+    public function queryForInternal()
+    {
+        $this->builder->where('company_uuid', $this->session->get('company'));
+    }
+
+    public function queryForPublic()
+    {
+        $this->builder->where('company_uuid', $this->session->get('company'));
+    }
+
+    public function query(?string $searchQuery)
+    {
+        $this->builder->search($searchQuery);
+    }
+
+    public function createdAt($createdAt)
+    {
+        $createdAt = Utils::dateRange($createdAt);
+
+        if (is_array($createdAt)) {
+            $this->builder->whereBetween('created_at', $createdAt);
+        } else {
+            $this->builder->whereDate('created_at', $createdAt);
+        }
+    }
+}

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

@@ -0,0 +1,44 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Resources\v1;
+
+use Fleetbase\Http\Resources\FleetbaseResource;
+use Fleetbase\LaravelMysqlSpatial\Types\Point;
+use Fleetbase\Support\Http;
+use Fleetbase\Support\Resolve;
+
+class Position extends FleetbaseResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return [
+            'id'                              => $this->when(Http::isInternalRequest(), $this->id, $this->public_id),
+            'uuid'                            => $this->when(Http::isInternalRequest(), $this->uuid),
+            'public_id'                       => $this->when(Http::isInternalRequest(), $this->public_id),
+            'order_uuid'                      => $this->when(Http::isInternalRequest(), $this->order_uuid),
+            'company_uuid'                    => $this->when(Http::isInternalRequest(), $this->company_uuid),
+            'destination_uuid'                => $this->when(Http::isInternalRequest(), $this->destination_uuid),
+            'subject_uuid'                    => $this->when(Http::isInternalRequest(), $this->subject_uuid),
+            'subject_type'                    => $this->subject_type,
+            'subject'                         => $this->whenLoaded('subject', fn () => Resolve::httpResourceForModel($this->subject)),
+            'order'                           => $this->whenLoaded('order', fn () => new Order($this->order)),
+            'destination'                     => $this->whenLoaded('destination', fn () => new Place($this->destination)),
+            'heading'                         => $this->heading ?? 0,
+            'bearing'                         => $this->bearing ?? 0,
+            'speed'                           => $this->speed ?? 0,
+            'altitude'                        => $this->altitude ?? 0,
+            'latitude'                        => $this->latitude ?? 0,
+            'longitude'                       => $this->longitude ?? 0,
+            'coordinates'                     => $this->location ?? new Point(0, 0),
+            'updated_at'                      => $this->updated_at,
+            'created_at'                      => $this->created_at,
+        ];
+    }
+}

package/server/src/Jobs/ReplayPositions.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace Fleetbase\FleetOps\Jobs;
+
+use Carbon\Carbon;
+use Fleetbase\FleetOps\Models\Position;
+use Fleetbase\Support\SocketCluster\SocketClusterService;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Log;
+
+class ReplayPositions implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+    use SerializesModels;
+
+    /** @var \Illuminate\Support\Collection<int, Position> */
+    protected $positions;
+    protected string $channelId;
+    protected float $speed;
+    protected ?string $subjectUuid;
+
+    /** Max runtime per worker (seconds) */
+    public $timeout = 3600;
+
+    /**
+     * @param \Illuminate\Support\Collection<int, Position> $positions
+     */
+    public function __construct($positions, string $channelId, float $speed = 1, ?string $subjectUuid = null)
+    {
+        $this->positions   = $positions;
+        $this->channelId   = $channelId;
+        $this->speed       = max($speed, 0.1);
+        $this->subjectUuid = $subjectUuid;
+    }
+
+    public function handle(): void
+    {
+        $socket = new SocketClusterService();
+
+        // Base timestamp to compute relative offsets
+        $baseTime = Carbon::parse($this->positions->first()->created_at);
+
+        foreach ($this->positions as $index => $position) {
+            $currentTime = Carbon::parse($position->created_at);
+            $offset      = $baseTime->diffInSeconds($currentTime, false) / $this->speed;
+
+            // Schedule a small job for each event with its own delay
+            SendPositionReplay::dispatch(
+                $this->channelId,
+                $position,
+                $index,
+                $this->subjectUuid
+            )->delay(now()->addSeconds(max(0, $offset)));
+        }
+
+        Log::info("Replay scheduled for {$this->positions->count()} positions on channel {$this->channelId}");
+    }
+}

package/server/src/Jobs/SendPositionReplay.php

@@ -0,0 +1,65 @@
+<?php
+
+namespace Fleetbase\FleetOps\Jobs;
+
+use Fleetbase\FleetOps\Models\Position;
+use Fleetbase\Support\SocketCluster\SocketClusterService;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Log;
+
+class SendPositionReplay implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+    use SerializesModels;
+
+    protected string $channelId;
+    protected Position $position;
+    protected int $index;
+    protected ?string $subjectUuid;
+
+    public $tries   = 3;
+    public $timeout = 60;
+
+    public function __construct(string $channelId, Position $position, int $index, ?string $subjectUuid = null)
+    {
+        $this->channelId   = $channelId;
+        $this->position    = $position;
+        $this->index       = $index;
+        $this->subjectUuid = $subjectUuid;
+    }
+
+    public function handle(): void
+    {
+        $socket = new SocketClusterService();
+
+        $eventData = [
+            'id'          => uniqid('event_'),
+            'api_version' => config('api.version'),
+            'event'       => 'position.simulated',
+            'created_at'  => $this->position->created_at->toDateTimeString(),
+            'data'        => [
+                'id'             => $this->subjectUuid ?? $this->position->subject_uuid,
+                'location'       => $this->position->coordinates,
+                'heading'        => $this->position->heading ?? 0,
+                'speed'          => $this->position->speed ?? 0,
+                'altitude'       => $this->position->altitude ?? 0,
+                'additionalData' => [
+                    'index'         => $this->index,
+                    'position_uuid' => $this->position->uuid,
+                ],
+            ],
+        ];
+
+        try {
+            $socket->send($this->channelId, $eventData);
+        } catch (\Throwable $e) {
+            Log::error("Failed to send replay event [{$this->position->uuid}]: {$e->getMessage()}");
+        }
+    }
+}

package/server/src/Jobs/SyncTelematicDevicesJob.php

@@ -0,0 +1,106 @@
+<?php
+
+namespace Fleetbase\FleetOps\Jobs;
+
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Support\Telematics\TelematicService;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Log;
+
+/**
+ * Class SyncTelematicDevicesJob.
+ *
+ * Job for discovering and syncing devices from a provider.
+ */
+class SyncTelematicDevicesJob implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+    use SerializesModels;
+
+    public Telematic $telematic;
+    public array $options;
+    public int $tries   = 3;
+    public int $timeout = 300;
+
+    /**
+     * Create a new job instance.
+     */
+    public function __construct(Telematic $telematic, array $options = [])
+    {
+        $this->telematic = $telematic;
+        $this->options   = $options;
+        $this->queue     = 'telematics-sync';
+    }
+
+    /**
+     * Execute the job.
+     */
+    public function handle(ProviderRegistry $registry, TelematicService $service): void
+    {
+        $correlationId = \Illuminate\Support\Str::uuid()->toString();
+
+        Log::info('Device discovery started', [
+            'correlation_id' => $correlationId,
+            'telematic_uuid' => $this->telematic->uuid,
+            'provider'       => $this->telematic->provider,
+        ]);
+
+        try {
+            $provider = $registry->resolve($this->telematic->provider);
+            $provider->connect($this->telematic);
+
+            $cursor      = null;
+            $totalSynced = 0;
+
+            do {
+                $response = $provider->fetchDevices([
+                    'limit'   => $this->options['limit'] ?? 100,
+                    'cursor'  => $cursor,
+                    'filters' => $this->options['filters'] ?? [],
+                ]);
+
+                foreach ($response['devices'] as $devicePayload) {
+                    $normalizedDevice = $provider->normalizeDevice($devicePayload);
+                    $service->linkDevice($this->telematic, $normalizedDevice);
+                    $totalSynced++;
+                }
+
+                $cursor = $response['next_cursor'];
+
+                Log::info('Device discovery progress', [
+                    'correlation_id' => $correlationId,
+                    'synced'         => $totalSynced,
+                    'has_more'       => $response['has_more'],
+                ]);
+
+                // Broadcast progress (TODO: implement WebSocket broadcasting)
+            } while ($response['has_more'] && $cursor);
+
+            Log::info('Device discovery completed', [
+                'correlation_id' => $correlationId,
+                'total_synced'   => $totalSynced,
+            ]);
+        } catch (\Exception $e) {
+            Log::error('Device discovery failed', [
+                'correlation_id' => $correlationId,
+                'error'          => $e->getMessage(),
+            ]);
+
+            throw $e;
+        }
+    }
+
+    /**
+     * Get the job ID.
+     */
+    public function getJobId(): string
+    {
+        return $this->job->getJobId() ?? \Illuminate\Support\Str::uuid()->toString();
+    }
+}

package/server/src/Jobs/TestTelematicConnectionJob.php

@@ -0,0 +1,102 @@
+<?php
+
+namespace Fleetbase\FleetOps\Jobs;
+
+use Fleetbase\FleetOps\Models\Telematic;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Crypt;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Str;
+
+/**
+ * Class TestTelematicConnectionJob.
+ *
+ * Job for testing connection to a provider asynchronously.
+ */
+class TestTelematicConnectionJob implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+    use SerializesModels;
+
+    public Telematic $telematic;
+    public int $tries   = 1;
+    public int $timeout = 30;
+
+    /**
+     * Create a new job instance.
+     */
+    public function __construct(Telematic $telematic)
+    {
+        $this->telematic = $telematic;
+        $this->queue     = 'telematics-priority';
+    }
+
+    /**
+     * Execute the job.
+     */
+    public function handle(ProviderRegistry $registry): void
+    {
+        $correlationId = Str::uuid()->toString();
+
+        Log::info('Connection test started', [
+            'correlation_id' => $correlationId,
+            'telematic_uuid' => $this->telematic->uuid,
+            'provider'       => $this->telematic->provider,
+        ]);
+
+        try {
+            $provider    = $registry->resolve($this->telematic->provider);
+            $credentials = json_decode(Crypt::decryptString($this->telematic->credentials), true);
+
+            $result = $provider->testConnection($credentials);
+
+            if ($result['success']) {
+                $this->telematic->status = 'active';
+                $this->telematic->meta   = array_merge($this->telematic->meta ?? [], [
+                    'last_connection_test' => now()->toDateTimeString(),
+                    'last_test_result'     => 'success',
+                ]);
+            } else {
+                $this->telematic->status = 'error';
+                $this->telematic->meta   = array_merge($this->telematic->meta ?? [], [
+                    'last_connection_test' => now()->toDateTimeString(),
+                    'last_test_result'     => 'failed',
+                    'last_error'           => $result['message'],
+                ]);
+            }
+
+            $this->telematic->save();
+
+            Log::info('Connection test completed', [
+                'correlation_id' => $correlationId,
+                'success'        => $result['success'],
+            ]);
+
+            // Broadcast result (TODO: implement WebSocket broadcasting)
+        } catch (\Exception $e) {
+            Log::error('Connection test failed', [
+                'correlation_id' => $correlationId,
+                'error'          => $e->getMessage(),
+            ]);
+
+            $this->telematic->status = 'error';
+            $this->telematic->save();
+
+            throw $e;
+        }
+    }
+
+    /**
+     * Get the job ID.
+     */
+    public function getJobId(): string
+    {
+        return $this->job->getJobId() ?? Str::uuid()->toString();
+    }
+}

package/server/src/Models/Device.php

@@ -3,6 +3,10 @@
 namespace Fleetbase\FleetOps\Models;
 
 use Fleetbase\Casts\Json;
+use Fleetbase\FleetOps\Casts\Point;
+use Fleetbase\LaravelMysqlSpatial\Eloquent\SpatialTrait;
+use Fleetbase\LaravelMysqlSpatial\Types\Point as SpatialPoint;
+use Fleetbase\Models\File;
 use Fleetbase\Models\Model;
 use Fleetbase\Models\User;
 use Fleetbase\Traits\HasApiModelBehavior;
@@ -15,6 +19,8 @@ use Fleetbase\Traits\TracksApiCredential;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\MorphTo;
+use Illuminate\Support\Arr;
+use Illuminate\Support\Str;
 use Spatie\Activitylog\LogOptions;
 use Spatie\Activitylog\Traits\LogsActivity;
 use Spatie\Sluggable\HasSlug;
@@ -37,6 +43,7 @@ class Device extends Model
     use HasMetaAttributes;
     use Searchable;
     use HasCustomFields;
+    use SpatialTrait;
 
     /**
      * The database table used by the model.
@@ -57,7 +64,7 @@ class Device extends Model
      *
      * @var array
      */
-    protected $searchableColumns = ['name', 'model', 'serial_number', 'public_id'];
+    protected $searchableColumns = ['name', 'model', 'serial_number', 'manufacturer', 'public_id'];
 
     /**
      * The attributes that can be used for filtering.
@@ -75,14 +82,20 @@ class Device extends Model
         'company_uuid',
         'telematic_uuid',
         'warranty_uuid',
-        'device_type',
+        'photo_uuid',
+        'type',
         'device_id',
-        'device_provider',
-        'device_name',
-        'device_model',
-        'device_location',
+        'internal_id',
+        'imei',
+        'imsi',
+        'firmware_version',
+        'provider',
+        'name',
+        'model',
+        'location',
         'manufacturer',
         'serial_number',
+        'last_position',
         'installation_date',
         'last_maintenance_date',
         'meta',
@@ -110,6 +123,7 @@ class Device extends Model
         'is_online',
         'attached_to_name',
         'connection_status',
+        'photo_url',
     ];
 
     /**
@@ -117,7 +131,14 @@ class Device extends Model
      *
      * @var array
      */
-    protected $hidden = ['warranty', 'telematic', 'attachable'];
+    protected $hidden = [];
+
+    /**
+     * The attributes that are spatial columns.
+     *
+     * @var array
+     */
+    protected $spatialFields = ['last_position'];
 
     /**
      * The attributes that should be cast to native types.
@@ -125,9 +146,10 @@ class Device extends Model
      * @var array
      */
     protected $casts = [
-        'last_online_at' => 'datetime',
-        'meta'           => Json::class,
-        'options'        => Json::class,
+        'last_online_at'              => 'datetime',
+        'last_position'               => Point::class,
+        'meta'                        => Json::class,
+        'options'                     => Json::class,
     ];
 
     /**
@@ -204,6 +226,21 @@ class Device extends Model
         return $this->hasMany(Sensor::class, 'device_uuid', 'uuid');
     }
 
+    public function photo(): BelongsTo
+    {
+        return $this->belongsTo(File::class);
+    }
+
+    /**
+     * Get photo URL attribute.
+     *
+     * @return string
+     */
+    public function getPhotoUrlAttribute()
+    {
+        return data_get($this, 'photo.url', 'https://flb-assets.s3.ap-southeast-1.amazonaws.com/static/image-file-icon.png');
+    }
+
     /**
      * Get the warranty name.
      */
@@ -432,4 +469,29 @@ class Device extends Model
             ->limit($limit)
             ->get();
     }
+
+    /**
+     * Creates a new position for the vehicle.
+     */
+    public function createPosition(array $attributes = [], Model|string|null $destination = null): ?Position
+    {
+        if (!isset($attributes['coordinates']) && isset($attributes['location'])) {
+            $attributes['coordinates'] = $attributes['location'];
+        }
+
+        if (!isset($attributes['coordinates']) && isset($attributes['latitude']) && isset($attributes['longitude'])) {
+            $attributes['coordinates'] = new SpatialPoint($attributes['latitude'], $attributes['longitude']);
+        }
+
+        // handle destination if set
+        $destinationUuid = Str::isUuid($destination) ? $destination : data_get($destination, 'uuid');
+
+        return Position::create([
+            ...Arr::only($attributes, ['coordinates', 'heading', 'bearing', 'speed', 'altitude', 'order_uuid']),
+            'subject_uuid'     => $this->uuid,
+            'subject_type'     => $this->getMorphClass(),
+            'company_uuid'     => $this->company_uuid,
+            'destination_uuid' => $destinationUuid,
+        ]);
+    }
 }

package/server/src/Models/DeviceEvent.php

@@ -4,6 +4,7 @@ namespace Fleetbase\FleetOps\Models;
 
 use Fleetbase\Casts\Json;
 use Fleetbase\Models\Alert;
+use Fleetbase\Models\Company;
 use Fleetbase\Models\Model;
 use Fleetbase\Models\User;
 use Fleetbase\Traits\HasApiModelBehavior;
@@ -67,6 +68,7 @@ class DeviceEvent extends Model
      * @var array
      */
     protected $fillable = [
+        'company_uuid',
         'device_uuid',
         'payload',
         'meta',
@@ -143,6 +145,11 @@ class DeviceEvent extends Model
         return LogOptions::defaults()->logAll();
     }
 
+    public function company(): BelongsTo
+    {
+        return $this->belongsTo(Company::class, 'company_uuid', 'uuid');
+    }
+
     public function device(): BelongsTo
     {
         return $this->belongsTo(Device::class, 'device_uuid', 'uuid');

package/server/src/Models/Driver.php

@@ -8,6 +8,7 @@ use Fleetbase\FleetOps\Scopes\DriverScope;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\FleetOps\Support\Utils as FleetOpsUtils;
 use Fleetbase\LaravelMysqlSpatial\Eloquent\SpatialTrait;
+use Fleetbase\LaravelMysqlSpatial\Types\Point as SpatialPoint;
 use Fleetbase\Models\File;
 use Fleetbase\Models\Model;
 use Fleetbase\Models\User;
@@ -24,6 +25,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasManyThrough;
 use Illuminate\Notifications\Notifiable;
+use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
@@ -645,7 +647,7 @@ class Driver extends Model
         $positionData = [
             'company_uuid'     => session('company', $this->company_uuid),
             'subject_uuid'     => $this->uuid,
-            'subject_type'     => get_class($this),
+            'subject_type'     => $this->getMorphClass(),
             'coordinates'      => $this->location,
             'altitude'         => $this->altitude,
             'heading'          => $this->heading,
@@ -661,6 +663,31 @@ class Driver extends Model
         return ($isFirstPosition || $isPast50Meters) ? Position::create($positionData) : null;
     }
 
+    /**
+     * Creates a new position for the vehicle.
+     */
+    public function createPosition(array $attributes = [], Model|string|null $destination = null): ?Position
+    {
+        if (!isset($attributes['coordinates']) && isset($attributes['location'])) {
+            $attributes['coordinates'] = $attributes['location'];
+        }
+
+        if (!isset($attributes['coordinates']) && isset($attributes['latitude']) && isset($attributes['longitude'])) {
+            $attributes['coordinates'] = new SpatialPoint($attributes['latitude'], $attributes['longitude']);
+        }
+
+        // handle destination if set
+        $destinationUuid = Str::isUuid($destination) ? $destination : data_get($destination, 'uuid');
+
+        return Position::create([
+            ...Arr::only($attributes, ['coordinates', 'heading', 'bearing', 'speed', 'altitude', 'order_uuid']),
+            'subject_uuid'     => $this->uuid,
+            'subject_type'     => $this->getMorphClass(),
+            'company_uuid'     => $this->company_uuid,
+            'destination_uuid' => $destinationUuid,
+        ]);
+    }
+
     /**
      * Get the user relationship from the driver.
      */

package/server/src/Models/Payload.php

@@ -388,7 +388,6 @@ class Payload extends Model
             } else {
                 $place = Place::createFromMixed($attributes);
 
-
                 // Store temp search UUID for traceability if present and different
                 if ($place instanceof Place && isset($attributes['uuid']) && $place->uuid !== $attributes['uuid']) {
                     $place->updateMeta('search_uuid', $attributes['uuid']);

package/server/src/Models/Place.php

@@ -366,6 +366,7 @@ class Place extends Model
             if ($saveInstance) {
                 $place->save();
             }
+
             return $place;
         }
 
@@ -554,8 +555,10 @@ class Place extends Model
             }
 
             // If has $attributes['address']
+            $address = $place['address'];
             if (!empty($place['address'])) {
-                return static::createFromGeocodingLookup($place['address'], $saveInstance);
+                // return static::createFromGeocodingLookup($place['address'], $saveInstance);
+                return static::create(array_merge($place, static::getValuesFromGeocodingLookup($address)));
             }
 
             // Perform google lookup to fill address