feat: Design BOM 템플릿 diff/clone API 및 모델버전 릴리즈 유효성 검사 도입

- Design BOM 템플릿 diff/clone 엔드포인트 추가
- 컨트롤러 검증 로직 FormRequest 분리(DiffRequest/CloneRequest/Upsert/ReplaceItems)
- BomTemplateService에 diffTemplates/cloneTemplate/replaceItems/쇼우 로직 정리
- ModelVersionController createDraft FormRequest 적용 및 서비스 호출 정리
- 모델버전 release 전 유효성 검사(존재/활성/테넌트 일치, qty>0, 중복 금지) 추가
- DB enum 미사용 방침 준수(status 문자열 유지)
- model_versions 인덱스 최적화(tenant_id, model_id, status / 기간 범위)
- Swagger 문서(Design BOM) 및 i18n 메시지 키 추가

app/Http/Controllers/Api/V1/Design/BomTemplateController.php

@@ -4,8 +4,11 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
+use App\Http\Requests\Design\BomTemplate\CloneRequest;
+use App\Http\Requests\Design\BomTemplate\DiffRequest;
+use App\Http\Requests\Design\BomTemplate\ReplaceItemsRequest;
+use App\Http\Requests\Design\BomTemplate\UpsertRequest;
 use App\Services\Design\BomTemplateService;
-use Illuminate\Http\Request;
 
 class BomTemplateController extends Controller
 {
@@ -21,14 +24,10 @@ public function listByVersion(int $versionId)
         }, __('message.fetched'));
     }
 
-    public function upsertTemplate(Request $request, int $versionId)
+    public function upsertTemplate(UpsertRequest $request, int $versionId)
     {
         return ApiResponse::handle(function () use ($request, $versionId) {
-            $payload = $request->validate([
-                'name'       => 'nullable|string|max:100',
-                'is_primary' => 'boolean',
-                'notes'      => 'nullable|string',
-            ]);
+            $payload = $request->validated();
             return $this->service->upsertTemplate(
                 modelVersionId: $versionId,
                 name: $payload['name'] ?? 'Main',
@@ -43,21 +42,35 @@ public function show(int $templateId)
         return ApiResponse::handle(fn() => $this->service->show($templateId, true), __('message.fetched'));
     }
 
-    public function replaceItems(Request $request, int $templateId)
+    public function replaceItems(ReplaceItemsRequest $request, int $templateId)
     {
         return ApiResponse::handle(function () use ($request, $templateId) {
-            $payload = $request->validate([
-                'items'                => 'required|array|min:1',
-                'items.*.ref_type'     => 'required|string|in:MATERIAL,PRODUCT',
-                'items.*.ref_id'       => 'required|integer|min:1',
-                'items.*.qty'          => 'required|numeric|gt:0',
-                'items.*.waste_rate'   => 'nullable|numeric|min:0',
-                'items.*.uom_id'       => 'nullable|integer|min:1',
-                'items.*.notes'        => 'nullable|string|max:255',
-                'items.*.sort_order'   => 'nullable|integer',
-            ]);
+            $payload = $request->validated();
             $this->service->replaceItems($templateId, $payload['items']);
             return null;
         }, __('message.bom.bulk_upsert'));
     }
+
+    public function diff(int $templateId, DiffRequest $request)
+    {
+        return ApiResponse::handle(function () use ($templateId, $request) {
+            $otherId = $request->validated()['other_template_id'];
+            return $this->service->diffTemplates($templateId, $otherId);
+        }, __('message.design.template_diff'));
+    }
+
+    public function cloneTemplate(int $templateId, CloneRequest $request)
+    {
+        return ApiResponse::handle(function () use ($templateId, $request) {
+            $payload = $request->validated();
+            $tpl = $this->service->cloneTemplate(
+                templateId: $templateId,
+                targetVersionId: $payload['target_version_id'] ?? null,
+                name: $payload['name'] ?? null,
+                isPrimary: (bool)($payload['is_primary'] ?? false),
+                notes: $payload['notes'] ?? null
+            );
+            return $tpl;
+        }, __('message.design.template_cloned'));
+    }
 }