feat: ClientGroup 및 Pricing API 완성 및 Swagger 문서 작성

- ClientGroupService 구현: 고객 그룹 관리 비즈니스 로직 (CRUD + toggle)
- ClientGroupController 구현: 6개 REST API 엔드포인트
- PricingController 구현: 5개 가격 관리 API 엔드포인트
- routes/api.php에 client-groups, pricing 라우트 등록
- ClientGroupApi.php Swagger 문서 작성 (OpenAPI 3.0)
- PricingApi.php Swagger 문서 작성 (OpenAPI 3.0)
- l5-swagger 재생성 완료

추가된 파일:
- app/Services/ClientGroupService.php
- app/Http/Controllers/Api/V1/ClientGroupController.php
- app/Http/Controllers/Api/V1/PricingController.php
- app/Swagger/v1/ClientGroupApi.php
- app/Swagger/v1/PricingApi.php

수정된 파일:
- routes/api.php (라우트 11개 추가)
- CURRENT_WORKS.md (작업 내용 문서화)

API 엔드포인트:
- GET/POST/PUT/DELETE /api/v1/client-groups
- GET/POST /api/v1/pricing (show, bulk, upsert 포함)

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

@@ -0,0 +1,72 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Services\ClientGroupService;
+use Illuminate\Http\Request;
+
+class ClientGroupController extends Controller
+{
+    protected ClientGroupService $service;
+
+    public function __construct(ClientGroupService $service)
+    {
+        $this->service = $service;
+    }
+
+    public function index(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $data = $this->service->index($request->all());
+
+            return ['data' => $data, 'message' => __('message.fetched')];
+        });
+    }
+
+    public function show(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $data = $this->service->show($id);
+
+            return ['data' => $data, 'message' => __('message.fetched')];
+        });
+    }
+
+    public function store(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $data = $this->service->store($request->all());
+
+            return ['data' => $data, 'message' => __('message.created')];
+        });
+    }
+
+    public function update(Request $request, int $id)
+    {
+        return ApiResponse::handle(function () use ($request, $id) {
+            $data = $this->service->update($id, $request->all());
+
+            return ['data' => $data, 'message' => __('message.updated')];
+        });
+    }
+
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->destroy($id);
+
+            return ['data' => null, 'message' => __('message.deleted')];
+        });
+    }
+
+    public function toggle(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $data = $this->service->toggle($id);
+
+            return ['data' => $data, 'message' => __('message.updated')];
+        });
+    }
+}

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

@@ -0,0 +1,96 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Services\Pricing\PricingService;
+use Illuminate\Http\Request;
+
+class PricingController extends Controller
+{
+    protected PricingService $service;
+
+    public function __construct(PricingService $service)
+    {
+        $this->service = $service;
+    }
+
+    /**
+     * 가격 이력 목록 조회
+     */
+    public function index(Request $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);
+
+            return ['data' => $data, 'message' => __('message.fetched')];
+        });
+    }
+
+    /**
+     * 단일 항목 가격 조회
+     */
+    public function show(Request $request)
+    {
+        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;
+
+            $result = $this->service->getItemPrice($itemType, $itemId, $clientId, $date);
+
+            return ['data' => $result, 'message' => __('message.fetched')];
+        });
+    }
+
+    /**
+     * 여러 항목 일괄 가격 조회
+     */
+    public function bulk(Request $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;
+
+            $result = $this->service->getBulkItemPrices($items, $clientId, $date);
+
+            return ['data' => $result, 'message' => __('message.fetched')];
+        });
+    }
+
+    /**
+     * 가격 등록/수정
+     */
+    public function upsert(Request $request)
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $data = $this->service->upsertPrice($request->all());
+
+            return ['data' => $data, 'message' => __('message.created')];
+        });
+    }
+
+    /**
+     * 가격 삭제
+     */
+    public function destroy(int $id)
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $this->service->deletePrice($id);
+
+            return ['data' => null, 'message' => __('message.deleted')];
+        });
+    }
+}