feat: [품질검사] 수주 선택 필터링 + 개소 상세 + 검사 상태 개선

- availableOrders: client_id/item_id 필터 파라미터 지원
- availableOrders: 응답에 client_id, client_name, item_id, item_name, locations(개소 상세) 추가
- show: 개소별 데이터에 거래처/모델 정보 포함
- DocumentService: fqcStatus rootNodes 기반으로 변경

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/Services/DocumentService.php

@@ -663,20 +663,32 @@ public function fqcStatus(int $orderId, int $templateId): array
         $tenantId = $this->tenantId();
 
         $order = \App\Models\Orders\Order::where('tenant_id', $tenantId)
-            ->with('items')
+            ->with(['rootNodes.items' => fn ($q) => $q->orderBy('sort_order')])
             ->findOrFail($orderId);
 
-        // 해당 수주의 FQC 문서 조회
+        // 개소별 대표 OrderItem ID 수집
+        $representativeItemIds = $order->rootNodes
+            ->map(fn ($node) => $node->items->first()?->id)
+            ->filter()
+            ->values();
+
+        // 해당 대표 품목의 FQC 문서 조회
         $documents = Document::where('tenant_id', $tenantId)
             ->where('template_id', $templateId)
             ->where('linkable_type', \App\Models\Orders\OrderItem::class)
-            ->whereIn('linkable_id', $order->items->pluck('id'))
+            ->whereIn('linkable_id', $representativeItemIds)
             ->with('data')
             ->get()
             ->keyBy('linkable_id');
 
-        $items = $order->items->map(function ($orderItem) use ($documents) {
-            $doc = $documents->get($orderItem->id);
+        // 개소(root node)별 진행현황
+        $items = $order->rootNodes->map(function ($node) use ($documents) {
+            $representativeItem = $node->items->first();
+            if (! $representativeItem) {
+                return null;
+            }
+
+            $doc = $documents->get($representativeItem->id);
 
             // 종합판정 값 추출
             $judgement = null;
@@ -686,17 +698,17 @@ public function fqcStatus(int $orderId, int $templateId): array
             }
 
             return [
-                'order_item_id' => $orderItem->id,
-                'floor_code' => $orderItem->floor_code,
-                'symbol_code' => $orderItem->symbol_code,
-                'specification' => $orderItem->specification,
-                'item_name' => $orderItem->item_name,
+                'order_item_id' => $representativeItem->id,
+                'floor_code' => $representativeItem->floor_code,
+                'symbol_code' => $representativeItem->symbol_code,
+                'specification' => $representativeItem->specification,
+                'item_name' => $representativeItem->item_name,
                 'document_id' => $doc?->id,
                 'document_no' => $doc?->document_no,
                 'status' => $doc?->status ?? 'NONE',
                 'judgement' => $judgement,
             ];
-        });
+        })->filter()->values();
 
         // 통계
         $total = $items->count();
@@ -889,6 +901,7 @@ public function upsert(array $data): Document
                 if (isset($data['rendered_html'])) {
                     $updatePayload['rendered_html'] = $data['rendered_html'];
                 }
+
                 return $this->update($existingDocument->id, $updatePayload);
             }
 
@@ -904,6 +917,7 @@ public function upsert(array $data): Document
             if (isset($data['rendered_html'])) {
                 $createPayload['rendered_html'] = $data['rendered_html'];
             }
+
             return $this->create($createPayload);
         });
     }