@fleetbase/fleetops-engine 0.6.48 → 0.6.49

package/server/src/Http/Resources/v1/Index/Driver.php

@@ -33,6 +33,7 @@ class Driver extends FleetbaseResource
             'current_job_uuid'=> $this->when($isInternal, $this->current_job_uuid),
             'name'            => $this->name,
             'vehicle_name'    => $this->when($isInternal, $this->vehicle_name),
+            'email'           => $this->email,
             'phone'           => $this->phone,
             'photo_url'       => $this->photo_url,
             'status'          => $this->status,
@@ -41,6 +42,53 @@ class Driver extends FleetbaseResource
             'altitude'        => (int) data_get($this, 'altitude', 0),
             'speed'           => (int) data_get($this, 'speed', 0),
             'online'          => data_get($this, 'online', false),
+            'meta'            => [
+                '_index_resource'         => true,
+                'location_coordinates'    => $this->locationCoordinates(),
+                'current_order_reference' => $this->currentOrderReference(),
+                'speed_label'             => $this->speedLabel(),
+                'heading_label'           => $this->headingLabel(),
+                'status_label'            => $this->statusLabel(),
+            ],
         ];
     }
+
+    protected function currentOrderReference(): ?string
+    {
+        $this->loadMissing('currentOrder');
+        $order = data_get($this, 'currentOrder');
+
+        return data_get($order, 'tracking') ?? data_get($order, 'public_id');
+    }
+
+    protected function locationCoordinates(): ?string
+    {
+        $location = Utils::castPoint($this->location);
+
+        return $location ? $this->formatCoordinate($location->getLat()) . ' ' . $this->formatCoordinate($location->getLng()) : null;
+    }
+
+    protected function speedLabel(): string
+    {
+        $speed = data_get($this, 'speed');
+
+        return is_numeric($speed) ? ((int) $speed) . ' km/h' : '-';
+    }
+
+    protected function headingLabel(): string
+    {
+        $heading = data_get($this, 'heading');
+
+        return is_numeric($heading) ? ((int) $heading) . ' deg' : '-';
+    }
+
+    protected function statusLabel(): ?string
+    {
+        return $this->status ? str($this->status)->replace(['_', '-'], ' ')->headline()->toString() : null;
+    }
+
+    protected function formatCoordinate(float $coordinate): string
+    {
+        return (string) round($coordinate, 4);
+    }
 }

package/server/src/Http/Resources/v1/Index/Vehicle.php

@@ -2,6 +2,7 @@
 
 namespace Fleetbase\FleetOps\Http\Resources\v1\Index;
 
+use Fleetbase\FleetOps\Models\Order;
 use Fleetbase\FleetOps\Support\Utils;
 use Fleetbase\Http\Resources\FleetbaseResource;
 use Fleetbase\Support\Http;
@@ -28,8 +29,12 @@ class Vehicle extends FleetbaseResource
             'company_uuid'    => $this->when($isInternal, $this->company_uuid),
             'vendor_uuid'     => $this->when($isInternal, $this->vendor_uuid),
             'photo_uuid'      => $this->when($isInternal, $this->photo_uuid),
+            'internal_id'     => $this->internal_id,
             'display_name'    => $this->display_name,
+            'driver_name'     => $this->driver_name,
             'plate_number'    => $this->plate_number,
+            'serial_number'   => $this->serial_number,
+            'vin'             => $this->vin,
             'make'            => $this->make,
             'model'           => $this->model,
             'year'            => $this->year,
@@ -43,8 +48,76 @@ class Vehicle extends FleetbaseResource
 
             // Meta flag to indicate this is an index resource
             'meta'            => [
-                '_index_resource' => true,
+                '_index_resource'          => true,
+                'current_order_reference'  => $this->currentOrderReference(),
+                'location_coordinates'     => $this->locationCoordinates(),
+                'speed_label'              => $this->speedLabel(),
+                'heading_label'            => $this->headingLabel(),
+                'status_label'             => $this->statusLabel(),
             ],
         ];
     }
+
+    protected function currentOrderReference(): ?string
+    {
+        $this->loadMissing('driver.currentOrder');
+        $order = data_get($this, 'driver.currentOrder') ?? $this->currentPositionOrder() ?? $this->currentVehicleOrder();
+
+        return data_get($order, 'tracking') ?? data_get($order, 'public_id');
+    }
+
+    protected function locationCoordinates(): ?string
+    {
+        $location = Utils::castPoint($this->location);
+
+        return $location ? $this->formatCoordinate($location->getLat()) . ' ' . $this->formatCoordinate($location->getLng()) : null;
+    }
+
+    protected function speedLabel(): string
+    {
+        $speed = data_get($this->lastKnownPosition(), 'speed', data_get($this, 'speed'));
+
+        return is_numeric($speed) ? ((int) $speed) . ' km/h' : '-';
+    }
+
+    protected function headingLabel(): string
+    {
+        $heading = data_get($this->lastKnownPosition(), 'heading', data_get($this, 'heading'));
+
+        return is_numeric($heading) ? ((int) $heading) . ' deg' : '-';
+    }
+
+    protected function statusLabel(): ?string
+    {
+        return $this->status ? str($this->status)->replace(['_', '-'], ' ')->headline()->toString() : null;
+    }
+
+    protected function currentPositionOrder(): ?Order
+    {
+        $orderUuid = data_get($this->lastKnownPosition(), 'order_uuid');
+
+        return $orderUuid ? Order::where('uuid', $orderUuid)->first() : null;
+    }
+
+    protected function currentVehicleOrder(): ?Order
+    {
+        return Order::where('vehicle_assigned_uuid', $this->uuid)
+            ->whereNotIn('status', ['completed', 'canceled', 'cancelled'])
+            ->latest()
+            ->first();
+    }
+
+    protected function lastKnownPosition()
+    {
+        if (!$this->resource->relationLoaded('last_known_position')) {
+            $this->resource->setRelation('last_known_position', $this->getLastKnownPosition());
+        }
+
+        return $this->resource->getRelation('last_known_position');
+    }
+
+    protected function formatCoordinate(float $coordinate): string
+    {
+        return (string) round($coordinate, 4);
+    }
 }

package/server/src/Models/Driver.php

@@ -97,6 +97,7 @@ class Driver extends Model
         'signup_token_used',
         'avatar_url',
         'drivers_license_number',
+        'license_expiry',
         'location',
         'heading',
         'bearing',
@@ -141,6 +142,7 @@ class Driver extends Model
         'location'        => Point::class,
         'online'          => 'boolean',
         'meta'            => Json::class,
+        'license_expiry'  => 'date',
         // Orchestrator
         'skills'          => Json::class,
         'max_travel_time' => 'integer',

package/server/src/Models/OrderConfig.php

@@ -458,28 +458,31 @@ class OrderConfig extends Model
     /**
      * Resolves an OrderConfig from a given identifier or an array of identifiers within an optional company context.
      *
-     * @param string|array $orderConfigIdentifier the identifier(s) for the OrderConfig (namespace, public_id, or key)
+     * @param string|array $orderConfigIdentifier the identifier(s) for the OrderConfig (uuid, namespace, public_id, or key)
      * @param Company|null $company               the company context, if any, to narrow down the search
      *
      * @return OrderConfig|null the found OrderConfig or null if none found
      */
     public static function resolveFromIdentifier($orderConfigIdentifier, ?Company $company = null): ?OrderConfig
     {
-        $query = static::query();
+        $companyUuid  = $company instanceof Company ? $company->uuid : session('company');
+        $identifiers  = is_array($orderConfigIdentifier) ? $orderConfigIdentifier : [$orderConfigIdentifier];
+        $identifiers  = collect($identifiers)->filter(fn ($identifier) => filled($identifier))->values();
+
+        if ($identifiers->isEmpty()) {
+            return static::default($company);
+        }
+
+        foreach ($identifiers as $identifier) {
+            $query = static::query();
 
-        if ($company instanceof Company) {
-            $query->where('company_uuid', $company->uuid);
-        } else {
-            $companyUuid = session('company');
             if ($companyUuid) {
                 $query->where('company_uuid', $companyUuid);
             }
-        }
 
-        $identifiers = is_array($orderConfigIdentifier) ? $orderConfigIdentifier : [$orderConfigIdentifier];
-        foreach ($identifiers as $identifier) {
             $orderConfig = $query->where(function ($query) use ($identifier) {
-                $query->where('namespace', $identifier)
+                $query->where('uuid', $identifier)
+                      ->orWhere('namespace', $identifier)
                       ->orWhere('public_id', $identifier)
                       ->orWhere('key', $identifier);
             })->first();
@@ -489,7 +492,7 @@ class OrderConfig extends Model
             }
         }
 
-        return static::default($company);
+        return null;
     }
 
     /**

package/server/src/Notifications/LateDeparture.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Fleetbase\FleetOps\Notifications;
+
+use Fleetbase\FleetOps\Models\Order;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Notifications\Messages\MailMessage;
+use Illuminate\Notifications\Notification;
+
+class LateDeparture extends Notification implements ShouldQueue
+{
+    use Queueable;
+
+    public static string $name = 'Late Departure';
+    public static string $description = 'Notify when an order has not departed after the configured grace period.';
+    public static string $package = 'fleet-ops';
+
+    public function __construct(public Order $order, public array $context = [])
+    {
+    }
+
+    public function via($notifiable): array
+    {
+        return ['mail', 'database'];
+    }
+
+    public function toMail($notifiable): MailMessage
+    {
+        $orderId = $this->order->tracking ?? $this->order->public_id;
+
+        return (new MailMessage())
+            ->subject("Late departure detected for {$orderId}")
+            ->line("Order {$orderId} has not departed within the configured grace period.")
+            ->line('Please review the order and dispatch status.');
+    }
+
+    public function toArray($notifiable): array
+    {
+        return [
+            'event'      => 'order.late_departure',
+            'order_id'   => $this->order->public_id,
+            'order_uuid' => $this->order->uuid,
+            'context'    => $this->context,
+            'message'    => sprintf('Order %s has not departed within the configured grace period.', $this->order->tracking ?? $this->order->public_id),
+        ];
+    }
+}

package/server/src/Notifications/ProlongedStoppage.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Fleetbase\FleetOps\Notifications;
+
+use Fleetbase\FleetOps\Models\Order;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Notifications\Messages\MailMessage;
+use Illuminate\Notifications\Notification;
+
+class ProlongedStoppage extends Notification implements ShouldQueue
+{
+    use Queueable;
+
+    public static string $name = 'Prolonged Stoppage';
+    public static string $description = 'Notify when a vehicle remains stopped during an active trip beyond the configured threshold.';
+    public static string $package = 'fleet-ops';
+
+    public function __construct(public Order $order, public array $context = [])
+    {
+    }
+
+    public function via($notifiable): array
+    {
+        return ['mail', 'database'];
+    }
+
+    public function toMail($notifiable): MailMessage
+    {
+        $orderId = $this->order->tracking ?? $this->order->public_id;
+
+        return (new MailMessage())
+            ->subject("Prolonged stoppage detected for {$orderId}")
+            ->line("The vehicle assigned to order {$orderId} has remained stopped beyond the configured threshold.")
+            ->line('Please review the active trip and vehicle location.');
+    }
+
+    public function toArray($notifiable): array
+    {
+        return [
+            'event'      => 'order.prolonged_stoppage',
+            'order_id'   => $this->order->public_id,
+            'order_uuid' => $this->order->uuid,
+            'context'    => $this->context,
+            'message'    => sprintf('The vehicle assigned to order %s has remained stopped beyond the configured threshold.', $this->order->tracking ?? $this->order->public_id),
+        ];
+    }
+}

package/server/src/Notifications/RouteDeviation.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Fleetbase\FleetOps\Notifications;
+
+use Fleetbase\FleetOps\Models\Order;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Notifications\Messages\MailMessage;
+use Illuminate\Notifications\Notification;
+
+class RouteDeviation extends Notification implements ShouldQueue
+{
+    use Queueable;
+
+    public static string $name = 'Route Deviation';
+    public static string $description = 'Notify when tracked vehicle location deviates from the active route beyond the configured threshold.';
+    public static string $package = 'fleet-ops';
+
+    public function __construct(public Order $order, public array $context = [])
+    {
+    }
+
+    public function via($notifiable): array
+    {
+        return ['mail', 'database'];
+    }
+
+    public function toMail($notifiable): MailMessage
+    {
+        $orderId = $this->order->tracking ?? $this->order->public_id;
+
+        return (new MailMessage())
+            ->subject("Route deviation detected for {$orderId}")
+            ->line("The vehicle assigned to order {$orderId} has deviated from the active route beyond the configured threshold.")
+            ->line('Please review the route and current vehicle position.');
+    }
+
+    public function toArray($notifiable): array
+    {
+        return [
+            'event'      => 'order.route_deviation',
+            'order_id'   => $this->order->public_id,
+            'order_uuid' => $this->order->uuid,
+            'context'    => $this->context,
+            'message'    => sprintf('The vehicle assigned to order %s has deviated from the active route beyond the configured threshold.', $this->order->tracking ?? $this->order->public_id),
+        ];
+    }
+}

package/server/src/Orchestration/Engines/VroomOrchestrationEngine.php

@@ -171,12 +171,17 @@ class VroomOrchestrationEngine implements OrchestrationEngineInterface
         $vroomPayload = $this->buildCapacityOnlyPayload($capacityTasks, $vroomVehicles, $options, $jobIdReverse);
 
         if (empty($vroomPayload['vehicles'])) {
+            $vehiclePacking   = $this->resolveVehiclePacking($options);
+            $vehicleFixedCost = $this->resolveVehicleFixedCost($options);
+
             return $this->mergeInvalidTasks([
                 'assignments' => [],
                 'unassigned'  => array_column($capacityTasks, 'id'),
                 'summary'     => [
                     'engine'              => 'vroom',
                     'allocation_strategy' => 'capacity_only',
+                    'vehicle_packing'     => $vehiclePacking,
+                    'vehicle_fixed_cost'  => $vehiclePacking === 'minimize_vehicles' ? $vehicleFixedCost : null,
                     'assigned'            => 0,
                     'unassigned'          => count($capacityTasks),
                     'unassigned_reasons'  => array_map(fn (array $task) => [
@@ -192,6 +197,8 @@ class VroomOrchestrationEngine implements OrchestrationEngineInterface
         $result['summary'] = array_merge($result['summary'] ?? [], [
             'engine'              => 'vroom',
             'allocation_strategy' => 'capacity_only',
+            'vehicle_packing'     => $this->resolveVehiclePacking($options),
+            'vehicle_fixed_cost'  => $this->resolveVehiclePacking($options) === 'minimize_vehicles' ? $this->resolveVehicleFixedCost($options) : null,
         ]);
 
         return $this->mergeInvalidTasks($result, $invalidTasks);
@@ -203,10 +210,12 @@ class VroomOrchestrationEngine implements OrchestrationEngineInterface
         $profile         = $options['profile'] ?? 'capacity_only';
         $respectCapacity = (bool) ($options['respect_capacity'] ?? true);
         $respectSkills   = (bool) ($options['respect_skills'] ?? true);
+        $vehiclePacking  = $this->resolveVehiclePacking($options);
+        $fixedCost       = $this->resolveVehicleFixedCost($options);
 
         $vroomPayload = [
             'jobs'     => [],
-            'vehicles' => array_map(function (array $v) use ($profile, $respectCapacity, $respectSkills) {
+            'vehicles' => array_map(function (array $v) use ($profile, $respectCapacity, $respectSkills, $vehiclePacking, $fixedCost) {
                 $vehicle = [
                     'id'          => crc32($v['id']),
                     'description' => json_encode(['vehicle_id' => $v['id'], 'driver_id' => $v['driver_id'] ?? null]),
@@ -214,6 +223,10 @@ class VroomOrchestrationEngine implements OrchestrationEngineInterface
                     'start_index' => 0,
                 ];
 
+                if ($vehiclePacking === 'minimize_vehicles') {
+                    $vehicle['costs'] = ['fixed' => $fixedCost];
+                }
+
                 if ($respectCapacity) {
                     $vehicle['capacity'] = $v['capacity'];
                 }
@@ -265,6 +278,20 @@ class VroomOrchestrationEngine implements OrchestrationEngineInterface
         return $vroomPayload;
     }
 
+    protected function resolveVehiclePacking(array $options): string
+    {
+        $packing = strtolower((string) ($options['vehicle_packing'] ?? 'minimize_vehicles'));
+
+        return in_array($packing, ['minimize_vehicles', 'balanced', 'none'], true)
+            ? $packing
+            : 'minimize_vehicles';
+    }
+
+    protected function resolveVehicleFixedCost(array $options): int
+    {
+        return max(0, (int) ($options['vehicle_fixed_cost'] ?? 100000));
+    }
+
     protected function buildUniformMatrix(int $size): array
     {
         $matrix = [];

package/server/src/Providers/FleetOpsServiceProvider.php

@@ -65,6 +65,7 @@ class FleetOpsServiceProvider extends CoreServiceProvider
         \Fleetbase\FleetOps\Console\Commands\TestEmail::class,
         \Fleetbase\FleetOps\Console\Commands\ProcessMaintenanceTriggers::class,
         \Fleetbase\FleetOps\Console\Commands\SendMaintenanceReminders::class,
+        \Fleetbase\FleetOps\Console\Commands\ProcessOperationalAlerts::class,
     ];
 
     /**
@@ -126,6 +127,7 @@ class FleetOpsServiceProvider extends CoreServiceProvider
             $schedule->command('fleetops:purge-service-quotes')->daily()->withoutOverlapping();
             $schedule->command('fleetops:process-maintenance-triggers')->daily()->withoutOverlapping()->storeOutputInDb();
             $schedule->command('fleetops:send-maintenance-reminders')->daily()->withoutOverlapping()->storeOutputInDb();
+            $schedule->command('fleetops:process-operational-alerts')->everyMinute()->withoutOverlapping()->storeOutputInDb();
         });
         $this->registerNotifications();
         $this->registerExpansionsFrom(__DIR__ . '/../Expansions');
@@ -192,6 +194,9 @@ class FleetOpsServiceProvider extends CoreServiceProvider
             \Fleetbase\FleetOps\Notifications\OrderFailed::class,
             \Fleetbase\FleetOps\Notifications\OrderCompleted::class,
             \Fleetbase\FleetOps\Notifications\DriverArrivedAtGeofence::class,
+            \Fleetbase\FleetOps\Notifications\LateDeparture::class,
+            \Fleetbase\FleetOps\Notifications\RouteDeviation::class,
+            \Fleetbase\FleetOps\Notifications\ProlongedStoppage::class,
         ]);
 
         // Register Notifiables

package/server/src/Providers/NotificationServiceProvider.php

@@ -31,6 +31,9 @@ class NotificationServiceProvider extends CoreServiceProvider
             \Fleetbase\FleetOps\Notifications\OrderDispatched::class,
             \Fleetbase\FleetOps\Notifications\OrderDispatchFailed::class,
             \Fleetbase\FleetOps\Notifications\OrderPing::class,
+            \Fleetbase\FleetOps\Notifications\LateDeparture::class,
+            \Fleetbase\FleetOps\Notifications\RouteDeviation::class,
+            \Fleetbase\FleetOps\Notifications\ProlongedStoppage::class,
         ]);
 
         // Register Notifiables

package/server/src/Support/Analytics/AbstractAnalytics.php

@@ -0,0 +1,77 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Analytics;
+
+use Fleetbase\Models\Company;
+use Illuminate\Support\Carbon;
+
+/**
+ * Base for analytics-widget data providers. Unlike scalar Metrics, each
+ * subclass returns a widget-specific JSON shape (Chart.js datasets, ranked
+ * rows, scalar tiles, map points, etc.) so the base just provides company
+ * scoping + period parsing.
+ */
+abstract class AbstractAnalytics
+{
+    protected Company $company;
+    protected ?\DateTimeInterface $start = null;
+    protected ?\DateTimeInterface $end   = null;
+
+    abstract public function get(): array;
+
+    public static function forCompany(Company $company): static
+    {
+        return (new static())->setCompany($company);
+    }
+
+    public function between(?\DateTimeInterface $start, ?\DateTimeInterface $end): static
+    {
+        $this->start = $start;
+        $this->end   = $end;
+
+        return $this;
+    }
+
+    /**
+     * Resolve a [start, end] tuple from a `period` shorthand or explicit dates,
+     * falling back to a 30-day window. Shared by every analytics call.
+     */
+    public static function resolvePeriod(?string $period, ?\DateTimeInterface $start, ?\DateTimeInterface $end, int $defaultDays = 30): array
+    {
+        if ($period !== null && $period !== '') {
+            $days = match ($period) {
+                '7d'   => 7,
+                '14d'  => 14,
+                '30d'  => 30,
+                '90d'  => 90,
+                '180d' => 180,
+                '365d' => 365,
+                default => null,
+            };
+
+            if ($days !== null) {
+                return [
+                    Carbon::now()->subDays($days)->toDateTime(),
+                    Carbon::now()->toDateTime(),
+                ];
+            }
+        }
+
+        return [
+            $start ?? Carbon::now()->subDays($defaultDays)->toDateTime(),
+            $end ?? Carbon::now()->toDateTime(),
+        ];
+    }
+
+    protected function setCompany(Company $company): static
+    {
+        $this->company = $company;
+
+        return $this;
+    }
+
+    protected function companyCurrency(): string
+    {
+        return $this->company->currency ?? 'USD';
+    }
+}

package/server/src/Support/Analytics/FuelEfficiency.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace Fleetbase\FleetOps\Support\Analytics;
+
+use Fleetbase\FleetOps\Models\FuelReport;
+use Fleetbase\FleetOps\Models\Order;
+use Illuminate\Support\Carbon;
+
+/**
+ * Dual-axis fuel chart: weekly total cost (bars) + cost-per-km (line).
+ * Cost-per-km is sum(FuelReport.amount in primary currency) divided by
+ * sum(Order.distance, in km) for that bucket.
+ */
+class FuelEfficiency extends AbstractAnalytics
+{
+    public function get(): array
+    {
+        $currency = $this->companyCurrency();
+        $start    = $this->start ?? Carbon::now()->subDays(90)->toDateTime();
+        $end      = $this->end ?? Carbon::now()->toDateTime();
+
+        $fuelByWeek = FuelReport::where('company_uuid', $this->company->uuid)
+            ->where('currency', $currency)
+            ->whereBetween('created_at', [$start, $end])
+            ->selectRaw("YEARWEEK(created_at, 1) as wk, MIN(DATE(created_at)) as wk_start, SUM(amount) as total_cost")
+            ->groupBy('wk')
+            ->orderBy('wk')
+            ->get();
+
+        $distanceByWeek = Order::where('company_uuid', $this->company->uuid)
+            ->where('status', 'completed')
+            ->whereBetween('updated_at', [$start, $end])
+            ->selectRaw("YEARWEEK(updated_at, 1) as wk, SUM(distance) as total_distance")
+            ->groupBy('wk')
+            ->orderBy('wk')
+            ->pluck('total_distance', 'wk');
+
+        $labels    = [];
+        $costData  = [];
+        $cpkmData  = [];
+
+        foreach ($fuelByWeek as $row) {
+            $labels[]   = Carbon::parse($row->wk_start)->format('M j');
+            $cost       = (float) $row->total_cost;
+            $distanceM  = (float) ($distanceByWeek[$row->wk] ?? 0);
+            $distanceKm = $distanceM / 1000.0;
+            $costData[] = round($cost, 2);
+            $cpkmData[] = $distanceKm > 0 ? round($cost / $distanceKm, 3) : null;
+        }
+
+        $totalCost      = array_sum($costData);
+        $totalDistanceM = array_sum($distanceByWeek->all());
+        $avgCostPerKm   = $totalDistanceM > 0
+            ? round($totalCost / ($totalDistanceM / 1000.0), 3)
+            : 0.0;
+
+        return [
+            'labels'   => $labels,
+            'datasets' => [
+                [
+                    'type'            => 'bar',
+                    'label'           => 'Fuel Cost',
+                    'data'            => $costData,
+                    'yAxisID'         => 'y1',
+                    'backgroundColor' => '#3485e2',
+                ],
+                [
+                    'type'        => 'line',
+                    'label'       => 'Cost per km',
+                    'data'        => $cpkmData,
+                    'yAxisID'     => 'y2',
+                    'borderColor' => '#f59e0b',
+                    'tension'     => 0.3,
+                ],
+            ],
+            'summary' => [
+                'total_cost'       => round($totalCost, 2),
+                'currency'         => $currency,
+                'avg_cost_per_km'  => $avgCostPerKm,
+            ],
+        ];
+    }
+}