@fleetbase/fleetops-engine 0.6.20 → 0.6.21

package/addon/styles/fleetops-engine.css

@@ -1689,3 +1689,160 @@ main.console-fleet-ops-operations-orders-index-index section.next-view-section >
     padding-left: 0.5rem;
     padding-right: 2rem;
 }
+
+.positions-replay-component {
+    width: 100%;
+    max-width: 100%;
+}
+
+.positions-replay-component .metric-card {
+    padding: 0.75rem;
+    border-radius: 0.5rem;
+    background-color: rgba(0, 0, 0, 2%);
+    transition: all 0.2s ease-in-out;
+}
+
+.positions-replay-component .metric-card:hover {
+    background-color: rgba(0, 0, 0, 4%);
+    box-shadow: 0 4px 6px rgba(0, 0, 0, 10%);
+}
+
+body[data-theme='dark'] .positions-replay-component .metric-card {
+    background-color: rgba(255, 255, 255, 5%);
+}
+
+body[data-theme='dark'] .positions-replay-component .metric-card:hover {
+    background-color: rgba(255, 255, 255, 8%);
+}
+
+.positions-replay-component .metric-label {
+    font-size: 0.65rem;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    margin-bottom: 0.25rem;
+}
+
+.positions-replay-component .metric-value {
+    font-size: 0.85rem;
+    line-height: 1;
+}
+
+.positions-replay-component .positions-replay-map-container {
+    overflow: hidden;
+    height: 100%;
+    width: 100%;
+}
+
+.positions-replay-component .replay-controls {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    flex-wrap: wrap;
+    gap: 1rem;
+}
+
+.positions-replay-component .speed-control {
+    display: flex;
+    align-items: center;
+}
+
+.positions-replay-component .speed-control > select.speed-select {
+    height: 1.7rem;
+    font-size: 0.85rem;
+    line-height: 0.85rem;
+    text-align: center;
+    padding: 0 2rem 0 0.75rem;
+}
+
+.positions-replay-component .replay-progress {
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+}
+
+.positions-replay-component .progress-bar {
+    position: relative;
+    overflow: hidden;
+    border-radius: 9999px;
+}
+
+.positions-replay-component .progress-fill {
+    height: 100%;
+    background: linear-gradient(90deg, #3b82f6, #2563eb);
+    transition: width 0.3s ease-in-out;
+}
+
+.positions-replay-component .map-wrapper {
+    position: relative;
+    width: 100%;
+}
+
+.positions-replay-component .positions-replay-map {
+    width: 100%;
+    height: 100%;
+}
+
+.positions-replay-component .positions-replay-timeline {
+    margin-top: 1rem;
+}
+
+.positions-replay-component .timeline-container {
+    position: relative;
+}
+
+.positions-replay-component .timeline-track {
+    display: flex;
+    padding-bottom: 1rem;
+    min-width: min-content;
+}
+
+.positions-replay-component .timeline-item {
+    position: relative;
+    min-width: 80px;
+    padding: 0.5rem;
+    border-radius: 0.375rem;
+    transition: all 0.2s ease-in-out;
+}
+
+.positions-replay-component .timeline-item:hover {
+    transform: translateY(-2px);
+}
+
+.positions-replay-component .timeline-marker {
+    width: 0.75rem;
+    height: 0.75rem;
+    border-radius: 50%;
+    margin: 0 auto 0.25rem;
+    transition: all 0.2s ease-in-out;
+}
+
+.positions-replay-component .timeline-item:hover .timeline-marker {
+    transform: scale(1.3);
+}
+
+.positions-replay-component .timeline-content {
+    text-align: center;
+    white-space: nowrap;
+}
+
+.positions-replay-component .positions-replay-table table {
+    width: 100%;
+    border-collapse: collapse;
+}
+
+.positions-replay-component .positions-replay-table th {
+    position: sticky;
+    top: 0;
+    z-index: 10;
+    white-space: nowrap;
+    text-overflow: ellipsis;
+    font-size: 0.65rem;
+}
+
+.positions-replay-component .empty-state {
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    min-height: 400px;
+}

package/addon/templates/connectivity/devices/index/details/index.hbs

@@ -1,2 +1,2 @@
-
-{{outlet}}
+<Device::Details @resource={{@model}} />
+<Spacer @height="200px" />

package/addon/templates/connectivity/devices/index/details.hbs

@@ -1,2 +1,15 @@
-
-{{outlet}}
+<Layout::Resource::Panel
+    @resource={{@model}}
+    @controller={{this}}
+    @headerComponent={{component "device/panel-header" resource=@model}}
+    @headerTitle={{or @model.name @model.serial_number}}
+    @actionButtons={{this.actionButtons}}
+    @onPressCancel={{transition-to "connectivity.devices.index"}}
+    @onOverlayReady={{fn (mut this.overlay)}}
+    @headerClass="no-bottom-border"
+    @bodyClass="no-scroll"
+>
+    <TabNavigation @tabs={{this.tabs}} @contentClass="scrollable" @tablistClass="pl-2">
+        {{outlet}}
+    </TabNavigation>
+</Layout::Resource::Panel>

package/addon/templates/connectivity/devices/index/edit.hbs

@@ -1,7 +1,7 @@
 <Layout::Resource::Panel
     @resource={{@model}}
     @controller={{this}}
-    @headerTitle={{concat "Edit: " @model.name}}
+    @headerTitle={{concat "Edit: " (or @model.name @model.serial_number)}}
     @actionButtons={{this.actionButtons}}
     @saveTask={{this.save}}
     @onPressCancel={{this.cancel}}

package/addon/templates/connectivity/events/index.hbs

@@ -1,6 +1,6 @@
 <Layout::Resource::Tabular
     @resource="device-event"
-    @title={{t "resource.device-events"}}
+    @title="Connectivity Events"
     @searchQuery={{this.query}}
     @onSearch={{perform this.deviceEventActions.controllerSearchTask this}}
     @data={{@model}}

package/addon/templates/connectivity/sensors/index/details/index.hbs

@@ -1,2 +1,2 @@
-
-{{outlet}}
+<Sensor::Details @resource={{@model}} />
+<Spacer @height="200px" />

package/addon/templates/connectivity/sensors/index/details.hbs

@@ -1,2 +1,15 @@
-
-{{outlet}}
+<Layout::Resource::Panel
+    @resource={{@model}}
+    @controller={{this}}
+    @headerComponent={{component "sensor/panel-header" resource=@model}}
+    @headerTitle={{or @model.name @model.serial_number}}
+    @actionButtons={{this.actionButtons}}
+    @onPressCancel={{transition-to "connectivity.sensors.index"}}
+    @onOverlayReady={{fn (mut this.overlay)}}
+    @headerClass="no-bottom-border"
+    @bodyClass="no-scroll"
+>
+    <TabNavigation @tabs={{this.tabs}} @contentClass="scrollable" @tablistClass="pl-2">
+        {{outlet}}
+    </TabNavigation>
+</Layout::Resource::Panel>

package/addon/templates/connectivity/sensors/index/edit.hbs

@@ -1,7 +1,7 @@
 <Layout::Resource::Panel
     @resource={{@model}}
     @controller={{this}}
-    @headerTitle={{concat "Edit: " @model.name}}
+    @headerTitle={{concat "Edit: " (or @model.name @model.serial_number)}}
     @actionButtons={{this.actionButtons}}
     @saveTask={{this.save}}
     @onPressCancel={{this.cancel}}

package/addon/templates/connectivity/telematics/index/details/index.hbs

@@ -1,2 +1,2 @@
-
-{{outlet}}
+<Telematic::Details @resource={{@model}} />
+<Spacer @height="200px" />

package/addon/templates/connectivity/telematics/index/details.hbs

@@ -1,2 +1,14 @@
-
-{{outlet}}
+<Layout::Resource::Panel
+    @resource={{@model}}
+    @controller={{this}}
+    @headerTitle={{or @model.name @model.provider}}
+    @actionButtons={{this.actionButtons}}
+    @onPressCancel={{transition-to "connectivity.telematics.index"}}
+    @onOverlayReady={{fn (mut this.overlay)}}
+    @headerClass="no-bottom-border"
+    @bodyClass="no-scroll"
+>
+    <TabNavigation @tabs={{this.tabs}} @contentClass="scrollable" @tablistClass="pl-2">
+        {{outlet}}
+    </TabNavigation>
+</Layout::Resource::Panel>

package/addon/templates/connectivity/telematics/index/edit.hbs

@@ -1,7 +1,7 @@
 <Layout::Resource::Panel
     @resource={{@model}}
     @controller={{this}}
-    @headerTitle={{concat "Edit: " @model.name}}
+    @headerTitle={{concat "Edit: " (or @model.name @model.provider)}}
     @actionButtons={{this.actionButtons}}
     @saveTask={{this.save}}
     @onPressCancel={{this.cancel}}

package/addon/templates/management/vehicles/index/details/positions.hbs

@@ -0,0 +1 @@
+<PositionsReplay @resource={{@model}} />

package/addon/utils/fleet-ops-options.js

@@ -403,6 +403,95 @@ export const serviceAreaTypes = [
     { label: 'Continent', value: 'continent', description: 'A global landmass encompassing multiple countries (e.g., Asia, Europe, Africa).' },
 ];
 
+export const telematicStatuses = [
+    { value: 'initialized', label: 'Initialized', description: 'Provider entry has been created but not yet configured.' },
+    { value: 'configured', label: 'Configured', description: 'Provider credentials and settings are valid but connection not yet tested.' },
+    { value: 'connecting', label: 'Connecting', description: 'Attempting to establish a connection with provider API.' },
+    { value: 'connected', label: 'Connected', description: 'Successfully authenticated and connected to provider API.' },
+    { value: 'synchronizing', label: 'Synchronizing', description: 'Currently syncing data (devices, vehicles, positions, etc.) from provider.' },
+    { value: 'active', label: 'Active', description: 'Integration is healthy and data syncs are occurring normally.' },
+    { value: 'degraded', label: 'Degraded', description: 'Integration partially working; intermittent errors or missing data.' },
+    { value: 'disconnected', label: 'Disconnected', description: 'Connection lost or failed authentication.' },
+    { value: 'error', label: 'Error', description: 'Provider integration encountered a fatal issue.' },
+    { value: 'disabled', label: 'Disabled', description: 'Manually disabled by the user.' },
+    { value: 'archived', label: 'Archived', description: 'Deprecated or replaced integration, kept for record.' },
+];
+
+export const telematicHealthStates = [
+    { value: 'healthy', label: 'Healthy', description: 'Integration tested and stable.' },
+    { value: 'warning', label: 'Warning', description: 'Minor issues detected (e.g., slow response, nearing quota).' },
+    { value: 'critical', label: 'Critical', description: 'Persistent failure or no data received in X hours.' },
+];
+
+export const deviceTypes = [
+    { label: 'GPS Tracker', value: 'gps_tracker', description: 'Standalone GPS tracking device installed in vehicle or asset.' },
+    { label: 'OBD-II Plug-in Device', value: 'obd2_plugin', description: 'Plugs into vehicle OBD-II port; reads diagnostics, engine data, and transmits telematics.' },
+    { label: 'CAN Bus Module', value: 'can_bus_module', description: 'Hard-wired module connected to vehicle CAN bus for detailed vehicle subsystem data.' },
+    { label: 'Dash Camera Telematics Unit', value: 'dashcam_unit', description: 'Camera + integrated telematics module capturing video and vehicle data.' },
+    {
+        label: 'Battery-Powered Asset Tracker',
+        value: 'battery_asset_tracker',
+        description: 'Self-powered wireless device for tracking non-powered assets (trailers, containers, equipment).',
+    },
+    { label: 'Smartphone App Device', value: 'smartphone_app_device', description: 'Mobile device running telematics/tracking app using phone sensors and connectivity.' },
+    { label: 'Hard-wired Black Box Module', value: 'hardwired_black_box', description: 'Permanently installed telematics control unit wired to vehicle electrical system for fleet use.' },
+    { label: 'Mobile Edge / IoT Gateway', value: 'mobile_edge_gateway', description: 'Multi-sensor/IoT gateway installed in vehicle or asset to aggregate sensor data and telematics.' },
+    {
+        label: 'Trailer/Container Telematic Sensor Node',
+        value: 'trailer_container_node',
+        description: 'Specialised telematics node for trailers, containers, intermodal assets, tracking location and status.',
+    },
+];
+
+export const sensorTypes = [
+    { label: 'GPS / GNSS Receiver', value: 'gps_gnss', description: 'Global positioning sensor providing latitude/longitude, speed and time information.' },
+    { label: 'Accelerometer', value: 'accelerometer', description: 'Measures linear acceleration; used to detect harsh braking, rapid acceleration, and movement.' },
+    { label: 'Gyroscope / IMU', value: 'gyroscope_imu', description: 'Inertial Measurement Unit estimating orientation, yaw/pitch/roll of vehicle or asset.' },
+    { label: 'Fuel Level Sensor', value: 'fuel_level', description: 'Measures remaining fuel in tank; used for fuel monitoring and consumption tracking.' },
+    { label: 'Tire Pressure Sensor (TPMS)', value: 'tire_pressure', description: 'Measures pressure (and often temperature) in tires for safety and maintenance.' },
+    { label: 'Engine Diagnostic / OBD Sensor', value: 'engine_diagnostic', description: 'Reads engine fault codes, RPM, engine hours, and other diagnostics via OBD or CAN.' },
+    { label: 'Temperature Sensor', value: 'temperature', description: 'Monitors ambient or equipment temperature; used for refrigerated cargo, battery health etc.' },
+    { label: 'Humidity Sensor', value: 'humidity', description: 'Detects moisture/humidity levels in cargo or enclosed spaces for condition monitoring.' },
+    { label: 'Door / Hatch Sensor', value: 'door_hatch', description: 'Monitors open/close status of doors, hatches or compartments for security/tracking.' },
+    { label: 'Vibration / Shock Sensor', value: 'vibration_shock', description: 'Measures vibration or shock events; suitable for freight, containers or equipment stability monitoring.' },
+    { label: 'Battery Voltage Sensor', value: 'battery_voltage', description: 'Monitors battery or electrical system voltage to detect low power or charging issues.' },
+    { label: 'Geofence / Entry-Exit Event Sensor', value: 'geofence_event', description: 'Triggers when asset enters/exits defined geographic zone; used for location-based alerts.' },
+    { label: 'Idle Time Sensor', value: 'idle_time', description: 'Tracks engine on with vehicle stationary; used to measure idling and optimize fuel/usage.' },
+    { label: 'Driver Behavior Sensor', value: 'driver_behavior', description: 'Aggregates data (speed, braking, cornering) to score driving behavior and safety.' },
+];
+
+export const deviceStatuses = [
+    { label: 'Inactive', value: 'inactive', description: 'Device record exists but has not yet been activated or assigned.' },
+    { label: 'Active', value: 'active', description: 'Device is online and actively communicating with the platform.' },
+    { label: 'Online', value: 'online', description: 'Device is currently connected and transmitting live data.' },
+    { label: 'Offline', value: 'offline', description: 'Device is powered off or has not transmitted data within the expected interval.' },
+    { label: 'Sleeping', value: 'sleeping', description: 'Device in low-power mode awaiting wake event or scheduled reporting interval.' },
+    { label: 'Idle', value: 'idle', description: 'Device is powered and connected but not moving or transmitting new telemetry.' },
+    { label: 'Maintenance', value: 'maintenance', description: 'Device is undergoing repair, firmware update, or service maintenance.' },
+    { label: 'Degraded', value: 'degraded', description: 'Device is partially functional; intermittent connectivity or incomplete data.' },
+    { label: 'Error', value: 'error', description: 'Device reported fault, hardware issue, or repeated communication errors.' },
+    { label: 'Disconnected', value: 'disconnected', description: 'Device lost connection to network or telematic gateway.' },
+    { label: 'Decommissioned', value: 'decommissioned', description: 'Device permanently retired or removed from active fleet use.' },
+    { label: 'Disabled', value: 'disabled', description: 'Device manually disabled by user or admin; data not being accepted.' },
+    { label: 'Pending Activation', value: 'pending_activation', description: 'Device provisioned but not yet verified or linked to telematic source.' },
+    { label: 'Provisioning', value: 'provisioning', description: 'Device configuration or initialization is in progress.' },
+];
+
+export const sensorStatuses = [
+    { label: 'Active', value: 'active', description: 'Sensor is online and transmitting readings as expected.' },
+    { label: 'Inactive', value: 'inactive', description: 'Sensor exists but is not currently operational or reporting.' },
+    { label: 'Online', value: 'online', description: 'Sensor is connected and sending live data via its parent device.' },
+    { label: 'Offline', value: 'offline', description: 'Sensor has stopped sending data or is unreachable.' },
+    { label: 'Calibrating', value: 'calibrating', description: 'Sensor undergoing calibration or self-test to ensure measurement accuracy.' },
+    { label: 'Faulty', value: 'faulty', description: 'Sensor hardware failure or inconsistent readings detected.' },
+    { label: 'Degraded', value: 'degraded', description: 'Sensor partially functional; data irregularities or unstable connection.' },
+    { label: 'Maintenance', value: 'maintenance', description: 'Sensor temporarily disabled for maintenance, cleaning, or recalibration.' },
+    { label: 'Error', value: 'error', description: 'Critical failure or unrecoverable error reported by sensor or gateway.' },
+    { label: 'Disconnected', value: 'disconnected', description: 'Sensor communication link lost with device or telematic gateway.' },
+    { label: 'Disabled', value: 'disabled', description: 'Sensor manually disabled; no data being collected.' },
+    { label: 'Decommissioned', value: 'decommissioned', description: 'Sensor permanently retired, replaced, or removed from service.' },
+];
+
 export default function fleetOpsOptions(key) {
     const allOptions = {
         driverTypes,
@@ -434,6 +523,12 @@ export default function fleetOpsOptions(key) {
         dimensionUnits,
         weightUnits,
         serviceAreaTypes,
+        telematicStatuses,
+        telematicHealthStates,
+        deviceTypes,
+        sensorTypes,
+        deviceStatuses,
+        sensorStatuses,
     };
 
     return allOptions[key] ?? [];

package/app/components/device/panel-header.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/device/panel-header';

package/app/components/map/drawer/device-event-listing.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/map/drawer/device-event-listing';

package/app/components/map/drawer/position-listing.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/map/drawer/position-listing';

package/app/components/positions-replay.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/positions-replay';

package/app/components/sensor/panel-header.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/sensor/panel-header';

package/app/helpers/get-fleet-ops-option-label.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/helpers/get-fleet-ops-option-label';

package/app/routes/management/vehicles/index/details/positions.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/routes/management/vehicles/index/details/positions';

package/app/templates/management/vehicles/index/details/positions.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/templates/management/vehicles/index/details/positions';

package/composer.json

@@ -1,6 +1,6 @@
 {
     "name": "fleetbase/fleetops-api",
-    "version": "0.6.20",
+    "version": "0.6.21",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "keywords": [
         "fleetbase-extension",

package/extension.json

@@ -1,6 +1,6 @@
 {
     "name": "Fleet-Ops",
-    "version": "0.6.20",
+    "version": "0.6.21",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "repository": "https://github.com/fleetbase/fleetops",
     "license": "AGPL-3.0-or-later",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@fleetbase/fleetops-engine",
-    "version": "0.6.20",
+    "version": "0.6.21",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "fleetbase": {
         "route": "fleet-ops"
@@ -42,9 +42,9 @@
     },
     "dependencies": {
         "@babel/core": "^7.23.2",
-        "@fleetbase/ember-core": "^0.3.4",
-        "@fleetbase/ember-ui": "^0.3.6",
-        "@fleetbase/fleetops-data": "^0.1.20",
+        "@fleetbase/ember-core": "^0.3.6",
+        "@fleetbase/ember-ui": "^0.3.7",
+        "@fleetbase/fleetops-data": "^0.1.21",
         "@fleetbase/leaflet-routing-machine": "^3.2.17",
         "@fortawesome/ember-fontawesome": "^2.0.0",
         "@fortawesome/fontawesome-svg-core": "6.4.0",

package/server/config/telematics.php

@@ -0,0 +1,111 @@
+<?php
+
+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',
+            'required_fields' => [
+                [
+                    'name' => 'token',
+                    'label' => 'Flespi Token',
+                    'type' => 'password',
+                    'placeholder' => 'Enter your Flespi API token',
+                    'required' => true,
+                    'validation' => 'required|string|min:20',
+                ],
+                [
+                    'name' => 'webhook_secret',
+                    'label' => 'Webhook Secret (Optional)',
+                    'type' => 'password',
+                    'placeholder' => 'Enter webhook secret for signature validation',
+                    'required' => false,
+                ],
+            ],
+            'supports_webhooks' => true,
+            'supports_discovery' => true,
+            '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/',
+            'required_fields' => [
+                [
+                    'name' => 'database',
+                    'label' => 'Database Name',
+                    'type' => 'text',
+                    'placeholder' => 'Enter your Geotab database name',
+                    'required' => true,
+                ],
+                [
+                    'name' => 'username',
+                    'label' => 'Username',
+                    'type' => 'text',
+                    'placeholder' => 'Enter your Geotab username',
+                    'required' => true,
+                ],
+                [
+                    'name' => 'password',
+                    'label' => 'Password',
+                    'type' => 'password',
+                    'placeholder' => 'Enter your Geotab password',
+                    'required' => true,
+                ],
+            ],
+            'supports_webhooks' => false,
+            'supports_discovery' => true,
+            'metadata' => [
+                'rate_limit' => 50,
+                '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/',
+            'required_fields' => [
+                [
+                    'name' => 'api_token',
+                    'label' => 'API Token',
+                    'type' => 'password',
+                    'placeholder' => 'Enter your Samsara API token',
+                    'required' => true,
+                    'validation' => 'required|string|min:20',
+                ],
+                [
+                    'name' => 'webhook_secret',
+                    'label' => 'Webhook Secret (Optional)',
+                    'type' => 'password',
+                    'placeholder' => 'Enter webhook secret for signature validation',
+                    'required' => false,
+                ],
+            ],
+            'supports_webhooks' => true,
+            'supports_discovery' => true,
+            'metadata' => [
+                'rate_limit' => 60,
+                'pagination' => 'cursor',
+            ],
+        ],
+    ]
+];
+

package/server/migrations/2025_10_27_000001_add_telematics_integration_fields.php

@@ -0,0 +1,70 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        // Update telematics table
+        Schema::table('telematics', function (Blueprint $table) {
+            $table->json('credentials')->after('config');
+            $table->string('public_id')->after('uuid')->nullable()->index();
+        });
+
+        // Update devices table
+        Schema::table('devices', function (Blueprint $table) {
+            $table->string('public_id')->after('uuid')->nullable()->index();
+            $table->foreignUuid('company_uuid')->nullable()->after('_key')->constrained('companies', 'uuid')->nullOnDelete();
+            $table->foreignUuid('photo_uuid')->nullable()->after('telematic_uuid')->constrained('files', 'uuid')->nullOnDelete();
+        });
+
+        // Update sensors table
+        Schema::table('sensors', function (Blueprint $table) {
+            $table->string('public_id')->after('uuid')->nullable()->index();
+            $table->foreignUuid('photo_uuid')->nullable()->after('company_uuid')->constrained('files', 'uuid')->nullOnDelete();
+        });
+
+        // Update device events table
+        Schema::table('device_events', function (Blueprint $table) {
+            $table->string('public_id')->after('uuid')->nullable()->index();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        // Remove columns from telematics
+        Schema::table('telematics', function (Blueprint $table) {
+            $table->dropColumn(['credentials', 'public_id']);
+        });
+
+        // Remove columns from devices
+        Schema::table('devices', function (Blueprint $table) {
+            $table->dropForeign(['company_uuid']);
+            $table->dropForeign(['photo_uuid']);
+            $table->dropColumn(['public_id', 'photo_uuid', 'company_uuid']);
+        });
+
+        // Remove columns from sensors
+        Schema::table('sensors', function (Blueprint $table) {
+            $table->dropForeign(['photo_uuid']);
+            $table->dropColumn(['public_id', 'photo_uuid']);
+        });
+
+        // Remove columns from device events
+        Schema::table('device_events', function (Blueprint $table) {
+            $table->dropColumn(['public_id']);
+        });
+    }
+};