@fleetbase/fleetops-engine 0.6.37 → 0.6.39

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

@@ -0,0 +1,137 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Resources\v1;
+
+use Fleetbase\FleetOps\Support\Utils;
+use Fleetbase\Http\Resources\FleetbaseResource;
+use Fleetbase\Support\Http;
+use Illuminate\Support\Str;
+
+class MaintenanceSchedule extends FleetbaseResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return $this->withCustomFields([
+            '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),
+            'company_uuid'                => $this->when(Http::isInternalRequest(), $this->company_uuid),
+            'created_by_uuid'             => $this->when(Http::isInternalRequest(), $this->created_by_uuid),
+            'updated_by_uuid'             => $this->when(Http::isInternalRequest(), $this->updated_by_uuid),
+            // Polymorphic subject
+            'subject_uuid'                => $this->when(Http::isInternalRequest(), $this->subject_uuid),
+            'subject_type'                => $this->when(Http::isInternalRequest(), $this->subject_type ? Utils::toEmberResourceType($this->subject_type) : null),
+            'subject'                     => $this->whenLoaded('subject', function () {
+                return $this->setSubjectType($this->transformMorphResource($this->subject));
+            }),
+            // Polymorphic default assignee
+            'default_assignee_uuid'       => $this->when(Http::isInternalRequest(), $this->default_assignee_uuid),
+            'default_assignee_type'       => $this->when(Http::isInternalRequest(), $this->default_assignee_type ? Utils::toEmberResourceType($this->default_assignee_type) : null),
+            'default_assignee'            => $this->whenLoaded('defaultAssignee', function () {
+                return $this->setAssigneeType($this->transformMorphResource($this->defaultAssignee));
+            }),
+            // Core attributes
+            'name'                        => $this->name,
+            'type'                        => $this->type,
+            'status'                      => $this->status,
+            'interval_method'             => $this->interval_method,
+            'interval_type'               => $this->interval_type,
+            'interval_value'              => $this->interval_value,
+            'interval_unit'               => $this->interval_unit,
+            'interval_distance'           => $this->interval_distance,
+            'interval_engine_hours'       => $this->interval_engine_hours,
+            // Baseline readings
+            'last_service_odometer'       => $this->last_service_odometer,
+            'last_service_engine_hours'   => $this->last_service_engine_hours,
+            'last_service_date'           => $this->last_service_date,
+            // Next-due thresholds
+            'next_due_date'               => $this->next_due_date,
+            'next_due_odometer'           => $this->next_due_odometer,
+            'next_due_engine_hours'       => $this->next_due_engine_hours,
+            // Work-order defaults
+            'default_priority'            => $this->default_priority,
+            'instructions'                => $this->instructions,
+            'reminder_offsets'            => $this->reminder_offsets ?? [],
+            'meta'                        => data_get($this, 'meta', (object) []),
+            'slug'                        => $this->slug,
+            // Convenience name attrs
+            'subject_name'                => $this->subject_name,
+            'default_assignee_name'       => $this->default_assignee_name,
+            // Dates
+            'last_triggered_at'           => $this->last_triggered_at,
+            'updated_at'                  => $this->updated_at,
+            'created_at'                  => $this->created_at,
+        ]);
+    }
+
+    /**
+     * Inject the abstract 'maintenance-subject' type into the embedded subject object
+     * so Ember Data can resolve the correct polymorphic model.
+     *
+     * subject_type must be the Ember Data model name for the concrete subtype,
+     * e.g. 'maintenance-subject-vehicle' or 'maintenance-subject-equipment'.
+     * We use the bare PHP class basename so we get 'vehicle' / 'equipment' rather
+     * than the full 'fleet-ops:vehicle' string that toEmberResourceType() would return.
+     */
+    protected function setSubjectType(?array $resolved): ?array
+    {
+        if (empty($resolved)) {
+            return $resolved;
+        }
+
+        $bareSlug = Str::kebab(class_basename($this->subject_type ?? ''));
+
+        data_set($resolved, 'type', 'maintenance-subject-' . $bareSlug);
+        data_set($resolved, 'subject_type', 'maintenance-subject-' . $bareSlug);
+
+        return $resolved;
+    }
+
+    /**
+     * Inject the abstract 'facilitator' type into the embedded default_assignee object
+     * so Ember Data can resolve the correct polymorphic model.
+     *
+     * facilitator_type must be the Ember Data model name for the concrete subtype,
+     * e.g. 'facilitator-vendor' or 'facilitator-contact'.
+     * We use the bare PHP class basename so we get 'vendor' / 'contact' rather
+     * than the full 'fleet-ops:vendor' string that toEmberResourceType() would return.
+     */
+    protected function setAssigneeType(?array $resolved): ?array
+    {
+        if (empty($resolved)) {
+            return $resolved;
+        }
+
+        $bareSlug = Str::kebab(class_basename($this->default_assignee_type ?? ''));
+
+        data_set($resolved, 'type', 'facilitator-' . $bareSlug);
+        data_set($resolved, 'facilitator_type', 'facilitator-' . $bareSlug);
+
+        return $resolved;
+    }
+
+    /**
+     * Resolve the appropriate resource transformer for a polymorphic morph target
+     * and return its array representation.
+     */
+    protected function transformMorphResource($model): ?array
+    {
+        if (!$model) {
+            return null;
+        }
+
+        $resourceClass = \Fleetbase\Support\Find::httpResourceForModel($model);
+        if ($resourceClass) {
+            return (new $resourceClass($model))->resolve();
+        }
+
+        return (new \Illuminate\Http\Resources\Json\JsonResource($model))->resolve();
+    }
+}

package/server/src/Http/Resources/v1/Orchestrator/Order.php

@@ -0,0 +1,116 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Resources\v1\Orchestrator;
+
+use Fleetbase\FleetOps\Http\Resources\v1\Index\Driver;
+use Fleetbase\FleetOps\Http\Resources\v1\Index\Payload;
+use Fleetbase\FleetOps\Http\Resources\v1\Index\Vehicle;
+use Fleetbase\Http\Resources\FleetbaseResource;
+
+/**
+ * Orchestrator Order resource.
+ *
+ * A workbench-specific Order representation that extends the lightweight
+ * Index/Order shape with custom_field_values. This resource is intentionally
+ * separate from Index/Order so that the tabular orders view retains its
+ * optimised, minimal payload while the Orchestrator Workbench gets the richer
+ * data it needs to render configurable card fields.
+ *
+ * Used exclusively by OrchestrationController::orders().
+ */
+class Order extends FleetbaseResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param \Illuminate\Http\Request $request
+     */
+    public function toArray($request): array
+    {
+        return [
+            'id'                    => $this->id,
+            'uuid'                  => $this->uuid,
+            'public_id'             => $this->public_id,
+            'internal_id'           => $this->internal_id,
+            'company_uuid'          => $this->company_uuid,
+            'payload_uuid'          => $this->payload_uuid,
+            'order_config_uuid'     => $this->order_config_uuid,
+            'driver_assigned_uuid'  => $this->driver_assigned_uuid,
+            'vehicle_assigned_uuid' => $this->vehicle_assigned_uuid,
+            'tracking'              => $this->trackingNumber?->tracking_number,
+
+            // Minimal order config
+            'order_config'          => $this->whenLoaded('orderConfig', function () {
+                return [
+                    'id'   => $this->orderConfig->public_id,
+                    'name' => $this->orderConfig->name,
+                    'key'  => $this->orderConfig->key,
+                ];
+            }),
+
+            // Payload with pickup/dropoff/waypoints
+            'payload'               => $this->whenLoaded('payload', function () {
+                return new Payload($this->payload);
+            }),
+
+            // Lightweight driver
+            'driver_assigned'       => $this->whenLoaded('driverAssigned', function () {
+                return new Driver($this->driverAssigned);
+            }),
+
+            // Lightweight vehicle
+            'vehicle_assigned'      => $this->whenLoaded('vehicleAssigned', function () {
+                return new Vehicle($this->vehicleAssigned);
+            }),
+
+            // Custom field values — the primary addition over Index/Order.
+            // Each entry contains the raw value and the parent CustomField
+            // definition (name, label, type) so the card renderer can match
+            // by field name/label without a separate API call.
+            'custom_field_values'   => $this->whenLoaded('customFieldValues', function () {
+                return $this->customFieldValues->map(function ($cfv) {
+                    return [
+                        'id'                => $cfv->uuid,
+                        'uuid'              => $cfv->uuid,
+                        'custom_field_uuid' => $cfv->custom_field_uuid,
+                        'value'             => $cfv->value,
+                        'value_type'        => $cfv->value_type,
+                        'custom_field'      => $cfv->relationLoaded('customField') && $cfv->customField
+                            ? [
+                                'id'       => $cfv->customField->uuid,
+                                'uuid'     => $cfv->customField->uuid,
+                                'name'     => $cfv->customField->name,
+                                'label'    => $cfv->customField->label,
+                                'type'     => $cfv->customField->type,
+                                'required' => (bool) $cfv->customField->required,
+                            ]
+                            : null,
+                    ];
+                })->values();
+            }),
+
+            // Scalar fields
+            'type'                  => $this->type,
+            'status'                => $this->status,
+            'notes'                 => $this->notes,
+            'adhoc'                 => (bool) data_get($this, 'adhoc', false),
+            'dispatched'            => (bool) data_get($this, 'dispatched', false),
+            'has_driver_assigned'   => $this->has_driver_assigned,
+            'is_scheduled'          => $this->is_scheduled,
+            'orchestrator_priority' => $this->orchestrator_priority ?? 0,
+            'time_window_start'     => $this->time_window_start,
+            'time_window_end'       => $this->time_window_end,
+            'required_skills'       => $this->required_skills ?? [],
+
+            // Timestamps
+            'scheduled_at'          => $this->scheduled_at,
+            'dispatched_at'         => $this->dispatched_at,
+            'started_at'            => $this->started_at,
+            'created_at'            => $this->created_at,
+            'updated_at'            => $this->updated_at,
+
+            // Meta
+            'meta'                  => $this->meta ?? [],
+        ];
+    }
+}

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

@@ -7,6 +7,7 @@ use Fleetbase\Http\Resources\Comment;
 use Fleetbase\Http\Resources\File;
 use Fleetbase\Http\Resources\FleetbaseResource;
 use Fleetbase\Support\Http;
+use Illuminate\Support\Str;
 
 class Order extends FleetbaseResource
 {
@@ -117,8 +118,9 @@ class Order extends FleetbaseResource
             return $resolved;
         }
 
-        data_set($resolved, 'type', 'customer');
-        data_set($resolved, 'customer_type', 'customer-' . Utils::toEmberResourceType($this->customer_type));
+        $bareSlug = Str::kebab(class_basename($this->customer_type ?? ''));
+        data_set($resolved, 'type', 'customer-' . $bareSlug);
+        data_set($resolved, 'customer_type', 'customer-' . $bareSlug);
 
         return $resolved;
     }
@@ -136,8 +138,9 @@ class Order extends FleetbaseResource
             return $resolved;
         }
 
-        data_set($resolved, 'type', 'facilitator');
-        data_set($resolved, 'facilitator_type', 'facilitator-' . Utils::toEmberResourceType($this->facilitator_type));
+        $bareSlug = Str::kebab(class_basename($this->facilitator_type ?? ''));
+        data_set($resolved, 'type', 'facilitator-' . $bareSlug);
+        data_set($resolved, 'facilitator_type', 'facilitator-' . $bareSlug);
 
         return $resolved;
     }

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

@@ -61,6 +61,13 @@ class Waypoint extends FleetbaseResource
             'type'                   => $waypoint->type ?? $this->type,
             'meta'                   => data_get($this, 'meta', Utils::createObject()),
             'eta'                    => $this->eta,
+            // Per-stop POD and notes
+            'notes'                  => $waypoint->notes ?? null,
+            'pod_method'             => $waypoint->pod_method ?? null,
+            'pod_required'           => $waypoint->pod_required ?? false,
+            'time_window_start'      => $waypoint->time_window_start,
+            'time_window_end'        => $waypoint->time_window_end,
+            'service_time'           => $waypoint->service_time,
             'updated_at'             => $this->updated_at,
             'created_at'             => $this->created_at,
         ];

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

@@ -0,0 +1,136 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Resources\v1;
+
+use Fleetbase\FleetOps\Support\Utils;
+use Fleetbase\Http\Resources\FleetbaseResource;
+use Fleetbase\Support\Http;
+use Illuminate\Support\Str;
+
+class WorkOrder extends FleetbaseResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @param \Illuminate\Http\Request $request
+     *
+     * @return array
+     */
+    public function toArray($request)
+    {
+        return $this->withCustomFields([
+            '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),
+            'company_uuid'            => $this->when(Http::isInternalRequest(), $this->company_uuid),
+            'schedule_uuid'           => $this->when(Http::isInternalRequest(), $this->schedule_uuid),
+            'created_by_uuid'         => $this->when(Http::isInternalRequest(), $this->created_by_uuid),
+            'updated_by_uuid'         => $this->when(Http::isInternalRequest(), $this->updated_by_uuid),
+            // Polymorphic target
+            'target_uuid'             => $this->when(Http::isInternalRequest(), $this->target_uuid),
+            'target_type'             => $this->when(Http::isInternalRequest(), $this->target_type ? Utils::toEmberResourceType($this->target_type) : null),
+            'target'                  => $this->whenLoaded('target', function () {
+                return $this->setTargetType($this->transformMorphResource($this->target));
+            }),
+            // Polymorphic assignee
+            'assignee_uuid'           => $this->when(Http::isInternalRequest(), $this->assignee_uuid),
+            'assignee_type'           => $this->when(Http::isInternalRequest(), $this->assignee_type ? Utils::toEmberResourceType($this->assignee_type) : null),
+            'assignee'                => $this->whenLoaded('assignee', function () {
+                return $this->setAssigneeType($this->transformMorphResource($this->assignee));
+            }),
+            // Core attributes
+            'code'                    => $this->code,
+            'subject'                 => $this->subject,
+            'status'                  => $this->status,
+            'priority'                => $this->priority,
+            'instructions'            => $this->instructions,
+            'checklist'               => data_get($this, 'checklist', []),
+            'meta'                    => data_get($this, 'meta', (object) []),
+            'slug'                    => $this->slug,
+            // Computed
+            'target_name'             => $this->target_name,
+            'assignee_name'           => $this->assignee_name,
+            'is_overdue'              => $this->is_overdue,
+            'days_until_due'          => $this->days_until_due,
+            'completion_percentage'   => $this->completion_percentage,
+            // Dates
+            'opened_at'               => $this->opened_at,
+            'due_at'                  => $this->due_at,
+            'closed_at'               => $this->closed_at,
+            'updated_at'              => $this->updated_at,
+            'created_at'              => $this->created_at,
+        ]);
+    }
+
+    /**
+     * Inject the abstract 'maintenance-subject' type into the embedded target object
+     * so Ember Data can resolve the correct polymorphic model.
+     *
+     * The subject_type must be the Ember Data model name for the concrete subtype,
+     * e.g. 'maintenance-subject-vehicle' or 'maintenance-subject-equipment'.
+     *
+     * We derive it from the bare PHP class basename (e.g. 'Vehicle' -> 'vehicle')
+     * rather than using toEmberResourceType() which produces 'fleet-ops:vehicle' —
+     * a string that would make the injected type 'maintenance-subject-fleet-ops:vehicle'.
+     */
+    protected function setTargetType(?array $resolved): ?array
+    {
+        if (empty($resolved)) {
+            return $resolved;
+        }
+
+        // class_basename('Fleetbase\FleetOps\Models\Vehicle') -> 'Vehicle'
+        // Str::kebab('Vehicle') -> 'vehicle'
+        $bareSlug = Str::kebab(class_basename($this->target_type ?? ''));
+
+        data_set($resolved, 'type', 'maintenance-subject-' . $bareSlug);
+        data_set($resolved, 'subject_type', 'maintenance-subject-' . $bareSlug);
+
+        return $resolved;
+    }
+
+    /**
+     * Inject the abstract 'facilitator' type into the embedded assignee object
+     * so Ember Data can resolve the correct polymorphic model.
+     *
+     * The facilitator_type must be the Ember Data model name for the concrete subtype,
+     * e.g. 'facilitator-vendor' or 'facilitator-contact'.
+     *
+     * We derive it from the bare PHP class basename (e.g. 'Vendor' -> 'vendor')
+     * rather than using toEmberResourceType() which produces 'fleet-ops:vendor' —
+     * a string that would make the injected type 'facilitator-fleet-ops:vendor'.
+     */
+    protected function setAssigneeType(?array $resolved): ?array
+    {
+        if (empty($resolved)) {
+            return $resolved;
+        }
+
+        // class_basename('Fleetbase\FleetOps\Models\Vendor') -> 'Vendor'
+        // Str::kebab('Vendor') -> 'vendor'
+        $bareSlug = Str::kebab(class_basename($this->assignee_type ?? ''));
+
+        data_set($resolved, 'type', 'facilitator-' . $bareSlug);
+        data_set($resolved, 'facilitator_type', 'facilitator-' . $bareSlug);
+
+        return $resolved;
+    }
+
+    /**
+     * Resolve the appropriate resource transformer for a polymorphic morph target
+     * and return its array representation.
+     */
+    protected function transformMorphResource($model): ?array
+    {
+        if (!$model) {
+            return null;
+        }
+
+        $resourceClass = \Fleetbase\Support\Find::httpResourceForModel($model);
+        if ($resourceClass) {
+            return (new $resourceClass($model))->resolve();
+        }
+
+        return (new \Illuminate\Http\Resources\Json\JsonResource($model))->resolve();
+    }
+}

package/server/src/Imports/EquipmentImport.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Fleetbase\FleetOps\Imports;
+
+use Fleetbase\FleetOps\Models\Equipment;
+use Illuminate\Support\Collection;
+use Maatwebsite\Excel\Concerns\ToCollection;
+use Maatwebsite\Excel\Concerns\WithHeadingRow;
+
+class EquipmentImport implements ToCollection, WithHeadingRow
+{
+    /**
+     * Counter for successfully imported rows.
+     */
+    public int $imported = 0;
+
+    public function collection(Collection $rows)
+    {
+        foreach ($rows as $row) {
+            if ($row instanceof Collection) {
+                $row = array_filter($row->toArray());
+            }
+
+            if (empty($row)) {
+                continue;
+            }
+
+            Equipment::createFromImport($row, true);
+            $this->imported++;
+        }
+    }
+}

package/server/src/Imports/MaintenanceImport.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Fleetbase\FleetOps\Imports;
+
+use Fleetbase\FleetOps\Models\Maintenance;
+use Illuminate\Support\Collection;
+use Maatwebsite\Excel\Concerns\ToCollection;
+use Maatwebsite\Excel\Concerns\WithHeadingRow;
+
+class MaintenanceImport implements ToCollection, WithHeadingRow
+{
+    /**
+     * Counter for successfully imported rows.
+     */
+    public int $imported = 0;
+
+    public function collection(Collection $rows)
+    {
+        foreach ($rows as $row) {
+            if ($row instanceof Collection) {
+                $row = array_filter($row->toArray());
+            }
+
+            if (empty($row)) {
+                continue;
+            }
+
+            Maintenance::createFromImport($row, true);
+            $this->imported++;
+        }
+    }
+}

package/server/src/Imports/MaintenanceScheduleImport.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Fleetbase\FleetOps\Imports;
+
+use Fleetbase\FleetOps\Models\MaintenanceSchedule;
+use Illuminate\Support\Collection;
+use Maatwebsite\Excel\Concerns\ToCollection;
+use Maatwebsite\Excel\Concerns\WithHeadingRow;
+
+class MaintenanceScheduleImport implements ToCollection, WithHeadingRow
+{
+    /**
+     * Counter for successfully imported rows.
+     */
+    public int $imported = 0;
+
+    public function collection(Collection $rows)
+    {
+        foreach ($rows as $row) {
+            if ($row instanceof Collection) {
+                $row = array_filter($row->toArray());
+            }
+
+            if (empty($row)) {
+                continue;
+            }
+
+            MaintenanceSchedule::createFromImport($row, true);
+            $this->imported++;
+        }
+    }
+}

package/server/src/Imports/PartImport.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Fleetbase\FleetOps\Imports;
+
+use Fleetbase\FleetOps\Models\Part;
+use Illuminate\Support\Collection;
+use Maatwebsite\Excel\Concerns\ToCollection;
+use Maatwebsite\Excel\Concerns\WithHeadingRow;
+
+class PartImport implements ToCollection, WithHeadingRow
+{
+    /**
+     * Counter for successfully imported rows.
+     */
+    public int $imported = 0;
+
+    public function collection(Collection $rows)
+    {
+        foreach ($rows as $row) {
+            if ($row instanceof Collection) {
+                $row = array_filter($row->toArray());
+            }
+
+            if (empty($row)) {
+                continue;
+            }
+
+            Part::createFromImport($row, true);
+            $this->imported++;
+        }
+    }
+}

package/server/src/Imports/WorkOrderImport.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace Fleetbase\FleetOps\Imports;
+
+use Fleetbase\FleetOps\Models\WorkOrder;
+use Illuminate\Support\Collection;
+use Maatwebsite\Excel\Concerns\ToCollection;
+use Maatwebsite\Excel\Concerns\WithHeadingRow;
+
+class WorkOrderImport implements ToCollection, WithHeadingRow
+{
+    /**
+     * Counter for successfully imported rows.
+     */
+    public int $imported = 0;
+
+    public function collection(Collection $rows)
+    {
+        foreach ($rows as $row) {
+            if ($row instanceof Collection) {
+                $row = array_filter($row->toArray());
+            }
+
+            if (empty($row)) {
+                continue;
+            }
+
+            WorkOrder::createFromImport($row, true);
+            $this->imported++;
+        }
+    }
+}