@fleetbase/fleetops-engine 0.6.38 → 0.6.40

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

@@ -3,6 +3,12 @@
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
+use Fleetbase\FleetOps\Imports\MaintenanceImport;
+use Fleetbase\FleetOps\Models\Maintenance;
+use Fleetbase\Http\Requests\ImportRequest;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Maatwebsite\Excel\Facades\Excel;
 
 class MaintenanceController extends FleetOpsController
 {
@@ -12,4 +18,163 @@ class MaintenanceController extends FleetOpsController
      * @var string
      */
     public $resource = 'maintenance';
+
+    /**
+     * Eager-load polymorphic relationships after create so they appear in the API response.
+     * Called automatically by HasApiControllerBehavior::createRecord() via getControllerCallback.
+     */
+    public function onAfterCreate($request, Maintenance $record, array $input): void
+    {
+        $record->load(['maintainable', 'performedBy']);
+    }
+
+    /**
+     * Eager-load polymorphic relationships after update so they appear in the API response.
+     * Called automatically by HasApiControllerBehavior::updateRecord() via getControllerCallback.
+     */
+    public function onAfterUpdate($request, Maintenance $record, array $input): void
+    {
+        $record->load(['maintainable', 'performedBy']);
+    }
+
+    /**
+     * Eager-load polymorphic relationships when finding record so they appear in the API response.
+     * Called automatically by HasApiControllerBehavior::findRecord() via getControllerCallback.
+     */
+    public function onFindRecord($builder, $request): void
+    {
+        $builder->with(['maintainable', 'performedBy']);
+    }
+
+    /**
+     * Add a cost line item to a maintenance record.
+     * POST /maintenances/{id}/line-items.
+     */
+    public function addLineItem(string $id, Request $request): JsonResponse
+    {
+        $maintenance = Maintenance::where('uuid', $id)
+            ->orWhere('public_id', $id)
+            ->firstOrFail();
+
+        $validated = $request->validate([
+            'description' => 'required|string|max:255',
+            'quantity'    => 'required|numeric|min:0',
+            'unit_cost'   => 'required|integer|min:0',
+            'currency'    => 'nullable|string|size:3',
+        ]);
+
+        $maintenance->addLineItem($validated);
+        $maintenance->refresh();
+        $this->recalculateCosts($maintenance);
+
+        return response()->json([
+            'status'     => 'ok',
+            'line_items' => $maintenance->line_items,
+            'total_cost' => $maintenance->total_cost,
+        ]);
+    }
+
+    /**
+     * Update a cost line item on a maintenance record.
+     * PUT /maintenances/{id}/line-items/{index}.
+     */
+    public function updateLineItem(string $id, int $index, Request $request): JsonResponse
+    {
+        $maintenance = Maintenance::where('uuid', $id)
+            ->orWhere('public_id', $id)
+            ->firstOrFail();
+
+        $validated = $request->validate([
+            'description' => 'required|string|max:255',
+            'quantity'    => 'required|numeric|min:0',
+            'unit_cost'   => 'required|integer|min:0',
+            'currency'    => 'nullable|string|size:3',
+        ]);
+
+        $lineItems = $maintenance->line_items ?? [];
+
+        if (!isset($lineItems[$index])) {
+            return response()->json(['error' => 'Line item not found.'], 404);
+        }
+
+        $lineItems[$index] = array_merge($lineItems[$index], $validated, [
+            'updated_at' => now(),
+        ]);
+
+        $maintenance->update(['line_items' => $lineItems]);
+        $maintenance->refresh();
+        $this->recalculateCosts($maintenance);
+
+        return response()->json([
+            'status'     => 'ok',
+            'line_items' => $maintenance->line_items,
+            'total_cost' => $maintenance->total_cost,
+        ]);
+    }
+
+    /**
+     * Remove a cost line item from a maintenance record.
+     * DELETE /maintenances/{id}/line-items/{index}.
+     */
+    public function removeLineItem(string $id, int $index): JsonResponse
+    {
+        $maintenance = Maintenance::where('uuid', $id)
+            ->orWhere('public_id', $id)
+            ->firstOrFail();
+
+        if (!$maintenance->removeLineItem($index)) {
+            return response()->json(['error' => 'Line item not found.'], 404);
+        }
+
+        $maintenance->refresh();
+        $this->recalculateCosts($maintenance);
+
+        return response()->json([
+            'status'     => 'ok',
+            'line_items' => $maintenance->line_items,
+            'total_cost' => $maintenance->total_cost,
+        ]);
+    }
+
+    /**
+     * Process import files (excel, csv) into Maintenance 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 MaintenanceImport();
+                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]);
+    }
+
+    /**
+     * Recalculate and persist parts_cost and total_cost derived from line_items.
+     * All monetary values are stored as integers (smallest currency unit, e.g. cents).
+     */
+    protected function recalculateCosts(Maintenance $maintenance): void
+    {
+        $lineItems = $maintenance->line_items ?? [];
+        $partsCost = (int) collect($lineItems)->sum(fn ($item) => ($item['quantity'] ?? 0) * ($item['unit_cost'] ?? 0));
+        $laborCost = (int) ($maintenance->labor_cost ?? 0);
+        $tax       = (int) ($maintenance->tax ?? 0);
+        $totalCost = $laborCost + $partsCost + $tax;
+
+        $maintenance->update([
+            'parts_cost' => $partsCost,
+            'total_cost' => $totalCost,
+        ]);
+    }
 }

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

@@ -0,0 +1,304 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
+
+use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
+use Fleetbase\FleetOps\Imports\MaintenanceScheduleImport;
+use Fleetbase\FleetOps\Models\MaintenanceSchedule;
+use Fleetbase\FleetOps\Models\WorkOrder;
+use Fleetbase\Http\Requests\ImportRequest;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Support\Carbon;
+use Maatwebsite\Excel\Facades\Excel;
+use Spatie\IcalendarGenerator\Components\Calendar;
+use Spatie\IcalendarGenerator\Components\Event;
+use Spatie\IcalendarGenerator\Enums\RecurrenceFrequency;
+use Spatie\IcalendarGenerator\ValueObjects\RRule;
+
+class MaintenanceScheduleController extends FleetOpsController
+{
+    /**
+     * The resource to query.
+     *
+     * @var string
+     */
+    public $resource = 'maintenance-schedule';
+
+    /**
+     * Process import files (excel, csv) into MaintenanceSchedule records.
+     *
+     * @return 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 MaintenanceScheduleImport();
+                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]);
+    }
+
+    /**
+     * Pause a maintenance schedule.
+     * POST /maintenance-schedules/{id}/pause.
+     */
+    public function pause(string $id): JsonResponse
+    {
+        $schedule = MaintenanceSchedule::where('uuid', $id)
+            ->orWhere('public_id', $id)
+            ->firstOrFail();
+
+        $schedule->pause();
+
+        return response()->json([
+            'status'  => 'ok',
+            'message' => 'Maintenance schedule paused.',
+            'data'    => $schedule->fresh(),
+        ]);
+    }
+
+    /**
+     * Resume a paused maintenance schedule.
+     * POST /maintenance-schedules/{id}/resume.
+     */
+    public function resume(string $id): JsonResponse
+    {
+        $schedule = MaintenanceSchedule::where('uuid', $id)
+            ->orWhere('public_id', $id)
+            ->firstOrFail();
+
+        $schedule->resume();
+
+        return response()->json([
+            'status'  => 'ok',
+            'message' => 'Maintenance schedule resumed.',
+            'data'    => $schedule->fresh(),
+        ]);
+    }
+
+    /**
+     * Manually trigger a work order from a schedule.
+     * POST /maintenance-schedules/{id}/trigger.
+     */
+    public function trigger(string $id, Request $request): JsonResponse
+    {
+        $schedule = MaintenanceSchedule::where('uuid', $id)
+            ->orWhere('public_id', $id)
+            ->firstOrFail();
+
+        $workOrder = WorkOrder::create([
+            'company_uuid'    => $schedule->company_uuid,
+            'schedule_uuid'   => $schedule->uuid,
+            'subject'         => $schedule->name,
+            '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,
+            'created_by_uuid' => session('user'),
+        ]);
+
+        return response()->json([
+            'status'     => 'ok',
+            'message'    => 'Work order created from schedule.',
+            'work_order' => $workOrder,
+        ]);
+    }
+
+    /**
+     * Return a JSON calendar feed of upcoming maintenance schedule events.
+     *
+     * Accepts optional `start` and `end` query params (ISO 8601 date strings)
+     * to limit the visible window. Defaults to the next 90 days.
+     *
+     * For recurring schedules (those with interval_value + interval_unit set)
+     * we expand all occurrences that fall inside the requested window, not just
+     * the single stored next_due_date. This is what makes navigating to future
+     * calendar months work correctly.
+     *
+     * GET /maintenance-schedules/calendar-feed
+     */
+    public function calendarFeed(Request $request): JsonResponse
+    {
+        $windowStart = $request->input('start')
+            ? Carbon::parse($request->input('start'))->startOfDay()
+            : Carbon::today();
+
+        $windowEnd = $request->input('end')
+            ? Carbon::parse($request->input('end'))->endOfDay()
+            : Carbon::today()->addDays(90)->endOfDay();
+
+        // Fetch all active schedules whose next_due_date is on or before the
+        // window end. Schedules that start after the window end can never
+        // produce an occurrence inside the window.
+        $schedules = MaintenanceSchedule::withoutGlobalScopes()
+            ->where('status', 'active')
+            ->whereNotNull('next_due_date')
+            ->where('next_due_date', '<=', $windowEnd)
+            ->whereNull('deleted_at')
+            ->with(['subject', 'defaultAssignee'])
+            ->get();
+
+        $events = [];
+
+        foreach ($schedules as $schedule) {
+            $assetName = $schedule->subject?->name
+                ?? $schedule->subject?->display_name
+                ?? $schedule->subject?->public_id
+                ?? 'Unknown Asset';
+
+            $assigneeName = $schedule->defaultAssignee?->name ?? null;
+            $color        = $this->eventColorForPriority($schedule->default_priority);
+
+            $baseEvent = [
+                'id'            => $schedule->public_id,
+                'uuid'          => $schedule->uuid,
+                'title'         => $schedule->name . ' — ' . $assetName,
+                'allDay'        => true,
+                'status'        => $schedule->status,
+                'priority'      => $schedule->default_priority,
+                'type'          => $schedule->type,
+                'subject_name'  => $assetName,
+                'assignee_name' => $assigneeName,
+                'color'         => $color,
+            ];
+
+            $intervalValue = (int) ($schedule->interval_value ?? 0);
+            $intervalUnit  = $schedule->interval_unit ?? null; // days | weeks | months | years
+            $firstDue      = $schedule->next_due_date->copy()->startOfDay();
+
+            if ($intervalValue > 0 && $intervalUnit) {
+                // --- Recurring schedule: expand all occurrences in the window ---
+                //
+                // Walk forward from next_due_date in steps of (interval_value interval_unit)
+                // and emit an event for every occurrence that falls inside [windowStart, windowEnd].
+                // We cap at 500 occurrences as a safety guard.
+                $occurrence     = $firstDue->copy();
+                $count          = 0;
+                $maxOccurrences = 500;
+
+                while ($occurrence->lte($windowEnd) && $count < $maxOccurrences) {
+                    if ($occurrence->gte($windowStart)) {
+                        $dateStr  = $occurrence->toDateString();
+                        $events[] = array_merge($baseEvent, [
+                            // Keep id as the plain public_id so the click
+                            // handler can navigate to the schedule details.
+                            'id'              => $schedule->public_id,
+                            'start'           => $dateStr,
+                            'end'             => $dateStr,
+                            'occurrence_date' => $dateStr,
+                        ]);
+                    }
+                    $occurrence->add($intervalValue . ' ' . $intervalUnit);
+                    $count++;
+                }
+            } else {
+                // --- One-off schedule: emit only if it falls in the window ---
+                if ($firstDue->between($windowStart, $windowEnd)) {
+                    $dateStr  = $firstDue->toDateString();
+                    $events[] = array_merge($baseEvent, [
+                        'start' => $dateStr,
+                        'end'   => $dateStr,
+                    ]);
+                }
+            }
+        }
+
+        return response()->json(['events' => $events]);
+    }
+
+    /**
+     * Download an iCal (.ics) file for a single maintenance schedule.
+     *
+     * GET /maintenance-schedules/{id}/ical
+     */
+    public function ical(string $id): Response
+    {
+        $schedule = MaintenanceSchedule::where('uuid', $id)
+            ->orWhere('public_id', $id)
+            ->with(['subject', 'defaultAssignee'])
+            ->firstOrFail();
+
+        $assetName = $schedule->subject?->name
+            ?? $schedule->subject?->display_name
+            ?? $schedule->subject?->public_id
+            ?? 'Asset';
+
+        $eventTitle = $schedule->name . ' — ' . $assetName;
+
+        $dueDate = $schedule->next_due_date ?? Carbon::today();
+
+        $description = implode("\n", array_filter([
+            'Schedule: ' . $schedule->name,
+            'Asset: ' . $assetName,
+            'Type: ' . ucfirst(str_replace('_', ' ', $schedule->type ?? '')),
+            'Priority: ' . ucfirst($schedule->default_priority ?? 'normal'),
+            $schedule->instructions ? 'Instructions: ' . $schedule->instructions : null,
+        ]));
+
+        // Build the event, adding an RRULE when the schedule has a time-based interval.
+        $event = Event::create($eventTitle)
+            ->uniqueIdentifier($schedule->uuid . '@fleetbase.io')
+            ->description($description)
+            ->startsAt($dueDate->copy()->startOfDay())
+            ->endsAt($dueDate->copy()->endOfDay())
+            ->fullDay();
+
+        $intervalValue = (int) ($schedule->interval_value ?? 0);
+        $intervalUnit  = $schedule->interval_unit ?? null;
+
+        if ($intervalValue > 0 && $intervalUnit) {
+            $freqMap = [
+                'days'   => RecurrenceFrequency::daily(),
+                'weeks'  => RecurrenceFrequency::weekly(),
+                'months' => RecurrenceFrequency::monthly(),
+                'years'  => RecurrenceFrequency::yearly(),
+            ];
+            $freq = $freqMap[$intervalUnit] ?? null;
+            if ($freq !== null) {
+                $rrule = RRule::frequency($freq)->interval($intervalValue);
+                $event->rrule($rrule);
+            }
+        }
+
+        $calendar = Calendar::create($eventTitle)
+            ->productIdentifier('Fleetbase FleetOps')
+            ->event($event);
+
+        $filename = 'maintenance-' . $schedule->public_id . '.ics';
+
+        return response($calendar->get(), 200, [
+            'Content-Type'        => 'text/calendar; charset=utf-8',
+            'Content-Disposition' => 'attachment; filename="' . $filename . '"',
+        ]);
+    }
+
+    /**
+     * Map a priority string to a FullCalendar-compatible hex colour.
+     */
+    private function eventColorForPriority(?string $priority): string
+    {
+        return match ($priority) {
+            'critical'  => '#ef4444',
+            'high'      => '#f97316',
+            'normal'    => '#3b82f6',
+            'low'       => '#22c55e',
+            default     => '#6b7280',
+        };
+    }
+}

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

@@ -0,0 +1,138 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
+
+use Fleetbase\FleetOps\Models\Manifest;
+use Fleetbase\FleetOps\Models\ManifestStop;
+use Fleetbase\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+/**
+ * ManifestController.
+ *
+ * Provides CRUD and status-transition endpoints for Manifests and their stops.
+ *
+ * Endpoints:
+ *   GET    /int/v1/fleet-ops/manifests              — list manifests for company
+ *   GET    /int/v1/fleet-ops/manifests/{id}         — get a single manifest with stops
+ *   DELETE /int/v1/fleet-ops/manifests/{id}         — cancel/delete a manifest
+ *   POST   /int/v1/fleet-ops/manifests/{id}/cancel  — cancel a manifest
+ *   GET    /int/v1/fleet-ops/manifest-stops/{id}    — get a single stop
+ *   PATCH  /int/v1/fleet-ops/manifest-stops/{id}    — update a stop (status, sequence)
+ */
+class ManifestController extends Controller
+{
+    /**
+     * List manifests for the current company.
+     * Supports filtering by status, driver_id, vehicle_id, and scheduled_date.
+     *
+     * GET /int/v1/fleet-ops/manifests
+     */
+    public function index(Request $request): JsonResponse
+    {
+        $companyUuid = session('company');
+        $query       = Manifest::forCompany($companyUuid)
+            ->with(['driver', 'vehicle', 'stops.place', 'stops.order.trackingNumber']);
+
+        if ($request->filled('status')) {
+            $query->where('status', $request->input('status'));
+        }
+        if ($request->filled('driver_id')) {
+            $query->whereHas('driver', fn ($q) => $q->where('public_id', $request->input('driver_id')));
+        }
+        if ($request->filled('vehicle_id')) {
+            $query->whereHas('vehicle', fn ($q) => $q->where('public_id', $request->input('vehicle_id')));
+        }
+        if ($request->filled('scheduled_date')) {
+            $query->whereDate('scheduled_date', $request->input('scheduled_date'));
+        }
+
+        $manifests = $query->orderByDesc('created_at')->paginate($request->input('limit', 30));
+
+        return response()->json($manifests);
+    }
+
+    /**
+     * Get a single manifest with its full stop list.
+     *
+     * GET /int/v1/fleet-ops/manifests/{id}
+     */
+    public function show(string $id): JsonResponse
+    {
+        $manifest = Manifest::where('public_id', $id)
+            ->with(['driver', 'vehicle', 'stops' => fn ($q) => $q->orderBy('sequence')->with(['place', 'order.trackingNumber', 'order.payload.dropoff'])])
+            ->firstOrFail();
+
+        return response()->json(['manifest' => $manifest]);
+    }
+
+    /**
+     * Cancel a manifest (soft delete + status update).
+     *
+     * POST /int/v1/fleet-ops/manifests/{id}/cancel
+     */
+    public function cancel(string $id): JsonResponse
+    {
+        $manifest = Manifest::where('public_id', $id)->firstOrFail();
+        $manifest->cancel();
+
+        return response()->json(['status' => 'cancelled', 'manifest' => $manifest]);
+    }
+
+    /**
+     * Delete (soft-delete) a manifest.
+     *
+     * DELETE /int/v1/fleet-ops/manifests/{id}
+     */
+    public function destroy(string $id): JsonResponse
+    {
+        $manifest = Manifest::where('public_id', $id)->firstOrFail();
+        $manifest->delete();
+
+        return response()->json(['deleted' => true]);
+    }
+
+    /**
+     * Get a single manifest stop.
+     *
+     * GET /int/v1/fleet-ops/manifest-stops/{id}
+     */
+    public function showStop(string $id): JsonResponse
+    {
+        $stop = ManifestStop::where('public_id', $id)
+            ->with(['place', 'order.trackingNumber', 'order.payload.dropoff', 'waypoint'])
+            ->firstOrFail();
+
+        return response()->json(['stop' => $stop]);
+    }
+
+    /**
+     * Update a manifest stop (status, sequence, notes).
+     * Used by the dispatcher for manual reordering and by the Navigator app
+     * for arrived/completed/skipped status transitions.
+     *
+     * PATCH /int/v1/fleet-ops/manifest-stops/{id}
+     */
+    public function updateStop(Request $request, string $id): JsonResponse
+    {
+        $stop = ManifestStop::where('public_id', $id)->firstOrFail();
+
+        $allowed = ['status', 'sequence', 'actual_arrival', 'meta'];
+        $data    = $request->only($allowed);
+
+        // Handle status transitions via dedicated methods for side-effect logic
+        if (isset($data['status'])) {
+            match ($data['status']) {
+                'arrived'   => $stop->markArrived(),
+                'completed' => $stop->markCompleted(),
+                'skipped'   => $stop->markSkipped(),
+                default     => $stop->update($data),
+            };
+        } else {
+            $stop->update($data);
+        }
+
+        return response()->json(['stop' => $stop->fresh(['place', 'order.trackingNumber'])]);
+    }
+}