feat: [QMS] 2일차 로트 추적 심사 API 구현 (Phase 1)

- QmsLotAuditService: 품질관리서 목록/상세, 8종 서류 조합, 서류 상세(2단계 로딩), 확인 토글
- QmsLotAuditController: 5개 엔드포인트 (index, show, routeDocuments, documentDetail, confirm)
- FormRequest 3개: Index, Confirm, DocumentDetail 파라미터 검증
- QualityDocumentLocation: options JSON 컬럼 추가 (마이그레이션 + 모델 casts)
- IQC 추적: WorkOrderMaterialInput → StockLot → lot_no → Inspection(IQC) 경로
- 비관적 업데이트: DB::transaction + lockForUpdate() 원자성 보장

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

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

@@ -0,0 +1,65 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Qms\QmsLotAuditConfirmRequest;
+use App\Http\Requests\Qms\QmsLotAuditDocumentDetailRequest;
+use App\Http\Requests\Qms\QmsLotAuditIndexRequest;
+use App\Services\QmsLotAuditService;
+
+class QmsLotAuditController extends Controller
+{
+    public function __construct(private QmsLotAuditService $service) {}
+
+    /**
+     * 품질관리서 목록 (로트 추적 심사용)
+     */
+    public function index(QmsLotAuditIndexRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->index($request->validated());
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 품질관리서 상세 — 수주/개소 목록
+     */
+    public function show(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->show($id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 수주 루트별 8종 서류 목록
+     */
+    public function routeDocuments(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->routeDocuments($id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 서류 상세 조회 (2단계 로딩)
+     */
+    public function documentDetail(QmsLotAuditDocumentDetailRequest $request, string $type, int $id)
+    {
+        return ApiResponse::handle(function () use ($type, $id) {
+            return $this->service->documentDetail($type, $id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 개소별 로트 심사 확인 토글
+     */
+    public function confirm(QmsLotAuditConfirmRequest $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            return $this->service->confirm($id, $request->validated());
+        }, __('message.updated'));
+    }
+}

app/Http/Requests/Qms/QmsLotAuditConfirmRequest.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests\Qms;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class QmsLotAuditConfirmRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'confirmed' => 'required|boolean',
+        ];
+    }
+
+    public function messages(): array
+    {
+        return [
+            'confirmed.required' => __('validation.required', ['attribute' => '확인 상태']),
+            'confirmed.boolean' => __('validation.boolean', ['attribute' => '확인 상태']),
+        ];
+    }
+}

app/Http/Requests/Qms/QmsLotAuditDocumentDetailRequest.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Http\Requests\Qms;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class QmsLotAuditDocumentDetailRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    protected function prepareForValidation(): void
+    {
+        $this->merge([
+            'type' => $this->route('type'),
+        ]);
+    }
+
+    public function rules(): array
+    {
+        return [
+            'type' => 'required|string|in:import,order,log,report,confirmation,shipping,product,quality',
+        ];
+    }
+
+    public function messages(): array
+    {
+        return [
+            'type.in' => __('validation.in', ['attribute' => '서류 타입']),
+        ];
+    }
+}

app/Http/Requests/Qms/QmsLotAuditIndexRequest.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Requests\Qms;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class QmsLotAuditIndexRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'year' => 'nullable|integer|min:2020|max:2100',
+            'quarter' => 'nullable|integer|in:1,2,3,4',
+            'q' => 'nullable|string|max:100',
+            'per_page' => 'nullable|integer|min:1|max:100',
+        ];
+    }
+}