feat(scanner): return scan attempt result context

app/Domains/Ticket/Controllers/Scanner/TicketController.php

@@ -3,10 +3,13 @@
 namespace App\Domains\Ticket\Controllers\Scanner;
 
 use App\Domains\Auth\Models\User;
+use App\Domains\Ticket\Resources\Scanner\ScannerScanResultResource;
 use App\Domains\Ticket\Resources\TicketResource;
 use App\Domains\Ticket\Services\ScannerTicketService;
 use App\Http\Controllers\Controller;
+use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
 
 class TicketController extends Controller
 {
@@ -22,13 +25,13 @@ class TicketController extends Controller
         );
     }
 
-    public function scan(Request $request): TicketResource
+    public function scan(Request $request): JsonResponse
     {
         /** @var User $scanner */
         $scanner = $request->user();
 
-        return TicketResource::make(
+        return ScannerScanResultResource::make(
             $this->ticketService->scan($scanner, $request->input('data'))
-        );
+        )->response()->setStatusCode(Response::HTTP_OK);
     }
 }

app/Domains/Ticket/Resources/Scanner/ScanAttemptResource.php

@@ -16,8 +16,10 @@ class ScanAttemptResource extends JsonResource
         return [
             'id' => $this->id,
             'data' => $this->data,
+            'ticket_id' => $this->ticket_id,
             'ticket' => $this->ticket?->ticket,
             'attempted_at' => $this->created_at,
+            'resolved_at' => $this->resolved_at,
             'result' => $this->result->value,
             'can_view_ticket' => $this->ticket !== null
                 && $this->result !== ScanAttemptResult::CategoryForbidden,

app/Domains/Ticket/Resources/Scanner/ScannerScanResultResource.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Domains\Ticket\Resources\Scanner;
+
+use App\Domains\Ticket\Models\ScanAttempt;
+use App\Domains\Ticket\Resources\TicketResource;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+/** @mixin ScanAttempt */
+class ScannerScanResultResource extends JsonResource
+{
+    /** @return array<string, mixed> */
+    public function toArray(Request $request): array
+    {
+        $ticket = $this->ticket;
+        $client = $ticket?->user;
+
+        return [
+            'scan_attempt' => ScanAttemptResource::make($this->resource),
+            'ticket' => $ticket === null ? null : TicketResource::make($ticket),
+            'client' => $client === null ? null : [
+                'id' => $client->id,
+                'nombre_apellido' => $client->nombre_apellido,
+            ],
+        ];
+    }
+}

app/Domains/Ticket/Services/ScannerTicketService.php

@@ -98,7 +98,7 @@ class ScannerTicketService
         return $query->firstOrFail();
     }
 
-    public function scan(User $scanner, mixed $scannedData): Ticket
+    public function scan(User $scanner, mixed $scannedData): ScanAttempt
     {
         $scanAttempt = ScanAttempt::query()->create([
             'tenant_code' => $scanner->tenant_codigo,
@@ -125,7 +125,7 @@ class ScannerTicketService
                 $scanAttempt,
                 &$ticketId,
                 &$failureResult,
-            ): Ticket {
+            ): ScanAttempt {
                 $ticket = $this->baseQuery()
                     ->where('tenant_code', $scanner->tenant_codigo)
                     ->where('ticket', $scannedData)
@@ -172,7 +172,9 @@ class ScannerTicketService
                     $ticketId,
                 );
 
-                return $ticket->refresh()->load($this->relations());
+                $ticket = $ticket->refresh()->load($this->relations());
+
+                return $scanAttempt->refresh()->setRelation('ticket', $ticket);
             });
         } catch (Throwable $exception) {
             $result = $exception instanceof ModelNotFoundException