feat(rfid): add lookup endpoint to retrieve item info by code

Author: RLASH18

app/Http/Controllers/Api/RfidController.php

@@ -19,6 +19,26 @@ public function __construct(
         protected ItemService $itemService
     ) {}
 
+    /**
+     * Look up item info by item_code (read-only, no stock change).
+     */
+    public function lookup(string $code): JsonResponse
+    {
+        $item = $this->itemService->findByCode($code);
+
+        if (! $item) {
+            return response()->json([
+                'status' => 'error',
+                'message' => 'Item not found',
+            ], 404);
+        }
+
+        return response()->json([
+            'status' => 'success',
+            'data' => $item,
+        ], 200);
+    }
+
     /**
      * Handle RFID scan and adjust item quantity.
      */

app/Services/ItemService.php

@@ -221,6 +221,17 @@ protected function deleteImages(Item $item)
         }
     }
 
+    /**
+     * Find an item by its item_code
+     *
+     * @param string $itemCode
+     * @return Item|null
+     */
+    public function findByCode(string $itemCode): ?Item
+    {
+        return $this->itemRepo->findByCode($itemCode);
+    }
+
     /**
      * Adjust item quantity via RFID scan.
      * Use action 'add' to increase and 'deduct' to decrease.
@@ -232,7 +243,7 @@ protected function deleteImages(Item $item)
      */
     public function adjustQuantityByCode(string $itemCode, string $action, int $quantity): array
     {
-        $item = $this->itemRepo->findByCode($itemCode);
+        $item = $this->findByCode($itemCode);
 
         if (! $item) {
             return ['success' => false, 'message' => 'Item not found'];

routes/groups/rfid.php

@@ -8,7 +8,11 @@
     ->name('rfid.')
     ->group(function () {
 
-        // Scan item by item_code
+        // Look up item info by item_code (read-only, no stock change)
+        Route::get('/item/{code}', [RfidController::class, 'lookup'])
+            ->name('lookup');
+
+        // Scan item by item_code (adjusts stock)
         Route::post('/scan', [RfidController::class, 'scan'])
             ->name('scan');
     });