@fleetbase/fleetops-engine 0.6.17 → 0.6.19

package/server/src/Models/Telematic.php

@@ -0,0 +1,336 @@
+<?php
+
+namespace Fleetbase\FleetOps\Models;
+
+use Fleetbase\Casts\Json;
+use Fleetbase\Models\Model;
+use Fleetbase\Models\User;
+use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasCustomFields;
+use Fleetbase\Traits\HasMetaAttributes;
+use Fleetbase\Traits\HasPublicId;
+use Fleetbase\Traits\HasUuid;
+use Fleetbase\Traits\Searchable;
+use Fleetbase\Traits\TracksApiCredential;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\HasOne;
+use Spatie\Activitylog\LogOptions;
+use Spatie\Activitylog\Traits\LogsActivity;
+
+/**
+ * Class Telematic.
+ *
+ * Represents a telematics device/modem that provides connectivity and data transmission
+ * capabilities for fleet assets. This is the "brain" that enables communication between
+ * physical devices and the fleet management system.
+ */
+class Telematic extends Model
+{
+    use HasUuid;
+    use HasPublicId;
+    use TracksApiCredential;
+    use HasApiModelBehavior;
+    use LogsActivity;
+    use HasMetaAttributes;
+    use Searchable;
+    use HasCustomFields;
+
+    /**
+     * The database table used by the model.
+     *
+     * @var string
+     */
+    protected $table = 'telematics';
+
+    /**
+     * The type of public Id to generate.
+     *
+     * @var string
+     */
+    protected $publicIdType = 'telematic';
+
+    /**
+     * The attributes that can be queried.
+     *
+     * @var array
+     */
+    protected $searchableColumns = ['name', 'provider', 'model', 'serial_number', 'imei', 'public_id'];
+
+    /**
+     * The attributes that can be used for filtering.
+     *
+     * @var array
+     */
+    protected $filterParams = ['provider', 'status', 'warranty_uuid'];
+
+    /**
+     * The attributes that are mass assignable.
+     *
+     * @var array
+     */
+    protected $fillable = [
+        'company_uuid',
+        'warranty_uuid',
+        'name',
+        'provider',
+        'model',
+        'serial_number',
+        'firmware_version',
+        'status',
+        'imei',
+        'iccid',
+        'imsi',
+        'msisdn',
+        'last_seen_at',
+        'last_metrics',
+        'config',
+        'meta',
+        'slug',
+    ];
+
+    /**
+     * Dynamic attributes that are appended to object.
+     *
+     * @var array
+     */
+    protected $appends = ['warranty_name', 'is_online', 'signal_strength', 'last_location'];
+
+    /**
+     * The attributes excluded from the model's JSON form.
+     *
+     * @var array
+     */
+    protected $hidden = ['warranty'];
+
+    /**
+     * The attributes that should be cast to native types.
+     *
+     * @var array
+     */
+    protected $casts = [
+        'last_seen_at' => 'datetime',
+        'last_metrics' => Json::class,
+        'config'       => Json::class,
+        'meta'         => Json::class,
+    ];
+
+    /**
+     * Properties which activity needs to be logged.
+     *
+     * @var array
+     */
+    protected static $logAttributes = '*';
+
+    /**
+     * Do not log empty changed.
+     *
+     * @var bool
+     */
+    protected static $submitEmptyLogs = false;
+
+    /**
+     * The name of the subject to log.
+     *
+     * @var string
+     */
+    protected static $logName = 'telematic';
+
+    /**
+     * Get the activity log options for the model.
+     */
+    public function getActivitylogOptions(): LogOptions
+    {
+        return LogOptions::defaults()->logAll();
+    }
+
+    public function warranty(): BelongsTo
+    {
+        return $this->belongsTo(Warranty::class, 'warranty_uuid', 'uuid');
+    }
+
+    public function createdBy(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'created_by_uuid', 'uuid');
+    }
+
+    public function updatedBy(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'updated_by_uuid', 'uuid');
+    }
+
+    public function device(): HasOne
+    {
+        return $this->hasOne(Device::class, 'telematic_uuid', 'uuid');
+    }
+
+    public function assets(): HasMany
+    {
+        return $this->hasMany(Asset::class, 'telematic_uuid', 'uuid');
+    }
+
+    /**
+     * Get the warranty name.
+     */
+    public function getWarrantyNameAttribute(): ?string
+    {
+        return $this->warranty?->name;
+    }
+
+    /**
+     * Check if the telematic device is currently online.
+     */
+    public function getIsOnlineAttribute(): bool
+    {
+        if (!$this->last_seen_at) {
+            return false;
+        }
+
+        // Consider online if last seen within 5 minutes
+        return $this->last_seen_at->gt(now()->subMinutes(5));
+    }
+
+    /**
+     * Get the signal strength from last metrics.
+     */
+    public function getSignalStrengthAttribute(): ?int
+    {
+        return $this->last_metrics['signal_strength'] ?? null;
+    }
+
+    /**
+     * Get the last known location from metrics.
+     */
+    public function getLastLocationAttribute(): ?array
+    {
+        $metrics = $this->last_metrics;
+
+        if (isset($metrics['lat']) && isset($metrics['lng'])) {
+            return [
+                'latitude'  => $metrics['lat'],
+                'longitude' => $metrics['lng'],
+                'timestamp' => $this->last_seen_at?->toISOString(),
+            ];
+        }
+
+        return null;
+    }
+
+    /**
+     * Scope to get online telematics.
+     *
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     *
+     * @return \Illuminate\Database\Eloquent\Builder
+     */
+    public function scopeOnline($query)
+    {
+        return $query->where('last_seen_at', '>=', now()->subMinutes(5));
+    }
+
+    /**
+     * Scope to get offline telematics.
+     *
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     *
+     * @return \Illuminate\Database\Eloquent\Builder
+     */
+    public function scopeOffline($query)
+    {
+        return $query->where(function ($q) {
+            $q->whereNull('last_seen_at')
+              ->orWhere('last_seen_at', '<', now()->subMinutes(5));
+        });
+    }
+
+    /**
+     * Scope to get telematics by provider.
+     *
+     * @param \Illuminate\Database\Eloquent\Builder $query
+     *
+     * @return \Illuminate\Database\Eloquent\Builder
+     */
+    public function scopeByProvider($query, string $provider)
+    {
+        return $query->where('provider', $provider);
+    }
+
+    /**
+     * Update the last seen timestamp and metrics.
+     */
+    public function updateHeartbeat(array $metrics = []): bool
+    {
+        return $this->update([
+            'last_seen_at' => now(),
+            'last_metrics' => array_merge($this->last_metrics ?? [], $metrics),
+        ]);
+    }
+
+    /**
+     * Get the connection status based on last seen time.
+     */
+    public function getConnectionStatus(): string
+    {
+        if (!$this->last_seen_at) {
+            return 'never_connected';
+        }
+
+        $minutesOffline = $this->last_seen_at->diffInMinutes(now());
+
+        if ($minutesOffline <= 5) {
+            return 'online';
+        } elseif ($minutesOffline <= 60) {
+            return 'recently_offline';
+        } elseif ($minutesOffline <= 1440) { // 24 hours
+            return 'offline';
+        } else {
+            return 'long_offline';
+        }
+    }
+
+    /**
+     * Check if the telematic supports a specific feature.
+     */
+    public function supportsFeature(string $feature): bool
+    {
+        $config   = $this->config ?? [];
+        $features = $config['supported_features'] ?? [];
+
+        return in_array($feature, $features);
+    }
+
+    /**
+     * Get the firmware update status.
+     */
+    public function getFirmwareStatus(): array
+    {
+        $config = $this->config ?? [];
+
+        return [
+            'current_version'  => $this->firmware_version,
+            'latest_version'   => $config['latest_firmware'] ?? null,
+            'update_available' => isset($config['latest_firmware'])
+                                && version_compare($this->firmware_version, $config['latest_firmware'], '<'),
+        ];
+    }
+
+    /**
+     * Send a command to the telematic device.
+     */
+    public function sendCommand(string $command, array $parameters = []): bool
+    {
+        // This would integrate with the actual telematic provider's API
+        // For now, we'll just log the command attempt
+
+        activity('telematic_command')
+            ->performedOn($this)
+            ->withProperties([
+                'command'    => $command,
+                'parameters' => $parameters,
+                'timestamp'  => now(),
+            ])
+            ->log("Command '{$command}' sent to telematic device");
+
+        return true;
+    }
+}

package/server/src/Models/Vehicle.php

@@ -3,13 +3,16 @@
 namespace Fleetbase\FleetOps\Models;
 
 use Fleetbase\Casts\Json;
+use Fleetbase\Casts\Money;
 use Fleetbase\FleetOps\Casts\Point;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\FleetOps\Support\VehicleData;
 use Fleetbase\LaravelMysqlSpatial\Eloquent\SpatialTrait;
+use Fleetbase\Models\Category;
 use Fleetbase\Models\File;
 use Fleetbase\Models\Model;
 use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasCustomFields;
 use Fleetbase\Traits\HasMetaAttributes;
 use Fleetbase\Traits\HasPublicId;
 use Fleetbase\Traits\HasUuid;
@@ -19,6 +22,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasManyThrough;
 use Illuminate\Database\Eloquent\Relations\HasOne;
+use Illuminate\Database\Eloquent\Relations\MorphMany;
 use Illuminate\Support\Str;
 use Spatie\Activitylog\LogOptions;
 use Spatie\Activitylog\Traits\LogsActivity;
@@ -36,6 +40,7 @@ class Vehicle extends Model
     use HasSlug;
     use LogsActivity;
     use HasMetaAttributes;
+    use HasCustomFields;
 
     /**
      * The database table used by the model.
@@ -98,25 +103,55 @@ class Vehicle extends Model
     protected $fillable = [
         'company_uuid',
         'vendor_uuid',
+        'category_uuid',
+        'warranty_uuid',
         'photo_uuid',
         'avatar_url',
+        'name',
+        'description',
         'make',
+        'model',
+        'model_type',
+        'year',
+        'color',
         'location',
         'speed',
         'heading',
         'altitude',
-        'model',
-        'year',
+        'odometer',
+        'odometer_unit',
+        'fuel_type',
+        'fuel_volume_unit',
         'trim',
+        'transmission',
+        'measurement_system',
+        'body_type',
+        'body_sub_type',
+        'usage_type',
+        'ownership_type',
         'type',
+        'class',
         'plate_number',
+        'call_sign',
+        'serial_number',
+        'financing_status',
+        'currency',
+        'insurance_value',
+        'depreciation_rate',
+        'current_value',
+        'acquisition_cost',
         'vin',
         'vin_data',
+        'specs',
+        'details',
+        'notes',
         'meta',
         'telematics',
         'status',
         'online',
         'slug',
+        'purchased_at',
+        'lease_expires_at',
     ];
 
     /**
@@ -158,12 +193,18 @@ class Vehicle extends Model
      * @var array
      */
     protected $casts = [
-        'location'   => Point::class,
-        'meta'       => Json::class,
-        'telematics' => Json::class,
-        'model_data' => Json::class,
-        'vin_data'   => Json::class,
-        'online'     => 'boolean',
+        'current_value'          => Money::class,
+        'insurance_value'        => Money::class,
+        'acquisition_cost'       => Money::class,
+        'location'               => Point::class,
+        'meta'                   => Json::class,
+        'telematics'             => Json::class,
+        'specs'                  => Json::class,
+        'details'                => Json::class,
+        'vin_data'               => Json::class,
+        'online'                 => 'boolean',
+        'purchased_at'           => 'datetime',
+        'lease_expires_at'       => 'datetime',
     ];
 
     public function photo(): BelongsTo
@@ -173,7 +214,22 @@ class Vehicle extends Model
 
     public function driver(): HasOne
     {
-        return $this->hasOne(Driver::class)->without(['vehicle']);
+        return $this->hasOne(Driver::class, 'vehicle_uuid', 'uuid')->without(['vehicle']);
+    }
+
+    public function category(): BelongsTo
+    {
+        return $this->belongsTo(Category::class, 'category_uuid', 'uuid');
+    }
+
+    public function telematic(): BelongsTo
+    {
+        return $this->belongsTo(Telematic::class, 'telematic_uuid', 'uuid');
+    }
+
+    public function warranty(): BelongsTo
+    {
+        return $this->belongsTo(Warranty::class, 'warranty_uuid', 'uuid');
     }
 
     public function vendor(): BelongsTo
@@ -188,7 +244,7 @@ class Vehicle extends Model
 
     public function devices(): HasMany
     {
-        return $this->hasMany(VehicleDevice::class);
+        return $this->hasMany(Device::class, 'attachable_uuid');
     }
 
     public function positions(): HasMany
@@ -196,6 +252,26 @@ class Vehicle extends Model
         return $this->hasMany(Position::class, 'subject_uuid');
     }
 
+    public function equipments(): HasMany
+    {
+        return $this->hasMany(Equipment::class, 'equipable_uuid', 'uuid')->where('equipable_type', static::class);
+    }
+
+    public function maintenances(): HasMany
+    {
+        return $this->hasMany(Maintenance::class, 'maintainable_uuid', 'uuid')->where('maintainable_type', static::class);
+    }
+
+    public function sensors(): HasMany
+    {
+        return $this->hasMany(Sensor::class, 'sensorable_uuid', 'uuid')->where('sensorable_type', static::class);
+    }
+
+    public function parts(): MorphMany
+    {
+        return $this->morphMany(Part::class, 'asset');
+    }
+
     /**
      * Get avatar URL attribute.
      *
@@ -217,7 +293,7 @@ class Vehicle extends Model
         $nameSegments = [];
 
         // Populate the nameSegments array with the values of the attributes
-        $keys = ['year', 'make', 'model', 'trim', 'plate_number'];
+        $keys = ['year', 'make', 'model', 'trim'];
         foreach ($keys as $key) {
             if (!empty($this->{$key})) {
                 $nameSegments[] = $this->{$key};
@@ -540,8 +616,48 @@ class Vehicle extends Model
             $query->where('public_id', $vehicleName)
                     ->orWhere('plate_number', $vehicleName)
                     ->orWhere('vin', $vehicleName)
+                    ->orWhere('serial_number', $vehicleName)
+                    ->orWhere('call_sign', $vehicleName)
                     ->orWhereRaw("CONCAT(make, ' ', model, ' ', year) LIKE ?", ["%{$vehicleName}%"])
                     ->orWhereRaw("CONCAT(year, ' ', make, ' ', model) LIKE ?", ["%{$vehicleName}%"]);
         })->first();
     }
+
+    /**
+     * Set or update a single key/value pair in the `details` JSON column.
+     *
+     * Uses Laravel's `data_set` helper to allow dot notation for nested keys.
+     *
+     * @param string|array $key   the key (or array path) to set within the details
+     * @param mixed        $value the value to assign to the given key
+     *
+     * @return array the updated details array
+     */
+    public function setDetail(string|array $key, mixed $value): array
+    {
+        $details = is_array($this->details) ? $this->details : (array) $this->details;
+        data_set($details, $key, $value);
+        $this->details = $details;
+
+        return $details;
+    }
+
+    /**
+     * Merge multiple values into the `details` JSON column.
+     *
+     * By default this performs a shallow merge (overwrites duplicate keys).
+     * Use `array_replace_recursive` if you need nested merges.
+     *
+     * @param array $newDetails key/value pairs to merge into details
+     *
+     * @return array the updated details array
+     */
+    public function setDetails(array $newDetails = []): array
+    {
+        $details       = is_array($this->details) ? $this->details : (array) $this->details;
+        $details       = array_merge($details, $newDetails);
+        $this->details = $details;
+
+        return $details;
+    }
 }

package/server/src/Models/VehicleDevice.php

@@ -19,7 +19,7 @@ class VehicleDevice extends Model
      *
      * @var string
      */
-    protected $table = 'vehicle_devices';
+    protected $table = 'devices';
 
     /**
      * Attributes that is filterable on this model.

package/server/src/Models/VehicleDeviceEvent.php

@@ -24,7 +24,7 @@ class VehicleDeviceEvent extends Model
      *
      * @var string
      */
-    protected $table = 'vehicle_device_events';
+    protected $table = 'device_events';
 
     /**
      * Attributes that is filterable on this model.

package/server/src/Models/Vendor.php

@@ -6,6 +6,7 @@ use Fleetbase\Casts\Json;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Models\Model;
 use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasCustomFields;
 use Fleetbase\Traits\HasInternalId;
 use Fleetbase\Traits\HasPublicId;
 use Fleetbase\Traits\HasUuid;
@@ -32,6 +33,7 @@ class Vendor extends Model
     use HasSlug;
     use LogsActivity;
     use Notifiable;
+    use HasCustomFields;
 
     /**
      * The database table used by the model.
@@ -57,6 +59,7 @@ class Vendor extends Model
         'public_id',
         'internal_id',
         'company_uuid',
+        'place_uuid',
         'logo_uuid',
         'type_uuid',
         'connect_company_uuid',
@@ -70,6 +73,7 @@ class Vendor extends Model
         'place_uuid',
         'country',
         'status',
+        'notes',
         'type',
         'slug',
     ];
@@ -184,6 +188,11 @@ class Vendor extends Model
         return $this->hasMany(Order::class, 'customer_uuid')->whereNull('deleted_at')->withoutGlobalScopes();
     }
 
+    public function files(): HasMany
+    {
+        return $this->hasMany(\Fleetbase\Models\File::class, 'subject_uuid')->latest();
+    }
+
     /**
      * Get the vendor logo url.
      *
@@ -231,6 +240,9 @@ class Vendor extends Model
      */
     public function setTypeAttribute(?string $type)
     {
+        if (!$type && isset($this->type)) {
+            return;
+        }
         $this->attributes['type'] = $type ?? 'vendor';
     }
 
@@ -241,6 +253,9 @@ class Vendor extends Model
      */
     public function setStatusAttribute(?string $status = 'active')
     {
+        if (!$status && isset($this->status)) {
+            return;
+        }
         $this->attributes['status'] = $status ?? 'active';
     }