Implement household, QR sale, team helpers assignment, and helper endpoints

app/Http/Controllers/Api/V1/Scanner/ScannerController.php

@@ -15,6 +15,33 @@ class ScannerController extends ApiController
 {
     public function __construct(private readonly ScanService $scanner) {}
 
+    public function teamDetails(Request $request): JsonResponse
+    {
+        $user = $request->user();
+
+        $team = \App\Models\CollectionTeam::query()
+            ->with(['driver', 'truck', 'helpers.user'])
+            ->where('scanner_id', $user->id)
+            ->where('status', \App\Models\CollectionTeam::STATUS_ACTIVE)
+            ->first();
+
+        if (! $team) {
+            return $this->fail('No active collection team assigned to this scanner', null, 404);
+        }
+
+        $trip = \App\Models\Trip::query()
+            ->with(['route.stops.dropOffPoint', 'stops.dropOffPoint'])
+            ->where('team_id', $team->id)
+            ->whereIn('status', [\App\Models\Trip::STATUS_SCHEDULED, \App\Models\Trip::STATUS_IN_PROGRESS, \App\Models\Trip::STATUS_AT_DUMPSITE])
+            ->orderBy('scheduled_date')
+            ->first();
+
+        return $this->ok([
+            'team' => \App\Http\Resources\CollectionTeamResource::make($team),
+            'active_trip' => $trip ? \App\Http\Resources\TripResource::make($trip) : null,
+        ]);
+    }
+
     public function scan(Request $request): JsonResponse
     {
         $data = $request->validate([