feat: G-1 작업지시 관리 API 구현
- 작업지시 테이블 마이그레이션 (work_orders, work_order_items, work_order_bending_details, work_order_issues)
- 작업지시 모델 4개 (WorkOrder, WorkOrderItem, WorkOrderBendingDetail, WorkOrderIssue)
- WorkOrderService 비즈니스 로직 구현
- WorkOrderController REST API 엔드포인트 11개
- FormRequest 검증 클래스 5개
- Swagger API 문서화 완료
API Endpoints:
- GET /work-orders (목록)
- GET /work-orders/stats (통계)
- POST /work-orders (등록)
- GET /work-orders/{id} (상세)
- PUT /work-orders/{id} (수정)
- DELETE /work-orders/{id} (삭제)
- PATCH /work-orders/{id}/status (상태변경)
- PATCH /work-orders/{id}/assign (담당자배정)
- PATCH /work-orders/{id}/bending/toggle (벤딩토글)
- POST /work-orders/{id}/issues (이슈등록)
- PATCH /work-orders/{id}/issues/{issueId}/resolve (이슈해결)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
130
app/Http/Controllers/Api/V1/WorkOrderController.php
Normal file
130
app/Http/Controllers/Api/V1/WorkOrderController.php
Normal file
@@ -0,0 +1,130 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Controllers\Api\V1;
|
||||
|
||||
use App\Helpers\ApiResponse;
|
||||
use App\Http\Controllers\Controller;
|
||||
use App\Http\Requests\WorkOrder\WorkOrderAssignRequest;
|
||||
use App\Http\Requests\WorkOrder\WorkOrderIssueRequest;
|
||||
use App\Http\Requests\WorkOrder\WorkOrderStatusRequest;
|
||||
use App\Http\Requests\WorkOrder\WorkOrderStoreRequest;
|
||||
use App\Http\Requests\WorkOrder\WorkOrderUpdateRequest;
|
||||
use App\Services\WorkOrderService;
|
||||
use Illuminate\Http\Request;
|
||||
|
||||
class WorkOrderController extends Controller
|
||||
{
|
||||
public function __construct(private WorkOrderService $service) {}
|
||||
|
||||
/**
|
||||
* 목록 조회
|
||||
*/
|
||||
public function index(Request $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->index($request->all());
|
||||
}, __('message.work_order.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 통계 조회
|
||||
*/
|
||||
public function stats()
|
||||
{
|
||||
return ApiResponse::handle(function () {
|
||||
return $this->service->stats();
|
||||
}, __('message.work_order.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 단건 조회
|
||||
*/
|
||||
public function show(int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($id) {
|
||||
return $this->service->show($id);
|
||||
}, __('message.work_order.fetched'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 생성
|
||||
*/
|
||||
public function store(WorkOrderStoreRequest $request)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request) {
|
||||
return $this->service->store($request->validated());
|
||||
}, __('message.work_order.created'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 수정
|
||||
*/
|
||||
public function update(WorkOrderUpdateRequest $request, int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request, $id) {
|
||||
return $this->service->update($id, $request->validated());
|
||||
}, __('message.work_order.updated'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 삭제
|
||||
*/
|
||||
public function destroy(int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($id) {
|
||||
$this->service->destroy($id);
|
||||
|
||||
return 'success';
|
||||
}, __('message.work_order.deleted'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 상태 변경
|
||||
*/
|
||||
public function updateStatus(WorkOrderStatusRequest $request, int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request, $id) {
|
||||
return $this->service->updateStatus($id, $request->validated()['status']);
|
||||
}, __('message.work_order.status_updated'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 담당자 배정
|
||||
*/
|
||||
public function assign(WorkOrderAssignRequest $request, int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request, $id) {
|
||||
return $this->service->assign($id, $request->validated());
|
||||
}, __('message.work_order.assigned'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 벤딩 항목 토글
|
||||
*/
|
||||
public function toggleBendingField(Request $request, int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request, $id) {
|
||||
return $this->service->toggleBendingField($id, $request->input('field'));
|
||||
}, __('message.work_order.bending_toggled'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 이슈 추가
|
||||
*/
|
||||
public function addIssue(WorkOrderIssueRequest $request, int $id)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($request, $id) {
|
||||
return $this->service->addIssue($id, $request->validated());
|
||||
}, __('message.work_order.issue_added'));
|
||||
}
|
||||
|
||||
/**
|
||||
* 이슈 해결
|
||||
*/
|
||||
public function resolveIssue(int $workOrderId, int $issueId)
|
||||
{
|
||||
return ApiResponse::handle(function () use ($workOrderId, $issueId) {
|
||||
return $this->service->resolveIssue($workOrderId, $issueId);
|
||||
}, __('message.work_order.issue_resolved'));
|
||||
}
|
||||
}
|
||||
29
app/Http/Requests/WorkOrder/WorkOrderAssignRequest.php
Normal file
29
app/Http/Requests/WorkOrder/WorkOrderAssignRequest.php
Normal file
@@ -0,0 +1,29 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\WorkOrder;
|
||||
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
|
||||
class WorkOrderAssignRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'assignee_id' => 'required|integer|exists:users,id',
|
||||
'team_id' => 'nullable|integer|exists:departments,id',
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'assignee_id.required' => __('validation.required', ['attribute' => '담당자']),
|
||||
'assignee_id.exists' => __('validation.exists', ['attribute' => '담당자']),
|
||||
];
|
||||
}
|
||||
}
|
||||
31
app/Http/Requests/WorkOrder/WorkOrderIssueRequest.php
Normal file
31
app/Http/Requests/WorkOrder/WorkOrderIssueRequest.php
Normal file
@@ -0,0 +1,31 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\WorkOrder;
|
||||
|
||||
use App\Models\Production\WorkOrderIssue;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class WorkOrderIssueRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'title' => 'required|string|max:200',
|
||||
'description' => 'nullable|string',
|
||||
'priority' => ['nullable', Rule::in(WorkOrderIssue::PRIORITIES)],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'title.required' => __('validation.required', ['attribute' => '이슈 제목']),
|
||||
];
|
||||
}
|
||||
}
|
||||
30
app/Http/Requests/WorkOrder/WorkOrderStatusRequest.php
Normal file
30
app/Http/Requests/WorkOrder/WorkOrderStatusRequest.php
Normal file
@@ -0,0 +1,30 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\WorkOrder;
|
||||
|
||||
use App\Models\Production\WorkOrder;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class WorkOrderStatusRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
'status' => ['required', Rule::in(WorkOrder::STATUSES)],
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'status.required' => __('validation.required', ['attribute' => '상태']),
|
||||
'status.in' => __('validation.in', ['attribute' => '상태']),
|
||||
];
|
||||
}
|
||||
}
|
||||
60
app/Http/Requests/WorkOrder/WorkOrderStoreRequest.php
Normal file
60
app/Http/Requests/WorkOrder/WorkOrderStoreRequest.php
Normal file
@@ -0,0 +1,60 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\WorkOrder;
|
||||
|
||||
use App\Models\Production\WorkOrder;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class WorkOrderStoreRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
// 기본 정보
|
||||
'sales_order_id' => 'nullable|integer|exists:orders,id',
|
||||
'project_name' => 'nullable|string|max:200',
|
||||
'process_type' => ['required', Rule::in(WorkOrder::PROCESS_TYPES)],
|
||||
'status' => ['nullable', Rule::in(WorkOrder::STATUSES)],
|
||||
'assignee_id' => 'nullable|integer|exists:users,id',
|
||||
'team_id' => 'nullable|integer|exists:departments,id',
|
||||
'scheduled_date' => 'nullable|date',
|
||||
'memo' => 'nullable|string',
|
||||
'is_active' => 'nullable|boolean',
|
||||
|
||||
// 품목 배열
|
||||
'items' => 'nullable|array',
|
||||
'items.*.item_id' => 'nullable|integer|exists:items,id',
|
||||
'items.*.item_name' => 'required|string|max:200',
|
||||
'items.*.specification' => 'nullable|string|max:500',
|
||||
'items.*.quantity' => 'nullable|numeric|min:0',
|
||||
'items.*.unit' => 'nullable|string|max:20',
|
||||
|
||||
// 벤딩 상세 (process_type이 bending인 경우)
|
||||
'bending_detail' => 'nullable|array',
|
||||
'bending_detail.shaft_cutting' => 'nullable|boolean',
|
||||
'bending_detail.bearing' => 'nullable|boolean',
|
||||
'bending_detail.shaft_welding' => 'nullable|boolean',
|
||||
'bending_detail.assembly' => 'nullable|boolean',
|
||||
'bending_detail.winder_welding' => 'nullable|boolean',
|
||||
'bending_detail.frame_assembly' => 'nullable|boolean',
|
||||
'bending_detail.bundle_assembly' => 'nullable|boolean',
|
||||
'bending_detail.motor_assembly' => 'nullable|boolean',
|
||||
'bending_detail.bracket_assembly' => 'nullable|boolean',
|
||||
];
|
||||
}
|
||||
|
||||
public function messages(): array
|
||||
{
|
||||
return [
|
||||
'process_type.required' => __('validation.required', ['attribute' => '공정유형']),
|
||||
'process_type.in' => __('validation.in', ['attribute' => '공정유형']),
|
||||
'items.*.item_name.required' => __('validation.required', ['attribute' => '품목명']),
|
||||
];
|
||||
}
|
||||
}
|
||||
51
app/Http/Requests/WorkOrder/WorkOrderUpdateRequest.php
Normal file
51
app/Http/Requests/WorkOrder/WorkOrderUpdateRequest.php
Normal file
@@ -0,0 +1,51 @@
|
||||
<?php
|
||||
|
||||
namespace App\Http\Requests\WorkOrder;
|
||||
|
||||
use App\Models\Production\WorkOrder;
|
||||
use Illuminate\Foundation\Http\FormRequest;
|
||||
use Illuminate\Validation\Rule;
|
||||
|
||||
class WorkOrderUpdateRequest extends FormRequest
|
||||
{
|
||||
public function authorize(): bool
|
||||
{
|
||||
return true;
|
||||
}
|
||||
|
||||
public function rules(): array
|
||||
{
|
||||
return [
|
||||
// 기본 정보
|
||||
'sales_order_id' => 'nullable|integer|exists:orders,id',
|
||||
'project_name' => 'nullable|string|max:200',
|
||||
'process_type' => ['nullable', Rule::in(WorkOrder::PROCESS_TYPES)],
|
||||
'status' => ['nullable', Rule::in(WorkOrder::STATUSES)],
|
||||
'assignee_id' => 'nullable|integer|exists:users,id',
|
||||
'team_id' => 'nullable|integer|exists:departments,id',
|
||||
'scheduled_date' => 'nullable|date',
|
||||
'memo' => 'nullable|string',
|
||||
'is_active' => 'nullable|boolean',
|
||||
|
||||
// 품목 배열 (있으면 전체 교체)
|
||||
'items' => 'nullable|array',
|
||||
'items.*.item_id' => 'nullable|integer|exists:items,id',
|
||||
'items.*.item_name' => 'required|string|max:200',
|
||||
'items.*.specification' => 'nullable|string|max:500',
|
||||
'items.*.quantity' => 'nullable|numeric|min:0',
|
||||
'items.*.unit' => 'nullable|string|max:20',
|
||||
|
||||
// 벤딩 상세
|
||||
'bending_detail' => 'nullable|array',
|
||||
'bending_detail.shaft_cutting' => 'nullable|boolean',
|
||||
'bending_detail.bearing' => 'nullable|boolean',
|
||||
'bending_detail.shaft_welding' => 'nullable|boolean',
|
||||
'bending_detail.assembly' => 'nullable|boolean',
|
||||
'bending_detail.winder_welding' => 'nullable|boolean',
|
||||
'bending_detail.frame_assembly' => 'nullable|boolean',
|
||||
'bending_detail.bundle_assembly' => 'nullable|boolean',
|
||||
'bending_detail.motor_assembly' => 'nullable|boolean',
|
||||
'bending_detail.bracket_assembly' => 'nullable|boolean',
|
||||
];
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user