@fleetbase/fleetops-engine 0.6.58 → 0.6.59

package/server/tests/Feature/Http/Api/OrderControllerLifecycleActionsTest.php

@@ -0,0 +1,279 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\OrderController;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+/**
+ * Covers the API OrderController lifecycle actions against SQLite with a
+ * real transport order-config flow: next-activity resolution with
+ * proof-of-delivery flags, order completion with the incomplete-waypoint
+ * guard, cancellation, and current-destination selection for multi-stop
+ * payloads.
+ */
+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\Models\event')) {
+    eval('namespace Fleetbase\FleetOps\Models; function event($event = null) { \FleetOpsOrderLifecycleRecorder::$events[] = $event; return $event; }');
+}
+
+if (!function_exists('Fleetbase\FleetOps\Models\dispatch')) {
+    eval('namespace Fleetbase\FleetOps\Models; function dispatch($job = null) { \FleetOpsOrderLifecycleRecorder::$dispatched[] = $job; return new \Fleetbase\TestSupport\PendingDispatch(); }');
+}
+
+if (!Request::hasMacro('or')) {
+    Request::macro('or', function (array $params = [], $default = null) {
+        foreach ($params as $param) {
+            if ($this->has($param)) {
+                return $this->input($param);
+            }
+        }
+
+        return $default;
+    });
+}
+
+class FleetOpsOrderLifecycleRecorder
+{
+    public static array $events     = [];
+    public static array $dispatched = [];
+}
+
+function fleetopsOrderLifecycleBoot(): 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', fn ($wkt, $srid = 0, $axisOrder = null) => $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', 'order', 'type'],
+        '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', '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', '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' => [],
+            ],
+        ]),
+    ]);
+    FleetOpsOrderLifecycleRecorder::$events = [];
+
+    return $connection;
+}
+
+function fleetopsOrderLifecycleSeedOrder(SQLiteConnection $connection, array $attributes = []): void
+{
+    $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_lifecycle',
+        '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('next activity resolves flow steps and missing orders 404', function () {
+    $connection = fleetopsOrderLifecycleBoot();
+    $controller = new OrderController();
+
+    $missing = $controller->getNextActivity('order_missing', Request::create('/x', 'GET'));
+    expect($missing)->toBeInstanceOf(JsonResponse::class)
+        ->and($missing->getStatusCode())->toBe(404);
+
+    fleetopsOrderLifecycleSeedOrder($connection);
+    $activities = $controller->getNextActivity('order_lifecycle', Request::create('/x', 'GET'));
+    $decoded    = $activities->getData(true);
+    expect(collect($decoded)->pluck('code')->all())->toContain('dispatched');
+});
+
+test('next activity errors when the order has no resolvable order config', function () {
+    $connection = fleetopsOrderLifecycleBoot();
+    fleetopsOrderLifecycleSeedOrder($connection, ['order_config_uuid' => null]);
+
+    // Without the order's own config, its company, or a default transport config
+    // for the session company, `ensureOrderConfig()` has nothing left to resolve
+    $connection->table('order_configs')->delete();
+    $connection->table('companies')->delete();
+
+    $response = (new OrderController())->getNextActivity('order_lifecycle', Request::create('/x', 'GET'));
+
+    expect($response)->toBeInstanceOf(JsonResponse::class)
+        ->and($response->getData(true))->toBe(['error' => 'No order config found for order.']);
+});
+
+test('next activity flags proof of delivery on completing activities', function () {
+    $connection = fleetopsOrderLifecycleBoot();
+    fleetopsOrderLifecycleSeedOrder($connection, ['status' => 'started', 'started' => 1, 'pod_required' => 1, 'pod_method' => 'signature']);
+
+    // Move the flow to started so the next activity completes the order
+    $connection->table('tracking_statuses')->insert(['uuid' => 'ts-1', 'company_uuid' => 'company-1', 'tracking_number_uuid' => 'tn-1', 'code' => 'STARTED', 'status' => 'Started']);
+    $connection->table('tracking_numbers')->where('uuid', 'tn-1')->update(['status_uuid' => 'ts-1']);
+
+    $activities = (new OrderController())->getNextActivity('order_lifecycle', Request::create('/x', 'GET'));
+    $decoded    = collect($activities->getData(true));
+    $completing = $decoded->first(fn ($activity) => ($activity['code'] ?? null) === 'completed');
+
+    expect($completing)->not->toBeNull()
+        ->and($completing['require_pod'] ?? null)->toBeTrue()
+        ->and($completing['pod_method'] ?? null)->toBe('signature');
+});
+
+test('complete order guards incomplete waypoints and cancel cancels', function () {
+    $connection = fleetopsOrderLifecycleBoot();
+    $controller = new OrderController();
+
+    $missing = $controller->completeOrder('order_missing');
+    expect($missing->getStatusCode())->toBe(404);
+
+    // Incomplete waypoint markers block completion
+    fleetopsOrderLifecycleSeedOrder($connection, ['status' => 'started', 'started' => 1]);
+    $connection->table('waypoints')->insert(['uuid' => 'wp-1', 'company_uuid' => 'company-1', 'payload_uuid' => 'payload-1', 'place_uuid' => 'place-p', 'tracking_number_uuid' => 'tn-wp', 'order' => '1']);
+    $connection->table('tracking_numbers')->insert(['uuid' => 'tn-wp', 'company_uuid' => 'company-1', 'tracking_number' => 'TRK-WP', 'status_uuid' => 'ts-wp']);
+    $connection->table('tracking_statuses')->insert(['uuid' => 'ts-wp', 'company_uuid' => 'company-1', 'tracking_number_uuid' => 'tn-wp', 'code' => 'CREATED', 'status' => 'Created']);
+
+    $blocked = $controller->completeOrder('order_lifecycle');
+    expect($blocked->getData(true)['error'])->toContain('Not all waypoints completed');
+
+    // Cancellation runs the cancel transition
+    $canceled = $controller->cancelOrder('order_lifecycle');
+    expect($connection->table('orders')->value('status'))->toBe('canceled');
+
+    expect($controller->cancelOrder('order_missing')->getStatusCode())->toBe(404);
+});
+
+test('set destination validates and persists the current service stop', function () {
+    $connection = fleetopsOrderLifecycleBoot();
+    $controller = new OrderController();
+
+    expect($controller->setDestination('order_missing', 'place-d')->getStatusCode())->toBe(404);
+
+    fleetopsOrderLifecycleSeedOrder($connection);
+
+    // Unknown place keys are rejected
+    $invalid = $controller->setDestination('order_lifecycle', 'place-unknown');
+    expect($invalid->getStatusCode())->toBe(422);
+
+    // Valid destination persists onto the payload
+    $controller->setDestination('order_lifecycle', 'place-d');
+    expect($connection->table('payloads')->value('current_waypoint_uuid'))->toBe('place-d');
+});

package/server/tests/Feature/Http/Api/OrderControllerLookupHelpersTest.php

@@ -0,0 +1,207 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\OrderController;
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Entity;
+use Fleetbase\FleetOps\Models\Order;
+use Fleetbase\FleetOps\Models\Payload;
+use Fleetbase\FleetOps\Models\Waypoint;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
+use Illuminate\Database\SQLiteConnection;
+
+/**
+ * Covers the real bodies of the API OrderController's lookup and resolution
+ * helpers against an in-memory SQLite fixture: order/driver/payload lookups,
+ * proof subject resolution across order/waypoint/entity types, proof scoping,
+ * order comments error handling, and order scheduling.
+ */
+if (!class_exists('Fleetbase\FleetOps\Http\Requests\ScheduleOrderRequest', false) && !class_exists('ScheduleOrderRequestShimLoaded', false)) {
+    // Loads through the FormRequest shim provided by the pest bootstrap.
+    class_exists(Fleetbase\FleetOps\Http\Requests\ScheduleOrderRequest::class);
+}
+
+class FleetOpsApiOrderLookupProbe extends OrderController
+{
+    public ?string $timezone = null;
+
+    public function callProtected(string $method, mixed ...$arguments): mixed
+    {
+        $reflection = new ReflectionMethod(OrderController::class, $method);
+        $reflection->setAccessible(true);
+
+        return $reflection->invoke($this, ...$arguments);
+    }
+
+    protected function defaultCompanyTimezone(): string
+    {
+        return $this->timezone ?? 'Asia/Singapore';
+    }
+}
+
+function fleetopsApiOrderLookupBoot(): SQLiteConnection
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $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);
+        }
+    });
+    app()->instance('db.schema', $connection->getSchemaBuilder());
+    Illuminate\Support\Facades\DB::clearResolvedInstance('db');
+
+    $schema = $connection->getSchemaBuilder();
+    $tables = [
+        'orders'    => ['uuid', 'public_id', 'internal_id', 'company_uuid', 'payload_uuid', 'driver_assigned_uuid', 'status', 'scheduled_at'],
+        'drivers'   => ['uuid', 'public_id', 'company_uuid', 'user_uuid'],
+        'users'     => ['uuid', 'public_id', 'company_uuid'],
+        'payloads'  => ['uuid', 'public_id', 'company_uuid'],
+        'waypoints' => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'place_uuid'],
+        'places'    => ['uuid', 'public_id', 'company_uuid', 'name'],
+        'entities'  => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'name'],
+        'proofs'    => ['uuid', 'public_id', 'company_uuid', 'order_uuid', 'subject_uuid', 'subject_type', 'file_uuid'],
+    ];
+    foreach ($tables as $table => $columns) {
+        $schema->create($table, function ($blueprint) use ($columns) {
+            $blueprint->increments('id');
+            foreach ($columns as $column) {
+                $blueprint->string($column)->nullable();
+            }
+            $blueprint->timestamps();
+            $blueprint->timestamp('deleted_at')->nullable();
+        });
+    }
+
+    session(['company' => 'company-1']);
+
+    return $connection;
+}
+
+test('order and related lookup helpers execute against the database', function () {
+    $connection = fleetopsApiOrderLookupBoot();
+    $connection->table('orders')->insert(['uuid' => 'order-1', 'public_id' => 'order_test', 'company_uuid' => 'company-1']);
+    $connection->table('users')->insert(['uuid' => 'user-1', 'company_uuid' => 'company-1']);
+    $connection->table('drivers')->insert(['uuid' => 'driver-1', 'public_id' => 'driver_test', 'company_uuid' => 'company-1', 'user_uuid' => 'user-1']);
+    $connection->table('payloads')->insert(['uuid' => 'payload-1', 'public_id' => 'payload_test', 'company_uuid' => 'company-1']);
+
+    $probe = new FleetOpsApiOrderLookupProbe();
+
+    expect($probe->callProtected('findOrder', 'order_test'))->toBeInstanceOf(Order::class);
+    expect(fn () => $probe->callProtected('findOrder', 'missing'))->toThrow(ModelNotFoundException::class);
+
+    expect($probe->callProtected('findDriverByPublicId', 'driver_test'))->toBeInstanceOf(Driver::class)
+        ->and($probe->callProtected('findDriverByPublicId', 'missing'))->toBeNull()
+        ->and($probe->callProtected('findDriverByUuid', 'driver-1'))->toBeInstanceOf(Driver::class)
+        ->and($probe->callProtected('findDriverByUuid', 'missing'))->toBeNull();
+
+    expect($probe->callProtected('findPayloadByUuid', 'payload-1'))->toBeInstanceOf(Payload::class)
+        ->and($probe->callProtected('findPayloadByUuid', 'missing'))->toBeNull();
+
+    expect($probe->callProtected('newPayload'))->toBeInstanceOf(Payload::class)
+        ->and($probe->callProtected('sessionCompany'))->toBe('company-1');
+});
+
+test('proof subject resolution covers order waypoint and entity types', function () {
+    $connection = fleetopsApiOrderLookupBoot();
+    $connection->table('waypoints')->insert(['uuid' => 'waypoint-1', 'public_id' => 'waypoint_test', 'payload_uuid' => 'payload-1', 'place_uuid' => 'place-1']);
+    $connection->table('places')->insert(['uuid' => 'place-1', 'public_id' => 'place_test', 'name' => 'Depot']);
+    $connection->table('entities')->insert(['uuid' => 'entity-1', 'public_id' => 'entity_test', 'name' => 'Package']);
+
+    $order = new class extends Order {
+        protected $guarded = [];
+        public $exists     = true;
+    };
+    $order->setRawAttributes(['uuid' => 'order-1', 'payload_uuid' => 'payload-1'], true);
+    $order->setRelation('payload', null);
+
+    $probe = new FleetOpsApiOrderLookupProbe();
+
+    expect($probe->callProtected('resolveSubject', $order, null, null))->toBe($order)
+        ->and($probe->callProtected('resolveSubject', $order, 'unknown-type', 'x'))->toBe($order);
+
+    $waypoint = $probe->callProtected('resolveSubject', $order, 'waypoint', 'waypoint_test');
+    expect($waypoint)->toBeInstanceOf(Waypoint::class)
+        ->and($waypoint->uuid)->toBe('waypoint-1');
+
+    $byPlace = $probe->callProtected('resolveSubject', $order, 'place', 'place_test');
+    expect($byPlace)->toBeInstanceOf(Waypoint::class);
+
+    $entity = $probe->callProtected('resolveSubject', $order, 'entity', 'entity_test');
+    expect($entity)->toBeInstanceOf(Entity::class)
+        ->and($entity->uuid)->toBe('entity-1');
+});
+
+test('proofs for subject scopes to order and subject records', function () {
+    $connection = fleetopsApiOrderLookupBoot();
+    $connection->table('proofs')->insert([
+        ['uuid' => 'proof-1', 'company_uuid' => 'company-1', 'order_uuid' => 'order-1', 'subject_uuid' => 'order-1'],
+        ['uuid' => 'proof-2', 'company_uuid' => 'company-1', 'order_uuid' => 'order-1', 'subject_uuid' => 'waypoint-1'],
+    ]);
+
+    $order = new class extends Order {
+        protected $guarded = [];
+        public $exists     = true;
+    };
+    $order->setRawAttributes(['uuid' => 'order-1'], true);
+    $waypoint = new Waypoint();
+    $waypoint->setRawAttributes(['uuid' => 'waypoint-1'], true);
+
+    $probe = new FleetOpsApiOrderLookupProbe();
+
+    expect($probe->callProtected('proofsForSubject', $order, $order)->count())->toBe(2)
+        ->and($probe->callProtected('proofsForSubject', $order, $waypoint)->count())->toBe(1);
+});
+
+test('order comments endpoint reports missing orders and load failures', function () {
+    fleetopsApiOrderLookupBoot();
+
+    $probe = new FleetOpsApiOrderLookupProbe();
+
+    $missing = $probe->orderComments('missing');
+    expect($missing->getStatusCode())->toBe(404)
+        ->and($missing->getData(true))->toBe(['error' => 'Order resource not found.']);
+
+    // Any other failure while loading comments reports the generic error
+    $failing = new class extends OrderController {
+        protected function findOrder(string $id, array $with = [], array $withCount = []): Order
+        {
+            throw new RuntimeException('comments backend unavailable');
+        }
+    };
+    $broken = $failing->orderComments('order_test');
+    expect($broken->getStatusCode())->toBe(404)
+        ->and($broken->getData(true))->toBe(['error' => 'An error occured trying to get order comments.']);
+});
+
+test('schedule order combines date time and timezone inputs', function () {
+    $connection = fleetopsApiOrderLookupBoot();
+    $connection->table('orders')->insert(['uuid' => 'order-1', 'public_id' => 'order_test', 'company_uuid' => 'company-1']);
+
+    $probe = new FleetOpsApiOrderLookupProbe();
+
+    $request  = Fleetbase\FleetOps\Http\Requests\ScheduleOrderRequest::create('/v1/orders/order_test/schedule', 'POST', [
+        'date' => '2026-08-01',
+        'time' => '14:30:00',
+    ]);
+    $response = $probe->scheduleOrder('order_test', $request);
+
+    expect($connection->table('orders')->value('scheduled_at'))->toContain('2026-08-01 14:30');
+
+    $missing = $probe->scheduleOrder('missing', $request);
+    expect($missing->getStatusCode())->toBe(404)
+        ->and($missing->getData(true))->toBe(['error' => 'Order resource not found.']);
+});