feat:검사 기준서 동적 필드 + 자동 하이라이트 + 미리보기 개선

- 문서 작성 시 연결 품목 규격(두께/너비/길이) 기반 자동 하이라이트
- 미리보기에서 field_values 동적 필드 데이터 정상 표시
- DocumentTemplateController에서 field_values 직렬화 추가
- DocumentController에 linkedItemSpecs 조회 로직 추가
- Item 모델 attributes JSON cast 추가

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

app/Http/Controllers/Api/Admin/DocumentApiController.php

@@ -20,10 +20,17 @@ public function index(Request $request): JsonResponse
     {
         $tenantId = session('selected_tenant_id');
 
+        // 슈퍼관리자 휴지통 조회
+        $showTrashed = $request->filled('trashed') && auth()->user()?->is_super_admin;
+
         $query = Document::with(['template', 'creator'])
             ->where('tenant_id', $tenantId)
             ->orderBy('created_at', 'desc');
 
+        if ($showTrashed) {
+            $query->onlyTrashed();
+        }
+
         // 상태 필터
         if ($request->filled('status')) {
             $query->where('status', $request->status);
@@ -207,14 +214,7 @@ public function destroy(int $id): JsonResponse
 
         $document = Document::where('tenant_id', $tenantId)->findOrFail($id);
 
-        // 작성중 상태에서만 삭제 가능
-        if ($document->status !== Document::STATUS_DRAFT) {
-            return response()->json([
-                'success' => false,
-                'message' => '작성중 상태의 문서만 삭제할 수 있습니다.',
-            ], 422);
-        }
-
+        $document->update(['deleted_by' => auth()->id()]);
         $document->delete();
 
         return response()->json([
@@ -223,6 +223,57 @@ public function destroy(int $id): JsonResponse
         ]);
     }
 
+    /**
+     * 문서 영구삭제 (슈퍼관리자 전용)
+     */
+    public function forceDestroy(int $id): JsonResponse
+    {
+        if (!auth()->user()?->is_super_admin) {
+            return response()->json([
+                'success' => false,
+                'message' => '슈퍼관리자만 영구 삭제할 수 있습니다.',
+            ], 403);
+        }
+
+        $tenantId = session('selected_tenant_id');
+
+        $document = Document::withTrashed()->where('tenant_id', $tenantId)->findOrFail($id);
+
+        // 관련 데이터도 영구삭제
+        $document->data()->delete();
+        $document->approvals()->delete();
+        $document->forceDelete();
+
+        return response()->json([
+            'success' => true,
+            'message' => '문서가 영구 삭제되었습니다.',
+        ]);
+    }
+
+    /**
+     * 삭제된 문서 복원 (슈퍼관리자 전용)
+     */
+    public function restore(int $id): JsonResponse
+    {
+        if (!auth()->user()?->is_super_admin) {
+            return response()->json([
+                'success' => false,
+                'message' => '슈퍼관리자만 복원할 수 있습니다.',
+            ], 403);
+        }
+
+        $tenantId = session('selected_tenant_id');
+
+        $document = Document::onlyTrashed()->where('tenant_id', $tenantId)->findOrFail($id);
+        $document->update(['deleted_by' => null]);
+        $document->restore();
+
+        return response()->json([
+            'success' => true,
+            'message' => '문서가 복원되었습니다.',
+        ]);
+    }
+
     /**
      * 결재 제출 (DRAFT → PENDING)
      */

app/Http/Controllers/DocumentController.php

@@ -4,8 +4,10 @@
 
 use App\Models\Documents\Document;
 use App\Models\DocumentTemplate;
+use App\Models\Items\Item;
 use Illuminate\Http\Request;
 use Illuminate\Http\Response;
+use Illuminate\Support\Facades\DB;
 use Illuminate\View\View;
 
 class DocumentController extends Controller
@@ -63,6 +65,7 @@ public function create(Request $request): View|Response
             'template' => $template,
             'templates' => $templates,
             'isCreate' => true,
+            'linkedItemSpecs' => $template ? $this->getLinkedItemSpecs($template) : [],
         ]);
     }
 
@@ -102,6 +105,7 @@ public function edit(int $id): View|Response
             'template' => $document->template,
             'templates' => $templates,
             'isCreate' => false,
+            'linkedItemSpecs' => $this->getLinkedItemSpecs($document->template),
         ]);
     }
 
@@ -154,4 +158,42 @@ public function show(int $id): View
             'document' => $document,
         ]);
     }
+
+    /**
+     * 템플릿에 연결된 품목들의 규격 정보 (thickness, width, length) 조회
+     */
+    private function getLinkedItemSpecs(DocumentTemplate $template): array
+    {
+        $specs = [];
+
+        if (! $template->relationLoaded('links')) {
+            $template->load('links.linkValues');
+        }
+
+        foreach ($template->links as $link) {
+            if ($link->source_table !== 'items') {
+                continue;
+            }
+
+            foreach ($link->linkValues as $lv) {
+                $item = Item::find($lv->linkable_id);
+                if (! $item) {
+                    continue;
+                }
+
+                $attrs = $item->attributes ?? [];
+                if (isset($attrs['thickness']) || isset($attrs['width']) || isset($attrs['length'])) {
+                    $specs[] = [
+                        'id' => $item->id,
+                        'name' => $item->name,
+                        'thickness' => $attrs['thickness'] ?? null,
+                        'width' => $attrs['width'] ?? null,
+                        'length' => $attrs['length'] ?? null,
+                    ];
+                }
+            }
+        }
+
+        return $specs;
+    }
 }

app/Http/Controllers/DocumentTemplateController.php

@@ -141,19 +141,22 @@ private function prepareTemplateData(DocumentTemplate $template): array
                     'title' => $s->title,
                     'image_path' => $s->image_path,
                     'items' => $s->items->map(function ($i) {
+                        $fv = $i->field_values ?? [];
+
                         return [
                             'id' => $i->id,
-                            'category' => $i->category,
-                            'item' => $i->item,
-                            'standard' => $i->standard,
-                            'tolerance' => $i->tolerance,
-                            'standard_criteria' => $i->standard_criteria,
-                            'method' => $i->method,
-                            'measurement_type' => $i->measurement_type,
-                            'frequency_n' => $i->frequency_n,
-                            'frequency_c' => $i->frequency_c,
-                            'frequency' => $i->frequency,
-                            'regulation' => $i->regulation,
+                            'category' => $fv['category'] ?? $i->category,
+                            'item' => $fv['item'] ?? $i->item,
+                            'standard' => $fv['standard'] ?? $i->standard,
+                            'tolerance' => $fv['tolerance'] ?? $i->tolerance,
+                            'standard_criteria' => $fv['standard_criteria'] ?? $i->standard_criteria,
+                            'method' => $fv['method'] ?? $i->method,
+                            'measurement_type' => $fv['measurement_type'] ?? $i->measurement_type,
+                            'frequency_n' => $fv['frequency_n'] ?? $i->frequency_n,
+                            'frequency_c' => $fv['frequency_c'] ?? $i->frequency_c,
+                            'frequency' => $fv['frequency'] ?? $i->frequency,
+                            'regulation' => $fv['regulation'] ?? $i->regulation,
+                            'field_values' => $fv,
                         ];
                     })->toArray(),
                 ];