feat: 2.4 입금/출금 관리 API 구현

- 마이그레이션: deposits, withdrawals 테이블 생성 - 모델: Deposit, Withdrawal (BelongsToTenant, SoftDeletes) - 서비스: DepositService, WithdrawalService (CRUD + summary) - 컨트롤러: DepositController, WithdrawalController - FormRequest: Store/Update 검증 클래스 - Swagger: 입금/출금 API 문서 (12개 엔드포인트) - 라우트: /v1/deposits, /v1/withdrawals 등록
2025-12-17 21:47:15 +09:00
parent e1b0c99d5d
commit 17799c47de
15 changed files with 1756 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/DepositController.php
+++ b/app/Http/Controllers/Api/V1/DepositController.php
@@ -0,0 +1,97 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\V1\Deposit\StoreDepositRequest;
+use App\Http\Requests\V1\Deposit\UpdateDepositRequest;
+use App\Http\Responses\ApiResponse;
+use App\Services\DepositService;
+use Illuminate\Http\Request;
+
+class DepositController extends Controller
+{
+    public function __construct(
+        private readonly DepositService $service
+    ) {}
+
+    /**
+     * 입금 목록
+     */
+    public function index(Request $request)
+    {
+        $params = $request->only([
+            'search',
+            'start_date',
+            'end_date',
+            'client_id',
+            'payment_method',
+            'bank_account_id',
+            'sort_by',
+            'sort_dir',
+            'per_page',
+            'page',
+        ]);
+
+        $deposits = $this->service->index($params);
+
+        return ApiResponse::handle(__('message.fetched'), $deposits);
+    }
+
+    /**
+     * 입금 등록
+     */
+    public function store(StoreDepositRequest $request)
+    {
+        $deposit = $this->service->store($request->validated());
+
+        return ApiResponse::handle(__('message.created'), $deposit, 201);
+    }
+
+    /**
+     * 입금 상세
+     */
+    public function show(int $id)
+    {
+        $deposit = $this->service->show($id);
+
+        return ApiResponse::handle(__('message.fetched'), $deposit);
+    }
+
+    /**
+     * 입금 수정
+     */
+    public function update(int $id, UpdateDepositRequest $request)
+    {
+        $deposit = $this->service->update($id, $request->validated());
+
+        return ApiResponse::handle(__('message.updated'), $deposit);
+    }
+
+    /**
+     * 입금 삭제
+     */
+    public function destroy(int $id)
+    {
+        $this->service->destroy($id);
+
+        return ApiResponse::handle(__('message.deleted'));
+    }
+
+    /**
+     * 입금 요약 (기간별 합계)
+     */
+    public function summary(Request $request)
+    {
+        $params = $request->only([
+            'start_date',
+            'end_date',
+            'client_id',
+            'payment_method',
+        ]);
+
+        $summary = $this->service->summary($params);
+
+        return ApiResponse::handle(__('message.fetched'), $summary);
+    }
+}
--- a/app/Http/Controllers/Api/V1/WithdrawalController.php
+++ b/app/Http/Controllers/Api/V1/WithdrawalController.php
@@ -0,0 +1,97 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\V1\Withdrawal\StoreWithdrawalRequest;
+use App\Http\Requests\V1\Withdrawal\UpdateWithdrawalRequest;
+use App\Http\Responses\ApiResponse;
+use App\Services\WithdrawalService;
+use Illuminate\Http\Request;
+
+class WithdrawalController extends Controller
+{
+    public function __construct(
+        private readonly WithdrawalService $service
+    ) {}
+
+    /**
+     * 출금 목록
+     */
+    public function index(Request $request)
+    {
+        $params = $request->only([
+            'search',
+            'start_date',
+            'end_date',
+            'client_id',
+            'payment_method',
+            'bank_account_id',
+            'sort_by',
+            'sort_dir',
+            'per_page',
+            'page',
+        ]);
+
+        $withdrawals = $this->service->index($params);
+
+        return ApiResponse::handle(__('message.fetched'), $withdrawals);
+    }
+
+    /**
+     * 출금 등록
+     */
+    public function store(StoreWithdrawalRequest $request)
+    {
+        $withdrawal = $this->service->store($request->validated());
+
+        return ApiResponse::handle(__('message.created'), $withdrawal, 201);
+    }
+
+    /**
+     * 출금 상세
+     */
+    public function show(int $id)
+    {
+        $withdrawal = $this->service->show($id);
+
+        return ApiResponse::handle(__('message.fetched'), $withdrawal);
+    }
+
+    /**
+     * 출금 수정
+     */
+    public function update(int $id, UpdateWithdrawalRequest $request)
+    {
+        $withdrawal = $this->service->update($id, $request->validated());
+
+        return ApiResponse::handle(__('message.updated'), $withdrawal);
+    }
+
+    /**
+     * 출금 삭제
+     */
+    public function destroy(int $id)
+    {
+        $this->service->destroy($id);
+
+        return ApiResponse::handle(__('message.deleted'));
+    }
+
+    /**
+     * 출금 요약 (기간별 합계)
+     */
+    public function summary(Request $request)
+    {
+        $params = $request->only([
+            'start_date',
+            'end_date',
+            'client_id',
+            'payment_method',
+        ]);
+
+        $summary = $this->service->summary($params);
+
+        return ApiResponse::handle(__('message.fetched'), $summary);
+    }
+}