@fleetbase/fleetops-engine 0.6.55 → 0.6.56

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

@@ -0,0 +1,132 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Api\v1;
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\Concerns\ResolvesFleetOpsApiResources;
+use Fleetbase\FleetOps\Http\Requests\CreateSensorRequest;
+use Fleetbase\FleetOps\Http\Requests\UpdateSensorRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\DeletedResource;
+use Fleetbase\FleetOps\Http\Resources\v1\Sensor as SensorResource;
+use Fleetbase\FleetOps\Models\Device;
+use Fleetbase\FleetOps\Models\Sensor;
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Models\Warranty;
+use Fleetbase\FleetOps\Support\Utils;
+use Fleetbase\Http\Controllers\Controller;
+use Fleetbase\LaravelMysqlSpatial\Types\Point;
+use Fleetbase\Models\File;
+use Illuminate\Http\Request;
+
+class SensorController extends Controller
+{
+    use ResolvesFleetOpsApiResources;
+
+    public function create(CreateSensorRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $input                 = $this->input($request);
+        $input['company_uuid'] = session('company');
+
+        $sensor = Sensor::create($input)->load(['telematic', 'device', 'warranty', 'photo', 'sensorable']);
+
+        return new SensorResource($sensor);
+    }
+
+    public function update(string $id, UpdateSensorRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        try {
+            $sensor = $this->resolveModel(Sensor::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Sensor resource not found.'], 404);
+        }
+
+        $sensor->update($this->input($request));
+
+        return new SensorResource($sensor->refresh()->load(['telematic', 'device', 'warranty', 'photo', 'sensorable']));
+    }
+
+    public function query(Request $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $results = Sensor::queryWithRequest($request, function (&$query) {
+            $query->with(['telematic', 'device', 'warranty', 'photo', 'sensorable']);
+        });
+
+        return SensorResource::collection($results);
+    }
+
+    public function find(string $id)
+    {
+        try {
+            $sensor = $this->resolveModel(Sensor::class, $id)->load(['telematic', 'device', 'warranty', 'photo', 'sensorable']);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Sensor resource not found.'], 404);
+        }
+
+        return new SensorResource($sensor);
+    }
+
+    public function delete(string $id)
+    {
+        try {
+            $sensor = $this->resolveModel(Sensor::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Sensor resource not found.'], 404);
+        }
+
+        $sensor->delete();
+
+        return new DeletedResource($sensor);
+    }
+
+    protected function input(Request $request): array
+    {
+        $input = $request->only([
+            'name',
+            'type',
+            'internal_id',
+            'imei',
+            'imsi',
+            'firmware_version',
+            'serial_number',
+            'unit',
+            'min_threshold',
+            'max_threshold',
+            'threshold_inclusive',
+            'last_reading_at',
+            'last_value',
+            'calibration',
+            'report_frequency_sec',
+            'status',
+            'meta',
+        ]);
+
+        if ($request->filled(['latitude', 'longitude'])) {
+            $input['last_position'] = new Point($request->input('latitude'), $request->input('longitude'));
+        } elseif ($request->filled('last_position')) {
+            $input['last_position'] = Utils::getPointFromCoordinates($request->input('last_position'));
+        }
+
+        $this->applyPublicIdRelation($input, 'device', 'device_uuid', Device::class, $request);
+        $this->applyPublicIdRelation($input, 'telematic', 'telematic_uuid', Telematic::class, $request);
+        $this->applyPublicIdRelation($input, 'warranty', 'warranty_uuid', Warranty::class, $request);
+        $this->applyPublicIdRelation($input, 'photo', 'photo_uuid', File::class, $request);
+
+        if ($request->exists('sensorable')) {
+            if (blank($request->input('sensorable'))) {
+                $input['sensorable_type'] = null;
+                $input['sensorable_uuid'] = null;
+            } else {
+                [$type, $uuid]            = $this->resolveMorph($request->input('sensorable_type'), $request->input('sensorable'));
+                $input['sensorable_type'] = $type;
+                $input['sensorable_uuid'] = $uuid;
+            }
+        }
+
+        return $input;
+    }
+}

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

@@ -0,0 +1,161 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Api\v1;
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\Concerns\ResolvesFleetOpsApiResources;
+use Fleetbase\FleetOps\Http\Requests\CreateWorkOrderRequest;
+use Fleetbase\FleetOps\Http\Requests\UpdateWorkOrderRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\DeletedResource;
+use Fleetbase\FleetOps\Http\Resources\v1\WorkOrder as WorkOrderResource;
+use Fleetbase\FleetOps\Mail\WorkOrderDispatched;
+use Fleetbase\FleetOps\Models\WorkOrder;
+use Fleetbase\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Mail;
+
+class WorkOrderController extends Controller
+{
+    use ResolvesFleetOpsApiResources;
+
+    public function create(CreateWorkOrderRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $input                 = $this->input($request);
+        $input['company_uuid'] = session('company');
+
+        $workOrder = WorkOrder::create($input)->load(['target', 'assignee']);
+
+        return new WorkOrderResource($workOrder);
+    }
+
+    public function update(string $id, UpdateWorkOrderRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        try {
+            $workOrder = $this->resolveModel(WorkOrder::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'WorkOrder resource not found.'], 404);
+        }
+
+        $workOrder->update($this->input($request));
+
+        return new WorkOrderResource($workOrder->refresh()->load(['target', 'assignee']));
+    }
+
+    public function query(Request $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $results = WorkOrder::queryWithRequest($request, function (&$query) {
+            $query->with(['target', 'assignee']);
+        });
+
+        return WorkOrderResource::collection($results);
+    }
+
+    public function find(string $id)
+    {
+        try {
+            $workOrder = $this->resolveModel(WorkOrder::class, $id)->load(['target', 'assignee']);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'WorkOrder resource not found.'], 404);
+        }
+
+        return new WorkOrderResource($workOrder);
+    }
+
+    public function delete(string $id)
+    {
+        try {
+            $workOrder = $this->resolveModel(WorkOrder::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'WorkOrder resource not found.'], 404);
+        }
+
+        $workOrder->delete();
+
+        return new DeletedResource($workOrder);
+    }
+
+    public function send(string $id): JsonResponse
+    {
+        try {
+            $workOrder = $this->resolveModel(WorkOrder::class, $id)->load(['target', 'assignee']);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'WorkOrder resource not found.'], 404);
+        }
+
+        $assignee = $workOrder->assignee;
+        if (!$assignee) {
+            return response()->json(['error' => 'This work order has no assigned vendor.'], 422);
+        }
+
+        $email = $assignee->email ?? null;
+        if (!$email) {
+            return response()->json(['error' => 'The assigned vendor has no email address on file.'], 422);
+        }
+
+        Mail::to($email)->send(new WorkOrderDispatched($workOrder));
+
+        activity('work_order_sent')
+            ->performedOn($workOrder)
+            ->withProperties(['sent_to' => $email])
+            ->log('Work order emailed to vendor');
+
+        return response()->json([
+            'status'  => 'ok',
+            'message' => 'Work order successfully sent to ' . $email,
+        ]);
+    }
+
+    protected function input(Request $request): array
+    {
+        $input = $request->only([
+            'code',
+            'subject',
+            'category',
+            'status',
+            'priority',
+            'opened_at',
+            'due_at',
+            'closed_at',
+            'instructions',
+            'checklist',
+            'estimated_cost',
+            'approved_budget',
+            'actual_cost',
+            'currency',
+            'cost_breakdown',
+            'cost_center',
+            'budget_code',
+            'meta',
+        ]);
+
+        if ($request->exists('target')) {
+            if (blank($request->input('target'))) {
+                $input['target_type'] = null;
+                $input['target_uuid'] = null;
+            } else {
+                [$type, $uuid]        = $this->resolveMorph($request->input('target_type'), $request->input('target'));
+                $input['target_type'] = $type;
+                $input['target_uuid'] = $uuid;
+            }
+        }
+
+        if ($request->exists('assignee')) {
+            if (blank($request->input('assignee'))) {
+                $input['assignee_type'] = null;
+                $input['assignee_uuid'] = null;
+            } else {
+                [$type, $uuid]          = $this->resolveMorph($request->input('assignee_type'), $request->input('assignee'));
+                $input['assignee_type'] = $type;
+                $input['assignee_uuid'] = $uuid;
+            }
+        }
+
+        return $input;
+    }
+}

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

@@ -2,13 +2,17 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\DeviceExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Models\Device;
 use Fleetbase\FleetOps\Models\Vehicle;
 use Fleetbase\FleetOps\Support\Utils;
+use Fleetbase\Http\Requests\ExportRequest;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Str;
+use Maatwebsite\Excel\Facades\Excel;
 
 class DeviceController extends FleetOpsController
 {
@@ -19,6 +23,20 @@ class DeviceController extends FleetOpsController
      */
     public $resource = 'device';
 
+    /**
+     * Export devices to excel or csv.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('devices-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new DeviceExport($selections), $fileName);
+    }
+
     /**
      * Query callback when querying record.
      *

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

@@ -2,9 +2,12 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\EquipmentExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Imports\EquipmentImport;
+use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
+use Illuminate\Support\Str;
 use Maatwebsite\Excel\Facades\Excel;
 
 class EquipmentController extends FleetOpsController
@@ -16,6 +19,20 @@ class EquipmentController extends FleetOpsController
      */
     public $resource = 'equipment';
 
+    /**
+     * Export equipment to excel or csv.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('equipment-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new EquipmentExport($selections), $fileName);
+    }
+
     /**
      * Process import files (excel, csv) into Equipment records.
      *

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

@@ -2,12 +2,15 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\MaintenanceExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Imports\MaintenanceImport;
 use Fleetbase\FleetOps\Models\Maintenance;
+use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Support\Str;
 use Maatwebsite\Excel\Facades\Excel;
 
 class MaintenanceController extends FleetOpsController
@@ -19,6 +22,20 @@ class MaintenanceController extends FleetOpsController
      */
     public $resource = 'maintenance';
 
+    /**
+     * Export maintenances to excel or csv.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('maintenances-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new MaintenanceExport($selections), $fileName);
+    }
+
     /**
      * Eager-load polymorphic relationships after create so they appear in the API response.
      * Called automatically by HasApiControllerBehavior::createRecord() via getControllerCallback.

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

@@ -2,15 +2,18 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\MaintenanceScheduleExport;
 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\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Http\Response;
 use Illuminate\Support\Carbon;
+use Illuminate\Support\Str;
 use Maatwebsite\Excel\Facades\Excel;
 use Spatie\IcalendarGenerator\Components\Calendar;
 use Spatie\IcalendarGenerator\Components\Event;
@@ -26,6 +29,20 @@ class MaintenanceScheduleController extends FleetOpsController
      */
     public $resource = 'maintenance-schedule';
 
+    /**
+     * Export maintenance schedules to excel or csv.
+     *
+     * @return Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('maintenance-schedules-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new MaintenanceScheduleExport($selections), $fileName);
+    }
+
     /**
      * Process import files (excel, csv) into MaintenanceSchedule records.
      *

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

@@ -2,9 +2,12 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\PartExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Imports\PartImport;
+use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
+use Illuminate\Support\Str;
 use Maatwebsite\Excel\Facades\Excel;
 
 class PartController extends FleetOpsController
@@ -16,6 +19,20 @@ class PartController extends FleetOpsController
      */
     public $resource = 'part';
 
+    /**
+     * Export parts to excel or csv.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('parts-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new PartExport($selections), $fileName);
+    }
+
     /**
      * Process import files (excel, csv) into Part records.
      *

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

@@ -2,7 +2,11 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\SensorExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
+use Fleetbase\Http\Requests\ExportRequest;
+use Illuminate\Support\Str;
+use Maatwebsite\Excel\Facades\Excel;
 
 class SensorController extends FleetOpsController
 {
@@ -13,6 +17,20 @@ class SensorController extends FleetOpsController
      */
     public $resource = 'sensor';
 
+    /**
+     * Export sensors to excel or csv.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('sensors-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new SensorExport($selections), $fileName);
+    }
+
     /**
      * Query callback when querying record.
      *

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

@@ -327,12 +327,16 @@ class SettingController extends Controller
     public function getMapSettings()
     {
         $defaults = [
-            'mapProvider' => 'leaflet',
+            'mapProvider'                 => 'leaflet',
+            'googleMapsMapType'           => 'roadmap',
+            'showGoogleMapsTrafficLayer'  => false,
+            'showGoogleMapsTransitLayer'  => false,
         ];
 
         $systemMapSettings          = Setting::lookup('fleet-ops.map-settings', []);
         $mapSettings                = Setting::lookupFromCompany('fleet-ops.map-settings', $defaults);
         $mapSettings['mapProvider'] = data_get($mapSettings, 'mapProvider') ?: data_get($systemMapSettings, 'mapProvider', 'leaflet');
+        $mapSettings                = $this->normalizeCompanyMapSettings($mapSettings);
 
         // Source the Google Maps API key from the system-level services config
         // that is managed by the core-api admin settings panel. This ensures a
@@ -362,10 +366,7 @@ class SettingController extends Controller
         unset($settings['googleMapsApiKey']);
 
         // Validate provider value
-        $allowedProviders = ['leaflet', 'google'];
-        if (isset($settings['mapProvider']) && !in_array($settings['mapProvider'], $allowedProviders)) {
-            $settings['mapProvider'] = 'leaflet';
-        }
+        $settings = $this->normalizeCompanyMapSettings($settings);
 
         Setting::configureCompany('fleet-ops.map-settings', $settings);
 
@@ -400,6 +401,29 @@ class SettingController extends Controller
         return response()->json($this->getAdminMapSettings()->getData(true));
     }
 
+    protected function normalizeCompanyMapSettings(array $settings): array
+    {
+        $allowedProviders = ['leaflet', 'google'];
+        $mapProvider      = data_get($settings, 'mapProvider', 'leaflet');
+        if (!in_array($mapProvider, $allowedProviders)) {
+            $mapProvider = 'leaflet';
+        }
+
+        $allowedGoogleMapTypes = ['roadmap', 'satellite', 'hybrid', 'terrain'];
+        $googleMapsMapType     = data_get($settings, 'googleMapsMapType', 'roadmap');
+        if (!in_array($googleMapsMapType, $allowedGoogleMapTypes)) {
+            $googleMapsMapType = 'roadmap';
+        }
+
+        return [
+            ...$settings,
+            'mapProvider'                => $mapProvider,
+            'googleMapsMapType'          => $googleMapsMapType,
+            'showGoogleMapsTrafficLayer' => filter_var(data_get($settings, 'showGoogleMapsTrafficLayer', false), FILTER_VALIDATE_BOOLEAN),
+            'showGoogleMapsTransitLayer' => filter_var(data_get($settings, 'showGoogleMapsTransitLayer', false), FILTER_VALIDATE_BOOLEAN),
+        ];
+    }
+
     /**
      * Retrieve driver scheduling settings for the current company.
      *

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

@@ -2,13 +2,17 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\TelematicExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Models\Telematic;
 use Fleetbase\FleetOps\Support\Telematics\TelematicProviderRegistry;
 use Fleetbase\FleetOps\Support\Telematics\TelematicService;
+use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Models\Activity;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+use Maatwebsite\Excel\Facades\Excel;
 
 class TelematicController extends FleetOpsController
 {
@@ -29,6 +33,20 @@ class TelematicController extends FleetOpsController
         $this->registry          = $registry;
     }
 
+    /**
+     * Export telematics to excel or csv.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('telematics-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new TelematicExport($selections), $fileName);
+    }
+
     /**
      * Query callback when querying record.
      *

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

@@ -2,13 +2,16 @@
 
 namespace Fleetbase\FleetOps\Http\Controllers\Internal\v1;
 
+use Fleetbase\FleetOps\Exports\WorkOrderExport;
 use Fleetbase\FleetOps\Http\Controllers\FleetOpsController;
 use Fleetbase\FleetOps\Imports\WorkOrderImport;
 use Fleetbase\FleetOps\Mail\WorkOrderDispatched;
 use Fleetbase\FleetOps\Models\WorkOrder;
+use Fleetbase\Http\Requests\ExportRequest;
 use Fleetbase\Http\Requests\ImportRequest;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Support\Facades\Mail;
+use Illuminate\Support\Str;
 use Maatwebsite\Excel\Facades\Excel;
 
 class WorkOrderController extends FleetOpsController
@@ -20,6 +23,20 @@ class WorkOrderController extends FleetOpsController
      */
     public $resource = 'work-order';
 
+    /**
+     * Export work orders to excel or csv.
+     *
+     * @return \Illuminate\Http\Response
+     */
+    public function export(ExportRequest $request)
+    {
+        $format     = $request->input('format', 'xlsx');
+        $selections = $request->array('selections');
+        $fileName   = trim(Str::slug('work-orders-' . date('Y-m-d-H:i')) . '.' . $format);
+
+        return Excel::download(new WorkOrderExport($selections), $fileName);
+    }
+
     /**
      * Process import files (excel, csv) into WorkOrder records.
      *