feat: Items API CRUD 기능 추가 (BP-MES Phase 1 Day 3-5)

- ItemsController 및 ItemsService CRUD 메서드 구현
- FormRequest 검증 클래스 추가 (ItemStoreRequest, ItemUpdateRequest)
- Swagger 문서 완성 (ItemsApi.php)
- 품목 생성/조회/수정/삭제 엔드포인트 추가
- i18n 메시지 키 추가 (message.item)
- Code 기반 라우팅 적용
- Hybrid 구조 지원 (고정 필드 + attributes JSON)

app/Http/Controllers/Api/V1/ItemsController.php

@@ -4,6 +4,8 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\Item\ItemStoreRequest;
+use App\Http\Requests\Item\ItemUpdateRequest;
 use App\Services\ItemsService;
 use Illuminate\Http\Request;
 
@@ -42,4 +44,56 @@ public function show(Request $request, int $id)
             return $this->service->getItem($itemType, $id, $includePrice, $clientId, $priceDate);
         }, __('message.fetched'));
     }
-}
+
+    /**
+     * 품목 상세 조회 (code 기반, BOM 포함 옵션)
+     *
+     * GET /api/v1/items/code/{code}?include_bom=true
+     */
+    public function showByCode(Request $request, string $code)
+    {
+        return ApiResponse::handle(function () use ($request, $code) {
+            $includeBom = filter_var($request->input('include_bom', false), FILTER_VALIDATE_BOOLEAN);
+
+            return $this->service->getItemByCode($code, $includeBom);
+        }, __('message.item.fetched'));
+    }
+
+    /**
+     * 품목 생성
+     *
+     * POST /api/v1/items
+     */
+    public function store(ItemStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->createItem($request->validated());
+        }, __('message.item.created'));
+    }
+
+    /**
+     * 품목 수정
+     *
+     * PUT /api/v1/items/{code}
+     */
+    public function update(string $code, ItemUpdateRequest $request)
+    {
+        return ApiResponse::handle(function () use ($code, $request) {
+            return $this->service->updateItem($code, $request->validated());
+        }, __('message.item.updated'));
+    }
+
+    /**
+     * 품목 삭제 (Soft Delete)
+     *
+     * DELETE /api/v1/items/{code}
+     */
+    public function destroy(string $code)
+    {
+        return ApiResponse::handle(function () use ($code) {
+            $this->service->deleteItem($code);
+
+            return 'success';
+        }, __('message.item.deleted'));
+    }
+}