@fleetbase/fleetops-engine 0.6.37 → 0.6.39

package/addon/utils/to-calendar-date.js

@@ -0,0 +1,70 @@
+/**
+ * toCalendarDate
+ *
+ * Converts a UTC Date into a "fake local" Date whose **local** fields
+ * (getFullYear, getMonth, getDate, getHours, getMinutes, getSeconds) equal the
+ * wall-clock time in the given IANA timezone.
+ *
+ * Why this is needed
+ * ------------------
+ * @event-calendar/core has no timezone support (see maintainer comment:
+ * https://github.com/vkurko/calendar/issues/576).  When the library ingests an
+ * event it reads the Date's **local** fields and stores them as UTC wall-clock
+ * values.  This means the event is positioned at whatever the browser's local
+ * time is for the given UTC instant — which is wrong when the company timezone
+ * differs from the browser timezone.
+ *
+ * By constructing a Date whose local fields already equal the company-local
+ * wall-clock time, the library will position the event at the correct time
+ * regardless of the browser's timezone.
+ *
+ * Example
+ * -------
+ *   UTC instant:        2026-04-06T14:30:00Z
+ *   Company timezone:   Asia/Singapore (UTC+8)
+ *   Wall-clock time:    2026-04-06 22:30 SGT
+ *
+ *   toCalendarDate(new Date('2026-04-06T14:30:00Z'), 'Asia/Singapore')
+ *   → new Date(2026, 3, 6, 22, 30, 0)   ← local fields = 22:30 on Apr 6
+ *
+ * The calendar reads the local fields (22:30, Apr 6) and positions the event
+ * there — correct regardless of whether the browser is UTC, UTC+8, or anything
+ * else.
+ *
+ * @param {Date|string|number} utcDate  Any value that `new Date()` accepts.
+ * @param {string}             timezone IANA timezone string, e.g. 'Asia/Singapore'.
+ * @returns {Date}  A Date whose local fields equal the wall-clock time in `timezone`.
+ */
+export default function toCalendarDate(utcDate, timezone) {
+    const date = utcDate instanceof Date ? utcDate : new Date(utcDate);
+
+    if (!timezone) {
+        // No timezone provided — return the date unchanged.
+        return date;
+    }
+
+    try {
+        const parts = new Intl.DateTimeFormat('en-US', {
+            timeZone: timezone,
+            year: 'numeric',
+            month: '2-digit',
+            day: '2-digit',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+            hour12: false,
+        }).formatToParts(date);
+
+        const get = (type) => parseInt(parts.find((p) => p.type === type)?.value ?? '0', 10);
+
+        // hour12: false can return 24 for midnight — normalise to 0.
+        const hour = get('hour') % 24;
+
+        // Construct a Date whose LOCAL fields equal the company wall-clock time.
+        // The UTC fields of this Date are irrelevant; the library only reads local fields.
+        return new Date(get('year'), get('month') - 1, get('day'), hour, get('minute'), get('second'));
+    } catch {
+        // Intl unavailable or invalid timezone — return the original date unchanged.
+        return date;
+    }
+}

package/app/components/driver/schedule.js

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

package/app/components/maintenance/cost-panel.js

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

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

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

package/app/components/maintenance-schedule/details.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/maintenance-schedule/details';

package/app/components/maintenance-schedule/form.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/maintenance-schedule/form';

package/app/components/modals/add-driver-shift.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/modals/add-driver-shift';

package/app/components/modals/bulk-assign-orders.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/modals/bulk-assign-orders';

package/app/components/modals/driver-shift.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/modals/driver-shift';

package/app/components/modals/orchestrator-import.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/modals/orchestrator-import';

package/app/components/modals/scheduling-conflict.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/modals/scheduling-conflict';

package/app/components/modals/send-work-order.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/modals/send-work-order';

package/app/components/modals/set-driver-availability.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/modals/set-driver-availability';

package/app/components/orchestrator/card-fields-settings.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/orchestrator/card-fields-settings';

package/app/components/orchestrator/order-pool.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/orchestrator/order-pool';

package/app/components/orchestrator/phase-builder.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/orchestrator/phase-builder';

package/app/components/orchestrator/plan-viewer.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/orchestrator/plan-viewer';

package/app/components/orchestrator/resource-panel.js

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

package/app/components/orchestrator-workbench.js

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

package/app/components/vehicle/details/maintenance-history.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/vehicle/details/maintenance-history';

package/app/components/vehicle/details/schedules.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/vehicle/details/schedules';

package/app/components/vehicle/details/work-orders.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/components/vehicle/details/work-orders';

package/app/controllers/operations/orchestrator.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/controllers/operations/orchestrator';

package/app/controllers/settings/orchestrator.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/controllers/settings/orchestrator';

package/app/controllers/settings/scheduling.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/controllers/settings/scheduling';

package/app/routes/operations/orchestrator.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/routes/operations/orchestrator';

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

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

package/app/routes/settings/orchestrator.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/routes/settings/orchestrator';

package/app/routes/settings/scheduling.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/routes/settings/scheduling';

package/app/services/maintenance-schedule-actions.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/services/maintenance-schedule-actions';

package/app/services/orchestration-engine-interface.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/services/orchestration-engine-interface';

package/app/services/orchestration-engine.js

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

package/app/services/order-allocation.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/services/order-allocation';

package/app/services/scheduling.js

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

package/app/services/vroom-allocation-engine.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/services/vroom-allocation-engine';

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

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

package/app/templates/settings/scheduling.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/templates/settings/scheduling';

package/app/utils/create-full-calendar-event-from-schedule-item.js

@@ -0,0 +1 @@
+export { default } from '@fleetbase/fleetops-engine/utils/create-full-calendar-event-from-schedule-item';

package/app/utils/route-colors.js

@@ -0,0 +1 @@
+export { default, ROUTE_COLOR_PALETTE, colorForId, darkenColor, routeStyleForStatus, waypointIconHtml } from '@fleetbase/fleetops-engine/utils/route-colors';

package/composer.json

@@ -1,6 +1,6 @@
 {
     "name": "fleetbase/fleetops-api",
-    "version": "0.6.37",
+    "version": "0.6.39",
     "description": "Fleet & Transport Management Extension for Fleetbase",
     "keywords": [
         "fleetbase-extension",
@@ -33,8 +33,10 @@
         "php-http/guzzle7-adapter": "^1.0",
         "php-units-of-measure/php-units-of-measure": "^2.2",
         "psr/http-factory-implementation": "*",
+        "rlanvin/php-rrule": "^2.6",
         "toin0u/geocoder-laravel": "^4.4",
-        "webit/eval-math": "^1.0"
+        "webit/eval-math": "^1.0",
+        "spatie/icalendar-generator": "^2.8"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^3.34.1",
@@ -94,4 +96,4 @@
             "@test:unit"
         ]
     }
-}
+}

package/extension.json

@@ -1,6 +1,6 @@
 {
     "name": "Fleet-Ops",
-    "version": "0.6.37",
+    "version": "0.6.39",
     "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.37",
+    "version": "0.6.39",
     "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.12",
-        "@fleetbase/ember-ui": "^0.3.21",
-        "@fleetbase/fleetops-data": "^0.1.25",
+        "@fleetbase/ember-core": "^0.3.18",
+        "@fleetbase/ember-ui": "^0.3.26",
+        "@fleetbase/fleetops-data": "^0.1.27",
         "@fleetbase/leaflet-routing-machine": "^3.2.17",
         "@fortawesome/ember-fontawesome": "^2.0.0",
         "@fortawesome/fontawesome-svg-core": "6.4.0",
@@ -69,7 +69,8 @@
         "ember-tag-input": "^3.1.0",
         "ember-wormhole": "^0.6.0",
         "leaflet-contextmenu": "^1.4.0",
-        "leaflet-draw": "^1.0.4"
+        "leaflet-draw": "^1.0.4",
+        "xlsx": "^0.18.5"
     },
     "devDependencies": {
         "@babel/eslint-parser": "^7.22.15",

package/server/config/fleetops.php

@@ -40,7 +40,26 @@ return [
         'host' => env('OSRM_HOST', 'https://router.project-osrm.org')
     ],
 
-     /*
+    /*
+    |--------------------------------------------------------------------------
+    | VROOM Route Optimisation Engine
+    |--------------------------------------------------------------------------
+    |
+    | FleetOps ships its own self-contained VROOM engine that does NOT require
+    | the optional `fleetbase/vroom` extension to be installed. When the
+    | extension IS installed its `vroom.base_uri` config key takes precedence.
+    |
+    | API key resolution order:
+    |   1. Company-level setting written by the fleetbase/vroom extension UI
+    |   2. VROOM_API_KEY environment variable
+    |   3. No key (for self-hosted VROOM instances that do not require auth)
+    |
+    | To use a different engine set ORCHESTRATOR_ENGINE=greedy (built-in,
+    | no external service required) or register a custom engine.
+    |
+    */
+
+    /*
     |--------------------------------------------------------------------------
     | Distance Matrix Calculator 
     | Options: "calculate", "google", "osrm"

package/server/migrations/2025_08_28_054927_create_parts_table.php

@@ -30,8 +30,8 @@ return new class extends Migration {
             $table->foreignUuid('vendor_uuid')->nullable()->constrained('vendors', 'uuid')->nullOnDelete();
 
             $table->integer('quantity_on_hand')->default(0);
-            $table->decimal('unit_cost', 12, 2)->nullable();
-            $table->decimal('msrp', 12, 2)->nullable();
+            $table->bigInteger('unit_cost')->nullable(); // stored in cents
+            $table->bigInteger('msrp')->nullable();       // stored in cents
             $table->integer('reorder_point')->default(5);
             $table->integer('reorder_quantity')->default(10);
             $table->integer('max_stock_level')->nullable();

package/server/migrations/2025_08_28_054932_add_public_id_to_maintenance_tables.php

@@ -0,0 +1,45 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Adds the `public_id` column (required by the HasPublicId trait) to the four
+ * maintenance-related tables that were created without it.
+ */
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        $tables = ['parts', 'equipment', 'work_orders', 'maintenances'];
+
+        foreach ($tables as $table) {
+            if (Schema::hasTable($table) && !Schema::hasColumn($table, 'public_id')) {
+                Schema::table($table, function (Blueprint $t) {
+                    // Insert public_id right after _key to match the convention used
+                    // in all other FleetOps tables (vehicles, drivers, orders, etc.)
+                    $t->string('public_id', 191)->nullable()->unique()->index()->after('_key');
+                });
+            }
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        $tables = ['parts', 'equipment', 'work_orders', 'maintenances'];
+
+        foreach ($tables as $table) {
+            if (Schema::hasTable($table) && Schema::hasColumn($table, 'public_id')) {
+                Schema::table($table, function (Blueprint $t) {
+                    $t->dropColumn('public_id');
+                });
+            }
+        }
+    }
+};

package/server/migrations/2025_09_01_000001_create_maintenance_schedules_table.php

@@ -0,0 +1,88 @@
+<?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('maintenance_schedules', 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();
+
+            // The asset this schedule applies to (vehicle, equipment, etc.)
+            $table->string('subject_type')->nullable();
+            $table->uuid('subject_uuid')->nullable();
+            $table->index(['subject_type', 'subject_uuid']);
+
+            $table->string('name');
+            $table->string('type')->nullable()->index();          // oil_change, inspection, tire_rotation, etc.
+            $table->string('status')->default('active')->index(); // active, paused, completed
+
+            // Interval definition — one or more can be set; whichever triggers first wins
+            $table->string('interval_method')->nullable()->index(); // time, distance, engine_hours — the user-selected method
+            $table->string('interval_type')->nullable()->index();   // time, distance, engine_hours, or combined (legacy/computed)
+            $table->unsignedInteger('interval_value')->nullable();  // e.g. 5000
+            $table->string('interval_unit')->nullable();            // km, miles, days, months
+
+            // Odometer / engine-hour thresholds
+            $table->unsignedBigInteger('interval_distance')->nullable();     // distance in base unit (km)
+            $table->unsignedBigInteger('interval_engine_hours')->nullable(); // engine hours
+
+            // Baseline readings (set when schedule is created or reset after completion)
+            $table->unsignedBigInteger('last_service_odometer')->nullable();
+            $table->unsignedBigInteger('last_service_engine_hours')->nullable();
+            $table->timestamp('last_service_date')->nullable();
+
+            // Next-due thresholds (computed and stored for fast querying)
+            $table->timestamp('next_due_date')->nullable()->index();
+            $table->unsignedBigInteger('next_due_odometer')->nullable()->index();
+            $table->unsignedBigInteger('next_due_engine_hours')->nullable()->index();
+
+            // Default work order settings for auto-generation
+            $table->string('default_priority')->default('normal'); // low, normal, high, critical
+            $table->string('default_assignee_type')->nullable();
+            $table->uuid('default_assignee_uuid')->nullable();
+            $table->index(['default_assignee_type', 'default_assignee_uuid'], 'ms_default_assignee_idx');
+
+            $table->text('instructions')->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']);
+            $table->index(['next_due_date', 'status']);
+        });
+
+        // Add schedule_uuid FK to work_orders for traceability
+        Schema::table('work_orders', function (Blueprint $table) {
+            $table->uuid('schedule_uuid')->nullable()->after('company_uuid');
+            $table->index('schedule_uuid');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('work_orders', function (Blueprint $table) {
+            $table->dropIndex(['schedule_uuid']);
+            $table->dropColumn('schedule_uuid');
+        });
+
+        Schema::disableForeignKeyConstraints();
+        Schema::dropIfExists('maintenance_schedules');
+        Schema::enableForeignKeyConstraints();
+    }
+};

package/server/migrations/2026_04_01_000001_fix_monetary_columns_in_parts_table.php

@@ -0,0 +1,48 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Fix monetary columns in the parts table.
+ *
+ * - Convert unit_cost and msrp from decimal(12,2) to integer (cents)
+ *   to align with the Fleetbase monetary storage standard (all amounts stored as cents).
+ * - Add currency column for internationalisation support.
+ */
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('parts', function (Blueprint $table) {
+            // Convert decimal monetary columns to integer (cents) — only needed on
+            // existing installs where the original migration used decimal(12,2).
+            // Fresh installs already have bigInteger from the updated create migration.
+            $columnType = Schema::getColumnType('parts', 'unit_cost');
+            if (in_array($columnType, ['decimal', 'float', 'double'])) {
+                $table->bigInteger('unit_cost')->nullable()->change();
+                $table->bigInteger('msrp')->nullable()->change();
+            }
+
+            // Add currency column for internationalisation if it doesn't exist yet
+            if (!Schema::hasColumn('parts', 'currency')) {
+                $table->string('currency')->nullable()->after('msrp');
+            }
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('parts', function (Blueprint $table) {
+            $table->decimal('unit_cost', 12, 2)->nullable()->change();
+            $table->decimal('msrp', 12, 2)->nullable()->change();
+            $table->dropColumn('currency');
+        });
+    }
+};

package/server/migrations/2026_04_01_000003_add_photo_uuid_to_equipment_and_parts_tables.php

@@ -0,0 +1,61 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Adds the `photo_uuid` column to the `equipments` and `parts` tables.
+ *
+ * Both models have a `photo()` BelongsTo relationship to the `files` table and a
+ * `getPhotoUrlAttribute()` accessor, but the backing foreign key column was omitted
+ * from the original create migrations. This migration adds it as a nullable FK so
+ * existing rows are unaffected.
+ */
+return new class extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        if (Schema::hasTable('equipments') && !Schema::hasColumn('equipments', 'photo_uuid')) {
+            Schema::table('equipments', function (Blueprint $table) {
+                $table->foreignUuid('photo_uuid')
+                      ->nullable()
+                      ->after('warranty_uuid')
+                      ->constrained('files', 'uuid')
+                      ->nullOnDelete();
+            });
+        }
+
+        if (Schema::hasTable('parts') && !Schema::hasColumn('parts', 'photo_uuid')) {
+            Schema::table('parts', function (Blueprint $table) {
+                $table->foreignUuid('photo_uuid')
+                      ->nullable()
+                      ->after('warranty_uuid')
+                      ->constrained('files', 'uuid')
+                      ->nullOnDelete();
+            });
+        }
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        if (Schema::hasTable('equipments') && Schema::hasColumn('equipments', 'photo_uuid')) {
+            Schema::table('equipments', function (Blueprint $table) {
+                $table->dropForeign(['photo_uuid']);
+                $table->dropColumn('photo_uuid');
+            });
+        }
+
+        if (Schema::hasTable('parts') && Schema::hasColumn('parts', 'photo_uuid')) {
+            Schema::table('parts', function (Blueprint $table) {
+                $table->dropForeign(['photo_uuid']);
+                $table->dropColumn('photo_uuid');
+            });
+        }
+    }
+};

package/server/migrations/2026_04_01_000004_add_public_id_to_equipments_table.php

@@ -0,0 +1,38 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+/**
+ * Adds the `public_id` column to the `equipments` table on existing deployments.
+ *
+ * The original add_public_id_to_maintenance_tables migration referenced the table
+ * as 'equipment' (singular) instead of 'equipments' (plural, the actual table name
+ * used by the Equipment model). As a result the equipments table never received the
+ * public_id column on any database that had already run that migration, causing a
+ * SQLSTATE[42S22] "Unknown column 'public_id'" error whenever a new Equipment record
+ * was saved (HasPublicId::generatePublicId checks for uniqueness against this column).
+ *
+ * This migration is fully idempotent: it checks both that the table exists and that
+ * the column is absent before attempting to add it.
+ */
+return new class extends Migration {
+    public function up(): void
+    {
+        if (Schema::hasTable('equipments') && !Schema::hasColumn('equipments', 'public_id')) {
+            Schema::table('equipments', function (Blueprint $table) {
+                $table->string('public_id', 191)->nullable()->unique()->index()->after('_key');
+            });
+        }
+    }
+
+    public function down(): void
+    {
+        if (Schema::hasTable('equipments') && Schema::hasColumn('equipments', 'public_id')) {
+            Schema::table('equipments', function (Blueprint $table) {
+                $table->dropColumn('public_id');
+            });
+        }
+    }
+};