feat: 2.3 카드/계좌 관리 API 구현

- cards, bank_accounts 테이블 마이그레이션 - Card, BankAccount 모델 (카드번호 암호화) - CardService, BankAccountService - CardController, BankAccountController + FormRequest 4개 - API 엔드포인트 15개 (카드 7개, 계좌 8개) - Swagger 문서 (CardApi.php, BankAccountApi.php)
2025-12-17 21:02:20 +09:00
parent a1980adb20
commit e1b0c99d5d
15 changed files with 1916 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/BankAccountController.php
+++ b/app/Http/Controllers/Api/V1/BankAccountController.php
@@ -0,0 +1,108 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\V1\BankAccount\StoreBankAccountRequest;
+use App\Http\Requests\V1\BankAccount\UpdateBankAccountRequest;
+use App\Http\Responses\ApiResponse;
+use App\Services\BankAccountService;
+use Illuminate\Http\Request;
+
+class BankAccountController extends Controller
+{
+    public function __construct(
+        private readonly BankAccountService $service
+    ) {}
+
+    /**
+     * 계좌 목록
+     */
+    public function index(Request $request)
+    {
+        $params = $request->only([
+            'search',
+            'status',
+            'assigned_user_id',
+            'is_primary',
+            'sort_by',
+            'sort_dir',
+            'per_page',
+            'page',
+        ]);
+
+        $accounts = $this->service->index($params);
+
+        return ApiResponse::handle(__('message.fetched'), $accounts);
+    }
+
+    /**
+     * 계좌 등록
+     */
+    public function store(StoreBankAccountRequest $request)
+    {
+        $account = $this->service->store($request->validated());
+
+        return ApiResponse::handle(__('message.created'), $account, 201);
+    }
+
+    /**
+     * 계좌 상세
+     */
+    public function show(int $id)
+    {
+        $account = $this->service->show($id);
+
+        return ApiResponse::handle(__('message.fetched'), $account);
+    }
+
+    /**
+     * 계좌 수정
+     */
+    public function update(int $id, UpdateBankAccountRequest $request)
+    {
+        $account = $this->service->update($id, $request->validated());
+
+        return ApiResponse::handle(__('message.updated'), $account);
+    }
+
+    /**
+     * 계좌 삭제
+     */
+    public function destroy(int $id)
+    {
+        $this->service->destroy($id);
+
+        return ApiResponse::handle(__('message.deleted'));
+    }
+
+    /**
+     * 계좌 상태 토글 (사용/정지)
+     */
+    public function toggle(int $id)
+    {
+        $account = $this->service->toggleStatus($id);
+
+        return ApiResponse::handle(__('message.updated'), $account);
+    }
+
+    /**
+     * 대표계좌 설정
+     */
+    public function setPrimary(int $id)
+    {
+        $account = $this->service->setPrimary($id);
+
+        return ApiResponse::handle(__('message.updated'), $account);
+    }
+
+    /**
+     * 활성 계좌 목록 (셀렉트박스용)
+     */
+    public function active()
+    {
+        $accounts = $this->service->getActiveAccounts();
+
+        return ApiResponse::handle(__('message.fetched'), $accounts);
+    }
+}
--- a/app/Http/Controllers/Api/V1/CardController.php
+++ b/app/Http/Controllers/Api/V1/CardController.php
@@ -0,0 +1,97 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\V1\Card\StoreCardRequest;
+use App\Http\Requests\V1\Card\UpdateCardRequest;
+use App\Http\Responses\ApiResponse;
+use App\Services\CardService;
+use Illuminate\Http\Request;
+
+class CardController extends Controller
+{
+    public function __construct(
+        private readonly CardService $service
+    ) {}
+
+    /**
+     * 카드 목록
+     */
+    public function index(Request $request)
+    {
+        $params = $request->only([
+            'search',
+            'status',
+            'assigned_user_id',
+            'sort_by',
+            'sort_dir',
+            'per_page',
+            'page',
+        ]);
+
+        $cards = $this->service->index($params);
+
+        return ApiResponse::handle(__('message.fetched'), $cards);
+    }
+
+    /**
+     * 카드 등록
+     */
+    public function store(StoreCardRequest $request)
+    {
+        $card = $this->service->store($request->validated());
+
+        return ApiResponse::handle(__('message.created'), $card, 201);
+    }
+
+    /**
+     * 카드 상세
+     */
+    public function show(int $id)
+    {
+        $card = $this->service->show($id);
+
+        return ApiResponse::handle(__('message.fetched'), $card);
+    }
+
+    /**
+     * 카드 수정
+     */
+    public function update(int $id, UpdateCardRequest $request)
+    {
+        $card = $this->service->update($id, $request->validated());
+
+        return ApiResponse::handle(__('message.updated'), $card);
+    }
+
+    /**
+     * 카드 삭제
+     */
+    public function destroy(int $id)
+    {
+        $this->service->destroy($id);
+
+        return ApiResponse::handle(__('message.deleted'));
+    }
+
+    /**
+     * 카드 상태 토글 (사용/정지)
+     */
+    public function toggle(int $id)
+    {
+        $card = $this->service->toggleStatus($id);
+
+        return ApiResponse::handle(__('message.updated'), $card);
+    }
+
+    /**
+     * 활성 카드 목록 (셀렉트박스용)
+     */
+    public function active()
+    {
+        $cards = $this->service->getActiveCards();
+
+        return ApiResponse::handle(__('message.fetched'), $cards);
+    }
+}