@fleetbase/fleetops-engine 0.6.38 → 0.6.40

package/server/src/Models/Manifest.php

@@ -0,0 +1,214 @@
+<?php
+
+namespace Fleetbase\FleetOps\Models;
+
+use Fleetbase\Casts\Json;
+use Fleetbase\Models\Model;
+use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasInternalId;
+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\SoftDeletes;
+
+/**
+ * Manifest.
+ *
+ * Represents a committed delivery plan for a specific vehicle and (optionally)
+ * driver. Generated by the Orchestrator commit step. Each Manifest contains an
+ * ordered list of ManifestStops representing the physical locations to visit.
+ *
+ * Status lifecycle:
+ *   draft → active → in_progress → completed
+ *                               ↘ cancelled
+ */
+class Manifest extends Model
+{
+    use HasUuid;
+    use HasPublicId;
+    use HasInternalId;
+    use HasMetaAttributes;
+    use HasApiModelBehavior;
+    use TracksApiCredential;
+    use Searchable;
+    use SoftDeletes;
+
+    /**
+     * The database table used by the model.
+     */
+    protected $table = 'manifests';
+
+    /**
+     * The type of public ID to generate.
+     */
+    protected $publicIdType = 'manifest';
+
+    /**
+     * Columns that can be searched.
+     */
+    protected $searchableColumns = ['public_id', 'internal_id'];
+
+    /**
+     * Mass-assignable attributes.
+     */
+    protected $fillable = [
+        'company_uuid',
+        'driver_uuid',
+        'vehicle_uuid',
+        'status',
+        'scheduled_date',
+        'started_at',
+        'completed_at',
+        'total_distance_m',
+        'total_duration_s',
+        'stop_count',
+        'notes',
+        'meta',
+    ];
+
+    /**
+     * Attribute casts.
+     */
+    protected $casts = [
+        'meta'           => Json::class,
+        'scheduled_date' => 'date',
+        'started_at'     => 'datetime',
+        'completed_at'   => 'datetime',
+    ];
+
+    /**
+     * Attributes appended to the model's JSON representation.
+     */
+    protected $appends = [
+        'driver_name',
+        'vehicle_name',
+        'completed_stops',
+        'pending_stops',
+    ];
+
+    // ── Relationships ─────────────────────────────────────────────────────────
+
+    /**
+     * The driver assigned to this manifest.
+     */
+    public function driver(): BelongsTo
+    {
+        return $this->belongsTo(Driver::class, 'driver_uuid', 'uuid');
+    }
+
+    /**
+     * The vehicle assigned to this manifest.
+     */
+    public function vehicle(): BelongsTo
+    {
+        return $this->belongsTo(Vehicle::class, 'vehicle_uuid', 'uuid');
+    }
+
+    /**
+     * The ordered list of stops in this manifest.
+     */
+    public function stops(): HasMany
+    {
+        return $this->hasMany(ManifestStop::class, 'manifest_uuid', 'uuid')
+            ->orderBy('sequence');
+    }
+
+    /**
+     * The orders associated with this manifest (through stops).
+     */
+    public function orders(): HasMany
+    {
+        return $this->hasMany(Order::class, 'manifest_uuid', 'uuid');
+    }
+
+    // ── Computed Attributes ───────────────────────────────────────────────────
+
+    public function getDriverNameAttribute(): ?string
+    {
+        return $this->driver?->name;
+    }
+
+    public function getVehicleNameAttribute(): ?string
+    {
+        return $this->vehicle?->display_name;
+    }
+
+    public function getCompletedStopsAttribute(): int
+    {
+        return $this->stops()->where('status', 'completed')->count();
+    }
+
+    public function getPendingStopsAttribute(): int
+    {
+        return $this->stops()->whereIn('status', ['pending', 'arrived'])->count();
+    }
+
+    // ── Scopes ────────────────────────────────────────────────────────────────
+
+    public function scopeForCompany($query, string $companyUuid)
+    {
+        return $query->where('company_uuid', $companyUuid);
+    }
+
+    public function scopeActive($query)
+    {
+        return $query->whereIn('status', ['active', 'in_progress']);
+    }
+
+    public function scopeForDriver($query, string $driverUuid)
+    {
+        return $query->where('driver_uuid', $driverUuid);
+    }
+
+    public function scopeForVehicle($query, string $vehicleUuid)
+    {
+        return $query->where('vehicle_uuid', $vehicleUuid);
+    }
+
+    // ── Business Logic ────────────────────────────────────────────────────────
+
+    /**
+     * Mark the manifest as in_progress and record the start time.
+     */
+    public function start(): self
+    {
+        $this->update(['status' => 'in_progress', 'started_at' => now()]);
+
+        return $this;
+    }
+
+    /**
+     * Mark the manifest as completed and record the completion time.
+     */
+    public function complete(): self
+    {
+        $this->update(['status' => 'completed', 'completed_at' => now()]);
+
+        return $this;
+    }
+
+    /**
+     * Cancel the manifest.
+     */
+    public function cancel(): self
+    {
+        $this->update(['status' => 'cancelled']);
+
+        return $this;
+    }
+
+    /**
+     * Check whether all stops are completed and auto-complete the manifest.
+     */
+    public function checkAndAutoComplete(): void
+    {
+        $pendingCount = $this->stops()->whereIn('status', ['pending', 'arrived'])->count();
+        if ($pendingCount === 0 && $this->status === 'in_progress') {
+            $this->complete();
+        }
+    }
+}

package/server/src/Models/ManifestStop.php

@@ -0,0 +1,162 @@
+<?php
+
+namespace Fleetbase\FleetOps\Models;
+
+use Fleetbase\Casts\Json;
+use Fleetbase\Models\Model;
+use Fleetbase\Traits\HasApiModelBehavior;
+use Fleetbase\Traits\HasMetaAttributes;
+use Fleetbase\Traits\HasPublicId;
+use Fleetbase\Traits\HasUuid;
+use Fleetbase\Traits\TracksApiCredential;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+/**
+ * ManifestStop.
+ *
+ * Represents a single physical stop within a Manifest. Each stop links to:
+ *   - The parent Manifest
+ *   - The Order being fulfilled at this stop
+ *   - The Place (physical address) to visit
+ *   - Optionally, the specific Waypoint within the order's Payload
+ *
+ * The sequence field holds the VROOM-optimised stop order (1-indexed).
+ */
+class ManifestStop extends Model
+{
+    use HasUuid;
+    use HasPublicId;
+    use HasMetaAttributes;
+    use HasApiModelBehavior;
+    use TracksApiCredential;
+    use SoftDeletes;
+
+    /**
+     * The database table used by the model.
+     */
+    protected $table = 'manifest_stops';
+
+    /**
+     * The type of public ID to generate.
+     */
+    protected $publicIdType = 'mstop';
+
+    /**
+     * Mass-assignable attributes.
+     */
+    protected $fillable = [
+        'manifest_uuid',
+        'order_uuid',
+        'place_uuid',
+        'waypoint_uuid',
+        'status',
+        'sequence',
+        'estimated_arrival',
+        'actual_arrival',
+        'distance_from_prev_m',
+        'duration_from_prev_s',
+        'meta',
+    ];
+
+    /**
+     * Attribute casts.
+     */
+    protected $casts = [
+        'meta'                 => Json::class,
+        'estimated_arrival'    => 'datetime',
+        'actual_arrival'       => 'datetime',
+        'sequence'             => 'integer',
+        'distance_from_prev_m' => 'integer',
+        'duration_from_prev_s' => 'integer',
+    ];
+
+    /**
+     * Attributes appended to the model's JSON representation.
+     */
+    protected $appends = [
+        'tracking_number',
+        'address',
+    ];
+
+    // ── Relationships ─────────────────────────────────────────────────────────
+
+    /**
+     * The parent manifest.
+     */
+    public function manifest(): BelongsTo
+    {
+        return $this->belongsTo(Manifest::class, 'manifest_uuid', 'uuid');
+    }
+
+    /**
+     * The order this stop fulfils.
+     */
+    public function order(): BelongsTo
+    {
+        return $this->belongsTo(Order::class, 'order_uuid', 'uuid')
+            ->with(['trackingNumber', 'payload.dropoff']);
+    }
+
+    /**
+     * The physical Place to visit.
+     */
+    public function place(): BelongsTo
+    {
+        return $this->belongsTo(Place::class, 'place_uuid', 'uuid');
+    }
+
+    /**
+     * The specific Waypoint within the order payload (nullable).
+     */
+    public function waypoint(): BelongsTo
+    {
+        return $this->belongsTo(Waypoint::class, 'waypoint_uuid', 'uuid');
+    }
+
+    // ── Computed Attributes ───────────────────────────────────────────────────
+
+    public function getTrackingNumberAttribute(): ?string
+    {
+        return $this->order?->trackingNumber?->tracking_number;
+    }
+
+    public function getAddressAttribute(): ?string
+    {
+        return $this->place?->address ?? $this->order?->payload?->dropoff?->address;
+    }
+
+    // ── Business Logic ────────────────────────────────────────────────────────
+
+    /**
+     * Mark this stop as arrived and record the actual arrival time.
+     */
+    public function markArrived(): self
+    {
+        $this->update(['status' => 'arrived', 'actual_arrival' => now()]);
+
+        return $this;
+    }
+
+    /**
+     * Mark this stop as completed and trigger manifest auto-completion check.
+     */
+    public function markCompleted(): self
+    {
+        $this->update(['status' => 'completed']);
+        $this->manifest?->checkAndAutoComplete();
+
+        return $this;
+    }
+
+    /**
+     * Mark this stop as skipped.
+     */
+    public function markSkipped(): self
+    {
+        $this->update(['status' => 'skipped']);
+        $this->manifest?->checkAndAutoComplete();
+
+        return $this;
+    }
+}

package/server/src/Models/Order.php

@@ -120,6 +120,13 @@ class Order extends Model
         'notes',
         'type',
         'status',
+        // Orchestrator
+        'orchestrator_priority',
+        'required_skills',
+        'time_window_start',
+        'time_window_end',
+        // Manifest (set by orchestrator commit)
+        'manifest_uuid',
     ];
 
     /**
@@ -205,6 +212,11 @@ class Order extends Model
         'scheduled_at'     => 'datetime',
         'dispatched_at'    => 'datetime',
         'started_at'       => 'datetime',
+        // Orchestrator
+        'required_skills'       => Json::class,
+        'time_window_start'     => 'datetime',
+        'time_window_end'       => 'datetime',
+        'orchestrator_priority' => 'integer',
     ];
 
     /**
@@ -623,6 +635,64 @@ class Order extends Model
         $this->attributes['status'] = is_string($status) ? Str::snake($status) : 'created';
     }
 
+    /**
+     * Normalise the date portion of time_window_start on write.
+     *
+     * If the incoming value has a Unix-epoch date (1970-01-01) — which happens
+     * when a caller supplies a time-only string such as "09:00:00" or when the
+     * client-side picker emits a time without a date — the date portion is
+     * replaced with the order's scheduled_at date, falling back to created_at,
+     * and finally to now().  If the value already carries a meaningful date it
+     * is stored as-is, so callers that supply a full datetime are never
+     * overridden.
+     */
+    public function setTimeWindowStartAttribute($value): void
+    {
+        $this->attributes['time_window_start'] = $this->normaliseTimeWindowValue($value);
+    }
+
+    /**
+     * Normalise the date portion of time_window_end on write.
+     *
+     * @see setTimeWindowStartAttribute()
+     */
+    public function setTimeWindowEndAttribute($value): void
+    {
+        $this->attributes['time_window_end'] = $this->normaliseTimeWindowValue($value);
+    }
+
+    /**
+     * Resolve a time-window value to a full datetime string, injecting the
+     * order's reference date (scheduled_at ?? created_at ?? now) when the
+     * supplied value has no meaningful date of its own.
+     *
+     * @param mixed $value Anything Carbon::parse() can accept, or null
+     *
+     * @return string|null MySQL-formatted datetime string, or null
+     */
+    protected function normaliseTimeWindowValue($value): ?string
+    {
+        if ($value === null || $value === '') {
+            return null;
+        }
+
+        $parsed = Carbon::parse($value);
+
+        // When the date portion is the Unix epoch the caller sent a time-only
+        // value (e.g. "09:00:00").  Inject the order's reference date.
+        if ($parsed->year === 1970 && $parsed->month === 1 && $parsed->day === 1) {
+            $ref = isset($this->attributes['scheduled_at']) && $this->attributes['scheduled_at']
+                ? Carbon::parse($this->attributes['scheduled_at'])
+                : (isset($this->attributes['created_at']) && $this->attributes['created_at']
+                    ? Carbon::parse($this->attributes['created_at'])
+                    : Carbon::now());
+
+            $parsed->setDate($ref->year, $ref->month, $ref->day);
+        }
+
+        return $parsed->toDateTimeString();
+    }
+
     /**
      * Checks if a driver is assigned to the order.
      *

package/server/src/Models/OrderConfig.php

@@ -175,11 +175,14 @@ class OrderConfig extends Model
     }
 
     /**
-     * @return \Illuminate\Database\Eloquent\Relations\HasMany
+     * Get all custom fields defined for this order config.
+     * CustomField uses a polymorphic subject relationship (subject_uuid / subject_type).
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\MorphMany
      */
     public function customFields()
     {
-        return $this->belongsTo(\Fleetbase\Models\CustomField::class);
+        return $this->morphMany(\Fleetbase\Models\CustomField::class, 'subject', 'subject_type', 'subject_uuid');
     }
 
     /**

package/server/src/Models/Part.php

@@ -3,7 +3,9 @@
 namespace Fleetbase\FleetOps\Models;
 
 use Fleetbase\Casts\Json;
+use Fleetbase\Casts\Money;
 use Fleetbase\Casts\PolymorphicType;
+use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\FleetOps\Traits\Maintainable;
 use Fleetbase\Models\Alert;
 use Fleetbase\Models\File;
@@ -88,6 +90,7 @@ class Part extends Model
         'quantity_on_hand',
         'unit_cost',
         'msrp',
+        'currency',
         'asset_type',
         'asset_uuid',
         'type',
@@ -126,8 +129,9 @@ class Part extends Model
      */
     protected $casts = [
         'quantity_on_hand' => 'integer',
-        'unit_cost'        => 'decimal:2',
-        'msrp'             => 'decimal:2',
+        // Money values
+        'unit_cost'        => Money::class,
+        'msrp'             => Money::class,
         'specs'            => Json::class,
         'meta'             => Json::class,
         'asset_type'       => PolymorphicType::class,
@@ -199,7 +203,7 @@ class Part extends Model
 
     public function asset(): MorphTo
     {
-        return $this->morphTo();
+        return $this->morphTo(__FUNCTION__, 'asset_type', 'asset_uuid');
     }
 
     /**
@@ -501,4 +505,66 @@ class Part extends Model
 
         return $quantity * ($price ?? 0);
     }
+
+    /**
+     * Create a Part instance from an import row.
+     *
+     * Monetary values (unit_cost, msrp) must be supplied in cents (integers).
+     * The Money cast will strip non-numeric characters before storage.
+     *
+     * @param array $row          Associative array from the import spreadsheet
+     * @param bool  $saveInstance Whether to persist the record immediately
+     */
+    public static function createFromImport(array $row, bool $saveInstance = false): Part
+    {
+        $row = array_filter($row);
+
+        $sku            = Utils::or($row, ['sku', 'part_number', 'internal_id']);
+        $name           = Utils::or($row, ['name', 'part_name']);
+        $type           = Utils::or($row, ['type', 'part_type'], 'consumable');
+        $status         = Utils::or($row, ['status'], 'in_stock');
+        $manufacturer   = Utils::or($row, ['manufacturer', 'make', 'brand']);
+        $model          = Utils::or($row, ['model', 'part_model']);
+        $serialNumber   = Utils::or($row, ['serial_number', 'serial']);
+        $barcode        = Utils::or($row, ['barcode']);
+        $description    = Utils::or($row, ['description']);
+        $quantityOnHand = Utils::or($row, ['quantity_on_hand', 'quantity', 'qty']);
+        $unitCost       = Utils::or($row, ['unit_cost', 'cost']);
+        $msrp           = Utils::or($row, ['msrp', 'retail_price']);
+        $currency       = Utils::or($row, ['currency'], 'USD');
+        $vendorName     = Utils::or($row, ['vendor_name', 'vendor', 'supplier']);
+
+        $part = new static([
+            'company_uuid'     => session('company'),
+            'sku'              => $sku,
+            'name'             => $name,
+            'type'             => $type,
+            'status'           => $status,
+            'manufacturer'     => $manufacturer,
+            'model'            => $model,
+            'serial_number'    => $serialNumber,
+            'barcode'          => $barcode,
+            'description'      => $description,
+            'quantity_on_hand' => $quantityOnHand ? (int) $quantityOnHand : 0,
+            'unit_cost'        => $unitCost,
+            'msrp'             => $msrp,
+            'currency'         => strtoupper($currency ?? 'USD'),
+        ]);
+
+        // Attempt to resolve vendor by name
+        if ($vendorName) {
+            $vendor = Vendor::where('company_uuid', session('company'))
+                ->where('name', 'like', '%' . $vendorName . '%')
+                ->first();
+            if ($vendor) {
+                $part->vendor_uuid = $vendor->uuid;
+            }
+        }
+
+        if ($saveInstance === true) {
+            $part->save();
+        }
+
+        return $part;
+    }
 }

package/server/src/Models/Place.php

@@ -235,7 +235,7 @@ class Place extends Model
             function ($option) {
                 $key = str_replace(['.svg', '.png'], '', $option);
 
-                return [$key => Utils::assetFromS3('static/place-icons/' . $option)];
+                return [$key => Utils::assetFromFleetbase('static/place-icons/' . $option)];
             }
         );
 

package/server/src/Models/Sensor.php

@@ -216,7 +216,7 @@ class Sensor extends Model
 
     public function sensorable(): MorphTo
     {
-        return $this->morphTo();
+        return $this->morphTo(__FUNCTION__, 'sensorable_type', 'sensorable_uuid');
     }
 
     public function photo(): BelongsTo

package/server/src/Models/ServiceQuote.php

@@ -121,7 +121,7 @@ class ServiceQuote extends Model
         return $this->belongsTo(IntegratedVendor::class);
     }
 
-    public function getServiceRateNameAttribute(): string
+    public function getServiceRateNameAttribute(): ?string
     {
         return data_get($this, 'serviceRate.service_name');
     }

package/server/src/Models/Vehicle.php

@@ -139,6 +139,7 @@ class Vehicle extends Model
         'type',
         'class',
         // Identifiers
+        'internal_id',
         'plate_number',
         'call_sign',
         'serial_number',
@@ -204,6 +205,15 @@ class Vehicle extends Model
         'slug',
         'purchased_at',
         'lease_expires_at',
+        // Orchestrator
+        'skills',
+        'payload_capacity_volume',
+        'payload_capacity_pallets',
+        'payload_capacity_parcels',
+        'max_tasks',
+        'time_window_start',
+        'time_window_end',
+        'return_to_depot',
     ];
 
     /**
@@ -295,6 +305,13 @@ class Vehicle extends Model
         'torque'              => 'decimal:2',
         'gvwr'                => 'decimal:2',
         'gcwr'                => 'decimal:2',
+        // Orchestrator
+        'skills'                    => Json::class,
+        'payload_capacity_volume'   => 'decimal:3',
+        'payload_capacity_pallets'  => 'integer',
+        'payload_capacity_parcels'  => 'integer',
+        'max_tasks'                 => 'integer',
+        'return_to_depot'           => 'boolean',
     ];
 
     public function photo(): BelongsTo
@@ -561,7 +578,7 @@ class Vehicle extends Model
             function ($option) {
                 $key = str_replace(['.svg', '.png'], '', $option);
 
-                return [$key => Utils::assetFromS3('static/vehicle-icons/' . $option)];
+                return [$key => Utils::assetFromFleetbase('static/vehicle-icons/' . $option)];
             }
         );
 

package/server/src/Models/Warranty.php

@@ -164,7 +164,7 @@ class Warranty extends Model
 
     public function subject(): MorphTo
     {
-        return $this->morphTo();
+        return $this->morphTo(__FUNCTION__, 'subject_type', 'subject_uuid');
     }
 
     /**