@fleetbase/fleetops-engine 0.6.65 → 0.6.66

package/server/config/telemetry.php

@@ -0,0 +1,17 @@
+<?php
+
+return [
+    'polling_enabled'           => false,
+    'webhooks_enabled'          => false,
+    'poll_queue'                => env('TELEMATICS_POLL_QUEUE', 'default'),
+    'ingestion_queue'           => env('TELEMATICS_INGESTION_QUEUE', 'default'),
+    'page_size'                 => 1000,
+    'max_pages'                 => 100,
+    'batch_size'                => 100,
+    'max_payload_bytes'         => 2097152,
+    'max_pending_deliveries'    => 10000,
+    'processed_retention_hours' => 24,
+    'quarantine_retention_days' => 7,
+    'stale_engine_on_seconds'   => 120,
+    'stale_engine_off_seconds'  => 600,
+];

package/server/migrations/2026_09_09_000001_create_inspection_tables.php

@@ -0,0 +1,152 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('inspection_forms', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->string('public_id', 191)->nullable()->unique()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+
+            $table->string('name')->index();
+            $table->text('description')->nullable();
+            $table->string('type')->default('dvir')->index();
+            $table->string('status')->default('draft')->index();
+            $table->string('frequency')->nullable()->index();
+
+            $table->string('subject_type')->nullable();
+            $table->uuid('subject_uuid')->nullable();
+            $table->index(['subject_type', 'subject_uuid']);
+
+            $table->json('items')->nullable();
+            $table->json('settings')->nullable();
+            $table->json('meta')->nullable();
+            $table->timestamp('published_at')->nullable()->index();
+
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'status', 'type']);
+        });
+
+        Schema::create('inspection_links', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->string('public_id', 191)->nullable()->unique()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('inspection_form_uuid')->constrained('inspection_forms', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('driver_uuid')->nullable()->constrained('drivers', 'uuid')->nullOnDelete();
+            $table->foreignUuid('vehicle_uuid')->nullable()->constrained('vehicles', 'uuid')->nullOnDelete();
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->string('token_hash', 191)->unique();
+            $table->string('status')->default('active')->index();
+            $table->boolean('single_use')->default(true)->index();
+            $table->timestamp('expires_at')->nullable()->index();
+            $table->timestamp('last_viewed_at')->nullable();
+            $table->timestamp('used_at')->nullable()->index();
+            $table->string('used_ip')->nullable();
+            $table->text('used_user_agent')->nullable();
+            $table->json('meta')->nullable();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'inspection_form_uuid', 'status']);
+        });
+
+        Schema::create('inspection_submissions', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->string('public_id', 191)->nullable()->unique()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('inspection_form_uuid')->nullable()->constrained('inspection_forms', 'uuid')->nullOnDelete();
+            $table->foreignUuid('vehicle_uuid')->nullable()->constrained('vehicles', 'uuid')->nullOnDelete();
+            $table->foreignUuid('driver_uuid')->nullable()->constrained('drivers', 'uuid')->nullOnDelete();
+            $table->foreignUuid('submitted_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('issue_uuid')->nullable()->constrained('issues', 'uuid')->nullOnDelete();
+            $table->foreignUuid('work_order_uuid')->nullable()->constrained('work_orders', 'uuid')->nullOnDelete();
+
+            $table->string('type')->default('dvir')->index();
+            $table->string('status')->default('draft')->index();
+            $table->string('result')->nullable()->index();
+            $table->string('source')->nullable()->index();
+            $table->unsignedBigInteger('odometer')->nullable();
+            $table->unsignedBigInteger('engine_hours')->nullable();
+            $table->unsignedInteger('total_items')->default(0);
+            $table->unsignedInteger('failed_items')->default(0);
+            $table->timestamp('started_at')->nullable()->index();
+            $table->timestamp('submitted_at')->nullable()->index();
+            $table->timestamp('resolved_at')->nullable()->index();
+
+            $table->json('location')->nullable();
+            $table->json('signature')->nullable();
+            $table->json('attachments')->nullable();
+            $table->json('meta')->nullable();
+
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'status', 'result']);
+            $table->index(['vehicle_uuid', 'submitted_at']);
+        });
+
+        Schema::create('inspection_item_results', function (Blueprint $table) {
+            $table->increments('id');
+            $table->uuid('uuid')->index();
+            $table->string('_key')->nullable()->index();
+            $table->foreignUuid('company_uuid')->constrained('companies', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('inspection_submission_uuid')->constrained('inspection_submissions', 'uuid')->cascadeOnDelete();
+            $table->foreignUuid('issue_uuid')->nullable()->constrained('issues', 'uuid')->nullOnDelete();
+            $table->foreignUuid('work_order_uuid')->nullable()->constrained('work_orders', 'uuid')->nullOnDelete();
+
+            $table->string('item_key')->nullable()->index();
+            $table->string('label')->index();
+            $table->string('category')->nullable()->index();
+            $table->string('status')->default('passed')->index();
+            $table->string('severity')->nullable()->index();
+            $table->boolean('passed')->default(true)->index();
+            $table->text('comments')->nullable();
+            $table->json('photos')->nullable();
+            $table->json('meta')->nullable();
+
+            $table->foreignUuid('created_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+            $table->foreignUuid('updated_by_uuid')->nullable()->constrained('users', 'uuid')->nullOnDelete();
+
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->index(['company_uuid', 'passed', 'severity']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('inspection_item_results');
+        Schema::dropIfExists('inspection_submissions');
+        Schema::dropIfExists('inspection_links');
+        Schema::dropIfExists('inspection_forms');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2026_09_10_000001_convert_inspection_form_items_to_field_groups.php

@@ -0,0 +1,44 @@
+<?php
+
+use Fleetbase\FleetOps\Models\InspectionForm;
+use Fleetbase\FleetOps\Support\InspectionFormSync;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Folds the first cut's `items` checklist into the second cut's structure.
+ *
+ * A form used to be a JSON list of pass/fail items; it is now groups of typed
+ * fields. Rather than ask an operator to rebuild every form by hand, each
+ * legacy checklist becomes a "Checklist" group of `pass-fail` fields carrying
+ * the same labels and severities. `items` is left in place, read-only, for one
+ * release, so a console or app that has not been updated still renders.
+ *
+ * Idempotent: a form that already has fields is skipped, so re-running this —
+ * or running it after a form has been rebuilt in the builder — changes
+ * nothing. There is no down: dropping fields that an operator may since have
+ * edited would lose work, and `items` was never removed.
+ */
+return new class extends Migration {
+    public function up(): void
+    {
+        if (!Schema::hasTable('inspection_forms') || !Schema::hasTable('custom_fields') || !Schema::hasTable('categories')) {
+            return;
+        }
+
+        InspectionForm::query()
+            ->whereNotNull('items')
+            ->orderBy('id')
+            ->chunkById(100, function ($forms) {
+                foreach ($forms as $form) {
+                    InspectionFormSync::convertLegacyItems($form);
+                }
+            });
+    }
+
+    public function down(): void
+    {
+        // Nothing to undo: `items` was never removed, and the fields written
+        // here may have been edited since.
+    }
+};

package/server/migrations/2026_09_10_000002_add_token_to_inspection_links.php

@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Keep the inspection link itself, not only its fingerprint.
+ *
+ * A link was stored as `token_hash` alone, which is right for looking one up
+ * and wrong for everything an operator needs afterwards. Once the modal that
+ * minted it closed, nobody could see the link again: not to send it a second
+ * time, not to check which vehicle it was for, not to tell an expired link
+ * from a live one. The only recourse was to mint another.
+ *
+ * So the token is kept alongside its hash, encrypted at rest with the
+ * application key. It is a capability URL — it grants filling in one published
+ * form, once, for one vehicle, until it expires — not a credential, and being
+ * able to re-read one is how every share link behaves.
+ *
+ * `token_hash` stays exactly as it is: it is the unique index a public request
+ * is resolved through, and nothing about the lookup path changes. Links minted
+ * before this migration keep a null token and are shown without their URL.
+ */
+return new class extends Migration {
+    public function up()
+    {
+        Schema::table('inspection_links', function (Blueprint $table) {
+            $table->text('token')->nullable()->after('token_hash');
+        });
+    }
+
+    public function down()
+    {
+        Schema::table('inspection_links', function (Blueprint $table) {
+            $table->dropColumn('token');
+        });
+    }
+};

package/server/migrations/2026_09_11_000001_add_assignee_and_pin_to_inspection_links.php

@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Let an inspection link be meant for anyone, and protect it with a PIN.
+ *
+ * A link could name a driver, and nobody else. Inspections are completed by
+ * anyone in the organisation, so a link can now be assigned to any user;
+ * the driver and vehicle stay as optional details of the inspection itself.
+ *
+ * A link now carries a PIN: a second thing to know alongside the link, which
+ * can be sent to the assignee by email or SMS, or read out. It is kept hashed
+ * for checking and encrypted so the console can show it again, and wrong
+ * guesses are counted so the link locks after a few.
+ */
+return new class extends Migration {
+    public function up()
+    {
+        Schema::table('inspection_links', function (Blueprint $table) {
+            $table->foreignUuid('assignee_uuid')->nullable()->after('vehicle_uuid')->constrained('users', 'uuid')->nullOnDelete();
+            $table->string('pin_hash')->nullable()->after('token');
+            $table->text('pin')->nullable()->after('pin_hash');
+            $table->unsignedSmallInteger('pin_attempts')->default(0)->after('pin');
+            $table->string('pin_sent_via', 20)->nullable()->after('pin_attempts');
+            $table->timestamp('pin_sent_at')->nullable()->after('pin_sent_via');
+        });
+    }
+
+    public function down()
+    {
+        Schema::table('inspection_links', function (Blueprint $table) {
+            $table->dropConstrainedForeignId('assignee_uuid');
+            $table->dropColumn(['pin_hash', 'pin', 'pin_attempts', 'pin_sent_via', 'pin_sent_at']);
+        });
+    }
+};

package/server/migrations/2026_09_15_000001_create_telematic_telemetry_tables.php

@@ -0,0 +1,62 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        Schema::table('devices', fn (Blueprint $table) => $table->index(['company_uuid', 'telematic_uuid', 'device_id'], 'devices_telematic_lookup'));
+        Schema::create('telematic_sync_runs', function (Blueprint $table) {
+            $table->uuid('uuid')->primary();
+            $table->uuid('telematic_uuid')->index();
+            $table->string('status')->default('fetching')->index();
+            $table->unsignedInteger('pages')->default(0);
+            $table->unsignedInteger('units')->default(0);
+            $table->unsignedInteger('applied')->default(0);
+            $table->unsignedInteger('failed')->default(0);
+            $table->text('error')->nullable();
+            $table->timestamps();
+        });
+        Schema::create('telematic_deliveries', function (Blueprint $table) {
+            $table->uuid('uuid')->primary();
+            $table->uuid('telematic_uuid')->index();
+            $table->uuid('run_uuid')->nullable()->index();
+            $table->string('source', 16);
+            $table->string('status', 24)->default('pending');
+            $table->char('payload_hash', 64);
+            $table->longText('payload');
+            $table->longText('retry_payload')->nullable();
+            $table->unsignedInteger('invalid_count')->default(0);
+            $table->unsignedInteger('attempts')->default(0);
+            $table->unsignedInteger('queue_delay_seconds')->nullable();
+            $table->unsignedInteger('source_delay_seconds')->nullable();
+            $table->unsignedInteger('applied')->default(0);
+            $table->unsignedInteger('failed')->default(0);
+            $table->text('error')->nullable();
+            $table->timestamp('received_at');
+            $table->timestamp('available_at')->nullable();
+            $table->timestamp('processed_at')->nullable();
+            $table->timestamps();
+            $table->index(['status', 'available_at']);
+            $table->index(['status', 'updated_at']);
+            $table->index(['telematic_uuid', 'status']);
+            $table->index(['telematic_uuid', 'received_at']);
+            $table->index(['telematic_uuid', 'source', 'received_at']);
+        });
+        Schema::create('telematic_webhook_credentials', function (Blueprint $table) {
+            $table->uuid('telematic_uuid')->primary();
+            $table->text('token');
+            $table->timestamps();
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('devices', fn (Blueprint $table) => $table->dropIndex('devices_telematic_lookup'));
+        Schema::dropIfExists('telematic_webhook_credentials');
+        Schema::dropIfExists('telematic_deliveries');
+        Schema::dropIfExists('telematic_sync_runs');
+    }
+};

package/server/migrations/2026_09_15_000002_scope_fuel_transactions_to_connection.php

@@ -0,0 +1,25 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up(): void
+    {
+        Schema::table('fuel_provider_transactions', function (Blueprint $table) {
+            $table->unique(['company_uuid', 'fuel_provider_connection_uuid', 'provider', 'active_provider_transaction_id'], 'fuel_provider_txn_connection_unique');
+            $table->dropUnique('fuel_provider_txn_company_provider_unique');
+        });
+    }
+
+    public function down(): void
+    {
+        // Restore the tighter constraint first; rollback must fail rather than
+        // silently discard distinct sandbox and production transactions.
+        Schema::table('fuel_provider_transactions', function (Blueprint $table) {
+            $table->unique(['company_uuid', 'provider', 'active_provider_transaction_id'], 'fuel_provider_txn_company_provider_unique');
+            $table->dropUnique('fuel_provider_txn_connection_unique');
+        });
+    }
+};

package/server/migrations/2026_09_16_000001_add_public_id_to_alerts_table.php

@@ -0,0 +1,45 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Give the core `alerts` table the `public_id` its model writes.
+     *
+     * `Fleetbase\Models\Alert` uses `HasPublicId`, whose creating hook checks
+     * `alerts.public_id` for a collision before assigning one, but the core
+     * migration never created the column. Every alert insert therefore fails
+     * with "Unknown column 'public_id'": Radar's acknowledge and snooze (which
+     * create a state row on first use), and the low-stock, sensor and device
+     * event alerts FleetOps already raises.
+     *
+     * Guarded, so it is a no-op wherever core-api adds the column itself.
+     */
+    public function up(): void
+    {
+        if (!Schema::hasTable('alerts') || Schema::hasColumn('alerts', 'public_id')) {
+            return;
+        }
+
+        Schema::table('alerts', function (Blueprint $table) {
+            $table->string('public_id', 191)->nullable()->unique()->after('uuid');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        if (!Schema::hasTable('alerts') || !Schema::hasColumn('alerts', 'public_id')) {
+            return;
+        }
+
+        Schema::table('alerts', function (Blueprint $table) {
+            $table->dropUnique(['public_id']);
+            $table->dropColumn('public_id');
+        });
+    }
+};

package/server/resources/views/mail/inspection-link-pin.blade.php

@@ -0,0 +1,34 @@
+@php
+    // Strings are built here, not inline: Blade only reads `@` as a directive
+    // when it does not follow a word character, so `inspection@if(...)` would
+    // stay literal text while its `@endif` compiled and broke the view.
+    $formName    = $form?->name ?: 'inspection';
+    $vehicleName = $vehicle ? ($vehicle->display_name ?? $vehicle->name) : null;
+    $forVehicle  = $vehicleName ? ' for ' . $vehicleName : '';
+    $senderLine  = $sender?->name ? $sender->name . ' has asked you to complete this inspection.' : 'You have been asked to complete this inspection.';
+@endphp
+<x-mail-layout>
+<h2 style="font-size: 18px; font-weight: 600;">Complete the {{ $formName }} inspection</h2>
+
+@if($recipient && $recipient->name)
+<p>Hi {{ $recipient->name }},</p>
+@endif
+
+<p>{{ $senderLine }} It is the <strong>{{ $formName }}</strong> inspection{{ $forVehicle }}.</p>
+
+@if($url)
+<p style="margin: 24px 0;"><a href="{{ $url }}" style="display: inline-block; background-color: #2563eb; color: #ffffff; text-decoration: none; font-weight: 600; padding: 10px 18px; border-radius: 6px;">Open the inspection</a></p>
+@endif
+
+<p>When it asks, enter this PIN:</p>
+
+<p style="font-size: 28px; font-weight: 700; letter-spacing: 6px; font-family: ui-monospace, Menlo, Consolas, monospace; margin: 16px 0 20px;">{{ $pin }}</p>
+
+<p>The link locks after {{ $maxAttempts }} incorrect PINs.@if($expiresAt) It expires on {{ $expiresAt->format('j M Y, H:i T') }}.@endif</p>
+
+@if($url)
+<p style="color: #6b7280; font-size: 13px;">If the button does not work, copy this address into your browser:<br><span style="word-break: break-all;">{{ $url }}</span></p>
+@endif
+
+<p style="color: #6b7280; font-size: 13px;">If you were not expecting this, you can ignore it. Do not forward this email: anyone with it can open the inspection.</p>
+</x-mail-layout>

package/server/src/Auth/Schemas/FleetOps.php

@@ -125,6 +125,14 @@ class FleetOps
             'name'    => 'work-order',
             'actions' => ['export', 'import'],
         ],
+        [
+            'name'    => 'inspection-form',
+            'actions' => ['publish', 'archive'],
+        ],
+        [
+            'name'    => 'inspection-submission',
+            'actions' => ['submit', 'create-issue', 'create-work-order', 'resolve'],
+        ],
         [
             'name'    => 'equipment',
             'actions' => ['export', 'import'],
@@ -297,6 +305,8 @@ class FleetOps
                 'see extension',
                 '* maintenance',
                 '* work-order',
+                '* inspection-form',
+                '* inspection-submission',
                 '* equipment',
                 '* part',
                 '* trailer',
@@ -322,6 +332,8 @@ class FleetOps
                 '* place',
                 '* maintenance',
                 '* work-order',
+                '* inspection-form',
+                '* inspection-submission',
                 '* equipment',
                 '* part',
                 '* trailer',

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

@@ -0,0 +1,82 @@
+<?php
+
+namespace Fleetbase\FleetOps\Console\Commands;
+
+use Fleetbase\FleetOps\Contracts\TelemetryProviderInterface;
+use Fleetbase\FleetOps\Jobs\ProcessTelematicDelivery;
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Support\Telematics\TelematicProviderRegistry;
+use Fleetbase\FleetOps\Support\Telematics\Telemetry\Configuration;
+use Fleetbase\FleetOps\Support\Telematics\Telemetry\Inbox;
+use Fleetbase\FleetOps\Support\Telematics\Telemetry\Queue;
+use Illuminate\Console\Command;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
+
+class DrainTelematicInbox extends Command
+{
+    protected $signature   = 'fleetops:drain-telematic-inbox';
+    protected $description = 'Recover pending telematic deliveries and expire retained payloads.';
+
+    public function handle(): int
+    {
+        $registry         = app(TelematicProviderRegistry::class);
+        $webhookProviders = [];
+        foreach ($registry->all() as $descriptor) {
+            if (!data_get($descriptor->metadata, 'telemetry.durable_ingestion', false)) {
+                continue;
+            }
+            try {
+                $provider = $registry->resolve($descriptor->key);
+                if ($provider instanceof TelemetryProviderInterface
+                    && (Configuration::options($provider)['webhooks_enabled'] ?? false)) {
+                    $webhookProviders[] = $descriptor->key;
+                }
+            } catch (\Throwable $e) {
+                Log::warning('Telemetry provider configuration unavailable during inbox recovery.', ['provider' => $descriptor->key, 'exception' => class_basename($e)]);
+            }
+        }
+        // Exclude paused webhook sources before applying the dispatch limit, so
+        // one paused integration cannot starve polling or other providers.
+        $pending = DB::table('telematic_deliveries')->leftJoin('telematics', 'telematics.uuid', '=', 'telematic_deliveries.telematic_uuid')
+            ->whereIn('telematic_deliveries.status', ['pending', 'retry', 'processing'])
+            ->where('available_at', '<=', now())
+            ->where(function ($query) use ($webhookProviders) {
+                $query->where('source', '!=', 'webhook')->orWhereIn('telematics.provider', $webhookProviders)->orWhereNull('telematics.uuid');
+            });
+        $optionsByConnection = [];
+        foreach ($pending->orderBy('available_at')->limit(1000)->get(['telematic_deliveries.uuid', 'telematic_deliveries.telematic_uuid']) as $row) {
+            try {
+                if (!isset($optionsByConnection[$row->telematic_uuid])) {
+                    $connection                                = Telematic::withoutGlobalScopes()->where('uuid', $row->telematic_uuid)->first();
+                    $optionsByConnection[$row->telematic_uuid] = $connection ? Configuration::forConnection($connection) : [];
+                }
+            } catch (\InvalidArgumentException) {
+                DB::table('telematic_deliveries')->where('uuid', $row->uuid)->update(['status' => 'quarantined', 'error' => 'Provider configuration unavailable; inspect and replay.', 'updated_at' => now()]);
+                continue;
+            }
+            try {
+                Queue::dispatch((new ProcessTelematicDelivery($row->uuid))->onQueue($optionsByConnection[$row->telematic_uuid]['ingestion_queue'] ?? 'default'));
+            } catch (\Throwable) {
+                // A broker outage must not prevent retention cleanup; retry the next minute.
+                break;
+            }
+        }
+        // Bound deletes so retention cleanup cannot monopolize the inbox table.
+        foreach (['processed' => now()->subHours(config('telematics.telemetry.processed_retention_hours', 24)), 'quarantined' => now()->subDays(config('telematics.telemetry.quarantine_retention_days', 7))] as $status => $cutoff) {
+            for ($batch = 0; $batch < 20; $batch++) {
+                $ids = DB::table('telematic_deliveries')->where('status', $status)->where('updated_at', '<', $cutoff)->limit(1000)->pluck('uuid');
+                if ($ids->isEmpty()) {
+                    break;
+                }
+                DB::table('telematic_deliveries')->whereIn('uuid', $ids)->delete();
+            }
+        }
+        DB::table('telematic_sync_runs')->where('status', 'fetching')->where('updated_at', '<', now()->subMinutes(5))
+            ->update(['status' => 'incomplete', 'error' => 'Worker interrupted; next scheduled sweep will recover.']);
+        DB::table('telematic_sync_runs')->where('status', 'ingesting')->get(['uuid'])->each(fn ($run) => Inbox::finishRun($run->uuid));
+        DB::table('telematic_sync_runs')->where('updated_at', '<', now()->subDays(7))->delete();
+
+        return self::SUCCESS;
+    }
+}

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

@@ -93,7 +93,10 @@ class ProcessMaintenanceTriggers extends Command
                     'company_uuid'    => $schedule->company_uuid,
                     'schedule_uuid'   => $schedule->uuid,
                     'subject'         => $schedule->name,
-                    'category'        => 'preventive_maintenance',
+                    // An inspection schedule produces an inspection request,
+                    // not preventive maintenance, so the work order reads as
+                    // what it is.
+                    'category'        => $schedule->type === 'inspection' ? 'inspection_request' : 'preventive_maintenance',
                     'code'            => $woCode,
                     'status'          => 'open',
                     'priority'        => $schedule->default_priority ?? 'normal',

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

@@ -40,7 +40,37 @@ class SyncTelematics extends Command
                 return self::SUCCESS;
             }
 
-            $query = Telematic::withoutGlobalScopes()
+            $telemetryProviders = [];
+            foreach ($providerKeys as $key) {
+                if (!data_get($registry->findByKey($key)?->metadata, 'telemetry.durable_ingestion', false)) {
+                    continue;
+                }
+                $provider = $registry->resolve($key);
+                if (!$provider instanceof \Fleetbase\FleetOps\Contracts\TelemetryProviderInterface) {
+                    continue;
+                }
+                $options = \Fleetbase\FleetOps\Support\Telematics\Telemetry\Configuration::options($provider);
+                if (!($options['polling_enabled'] ?? false)) {
+                    continue;
+                }
+                $telemetryProviders[] = $key;
+                Telematic::withoutGlobalScopes()->where('provider', $key)->whereIn('status', ['active', 'connected', 'error', 'synchronizing'])
+                    ->whereNotNull('company_uuid')->orderBy('id')->chunkById(100, function ($connections) use ($options) {
+                        foreach ($connections as $connection) {
+                            if (\Fleetbase\FleetOps\Support\Telematics\Telemetry\Inbox::enabled($connection)) {
+                                try {
+                                    \Fleetbase\FleetOps\Support\Telematics\Telemetry\Queue::dispatch((new \Fleetbase\FleetOps\Jobs\PollTelematicTelemetry($connection->uuid))
+                                        ->onQueue($options['poll_queue'] ?? 'default')
+                                        ->delay(now()->addSeconds(abs(crc32($connection->uuid)) % 10)));
+                                } catch (\Throwable) {
+                                    \Illuminate\Support\Facades\Log::warning('Telemetry polling dispatch failed; next tick will retry.', ['telematic_uuid' => $connection->uuid]);
+                                }
+                            }
+                        }
+                    });
+            }
+            $providerKeys = array_values(array_diff($providerKeys, $telemetryProviders));
+            $query        = Telematic::withoutGlobalScopes()
                 ->whereIn('provider', $providerKeys)
                 ->whereIn('status', ['active', 'connected'])
                 ->whereNotNull('company_uuid');
@@ -80,7 +110,7 @@ class SyncTelematics extends Command
                     return false;
                 }
 
-                return !$excludeWebhookProviders || !$descriptor->supportsWebhooks;
+                return data_get($descriptor->metadata, 'telemetry.reconciliation', false) || !$excludeWebhookProviders || !$descriptor->supportsWebhooks;
             })
             ->keys()
             ->values()