@fleetbase/fleetops-engine 0.6.16 → 0.6.18

package/server/migrations/2025_08_28_054926_create_sensors_table.php

@@ -0,0 +1,62 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('sensors', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+
+            $table->string('name')->nullable()->index();
+            $table->string('slug')->nullable()->index();
+            $table->string('sensor_type')->index();             // temp, humidity, door, fuel, pressure, vibration, cargo-weight, etc.
+            $table->string('unit')->nullable();                 // C, F, %, psi, kg, etc.
+            $table->float('min_threshold')->nullable();
+            $table->float('max_threshold')->nullable();
+            $table->boolean('threshold_inclusive')->default(true);
+            $table->string('type')->nullable()->index();
+
+            $table->timestamp('last_reading_at')->nullable()->index();
+            $table->string('last_value')->nullable();           // use string to store raw value
+            $table->json('calibration')->nullable();            // { offset, slope, notes }
+            $table->unsignedInteger('report_frequency_sec')->nullable();
+
+            // A sensor can belong to a device, asset, or any other entity
+            $table->string('sensorable_type')->nullable();
+            $table->uuid('sensorable_uuid')->nullable();
+            $table->index(['sensorable_type', 'sensorable_uuid']);
+
+            // Optionally coupled to a device (if it streams via a device)
+            $table->foreignUuid('device_uuid')->nullable()->constrained('devices', 'uuid')->nullOnDelete();
+            $table->foreignUuid('warranty_uuid')->nullable()->constrained('warranties', 'uuid')->nullOnDelete();
+
+            $table->json('meta')->nullable();
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'sensor_type']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('sensors');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_054927_create_parts_table.php

@@ -0,0 +1,73 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('parts', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('category_uuid')->nullable()->constrained('categories', 'uuid')->nullOnDelete();
+
+            $table->string('sku')->nullable()->index();
+            $table->string('name')->index();
+            $table->string('manufacturer')->nullable()->index();
+            $table->string('model')->nullable();
+            $table->string('serial_number')->nullable()->index();
+            $table->string('barcode')->nullable()->index();
+            $table->string('type')->nullable()->index();
+            $table->string('slug')->nullable()->index();
+
+            $table->text('description')->nullable();
+            $table->foreignUuid('vendor_uuid')->nullable()->constrained('vendors', 'uuid')->nullOnDelete();
+
+            $table->integer('quantity_on_hand')->default(0);
+            $table->decimal('unit_cost', 12, 2)->nullable();
+            $table->decimal('msrp', 12, 2)->nullable();
+            $table->integer('reorder_point')->default(5);
+            $table->integer('reorder_quantity')->default(10);
+            $table->integer('max_stock_level')->nullable();
+            $table->integer('reserved_quantity')->default(0);
+
+            $table->integer('allocated_quantity')->default(0); // -- Allocated but not used
+            $table->string('inventory_method')->default('fifo'); // -- fifo, lifo, weighted_average
+
+            // Optional default target (e.g., a part kept for a specific asset or vehicle)
+            $table->string('asset_type')->nullable();
+            $table->uuid('asset_uuid')->nullable();
+            $table->index(['asset_type', 'asset_uuid']);
+
+            $table->foreignUuid('warranty_uuid')->nullable()->constrained('warranties', 'uuid')->nullOnDelete();
+
+            $table->json('specs')->nullable();
+            $table->json('meta')->nullable();
+
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->timestamp('last_ordered_at')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->unique(['company_uuid', 'sku']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('parts');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_054929_create_equipments_table.php

@@ -0,0 +1,58 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('equipments', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('category_uuid')->nullable()->constrained('categories', 'uuid')->nullOnDelete();
+
+            $table->string('name')->index();
+            $table->string('code')->nullable()->index();
+            $table->string('type')->nullable()->index();     // ppe, tool, accessory, fridge unit, etc.
+            $table->string('status')->default('active')->index();
+            $table->string('slug')->nullable()->index();
+            $table->string('serial_number')->nullable()->index();
+            $table->string('manufacturer')->nullable();
+            $table->string('model')->nullable();
+
+            // Can be assigned to an asset, device, driver, or facility
+            $table->string('equipable_type')->nullable();
+            $table->uuid('equipable_uuid')->nullable();
+            $table->index(['equipable_type', 'equipable_uuid']);
+
+            $table->date('purchased_at')->nullable();
+            $table->integer('purchase_price')->nullable();
+            $table->string('currency')->nullable();
+
+            $table->foreignUuid('warranty_uuid')->nullable()->constrained('warranties', 'uuid')->nullOnDelete();
+
+            $table->json('meta')->nullable();
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('equipments');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_054930_create_work_orders_table.php

@@ -0,0 +1,85 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('work_orders', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('category_uuid')->nullable()->constrained('categories', 'uuid')->nullOnDelete();
+
+            $table->string('code')->nullable()->index(); // external WO number
+            $table->string('subject')->index();
+            $table->string('status')->default('open')->index();     // open, in_progress, blocked, done, canceled
+            $table->string('priority')->nullable()->index();        // low, normal, high, critical
+
+            // What the WO is for asset, equipment, device, place, etc.
+            $table->string('target_type')->nullable();
+            $table->uuid('target_uuid')->nullable();
+            $table->index(['target_type', 'target_uuid']);
+
+            // Who it's assigned to (contact/technician/team/user/vendor)
+            $table->string('assignee_type')->nullable();
+            $table->uuid('assignee_uuid')->nullable();
+            $table->index(['assignee_type', 'assignee_uuid']);
+
+            $table->timestamp('opened_at')->nullable()->index();
+            $table->timestamp('due_at')->nullable()->index();
+            $table->timestamp('closed_at')->nullable()->index();
+
+            // -- Resource Planning
+            $table->json('required_skills')->nullable(); // -- Skills needed for work
+            $table->json('required_certifications')->nullable(); // -- Certs needed
+            $table->integer('estimated_duration_hours')->nullable();
+            $table->integer('actual_duration_hours')->nullable();
+            $table->json('resource_requirements')->nullable(); // -- Tools, parts, etc.
+
+            // -- Scheduling & Dependencies
+            $table->timestamp('earliest_start_date')->nullable();
+            $table->timestamp('latest_completion_date')->nullable();
+            $table->string('scheduling_priority')->default('normal'); // -- low, normal, high, urgent
+            $table->boolean('can_be_split')->default(false); // -- Can work be divided
+
+            // -- Cost Management
+            $table->integer('estimated_cost')->nullable();
+            $table->integer('approved_budget')->nullable();
+            $table->integer('actual_cost')->nullable();
+            $table->string('currency')->nullable();
+            $table->json('cost_breakdown')->nullable(); // -- Labor, parts, overhead
+            $table->string('cost_center')->nullable()->index();
+            $table->string('budget_code')->nullable()->index();
+
+            $table->text('instructions')->nullable();
+            $table->text('completion_notes')->nullable();
+            $table->json('checklist')->nullable();  // [{title, required, done_at}, ...]
+            $table->json('meta')->nullable();
+
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'status', 'priority']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('work_orders');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_054931_create_maintenances_table.php

@@ -0,0 +1,79 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('maintenances', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('category_uuid')->nullable()->constrained('categories', 'uuid')->nullOnDelete();
+
+            // Target of maintenance (usually an asset; could be equipment)
+            $table->string('maintainable_type')->nullable();
+            $table->uuid('maintainable_uuid')->nullable();
+            $table->index(['maintainable_type', 'maintainable_uuid']);
+
+            $table->foreignUuid('work_order_uuid')->nullable()->constrained('work_orders', 'uuid')->nullOnDelete();
+
+            $table->string('type')->nullable()->index();          // scheduled, unscheduled, inspection, corrective
+            $table->string('status')->default('open')->index();   // open, in_progress, done, canceled
+            $table->string('priority')->nullable()->index();      // low, normal, high, critical
+
+            $table->timestamp('scheduled_at')->nullable()->index();
+            $table->timestamp('started_at')->nullable()->index();
+            $table->timestamp('completed_at')->nullable()->index();
+
+            $table->unsignedBigInteger('odometer')->nullable();
+            $table->unsignedBigInteger('engine_hours')->nullable();
+
+            // Downtime
+            $table->integer('estimated_downtime_hours')->nullable();
+            $table->timestamp('downtime_start')->nullable();
+            $table->timestamp('downtime_end')->nullable();
+
+            // Vendor or internal performer
+            $table->string('performed_by_type')->nullable();
+            $table->uuid('performed_by_uuid')->nullable();
+            $table->index(['performed_by_type', 'performed_by_uuid']);
+
+            $table->text('summary')->nullable();
+            $table->text('notes')->nullable();
+            $table->json('line_items')->nullable(); // [{part_uuid, qty, unit_cost}, ...]
+            $table->integer('labor_cost')->nullable();
+            $table->integer('parts_cost')->nullable();
+            $table->integer('tax')->nullable();
+            $table->integer('total_cost')->nullable();
+            $table->string('currency')->nullable();
+
+            $table->json('attachments')->nullable();
+            $table->json('meta')->nullable();
+
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'status', 'type']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('maintenances');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_082002_update_vehicles_table_telematics.php

@@ -0,0 +1,60 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('vehicles', function (Blueprint $table) {
+            $table->foreignUuid('telematic_uuid')->after('company_uuid')->nullable()->constrained('telematics', 'uuid')->nullOnDelete();
+            $table->foreignUuid('warranty_uuid')->after('telematic_uuid')->nullable()->constrained('warranties', 'uuid')->nullOnDelete();
+            $table->foreignUuid('category_uuid')->after('telematic_uuid')->nullable()->constrained('categories', 'uuid')->nullOnDelete();
+
+            // Identification
+            $table->string('serial_number')->nullable()->after('plate_number');
+            $table->string('call_sign')->nullable()->after('plate_number');
+
+            // Financial Tracking
+            $table->integer('acquisition_cost')->nullable()->after('vin_data');
+            $table->integer('current_value')->nullable()->after('vin_data');
+            $table->integer('depreciation_rate')->nullable()->after('vin_data'); // -- Annual percentage
+            $table->integer('insurance_value')->nullable()->after('vin_data');
+            $table->string('currency')->nullable()->after('vin_data');
+            $table->string('financing_status')->nullable()->index()->after('vin_data'); // -- owned, leased, financed
+            $table->timestamp('lease_expires_at')->nullable()->index()->after('slug');
+            $table->timestamp('purchased_at')->nullable()->index()->after('slug');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::table('vehicles', function (Blueprint $table) {
+            $table->dropForeign(['telematic_uuid']);
+            $table->dropForeign(['warranty_uuid']);
+            $table->dropForeign(['category_uuid']);
+            $table->dropColumn('telematic_uuid');
+            $table->dropColumn('warranty_uuid');
+            $table->dropColumn('category_uuid');
+            $table->dropColumn('serial_number');
+            $table->dropColumn('call_sign');
+            $table->dropColumn('acquisition_cost');
+            $table->dropColumn('current_value');
+            $table->dropColumn('depreciation_rate');
+            $table->dropColumn('insurance_value');
+            $table->dropColumn('currency');
+            $table->dropColumn('financing_status');
+            $table->dropColumn('lease_expires_at');
+            $table->dropColumn('purchased_at');
+        });
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/src/Http/Controllers/Api/v1/OrderController.php

@@ -30,11 +30,13 @@ use Fleetbase\Models\Company;
 use Fleetbase\Models\File;
 use Fleetbase\Models\Setting;
 use Fleetbase\Support\Auth;
+use Fleetbase\Support\TemplateString;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Illuminate\Http\Request;
 use Illuminate\Http\UploadedFile;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Storage;
 use Illuminate\Support\Str;
 use Illuminate\Validation\ValidationException;
@@ -461,6 +463,14 @@ class OrderController extends Controller
             ]);
         }
 
+        // vehicle assignment
+        if ($request->has('vehicle')) {
+            $input['vehicle_assigned_uuid'] = Utils::getUuid('vehicles', [
+                'public_id'    => $request->input('vehicle'),
+                'company_uuid' => session('company'),
+            ]);
+        }
+
         // facilitator assignment
         if ($request->has('facilitator')) {
             $facilitator = Utils::getUuid(
@@ -901,7 +911,11 @@ class OrderController extends Controller
         $order->save();
 
         // trigger start event
-        event(new OrderStarted($order));
+        try {
+            event(new OrderStarted($order));
+        } catch (\Exception $e) {
+            Log::debug('Unable to complete order started event', ['error' => $e->getMessage(), 'order' => $order]);
+        }
 
         // set order as drivers current order
         $driver->current_job_uuid = $order->uuid;
@@ -1091,6 +1105,10 @@ class OrderController extends Controller
                 $activity->set('pod_method', $order->pod_method);
             }
 
+            // resolved status and details
+            $activity->set('_resolved_status', TemplateString::resolve($activity->get('status', ''), $order));
+            $activity->set('_resolved_details', TemplateString::resolve($activity->get('details', ''), $order));
+
             return $activity;
         });
 

package/server/src/Http/Controllers/Internal/v1/OrderController.php

@@ -32,6 +32,7 @@ use Fleetbase\Http\Requests\Internal\BulkDeleteRequest;
 use Fleetbase\Models\CustomFieldValue;
 use Fleetbase\Models\File;
 use Fleetbase\Models\Type;
+use Fleetbase\Support\TemplateString;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
@@ -722,20 +723,42 @@ class OrderController extends FleetOpsController
      *
      * @return \Illuminate\Http\Response
      */
-    public function nextActivity(string $id)
+    public function nextActivity(string $id, Request $request)
     {
-        $order = Order::withoutGlobalScopes()
-            ->where('uuid', $id)
-            ->orWhere('public_id', $id)
-            ->first();
+        $waypointId = $request->input('waypoint');
 
-        if (!$order) {
+        try {
+            $order = Order::findRecordOrFail($id, ['payload']);
+        } catch (ModelNotFoundException $exception) {
             return response()->error('No order found.');
         }
 
-        $nextActivities = $order->config()->nextActivity();
+        // Get waypoint record if available
+        $waypoint = null;
+        if ($waypointId) {
+            $waypoint = Waypoint::where('payload_uuid', $order->payload_uuid)->whereHas('place', function ($query) use ($waypointId) {
+                $query->where('public_id', $waypointId);
+            })->first();
+        }
+
+        $activities = $order->config()->nextActivity($waypoint);
+
+        // If activity is to complete order add proof of delivery properties if required
+        // This is a temporary fix until activity is updated to handle POD on it's own
+        $activities = $activities->map(function ($activity) use ($order) {
+            if ($activity->completesOrder() && $order->pod_required) {
+                $activity->set('require_pod', true);
+                $activity->set('pod_method', $order->pod_method);
+            }
+
+            // resolved status and details
+            $activity->set('_resolved_status', TemplateString::resolve($activity->get('status', ''), $order));
+            $activity->set('_resolved_details', TemplateString::resolve($activity->get('details', ''), $order));
+
+            return $activity;
+        });
 
-        return response()->json($nextActivities);
+        return response()->json($activities);
     }
 
     /**