feat: Items API에 group_id 파라미터 지원 추가

- common_codes에 item_group 추가 및 item_type parent_id 연결
- /api/v1/items?type=RM → 단일 품목 유형 조회
- /api/v1/items?group_id=103 → 그룹 전체 품목 조회 (FG,PT,SM,RM,CS)
- ItemService에 getItemTypesByGroupId(), newQueryForTypes() 메서드 추가
- 에러 메시지 추가 (item_type_or_group_required, invalid_group_id)

app/Services/ItemService.php

@@ -79,6 +79,32 @@ private function newQuery(string $itemType)
             ->where('item_type', strtoupper($itemType));
     }
 
+    /**
+     * group_id로 해당 그룹의 item_type 목록 조회
+     *
+     * @param  int  $groupId  common_codes의 item_group id
+     * @return array item_type 코드 배열 ['FG', 'PT', 'SM', 'RM', 'CS']
+     */
+    private function getItemTypesByGroupId(int $groupId): array
+    {
+        return \DB::table('common_codes')
+            ->where('code_group', 'item_type')
+            ->where('parent_id', $groupId)
+            ->where('is_active', true)
+            ->pluck('code')
+            ->toArray();
+    }
+
+    /**
+     * 여러 item_type으로 Query Builder 생성
+     */
+    private function newQueryForTypes(array $itemTypes)
+    {
+        return \App\Models\Items\Item::query()
+            ->where('tenant_id', $this->tenantId())
+            ->whereIn('item_type', array_map('strtoupper', $itemTypes));
+    }
+
     /**
      * items 테이블의 고정 컬럼 목록 조회 (SystemFields + ItemField 기반)
      */
@@ -252,7 +278,7 @@ protected function fetchCategoryTree(?int $parentId = null)
     /**
      * 목록/검색 (동적 테이블 라우팅)
      *
-     * @param  array  $params  검색 파라미터 (item_type 필수)
+     * @param  array  $params  검색 파라미터 (item_type 또는 group_id 필수)
      */
     public function index(array $params): LengthAwarePaginator
     {
@@ -260,16 +286,27 @@ public function index(array $params): LengthAwarePaginator
         $q = trim((string) ($params['q'] ?? $params['search'] ?? ''));
         $categoryId = $params['category_id'] ?? null;
         $itemType = $params['item_type'] ?? null;
+        $groupId = $params['group_id'] ?? null;
         $active = $params['active'] ?? null;
 
-        // item_type 필수 검증
-        if (! $itemType) {
-            throw new BadRequestHttpException(__('error.item_type_required'));
+        // item_type 또는 group_id 필수 검증
+        if (! $itemType && ! $groupId) {
+            throw new BadRequestHttpException(__('error.item_type_or_group_required'));
         }
 
-        // 동적 테이블 라우팅
-        $query = $this->newQuery($itemType)
-            ->with(['category:id,name', 'details']);
+        // group_id로 조회 시 해당 그룹의 모든 item_type 조회
+        if ($groupId && ! $itemType) {
+            $itemTypes = $this->getItemTypesByGroupId((int) $groupId);
+            if (empty($itemTypes)) {
+                throw new BadRequestHttpException(__('error.invalid_group_id'));
+            }
+            $query = $this->newQueryForTypes($itemTypes)
+                ->with(['category:id,name', 'details']);
+        } else {
+            // 단일 item_type 조회
+            $query = $this->newQuery($itemType)
+                ->with(['category:id,name', 'details']);
+        }
 
         // 검색어
         if ($q !== '') {