@fleetbase/fleetops-engine 0.6.54 → 0.6.56

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

@@ -0,0 +1,185 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Api\v1;
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\Concerns\ResolvesFleetOpsApiResources;
+use Fleetbase\FleetOps\Http\Requests\CreateFuelTransactionRequest;
+use Fleetbase\FleetOps\Http\Requests\UpdateFuelTransactionRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\DeletedResource;
+use Fleetbase\FleetOps\Http\Resources\v1\FuelTransaction as FuelTransactionResource;
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\FuelProviderConnection;
+use Fleetbase\FleetOps\Models\FuelProviderTransaction;
+use Fleetbase\FleetOps\Models\FuelReport;
+use Fleetbase\FleetOps\Models\Order;
+use Fleetbase\FleetOps\Models\Vehicle;
+use Fleetbase\FleetOps\Support\FuelProviders\FuelProviderService;
+use Fleetbase\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class FuelTransactionController extends Controller
+{
+    use ResolvesFleetOpsApiResources;
+
+    public function __construct(protected FuelProviderService $fuelProviderService)
+    {
+    }
+
+    public function create(CreateFuelTransactionRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $input                 = $this->input($request);
+        $input['company_uuid'] = session('company');
+
+        $transaction = FuelProviderTransaction::create($input)->load(['connection', 'vehicle', 'driver', 'order', 'fuelReport']);
+
+        return new FuelTransactionResource($transaction);
+    }
+
+    public function update(string $id, UpdateFuelTransactionRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        try {
+            $transaction = $this->findTransaction($id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'FuelTransaction resource not found.'], 404);
+        }
+
+        $transaction->update($this->input($request));
+
+        return new FuelTransactionResource($transaction->refresh()->load(['connection', 'vehicle', 'driver', 'order', 'fuelReport']));
+    }
+
+    public function query(Request $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $results = FuelProviderTransaction::queryWithRequest($request, function (&$query) {
+            $query->with(['connection', 'vehicle', 'driver', 'order', 'fuelReport']);
+        });
+
+        return FuelTransactionResource::collection($results);
+    }
+
+    public function find(string $id)
+    {
+        try {
+            $transaction = $this->findTransaction($id)->load(['connection', 'vehicle', 'driver', 'order', 'fuelReport']);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'FuelTransaction resource not found.'], 404);
+        }
+
+        return new FuelTransactionResource($transaction);
+    }
+
+    public function delete(string $id)
+    {
+        try {
+            $transaction = $this->findTransaction($id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'FuelTransaction resource not found.'], 404);
+        }
+
+        $transaction->delete();
+
+        return new DeletedResource($transaction);
+    }
+
+    public function matchVehicle(Request $request, string $id): JsonResponse
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $request->validate(['vehicle' => 'required|string']);
+        $transaction = $this->findTransaction($id);
+        $vehicle     = $this->resolveModel(Vehicle::class, $request->input('vehicle'));
+
+        return response()->json([
+            'status'      => 'ok',
+            'transaction' => new FuelTransactionResource($this->fuelProviderService->matchVehicle($transaction, $vehicle)),
+        ]);
+    }
+
+    public function matchOrder(Request $request, string $id): JsonResponse
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $request->validate(['order' => 'required|string']);
+        $transaction = $this->findTransaction($id);
+        $order       = $this->resolveModel(Order::class, $request->input('order'));
+
+        return response()->json([
+            'status'      => 'ok',
+            'transaction' => new FuelTransactionResource($this->fuelProviderService->matchOrder($transaction, $order)),
+        ]);
+    }
+
+    public function reprocess(string $id): JsonResponse
+    {
+        $transaction = $this->findTransaction($id);
+
+        return response()->json([
+            'status'      => 'ok',
+            'transaction' => new FuelTransactionResource($this->fuelProviderService->reprocessTransaction($transaction)),
+        ]);
+    }
+
+    public function review(Request $request, string $id): JsonResponse
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $request->validate(['status' => 'required|string|in:reviewed,ignored']);
+        $transaction = $this->findTransaction($id);
+
+        return response()->json([
+            'status'      => 'ok',
+            'transaction' => new FuelTransactionResource($this->fuelProviderService->reviewTransaction($transaction, $request->input('status'))),
+        ]);
+    }
+
+    protected function findTransaction(string $id): FuelProviderTransaction
+    {
+        return $this->resolveModel(FuelProviderTransaction::class, $id);
+    }
+
+    protected function input(Request $request): array
+    {
+        $input = $request->only([
+            'provider',
+            'provider_transaction_id',
+            'provider_vehicle_id',
+            'vehicle_card_id',
+            'internal_number',
+            'structure_number',
+            'plate_number',
+            'vin',
+            'serial_number',
+            'call_sign',
+            'trip_number',
+            'station_name',
+            'station_latitude',
+            'station_longitude',
+            'transaction_at',
+            'volume',
+            'metric_unit',
+            'amount',
+            'currency',
+            'odometer',
+            'sync_status',
+            'matched_at',
+            'normalized_payload',
+            'raw_payload',
+            'meta',
+        ]);
+
+        $this->applyPublicIdRelation($input, 'connection', 'fuel_provider_connection_uuid', FuelProviderConnection::class, $request);
+        $this->applyPublicIdRelation($input, 'fuel_report', 'fuel_report_uuid', FuelReport::class, $request);
+        $this->applyPublicIdRelation($input, 'vehicle', 'vehicle_uuid', Vehicle::class, $request);
+        $this->applyPublicIdRelation($input, 'driver', 'driver_uuid', Driver::class, $request);
+        $this->applyPublicIdRelation($input, 'order', 'order_uuid', Order::class, $request);
+
+        return $input;
+    }
+}

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

@@ -0,0 +1,120 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Api\v1;
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\Concerns\ResolvesFleetOpsApiResources;
+use Fleetbase\FleetOps\Http\Requests\CreatePartRequest;
+use Fleetbase\FleetOps\Http\Requests\UpdatePartRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\DeletedResource;
+use Fleetbase\FleetOps\Http\Resources\v1\Part as PartResource;
+use Fleetbase\FleetOps\Models\Part;
+use Fleetbase\FleetOps\Models\Vendor;
+use Fleetbase\FleetOps\Models\Warranty;
+use Fleetbase\Http\Controllers\Controller;
+use Fleetbase\Models\File;
+use Illuminate\Http\Request;
+
+class PartController extends Controller
+{
+    use ResolvesFleetOpsApiResources;
+
+    public function create(CreatePartRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $input                 = $this->input($request);
+        $input['company_uuid'] = session('company');
+
+        $part = Part::create($input)->load(['vendor', 'warranty', 'photo', 'asset']);
+
+        return new PartResource($part);
+    }
+
+    public function update(string $id, UpdatePartRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        try {
+            $part = $this->resolveModel(Part::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Part resource not found.'], 404);
+        }
+
+        $part->update($this->input($request));
+
+        return new PartResource($part->refresh()->load(['vendor', 'warranty', 'photo', 'asset']));
+    }
+
+    public function query(Request $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $results = Part::queryWithRequest($request, function (&$query) {
+            $query->with(['vendor', 'warranty', 'photo', 'asset']);
+        });
+
+        return PartResource::collection($results);
+    }
+
+    public function find(string $id)
+    {
+        try {
+            $part = $this->resolveModel(Part::class, $id)->load(['vendor', 'warranty', 'photo', 'asset']);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Part resource not found.'], 404);
+        }
+
+        return new PartResource($part);
+    }
+
+    public function delete(string $id)
+    {
+        try {
+            $part = $this->resolveModel(Part::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Part resource not found.'], 404);
+        }
+
+        $part->delete();
+
+        return new DeletedResource($part);
+    }
+
+    protected function input(Request $request): array
+    {
+        $input = $request->only([
+            'sku',
+            'name',
+            'manufacturer',
+            'model',
+            'serial_number',
+            'barcode',
+            'description',
+            'quantity_on_hand',
+            'unit_cost',
+            'msrp',
+            'currency',
+            'type',
+            'status',
+            'specs',
+            'meta',
+        ]);
+
+        $this->applyPublicIdRelation($input, 'vendor', 'vendor_uuid', Vendor::class, $request);
+        $this->applyPublicIdRelation($input, 'warranty', 'warranty_uuid', Warranty::class, $request);
+        $this->applyPublicIdRelation($input, 'photo', 'photo_uuid', File::class, $request);
+
+        if ($request->exists('asset')) {
+            if (blank($request->input('asset'))) {
+                $input['asset_type'] = null;
+                $input['asset_uuid'] = null;
+            } else {
+                [$type, $uuid]       = $this->resolveMorph($request->input('asset_type'), $request->input('asset'));
+                $input['asset_type'] = $type;
+                $input['asset_uuid'] = $uuid;
+            }
+        }
+
+        return $input;
+    }
+}

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.
      *
@@ -28,6 +46,7 @@ class DeviceController extends FleetOpsController
     public static function onQueryRecord($query, $request): void
     {
         $query->with(['telematic', 'warranty', 'attachable']);
+        $query->withCount('sensors');
 
         if ($request->filled('attachment_state')) {
             match ($request->input('attachment_state')) {
@@ -38,13 +57,17 @@ class DeviceController extends FleetOpsController
         }
 
         if ($request->filled('vehicle')) {
-            $query->where('attachable_uuid', $request->input('vehicle'));
+            static::applyVehicleFilter($query, $request->input('vehicle'));
         }
 
         if ($request->filled('device_id')) {
             $query->where('device_id', 'like', '%' . $request->input('device_id') . '%');
         }
 
+        if ($request->filled('serial_number')) {
+            $query->where('serial_number', 'like', '%' . $request->input('serial_number') . '%');
+        }
+
         if ($request->filled('connection_status')) {
             $statuses = Utils::arrayFrom($request->input('connection_status'));
 
@@ -80,6 +103,7 @@ class DeviceController extends FleetOpsController
     public static function onFindRecord($query, $request): void
     {
         $query->with(['telematic', 'warranty', 'attachable']);
+        $query->withCount('sensors');
     }
 
     /**
@@ -183,6 +207,17 @@ class DeviceController extends FleetOpsController
         }
     }
 
+    protected static function applyVehicleFilter($query, string $vehicle): void
+    {
+        $query->where(function ($vehicleQuery) use ($vehicle) {
+            $vehicleQuery->where('attachable_uuid', $vehicle)
+                ->orWhereIn('attachable_uuid', Vehicle::query()
+                    ->where('company_uuid', session('company'))
+                    ->where('public_id', $vehicle)
+                    ->pluck('uuid'));
+        });
+    }
+
     protected function logDeviceAttachmentLookupFailure(string $action, string $missingResource, string $deviceId, ?string $vehicleId): void
     {
         Log::warning('Device attachment lookup failed', [