@fleetbase/fleetops-engine 0.6.43 → 0.6.45

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

@@ -123,6 +123,38 @@ export const contactTypes = [
     { label: 'Dispatcher', value: 'dispatcher', description: 'Scheduling and operations contact' },
 ];
 
+export const entityTypes = [
+    { label: 'Parcel', value: 'parcel', description: 'Standard parcel or package used by parcel-based pricing.' },
+    { label: 'Package', value: 'package', description: 'Generic package or boxed item.' },
+    { label: 'Product', value: 'product', description: 'Sellable product or catalog item.' },
+    { label: 'Item', value: 'item', description: 'Generic inventory item when no stronger type applies.' },
+    { label: 'SKU / Inventory Unit', value: 'sku', description: 'Stock keeping unit or tracked inventory piece.' },
+    { label: 'Document', value: 'document', description: 'Envelopes, paperwork, and lightweight documents.' },
+    { label: 'Envelope', value: 'envelope', description: 'Flat document mailer or envelope.' },
+    { label: 'Box', value: 'box', description: 'Single boxed shipment unit.' },
+    { label: 'Carton', value: 'carton', description: 'Single carton, box, or case.' },
+    { label: 'Case', value: 'case', description: 'Case-packed goods or packaged case.' },
+    { label: 'Bundle', value: 'bundle', description: 'Bundled or strapped items shipped together.' },
+    { label: 'Bag', value: 'bag', description: 'Bagged goods, sacks, or pouches.' },
+    { label: 'Tote', value: 'tote', description: 'Reusable tote, bin, or container.' },
+    { label: 'Crate', value: 'crate', description: 'Rigid crate or caged shipment unit.' },
+    { label: 'Pallet', value: 'pallet', description: 'Palletized freight or grouped cargo.' },
+    { label: 'Container', value: 'container', description: 'Containerized shipment or storage container.' },
+    { label: 'Freight', value: 'freight', description: 'Loose freight or larger shipment unit.' },
+    { label: 'Cargo', value: 'cargo', description: 'General cargo not classified more specifically.' },
+    { label: 'Equipment', value: 'equipment', description: 'Tools, machines, or operational equipment.' },
+    { label: 'Machinery', value: 'machinery', description: 'Industrial machinery or large mechanical unit.' },
+    { label: 'Asset', value: 'asset', description: 'Tracked business asset or returnable item.' },
+    { label: 'Return', value: 'return', description: 'Returned goods or reverse-logistics item.' },
+    { label: 'Sample', value: 'sample', description: 'Sample item for trial, demo, or inspection.' },
+    { label: 'Spare Part', value: 'spare_part', description: 'Replacement component or service part.' },
+    { label: 'Medical Supply', value: 'medical_supply', description: 'Healthcare, lab, or medical delivery item.' },
+    { label: 'Food', value: 'food', description: 'Prepared food, meal, or grocery item.' },
+    { label: 'Beverage', value: 'beverage', description: 'Drink, liquid refreshment, or bottled shipment.' },
+    { label: 'Retail Goods', value: 'retail_goods', description: 'General consumer or retail merchandise.' },
+    { label: 'Passenger', value: 'passenger', description: 'Person transported as part of the order payload.' },
+];
+
 export const contactStatuses = [
     { label: 'Active', value: 'active', description: 'Contact is valid and in use' },
     { label: 'Inactive', value: 'inactive', description: 'Contact is no longer valid' },
@@ -821,6 +853,7 @@ export default function fleetOpsOptions(key) {
         fleetTypes,
         fleetStatuses,
         contactTypes,
+        entityTypes,
         contactStatuses,
         fuelReportTypes,
         fuelReportStatuses,

package/addon/utils/serialize-payload.js

@@ -5,7 +5,7 @@ export default function serializePayload(payload) {
     const serialized = {
         pickup: serializeModel(payload.pickup),
         dropoff: serializeModel(payload.dropoff),
-        entitities: serializeArray(payload.entities),
+        entities: serializeArray(payload.entities),
         waypoints: serializeArray(payload.waypoints),
     };
 

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

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

package/app/controllers/operations/orders/index/details/virtual.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/controllers/operations/orders/index/details/virtual';

package/app/helpers/f-to-int.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/helpers/f-to-int';

package/app/services/geofence-event-bus.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/services/geofence-event-bus';

package/composer.json

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

package/extension.json

@@ -1,6 +1,6 @@
 {
     "name": "Fleet-Ops",
-    "version": "0.6.43",
+    "version": "0.6.45",
     "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.43",
+    "version": "0.6.45",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "fleetbase": {
         "route": "fleet-ops"
@@ -44,7 +44,7 @@
         "@babel/core": "^7.23.2",
         "@fleetbase/ember-core": "^0.3.18",
         "@fleetbase/ember-ui": "^0.3.26",
-        "@fleetbase/fleetops-data": "^0.1.28",
+        "@fleetbase/fleetops-data": "^0.1.30",
         "@fleetbase/leaflet-routing-machine": "^3.2.17",
         "@fortawesome/ember-fontawesome": "^2.0.0",
         "@fortawesome/fontawesome-svg-core": "6.4.0",

package/server/migrations/2026_04_05_000001_add_geofence_config_to_zones_table.php

@@ -0,0 +1,48 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     *
+     * Adds geofence trigger configuration columns to the zones table,
+     * enabling each zone to be configured as an active geofence with
+     * entry/exit/dwell event triggers.
+     */
+    public function up(): void
+    {
+        Schema::table('zones', function (Blueprint $table) {
+            // Whether to fire a GeofenceEntered event when a driver enters this zone
+            $table->boolean('trigger_on_entry')->default(true)->after('stroke_color');
+
+            // Whether to fire a GeofenceExited event when a driver exits this zone
+            $table->boolean('trigger_on_exit')->default(true)->after('trigger_on_entry');
+
+            // Minutes a driver must remain inside before a GeofenceDwelled event fires.
+            // NULL disables dwell tracking for this zone.
+            $table->unsignedSmallInteger('dwell_threshold_minutes')->nullable()->after('trigger_on_exit');
+
+            // Optional speed limit (km/h) enforced within this zone.
+            // NULL means no speed limit is configured.
+            $table->unsignedSmallInteger('speed_limit_kmh')->nullable()->after('dwell_threshold_minutes');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('zones', function (Blueprint $table) {
+            $table->dropColumn([
+                'trigger_on_entry',
+                'trigger_on_exit',
+                'dwell_threshold_minutes',
+                'speed_limit_kmh',
+            ]);
+        });
+    }
+};

package/server/migrations/2026_04_05_000002_add_geofence_config_to_service_areas_table.php

@@ -0,0 +1,38 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     *
+     * Adds geofence trigger configuration columns to the service_areas table,
+     * enabling each service area to act as an active geofence boundary.
+     */
+    public function up(): void
+    {
+        Schema::table('service_areas', function (Blueprint $table) {
+            $table->boolean('trigger_on_entry')->default(true)->after('stroke_color');
+            $table->boolean('trigger_on_exit')->default(true)->after('trigger_on_entry');
+            $table->unsignedSmallInteger('dwell_threshold_minutes')->nullable()->after('trigger_on_exit');
+            $table->unsignedSmallInteger('speed_limit_kmh')->nullable()->after('dwell_threshold_minutes');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('service_areas', function (Blueprint $table) {
+            $table->dropColumn([
+                'trigger_on_entry',
+                'trigger_on_exit',
+                'dwell_threshold_minutes',
+                'speed_limit_kmh',
+            ]);
+        });
+    }
+};

package/server/migrations/2026_04_05_000003_create_driver_geofence_states_table.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 {
+    /**
+     * Run the migrations.
+     *
+     * Creates the driver_geofence_states table which acts as the state machine
+     * store for the geofencing engine. It tracks whether each driver is currently
+     * inside each geofence, enabling the system to detect transitions (entry/exit)
+     * rather than just evaluating current position in isolation.
+     *
+     * One record exists per driver-geofence pair. Records are upserted on each
+     * location update where a crossing is detected.
+     */
+    public function up(): void
+    {
+        Schema::create('driver_geofence_states', function (Blueprint $table) {
+            $table->id();
+            $table->uuid('driver_uuid')->index();
+            $table->uuid('geofence_uuid')->index();
+
+            // Discriminator: 'zone' or 'service_area'
+            $table->string('geofence_type', 50)->default('zone');
+
+            // Whether the driver is currently inside this geofence
+            $table->boolean('is_inside')->default(false)->index();
+
+            // Timestamp of when the driver most recently entered this geofence
+            $table->timestamp('entered_at')->nullable();
+
+            // Timestamp of when the driver most recently exited this geofence
+            $table->timestamp('exited_at')->nullable();
+
+            // Queue job ID of the pending CheckGeofenceDwell job.
+            // Stored so it can be cancelled if the driver exits before the dwell threshold.
+            $table->string('dwell_job_id')->nullable();
+
+            $table->timestamps();
+
+            // Composite unique key: one state record per driver-geofence pair
+            $table->unique(['driver_uuid', 'geofence_uuid'], 'driver_geofence_unique');
+
+            // Cascade delete when the driver is deleted
+            $table->foreign('driver_uuid')
+                ->references('uuid')
+                ->on('drivers')
+                ->onDelete('cascade');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('driver_geofence_states');
+    }
+};

package/server/migrations/2026_04_05_000004_create_geofence_events_log_table.php

@@ -0,0 +1,66 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     *
+     * Creates the geofence_events_log table which provides a persistent,
+     * queryable audit trail of all geofence events (entered, exited, dwelled).
+     * This table powers the reporting dashboard, dwell time analytics, and
+     * geofence activity history views.
+     */
+    public function up(): void
+    {
+        Schema::create('geofence_events_log', function (Blueprint $table) {
+            $table->id();
+            $table->uuid('uuid')->unique()->index();
+            $table->uuid('company_uuid')->index();
+            $table->uuid('driver_uuid')->index();
+            $table->uuid('vehicle_uuid')->nullable()->index();
+            $table->uuid('order_uuid')->nullable()->index();
+            $table->uuid('geofence_uuid')->index();
+
+            // Discriminator: 'zone' or 'service_area'
+            $table->string('geofence_type', 50)->default('zone');
+
+            // Snapshot of the geofence name at the time of the event
+            $table->string('geofence_name')->nullable();
+
+            // The type of geofence event
+            $table->enum('event_type', ['entered', 'exited', 'dwelled'])->index();
+
+            // Driver location at the time of the event
+            $table->decimal('latitude', 10, 7)->nullable();
+            $table->decimal('longitude', 10, 7)->nullable();
+
+            // Driver speed at the time of the event (km/h)
+            $table->decimal('speed_kmh', 8, 2)->nullable();
+
+            // Populated for 'exited' and 'dwelled' events
+            $table->unsignedInteger('dwell_duration_minutes')->nullable();
+
+            // The precise time the event occurred (not the DB insert time)
+            $table->timestamp('occurred_at')->index();
+
+            $table->timestamps();
+
+            // Composite indexes for common query patterns
+            $table->index(['company_uuid', 'occurred_at'], 'gel_company_occurred_idx');
+            $table->index(['geofence_uuid', 'occurred_at'], 'gel_geofence_occurred_idx');
+            $table->index(['driver_uuid', 'occurred_at'], 'gel_driver_occurred_idx');
+            $table->index(['order_uuid', 'event_type'], 'gel_order_event_idx');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('geofence_events_log');
+    }
+};

package/server/migrations/2026_04_22_000001_add_vehicle_support_to_geofence_events_log.php

@@ -0,0 +1,31 @@
+<?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::table('geofence_events_log', function (Blueprint $table) {
+            $table->uuid('subject_uuid')->nullable()->after('order_uuid')->index();
+            $table->string('subject_type', 50)->default('driver')->after('subject_uuid')->index();
+            $table->string('subject_name')->nullable()->after('subject_type');
+            $table->uuid('driver_uuid')->nullable()->change();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('geofence_events_log', function (Blueprint $table) {
+            $table->dropColumn(['subject_uuid', 'subject_type', 'subject_name']);
+            $table->uuid('driver_uuid')->nullable(false)->change();
+        });
+    }
+};

package/server/migrations/2026_04_22_000002_create_vehicle_geofence_states_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 {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('vehicle_geofence_states', function (Blueprint $table) {
+            $table->id();
+            $table->uuid('vehicle_uuid')->index();
+            $table->uuid('geofence_uuid')->index();
+            $table->string('geofence_type', 50)->default('zone');
+            $table->boolean('is_inside')->default(false)->index();
+            $table->timestamp('entered_at')->nullable();
+            $table->timestamp('exited_at')->nullable();
+            $table->string('dwell_job_id')->nullable();
+            $table->timestamps();
+
+            $table->unique(['vehicle_uuid', 'geofence_uuid'], 'vehicle_geofence_unique');
+            $table->foreign('vehicle_uuid')
+                ->references('uuid')
+                ->on('vehicles')
+                ->onDelete('cascade');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('vehicle_geofence_states');
+    }
+};