feat: 수주관리(Order Management) API Phase 1.1 구현

- OrderService 구현 (index, stats, show, store, update, destroy, updateStatus) - OrderController 구현 (7개 API 엔드포인트) - FormRequest 클래스 3개 생성 (Store, Update, UpdateStatus) - 상태 전환 규칙 검증 (DRAFT → CONFIRMED → IN_PROGRESS → COMPLETED/CANCELLED) - 수주번호 자동 생성 (ORD{YYYYMMDD}{0001} 형식) - Swagger API 문서 작성 (OrderApi.php) - i18n 메시지 키 추가 (ko/en) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-08 11:11:54 +09:00
parent 62203a19bd
commit de19ac97aa
12 changed files with 1041 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/OrderController.php
+++ b/app/Http/Controllers/Api/V1/OrderController.php
@@ -0,0 +1,88 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Order\StoreOrderRequest;
+use App\Http\Requests\Order\UpdateOrderRequest;
+use App\Http\Requests\Order\UpdateOrderStatusRequest;
+use App\Services\OrderService;
+use Illuminate\Http\Request;
+
+class OrderController extends Controller
+{
+    public function __construct(private OrderService $service) {}
+
+    /**
+     * 목록 조회
+     */
+    public function index(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->index($request->all());
+        }, __('message.order.fetched'));
+    }
+
+    /**
+     * 통계 조회
+     */
+    public function stats()
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->stats();
+        }, __('message.order.fetched'));
+    }
+
+    /**
+     * 단건 조회
+     */
+    public function show(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            return $this->service->show($id);
+        }, __('message.order.fetched'));
+    }
+
+    /**
+     * 생성
+     */
+    public function store(StoreOrderRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            return $this->service->store($request->validated());
+        }, __('message.order.created'));
+    }
+
+    /**
+     * 수정
+     */
+    public function update(UpdateOrderRequest $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            return $this->service->update($id, $request->validated());
+        }, __('message.order.updated'));
+    }
+
+    /**
+     * 삭제
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return 'success';
+        }, __('message.order.deleted'));
+    }
+
+    /**
+     * 상태 변경
+     */
+    public function updateStatus(UpdateOrderStatusRequest $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            return $this->service->updateStatus($id, $request->validated()['status']);
+        }, __('message.order.status_updated'));
+    }
+}
--- a/app/Http/Requests/Order/StoreOrderRequest.php
+++ b/app/Http/Requests/Order/StoreOrderRequest.php
@@ -0,0 +1,71 @@
+<?php
+
+namespace App\Http\Requests\Order;
+
+use App\Models\Orders\Order;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class StoreOrderRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            // 기본 정보
+            'quote_id' => 'nullable|integer|exists:quotes,id',
+            'order_type_code' => ['nullable', Rule::in([Order::TYPE_ORDER, Order::TYPE_PURCHASE])],
+            'status_code' => ['nullable', Rule::in([
+                Order::STATUS_DRAFT,
+                Order::STATUS_CONFIRMED,
+            ])],
+            'category_code' => 'nullable|string|max:50',
+
+            // 거래처 정보
+            'client_id' => 'nullable|integer|exists:clients,id',
+            'client_name' => 'nullable|string|max:200',
+            'client_contact' => 'nullable|string|max:100',
+            'site_name' => 'nullable|string|max:200',
+
+            // 금액 정보
+            'supply_amount' => 'nullable|numeric|min:0',
+            'tax_amount' => 'nullable|numeric|min:0',
+            'total_amount' => 'nullable|numeric|min:0',
+            'discount_rate' => 'nullable|numeric|min:0|max:100',
+            'discount_amount' => 'nullable|numeric|min:0',
+
+            // 배송/기타
+            'delivery_date' => 'nullable|date',
+            'delivery_method_code' => 'nullable|string|max:50',
+            'received_at' => 'nullable|date',
+            'memo' => 'nullable|string',
+            'remarks' => 'nullable|string',
+            'note' => 'nullable|string',
+
+            // 품목 배열
+            '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' => 'required|numeric|min:0',
+            'items.*.unit' => 'nullable|string|max:20',
+            'items.*.unit_price' => 'required|numeric|min:0',
+            'items.*.supply_amount' => 'nullable|numeric|min:0',
+            'items.*.tax_amount' => 'nullable|numeric|min:0',
+            'items.*.total_amount' => 'nullable|numeric|min:0',
+        ];
+    }
+
+    public function messages(): array
+    {
+        return [
+            'items.*.item_name.required' => __('validation.required', ['attribute' => '품목명']),
+            'items.*.quantity.required' => __('validation.required', ['attribute' => '수량']),
+            'items.*.unit_price.required' => __('validation.required', ['attribute' => '단가']),
+        ];
+    }
+}
--- a/app/Http/Requests/Order/UpdateOrderRequest.php
+++ b/app/Http/Requests/Order/UpdateOrderRequest.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Http\Requests\Order;
+
+use App\Models\Orders\Order;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class UpdateOrderRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            // 기본 정보 (order_no는 수정 불가)
+            'order_type_code' => ['nullable', Rule::in([Order::TYPE_ORDER, Order::TYPE_PURCHASE])],
+            'category_code' => 'nullable|string|max:50',
+
+            // 거래처 정보
+            'client_id' => 'nullable|integer|exists:clients,id',
+            'client_name' => 'nullable|string|max:200',
+            'client_contact' => 'nullable|string|max:100',
+            'site_name' => 'nullable|string|max:200',
+
+            // 금액 정보
+            'supply_amount' => 'nullable|numeric|min:0',
+            'tax_amount' => 'nullable|numeric|min:0',
+            'total_amount' => 'nullable|numeric|min:0',
+            'discount_rate' => 'nullable|numeric|min:0|max:100',
+            'discount_amount' => 'nullable|numeric|min:0',
+
+            // 배송/기타
+            'delivery_date' => 'nullable|date',
+            'delivery_method_code' => 'nullable|string|max:50',
+            'received_at' => 'nullable|date',
+            'memo' => 'nullable|string',
+            'remarks' => 'nullable|string',
+            'note' => 'nullable|string',
+
+            // 품목 배열 (전체 교체)
+            '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' => 'required|numeric|min:0',
+            'items.*.unit' => 'nullable|string|max:20',
+            'items.*.unit_price' => 'required|numeric|min:0',
+            'items.*.supply_amount' => 'nullable|numeric|min:0',
+            'items.*.tax_amount' => 'nullable|numeric|min:0',
+            'items.*.total_amount' => 'nullable|numeric|min:0',
+        ];
+    }
+
+    public function messages(): array
+    {
+        return [
+            'items.*.item_name.required' => __('validation.required', ['attribute' => '품목명']),
+            'items.*.quantity.required' => __('validation.required', ['attribute' => '수량']),
+            'items.*.unit_price.required' => __('validation.required', ['attribute' => '단가']),
+        ];
+    }
+}
--- a/app/Http/Requests/Order/UpdateOrderStatusRequest.php
+++ b/app/Http/Requests/Order/UpdateOrderStatusRequest.php
@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Http\Requests\Order;
+
+use App\Models\Orders\Order;
+use Illuminate\Foundation\Http\FormRequest;
+use Illuminate\Validation\Rule;
+
+class UpdateOrderStatusRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'status' => ['required', Rule::in([
+                Order::STATUS_DRAFT,
+                Order::STATUS_CONFIRMED,
+                Order::STATUS_IN_PROGRESS,
+                Order::STATUS_COMPLETED,
+                Order::STATUS_CANCELLED,
+            ])],
+        ];
+    }
+
+    public function messages(): array
+    {
+        return [
+            'status.required' => __('validation.required', ['attribute' => '상태']),
+            'status.in' => __('validation.in', ['attribute' => '상태']),
+        ];
+    }
+}