feat: 단가 관리 API 구현 및 Flow Tester 호환성 개선

- Price, PriceRevision 모델 추가 (PriceHistory 대체)
- PricingService: CRUD, 원가 조회, 확정 기능
- PricingController: statusCode 파라미터로 201 반환 지원
- NotFoundHttpException(404) 적용 (존재하지 않는 리소스)
- FormRequest 분리 (Store, Update, Index, Cost, ByItems)
- Swagger 문서 업데이트
- ApiResponse::handle()에 statusCode 옵션 추가
- prices/price_revisions 마이그레이션 및 데이터 이관

app/Http/Controllers/Api/V1/PricingController.php

@@ -4,93 +4,124 @@
 
 use App\Helpers\ApiResponse;
 use App\Http\Controllers\Controller;
-use App\Services\Pricing\PricingService;
-use Illuminate\Http\Request;
+use App\Http\Requests\Pricing\PriceByItemsRequest;
+use App\Http\Requests\Pricing\PriceCostRequest;
+use App\Http\Requests\Pricing\PriceIndexRequest;
+use App\Http\Requests\Pricing\PriceStoreRequest;
+use App\Http\Requests\Pricing\PriceUpdateRequest;
+use App\Services\PricingService;
 
 class PricingController extends Controller
 {
-    protected PricingService $service;
-
-    public function __construct(PricingService $service)
-    {
-        $this->service = $service;
-    }
+    public function __construct(
+        protected PricingService $service
+    ) {}
 
     /**
-     * 가격 이력 목록 조회
+     * 단가 목록 조회
      */
-    public function index(Request $request)
+    public function index(PriceIndexRequest $request)
     {
         return ApiResponse::handle(function () use ($request) {
-            $filters = $request->only([
-                'item_type_code',
-                'item_id',
-                'price_type_code',
-                'client_group_id',
-                'date',
-            ]);
-            $perPage = (int) ($request->input('size') ?? 15);
-
-            $data = $this->service->listPrices($filters, $perPage);
+            $data = $this->service->index($request->validated());
 
             return ['data' => $data, 'message' => __('message.fetched')];
         });
     }
 
     /**
-     * 단일 항목 가격 조회
+     * 단가 상세 조회
      */
-    public function show(Request $request)
+    public function show(int $id)
     {
-        return ApiResponse::handle(function () use ($request) {
-            $itemType = $request->input('item_type'); // PRODUCT | MATERIAL
-            $itemId = (int) $request->input('item_id');
-            $clientId = $request->input('client_id') ? (int) $request->input('client_id') : null;
-            $date = $request->input('date') ?? null;
+        return ApiResponse::handle(function () use ($id) {
+            $data = $this->service->show($id);
 
-            $result = $this->service->getItemPrice($itemType, $itemId, $clientId, $date);
-
-            return ['data' => $result, 'message' => __('message.fetched')];
+            return ['data' => $data, 'message' => __('message.fetched')];
         });
     }
 
     /**
-     * 여러 항목 일괄 가격 조회
+     * 단가 등록
      */
-    public function bulk(Request $request)
+    public function store(PriceStoreRequest $request)
     {
         return ApiResponse::handle(function () use ($request) {
-            $items = $request->input('items'); // [['item_type' => 'PRODUCT', 'item_id' => 1], ...]
-            $clientId = $request->input('client_id') ? (int) $request->input('client_id') : null;
-            $date = $request->input('date') ?? null;
+            $data = $this->service->store($request->validated());
 
-            $result = $this->service->getBulkItemPrices($items, $clientId, $date);
-
-            return ['data' => $result, 'message' => __('message.fetched')];
+            return ['data' => $data, 'message' => __('message.created'), 'statusCode' => 201];
         });
     }
 
     /**
-     * 가격 등록/수정
+     * 단가 수정
      */
-    public function upsert(Request $request)
+    public function update(PriceUpdateRequest $request, int $id)
     {
-        return ApiResponse::handle(function () use ($request) {
-            $data = $this->service->upsertPrice($request->all());
+        return ApiResponse::handle(function () use ($request, $id) {
+            $data = $this->service->update($id, $request->validated());
 
-            return ['data' => $data, 'message' => __('message.created')];
+            return ['data' => $data, 'message' => __('message.updated')];
         });
     }
 
     /**
-     * 가격 삭제
+     * 단가 삭제
      */
     public function destroy(int $id)
     {
         return ApiResponse::handle(function () use ($id) {
-            $this->service->deletePrice($id);
+            $this->service->destroy($id);
 
             return ['data' => null, 'message' => __('message.deleted')];
         });
     }
+
+    /**
+     * 단가 확정
+     */
+    public function finalize(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $data = $this->service->finalize($id);
+
+            return ['data' => $data, 'message' => __('message.pricing.finalized')];
+        });
+    }
+
+    /**
+     * 품목별 단가 현황 조회
+     */
+    public function byItems(PriceByItemsRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $data = $this->service->byItems($request->validated());
+
+            return ['data' => $data, 'message' => __('message.fetched')];
+        });
+    }
+
+    /**
+     * 변경 이력 조회
+     */
+    public function revisions(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $data = $this->service->revisions($id);
+
+            return ['data' => $data, 'message' => __('message.fetched')];
+        });
+    }
+
+    /**
+     * 원가 조회 (수입검사 > 표준원가 fallback)
+     */
+    public function cost(PriceCostRequest $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $data = $this->service->getCost($request->validated());
+
+            return ['data' => $data, 'message' => __('message.fetched')];
+        });
+    }
 }