@fleetbase/fleetops-engine 0.6.48 → 0.6.50

package/server/seeders/Testing/NetworkSeeder.php

@@ -0,0 +1,250 @@
+<?php
+
+namespace Fleetbase\FleetOps\Seeders\Testing;
+
+use Fleetbase\FleetOps\Models\Contact;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\ServiceArea;
+use Fleetbase\FleetOps\Models\ServiceRate;
+use Fleetbase\FleetOps\Models\ServiceRateFee;
+use Fleetbase\FleetOps\Models\Vendor;
+use Fleetbase\FleetOps\Models\Zone;
+use Fleetbase\FleetOps\Seeders\Testing\Concerns\SeedsTestingData;
+use Fleetbase\FleetOps\Support\FleetOps;
+use Fleetbase\Models\Company;
+use Illuminate\Database\Seeder;
+use Illuminate\Support\Facades\DB;
+
+class NetworkSeeder extends Seeder
+{
+    use SeedsTestingData;
+
+    public function run(): void
+    {
+        $company = $this->prepareCompany();
+        if (!$company) {
+            return;
+        }
+
+        DB::transaction(function () use ($company) {
+            $this->purgeSeedData();
+            FleetOps::createTransportConfig($company);
+            $this->seedServiceAreas($company);
+            $this->seedZones($company);
+            $places = $this->seedPlaces($company);
+            $this->seedContacts($company, $places);
+            $vendors = $this->seedVendors($company, $places);
+            $this->seedServiceRates($company, $vendors);
+
+            $this->command?->info('Seeded FleetOps testing network fixtures for company: ' . $company->public_id);
+        });
+    }
+
+    public function purgeSeedData(): void
+    {
+        $this->purgeModel(ServiceRateFee::class);
+        $this->purgeModel(ServiceRate::class);
+        $this->purgeModel(Vendor::class);
+        $this->purgeModel(Contact::class);
+        $this->purgeModel(Place::class);
+        $this->purgeModel(Zone::class);
+        $this->purgeModel(ServiceArea::class);
+    }
+
+    protected function seedServiceAreas(Company $company): void
+    {
+        $areas = [
+            'central_service_area' => [
+                'name'   => 'Singapore Central',
+                'border' => [[1.2700, 103.8000], [1.2700, 103.9100], [1.3600, 103.9100], [1.3600, 103.8000]],
+                'color'  => '#2563eb',
+            ],
+            'east_service_area' => [
+                'name'   => 'Singapore East',
+                'border' => [[1.3050, 103.9000], [1.3050, 104.0200], [1.3950, 104.0200], [1.3950, 103.9000]],
+                'color'  => '#059669',
+            ],
+        ];
+
+        foreach ($areas as $seedId => $area) {
+            $this->createRecord(ServiceArea::class, [
+                '_key'                    => $this->fixtureKey($seedId),
+                'company_uuid'            => $company->uuid,
+                'name'                    => $area['name'],
+                'type'                    => 'city',
+                'country'                 => 'SG',
+                'border'                  => $this->multiPolygon($area['border']),
+                'color'                   => $area['color'],
+                'stroke_color'            => $area['color'],
+                'status'                  => 'active',
+                'trigger_on_entry'        => true,
+                'trigger_on_exit'         => true,
+                'dwell_threshold_minutes' => 15,
+                'speed_limit_kmh'         => 50,
+            ]);
+        }
+    }
+
+    protected function seedZones(Company $company): void
+    {
+        $zones = [
+            'cbd_zone' => [
+                'service_area' => 'central_service_area',
+                'name'         => 'Marina Bay',
+                'border'       => [[1.2760, 103.8350], [1.2760, 103.8650], [1.3050, 103.8650], [1.3050, 103.8350]],
+                'color'        => '#7c3aed',
+            ],
+            'airport_zone' => [
+                'service_area' => 'east_service_area',
+                'name'         => 'Changi',
+                'border'       => [[1.3350, 103.9600], [1.3350, 104.0100], [1.3850, 104.0100], [1.3850, 103.9600]],
+                'color'        => '#dc2626',
+            ],
+            'warehouse_zone' => [
+                'service_area' => 'central_service_area',
+                'name'         => 'Jurong',
+                'border'       => [[1.3000, 103.7800], [1.3000, 103.8300], [1.3450, 103.8300], [1.3450, 103.7800]],
+                'color'        => '#ea580c',
+            ],
+        ];
+
+        foreach ($zones as $seedId => $zone) {
+            $serviceArea = $this->seededServiceArea($zone['service_area']);
+            $this->createRecord(Zone::class, [
+                '_key'                    => $this->fixtureKey($seedId),
+                'company_uuid'            => $company->uuid,
+                'service_area_uuid'       => $serviceArea?->uuid,
+                'name'                    => $zone['name'],
+                'description'             => 'Fixture zone for FleetOps testing assertions.',
+                'border'                  => $this->polygon($zone['border']),
+                'color'                   => $zone['color'],
+                'stroke_color'            => $zone['color'],
+                'status'                  => 'active',
+                'trigger_on_entry'        => true,
+                'trigger_on_exit'         => true,
+                'dwell_threshold_minutes' => 10,
+                'speed_limit_kmh'         => 40,
+            ]);
+        }
+    }
+
+    protected function seedPlaces(Company $company): array
+    {
+        $places = [
+            'central_depot' => ['Raffles Quay', '1 Raffles Quay', 'Singapore', 'SG', 1.2816, 103.8510],
+            'west_depot'    => ['Jurong East', '2 Jurong East Street 21', 'Singapore', 'SG', 1.3345, 103.7420],
+            'airport_hub'   => ['Changi Airfreight', '80 Airport Boulevard', 'Singapore', 'SG', 1.3644, 103.9915],
+            'orchard_store' => ['ION Orchard', '2 Orchard Turn', 'Singapore', 'SG', 1.3048, 103.8318],
+            'rochor_store'  => ['Rochor Canal', '1 Rochor Canal Road', 'Singapore', 'SG', 1.3039, 103.8520],
+            'tampines_store'=> ['Tampines Mall', '4 Tampines Central 5', 'Singapore', 'SG', 1.3525, 103.9447],
+        ];
+
+        $models = [];
+        foreach ($places as $seedId => [$name, $street1, $city, $country, $lat, $lng]) {
+            $models[$seedId] = $this->createRecord(Place::class, [
+                '_key'         => $this->fixtureKey($seedId),
+                'company_uuid' => $company->uuid,
+                'name'         => $name,
+                'street1'      => $street1,
+                'city'         => $city,
+                'country'      => $country,
+                'location'     => $this->point($lat, $lng),
+                'meta'         => $this->meta($seedId),
+            ]);
+        }
+
+        return $models;
+    }
+
+    protected function seedContacts(Company $company, array $places): void
+    {
+        $contacts = [
+            'customer_alice' => ['Alice Tan', 'customer', 'alice.testing@example.test', '+6591000001', 'orchard_store'],
+            'customer_ben'   => ['Ben Lim', 'customer', 'ben.testing@example.test', '+6591000002', 'rochor_store'],
+            'ops_manager'    => ['Nadia Rahman', 'contact', 'nadia.testing@example.test', '+6591000003', 'central_depot'],
+        ];
+
+        foreach ($contacts as $seedId => [$name, $type, $email, $phone, $placeSeedId]) {
+            $this->createRecord(Contact::class, [
+                '_key'         => $this->fixtureKey($seedId),
+                'company_uuid' => $company->uuid,
+                'place_uuid'   => $places[$placeSeedId]?->uuid,
+                'name'         => $name,
+                'title'        => $type === 'customer' ? 'Receiving Contact' : 'Operations Manager',
+                'email'        => $email,
+                'phone'        => $phone,
+                'type'         => $type,
+                'notes'        => 'FleetOps testing fixture contact.',
+                'meta'         => $this->meta($seedId),
+            ]);
+        }
+    }
+
+    protected function seedVendors(Company $company, array $places): array
+    {
+        $vendors = [
+            'facilitator_fastline' => ['Fastline Logistics', 'facilitator', 'ops@fastline.example.test', '+6592000001', 'central_depot'],
+            'supplier_parts'       => ['Apex Parts Supply', 'supplier', 'parts@example.test', '+6592000002', 'west_depot'],
+        ];
+
+        $models = [];
+        foreach ($vendors as $seedId => [$name, $type, $email, $phone, $placeSeedId]) {
+            $models[$seedId] = $this->createRecord(Vendor::class, [
+                '_key'         => $this->fixtureKey($seedId),
+                'company_uuid' => $company->uuid,
+                'place_uuid'   => $places[$placeSeedId]?->uuid,
+                'name'         => $name,
+                'email'        => $email,
+                'phone'        => $phone,
+                'country'      => 'SG',
+                'status'       => 'active',
+                'type'         => $type,
+                'notes'        => 'FleetOps testing fixture vendor.',
+                'meta'         => $this->meta($seedId),
+            ]);
+        }
+
+        return $models;
+    }
+
+    protected function seedServiceRates(Company $company, array $vendors): void
+    {
+        $orderConfig = FleetOps::createTransportConfig($company);
+        $rates       = [
+            'same_day_cbd'    => ['Same Day CBD', 'same_day', 'central_service_area', 'cbd_zone', 1200, 120, 1],
+            'airport_express' => ['Airport Express', 'express', 'east_service_area', 'airport_zone', 2800, 180, 0],
+        ];
+
+        foreach ($rates as $seedId => [$name, $type, $areaSeedId, $zoneSeedId, $baseFee, $perMeter, $estimatedDays]) {
+            $serviceRate = $this->createRecord(ServiceRate::class, [
+                '_key'                    => $this->fixtureKey($seedId),
+                'company_uuid'            => $company->uuid,
+                'service_area_uuid'       => $this->seededServiceArea($areaSeedId)?->uuid,
+                'zone_uuid'               => $this->seededZone($zoneSeedId)?->uuid,
+                'order_config_uuid'       => $orderConfig->uuid,
+                'service_name'            => $name,
+                'service_type'            => $type,
+                'base_fee'                => $baseFee,
+                'per_meter_flat_rate_fee' => $perMeter,
+                'per_meter_unit'          => 'm',
+                'algorithm'               => 'fixed_meter',
+                'rate_calculation_method' => 'fixed_meter',
+                'currency'                => 'SGD',
+                'duration_terms'          => 'days',
+                'estimated_days'          => $estimatedDays,
+            ]);
+
+            foreach ([['parcel', 1, 5, 400], ['parcel', 6, 20, 900]] as $index => [$unit, $min, $max, $fee]) {
+                $this->createRecord(ServiceRateFee::class, [
+                    '_key'              => $this->fixtureKey($seedId . '_fee_' . ($index + 1)),
+                    'service_rate_uuid' => $serviceRate->uuid,
+                    'min'               => $min,
+                    'max'               => $max,
+                    'unit'              => $unit,
+                    'fee'               => $fee,
+                    'currency'          => 'SGD',
+                ]);
+            }
+        }
+    }
+}

package/server/seeders/Testing/OrdersSeeder.php

@@ -0,0 +1,198 @@
+<?php
+
+namespace Fleetbase\FleetOps\Seeders\Testing;
+
+use Fleetbase\FleetOps\Models\Contact;
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Entity;
+use Fleetbase\FleetOps\Models\Order;
+use Fleetbase\FleetOps\Models\Payload;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\TrackingNumber;
+use Fleetbase\FleetOps\Models\TrackingStatus;
+use Fleetbase\FleetOps\Models\Vehicle;
+use Fleetbase\FleetOps\Models\Vendor;
+use Fleetbase\FleetOps\Models\Waypoint;
+use Fleetbase\FleetOps\Seeders\Testing\Concerns\SeedsTestingData;
+use Fleetbase\FleetOps\Support\FleetOps;
+use Fleetbase\Models\Company;
+use Fleetbase\Models\User;
+use Illuminate\Database\Seeder;
+use Illuminate\Support\Facades\DB;
+
+class OrdersSeeder extends Seeder
+{
+    use SeedsTestingData;
+
+    public function run(): void
+    {
+        $company = $this->prepareCompany();
+        if (!$company) {
+            return;
+        }
+
+        DB::transaction(function () use ($company) {
+            $this->purgeSeedData();
+            $this->seedOrders($company);
+
+            $this->command?->info('Seeded FleetOps testing order fixtures for company: ' . $company->public_id);
+        });
+    }
+
+    public function purgeSeedData(): void
+    {
+        $this->purgeModel(TrackingStatus::class);
+        $this->purgeModel(Order::class);
+        $this->purgeModel(Entity::class);
+        $this->purgeModel(Waypoint::class);
+        $this->purgeModel(TrackingNumber::class);
+        $this->purgeModel(Payload::class);
+    }
+
+    protected function seedOrders(Company $company): void
+    {
+        $places = [
+            'central_depot'  => $this->seededModel(Place::class, 'central_depot'),
+            'west_depot'     => $this->seededModel(Place::class, 'west_depot'),
+            'airport_hub'    => $this->seededModel(Place::class, 'airport_hub'),
+            'orchard_store'  => $this->seededModel(Place::class, 'orchard_store'),
+            'rochor_store'   => $this->seededModel(Place::class, 'rochor_store'),
+            'tampines_store' => $this->seededModel(Place::class, 'tampines_store'),
+        ];
+        $customers = [
+            'customer_alice' => $this->seededModel(Contact::class, 'customer_alice'),
+            'customer_ben'   => $this->seededModel(Contact::class, 'customer_ben'),
+        ];
+        $drivers = [
+            'driver_ava' => $this->seededModel(Driver::class, 'driver_ava'),
+            'driver_ken' => $this->seededModel(Driver::class, 'driver_ken'),
+        ];
+        $vehicles = [
+            'van_central' => $this->seededModel(Vehicle::class, 'van_central'),
+            'van_east'    => $this->seededModel(Vehicle::class, 'van_east'),
+        ];
+        $facilitator = $this->seededModel(Vendor::class, 'facilitator_fastline');
+        $dispatcher  = $this->seededModel(User::class, 'dispatcher_user');
+        $orderConfig = FleetOps::createTransportConfig($company);
+
+        $orders = [
+            'order_created_unassigned' => ['created', null, null, 'customer_alice', 'central_depot', 'orchard_store', [], 2, 1, null, false, false],
+            'order_scheduled'          => ['created', null, null, 'customer_ben', 'west_depot', 'rochor_store', [], 4, 1, $this->timestamp(30), false, false],
+            'order_dispatched'         => ['dispatched', 'driver_ava', 'van_central', 'customer_alice', 'central_depot', 'orchard_store', ['rochor_store'], 6, 2, null, true, false],
+            'order_started'            => ['started', 'driver_ken', 'van_east', 'customer_ben', 'airport_hub', 'tampines_store', [], 8, 1, null, true, true],
+            'order_completed'          => ['completed', 'driver_ava', 'van_central', 'customer_alice', 'central_depot', 'orchard_store', [], -4, 1, null, true, true],
+            'order_canceled'           => ['canceled', null, null, 'customer_ben', 'central_depot', 'rochor_store', [], -2, 1, null, false, false],
+            'order_vehicle_assigned'   => ['created', null, 'van_central', 'customer_alice', 'west_depot', 'airport_hub', ['orchard_store', 'rochor_store'], 10, 3, null, false, false],
+        ];
+
+        foreach ($orders as $seedId => [$status, $driverSeedId, $vehicleSeedId, $customerSeedId, $pickupSeedId, $dropoffSeedId, $waypointSeedIds, $hourOffset, $entityCount, $scheduledAt, $dispatched, $started]) {
+            $payload = $this->createPayload($company, $seedId, $places[$pickupSeedId], $places[$dropoffSeedId], array_map(fn ($placeSeedId) => $places[$placeSeedId], $waypointSeedIds));
+            $order   = $this->createRecord(Order::class, [
+                '_key'                  => $this->fixtureKey($seedId),
+                'internal_id'           => 'TEST-' . strtoupper(str_replace('order_', '', $seedId)),
+                'company_uuid'          => $company->uuid,
+                'payload_uuid'          => $payload->uuid,
+                'order_config_uuid'     => $orderConfig->uuid,
+                'customer_uuid'         => $customers[$customerSeedId]?->uuid,
+                'customer_type'         => Contact::class,
+                'facilitator_uuid'      => $facilitator?->uuid,
+                'facilitator_type'      => Vendor::class,
+                'driver_assigned_uuid'  => $driverSeedId ? $drivers[$driverSeedId]?->uuid : null,
+                'vehicle_assigned_uuid' => $vehicleSeedId ? $vehicles[$vehicleSeedId]?->uuid : null,
+                'created_by_uuid'       => $dispatcher?->uuid,
+                'updated_by_uuid'       => $dispatcher?->uuid,
+                'scheduled_at'          => $scheduledAt,
+                'dispatched_at'         => $dispatched ? $this->timestamp($hourOffset) : null,
+                'dispatched'            => $dispatched,
+                'started'               => $started,
+                'started_at'            => $started ? $this->timestamp($hourOffset + 1) : null,
+                'type'                  => 'transport',
+                'status'                => $status,
+                'notes'                 => 'FleetOps testing fixture order: ' . $seedId,
+                'pod_method'            => 'scan',
+                'pod_required'          => $status === 'completed',
+                'orchestrator_priority' => 50,
+                'required_skills'       => $vehicleSeedId === 'van_east' ? ['cold_chain'] : [],
+                'meta'                  => $this->meta($seedId),
+                'created_at'            => $this->timestamp($hourOffset),
+                'updated_at'            => $this->timestamp($hourOffset + 1),
+            ]);
+
+            $trackingNumber = $this->createTrackingNumber($company, $order, $seedId);
+            $order->forceFill(['tracking_number_uuid' => $trackingNumber->uuid])->save();
+            $this->seedEntities($company, $payload, $trackingNumber, $seedId, $entityCount, $places[$dropoffSeedId]);
+        }
+    }
+
+    protected function createPayload(Company $company, string $seedId, ?Place $pickup, ?Place $dropoff, array $waypoints): Payload
+    {
+        /** @var Payload $payload */
+        $payload = $this->createRecord(Payload::class, [
+            '_key'         => $this->fixtureKey($seedId . '_payload'),
+            'company_uuid' => $company->uuid,
+            'pickup_uuid'  => $pickup?->uuid,
+            'dropoff_uuid' => $dropoff?->uuid,
+            'type'         => 'transport',
+            'meta'         => $this->meta($seedId . '_payload'),
+        ]);
+
+        foreach ($waypoints as $index => $place) {
+            $this->createRecord(Waypoint::class, [
+                '_key'         => $this->fixtureKey($seedId . '_waypoint_' . ($index + 1)),
+                '_import_id'   => $this->fixtureKey($seedId . ':waypoint:' . ($index + 1)),
+                'company_uuid' => $company->uuid,
+                'payload_uuid' => $payload->uuid,
+                'place_uuid'   => $place?->uuid,
+                'type'         => 'dropoff',
+                'order'        => $index + 1,
+                'service_time' => 300,
+                'notes'        => 'FleetOps testing waypoint.',
+            ]);
+        }
+
+        return $payload;
+    }
+
+    protected function createTrackingNumber(Company $company, Order $order, string $seedId): TrackingNumber
+    {
+        /** @var TrackingNumber $trackingNumber */
+        $trackingNumber = $this->createRecord(TrackingNumber::class, [
+            '_key'            => $this->fixtureKey($seedId . '_tracking'),
+            'company_uuid'    => $company->uuid,
+            'owner_uuid'      => $order->uuid,
+            'owner_type'      => Order::class,
+            'tracking_number' => 'TEST-' . str_pad((string) crc32($seedId), 10, '0', STR_PAD_LEFT),
+            'region'          => 'SG',
+        ]);
+
+        return $trackingNumber;
+    }
+
+    protected function seedEntities(Company $company, Payload $payload, TrackingNumber $trackingNumber, string $seedId, int $entityCount, ?Place $destination): void
+    {
+        for ($i = 1; $i <= $entityCount; $i++) {
+            $this->createRecord(Entity::class, [
+                '_key'                 => $this->fixtureKey($seedId . '_entity_' . $i),
+                '_import_id'           => $this->fixtureKey($seedId . ':entity:' . $i),
+                'public_id'            => Entity::generatePublicId(),
+                'company_uuid'         => $company->uuid,
+                'payload_uuid'         => $payload->uuid,
+                'tracking_number_uuid' => $trackingNumber->uuid,
+                'destination_uuid'     => $destination?->uuid,
+                'internal_id'          => 'TEST-ENTITY-' . strtoupper($seedId) . '-' . $i,
+                'name'                 => 'Item ' . $i,
+                'type'                 => 'parcel',
+                'description'          => 'FleetOps testing fixture entity.',
+                'weight'               => 5 + $i,
+                'weight_unit'          => 'kg',
+                'length'               => 40,
+                'width'                => 30,
+                'height'               => 20,
+                'dimensions_unit'      => 'cm',
+                'currency'             => 'SGD',
+                'declared_value'       => 1000 + ($i * 100),
+                'meta'                 => $this->meta($seedId . '_entity_' . $i),
+            ], true);
+        }
+    }
+}

package/server/seeders/Testing/TestingSeeder.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace Fleetbase\FleetOps\Seeders\Testing;
+
+use Illuminate\Database\Seeder;
+use Illuminate\Support\Facades\Schema;
+
+class TestingSeeder extends Seeder
+{
+    public function run(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        try {
+            $this->purgeSeedData();
+        } finally {
+            Schema::enableForeignKeyConstraints();
+        }
+
+        $this->call([
+            NetworkSeeder::class,
+            FleetSeeder::class,
+            OrdersSeeder::class,
+            ConnectivitySeeder::class,
+            MaintenanceSeeder::class,
+        ]);
+    }
+
+    protected function purgeSeedData(): void
+    {
+        foreach ([
+            new MaintenanceSeeder(),
+            new ConnectivitySeeder(),
+            new OrdersSeeder(),
+            new FleetSeeder(),
+            new NetworkSeeder(),
+        ] as $seeder) {
+            $seeder->purgeSeedData();
+        }
+    }
+}

package/server/seeders/{VroomOrchestrationSeeder.php → Testing/VroomOrchestrationSeeder.php}

@@ -1,6 +1,6 @@
 <?php
 
-namespace Fleetbase\FleetOps\Seeders;
+namespace Fleetbase\FleetOps\Seeders\Testing;
 
 use Fleetbase\FleetOps\Models\Entity;
 use Fleetbase\FleetOps\Models\Order;
@@ -15,6 +15,13 @@ use Illuminate\Database\Seeder;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
 
+/**
+ * Explicit test-data seeder. Kept below server/seeders/Testing so fleetbase:seed
+ * does not auto-discover it during deploys.
+ *
+ * Run with:
+ * php artisan db:seed --class="Fleetbase\\FleetOps\\Seeders\\Testing\\VroomOrchestrationSeeder"
+ */
 class VroomOrchestrationSeeder extends Seeder
 {
     use ResolvesSeedCompany;
@@ -250,7 +257,7 @@ class VroomOrchestrationSeeder extends Seeder
                 'model'                    => $vehicle['model'],
                 'year'                     => '2024',
                 'type'                     => 'van',
-                'status'                   => 'active',
+                'status'                   => 'available',
                 'online'                   => true,
                 'location'                 => isset($vehicle['lat'], $vehicle['lng']) ? new Point($vehicle['lat'], $vehicle['lng']) : null,
                 'skills'                   => $vehicle['skills'] ?? [],
@@ -280,22 +287,22 @@ class VroomOrchestrationSeeder extends Seeder
         $orders = [
             'endpoint_only' => [
                 'payload_seed_id' => 'endpoint_only',
-                'name'       => 'VROOM Test Order - Pickup Dropoff',
-                'pickup'     => $places['depot'],
-                'dropoff'    => $places['orchard'],
-                'waypoints'  => [],
-                'entities'   => [
+                'name'            => 'VROOM Test Order - Pickup Dropoff',
+                'pickup'          => $places['depot'],
+                'dropoff'         => $places['orchard'],
+                'waypoints'       => [],
+                'entities'        => [
                     ['name' => 'Small carton', 'type' => 'parcel', 'weight' => 12, 'weight_unit' => 'kg', 'length' => 60, 'width' => 40, 'height' => 35, 'dimensions_unit' => 'cm'],
                     ['name' => 'Fragile tote', 'type' => 'parcel', 'weight' => 8, 'weight_unit' => 'kg', 'length' => 50, 'width' => 35, 'height' => 30, 'dimensions_unit' => 'cm'],
                 ],
             ],
             'waypoint_only' => [
                 'payload_seed_id' => 'waypoint_only',
-                'name'       => 'VROOM Test Order - Waypoints Only',
-                'pickup'     => null,
-                'dropoff'    => null,
-                'waypoints'  => [$places['rochor'], $places['novena'], $places['serangoon']],
-                'entities'   => [
+                'name'            => 'VROOM Test Order - Waypoints Only',
+                'pickup'          => null,
+                'dropoff'         => null,
+                'waypoints'       => [$places['rochor'], $places['novena'], $places['serangoon']],
+                'entities'        => [
                     ['name' => 'Multi-stop parcel 1', 'type' => 'parcel', 'weight' => 25, 'weight_unit' => 'kg', 'length' => 80, 'width' => 50, 'height' => 40, 'dimensions_unit' => 'cm'],
                     ['name' => 'Multi-stop parcel 2', 'type' => 'parcel', 'weight' => 18, 'weight_unit' => 'kg', 'length' => 70, 'width' => 45, 'height' => 35, 'dimensions_unit' => 'cm'],
                     ['name' => 'Multi-stop parcel 3', 'type' => 'parcel', 'weight' => 15, 'weight_unit' => 'kg', 'length' => 65, 'width' => 40, 'height' => 35, 'dimensions_unit' => 'cm'],
@@ -303,22 +310,22 @@ class VroomOrchestrationSeeder extends Seeder
             ],
             'mixed' => [
                 'payload_seed_id' => 'mixed',
-                'name'       => 'VROOM Test Order - Mixed Stops',
-                'pickup'     => $places['depot'],
-                'dropoff'    => $places['changi'],
-                'waypoints'  => [$places['paya_lebar'], $places['tampines']],
-                'entities'   => [
+                'name'            => 'VROOM Test Order - Mixed Stops',
+                'pickup'          => $places['depot'],
+                'dropoff'         => $places['changi'],
+                'waypoints'       => [$places['paya_lebar'], $places['tampines']],
+                'entities'        => [
                     ['name' => 'Heavy equipment crate', 'type' => 'freight', 'weight' => 180, 'weight_unit' => 'kg', 'length' => 120, 'width' => 80, 'height' => 90, 'dimensions_unit' => 'cm'],
                     ['name' => 'Accessory box', 'type' => 'parcel', 'weight' => 22, 'weight_unit' => 'kg', 'length' => 75, 'width' => 55, 'height' => 45, 'dimensions_unit' => 'cm'],
                 ],
             ],
             'single_waypoint' => [
                 'payload_seed_id' => 'single_waypoint',
-                'name'       => 'VROOM Test Order - Single Waypoint',
-                'pickup'     => null,
-                'dropoff'    => null,
-                'waypoints'  => [$places['woodlands']],
-                'entities'   => [
+                'name'            => 'VROOM Test Order - Single Waypoint',
+                'pickup'          => null,
+                'dropoff'         => null,
+                'waypoints'       => [$places['woodlands']],
+                'entities'        => [
                     ['name' => 'Oversized sample case', 'type' => 'parcel', 'weight' => 60, 'weight_unit' => 'kg', 'length' => 100, 'width' => 60, 'height' => 60, 'dimensions_unit' => 'cm'],
                 ],
             ],

package/server/src/Console/Commands/AuditCustomerUserConflicts.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace Fleetbase\FleetOps\Console\Commands;
+
+use Fleetbase\FleetOps\Models\Contact;
+use Illuminate\Console\Command;
+
+class AuditCustomerUserConflicts extends Command
+{
+    protected $signature = 'fleetops:audit-customer-user-conflicts {--company= : Limit audit to a company UUID} {--json : Output JSON instead of a table}';
+
+    protected $description = 'Reports customer contacts linked to users that may have been incorrectly promoted from staff/admin accounts.';
+
+    public function handle(): int
+    {
+        $query = Contact::where('type', 'customer')->whereNotNull('user_uuid')->with(['anyUser.companyUsers.roles', 'company']);
+
+        if ($company = $this->option('company')) {
+            $query->where('company_uuid', $company);
+        }
+
+        $rows = $query->get()->map(function (Contact $contact) {
+            $user        = $contact->anyUser;
+            $companyUser = $user?->companyUsers?->firstWhere('company_uuid', $contact->company_uuid);
+            $roles       = $companyUser?->roles?->pluck('name')->filter()->values()->all() ?? [];
+            $unexpected  = array_values(array_filter($roles, fn ($role) => $role !== 'Fleet-Ops Customer'));
+            $reasons     = [];
+
+            if (!$user) {
+                $reasons[] = 'missing linked user';
+            } elseif ($user->type !== 'customer') {
+                $reasons[] = 'linked user type is ' . $user->type;
+            }
+
+            if (!empty($unexpected)) {
+                $reasons[] = 'linked user has non-customer roles: ' . implode(', ', $unexpected);
+            }
+
+            if (empty($reasons)) {
+                return null;
+            }
+
+            return [
+                'contact_id'    => $contact->public_id,
+                'contact_uuid'  => $contact->uuid,
+                'contact_name'  => $contact->name,
+                'contact_email' => $contact->email,
+                'user_uuid'     => $user?->uuid,
+                'user_email'    => $user?->email,
+                'user_type'     => $user?->type,
+                'roles'         => implode(', ', $roles),
+                'company_uuid'  => $contact->company_uuid,
+                'company_name'  => $contact->company?->name,
+                'updated_at'    => optional($contact->updated_at)->toDateTimeString(),
+                'reason'        => implode('; ', $reasons),
+            ];
+        })->filter()->values();
+
+        if ($this->option('json')) {
+            $this->line($rows->toJson(JSON_PRETTY_PRINT));
+
+            return self::SUCCESS;
+        }
+
+        if ($rows->isEmpty()) {
+            $this->info('No suspicious customer user conflicts found.');
+
+            return self::SUCCESS;
+        }
+
+        $this->table(array_keys($rows->first()), $rows->all());
+
+        return self::SUCCESS;
+    }
+}