feat: I-4 거래통장 조회 API 구현

- BankTransactionController: 은행 거래내역 조회 API - BankTransactionService: 은행 거래 조회 로직 - Swagger 문서화 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-26 15:47:03 +09:00
parent e7862ed6e6
commit 2aa1d78e62
3 changed files with 543 additions and 0 deletions
--- a/app/Http/Controllers/Api/V1/BankTransactionController.php
+++ b/app/Http/Controllers/Api/V1/BankTransactionController.php
@@ -0,0 +1,66 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Helpers\ApiResponse;
+use App\Http\Controllers\Controller;
+use App\Services\BankTransactionService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+/**
+ * 은행 거래 (입출금 통합) 조회 컨트롤러
+ */
+class BankTransactionController extends Controller
+{
+    public function __construct(
+        protected BankTransactionService $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',
+                'bank_account_id' => 'nullable|integer',
+                'transaction_type' => 'nullable|string|max:50',
+                'search' => 'nullable|string|max:100',
+                'sort_by' => 'nullable|in:transaction_date,amount',
+                '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 accounts(): JsonResponse
+    {
+        return ApiResponse::handle(function () {
+            return $this->service->getAccountOptions();
+        }, __('message.fetched'));
+    }
+}