feat: [QMS] 점검표 템플릿 관리 백엔드 구현

- checklist_templates 테이블 마이그레이션 + 기본 시딩 - ChecklistTemplate 모델 (BelongsToTenant, Auditable, SoftDeletes) - ChecklistTemplateService: 조회/저장/파일 업로드/삭제 - SaveChecklistTemplateRequest: 중첩 JSON 검증 - ChecklistTemplateController: 5개 엔드포인트 - 라우트 등록 (quality/checklist-templates, quality/qms-documents)
2026-03-11 20:04:29 +09:00
parent 3bae303447
commit 12373edf8c
6 changed files with 536 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/ChecklistTemplateController.php
+++ b/app/Http/Controllers/Api/V1/ChecklistTemplateController.php
@@ -0,0 +1,82 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Quality\SaveChecklistTemplateRequest;
+use App\Services\ChecklistTemplateService;
+use Illuminate\Http\Request;
+
+class ChecklistTemplateController extends Controller
+{
+    public function __construct(private ChecklistTemplateService $service) {}
+
+    /**
+     * 템플릿 조회 (type별)
+     */
+    public function show(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $type = $request->query('type', 'day1_audit');
+
+            return $this->service->getByType($type);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 템플릿 저장 (전체 덮어쓰기)
+     */
+    public function update(SaveChecklistTemplateRequest $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            return $this->service->save($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 항목별 파일 목록 조회
+     */
+    public function documents(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $templateId = (int) $request->query('template_id');
+            $subItemId = $request->query('sub_item_id');
+
+            return $this->service->getDocuments($templateId, $subItemId);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 파일 업로드
+     */
+    public function uploadDocument(Request $request)
+    {
+        $request->validate([
+            'template_id' => ['required', 'integer'],
+            'sub_item_id' => ['required', 'string', 'max:50'],
+            'file' => ['required', 'file', 'max:10240'], // 10MB
+        ]);
+
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->uploadDocument(
+                (int) $request->input('template_id'),
+                $request->input('sub_item_id'),
+                $request->file('file')
+            );
+        }, __('message.created'));
+    }
+
+    /**
+     * 파일 삭제
+     */
+    public function deleteDocument(int $id, Request $request)
+    {
+        return ApiResponse::handle(function () use ($id, $request) {
+            $replace = filter_var($request->query('replace', false), FILTER_VALIDATE_BOOLEAN);
+            $this->service->deleteDocument($id, $replace);
+
+            return 'success';
+        }, __('message.deleted'));
+    }
+}
--- a/app/Http/Requests/Quality/SaveChecklistTemplateRequest.php
+++ b/app/Http/Requests/Quality/SaveChecklistTemplateRequest.php
@@ -0,0 +1,40 @@
+<?php
+
+namespace App\Http\Requests\Quality;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class SaveChecklistTemplateRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'name' => ['nullable', 'string', 'max:255'],
+            'categories' => ['required', 'array', 'min:1'],
+            'categories.*.id' => ['required', 'string', 'max:50'],
+            'categories.*.title' => ['required', 'string', 'max:255'],
+            'categories.*.subItems' => ['required', 'array'],
+            'categories.*.subItems.*.id' => ['required', 'string', 'max:50'],
+            'categories.*.subItems.*.name' => ['required', 'string', 'max:255'],
+            'options' => ['nullable', 'array'],
+        ];
+    }
+
+    public function messages(): array
+    {
+        return [
+            'categories.required' => __('validation.required', ['attribute' => '카테고리']),
+            'categories.min' => __('validation.min.array', ['attribute' => '카테고리', 'min' => 1]),
+            'categories.*.id.required' => __('validation.required', ['attribute' => '카테고리 ID']),
+            'categories.*.title.required' => __('validation.required', ['attribute' => '카테고리 제목']),
+            'categories.*.subItems.required' => __('validation.required', ['attribute' => '점검항목']),
+            'categories.*.subItems.*.id.required' => __('validation.required', ['attribute' => '항목 ID']),
+            'categories.*.subItems.*.name.required' => __('validation.required', ['attribute' => '항목명']),
+        ];
+    }
+}