@fleetbase/fleetops-engine 0.6.38 → 0.6.40

package/server/resources/views/mail/work-order-dispatched.blade.php

@@ -0,0 +1,67 @@
+<x-mail-layout>
+<h2 style="font-size: 18px; font-weight: 600;">
+    Work Order Dispatched: #{{ $workOrder->public_id }}
+</h2>
+
+@if($assignee && $assignee->name)
+<p>Dear {{ $assignee->name }},</p>
+@endif
+
+<p>
+    A work order has been assigned to you. Please review the details below and take the necessary action.
+</p>
+
+<table style="width: 100%; border-collapse: collapse; margin-top: 16px; margin-bottom: 16px;">
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; width: 40%; vertical-align: top;">Work Order #</td>
+        <td style="padding: 8px 0;">{{ $workOrder->public_id }}</td>
+    </tr>
+    @if($workOrder->subject)
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; vertical-align: top;">Subject</td>
+        <td style="padding: 8px 0;">{{ $workOrder->subject }}</td>
+    </tr>
+    @endif
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; vertical-align: top;">Status</td>
+        <td style="padding: 8px 0;">{{ ucfirst(str_replace('_', ' ', $workOrder->status)) }}</td>
+    </tr>
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; vertical-align: top;">Priority</td>
+        <td style="padding: 8px 0;">{{ ucfirst($workOrder->priority) }}</td>
+    </tr>
+    @if($target)
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; vertical-align: top;">Asset / Vehicle</td>
+        <td style="padding: 8px 0;">{{ $target->name ?? $target->display_name ?? $target->public_id }}</td>
+    </tr>
+    @endif
+    @if($workOrder->due_at)
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; vertical-align: top;">Due Date</td>
+        <td style="padding: 8px 0;">{{ $workOrder->due_at->format('d M Y') }}</td>
+    </tr>
+    @endif
+    @if($workOrder->estimated_cost)
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; vertical-align: top;">Estimated Cost</td>
+        <td style="padding: 8px 0;">{{ number_format($workOrder->estimated_cost / 100, 2) }} {{ strtoupper($workOrder->currency ?? 'USD') }}</td>
+    </tr>
+    @endif
+    @if($workOrder->approved_budget)
+    <tr>
+        <td style="padding: 8px 0; font-weight: 600; vertical-align: top;">Approved Budget</td>
+        <td style="padding: 8px 0;">{{ number_format($workOrder->approved_budget / 100, 2) }} {{ strtoupper($workOrder->currency ?? 'USD') }}</td>
+    </tr>
+    @endif
+</table>
+
+@if($workOrder->instructions)
+<p style="font-weight: 600; margin-bottom: 4px;">Instructions:</p>
+<p style="white-space: pre-line;">{{ $workOrder->instructions }}</p>
+@endif
+
+<p style="margin-top: 24px; color: #6b7280; font-size: 13px;">
+    Please do not reply directly to this email. Contact the fleet manager if you have any questions.
+</p>
+</x-mail-layout>

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

@@ -113,6 +113,22 @@ class FleetOps
             'name'    => 'issue',
             'actions' => ['export', 'import'],
         ],
+        [
+            'name'    => 'maintenance',
+            'actions' => ['export', 'import'],
+        ],
+        [
+            'name'    => 'work-order',
+            'actions' => ['export', 'import'],
+        ],
+        [
+            'name'    => 'equipment',
+            'actions' => ['export', 'import'],
+        ],
+        [
+            'name'    => 'part',
+            'actions' => ['export', 'import'],
+        ],
         [
             'name'    => 'custom-field',
             'actions' => [],
@@ -264,6 +280,23 @@ class FleetOps
                 'list order',
             ],
         ],
+        [
+            'name'        => 'MaintenanceManager',
+            'description' => 'Policy for managing maintenance records, work orders, equipment, and parts.',
+            'permissions' => [
+                'see extension',
+                '* maintenance',
+                '* work-order',
+                '* equipment',
+                '* part',
+                'see vehicle',
+                'list vehicle',
+                'view vehicle',
+                'see driver',
+                'list driver',
+                'view driver',
+            ],
+        ],
         [
             'name'        => 'OperationsAdmin',
             'description' => 'Policy for monitoring activities, issues, and fuel reports within the fleet operations.',
@@ -276,6 +309,10 @@ class FleetOps
                 '* fuel-report',
                 '* issue',
                 '* place',
+                '* maintenance',
+                '* work-order',
+                '* equipment',
+                '* part',
             ],
         ],
         [
@@ -370,6 +407,13 @@ class FleetOps
                 'OperationsAdmin',
             ],
         ],
+        [
+            'name'        => 'Maintenance Technician',
+            'description' => 'Role for technicians responsible for managing maintenance records, work orders, equipment, and parts inventory.',
+            'policies'    => [
+                'MaintenanceManager',
+            ],
+        ],
         [
             'name'        => 'Driver Coordinator',
             'description' => 'Role responsible for coordinating drivers, vehicles, and orders.',

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

@@ -0,0 +1,150 @@
+<?php
+
+namespace Fleetbase\FleetOps\Console\Commands;
+
+use Carbon\Carbon;
+use Fleetbase\FleetOps\Models\MaintenanceSchedule;
+use Fleetbase\FleetOps\Models\Vehicle;
+use Fleetbase\FleetOps\Models\WorkOrder;
+use Illuminate\Console\Command;
+
+/**
+ * ProcessMaintenanceTriggers.
+ *
+ * Scans all active MaintenanceSchedule records and determines whether a
+ * preventive maintenance work order should be created based on:
+ *
+ *  - Time/date thresholds  (next_due_date)
+ *  - Odometer thresholds   (next_due_odometer vs. current vehicle odometer)
+ *  - Engine-hour thresholds (next_due_engine_hours vs. current engine hours)
+ *
+ * When a schedule is triggered, a WorkOrder is automatically created from the
+ * schedule's default settings and a `maintenance.triggered` event is dispatched.
+ *
+ * Designed to run on a scheduled basis (e.g. daily via the Laravel scheduler).
+ */
+class ProcessMaintenanceTriggers extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'fleetops:process-maintenance-triggers
+                            {--sandbox : Run in sandbox database mode}
+                            {--dry-run : Report triggers without creating work orders}';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Process preventive maintenance schedule triggers and auto-create work orders';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): void
+    {
+        date_default_timezone_set('UTC');
+
+        $sandbox = (bool) $this->option('sandbox');
+        $dryRun  = (bool) $this->option('dry-run');
+        $conn    = $sandbox ? 'sandbox' : 'mysql';
+
+        $this->info('Processing maintenance schedule triggers' . ($dryRun ? ' [DRY RUN]' : '') . ' at ' . Carbon::now()->toDateTimeString());
+
+        $triggered = 0;
+
+        // ------------------------------------------------------------------
+        // Load all active schedules that have at least one threshold set
+        // ------------------------------------------------------------------
+        $schedules = MaintenanceSchedule::on($conn)
+            ->withoutGlobalScopes()
+            ->where('status', 'active')
+            ->where(function ($q) {
+                $q->whereNotNull('next_due_date')
+                  ->orWhereNotNull('next_due_odometer')
+                  ->orWhereNotNull('next_due_engine_hours');
+            })
+            ->whereNull('deleted_at')
+            ->with('subject')
+            ->get();
+
+        foreach ($schedules as $schedule) {
+            $subject         = $schedule->subject;
+            $currentOdometer = null;
+            $currentEngHours = null;
+
+            // Resolve current readings from the subject asset if it is a vehicle
+            if ($subject instanceof Vehicle) {
+                $currentOdometer = $subject->odometer;
+                $currentEngHours = $subject->engine_hours;
+            }
+
+            if (!$schedule->isDue($currentOdometer, $currentEngHours)) {
+                continue;
+            }
+
+            // Build a human-readable reason string for logging
+            $reasons = [];
+            if ($schedule->next_due_date && now()->gte($schedule->next_due_date)) {
+                $reasons[] = 'date due ' . $schedule->next_due_date->toDateString();
+            }
+            if ($schedule->next_due_odometer && $currentOdometer !== null && $currentOdometer >= $schedule->next_due_odometer) {
+                $reasons[] = "odometer {$currentOdometer} >= {$schedule->next_due_odometer}";
+            }
+            if ($schedule->next_due_engine_hours && $currentEngHours !== null && $currentEngHours >= $schedule->next_due_engine_hours) {
+                $reasons[] = "engine hours {$currentEngHours} >= {$schedule->next_due_engine_hours}";
+            }
+
+            $this->line("Triggered: schedule {$schedule->public_id} ({$schedule->name}) — " . implode(', ', $reasons));
+
+            if (!$dryRun) {
+                // Check if a pending work order already exists for this schedule
+                // to avoid duplicates on repeated runs before the WO is completed
+                $existingOpen = WorkOrder::on($conn)
+                    ->withoutGlobalScopes()
+                    ->where('schedule_uuid', $schedule->uuid)
+                    ->whereIn('status', ['open', 'in_progress'])
+                    ->whereNull('deleted_at')
+                    ->exists();
+
+                if ($existingOpen) {
+                    $this->line('  → Skipped: open work order already exists for this schedule.');
+                    continue;
+                }
+
+                // Auto-generate a work order from the schedule defaults
+                // Generate a sequential WO code: WO-YYYYMMDD-XXXX
+                $woCount = WorkOrder::on($conn)->withoutGlobalScopes()->whereNull('deleted_at')->count() + 1;
+                $woCode  = 'WO-' . now()->format('Ymd') . '-' . str_pad($woCount, 4, '0', STR_PAD_LEFT);
+
+                $workOrder = WorkOrder::on($conn)->create([
+                    'company_uuid'    => $schedule->company_uuid,
+                    'schedule_uuid'   => $schedule->uuid,
+                    'subject'         => $schedule->name,
+                    'code'            => $woCode,
+                    'status'          => 'open',
+                    'priority'        => $schedule->default_priority ?? 'normal',
+                    'target_type'     => $schedule->subject_type,
+                    'target_uuid'     => $schedule->subject_uuid,
+                    'assignee_type'   => $schedule->default_assignee_type,
+                    'assignee_uuid'   => $schedule->default_assignee_uuid,
+                    'instructions'    => $schedule->instructions,
+                    'due_at'          => $schedule->next_due_date,
+                    'opened_at'       => now(),
+                    'created_by_uuid' => null, // system-generated
+                ]);
+
+                $this->line("  → Created work order {$workOrder->public_id}");
+
+                event('maintenance.triggered', [$schedule, $workOrder]);
+            }
+
+            $triggered++;
+        }
+
+        $this->info("Processed {$triggered} schedule trigger(s)" . ($dryRun ? ' (dry run — no work orders created)' : '.'));
+    }
+}

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

@@ -0,0 +1,128 @@
+<?php
+
+namespace Fleetbase\FleetOps\Console\Commands;
+
+use Fleetbase\FleetOps\Mail\MaintenanceScheduleReminder;
+use Fleetbase\FleetOps\Models\MaintenanceSchedule;
+use Illuminate\Console\Command;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Mail;
+
+/**
+ * Sends reminder emails for upcoming maintenance schedules.
+ *
+ * Runs daily. For each active schedule that has reminder_offsets configured,
+ * it checks whether any offset threshold has been crossed (i.e. today is within
+ * N days of next_due_date) and — if no reminder has already been sent for that
+ * offset + due-date combination — sends a MaintenanceScheduleReminder email to
+ * the default assignee and records the send in maintenance_schedule_reminders.
+ */
+class SendMaintenanceReminders extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'fleetops:send-maintenance-reminders
+                            {--sandbox : Run against the sandbox database connection}
+                            {--dry-run : Log which emails would be sent without actually sending}';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Send reminder emails for maintenance schedules that are approaching their due date';
+
+    /**
+     * Execute the console command.
+     */
+    public function handle(): void
+    {
+        date_default_timezone_set('UTC');
+        $sandbox = (bool) $this->option('sandbox');
+        $dryRun  = (bool) $this->option('dry-run');
+        $conn    = $sandbox ? 'sandbox' : 'mysql';
+
+        $this->info('Sending maintenance schedule reminders' . ($dryRun ? ' [DRY RUN]' : '') . ' at ' . Carbon::now()->toDateTimeString());
+
+        $sent = 0;
+
+        // Load all active schedules that have:
+        //   - a non-null next_due_date (reminders are date-based only)
+        //   - a non-null reminder_offsets JSON array
+        //   - a default_assignee configured
+        $schedules = MaintenanceSchedule::on($conn)
+            ->withoutGlobalScopes()
+            ->where('status', 'active')
+            ->whereNotNull('next_due_date')
+            ->whereNotNull('reminder_offsets')
+            ->whereNotNull('default_assignee_uuid')
+            ->whereNull('deleted_at')
+            ->with(['subject', 'defaultAssignee'])
+            ->get();
+
+        foreach ($schedules as $schedule) {
+            $offsets     = $schedule->reminder_offsets;
+            $nextDueDate = $schedule->next_due_date;
+
+            if (empty($offsets) || !$nextDueDate) {
+                continue;
+            }
+
+            // Resolve the recipient email from the polymorphic defaultAssignee
+            $assignee = $schedule->defaultAssignee;
+            $email    = $assignee?->email ?? null;
+
+            if (!$email) {
+                $this->line("  → Skipped schedule {$schedule->public_id}: no email on default assignee.");
+                continue;
+            }
+
+            $dueDateSnapshot = $nextDueDate->toDateString();
+
+            foreach ($offsets as $offsetDays) {
+                $offsetDays = (int) $offsetDays;
+
+                // The reminder window: today must be on or after (due_date - offset_days)
+                $reminderDate = $nextDueDate->copy()->subDays($offsetDays);
+
+                if (Carbon::today()->lt($reminderDate)) {
+                    // Not yet within the reminder window for this offset
+                    continue;
+                }
+
+                // Check whether we already sent this reminder for this cycle
+                $alreadySent = DB::connection($conn)
+                    ->table('maintenance_schedule_reminders')
+                    ->where('schedule_uuid', $schedule->uuid)
+                    ->where('offset_days', $offsetDays)
+                    ->where('due_date_snapshot', $dueDateSnapshot)
+                    ->exists();
+
+                if ($alreadySent) {
+                    continue;
+                }
+
+                $this->line("Sending reminder: schedule {$schedule->public_id} ({$schedule->name}) — {$offsetDays} days before {$dueDateSnapshot} → {$email}");
+
+                if (!$dryRun) {
+                    Mail::to($email)->send(new MaintenanceScheduleReminder($schedule, $offsetDays));
+
+                    DB::connection($conn)->table('maintenance_schedule_reminders')->insert([
+                        'schedule_uuid'     => $schedule->uuid,
+                        'offset_days'       => $offsetDays,
+                        'due_date_snapshot' => $dueDateSnapshot,
+                        'sent_at'           => Carbon::now(),
+                    ]);
+                }
+
+                $sent++;
+            }
+        }
+
+        $this->info("Sent {$sent} reminder(s)" . ($dryRun ? ' (dry run — no emails sent)' : '.'));
+    }
+}

package/server/src/Http/Controllers/Api/v1/OrderController.php

@@ -55,7 +55,14 @@ class OrderController extends Controller
         set_time_limit(180);
 
         // get request input
-        $input = $request->only(['internal_id', 'payload', 'service_quote', 'purchase_rate', 'adhoc', 'adhoc_distance', 'pod_method', 'pod_required', 'scheduled_at', 'status', 'meta', 'notes']);
+        $input = $request->only([
+            'internal_id', 'payload', 'service_quote', 'purchase_rate',
+            'adhoc', 'adhoc_distance', 'pod_method', 'pod_required',
+            'scheduled_at', 'status', 'meta', 'notes',
+            // Orchestrator constraints
+            'time_window_start', 'time_window_end',
+            'required_skills', 'orchestrator_priority',
+        ]);
 
         // Get order config
         $orderConfig = OrderConfig::resolveFromIdentifier($request->only(['type', 'order_config']));
@@ -363,7 +370,13 @@ class OrderController extends Controller
         }
 
         // get request input
-        $input = $request->only(['internal_id', 'payload', 'adhoc', 'adhoc_distance', 'pod_method', 'pod_required', 'scheduled_at', 'meta', 'type', 'status', 'notes']);
+        $input = $request->only([
+            'internal_id', 'payload', 'adhoc', 'adhoc_distance',
+            'pod_method', 'pod_required', 'scheduled_at', 'meta', 'type', 'status', 'notes',
+            // Orchestrator constraints
+            'time_window_start', 'time_window_end',
+            'required_skills', 'orchestrator_priority',
+        ]);
 
         // update payload if new input or change payload by id
         if ($request->isArray('payload')) {

package/server/src/Http/Controllers/Api/v1/VehicleController.php

@@ -26,7 +26,15 @@ class VehicleController extends Controller
     public function create(CreateVehicleRequest $request)
     {
         // get request input
-        $input = $request->only(['status', 'make', 'model', 'year', 'trim', 'type', 'plate_number', 'vin', 'meta', 'online', 'location', 'altitude', 'heading', 'speed']);
+        $input = $request->only([
+            'status', 'make', 'model', 'year', 'trim', 'type', 'plate_number', 'vin',
+            'meta', 'online', 'location', 'altitude', 'heading', 'speed',
+            // Capacity
+            'payload_capacity', 'payload_capacity_volume',
+            'payload_capacity_pallets', 'payload_capacity_parcels',
+            // Orchestrator constraints
+            'skills', 'max_tasks', 'time_window_start', 'time_window_end', 'return_to_depot',
+        ]);
 
         // make sure company is set
         $input['company_uuid'] = session('company');
@@ -97,7 +105,15 @@ class VehicleController extends Controller
         }
 
         // get request input
-        $input = $request->only(['status', 'make', 'model', 'year', 'trim', 'type', 'plate_number', 'vin', 'meta', 'location', 'online', 'altitude', 'heading', 'speed']);
+        $input = $request->only([
+            'status', 'make', 'model', 'year', 'trim', 'type', 'plate_number', 'vin',
+            'meta', 'location', 'online', 'altitude', 'heading', 'speed',
+            // Capacity
+            'payload_capacity', 'payload_capacity_volume',
+            'payload_capacity_pallets', 'payload_capacity_parcels',
+            // Orchestrator constraints
+            'skills', 'max_tasks', 'time_window_start', 'time_window_end', 'return_to_depot',
+        ]);
 
         // vendor assignment
         if ($request->has('vendor')) {

package/server/src/Http/Controllers/Internal/v1/DriverController.php

@@ -29,6 +29,7 @@ use Maatwebsite\Excel\Facades\Excel;
 
 class DriverController extends FleetOpsController
 {
+    use Traits\DriverSchedulingTrait;
     /**
      * The resource to query.
      *

package/server/src/Http/Controllers/Internal/v1/EquipmentController.php

@@ -3,6 +3,9 @@
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
+use Fleetbase\FleetOps\Imports\EquipmentImport;
+use Fleetbase\Http\Requests\ImportRequest;
+use Maatwebsite\Excel\Facades\Excel;
 
 class EquipmentController extends FleetOpsController
 {
@@ -12,4 +15,28 @@ class EquipmentController extends FleetOpsController
      * @var string
      */
     public $resource = 'equipment';
+
+    /**
+     * Process import files (excel, csv) into Equipment records.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function import(ImportRequest $request)
+    {
+        $disk          = $request->input('disk', config('filesystems.default'));
+        $files         = $request->resolveFilesFromIds();
+        $importedCount = 0;
+
+        foreach ($files as $file) {
+            try {
+                $import = new EquipmentImport();
+                Excel::import($import, $file->path, $disk);
+                $importedCount += $import->imported;
+            } catch (\Throwable $e) {
+                return response()->error('Invalid file, unable to process.');
+            }
+        }
+
+        return response()->json(['status' => 'ok', 'message' => 'Import completed', 'imported' => $importedCount]);
+    }
 }

package/server/src/Http/Controllers/Internal/v1/LiveController.php

@@ -38,9 +38,16 @@ class LiveController extends Controller
                 ->applyDirectivesForPermissions('fleet-ops list order')
                 ->get();
 
-            // Loop through each order to get its current destination location
+            // Loop through each order to get its current destination location.
+            // Filter out null and 0,0 fallback coordinates — these are returned
+            // by getCurrentDestinationLocation() when an order has no dropoff or
+            // waypoint set, and would cause the location service to resolve to
+            // the ocean (0,0 = Gulf of Guinea).
             foreach ($orders as $order) {
-                $coordinates[] = $order->getCurrentDestinationLocation();
+                $location = $order->getCurrentDestinationLocation();
+                if ($location && !($location->getLat() == 0 && $location->getLng() == 0)) {
+                    $coordinates[] = $location;
+                }
             }
 
             return response()->json($coordinates);