@fleetbase/fleetops-engine 0.6.58 → 0.6.59

package/server/tests/Feature/Http/Internal/OrderControllerActivityFlowsTest.php

@@ -0,0 +1,663 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Internal\v1\OrderController;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+/**
+ * Covers the internal OrderController start/updateActivity/nextActivity/
+ * setDestination flows against SQLite with the transport order-config flow:
+ * start guards and success with driver job assignment, the
+ * proof-of-delivery requirement, dispatch-without-driver failure, lifecycle
+ * activity updates, next-activity resolution, and destination selection.
+ */
+if (!function_exists('Fleetbase\Support\session')) {
+    eval('namespace Fleetbase\Support; function session($key = null, $default = null) { if ($key === null) { return new class { public function has($k) { return \session($k) !== null; } public function get($k, $d = null) { return \session($k, $d); } }; } return \session($key, $default); }');
+}
+
+if (!function_exists('Fleetbase\Support\auth')) {
+    eval('namespace Fleetbase\Support; function auth() { return new class { public function user() { return null; } public function id() { return null; } }; }');
+}
+
+if (!function_exists('Fleetbase\FleetOps\Http\Controllers\Internal\v1\event')) {
+    eval('namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1; function event($event = null) { \FleetOpsInternalActivityRecorder::$events[] = $event; return $event; }');
+}
+
+if (!function_exists('Fleetbase\FleetOps\Models\event')) {
+    eval('namespace Fleetbase\FleetOps\Models; function event($event = null) { \FleetOpsInternalActivityRecorder::$events[] = $event; return $event; }');
+}
+
+if (!function_exists('Fleetbase\FleetOps\Models\dispatch')) {
+    eval('namespace Fleetbase\FleetOps\Models; function dispatch($job = null) { \FleetOpsInternalActivityRecorder::$dispatched[] = $job; return new \Fleetbase\TestSupport\PendingDispatch(); }');
+}
+
+class FleetOpsInternalActivityRecorder
+{
+    public static array $events     = [];
+    public static array $dispatched = [];
+}
+
+function fleetopsInternalActivityBoot(): SQLiteConnection
+{
+    if (!Str::hasMacro('humanize')) {
+        Str::macro('humanize', fn ($value, $uppercase = true) => str_replace('_', ' ', Str::snake((string) $value)));
+    }
+
+    $pdo = new PDO('sqlite::memory:');
+    $pdo->sqliteCreateFunction('ST_PointFromText', function ($wkt, $srid = 0, $axisOrder = null) {
+        if (is_string($wkt) && sscanf($wkt, 'POINT(%f %f)', $lng, $lat) === 2) {
+            return pack('V', 0) . pack('C', 1) . pack('V', 1) . pack('d', $lng) . pack('d', $lat);
+        }
+
+        return $wkt;
+    });
+    $pdo->sqliteCreateFunction('ST_GeomFromText', fn ($wkt, $srid = 0, $axisOrder = null) => $wkt);
+    $connection = new SQLiteConnection($pdo);
+    $resolver   = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+    app()->instance('db', new class($connection) {
+        public function __construct(public SQLiteConnection $c)
+        {
+        }
+
+        public function connection($name = null): SQLiteConnection
+        {
+            return $this->c;
+        }
+
+        public function __call($method, $arguments)
+        {
+            return $this->c->{$method}(...$arguments);
+        }
+    });
+    Illuminate\Support\Facades\DB::clearResolvedInstance('db');
+
+    $barcodeFake = new class {
+        public function __call($method, $arguments)
+        {
+            return 'barcode';
+        }
+    };
+    app()->instance('DNS2D', $barcodeFake);
+    app()->instance('DNS1D', $barcodeFake);
+
+    $schema = $connection->getSchemaBuilder();
+    app()->instance('db.schema', $schema);
+    $tables = [
+        'orders'            => ['uuid', 'public_id', 'internal_id', 'company_uuid', 'payload_uuid', 'order_config_uuid', 'tracking_number_uuid', 'driver_assigned_uuid', 'status', 'type', 'adhoc', 'dispatched', 'dispatched_at', 'started', 'started_at', 'scheduled_at', 'meta', 'distance', 'time', 'pod_required', 'pod_method'],
+        'payloads'          => ['uuid', 'public_id', 'company_uuid', 'pickup_uuid', 'dropoff_uuid', 'return_uuid', 'current_waypoint_uuid', 'pickup_tracking_number_uuid', 'dropoff_tracking_number_uuid', 'meta', 'type'],
+        'places'            => ['uuid', 'public_id', 'company_uuid', 'name', 'street1', 'city', 'country', 'location', 'meta'],
+        'waypoints'         => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'place_uuid', 'tracking_number_uuid', 'customer_uuid', 'customer_type', 'order', 'type', '_key', '_import_id'],
+        'drivers'           => ['uuid', 'public_id', 'company_uuid', 'user_uuid', 'vehicle_uuid', 'status', 'online', 'location', 'current_job_uuid'],
+        'users'             => ['uuid', 'public_id', 'company_uuid', 'name', 'status', 'type'],
+        'order_configs'     => ['uuid', 'public_id', 'company_uuid', 'name', 'key', 'namespace', 'description', 'flow', 'entities', 'meta', 'tags', 'version', 'core_service', 'status', 'type', '_key'],
+        'tracking_numbers'  => ['uuid', 'public_id', 'company_uuid', 'tracking_number', 'region', 'location', 'status_uuid', 'owner_uuid', 'owner_type', 'qr_code', 'barcode', '_key'],
+        'tracking_statuses' => ['uuid', 'public_id', 'company_uuid', 'tracking_number_uuid', 'proof_uuid', 'status', 'details', 'location', 'code', 'complete', '_key'],
+        'entities'          => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'destination_uuid', 'tracking_number_uuid', 'name', 'type'],
+        'proofs'            => ['uuid', 'public_id', 'company_uuid', 'order_uuid', 'subject_uuid', 'subject_type', 'remarks', 'raw_data', 'data'],
+        'companies'         => ['uuid', 'public_id', 'name', 'country'],
+        'positions'         => ['uuid', 'public_id', 'company_uuid', 'subject_uuid', 'subject_type', 'destination_uuid', 'coordinates', 'heading', 'bearing', 'speed', 'altitude', 'order_uuid', '_key'],
+    ];
+    foreach ($tables as $table => $columns) {
+        $schema->create($table, function ($blueprint) use ($columns) {
+            $blueprint->increments('id');
+            foreach ($columns as $column) {
+                if (in_array($column, ['core_service', 'started', 'adhoc', 'dispatched', 'pod_required'], true)) {
+                    $blueprint->integer($column)->nullable();
+                    continue;
+                }
+                $blueprint->string($column)->nullable();
+            }
+            $blueprint->timestamps();
+            $blueprint->timestamp('deleted_at')->nullable();
+        });
+    }
+
+    session(['company' => 'company-1']);
+    $connection->table('companies')->insert(['uuid' => 'company-1', 'name' => 'Acme', 'country' => 'SG']);
+    $connection->table('order_configs')->insert([
+        'uuid'         => 'config-1',
+        'public_id'    => 'order_config_transport',
+        'company_uuid' => 'company-1',
+        'name'         => 'Transport',
+        'key'          => 'transport',
+        'namespace'    => 'system:order-config:transport',
+        'core_service' => 1,
+        'status'       => 'active',
+        'version'      => '0.0.1',
+        'flow'         => json_encode([
+            'order_created' => [
+                'key'        => 'order_created',
+                'code'       => 'created',
+                'status'     => 'Created',
+                'details'    => 'Order created',
+                'activities' => ['order_dispatched'],
+            ],
+            'order_dispatched' => [
+                'key'        => 'order_dispatched',
+                'code'       => 'dispatched',
+                'status'     => 'Dispatched',
+                'details'    => 'Order dispatched',
+                'activities' => ['order_started'],
+            ],
+            'order_started' => [
+                'key'        => 'order_started',
+                'code'       => 'started',
+                'status'     => 'Started',
+                'details'    => 'Order started',
+                'activities' => ['order_completed'],
+            ],
+            'order_completed' => [
+                'key'        => 'order_completed',
+                'code'       => 'completed',
+                'status'     => 'Completed',
+                'details'    => 'Order completed',
+                'complete'   => true,
+                'activities' => [],
+            ],
+        ]),
+    ]);
+    FleetOpsInternalActivityRecorder::$events     = [];
+    FleetOpsInternalActivityRecorder::$dispatched = [];
+
+    return $connection;
+}
+
+function fleetopsInternalActivitySeedOrder(SQLiteConnection $connection, array $attributes = []): void
+{
+    $connection->table('users')->insert(['uuid' => 'user-1', 'company_uuid' => 'company-1', 'name' => 'Driver One']);
+    $connection->table('drivers')->insert(['uuid' => 'driver-1', 'public_id' => 'driver_one', 'company_uuid' => 'company-1', 'user_uuid' => 'user-1']);
+    $connection->table('places')->insert([
+        ['uuid' => 'place-p', 'company_uuid' => 'company-1', 'name' => 'Pickup'],
+        ['uuid' => 'place-d', 'company_uuid' => 'company-1', 'name' => 'Dropoff'],
+    ]);
+    $connection->table('payloads')->insert(['uuid' => 'payload-1', 'company_uuid' => 'company-1', 'pickup_uuid' => 'place-p', 'dropoff_uuid' => 'place-d']);
+    $connection->table('tracking_numbers')->insert(['uuid' => 'tn-1', 'company_uuid' => 'company-1', 'tracking_number' => 'TRK-1', 'owner_uuid' => 'order-1']);
+    $connection->table('orders')->insert(array_merge([
+        'uuid'                 => 'order-1',
+        'public_id'            => 'order_internal',
+        'company_uuid'         => 'company-1',
+        'payload_uuid'         => 'payload-1',
+        'order_config_uuid'    => 'config-1',
+        'tracking_number_uuid' => 'tn-1',
+        'status'               => 'created',
+        'type'                 => 'transport',
+        'adhoc'                => 0,
+        'dispatched'           => 0,
+        'started'              => 0,
+    ], $attributes));
+}
+
+test('start guards missing started and driverless orders then starts', function () {
+    $connection = fleetopsInternalActivityBoot();
+    $controller = new OrderController();
+
+    // Unknown order
+    $missing = $controller->start(Request::create('/x', 'POST', ['order' => 'order-missing']));
+    expect($missing->getData(true)['error'])->toContain('Unable to find order');
+
+    // Already started
+    fleetopsInternalActivitySeedOrder($connection, ['started' => 1]);
+    $started = $controller->start(Request::create('/x', 'POST', ['order' => 'order-1']));
+    expect($started->getData(true)['error'])->toContain('already been started');
+
+    // No driver
+    $connection->table('orders')->where('uuid', 'order-1')->update(['started' => 0]);
+    $noDriver = $controller->start(Request::create('/x', 'POST', ['order' => 'order-1']));
+    expect($noDriver->getData(true)['error'])->toContain('No driver assigned');
+
+    // Success starts the order and assigns the driver job
+    $connection->table('orders')->where('uuid', 'order-1')->update(['driver_assigned_uuid' => 'driver-1']);
+    $controller->start(Request::create('/x', 'POST', ['order' => 'order-1']));
+    expect($connection->table('orders')->value('started'))->toBe(1)
+        ->and($connection->table('drivers')->value('current_job_uuid'))->toBe('order-1')
+        ->and(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\OrderStarted))->not->toBeNull();
+});
+
+test('update activity enforces proof and dispatch preconditions', function () {
+    $connection = fleetopsInternalActivityBoot();
+    $controller = new OrderController();
+
+    $missing = $controller->updateActivity('order-missing', Request::create('/x', 'POST', []));
+    expect($missing->getData(true)['error'])->toContain('No order found');
+
+    fleetopsInternalActivitySeedOrder($connection, ['pod_required' => 1]);
+
+    // Completing activity without proof is rejected
+    $activity = ['key' => 'order_completed', 'code' => 'completed', 'status' => 'Completed', 'details' => 'Order completed', 'complete' => true];
+    $noProof  = $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $activity]));
+    expect($noProof->getStatusCode())->toBe(422);
+
+    // Dispatched activity without an assigned driver fails dispatch
+    $dispatched = ['key' => 'order_dispatched', 'code' => 'dispatched', 'status' => 'Dispatched', 'details' => 'Order dispatched'];
+    $failed     = $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $dispatched]));
+    expect($failed->getData(true)['error'])->toContain('No driver assigned')
+        ->and(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\OrderDispatchFailed))->not->toBeNull();
+
+    // Lifecycle activity updates the order normally with proof bypassed
+    $startedActivity = ['key' => 'order_started', 'code' => 'started', 'status' => 'Started', 'details' => 'Order started'];
+    $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $startedActivity, 'bypass_proof' => 1]));
+    expect($connection->table('tracking_statuses')->where('code', 'STARTED')->count())->toBeGreaterThanOrEqual(1);
+});
+
+test('next activity resolves the flow and destination selection persists', function () {
+    $connection = fleetopsInternalActivityBoot();
+    $controller = new OrderController();
+
+    fleetopsInternalActivitySeedOrder($connection);
+    $activities = $controller->nextActivity('order_internal', Request::create('/x', 'GET'));
+    expect(collect($activities->getData(true))->pluck('code')->all())->toContain('dispatched');
+
+    // Pickup/dropoff-only orders cannot change destination
+    $single = $controller->setDestination('order_internal', 'place-d');
+    expect($single->getStatusCode())->toBe(422)
+        ->and($single->getData(true)['error'])->toContain('multi-waypoint');
+
+    // Multi-waypoint orders validate and persist the destination
+    $connection->table('places')->insert(['uuid' => 'place-w', 'company_uuid' => 'company-1', 'name' => 'Waypoint']);
+    $connection->table('waypoints')->insert(['uuid' => 'wp-1', 'company_uuid' => 'company-1', 'payload_uuid' => 'payload-1', 'place_uuid' => 'place-w', 'order' => '1']);
+
+    $invalid = $controller->setDestination('order_internal', 'place-unknown');
+    expect($invalid->getStatusCode())->toBe(422);
+
+    $controller->setDestination('order_internal', 'place-d');
+    expect($connection->table('payloads')->value('current_waypoint_uuid'))->toBe('place-d');
+});
+
+function fleetopsInternalActivitySeedWaypoints(SQLiteConnection $connection): void
+{
+    $connection->table('places')->insert([
+        ['uuid' => 'place-w1', 'company_uuid' => 'company-1', 'name' => 'Stop One'],
+        ['uuid' => 'place-w2', 'company_uuid' => 'company-1', 'name' => 'Stop Two'],
+    ]);
+    $connection->table('tracking_numbers')->insert([
+        ['uuid' => 'tn-w1', 'company_uuid' => 'company-1', 'tracking_number' => 'TRKW1', 'owner_uuid' => 'wp-1'],
+        ['uuid' => 'tn-w2', 'company_uuid' => 'company-1', 'tracking_number' => 'TRKW2', 'owner_uuid' => 'wp-2'],
+    ]);
+    $connection->table('waypoints')->insert([
+        ['uuid' => 'wp-1', 'public_id' => 'waypoint_stopone', 'company_uuid' => 'company-1', 'payload_uuid' => 'payload-1', 'place_uuid' => 'place-w1', 'tracking_number_uuid' => 'tn-w1', 'order' => '0'],
+        ['uuid' => 'wp-2', 'public_id' => 'waypoint_stoptwo', 'company_uuid' => 'company-1', 'payload_uuid' => 'payload-1', 'place_uuid' => 'place-w2', 'tracking_number_uuid' => 'tn-w2', 'order' => '1'],
+    ]);
+}
+
+test('waypoint service stop activities gate progress and advance to completion', function () {
+    $connection = fleetopsInternalActivityBoot();
+    $controller = new OrderController();
+
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1']);
+    fleetopsInternalActivitySeedWaypoints($connection);
+    // Waypoint-only route so two completions exhaust the stops
+    $connection->table('payloads')->where('uuid', 'payload-1')->update(['pickup_uuid' => null, 'dropoff_uuid' => null]);
+
+    // Waypoint activity requires a started order first
+    $activity = ['key' => 'order_completed', 'code' => 'completed', 'status' => 'Completed', 'details' => 'Stop completed', 'complete' => true];
+    $gated    = $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $activity, 'bypass_proof' => 1]));
+    expect($gated->getStatusCode())->toBe(422);
+
+    // Started orders complete the current stop then advance to the next
+    $connection->table('orders')->where('uuid', 'order-1')->update(['started' => 1, 'status' => 'started']);
+    $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $activity, 'bypass_proof' => 1]));
+    expect($connection->table('payloads')->value('current_waypoint_uuid'))->not->toBeNull();
+
+    // Completing the final stop completes the order itself
+    $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $activity, 'bypass_proof' => 1]));
+    expect($connection->table('tracking_statuses')->where('code', 'COMPLETED')->count())->toBeGreaterThanOrEqual(1);
+});
+
+test('next activity resolves waypoint stops for started orders', function () {
+    $connection = fleetopsInternalActivityBoot();
+    $controller = new OrderController();
+
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'started' => 1, 'status' => 'started']);
+    fleetopsInternalActivitySeedWaypoints($connection);
+
+    $current = $controller->nextActivity('order_internal', Request::create('/x', 'GET'));
+    expect($current)->not->toBeNull();
+
+    $scoped = $controller->nextActivity('order_internal', Request::create('/x', 'GET', ['waypoint' => 'waypoint_stopone']));
+    expect($scoped)->not->toBeNull();
+});
+
+if (!function_exists('Fleetbase\FleetOps\Support\event')) {
+    eval('namespace Fleetbase\FleetOps\Support; function event($event = null) { \FleetOpsInternalActivityRecorder::$events[] = $event; return $event; }');
+}
+
+class FleetOpsServiceStopProbe extends OrderController
+{
+    public function callStop(string $method, ...$arguments): mixed
+    {
+        $reflection = new ReflectionMethod(OrderController::class, $method);
+        $reflection->setAccessible(true);
+
+        return $reflection->invoke($this, ...$arguments);
+    }
+}
+
+test('service stop activity updates waypoints entities and endpoint stops', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'started' => 1, 'status' => 'started']);
+    fleetopsInternalActivitySeedWaypoints($connection);
+    $connection->table('payloads')->where('uuid', 'payload-1')->update(['pickup_uuid' => null, 'dropoff_uuid' => null]);
+    $connection->table('entities')->insert(['uuid' => 'ent-1', 'company_uuid' => 'company-1', 'payload_uuid' => 'payload-1', 'destination_uuid' => 'place-w1', 'name' => 'Crate']);
+
+    $probe = new FleetOpsServiceStopProbe();
+    $order = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first();
+
+    FleetOpsInternalActivityRecorder::$events = [];
+    $location                                 = new Fleetbase\LaravelMysqlSpatial\Types\Point(1.30, 103.80);
+
+    // Non-completing activity fires waypoint and entity change events
+    $progress = new Fleetbase\FleetOps\Flow\Activity(['key' => 'order_started', 'code' => 'started', 'status' => 'Started', 'details' => 'In progress'], $order->getConfigFlow());
+    $stop     = $probe->callStop('updateCurrentServiceStopActivity', $order, $progress, $location);
+    expect($stop)->toBeArray()
+        ->and(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\WaypointActivityChanged))->not->toBeNull()
+        ->and(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\EntityActivityChanged))->not->toBeNull();
+
+    // Completing activity fires completion events and updates tracking status
+    $complete = new Fleetbase\FleetOps\Flow\Activity(['key' => 'order_completed', 'code' => 'completed', 'status' => 'Completed', 'details' => 'Done', 'complete' => true], $order->getConfigFlow());
+    $probe->callStop('updateCurrentServiceStopActivity', $order->fresh(['payload']), $complete, $location);
+    expect(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\WaypointCompleted))->not->toBeNull()
+        ->and(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\EntityCompleted))->not->toBeNull()
+        ->and($connection->table('tracking_numbers')->where('uuid', 'tn-w1')->value('status_uuid'))->not->toBeNull();
+});
+
+test('endpoint service stops create tracking numbers and resolve activities', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'started' => 1, 'status' => 'started']);
+
+    $probe    = new FleetOpsServiceStopProbe();
+    $order    = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first();
+    $location = new Fleetbase\LaravelMysqlSpatial\Types\Point(1.30, 103.80);
+
+    $activity = new Fleetbase\FleetOps\Flow\Activity(['key' => 'order_started', 'code' => 'started', 'status' => 'Started', 'details' => 'Pickup activity'], $order->getConfigFlow());
+    $probe->callStop('updateCurrentServiceStopActivity', $order, $activity, $location);
+
+    expect($connection->table('payloads')->value('pickup_tracking_number_uuid'))->not->toBeNull()
+        ->and($connection->table('tracking_statuses')->where('code', 'STARTED')->count())->toBeGreaterThanOrEqual(1);
+
+    // Unknown current status codes resolve to no next activities
+    $tnUuid = $connection->table('payloads')->value('pickup_tracking_number_uuid');
+    $connection->table('tracking_statuses')->insert(['uuid' => 'ts-odd', 'company_uuid' => 'company-1', 'tracking_number_uuid' => $tnUuid, 'code' => 'ZZZUNKNOWN', 'status' => 'Odd']);
+    $connection->table('tracking_numbers')->where('uuid', $tnUuid)->update(['status_uuid' => 'ts-odd']);
+
+    $order = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first();
+    $stop  = $probe->callStop('payloadCurrentServiceStop', $order->payload);
+    $next  = $probe->callStop('nextActivitiesForServiceStop', $order, $order->payload, $stop);
+    expect($next)->toHaveCount(0);
+});
+
+test('dispatched cancel and entity activities flow through update activity', function () {
+    $connection = fleetopsInternalActivityBoot();
+    $controller = new OrderController();
+
+    // Dispatched activity with an assigned driver dispatches the order
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1']);
+    $connection->table('users')->insertOrIgnore(['uuid' => 'user-1', 'company_uuid' => 'company-1', 'name' => 'Driver One']);
+    $connection->table('drivers')->insertOrIgnore(['uuid' => 'driver-1', 'public_id' => 'driver_intact1', 'company_uuid' => 'company-1', 'user_uuid' => 'user-1']);
+    $dispatched = $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => [
+        'key' => 'order_dispatched', 'code' => 'dispatched', 'status' => 'Dispatched', 'details' => 'Order dispatched',
+    ]]));
+    expect($dispatched->getData(true)['status'] ?? '')->toBe('dispatched');
+
+    // Classic payload entity activities insert per-entity statuses
+    $connection->table('entities')->insert(['uuid' => 'entity-1', 'public_id' => 'entity_intact1', 'company_uuid' => 'company-1', 'payload_uuid' => 'payload-1', 'name' => 'Parcel', 'tracking_number_uuid' => 'tn-ent']);
+    $connection->table('tracking_numbers')->insert(['uuid' => 'tn-ent', 'company_uuid' => 'company-1', 'tracking_number' => 'TRKENT', 'owner_uuid' => 'entity-1']);
+    $started = $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => [
+        'key' => 'order_started', 'code' => 'started', 'status' => 'Started', 'details' => 'Order started',
+    ]]));
+    expect($connection->table('tracking_statuses')->where('tracking_number_uuid', 'tn-ent')->count())->toBeGreaterThanOrEqual(1);
+});
+
+test('canceled service stop activities unassign drivers and cancel orders', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'status' => 'started', 'started' => 1]);
+    fleetopsInternalActivitySeedWaypoints($connection);
+    $connection->table('users')->insertOrIgnore(['uuid' => 'user-1', 'company_uuid' => 'company-1', 'name' => 'Driver One']);
+    $connection->table('drivers')->insertOrIgnore(['uuid' => 'driver-1', 'public_id' => 'driver_intcan1', 'company_uuid' => 'company-1', 'user_uuid' => 'user-1', 'current_job_uuid' => 'order-1']);
+    $controller = new OrderController();
+
+    $canceled = $controller->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => [
+        'key' => 'order_canceled', 'code' => 'canceled', 'status' => 'Canceled', 'details' => 'Order canceled',
+    ]]));
+
+    expect($connection->table('orders')->value('status'))->toBe('canceled')
+        ->and($connection->table('drivers')->value('current_job_uuid'))->toBeNull();
+});
+
+test('next activity marks proof requirements on completing activities', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['status' => 'started', 'started' => 1, 'pod_required' => 1, 'pod_method' => 'signature']);
+    $controller = new OrderController();
+
+    $response  = $controller->nextActivity('order_internal', Request::create('/x', 'GET'));
+    $payload   = method_exists($response, 'getData') ? $response->getData(true) : (array) $response;
+    $flattened = json_encode($payload);
+
+    expect($flattened)->toContain('require_pod');
+});
+
+test('edit order route updates waypoints and clears them for endpoint edits', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection);
+    fleetopsInternalActivitySeedWaypoints($connection);
+    $connection->table('places')->insert([
+        ['uuid' => '55555555-5555-4555-8555-555555555556', 'company_uuid' => 'company-1', 'name' => 'Route Edit Stop'],
+        ['uuid' => '55555555-5555-4555-8555-555555555557', 'company_uuid' => 'company-1', 'name' => 'Route Edit Pickup'],
+        ['uuid' => '55555555-5555-4555-8555-555555555558', 'company_uuid' => 'company-1', 'name' => 'Route Edit Dropoff'],
+    ]);
+    app()->bind('Fleetbase\Fleetops\Models\Contact', fn () => new Fleetbase\FleetOps\Models\Contact());
+    $controller = new OrderController();
+
+    // Waypoint updates rewrite the stop list through the payload
+    $updated = $controller->editOrderRoute('order-1', Request::create('/x', 'PUT', [
+        'waypoints' => [['place_uuid' => '55555555-5555-4555-8555-555555555556']],
+    ]));
+    expect($updated)->not->toBeNull()
+        ->and($connection->table('waypoints')->where('place_uuid', '55555555-5555-4555-8555-555555555556')->count())->toBe(1);
+
+    // Explicit empty waypoint lists clear the stop list directly
+    $controller->editOrderRoute('order-1', Request::create('/x', 'PUT', ['waypoints' => []]));
+    expect($connection->table('waypoints')->whereNull('deleted_at')->count())->toBe(0);
+
+    $controller->editOrderRoute('order-1', Request::create('/x', 'PUT', [
+        'waypoints' => [['place_uuid' => '55555555-5555-4555-8555-555555555556']],
+    ]));
+
+    // Endpoint-only edits clear residual waypoints
+    $cleared = $controller->editOrderRoute('order-1', Request::create('/x', 'PUT', [
+        'pickup'  => '55555555-5555-4555-8555-555555555557',
+        'dropoff' => '55555555-5555-4555-8555-555555555558',
+    ]));
+    expect($connection->table('waypoints')->whereNull('deleted_at')->count())->toBe(0);
+
+    // Unknown orders respond with the error seam
+    $missing = $controller->editOrderRoute('order-unknown', Request::create('/x', 'PUT', []));
+    expect($missing->getData(true)['error'] ?? '')->toContain('Unable to find order');
+});
+
+test('dispatch order endpoint guards and dispatches assigned orders', function () {
+    $connection = fleetopsInternalActivityBoot();
+    $controller = new OrderController();
+
+    // Unknown orders error first
+    $missing = $controller->dispatchOrder(Request::create('/x', 'POST', ['order' => 'order_missing99']));
+    expect($missing->getData(true)['error'] ?? '')->toContain('No order found');
+
+    // Orders without drivers cannot dispatch
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => null, 'dispatched' => 0]);
+    $noDriver = $controller->dispatchOrder(Request::create('/x', 'POST', ['order' => 'order_internal']));
+    expect($noDriver->getData(true)['error'] ?? '')->toContain('No driver assigned');
+
+    // Assigned orders dispatch once and reject repeats
+    $connection->table('users')->insertOrIgnore(['uuid' => 'user-1', 'company_uuid' => 'company-1', 'name' => 'Driver One']);
+    $connection->table('drivers')->insertOrIgnore(['uuid' => 'driver-1', 'public_id' => 'driver_dispone1', 'company_uuid' => 'company-1', 'user_uuid' => 'user-1']);
+    $connection->table('orders')->where('uuid', 'order-1')->update(['driver_assigned_uuid' => 'driver-1']);
+    $dispatched = $controller->dispatchOrder(Request::create('/x', 'POST', ['order' => 'order_internal']));
+    expect($dispatched->getData(true)['status'] ?? '')->toBe('OK');
+
+    $repeat = $controller->dispatchOrder(Request::create('/x', 'POST', ['order' => 'order_internal']));
+    expect($repeat->getData(true)['error'] ?? '')->toContain('already been dispatched');
+});
+
+test('set destination rejects single stop orders', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection);
+    $controller = new OrderController();
+
+    $rejected = $controller->setDestination('order_internal', 'place-p');
+    expect($rejected->getStatusCode())->toBe(422)
+        ->and($rejected->getData(true)['error'] ?? '')->toContain('multi-waypoint');
+});
+
+test('current waypoint activity guards markers and fires progress events', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'started' => 1, 'status' => 'started']);
+    fleetopsInternalActivitySeedWaypoints($connection);
+    $connection->table('entities')->insert(['uuid' => 'ent-wp-1', 'company_uuid' => 'company-1', 'payload_uuid' => 'payload-1', 'destination_uuid' => 'place-w1', 'name' => 'Parcel']);
+    $connection->table('payloads')->where('uuid', 'payload-1')->update(['current_waypoint_uuid' => 'place-w1']);
+
+    $probe    = new FleetOpsServiceStopProbe();
+    $order    = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first();
+    $location = new Fleetbase\LaravelMysqlSpatial\Types\Point(1.30, 103.80);
+    $payload  = $order->payload;
+
+    // Non-completing activities fire the change events for waypoint and entities
+    FleetOpsInternalActivityRecorder::$events = [];
+    $progress                                 = new Fleetbase\FleetOps\Flow\Activity(['key' => 'order_started', 'code' => 'started', 'status' => 'Started', 'details' => 'In progress'], $order->getConfigFlow());
+    $waypoint                                 = $probe->callStop('updateCurrentWaypointActivity', $payload, $progress, $location);
+
+    expect($waypoint)->not->toBeNull()
+        ->and(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\WaypointActivityChanged))->not->toBeNull()
+        ->and(collect(FleetOpsInternalActivityRecorder::$events)->first(fn ($event) => $event instanceof Fleetbase\FleetOps\Events\EntityActivityChanged))->not->toBeNull();
+
+    // Payloads pointing at an unknown stop resolve to no waypoint at all
+    $connection->table('payloads')->where('uuid', 'payload-1')->update(['current_waypoint_uuid' => 'place-missing']);
+    $orphaned = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first()->payload;
+    expect($probe->callStop('updateCurrentWaypointActivity', $orphaned, $progress, $location))->toBeNull();
+});
+
+test('payload waypoint activity lookup reports existing tracking statuses', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1']);
+    fleetopsInternalActivitySeedWaypoints($connection);
+
+    $probe    = new FleetOpsServiceStopProbe();
+    $order    = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first();
+    $activity = new Fleetbase\FleetOps\Flow\Activity(['key' => 'order_started', 'code' => 'started', 'status' => 'Started', 'details' => 'In progress'], $order->getConfigFlow());
+
+    // Payloads without a current waypoint never report an activity
+    expect($probe->callStop('payloadHasCurrentWaypointActivity', $order->payload, $activity))->toBeFalse();
+
+    // A current waypoint with no matching tracking status reports false
+    $connection->table('payloads')->where('uuid', 'payload-1')->update(['current_waypoint_uuid' => 'place-w1']);
+    $payload = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first()->payload;
+    expect($probe->callStop('payloadHasCurrentWaypointActivity', $payload, $activity))->toBeFalse();
+
+    // Once the tracking status exists for that stop the lookup reports true
+    $connection->table('tracking_statuses')->insert([
+        'uuid'                 => 'ts-wp-1',
+        'company_uuid'         => 'company-1',
+        'tracking_number_uuid' => 'tn-w1',
+        'code'                 => Fleetbase\FleetOps\Models\TrackingStatus::prepareCode('started'),
+        'status'               => 'Started',
+    ]);
+    $refreshed = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first()->payload;
+    expect($probe->callStop('payloadHasCurrentWaypointActivity', $refreshed, $activity))->toBeTrue();
+
+    // Stops without a tracking number short circuit before the query
+    $connection->table('waypoints')->where('uuid', 'wp-1')->update(['tracking_number_uuid' => null]);
+    $untracked = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first()->payload;
+    expect($probe->callStop('payloadHasCurrentWaypointActivity', $untracked, $activity))->toBeFalse();
+});
+
+test('driver ping notifies the assigned driver through the notification seam', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1']);
+
+    $notified = [];
+    app()->instance(Illuminate\Contracts\Notifications\Dispatcher::class, new class($notified) {
+        public function __construct(public array &$sent)
+        {
+        }
+
+        public function send($notifiables, $notification)
+        {
+            $this->sent[] = $notification;
+        }
+
+        public function sendNow($notifiables, $notification, ?array $channels = null)
+        {
+            $this->sent[] = $notification;
+        }
+
+        public function __call($method, $arguments)
+        {
+            return null;
+        }
+    });
+
+    $probe  = new FleetOpsServiceStopProbe();
+    $order  = Fleetbase\FleetOps\Models\Order::query()->where('uuid', 'order-1')->first();
+    $driver = Fleetbase\FleetOps\Models\Driver::query()->where('uuid', 'driver-1')->first();
+
+    $probe->callStop('sendDriverPing', $driver, $order);
+
+    expect($notified)->toHaveCount(1)
+        ->and($notified[0])->toBeInstanceOf(Fleetbase\FleetOps\Notifications\OrderPing::class);
+});
+
+test('starting multi stop orders seeds the first service stop', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'dispatched' => 1, 'status' => 'dispatched']);
+    fleetopsInternalActivitySeedWaypoints($connection);
+    $connection->table('payloads')->where('uuid', 'payload-1')->update(['pickup_uuid' => null, 'dropoff_uuid' => null]);
+
+    (new OrderController())->start(Request::create('/x', 'POST', ['order' => 'order-1']));
+
+    expect($connection->table('payloads')->value('current_waypoint_uuid'))->toBe('place-w1')
+        ->and($connection->table('orders')->value('started'))->toBe(1);
+});
+
+test('started activities seed the current stop on multi stop payloads', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'dispatched' => 1, 'status' => 'dispatched']);
+    fleetopsInternalActivitySeedWaypoints($connection);
+    $connection->table('payloads')->where('uuid', 'payload-1')->update(['pickup_uuid' => null, 'dropoff_uuid' => null]);
+
+    $started = ['key' => 'order_started', 'code' => 'started', 'status' => 'Started', 'details' => 'Order started'];
+    (new OrderController())->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $started, 'bypass_proof' => 1]));
+
+    expect($connection->table('payloads')->value('current_waypoint_uuid'))->not->toBeNull();
+});
+
+test('completing activities release the assigned drivers current job', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1', 'started' => 1, 'status' => 'started']);
+    $connection->table('drivers')->where('uuid', 'driver-1')->update(['current_job_uuid' => 'order-1']);
+
+    $completed = ['key' => 'order_completed', 'code' => 'completed', 'status' => 'Completed', 'details' => 'Order completed', 'complete' => true];
+    (new OrderController())->updateActivity('order_internal', Request::create('/x', 'POST', ['activity' => $completed, 'bypass_proof' => 1]));
+
+    expect($connection->table('drivers')->where('uuid', 'driver-1')->value('current_job_uuid'))->toBeNull()
+        ->and($connection->table('orders')->value('status'))->toBe('completed');
+});
+
+test('set destination and next activity guard missing orders and configs', function () {
+    $connection = fleetopsInternalActivityBoot();
+    fleetopsInternalActivitySeedOrder($connection, ['driver_assigned_uuid' => 'driver-1']);
+    $controller = new OrderController();
+
+    // Unknown orders are refused before any destination work happens
+    expect($controller->setDestination('order_missing99', 'place_any')->getData(true)['error'] ?? '')->toBe('No order found.');
+
+    // Orders whose company cannot be resolved have no config to fall back on
+    $connection->table('orders')->where('uuid', 'order-1')->update(['order_config_uuid' => null, 'type' => null]);
+    $connection->table('order_configs')->delete();
+    $connection->table('companies')->delete();
+    $noConfig = $controller->nextActivity('order_internal', Request::create('/x', 'GET'));
+    expect($noConfig->getData(true)['error'] ?? '')->toBe('No order config found for order.');
+});