feat: I-1 미지급비용 관리 API 개발

- ExpectedExpense 모델 및 마이그레이션 생성 - ExpectedExpenseService 구현 (CRUD, 일괄삭제, 지급일 변경, 요약) - ExpectedExpenseController REST API 구현 - FormRequest 검증 클래스 3개 생성 - Swagger API 문서 작성 - 라우트 추가 (8개 엔드포인트) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-26 13:23:07 +09:00
parent 0fef26f42a
commit 1f5539db32
9 changed files with 1097 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/ExpectedExpenseController.php
+++ b/app/Http/Controllers/Api/V1/ExpectedExpenseController.php
@@ -0,0 +1,127 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Http\Requests\V1\ExpectedExpense\StoreExpectedExpenseRequest;
+use App\Http\Requests\V1\ExpectedExpense\UpdateExpectedExpenseRequest;
+use App\Http\Requests\V1\ExpectedExpense\UpdateExpectedPaymentDateRequest;
+use App\Services\ExpectedExpenseService;
+use Illuminate\Http\Request;
+
+class ExpectedExpenseController extends Controller
+{
+    public function __construct(
+        private readonly ExpectedExpenseService $service
+    ) {}
+
+    /**
+     * 미지급비용 목록
+     */
+    public function index(Request $request)
+    {
+        $params = $request->only([
+            'search',
+            'start_date',
+            'end_date',
+            'client_id',
+            'transaction_type',
+            'payment_status',
+            'approval_status',
+            'sort_by',
+            'sort_dir',
+            'per_page',
+            'page',
+        ]);
+
+        $expenses = $this->service->index($params);
+
+        return ApiResponse::success($expenses, __('message.fetched'));
+    }
+
+    /**
+     * 미지급비용 등록
+     */
+    public function store(StoreExpectedExpenseRequest $request)
+    {
+        $expense = $this->service->store($request->validated());
+
+        return ApiResponse::success($expense, __('message.created'), [], 201);
+    }
+
+    /**
+     * 미지급비용 상세
+     */
+    public function show(int $id)
+    {
+        $expense = $this->service->show($id);
+
+        return ApiResponse::success($expense, __('message.fetched'));
+    }
+
+    /**
+     * 미지급비용 수정
+     */
+    public function update(int $id, UpdateExpectedExpenseRequest $request)
+    {
+        $expense = $this->service->update($id, $request->validated());
+
+        return ApiResponse::success($expense, __('message.updated'));
+    }
+
+    /**
+     * 미지급비용 삭제
+     */
+    public function destroy(int $id)
+    {
+        $this->service->destroy($id);
+
+        return ApiResponse::success(null, __('message.deleted'));
+    }
+
+    /**
+     * 미지급비용 일괄 삭제
+     */
+    public function destroyMany(Request $request)
+    {
+        $ids = $request->input('ids', []);
+
+        if (empty($ids)) {
+            return ApiResponse::error(__('error.no_ids_provided'), 400);
+        }
+
+        $count = $this->service->destroyMany($ids);
+
+        return ApiResponse::success(['deleted_count' => $count], __('message.deleted'));
+    }
+
+    /**
+     * 예상 지급일 일괄 변경
+     */
+    public function updateExpectedPaymentDate(UpdateExpectedPaymentDateRequest $request)
+    {
+        $count = $this->service->updateExpectedPaymentDate(
+            $request->input('ids'),
+            $request->input('expected_payment_date')
+        );
+
+        return ApiResponse::success(['updated_count' => $count], __('message.updated'));
+    }
+
+    /**
+     * 미지급비용 요약 (기간별 합계)
+     */
+    public function summary(Request $request)
+    {
+        $params = $request->only([
+            'start_date',
+            'end_date',
+            'payment_status',
+        ]);
+
+        $summary = $this->service->summary($params);
+
+        return ApiResponse::success($summary, __('message.fetched'));
+    }
+}