feat: 공정 단계(ProcessStep) CRUD API 구현

- process_steps 테이블 마이그레이션 생성 (step_code, sort_order, boolean 플래그 등) - ProcessStep 모델 생성 (child entity 패턴, HasFactory만 사용) - ProcessStepService: CRUD + reorder + STP-001 자동채번 - ProcessStepController: DI + ApiResponse::handle 패턴 - FormRequest 3개: Store, Update, Reorder - Process 모델에 steps() HasMany 관계 추가 - ProcessService eager-load에 steps 추가 (5곳) - Nested routes: /processes/{processId}/steps Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 18:59:12 +09:00
parent 529c587023
commit 3d20c6979d
10 changed files with 441 additions and 5 deletions
--- a/app/Services/ProcessStepService.php
+++ b/app/Services/ProcessStepService.php
@@ -0,0 +1,140 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Process;
+use App\Models\ProcessStep;
+use Illuminate\Support\Facades\DB;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+
+class ProcessStepService extends Service
+{
+    /**
+     * 공정 단계 목록 조회
+     */
+    public function index(int $processId)
+    {
+        $process = $this->findProcess($processId);
+
+        return $process->steps()
+            ->orderBy('sort_order')
+            ->get();
+    }
+
+    /**
+     * 공정 단계 상세 조회
+     */
+    public function show(int $processId, int $stepId)
+    {
+        $this->findProcess($processId);
+
+        $step = ProcessStep::where('process_id', $processId)->find($stepId);
+        if (! $step) {
+            throw new NotFoundHttpException(__('error.not_found'));
+        }
+
+        return $step;
+    }
+
+    /**
+     * 공정 단계 생성
+     */
+    public function store(int $processId, array $data)
+    {
+        $process = $this->findProcess($processId);
+
+        $data['process_id'] = $process->id;
+        $data['step_code'] = $this->generateStepCode($process->id);
+        $data['sort_order'] = ($process->steps()->max('sort_order') ?? 0) + 1;
+        $data['is_active'] = $data['is_active'] ?? true;
+
+        return ProcessStep::create($data);
+    }
+
+    /**
+     * 공정 단계 수정
+     */
+    public function update(int $processId, int $stepId, array $data)
+    {
+        $this->findProcess($processId);
+
+        $step = ProcessStep::where('process_id', $processId)->find($stepId);
+        if (! $step) {
+            throw new NotFoundHttpException(__('error.not_found'));
+        }
+
+        $step->update($data);
+
+        return $step->fresh();
+    }
+
+    /**
+     * 공정 단계 삭제
+     */
+    public function destroy(int $processId, int $stepId)
+    {
+        $this->findProcess($processId);
+
+        $step = ProcessStep::where('process_id', $processId)->find($stepId);
+        if (! $step) {
+            throw new NotFoundHttpException(__('error.not_found'));
+        }
+
+        $step->delete();
+
+        return true;
+    }
+
+    /**
+     * 공정 단계 순서 변경
+     */
+    public function reorder(int $processId, array $items)
+    {
+        $this->findProcess($processId);
+
+        return DB::transaction(function () use ($processId, $items) {
+            foreach ($items as $item) {
+                ProcessStep::where('process_id', $processId)
+                    ->where('id', $item['id'])
+                    ->update(['sort_order' => $item['sort_order']]);
+            }
+
+            return ProcessStep::where('process_id', $processId)
+                ->orderBy('sort_order')
+                ->get();
+        });
+    }
+
+    /**
+     * 부모 공정 조회 (tenant scope)
+     */
+    private function findProcess(int $processId): Process
+    {
+        $tenantId = $this->tenantId();
+
+        $process = Process::where('tenant_id', $tenantId)->find($processId);
+        if (! $process) {
+            throw new NotFoundHttpException(__('error.not_found'));
+        }
+
+        return $process;
+    }
+
+    /**
+     * 단계코드 자동 생성 (STP-001, STP-002, ...)
+     */
+    private function generateStepCode(int $processId): string
+    {
+        $lastStep = ProcessStep::where('process_id', $processId)
+            ->orderByRaw('CAST(SUBSTRING(step_code, 5) AS UNSIGNED) DESC')
+            ->first();
+
+        if ($lastStep && preg_match('/^STP-(\d+)$/', $lastStep->step_code, $matches)) {
+            $nextNum = (int) $matches[1] + 1;
+        } else {
+            $nextNum = 1;
+        }
+
+        return sprintf('STP-%03d', $nextNum);
+    }
+}