@fleetbase/fleetops-engine 0.6.55 → 0.6.57

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

@@ -0,0 +1,225 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Api\v1;
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\Concerns\ResolvesFleetOpsApiResources;
+use Fleetbase\FleetOps\Http\Requests\CreateDeviceRequest;
+use Fleetbase\FleetOps\Http\Requests\UpdateDeviceRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\DeletedResource;
+use Fleetbase\FleetOps\Http\Resources\v1\Device as DeviceResource;
+use Fleetbase\FleetOps\Models\Device;
+use Fleetbase\FleetOps\Models\Telematic;
+use Fleetbase\FleetOps\Models\Vehicle;
+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\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+
+class DeviceController extends Controller
+{
+    use ResolvesFleetOpsApiResources;
+
+    public function create(CreateDeviceRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $input                 = $this->input($request);
+        $input['company_uuid'] = session('company');
+
+        $device = Device::create($input)->load(['telematic', 'warranty', 'attachable', 'photo'])->loadCount('sensors');
+
+        return new DeviceResource($device);
+    }
+
+    public function update(string $id, UpdateDeviceRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        try {
+            $device = $this->resolveModel(Device::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Device resource not found.'], 404);
+        }
+
+        $device->update($this->input($request));
+
+        return new DeviceResource($device->refresh()->load(['telematic', 'warranty', 'attachable', 'photo'])->loadCount('sensors'));
+    }
+
+    public function query(Request $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $results = Device::queryWithRequest($request, function (&$query) {
+            $query->with(['telematic', 'warranty', 'attachable', 'photo'])->withCount('sensors');
+        });
+
+        return DeviceResource::collection($results);
+    }
+
+    public function find(string $id)
+    {
+        try {
+            $device = $this->resolveModel(Device::class, $id)->load(['telematic', 'warranty', 'attachable', 'photo']);
+            $device->loadCount('sensors');
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Device resource not found.'], 404);
+        }
+
+        return new DeviceResource($device);
+    }
+
+    public function delete(string $id)
+    {
+        try {
+            $device = $this->resolveModel(Device::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Device resource not found.'], 404);
+        }
+
+        $device->delete();
+
+        return new DeletedResource($device);
+    }
+
+    public function attach(Request $request, string $id): JsonResponse
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $request->validate([
+            'vehicle' => 'required_without:attachable|string|nullable',
+        ]);
+
+        $deviceId  = $id;
+        $vehicleId = $request->input('vehicle') ?? $request->input('attachable');
+
+        try {
+            $device  = $this->resolveModel(Device::class, $deviceId);
+            $vehicle = $this->resolveModel(Vehicle::class, $vehicleId);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            $this->logDeviceAttachmentLookupFailure('attach', $deviceId, $vehicleId);
+
+            return response()->json(['error' => 'Device or vehicle resource not found.'], 404);
+        }
+
+        try {
+            $device->attachTo($vehicle);
+            $device->load(['telematic', 'warranty', 'attachable', 'photo'])->loadCount('sensors');
+        } catch (\Throwable $e) {
+            $this->logDeviceAttachmentFailure('attach', $device, $vehicle, $e);
+
+            return response()->json(['error' => 'Unable to attach device to vehicle.'], 500);
+        }
+
+        return response()->json([
+            'status' => 'ok',
+            'device' => new DeviceResource($device),
+        ]);
+    }
+
+    public function detach(string $id): JsonResponse
+    {
+        try {
+            $device = $this->resolveModel(Device::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            $this->logDeviceAttachmentLookupFailure('detach', $id, null);
+
+            return response()->json(['error' => 'Device resource not found.'], 404);
+        }
+
+        try {
+            $device->detach();
+            $device->load(['telematic', 'warranty', 'attachable', 'photo'])->loadCount('sensors');
+        } catch (\Throwable $e) {
+            $this->logDeviceAttachmentFailure('detach', $device, null, $e);
+
+            return response()->json(['error' => 'Unable to detach device from vehicle.'], 500);
+        }
+
+        return response()->json([
+            'status' => 'ok',
+            'device' => new DeviceResource($device),
+        ]);
+    }
+
+    protected function input(Request $request): array
+    {
+        $input = $request->only([
+            'type',
+            'device_id',
+            'internal_id',
+            'imei',
+            'imsi',
+            'firmware_version',
+            'provider',
+            'name',
+            'model',
+            'location',
+            'manufacturer',
+            'serial_number',
+            'installation_date',
+            'last_maintenance_date',
+            'meta',
+            'data',
+            'options',
+            'online',
+            'status',
+            'data_frequency',
+            'notes',
+            'last_online_at',
+        ]);
+
+        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, '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('attachable')) {
+            if (blank($request->input('attachable'))) {
+                $input['attachable_type'] = null;
+                $input['attachable_uuid'] = null;
+            } else {
+                [$type, $uuid]            = $this->resolveMorph($request->input('attachable_type'), $request->input('attachable'));
+                $input['attachable_type'] = $type;
+                $input['attachable_uuid'] = $uuid;
+            }
+        }
+
+        return $input;
+    }
+
+    protected function logDeviceAttachmentLookupFailure(string $action, string $deviceId, ?string $vehicleId): void
+    {
+        Log::warning('Public API device attachment lookup failed', [
+            'action'       => $action,
+            'device_id'    => $deviceId,
+            'vehicle_id'   => $vehicleId,
+            'company_uuid' => session('company'),
+            'request_id'   => request()->headers->get('X-Request-ID') ?? request()->headers->get('X-Correlation-ID'),
+        ]);
+    }
+
+    protected function logDeviceAttachmentFailure(string $action, Device $device, ?Vehicle $vehicle, \Throwable $exception): void
+    {
+        Log::error('Public API device attachment failed', [
+            'action'          => $action,
+            'device_uuid'     => $device->uuid,
+            'device_id'       => $device->public_id,
+            'vehicle_uuid'    => $vehicle?->uuid,
+            'vehicle_id'      => $vehicle?->public_id,
+            'company_uuid'    => session('company'),
+            'request_id'      => request()->headers->get('X-Request-ID') ?? request()->headers->get('X-Correlation-ID'),
+            'exception_class' => get_class($exception),
+            'exception'       => $exception->getMessage(),
+        ]);
+    }
+}

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

@@ -0,0 +1,114 @@
+<?php
+
+namespace Fleetbase\FleetOps\Http\Controllers\Api\v1;
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\Concerns\ResolvesFleetOpsApiResources;
+use Fleetbase\FleetOps\Http\Requests\CreateEquipmentRequest;
+use Fleetbase\FleetOps\Http\Requests\UpdateEquipmentRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\DeletedResource;
+use Fleetbase\FleetOps\Http\Resources\v1\Equipment as EquipmentResource;
+use Fleetbase\FleetOps\Models\Equipment;
+use Fleetbase\FleetOps\Models\Warranty;
+use Fleetbase\Http\Controllers\Controller;
+use Fleetbase\Models\File;
+use Illuminate\Http\Request;
+
+class EquipmentController extends Controller
+{
+    use ResolvesFleetOpsApiResources;
+
+    public function create(CreateEquipmentRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $input                 = $this->input($request);
+        $input['company_uuid'] = session('company');
+
+        $equipment = Equipment::create($input)->load(['warranty', 'photo', 'equipable']);
+
+        return new EquipmentResource($equipment);
+    }
+
+    public function update(string $id, UpdateEquipmentRequest $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        try {
+            $equipment = $this->resolveModel(Equipment::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Equipment resource not found.'], 404);
+        }
+
+        $equipment->update($this->input($request));
+
+        return new EquipmentResource($equipment->refresh()->load(['warranty', 'photo', 'equipable']));
+    }
+
+    public function query(Request $request)
+    {
+        $this->rejectUuidIdentifiers($request);
+
+        $results = Equipment::queryWithRequest($request, function (&$query) {
+            $query->with(['warranty', 'photo', 'equipable']);
+        });
+
+        return EquipmentResource::collection($results);
+    }
+
+    public function find(string $id)
+    {
+        try {
+            $equipment = $this->resolveModel(Equipment::class, $id)->load(['warranty', 'photo', 'equipable']);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Equipment resource not found.'], 404);
+        }
+
+        return new EquipmentResource($equipment);
+    }
+
+    public function delete(string $id)
+    {
+        try {
+            $equipment = $this->resolveModel(Equipment::class, $id);
+        } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $exception) {
+            return response()->json(['error' => 'Equipment resource not found.'], 404);
+        }
+
+        $equipment->delete();
+
+        return new DeletedResource($equipment);
+    }
+
+    protected function input(Request $request): array
+    {
+        $input = $request->only([
+            'name',
+            'code',
+            'type',
+            'status',
+            'serial_number',
+            'manufacturer',
+            'model',
+            'purchased_at',
+            'purchase_price',
+            'currency',
+            'meta',
+        ]);
+
+        $this->applyPublicIdRelation($input, 'warranty', 'warranty_uuid', Warranty::class, $request);
+        $this->applyPublicIdRelation($input, 'photo', 'photo_uuid', File::class, $request);
+
+        if ($request->exists('equipable')) {
+            if (blank($request->input('equipable'))) {
+                $input['equipable_type'] = null;
+                $input['equipable_uuid'] = null;
+            } else {
+                [$type, $uuid]           = $this->resolveMorph($request->input('equipable_type'), $request->input('equipable'));
+                $input['equipable_type'] = $type;
+                $input['equipable_uuid'] = $uuid;
+            }
+        }
+
+        return $input;
+    }
+}

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;
+    }
+}