feat: I-3 법인카드 사용내역 API 구현

- CardTransactionController: 카드 거래내역 조회 API - CardTransactionService: 카드 거래 조회 로직 - Withdrawal 모델 카드 필드 확장 - Swagger 문서화 - withdrawals 테이블 카드 필드 마이그레이션 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-26 15:46:48 +09:00
parent dced7b7fd3
commit e7862ed6e6
5 changed files with 624 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/CardTransactionController.php
+++ b/app/Http/Controllers/Api/V1/CardTransactionController.php
@@ -0,0 +1,92 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Services\CardTransactionService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+/**
+ * 카드 거래 조회 컨트롤러
+ */
+class CardTransactionController extends Controller
+{
+    public function __construct(
+        protected CardTransactionService $service
+    ) {}
+
+    /**
+     * 카드 거래 목록 조회
+     */
+    public function index(Request $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $params = $request->validate([
+                'start_date' => 'nullable|date',
+                'end_date' => 'nullable|date|after_or_equal:start_date',
+                'card_id' => 'nullable|integer',
+                'search' => 'nullable|string|max:100',
+                'sort_by' => 'nullable|in:used_at,amount,merchant_name,created_at',
+                'sort_dir' => 'nullable|in:asc,desc',
+                'per_page' => 'nullable|integer|min:1|max:100',
+                'page' => 'nullable|integer|min:1',
+            ]);
+
+            return $this->service->index($params);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 카드 거래 요약 통계
+     */
+    public function summary(Request $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $params = $request->validate([
+                'start_date' => 'nullable|date',
+                'end_date' => 'nullable|date|after_or_equal:start_date',
+            ]);
+
+            return $this->service->summary($params);
+        }, __('message.fetched'));
+    }
+
+    /**
+     * 계정과목 일괄 수정
+     */
+    public function bulkUpdateAccountCode(Request $request): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($request) {
+            $validated = $request->validate([
+                'ids' => 'required|array|min:1',
+                'ids.*' => 'required|integer',
+                'account_code' => 'required|string|max:20',
+            ]);
+
+            $updatedCount = $this->service->bulkUpdateAccountCode(
+                $validated['ids'],
+                $validated['account_code']
+            );
+
+            return ['updated_count' => $updatedCount];
+        }, __('message.updated'));
+    }
+
+    /**
+     * 단일 카드 거래 조회
+     */
+    public function show(int $id): JsonResponse
+    {
+        return ApiResponse::handle(function () use ($id) {
+            $transaction = $this->service->show($id);
+
+            if (! $transaction) {
+                throw new \Illuminate\Database\Eloquent\ModelNotFoundException;
+            }
+
+            return $transaction;
+        }, __('message.fetched'));
+    }
+}