- 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>
141 lines
3.5 KiB
PHP
141 lines
3.5 KiB
PHP
<?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);
|
|
}
|
|
}
|