detail(@PathVariable Long logId) {
+ return ApiResponse.ok(service.detail(logId));
+ }
+}
diff --git a/ga-api/src/main/java/com/ga/api/service/external/ExternalCallLogService.java b/ga-api/src/main/java/com/ga/api/service/external/ExternalCallLogService.java
new file mode 100644
index 0000000..724562d
--- /dev/null
+++ b/ga-api/src/main/java/com/ga/api/service/external/ExternalCallLogService.java
@@ -0,0 +1,43 @@
+package com.ga.api.service.external;
+
+import com.ga.common.model.PageResponse;
+import com.ga.core.mapper.external.ExternalCallLogMapper;
+import com.ga.core.vo.external.ExternalCallLogResp;
+import com.ga.core.vo.external.ExternalCallLogSearchParam;
+import com.ga.core.vo.external.ExternalCallLogVO;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Propagation;
+import org.springframework.transaction.annotation.Transactional;
+
+/**
+ * 외부 연동 호출 감사 이력.
+ *
+ * {@link #recordCall} 은 AOP({@link com.ga.api.aop.ExternalCallLoggingAspect})에서 호출된다.
+ * 호출자 트랜잭션 롤백과 무관하게 영속화돼야 하므로 {@link Propagation#REQUIRES_NEW}.
+ */
+@Slf4j
+@Service
+@RequiredArgsConstructor
+public class ExternalCallLogService {
+
+ private final ExternalCallLogMapper mapper;
+
+ /** AOP에서 호출. 호출자 트랜잭션과 분리(REQUIRES_NEW). */
+ @Transactional(propagation = Propagation.REQUIRES_NEW)
+ public void recordCall(ExternalCallLogVO vo) {
+ mapper.insertOne(vo);
+ }
+
+ @Transactional(readOnly = true)
+ public PageResponse list(ExternalCallLogSearchParam param) {
+ param.startPage();
+ return PageResponse.of(mapper.selectList(param));
+ }
+
+ @Transactional(readOnly = true)
+ public ExternalCallLogResp detail(Long logId) {
+ return mapper.selectById(logId);
+ }
+}
diff --git a/ga-common/src/main/resources/db/migration/V85__외부연동_호출이력.sql b/ga-common/src/main/resources/db/migration/V85__외부연동_호출이력.sql
new file mode 100644
index 0000000..199e500
--- /dev/null
+++ b/ga-common/src/main/resources/db/migration/V85__외부연동_호출이력.sql
@@ -0,0 +1,85 @@
+-- V85: 외부 연동(펌뱅킹/SMS·카카오) 호출 감사 이력
+--
+-- 목적: BankTransferAdapter / MessageAdapter 모든 호출을 자동 영속화.
+-- 운영 감사·장애 추적·외부 SDK 통합 검증에 사용. AOP(@Around)가 INSERT.
+-- PII 는 요약 필드에 어댑터에서 이미 마스킹된 값만 들어간다 (계좌·전화 뒤 4자리만).
+
+CREATE TABLE IF NOT EXISTS external_call_log (
+ log_id BIGSERIAL PRIMARY KEY,
+ call_type VARCHAR(20) NOT NULL, -- BANK / MESSAGE
+ adapter_class VARCHAR(200) NOT NULL, -- 실제 호출된 구현체 (Mock/Kftc/Toast)
+ method_name VARCHAR(50) NOT NULL, -- requestTransfer / queryStatus / send
+ target_ref_type VARCHAR(30), -- WITHDRAW / APPROVAL 등 (가능 시)
+ target_ref_id BIGINT, -- withdrawRequestId / refId 등
+ request_summary TEXT, -- 요청 요약 (마스킹된 JSON 한 줄)
+ response_summary TEXT, -- 응답 요약
+ result_code VARCHAR(20), -- 외부 응답 코드 (정상 시)
+ result_message TEXT,
+ success BOOLEAN NOT NULL DEFAULT TRUE,
+ duration_ms INTEGER, -- 호출 소요 시간 (ms)
+ error_class VARCHAR(200), -- 예외 발생 시 클래스명
+ error_message TEXT, -- 예외 메시지
+ called_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+ created_by BIGINT -- 시도자 (가능 시)
+);
+
+COMMENT ON TABLE external_call_log IS '외부 연동 호출 감사 이력 (AOP 자동 영속화)';
+COMMENT ON COLUMN external_call_log.call_type IS 'BANK / MESSAGE';
+COMMENT ON COLUMN external_call_log.adapter_class IS '실제 호출된 어댑터 클래스 (Mock/Kftc/Toast)';
+COMMENT ON COLUMN external_call_log.method_name IS 'requestTransfer / queryStatus / send';
+COMMENT ON COLUMN external_call_log.success IS 'true=정상응답, false=예외/실패';
+
+CREATE INDEX IF NOT EXISTS idx_ecl_called_at_desc
+ ON external_call_log(called_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_ecl_type_called_at
+ ON external_call_log(call_type, called_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_ecl_target
+ ON external_call_log(target_ref_type, target_ref_id)
+ WHERE target_ref_type IS NOT NULL;
+
+CREATE INDEX IF NOT EXISTS idx_ecl_failures
+ ON external_call_log(called_at DESC)
+ WHERE success = FALSE;
+
+-- ============================================================
+-- 메뉴 등록 (시스템 그룹 하위)
+-- ============================================================
+INSERT INTO menu (menu_code, menu_name, menu_type, menu_path, component_path, menu_icon,
+ menu_level, sort_order, is_visible, is_active, parent_menu_id, description)
+SELECT
+ 'SYSTEM_EXTERNAL_CALL',
+ '외부연동 호출이력',
+ 'PAGE',
+ '/system/external-call-log',
+ 'system/ExternalCallLogList',
+ 'api',
+ 2,
+ 20,
+ 'Y',
+ 'Y',
+ (SELECT menu_id FROM menu WHERE menu_code = 'GRP_SYSTEM'),
+ '펌뱅킹/SMS·카카오 어댑터 호출 감사 이력 (AOP 자동 영속화)'
+WHERE EXISTS (SELECT 1 FROM menu WHERE menu_code = 'GRP_SYSTEM')
+ON CONFLICT (menu_code) DO NOTHING;
+
+-- ============================================================
+-- 권한 정의 (READ 만 — 감사 로그는 수동 등록 없음)
+-- ============================================================
+INSERT INTO menu_permission (menu_id, perm_code, perm_name, sort_order)
+SELECT menu_id, 'READ', '조회', 1 FROM menu WHERE menu_code = 'SYSTEM_EXTERNAL_CALL'
+ON CONFLICT (menu_id, perm_code) DO NOTHING;
+
+-- ============================================================
+-- 역할 부여 (SUPER_ADMIN / ADMIN)
+-- ============================================================
+INSERT INTO role_menu_permission (role_id, menu_id, perm_code, is_granted)
+SELECT r.role_id, m.menu_id, p.perm_code, 'Y'
+ FROM role r
+ CROSS JOIN menu m
+ JOIN menu_permission p ON p.menu_id = m.menu_id
+ WHERE r.role_code IN ('SUPER_ADMIN', 'ADMIN')
+ AND m.menu_code = 'SYSTEM_EXTERNAL_CALL'
+ AND p.perm_code = 'READ'
+ON CONFLICT (role_id, menu_id, perm_code) DO NOTHING;
diff --git a/ga-core/src/main/java/com/ga/core/mapper/external/ExternalCallLogMapper.java b/ga-core/src/main/java/com/ga/core/mapper/external/ExternalCallLogMapper.java
new file mode 100644
index 0000000..32b7bd7
--- /dev/null
+++ b/ga-core/src/main/java/com/ga/core/mapper/external/ExternalCallLogMapper.java
@@ -0,0 +1,20 @@
+package com.ga.core.mapper.external;
+
+import com.ga.core.vo.external.ExternalCallLogResp;
+import com.ga.core.vo.external.ExternalCallLogSearchParam;
+import com.ga.core.vo.external.ExternalCallLogVO;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+
+import java.util.List;
+
+@Mapper
+public interface ExternalCallLogMapper {
+
+ /** AOP @Around 영속화. selectKey 로 logId 채움. */
+ int insertOne(ExternalCallLogVO vo);
+
+ ExternalCallLogResp selectById(@Param("logId") Long logId);
+
+ List selectList(ExternalCallLogSearchParam param);
+}
diff --git a/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogResp.java b/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogResp.java
new file mode 100644
index 0000000..a215349
--- /dev/null
+++ b/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogResp.java
@@ -0,0 +1,25 @@
+package com.ga.core.vo.external;
+
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Data
+public class ExternalCallLogResp {
+ private Long logId;
+ private String callType;
+ private String adapterClass;
+ private String methodName;
+ private String targetRefType;
+ private Long targetRefId;
+ private String requestSummary;
+ private String responseSummary;
+ private String resultCode;
+ private String resultMessage;
+ private Boolean success;
+ private Integer durationMs;
+ private String errorClass;
+ private String errorMessage;
+ private LocalDateTime calledAt;
+ private Long createdBy;
+}
diff --git a/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogSearchParam.java b/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogSearchParam.java
new file mode 100644
index 0000000..d1b60e9
--- /dev/null
+++ b/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogSearchParam.java
@@ -0,0 +1,17 @@
+package com.ga.core.vo.external;
+
+import com.ga.common.model.SearchParam;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class ExternalCallLogSearchParam extends SearchParam {
+ /** BANK / MESSAGE */
+ private String callType;
+ private String methodName;
+ /** true 만 / false 만 (실패 조회) — null 이면 전체 */
+ private Boolean success;
+ private String targetRefType;
+ private Long targetRefId;
+}
diff --git a/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogVO.java b/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogVO.java
new file mode 100644
index 0000000..2e91fdd
--- /dev/null
+++ b/ga-core/src/main/java/com/ga/core/vo/external/ExternalCallLogVO.java
@@ -0,0 +1,34 @@
+package com.ga.core.vo.external;
+
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * external_call_log — 외부 연동(펌뱅킹/SMS·카카오) 호출 감사 이력 (V85).
+ * AOP @Around 가 INSERT. 운영 감사·장애 추적용. PII 는 이미 어댑터에서 마스킹된 값만 들어간다.
+ */
+@Data
+public class ExternalCallLogVO {
+ private Long logId;
+ /** BANK / MESSAGE */
+ private String callType;
+ /** 실제 호출된 구현체 (Mock/Kftc/Toast) */
+ private String adapterClass;
+ /** requestTransfer / queryStatus / send */
+ private String methodName;
+ /** WITHDRAW / APPROVAL 등 (가능 시) */
+ private String targetRefType;
+ private Long targetRefId;
+ /** 요청 요약 (마스킹된 JSON 한 줄) */
+ private String requestSummary;
+ private String responseSummary;
+ private String resultCode;
+ private String resultMessage;
+ private Boolean success;
+ private Integer durationMs;
+ private String errorClass;
+ private String errorMessage;
+ private LocalDateTime calledAt;
+ private Long createdBy;
+}
diff --git a/ga-core/src/main/resources/mapper/external/ExternalCallLogMapper.xml b/ga-core/src/main/resources/mapper/external/ExternalCallLogMapper.xml
new file mode 100644
index 0000000..4b168fa
--- /dev/null
+++ b/ga-core/src/main/resources/mapper/external/ExternalCallLogMapper.xml
@@ -0,0 +1,96 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ log_id, call_type, adapter_class, method_name,
+ target_ref_type, target_ref_id,
+ request_summary, response_summary,
+ result_code, result_message, success, duration_ms,
+ error_class, error_message, called_at, created_by
+
+
+
+ INSERT INTO external_call_log (
+ call_type, adapter_class, method_name,
+ target_ref_type, target_ref_id,
+ request_summary, response_summary,
+ result_code, result_message, success, duration_ms,
+ error_class, error_message, called_at, created_by
+ ) VALUES (
+ #{callType},
+ #{adapterClass},
+ #{methodName},
+ #{targetRefType, jdbcType=VARCHAR},
+ #{targetRefId, jdbcType=BIGINT},
+ #{requestSummary, jdbcType=LONGVARCHAR},
+ #{responseSummary, jdbcType=LONGVARCHAR},
+ #{resultCode, jdbcType=VARCHAR},
+ #{resultMessage, jdbcType=LONGVARCHAR},
+ #{success, jdbcType=BOOLEAN},
+ #{durationMs, jdbcType=INTEGER},
+ #{errorClass, jdbcType=VARCHAR},
+ #{errorMessage, jdbcType=LONGVARCHAR},
+ COALESCE(#{calledAt,jdbcType=TIMESTAMP}, CURRENT_TIMESTAMP),
+ #{createdBy, jdbcType=BIGINT}
+ )
+
+
+
+
+
+
+
diff --git a/ga-frontend/src/App.tsx b/ga-frontend/src/App.tsx
index b5d3a9c..c94ce99 100644
--- a/ga-frontend/src/App.tsx
+++ b/ga-frontend/src/App.tsx
@@ -94,6 +94,7 @@ import SystemLog from '@/pages/system/SystemLog';
import UploadTemplateManager from '@/pages/system/UploadTemplateManager';
import DataDomainList from '@/pages/system/DataDomainList';
import DataDictionary from '@/pages/system/DataDictionary';
+import ExternalCallLogList from '@/pages/system/ExternalCallLogList';
function RequireAuth({ children }: { children: React.ReactNode }) {
const token = localStorage.getItem('accessToken');
@@ -209,6 +210,7 @@ export default function App() {
} />
} />
} />
+ } />
);
diff --git a/ga-frontend/src/api/externalCallLog.ts b/ga-frontend/src/api/externalCallLog.ts
new file mode 100644
index 0000000..9e2614a
--- /dev/null
+++ b/ga-frontend/src/api/externalCallLog.ts
@@ -0,0 +1,41 @@
+import api, { unwrap } from './request';
+
+export interface ExternalCallLogResp extends Record {
+ logId: number;
+ callType: string; // BANK / MESSAGE
+ adapterClass: string; // Mock / Kftc / Toast
+ methodName: string; // requestTransfer / queryStatus / send
+ targetRefType?: string;
+ targetRefId?: number;
+ requestSummary?: string;
+ responseSummary?: string;
+ resultCode?: string;
+ resultMessage?: string;
+ success: boolean;
+ durationMs?: number;
+ errorClass?: string;
+ errorMessage?: string;
+ calledAt: string;
+ createdBy?: number;
+}
+
+export interface ExternalCallLogSearchParam {
+ callType?: string;
+ methodName?: string;
+ success?: boolean;
+ targetRefType?: string;
+ targetRefId?: number;
+ startDate?: string;
+ endDate?: string;
+ pageNum?: number;
+ pageSize?: number;
+}
+
+export const externalCallLogApi = {
+ list: (params?: ExternalCallLogSearchParam) =>
+ unwrap<{ list: ExternalCallLogResp[]; total: number }>(
+ api.get('/api/external-call-logs', { params })
+ ),
+ detail: (id: number) =>
+ unwrap(api.get(`/api/external-call-logs/${id}`)),
+};
diff --git a/ga-frontend/src/pages/system/ExternalCallLogList.tsx b/ga-frontend/src/pages/system/ExternalCallLogList.tsx
new file mode 100644
index 0000000..d3ec9f7
--- /dev/null
+++ b/ga-frontend/src/pages/system/ExternalCallLogList.tsx
@@ -0,0 +1,113 @@
+import { useState } from 'react';
+import { Tag, Drawer, Descriptions } from 'antd';
+import { ProTable, type ProColumns } from '@ant-design/pro-components';
+import PageContainer from '@/components/common/PageContainer';
+import { externalCallLogApi, ExternalCallLogResp } from '@/api/externalCallLog';
+
+export default function ExternalCallLogList() {
+ const [detail, setDetail] = useState(null);
+
+ const columns: ProColumns[] = [
+ { title: '호출시각', dataIndex: 'calledAt', width: 170, valueType: 'dateTime' },
+ {
+ title: '종류', dataIndex: 'callType', width: 90, valueType: 'select',
+ valueEnum: { BANK: { text: '펌뱅킹' }, MESSAGE: { text: 'SMS/카카오' } },
+ render: (_, r) => (
+ {r.callType}
+ ),
+ },
+ { title: '구현체', dataIndex: 'adapterClass', width: 200, search: false, ellipsis: true },
+ { title: '메서드', dataIndex: 'methodName', width: 140 },
+ {
+ title: '대상', dataIndex: 'targetRefType', width: 160, search: false,
+ render: (_, r) =>
+ r.targetRefType ? `${r.targetRefType}#${r.targetRefId ?? ''}` : '-',
+ },
+ {
+ title: '결과', dataIndex: 'success', width: 80,
+ valueType: 'select',
+ valueEnum: { true: { text: '성공' }, false: { text: '실패' } },
+ render: (_, r) => (
+ {r.success ? 'SUCCESS' : 'FAIL'}
+ ),
+ },
+ { title: '코드', dataIndex: 'resultCode', width: 90, search: false },
+ {
+ title: '소요(ms)', dataIndex: 'durationMs', width: 90, align: 'right', search: false,
+ },
+ {
+ title: '메시지', dataIndex: 'resultMessage', ellipsis: true, search: false,
+ render: (_, r) => r.errorMessage ?? r.resultMessage ?? '-',
+ },
+ ];
+
+ return (
+
+
+ rowKey="logId"
+ columns={columns}
+ dateFormatter="string"
+ scroll={{ x: 1300 }}
+ request={async (params) => {
+ const { current, pageSize, ...rest } = params as any;
+ const res = await externalCallLogApi.list({
+ ...rest, pageNum: current, pageSize,
+ });
+ return { data: res.list, total: res.total, success: true };
+ }}
+ onRow={(record) => ({ onClick: () => setDetail(record), style: { cursor: 'pointer' } })}
+ pagination={{ pageSize: 50, showTotal: (t) => `총 ${t.toLocaleString()}건` }}
+ search={{
+ labelWidth: 'auto', searchText: '검색', resetText: '초기화',
+ collapsed: false, collapseRender: false,
+ }}
+ />
+
+ setDetail(null)}
+ destroyOnClose
+ >
+ {detail && (
+
+ {detail.calledAt}
+ {detail.callType}
+ {detail.adapterClass}
+ {detail.methodName}
+
+ {detail.targetRefType ? `${detail.targetRefType}#${detail.targetRefId ?? ''}` : '-'}
+
+
+
+ {detail.success ? 'SUCCESS' : 'FAIL'}
+
+
+ {detail.resultCode ?? '-'}
+ {detail.resultMessage ?? '-'}
+ {detail.durationMs ?? '-'}
+
+
+ {detail.requestSummary ?? '-'}
+
+
+
+
+ {detail.responseSummary ?? '-'}
+
+
+ {detail.errorClass && (
+
+ {detail.errorClass}: {detail.errorMessage ?? ''}
+
+ )}
+
+ )}
+
+
+ );
+}
diff --git a/login.json b/login.json
new file mode 100644
index 0000000..c89841a
--- /dev/null
+++ b/login.json
@@ -0,0 +1 @@
+{"success":true,"code":"0000","message":"성공","data":{"accessToken":"eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJhZG1pbiIsInR5cGUiOiJBQ0NFU1MiLCJ1aWQiOjEsInJvbGVzIjpbIlNVUEVSX0FETUlOIl0sImlhdCI6MTc3OTYyOTYyNCwiZXhwIjoxNzc5NjM2ODI0fQ.wToTgSSi6aEZfWVJCZATKZwUlHXl5sz0Y6EngX5oTO4HzmvUB-dOQB76bIE84URE","refreshToken":"eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJhZG1pbiIsInR5cGUiOiJSRUZSRVNIIiwidWlkIjoxLCJyb2xlcyI6W10sImlhdCI6MTc3OTYyOTYyNCwiZXhwIjoxNzgwMjM0NDI0fQ.uZDBImRtJqrp5CAb1ILZ-v0G2DyNs4lnLFuSm8A1oJ1h_5JSQnJGVQr3OULrYCNI","accessTokenExpiresIn":7200000,"userId":1,"loginId":"admin","userName":"시스템 관리자","roles":["SUPER_ADMIN"]},"timestamp":[2026,5,24,22,33,44,637428600]}
\ No newline at end of file
diff --git a/token.txt b/token.txt
new file mode 100644
index 0000000..db4330a
--- /dev/null
+++ b/token.txt
@@ -0,0 +1 @@
+eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJhZG1pbiIsInR5cGUiOiJBQ0NFU1MiLCJ1aWQiOjEsInJvbGVzIjpbIlNVUEVSX0FETUlOIl0sImlhdCI6MTc3OTYyOTYyNCwiZXhwIjoxNzc5NjM2ODI0fQ.wToTgSSi6aEZfWVJCZATKZwUlHXl5sz0Y6EngX5oTO4HzmvUB-dOQB76bIE84URE