feat: P6 외부연동 어댑터 모듈 PoC (펌뱅킹/SMS·카카오)

신규 모듈 ga-external-adapter — 외부 SDK 의존성을 격리. 실제 SDK 통합 시 이 모듈의 구현체만 교체하면 ga-api/ga-common 무변경. - ga-common.adapter.bank: BankTransferAdapter 인터페이스 + Request/Response/Status - ga-common.adapter.message: MessageAdapter 인터페이스 + Channel(SMS/KAKAO)/Request/Response - ga-external-adapter: MockBankTransferAdapter / MockMessageAdapter (로그 + 마스킹) - V82: withdraw_request.transfer_tx_id/transfer_status/transfer_at + 부분 인덱스 - ApprovalService.handleApprovalCallback(WITHDRAW) — 최종 승인 시 펌뱅킹 어댑터 호출 - 성공: status APPROVED → SENT 전이, transfer_tx_id 영속화 - 실패: APPROVED 유지 + fail_reason 기록 (재시도 배치는 추후) - ApprovalService.sendStepNotification — DB 알림 외 SMS 어댑터 호출 (non-critical) - WithdrawRequestMapper.updateTransferResult 추가
2026-05-24 02:10:06 +09:00
parent c005ad705a
commit b04fa79840
17 changed files with 332 additions and 3 deletions
@@ -0,0 +1,57 @@
+package com.ga.external.bank;
+
+import com.ga.common.adapter.bank.BankTransferAdapter;
+import com.ga.common.adapter.bank.BankTransferRequest;
+import com.ga.common.adapter.bank.BankTransferResponse;
+import com.ga.common.adapter.bank.BankTransferStatus;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.time.LocalDateTime;
+import java.util.UUID;
+
+/**
+ * 펌뱅킹 Mock 구현.
+ * <p>
+ * 실제 KFTC/은행 SDK 가 들어오기 전까지 사용. 결과는 항상 ACCEPTED 반환 + 로그.
+ * 계좌번호는 뒷 4자리 외 마스킹해 로그에 남긴다.
+ */
+@Slf4j
+@Component
+public class MockBankTransferAdapter implements BankTransferAdapter {
+
+    @Override
+    public BankTransferResponse requestTransfer(BankTransferRequest request) {
+        String masked = maskAccount(request.getAccountNo());
+        String txId = "MOCK-" + UUID.randomUUID();
+        log.info("[MOCK BANK] requestTransfer withdrawId={} bank={} acc={} amount={} txId={}",
+                request.getWithdrawRequestId(), request.getBankCode(), masked, request.getAmount(), txId);
+
+        return BankTransferResponse.builder()
+                .txId(txId)
+                .status(BankTransferStatus.ACCEPTED)
+                .resultCode("0000")
+                .resultMessage("MOCK accepted")
+                .processedAt(LocalDateTime.now())
+                .build();
+    }
+
+    @Override
+    public BankTransferResponse queryStatus(String txId) {
+        log.info("[MOCK BANK] queryStatus txId={}", txId);
+        return BankTransferResponse.builder()
+                .txId(txId)
+                .status(BankTransferStatus.SETTLED)
+                .resultCode("0000")
+                .resultMessage("MOCK settled")
+                .processedAt(LocalDateTime.now())
+                .build();
+    }
+
+    private String maskAccount(String accountNo) {
+        if (accountNo == null) return null;
+        String digits = accountNo.replaceAll("[^0-9]", "");
+        if (digits.length() <= 4) return "****";
+        return "****" + digits.substring(digits.length() - 4);
+    }
+}