deploy: 2026-03-11 배포

- feat: QMS 감사 체크리스트 (AuditChecklist CRUD, 카테고리/항목/표준문서 모델, 마이그레이션) - feat: QMS LOT 감사 (QmsLotAudit 컨트롤러/서비스, 확인/문서상세 FormRequest) - fix: CalendarService, MemberService 수정 - chore: QualityDocumentLocation options 컬럼 추가, tenant_id 마이그레이션, 품질 더미데이터 시더
2026-03-11 02:04:29 +09:00
parent bd500a87bd
commit 047524c19f
21 changed files with 2356 additions and 1 deletions
--- a/app/Http/Controllers/Api/V1/AuditChecklistController.php
+++ b/app/Http/Controllers/Api/V1/AuditChecklistController.php
@@ -0,0 +1,112 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Qms\AuditChecklistStoreRequest;
+use App\Http\Requests\Qms\AuditChecklistUpdateRequest;
+use App\Services\AuditChecklistService;
+use Illuminate\Http\Request;
+
+class AuditChecklistController extends Controller
+{
+    public function __construct(private AuditChecklistService $service) {}
+
+    /**
+     * 점검표 목록
+     */
+    public function index(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->index($request->all());
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 점검표 생성 (카테고리+항목 일괄)
+     */
+    public function store(AuditChecklistStoreRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->store($request->validated());
+        }, __('message.created'));
+    }
+
+    /**
+     * 점검표 상세
+     */
+    public function show(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->show($id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 점검표 수정
+     */
+    public function update(AuditChecklistUpdateRequest $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.updated'));
+    }
+
+    /**
+     * 점검표 완료 처리
+     */
+    public function complete(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->complete($id);
+        }, __('message.updated'));
+    }
+
+    /**
+     * 항목 완료/미완료 토글
+     */
+    public function toggleItem(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->toggleItem($id);
+        }, __('message.updated'));
+    }
+
+    /**
+     * 항목별 기준 문서 조회
+     */
+    public function itemDocuments(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->itemDocuments($id);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 기준 문서 연결
+     */
+    public function attachDocument(Request $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            return $this->service->attachDocument($id, $request->validate([
+                'title' => 'required|string|max:200',
+                'version' => 'nullable|string|max:20',
+                'date' => 'nullable|date',
+                'document_id' => 'nullable|integer|exists:documents,id',
+            ]));
+        }, __('message.created'));
+    }
+
+    /**
+     * 기준 문서 연결 해제
+     */
+    public function detachDocument(int $id, int $docId)
+    {
+        return ApiResponse::handle(function () use ($id, $docId) {
+            $this->service->detachDocument($id, $docId);
+
+            return null;
+        }, __('message.deleted'));
+    }
+}
--- a/app/Http/Controllers/Api/V1/QmsLotAuditController.php
+++ b/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'));
+    }
+}
--- a/app/Http/Requests/Qms/AuditChecklistStoreRequest.php
+++ b/app/Http/Requests/Qms/AuditChecklistStoreRequest.php
@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Http\Requests\Qms;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class AuditChecklistStoreRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'year' => 'required|integer|min:2020|max:2100',
+            'quarter' => 'required|integer|in:1,2,3,4',
+            'type' => 'nullable|string|max:30',
+            'categories' => 'required|array|min:1',
+            'categories.*.title' => 'required|string|max:200',
+            'categories.*.sort_order' => 'nullable|integer|min:0',
+            'categories.*.items' => 'required|array|min:1',
+            'categories.*.items.*.name' => 'required|string|max:200',
+            'categories.*.items.*.description' => 'nullable|string',
+            'categories.*.items.*.sort_order' => 'nullable|integer|min:0',
+        ];
+    }
+
+    public function messages(): array
+    {
+        return [
+            'categories.required' => __('validation.required', ['attribute' => '카테고리']),
+            'categories.*.title.required' => __('validation.required', ['attribute' => '카테고리 제목']),
+            'categories.*.items.required' => __('validation.required', ['attribute' => '점검 항목']),
+            'categories.*.items.*.name.required' => __('validation.required', ['attribute' => '항목명']),
+        ];
+    }
+}
--- a/app/Http/Requests/Qms/AuditChecklistUpdateRequest.php
+++ b/app/Http/Requests/Qms/AuditChecklistUpdateRequest.php
@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests\Qms;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class AuditChecklistUpdateRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'categories' => 'sometimes|array|min:1',
+            'categories.*.id' => 'nullable|integer|exists:audit_checklist_categories,id',
+            'categories.*.title' => 'required|string|max:200',
+            'categories.*.sort_order' => 'nullable|integer|min:0',
+            'categories.*.items' => 'required|array|min:1',
+            'categories.*.items.*.id' => 'nullable|integer|exists:audit_checklist_items,id',
+            'categories.*.items.*.name' => 'required|string|max:200',
+            'categories.*.items.*.description' => 'nullable|string',
+            'categories.*.items.*.sort_order' => 'nullable|integer|min:0',
+        ];
+    }
+}
--- a/app/Http/Requests/Qms/QmsLotAuditConfirmRequest.php
+++ b/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' => '확인 상태']),
+        ];
+    }
+}
--- a/app/Http/Requests/Qms/QmsLotAuditDocumentDetailRequest.php
+++ b/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' => '서류 타입']),
+        ];
+    }
+}
--- a/app/Http/Requests/Qms/QmsLotAuditIndexRequest.php
+++ b/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',
+        ];
+    }
+}