@fleetbase/fleetops-engine 0.6.16 → 0.6.18

package/addon/components/layout/fleet-ops-sidebar.hbs

@@ -21,6 +21,11 @@
             @onClick={{fn this.universe.transitionMenuItem (concat this.routePrefix "virtual") menuItem}}
             @menuItem={{menuItem}}
             @icon={{menuItem.icon}}
+            @iconComponent={{menuItem.iconComponent}}
+            @iconComponentOptions={{menuItem.iconComponentOptions}}
+            @iconSize={{menuItem.iconSize}}
+            @iconPrefix={{menuItem.iconPrefix}}
+            @iconClass={{menuItem.iconClass}}
             @rightSideComponent={{menuItem.rightSideComponent}}
             @rightSideComponentContext={{menuItem.rightSideComponentContext}}
             @rightSideStatus={{menuItem.rightSideStatus}}
@@ -68,6 +73,11 @@
                     onClick=menuItem.onClick
                     route=(concat this.routePrefix menuItem.route)
                     icon=menuItem.icon
+                    iconComponent=menuItem.iconComponent
+                    iconComponentOptions=menuItem.iconComponentOptions
+                    iconSize=menuItem.iconSize
+                    iconPrefix=menuItem.iconPrefix
+                    iconClass=menuItem.iconClass
                     rightSideComponent=menuItem.rightSideComponent
                     rightSideComponentContext=menuItem.rightSideComponentContext
                     rightSideStatus=menuItem.rightSideStatus
@@ -94,6 +104,11 @@
                     @onClick={{menuItem.onClick}}
                     @route={{concat this.routePrefix menuItem.route}}
                     @icon={{menuItem.icon}}
+                    @iconComponent={{menuItem.iconComponent}}
+                    @iconComponentOptions={{menuItem.iconComponentOptions}}
+                    @iconSize={{menuItem.iconSize}}
+                    @iconPrefix={{menuItem.iconPrefix}}
+                    @iconClass={{menuItem.iconClass}}
                     @rightSideComponent={{menuItem.rightSideComponent}}
                     @rightSideComponentContext={{menuItem.rightSideComponentContext}}
                     @rightSideStatus={{menuItem.rightSideStatus}}
@@ -126,6 +141,11 @@
                         @onClick={{fn this.universe.transitionMenuItem (concat this.routePrefix "virtual") menuItem}}
                         @menuItem={{menuItem}}
                         @icon={{menuItem.icon}}
+                        @iconComponent={{menuItem.iconComponent}}
+                        @iconComponentOptions={{menuItem.iconComponentOptions}}
+                        @iconSize={{menuItem.iconSize}}
+                        @iconPrefix={{menuItem.iconPrefix}}
+                        @iconClass={{menuItem.iconClass}}
                         @rightSideComponent={{menuItem.rightSideComponent}}
                         @rightSideComponentContext={{menuItem.rightSideComponentContext}}
                         @rightSideStatus={{menuItem.rightSideStatus}}
@@ -172,6 +192,11 @@
                 @onClick={{fn this.universe.transitionMenuItem (concat this.routePrefix "virtual") menuItem}}
                 @menuItem={{menuItem}}
                 @icon={{menuItem.icon}}
+                @iconComponent={{menuItem.iconComponent}}
+                @iconComponentOptions={{menuItem.iconComponentOptions}}
+                @iconSize={{menuItem.iconSize}}
+                @iconPrefix={{menuItem.iconPrefix}}
+                @iconClass={{menuItem.iconClass}}
                 @rightSideComponent={{menuItem.rightSideComponent}}
                 @rightSideComponentContext={{menuItem.rightSideComponentContext}}
                 @rightSideStatus={{menuItem.rightSideStatus}}

package/addon/templates/virtual.hbs

@@ -1,8 +1,8 @@
 <Layout::Section::Header @title={{@model.title}} />
 
-<Layout::Section::Body class="overflow-y-scroll h-full">
-    <div class="container mx-auto h-screen">
-        <div class="max-w-3xl my-10 mx-auto space-y-">
+<Layout::Section::Body id="fleetops-virtual-body" class="overflow-y-scroll h-full">
+    <div id="fleetops-virtual-container" class="container mx-auto h-screen">
+        <div id="fleetops-virtual-wrapper" class="max-w-3xl my-10 mx-auto">
             {{component @model.component params=@model.componentParams}}
         </div>
     </div>

package/composer.json

@@ -1,6 +1,6 @@
 {
     "name": "fleetbase/fleetops-api",
-    "version": "0.6.16",
+    "version": "0.6.18",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "keywords": [
         "fleetbase-extension",
@@ -22,15 +22,16 @@
     ],
     "require": {
         "php": "^8.0",
-        "fleetbase/core-api": "*",
         "barryvdh/laravel-dompdf": "^2.0",
         "brick/geo": "0.7.2",
         "cknow/laravel-money": "^7.1",
+        "fleetbase/core-api": "*",
         "geocoder-php/google-maps-places-provider": "^1.4",
         "giggsey/libphonenumber-for-php": "^8.13",
         "league/geotools": "^1.1.0",
         "milon/barcode": "^10.0",
         "php-http/guzzle7-adapter": "^1.0",
+        "php-units-of-measure/php-units-of-measure": "^2.2",
         "psr/http-factory-implementation": "*",
         "toin0u/geocoder-laravel": "^4.4",
         "webit/eval-math": "^1.0"

package/extension.json

@@ -1,6 +1,6 @@
 {
     "name": "Fleet-Ops",
-    "version": "0.6.16",
+    "version": "0.6.18",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "repository": "https://github.com/fleetbase/fleetops",
     "license": "AGPL-3.0-or-later",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@fleetbase/fleetops-engine",
-    "version": "0.6.16",
+    "version": "0.6.18",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "fleetbase": {
         "route": "fleet-ops"

package/server/migrations/2025_08_11_170800_add_company_index_to_routes_table.php

@@ -0,0 +1,21 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        Schema::table('routes', function (Blueprint $table) {
+            $table->index(['company_uuid', 'id'], 'idx_routes_company_id');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('routes', function (Blueprint $table) {
+            $table->dropIndex('idx_routes_company_id');
+        });
+    }
+};

package/server/migrations/2025_08_28_054920_create_warranties_table.php

@@ -0,0 +1,56 @@
+<?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('warranties', 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('vendor_uuid')->nullable()->constrained('vendors', 'uuid')->nullOnDelete();
+            $table->foreignUuid('category_uuid')->nullable()->constrained('categories', 'uuid')->nullOnDelete();
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            // Covered item
+            $table->string('subject_type')->nullable();
+            $table->uuid('subject_uuid')->nullable();
+            $table->index(['subject_type', 'subject_uuid']);
+
+            $table->string('provider')->nullable()->index();    // manufacturer or third-party
+            $table->string('policy_number')->nullable()->index();
+            $table->string('type')->nullable()->index();
+
+            $table->date('start_date')->nullable()->index();
+            $table->date('end_date')->nullable()->index();
+
+            $table->json('coverage')->nullable();   // { parts: true, labor: false, roadside: true, limits: ... }
+            $table->json('terms')->nullable();      // text/structured
+            $table->text('policy')->nullable();      // text/structured
+            $table->json('meta')->nullable();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'end_date']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('warranties');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_054921_create_telematics_table.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::create('telematics', 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();          // optional label
+            $table->string('provider')->nullable()->index();       // samsara, geotab, custom, etc.
+            $table->string('model')->nullable();
+            $table->string('serial_number')->nullable()->index();
+            $table->string('firmware_version')->nullable();
+            $table->string('status')->default('active')->index();  // active, inactive
+
+            // Connectivity identifiers
+            $table->string('imei')->nullable()->index();
+            $table->string('iccid')->nullable()->index();
+            $table->string('imsi')->nullable()->index();
+            $table->string('msisdn')->nullable()->index();
+            $table->string('type')->nullable()->index();
+
+            // Last heartbeat / metrics
+            $table->json('last_metrics')->nullable();              // { lat, lng, speed, heading, temp, ... }
+
+            $table->json('config')->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->foreignUuid('warranty_uuid')->nullable()->constrained('warranties', 'uuid')->nullOnDelete();
+
+            $table->timestamp('last_seen_at')->nullable()->index();
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'provider']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('telematics');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_054922_create_assets_table.php

@@ -0,0 +1,94 @@
+<?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('assets', 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();
+
+            // Asset operator - can be vendor, contact, driver, user
+            $table->string('operator_type')->nullable();
+            $table->uuid('operator_uuid')->nullable();
+            $table->index(['operator_type', 'operator_uuid']);
+
+            // Asset assigned to - can be vendor, contact, driver, user
+            $table->string('assigned_to_type')->nullable();
+            $table->uuid('assigned_to_uuid')->nullable();
+            $table->index(['assigned_to_type', 'assigned_to_uuid']);
+
+            $table->string('name')->index();
+            $table->string('code')->nullable()->index();          // human code / fleet tag
+            $table->string('type')->nullable()->index();          // vehicle, trailer, container, drone, etc.
+            $table->string('status')->default('active')->index(); // active, inactive, retired, maintenance
+            $table->point('location')->nullable();
+            $table->string('speed')->nullable();
+            $table->string('heading')->nullable();
+            $table->string('altitude')->nullable();
+
+            // Financial Tracking
+            $table->integer('acquisition_cost')->nullable();
+            $table->integer('current_value')->nullable();
+            $table->integer('depreciation_rate')->nullable(); // -- Annual percentage
+            $table->integer('insurance_value')->nullable();
+            $table->string('currency')->nullable();
+            $table->string('financing_status')->nullable(); // -- owned, leased, financed
+            $table->date('lease_expires_at')->nullable()->index();
+
+            // Identity / registration
+            $table->string('vin')->nullable()->index();
+            $table->string('plate_number')->nullable()->index();
+            $table->string('make')->nullable();
+            $table->string('model')->nullable();
+            $table->unsignedSmallInteger('year')->nullable();
+            $table->string('color')->nullable();
+            $table->string('serial_number')->nullable()->index();
+            $table->string('call_sign')->nullable()->index();
+            $table->string('slug')->nullable()->index();
+
+            // Attachments & relations
+            $table->foreignUuid('vendor_uuid')->nullable()->constrained('vendors', 'uuid')->nullOnDelete();
+            $table->foreignUuid('current_place_uuid')->nullable()->constrained('places', 'uuid')->nullOnDelete();
+            $table->foreignUuid('telematic_uuid')->nullable()->constrained('telematics', 'uuid')->nullOnDelete();
+
+            // Operational attributes
+            $table->unsignedBigInteger('odometer')->nullable();     // in meters or units you prefer
+            $table->unsignedBigInteger('engine_hours')->nullable();
+            $table->decimal('gvw', 10, 2)->nullable();               // gross vehicle weight
+            $table->json('capacity')->nullable();                    // e.g. { volume_l:..., payload_kg:... }
+            $table->json('specs')->nullable();                       // arbitrary spec map
+            $table->json('attributes')->nullable();                  // freeform tags/flags
+
+            // Ownership, auditing
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('warranty_uuid')->nullable()->constrained('warranties', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'status']);
+            $table->unique(['company_uuid', 'code']); // ensure human code unique per company
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('assets');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2025_08_28_054925_create_devices_table.php

@@ -0,0 +1,190 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        // Rename legacy table if it exists
+        if (Schema::hasTable('vehicle_devices') && !Schema::hasTable('devices')) {
+            Schema::rename('vehicle_devices', 'devices');
+        }
+
+        // Bail out if the destination table still doesn't exist for some reason
+        if (!Schema::hasTable('devices')) {
+            return;
+        }
+
+        // Add/align new columns (guard each add with hasColumn)
+        Schema::table('devices', function (Blueprint $table) {
+            // warranty_uuid
+            if (!Schema::hasColumn('devices', 'warranty_uuid')) {
+                $table->foreignUuid('warranty_uuid')->after('uuid')->nullable()->constrained('warranties', 'uuid')->nullOnDelete();
+            }
+
+            // telematic_uuid (1:1 to telematics.uuid)
+            if (!Schema::hasColumn('devices', 'telematic_uuid')) {
+                $table->foreignUuid('telematic_uuid')->after('uuid')->nullable()->constrained('telematics', 'uuid')->nullOnDelete();
+            }
+
+            // lifecycle / telemetry
+            if (!Schema::hasColumn('devices', 'last_online_at')) {
+                $table->timestamp('last_online_at')->after('notes')->nullable()->index();
+            }
+
+            // polymorphic attachment: attachable_type + attachable_uuid (UUID)
+            if (!Schema::hasColumn('devices', 'attachable_type') && !Schema::hasColumn('devices', 'attachable_uuid')) {
+                $table->string('attachable_type')->after('telematic_uuid')->nullable();
+                $table->uuid('attachable_uuid')->after('telematic_uuid')->nullable();
+                $table->index(['attachable_type', 'attachable_uuid']);
+            }
+
+            // meta/options blobs (order doesn’t matter; avoid AFTER to keep this migration portable)
+            if (!Schema::hasColumn('devices', 'meta')) {
+                $table->json('meta')->nullable();
+            }
+
+            if (!Schema::hasColumn('devices', 'options')) {
+                $table->json('options')->nullable()->after('meta');
+            }
+
+            if (!Schema::hasColumn('devices', 'slug')) {
+                $table->string('slug')->nullable()->index()->after('status');
+            }
+
+            if (!Schema::hasColumn('devices', '_key')) {
+                $table->string('_key')->nullable()->index()->after('uuid');
+            }
+        });
+
+        // Data migration: vehicle_uuid → attachable (Vehicle)
+        if (Schema::hasColumn('devices', 'vehicle_uuid')) {
+            // Move values (MySQL/MariaDB & PostgreSQL compatible form)
+            // - For MySQL: backslashes in class name must be doubled in SQL string literal
+            $vehicleModel = 'Fleetbase\\\\FleetOps\\\\Models\\\\Vehicle';
+
+            // Use raw SQL to assign attachable_id from vehicle_uuid in one pass
+            // MySQL / MariaDB
+            if ($this->isMySql()) {
+                DB::statement("
+                    UPDATE `devices`
+                    SET `attachable_type` = '{$vehicleModel}',
+                        `attachable_uuid` = `vehicle_uuid`
+                    WHERE `vehicle_uuid` IS NOT NULL
+                ");
+            } else {
+                // PostgreSQL / others (no backticks)
+                $vehicleModelPg = 'Fleetbase\\FleetOps\\Models\\Vehicle';
+                DB::statement("
+                    UPDATE devices
+                    SET attachable_type = '{$vehicleModelPg}',
+                        attachable_uuid = vehicle_uuid
+                    WHERE vehicle_uuid IS NOT NULL
+                ");
+            }
+
+            // Drop the old column now that data is migrated
+            Schema::table('devices', function (Blueprint $table) {
+                if (Schema::hasColumn('devices', 'vehicle_uuid')) {
+                    $table->dropForeign('vehicle_devices_vehicle_uuid_foreign');
+                    $table->dropColumn('vehicle_uuid');
+                }
+            });
+        }
+    }
+
+    public function down(): void
+    {
+        // If devices table doesn't exist, nothing to do
+        if (!Schema::hasTable('devices')) {
+            return;
+        }
+
+        // Re-introduce vehicle_uuid to reverse the migration
+        Schema::table('devices', function (Blueprint $table) {
+            if (!Schema::hasColumn('devices', 'vehicle_uuid')) {
+                $table->uuid('vehicle_uuid')->after('uuid')->nullable();
+            }
+        });
+
+        // Move back attachable → vehicle_uuid where it was a Vehicle
+        $vehicleModelSqlMy = 'Fleetbase\\\\FleetOps\\\\Models\\\\Vehicle';
+        $vehicleModelSqlPg = 'Fleetbase\\FleetOps\\Models\\Vehicle';
+
+        if ($this->isMySql()) {
+            DB::statement("
+                UPDATE `devices`
+                SET `vehicle_uuid` = `attachable_uuid`
+                WHERE `attachable_type` = '{$vehicleModelSqlMy}'
+            ");
+        } else {
+            DB::statement("
+                UPDATE devices
+                SET vehicle_uuid = attachable_uuid
+                WHERE attachable_type = '{$vehicleModelSqlPg}'
+            ");
+        }
+
+        // Drop new columns added in up()
+        Schema::table('devices', function (Blueprint $table) {
+            // Drop FKs before columns if present
+            if (Schema::hasColumn('devices', 'telematic_uuid')) {
+                // fallback: FK name is unknown; attempt generic drop then column
+                try {
+                    $table->dropForeign(['telematic_uuid']);
+                } catch (Throwable $e) {
+                }
+                $table->dropColumn('telematic_uuid');
+            }
+
+            // Drop FKs before columns if present
+            if (Schema::hasColumn('devices', 'warranty_uuid')) {
+                // fallback: FK name is unknown; attempt generic drop then column
+                try {
+                    $table->dropForeign(['warranty_uuid']);
+                } catch (Throwable $e) {
+                }
+                $table->dropColumn('warranty_uuid');
+            }
+
+            if (Schema::hasColumn('devices', 'last_online_at')) {
+                $table->dropColumn('last_online_at');
+            }
+
+            if (Schema::hasColumn('devices', 'attachable_type') || Schema::hasColumn('devices', 'attachable_uuid')) {
+                $table->dropColumn('attachable_uuid');
+                $table->dropColumn('attachable_type');
+            }
+
+            if (Schema::hasColumn('devices', 'options')) {
+                $table->dropColumn('options');
+            }
+            if (Schema::hasColumn('devices', 'meta')) {
+                $table->dropColumn('meta');
+            }
+        });
+
+        // Rename devices back to vehicle_devices if that table does not already exist
+        if (!Schema::hasTable('vehicle_devices') && Schema::hasTable('devices')) {
+            Schema::rename('devices', 'vehicle_devices');
+            Schema::table('vehicle_devices', function (Blueprint $table) {
+                if (Schema::hasColumn('vehicle_devices', 'vehicle_uuid')) {
+                    $table->foreign(['vehicle_uuid'])->references('uuid')->on('vehicles')->cascadeOnDelete();
+                }
+            });
+            Schema::table('vehicle_device_events', function (Blueprint $table) {
+                if (Schema::hasColumn('vehicle_device_events', 'vehicle_device_uuid')) {
+                    $table->foreign(['vehicle_device_uuid'])->references('uuid')->on('vehicle_devices')->cascadeOnDelete();
+                }
+            });
+        }
+    }
+
+    private function isMySql(): bool
+    {
+        return in_array(DB::getDriverName(), ['mysql', 'mariadb']);
+    }
+};

package/server/migrations/2025_08_28_054926_create_device_events_table.php

@@ -0,0 +1,99 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        // Rename legacy table if needed
+        if (Schema::hasTable('vehicle_device_events') && !Schema::hasTable('device_events')) {
+            Schema::rename('vehicle_device_events', 'device_events');
+        }
+
+        if (!Schema::hasTable('device_events')) {
+            // Nothing to do if the table doesn't exist
+            return;
+        }
+
+        // Add device_uuid FK (many events per device; do NOT make it unique)
+        Schema::table('device_events', function (Blueprint $table) {
+            if (!Schema::hasColumn('device_events', 'device_uuid')) {
+                $table->foreignUuid('device_uuid')->after('uuid')->nullable()->constrained('devices', 'uuid')->cascadeOnDelete();
+            }
+
+            if (!Schema::hasColumn('device_events', 'event_type')) {
+                $table->string('event_type')->after('ident')->nullable();
+            }
+
+            if (!Schema::hasColumn('device_events', 'severity')) {
+                $table->string('severity')->after('ident')->nullable();
+            }
+
+            if (!Schema::hasColumn('device_events', '_key')) {
+                $table->string('_key')->after('uuid')->nullable()->index();
+            }
+        });
+
+        // Migrate data: vehicle_device_uuid -> device_uuid (if legacy column exists)
+        if (Schema::hasColumn('device_events', 'vehicle_device_uuid')) {
+            // Copy values in one pass
+            DB::table('device_events')
+                ->whereNotNull('vehicle_device_uuid')
+                ->update([
+                    'device_uuid' => DB::raw('vehicle_device_uuid'),
+                ]);
+
+            // Drop legacy column after successful copy
+            Schema::table('device_events', function (Blueprint $table) {
+                if (Schema::hasColumn('device_events', 'vehicle_device_uuid')) {
+                    $table->dropForeign('vehicle_device_events_vehicle_device_uuid_foreign');
+                    $table->dropColumn('vehicle_device_uuid');
+                }
+            });
+        }
+    }
+
+    public function down(): void
+    {
+        if (!Schema::hasTable('device_events')) {
+            return;
+        }
+
+        // 1) Re-introduce legacy column
+        Schema::table('device_events', function (Blueprint $table) {
+            if (!Schema::hasColumn('device_events', 'vehicle_device_uuid')) {
+                $table->uuid('vehicle_device_uuid')->nullable();
+            }
+        });
+
+        // 2) Move data back where present
+        if (Schema::hasColumn('device_events', 'device_uuid')) {
+            DB::table('device_events')
+                ->whereNotNull('device_uuid')
+                ->update([
+                    'vehicle_device_uuid' => DB::raw('device_uuid'),
+                ]);
+        }
+
+        // 3) Drop new FK/column
+        Schema::table('device_events', function (Blueprint $table) {
+            if (Schema::hasColumn('device_events', 'device_uuid')) {
+                // Drop FK safely when possible
+                // fallback: FK name is unknown; attempt generic drop then column
+                try {
+                    $table->dropForeign(['device_uuid']);
+                } catch (Throwable $e) {
+                }
+                $table->dropColumn('device_uuid');
+            }
+        });
+
+        // 4) Rename table back if the old name doesn't exist
+        if (!Schema::hasTable('vehicle_device_events') && Schema::hasTable('device_events')) {
+            Schema::rename('device_events', 'vehicle_device_events');
+        }
+    }
+};