@fleetbase/fleetops-engine 0.6.51 → 0.6.53

package/server/config/telematics.php

@@ -3,219 +3,228 @@
 return [
     'providers' => [
         [
-            'key' => 'flespi',
-            'label' => 'Flespi',
-            'type' => 'native',
-            'driver_class' => \Fleetbase\FleetOps\Support\Telematics\Providers\FlespiProvider::class,
-            'icon' => 'https://flespi.com/favicon.ico',
-            'description' => 'Flespi is a robust telematics platform offering device management, data processing, and API integration.',
-            'docs_url' => 'https://flespi.com/docs',
+            'key'             => 'flespi',
+            'label'           => 'Flespi',
+            'type'            => 'native',
+            'driver_class'    => Fleetbase\FleetOps\Support\Telematics\Providers\FlespiProvider::class,
+            'icon'            => '/engines-dist/images/telematics/providers/flespi.webp',
+            'description'     => 'Flespi is a robust telematics platform offering device management, data processing, and API integration.',
+            'docs_url'        => 'https://flespi.com/docs',
             'required_fields' => [
                 [
-                    'name' => 'token',
-                    'label' => 'Flespi Token',
-                    'type' => 'password',
+                    'name'        => 'token',
+                    'label'       => 'Flespi Token',
+                    'type'        => 'password',
                     'placeholder' => 'Enter your Flespi API token',
-                    'required' => true,
-                    'validation' => 'required|string|min:20',
+                    'required'    => true,
+                    'validation'  => 'required|string|min:20',
                 ],
                 [
-                    'name' => 'webhook_secret',
-                    'label' => 'Webhook Secret (Optional)',
-                    'type' => 'password',
+                    'name'        => 'webhook_secret',
+                    'label'       => 'Webhook Secret (Optional)',
+                    'type'        => 'password',
                     'placeholder' => 'Enter webhook secret for signature validation',
-                    'required' => false,
+                    'required'    => false,
                 ],
             ],
-            'supports_webhooks' => true,
+            'supports_webhooks'  => true,
             'supports_discovery' => true,
-            'metadata' => [
+            'metadata'           => [
                 'rate_limit' => 100,
                 'pagination' => 'offset',
             ],
         ],
 
         [
-            'key' => 'geotab',
-            'label' => 'Geotab',
-            'type' => 'native',
-            'driver_class' => \Fleetbase\FleetOps\Support\Telematics\Providers\GeotabProvider::class,
-            'icon' => 'https://www.geotab.com/favicon.ico',
-            'description' => 'Geotab provides fleet management solutions with GPS tracking, driver safety, and compliance features.',
-            'docs_url' => 'https://developers.geotab.com/',
+            'key'             => 'geotab',
+            'label'           => 'Geotab',
+            'type'            => 'native',
+            'driver_class'    => Fleetbase\FleetOps\Support\Telematics\Providers\GeotabProvider::class,
+            'icon'            => '/engines-dist/images/telematics/providers/geotab.webp',
+            'description'     => 'Geotab provides fleet management solutions with GPS tracking, driver safety, and compliance features.',
+            'docs_url'        => 'https://developers.geotab.com/',
             'required_fields' => [
                 [
-                    'name' => 'database',
-                    'label' => 'Database Name',
-                    'type' => 'text',
+                    'name'        => 'database',
+                    'label'       => 'Database Name',
+                    'type'        => 'text',
                     'placeholder' => 'Enter your Geotab database name',
-                    'required' => true,
+                    'required'    => true,
                 ],
                 [
-                    'name' => 'username',
-                    'label' => 'Username',
-                    'type' => 'text',
+                    'name'        => 'username',
+                    'label'       => 'Username',
+                    'type'        => 'text',
                     'placeholder' => 'Enter your Geotab username',
-                    'required' => true,
+                    'required'    => true,
                 ],
                 [
-                    'name' => 'password',
-                    'label' => 'Password',
-                    'type' => 'password',
+                    'name'        => 'password',
+                    'label'       => 'Password',
+                    'type'        => 'password',
                     'placeholder' => 'Enter your Geotab password',
-                    'required' => true,
+                    'required'    => true,
                 ],
             ],
-            'supports_webhooks' => false,
+            'supports_webhooks'  => false,
             'supports_discovery' => true,
-            'metadata' => [
+            'metadata'           => [
                 'rate_limit' => 50,
-                'auth_type' => 'session',
+                'auth_type'  => 'session',
             ],
         ],
 
         [
-            'key' => 'samsara',
-            'label' => 'Samsara',
-            'type' => 'native',
-            'driver_class' => \Fleetbase\FleetOps\Support\Telematics\Providers\SamsaraProvider::class,
-            'icon' => 'https://www.samsara.com/favicon.ico',
-            'description' => 'Samsara offers IoT solutions for fleet operations, including GPS tracking, dashcams, and asset monitoring.',
-            'docs_url' => 'https://developers.samsara.com/',
+            'key'             => 'samsara',
+            'label'           => 'Samsara',
+            'type'            => 'native',
+            'driver_class'    => Fleetbase\FleetOps\Support\Telematics\Providers\SamsaraProvider::class,
+            'icon'            => '/engines-dist/images/telematics/providers/samsara.webp',
+            'description'     => 'Samsara offers IoT solutions for fleet operations, including GPS tracking, dashcams, and asset monitoring.',
+            'docs_url'        => 'https://developers.samsara.com/',
             'required_fields' => [
                 [
-                    'name' => 'api_token',
-                    'label' => 'API Token',
-                    'type' => 'password',
+                    'name'        => 'api_token',
+                    'label'       => 'API Token',
+                    'type'        => 'password',
                     'placeholder' => 'Enter your Samsara API token',
-                    'required' => true,
-                    'validation' => 'required|string|min:20',
+                    'required'    => true,
+                    'validation'  => 'required|string|min:20',
                 ],
                 [
-                    'name' => 'webhook_secret',
-                    'label' => 'Webhook Secret (Optional)',
-                    'type' => 'password',
+                    'name'        => 'webhook_secret',
+                    'label'       => 'Webhook Secret (Optional)',
+                    'type'        => 'password',
                     'placeholder' => 'Enter webhook secret for signature validation',
-                    'required' => false,
+                    'required'    => false,
                 ],
             ],
-            'supports_webhooks' => true,
+            'supports_webhooks'  => true,
             'supports_discovery' => true,
-            'metadata' => [
+            'metadata'           => [
                 'rate_limit' => 60,
                 'pagination' => 'cursor',
             ],
         ],
 
         [
-            'key' => 'afaqy',
-            'label' => 'AFAQY',
-            'type' => 'native',
-            'driver_class' => \Fleetbase\FleetOps\Support\Telematics\Providers\AfaqyProvider::class,
-            'icon' => 'https://api.afaqy.sa/docs/img/favicon.ico',
-            'description' => 'AFAQY AVL REST integration for unit discovery, live position, speed, heading, odometer, fuel, and signal data.',
-            'docs_url' => 'https://api.afaqy.sa/docs/',
+            'key'             => 'afaqy',
+            'label'           => 'AFAQY',
+            'type'            => 'native',
+            'driver_class'    => Fleetbase\FleetOps\Support\Telematics\Providers\AfaqyProvider::class,
+            'icon'            => '/engines-dist/images/telematics/providers/afaqy.webp',
+            'description'     => 'AFAQY AVL REST integration for unit discovery, live position, speed, heading, odometer, fuel, and signal data.',
+            'docs_url'        => 'https://api.afaqy.sa/docs/',
             'required_fields' => [
                 [
-                    'name' => 'base_url',
-                    'label' => 'Base URL',
-                    'type' => 'text',
-                    'placeholder' => 'https://api.afaqy.sa',
-                    'required' => false,
-                    'validation' => 'nullable|url',
-                ],
-                [
-                    'name' => 'username',
-                    'label' => 'Username',
-                    'type' => 'text',
+                    'name'          => 'base_url',
+                    'label'         => 'Base URL',
+                    'type'          => 'text',
+                    'placeholder'   => 'https://api.afaqy.sa',
+                    'required'      => false,
+                    'advanced'      => true,
+                    'is_endpoint'   => true,
+                    'default_value' => 'https://api.afaqy.sa',
+                    'help_text'     => 'Optional override. Leave blank to use the default AFAQY API host.',
+                    'validation'    => 'nullable|url',
+                ],
+                [
+                    'name'        => 'username',
+                    'label'       => 'Username',
+                    'type'        => 'text',
                     'placeholder' => 'Enter your AFAQY username',
-                    'required' => false,
-                    'validation' => 'required_without:token|string',
+                    'required'    => false,
+                    'validation'  => 'required_without:token|string',
                 ],
                 [
-                    'name' => 'password',
-                    'label' => 'Password',
-                    'type' => 'password',
+                    'name'        => 'password',
+                    'label'       => 'Password',
+                    'type'        => 'password',
                     'placeholder' => 'Enter your AFAQY password',
-                    'required' => false,
-                    'validation' => 'required_without:token|string',
+                    'required'    => false,
+                    'validation'  => 'required_without:token|string',
                 ],
                 [
-                    'name' => 'token',
-                    'label' => 'Token',
-                    'type' => 'password',
+                    'name'        => 'token',
+                    'label'       => 'Token',
+                    'type'        => 'password',
                     'placeholder' => 'Use an existing AFAQY token',
-                    'required' => false,
-                    'validation' => 'required_without:username|string',
+                    'required'    => false,
+                    'validation'  => 'required_without:username|string',
                 ],
             ],
-            'supports_webhooks' => false,
+            'supports_webhooks'  => false,
             'supports_discovery' => true,
-            'metadata' => [
-                'rate_limit' => 60,
-                'pagination' => 'offset',
+            'metadata'           => [
+                'rate_limit'   => 60,
+                'pagination'   => 'offset',
                 'capabilities' => ['tracking', 'speed', 'heading', 'odometer', 'fuel_level', 'ignition'],
             ],
         ],
 
         [
-            'key' => 'safee',
-            'label' => 'Safee Tracking',
-            'type' => 'native',
-            'driver_class' => \Fleetbase\FleetOps\Support\Telematics\Providers\SafeeProvider::class,
-            'description' => 'Safee Tracking REST integration for vehicle discovery, last state, live positions, odometer, fuel, and sensor data.',
+            'key'             => 'safee',
+            'label'           => 'Safee Tracking',
+            'type'            => 'native',
+            'driver_class'    => Fleetbase\FleetOps\Support\Telematics\Providers\SafeeProvider::class,
+            'icon'            => '/engines-dist/images/telematics/providers/safee.webp',
+            'description'     => 'Safee Tracking REST integration for vehicle discovery, last state, live positions, odometer, fuel, and sensor data.',
             'required_fields' => [
                 [
-                    'name' => 'server_uri',
-                    'label' => 'Server URI',
-                    'type' => 'text',
-                    'placeholder' => 'https://tracking.example.com',
-                    'required' => true,
-                    'validation' => 'required|url',
-                ],
-                [
-                    'name' => 'realm_id',
-                    'label' => 'Realm ID',
-                    'type' => 'text',
+                    'name'          => 'server_uri',
+                    'label'         => 'Server URI',
+                    'type'          => 'text',
+                    'placeholder'   => 'https://api.safee.com',
+                    'required'      => false,
+                    'advanced'      => true,
+                    'is_endpoint'   => true,
+                    'default_value' => 'https://api.safee.com',
+                    'help_text'     => 'Optional override. Leave blank to use the default Safee API host.',
+                    'validation'    => 'nullable|url',
+                ],
+                [
+                    'name'        => 'realm_id',
+                    'label'       => 'Realm ID',
+                    'type'        => 'text',
                     'placeholder' => 'Enter Safee realm ID',
-                    'required' => true,
+                    'required'    => true,
                 ],
                 [
-                    'name' => 'client_id',
-                    'label' => 'Client ID',
-                    'type' => 'text',
+                    'name'        => 'client_id',
+                    'label'       => 'Client ID',
+                    'type'        => 'text',
                     'placeholder' => 'Enter Safee client ID',
-                    'required' => true,
+                    'required'    => true,
                 ],
                 [
-                    'name' => 'client_secret',
-                    'label' => 'Client Secret',
-                    'type' => 'password',
+                    'name'        => 'client_secret',
+                    'label'       => 'Client Secret',
+                    'type'        => 'password',
                     'placeholder' => 'Enter Safee client secret',
-                    'required' => true,
+                    'required'    => true,
                 ],
                 [
-                    'name' => 'username',
-                    'label' => 'Username',
-                    'type' => 'text',
+                    'name'        => 'username',
+                    'label'       => 'Username',
+                    'type'        => 'text',
                     'placeholder' => 'Enter Safee username',
-                    'required' => true,
+                    'required'    => true,
                 ],
                 [
-                    'name' => 'password',
-                    'label' => 'Password',
-                    'type' => 'password',
+                    'name'        => 'password',
+                    'label'       => 'Password',
+                    'type'        => 'password',
                     'placeholder' => 'Enter Safee password',
-                    'required' => true,
+                    'required'    => true,
                 ],
             ],
-            'supports_webhooks' => false,
+            'supports_webhooks'  => false,
             'supports_discovery' => true,
-            'metadata' => [
-                'rate_limit' => 3000,
-                'pagination' => 'none',
+            'metadata'           => [
+                'rate_limit'   => 3000,
+                'pagination'   => 'none',
                 'capabilities' => ['tracking', 'speed', 'heading', 'odometer', 'fuel_level', 'ignition'],
             ],
         ],
-    ]
+    ],
 ];

package/server/migrations/2026_06_06_000001_harden_device_events_telematics_contract.php

@@ -0,0 +1,59 @@
+<?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
+    {
+        if (!Schema::hasTable('device_events')) {
+            return;
+        }
+
+        Schema::table('device_events', function (Blueprint $table) {
+            if (!Schema::hasColumn('device_events', 'message')) {
+                $table->text('message')->nullable()->after('severity');
+            }
+
+            if (!Schema::hasColumn('device_events', 'occurred_at')) {
+                $table->timestamp('occurred_at')->nullable()->index()->after('message');
+            }
+
+            if (!Schema::hasColumn('device_events', 'processed_at')) {
+                $table->timestamp('processed_at')->nullable()->index()->after('occurred_at');
+            }
+
+            if (!Schema::hasColumn('device_events', 'data')) {
+                $table->json('data')->nullable()->after('payload');
+            }
+        });
+    }
+
+    public function down(): void
+    {
+        if (!Schema::hasTable('device_events')) {
+            return;
+        }
+
+        Schema::table('device_events', function (Blueprint $table) {
+            if (Schema::hasColumn('device_events', 'data')) {
+                $table->dropColumn('data');
+            }
+
+            if (Schema::hasColumn('device_events', 'processed_at')) {
+                $table->dropIndex(['processed_at']);
+                $table->dropColumn('processed_at');
+            }
+
+            if (Schema::hasColumn('device_events', 'occurred_at')) {
+                $table->dropIndex(['occurred_at']);
+                $table->dropColumn('occurred_at');
+            }
+
+            if (Schema::hasColumn('device_events', 'message')) {
+                $table->dropColumn('message');
+            }
+        });
+    }
+};

package/server/migrations/2026_06_08_000001_create_fuel_provider_connections_table.php

@@ -0,0 +1,37 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up()
+    {
+        Schema::create('fuel_provider_connections', function (Blueprint $table) {
+            $table->increments('id');
+            $table->string('uuid', 191)->nullable()->unique();
+            $table->string('public_id', 191)->nullable()->unique();
+            $table->uuid('company_uuid')->nullable()->index();
+            $table->string('provider', 80)->index();
+            $table->string('name')->nullable();
+            $table->string('environment', 40)->default('production')->index();
+            $table->string('status', 50)->default('configured')->index();
+            $table->json('credentials')->nullable();
+            $table->json('sync_settings')->nullable();
+            $table->json('last_sync_state')->nullable();
+            $table->timestamp('last_synced_at')->nullable()->index();
+            $table->timestamp('last_tested_at')->nullable();
+            $table->text('last_error')->nullable();
+            $table->json('meta')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->unique(['company_uuid', 'provider', 'environment'], 'fuel_provider_connection_unique');
+        });
+    }
+
+    public function down()
+    {
+        Schema::dropIfExists('fuel_provider_connections');
+    }
+};

package/server/migrations/2026_06_08_000002_create_fuel_provider_transactions_table.php

@@ -0,0 +1,53 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up()
+    {
+        Schema::create('fuel_provider_transactions', function (Blueprint $table) {
+            $table->increments('id');
+            $table->string('uuid', 191)->nullable()->unique();
+            $table->string('public_id', 191)->nullable()->unique();
+            $table->uuid('company_uuid')->nullable()->index();
+            $table->uuid('fuel_provider_connection_uuid')->nullable()->index();
+            $table->uuid('fuel_report_uuid')->nullable()->index();
+            $table->uuid('vehicle_uuid')->nullable()->index();
+            $table->uuid('driver_uuid')->nullable()->index();
+            $table->uuid('order_uuid')->nullable()->index();
+            $table->string('provider', 80)->index();
+            $table->string('provider_transaction_id', 191)->index();
+            $table->string('provider_vehicle_id')->nullable()->index();
+            $table->string('vehicle_card_id')->nullable()->index();
+            $table->string('internal_number')->nullable()->index();
+            $table->string('structure_number')->nullable()->index();
+            $table->string('plate_number')->nullable()->index();
+            $table->string('trip_number')->nullable()->index();
+            $table->string('station_name')->nullable()->index();
+            $table->decimal('station_latitude', 10, 7)->nullable();
+            $table->decimal('station_longitude', 10, 7)->nullable();
+            $table->timestamp('transaction_at')->nullable()->index();
+            $table->decimal('volume', 12, 3)->nullable();
+            $table->string('metric_unit', 20)->default('l');
+            $table->unsignedBigInteger('amount')->nullable();
+            $table->string('currency', 10)->default('SAR');
+            $table->string('odometer')->nullable();
+            $table->string('sync_status', 50)->default('imported')->index();
+            $table->timestamp('matched_at')->nullable();
+            $table->json('normalized_payload')->nullable();
+            $table->json('raw_payload')->nullable();
+            $table->json('meta')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+
+            $table->unique(['provider', 'provider_transaction_id'], 'fuel_provider_txn_provider_unique');
+        });
+    }
+
+    public function down()
+    {
+        Schema::dropIfExists('fuel_provider_transactions');
+    }
+};

package/server/migrations/2026_06_08_000003_create_fuel_provider_sync_runs_table.php

@@ -0,0 +1,40 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up()
+    {
+        Schema::create('fuel_provider_sync_runs', function (Blueprint $table) {
+            $table->increments('id');
+            $table->string('uuid', 191)->nullable()->unique();
+            $table->string('public_id', 191)->nullable()->unique();
+            $table->uuid('company_uuid')->nullable()->index();
+            $table->uuid('fuel_provider_connection_uuid')->nullable()->index();
+            $table->string('provider', 80)->index();
+            $table->string('status', 50)->default('queued')->index();
+            $table->timestamp('from')->nullable();
+            $table->timestamp('to')->nullable();
+            $table->unsignedInteger('imported')->default(0);
+            $table->unsignedInteger('matched')->default(0);
+            $table->unsignedInteger('unmatched')->default(0);
+            $table->unsignedInteger('fuel_reports_created')->default(0);
+            $table->decimal('liters', 12, 3)->default(0);
+            $table->unsignedBigInteger('amount')->default(0);
+            $table->timestamp('started_at')->nullable();
+            $table->timestamp('finished_at')->nullable();
+            $table->text('error')->nullable();
+            $table->json('summary')->nullable();
+            $table->json('meta')->nullable();
+            $table->softDeletes();
+            $table->timestamps();
+        });
+    }
+
+    public function down()
+    {
+        Schema::dropIfExists('fuel_provider_sync_runs');
+    }
+};

package/server/migrations/2026_06_10_000001_add_fuel_card_number_to_vehicles_table.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()
+    {
+        if (!Schema::hasColumn('vehicles', 'fuel_card_number')) {
+            Schema::table('vehicles', function (Blueprint $table) {
+                $table->string('fuel_card_number')->nullable()->index()->after('call_sign');
+            });
+        }
+    }
+
+    public function down()
+    {
+        if (Schema::hasColumn('vehicles', 'fuel_card_number')) {
+            Schema::table('vehicles', function (Blueprint $table) {
+                $table->dropColumn('fuel_card_number');
+            });
+        }
+    }
+};

package/server/migrations/2026_06_10_000002_add_vehicle_identity_columns_to_fuel_provider_transactions_table.php

@@ -0,0 +1,39 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    public function up()
+    {
+        if (!Schema::hasColumn('fuel_provider_transactions', 'vin')) {
+            Schema::table('fuel_provider_transactions', function (Blueprint $table) {
+                $table->string('vin')->nullable()->index()->after('plate_number');
+            });
+        }
+
+        if (!Schema::hasColumn('fuel_provider_transactions', 'serial_number')) {
+            Schema::table('fuel_provider_transactions', function (Blueprint $table) {
+                $table->string('serial_number')->nullable()->index()->after('vin');
+            });
+        }
+
+        if (!Schema::hasColumn('fuel_provider_transactions', 'call_sign')) {
+            Schema::table('fuel_provider_transactions', function (Blueprint $table) {
+                $table->string('call_sign')->nullable()->index()->after('serial_number');
+            });
+        }
+    }
+
+    public function down()
+    {
+        foreach (['call_sign', 'serial_number', 'vin'] as $column) {
+            if (Schema::hasColumn('fuel_provider_transactions', $column)) {
+                Schema::table('fuel_provider_transactions', function (Blueprint $table) use ($column) {
+                    $table->dropColumn($column);
+                });
+            }
+        }
+    }
+};