SamProject/sam-api
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
- 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>
This commit is contained in:
권혁성
2026-02-03 18:59:12 +09:00
parent 529c587023
commit 3d20c6979d
10 changed files with 441 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

84
app/Http/Controllers/V1/ProcessStepController.php Normal file
View File

@@ -0,0 +1,84 @@
<?php
namespace App\Http\Controllers\V1;
use App\Helpers\ApiResponse;
use App\Http\Controllers\Controller;
use App\Http\Requests\V1\ProcessStep\ReorderProcessStepRequest;
use App\Http\Requests\V1\ProcessStep\StoreProcessStepRequest;
use App\Http\Requests\V1\ProcessStep\UpdateProcessStepRequest;
use App\Services\ProcessStepService;
use Illuminate\Http\JsonResponse;
class ProcessStepController extends Controller
{
public function __construct(
private readonly ProcessStepService $processStepService
) {}
/**
* 공정 단계 목록 조회
*/
public function index(int $processId): JsonResponse
{
return ApiResponse::handle(
fn () => $this->processStepService->index($processId),
'message.fetched'
);
}
/**
* 공정 단계 상세 조회
*/
public function show(int $processId, int $stepId): JsonResponse
{
return ApiResponse::handle(
fn () => $this->processStepService->show($processId, $stepId),
'message.fetched'
);
}
/**
* 공정 단계 생성
*/
public function store(StoreProcessStepRequest $request, int $processId): JsonResponse
{
return ApiResponse::handle(
fn () => $this->processStepService->store($processId, $request->validated()),
'message.created'
);
}
/**
* 공정 단계 수정
*/
public function update(UpdateProcessStepRequest $request, int $processId, int $stepId): JsonResponse
{
return ApiResponse::handle(
fn () => $this->processStepService->update($processId, $stepId, $request->validated()),
'message.updated'
);
}
/**
* 공정 단계 삭제
*/
public function destroy(int $processId, int $stepId): JsonResponse
{
return ApiResponse::handle(
fn () => $this->processStepService->destroy($processId, $stepId),
'message.deleted'
);
}
/**
* 공정 단계 순서 변경
*/
public function reorder(ReorderProcessStepRequest $request, int $processId): JsonResponse
{
return ApiResponse::handle(
fn () => $this->processStepService->reorder($processId, $request->validated('items')),
'message.reordered'
);
}
}

31
app/Http/Requests/V1/ProcessStep/ReorderProcessStepRequest.php Normal file
View File

@@ -0,0 +1,31 @@
<?php
namespace App\Http\Requests\V1\ProcessStep;
use Illuminate\Foundation\Http\FormRequest;
class ReorderProcessStepRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'items' => ['required', 'array', 'min:1'],
'items.*.id' => ['required', 'integer'],
'items.*.sort_order' => ['required', 'integer', 'min:0'],
];
}
public function attributes(): array
{
return [
'items' => '정렬 항목',
'items.*.id' => '단계 ID',
'items.*.sort_order' => '정렬순서',
];
}
}

41
app/Http/Requests/V1/ProcessStep/StoreProcessStepRequest.php Normal file
View File

@@ -0,0 +1,41 @@
<?php
namespace App\Http\Requests\V1\ProcessStep;
use Illuminate\Foundation\Http\FormRequest;
class StoreProcessStepRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'step_name' => ['required', 'string', 'max:100'],
'is_required' => ['nullable', 'boolean'],
'needs_approval' => ['nullable', 'boolean'],
'needs_inspection' => ['nullable', 'boolean'],
'is_active' => ['nullable', 'boolean'],
'connection_type' => ['nullable', 'string', 'max:20'],
'connection_target' => ['nullable', 'string', 'max:255'],
'completion_type' => ['nullable', 'string', 'max:30'],
];
}
public function attributes(): array
{
return [
'step_name' => '단계명',
'is_required' => '필수여부',
'needs_approval' => '승인필요여부',
'needs_inspection' => '검사필요여부',
'is_active' => '사용여부',
'connection_type' => '연결유형',
'connection_target' => '연결대상',
'completion_type' => '완료유형',
];
}
}

41
app/Http/Requests/V1/ProcessStep/UpdateProcessStepRequest.php Normal file
View File

@@ -0,0 +1,41 @@
<?php
namespace App\Http\Requests\V1\ProcessStep;
use Illuminate\Foundation\Http\FormRequest;
class UpdateProcessStepRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'step_name' => ['sometimes', 'required', 'string', 'max:100'],
'is_required' => ['nullable', 'boolean'],
'needs_approval' => ['nullable', 'boolean'],
'needs_inspection' => ['nullable', 'boolean'],
'is_active' => ['nullable', 'boolean'],
'connection_type' => ['nullable', 'string', 'max:20'],
'connection_target' => ['nullable', 'string', 'max:255'],
'completion_type' => ['nullable', 'string', 'max:30'],
];
}
public function attributes(): array
{
return [
'step_name' => '단계명',
'is_required' => '필수여부',
'needs_approval' => '승인필요여부',
'needs_inspection' => '검사필요여부',
'is_active' => '사용여부',
'connection_type' => '연결유형',
'connection_target' => '연결대상',
'completion_type' => '완료유형',
];
}
}