banking_schema
테이블 (3)
금융기관 상태관리 테이블 (bank_routing_status)
- 금융결제원 표준 은행코드 (bank_code) — VARCHAR(10) — 기본 키 — NOT NULL — 금융결제원에서 제공하는 표준 은행 코드
- 은행 이름 (bank_name) — VARCHAR(50) — NOT NULL — 은행 이름
- 통신가능여부 (is_available) — TINYINT(1) — NOT NULL — [중요] 현재 해당 은행망으로 통신이 가능한지에 대한 여부, 0이면 Circuit Breaker 동작
- 은행 점검시간 시작일시 (maint_start_time) — DATETIME — NOT NULL — 정기/긴급 점검 시작 일시
- 은행 점검시간 종료일시 (maint_end_time) — DATETIME — NOT NULL — 정기/긴급 점검 종료 예정일시
- 상태변경 일시 (updated_at) — DATETIME — NOT NULL — 상태가 마지막으로 수동/자동 변경된 일시
대사 배치 기록용 테이블 (reconciliation_history)
- 대사 작업 고유 식별자 (rec_id) — BIGINT — 기본 키 — NOT NULL — 대사 작업 고유 식별자로 snowflake 방식으로 ID 채번
- 대조 날짜 (target_date) — DATE — NOT NULL — 대조(대사)할 기준 일자. (보통 어제 날짜를 오늘 새벽에 대사)
- 정산 불일치 건수 (unmatched_count) — INT — Asset DB (PENDING)와 KFTC 정산 파일 간 불일치 발견 건수
- 불일치 건 시스템 자동환불 수 (resolved_count) — INT — 불일치 건 중 시스템이 자동으로 환불처리하여 해결한 건 수(보상 트랜잭션으로 처리 한 카운팅 수 )
- 대사 작업 배치 상태 (status) — CARCHAR(20) — NOT NULL — 예: IN_PROGRESS, COMPLETED, FAILED
- 배치 작업시작 일시 (created_at) — DATETIME — NOT NULL — 배치 작업 시작 일시
- 배치 작업종료/실패 일시 (updated_at) — DATETIME — NOT NULL — 배치 작업 종료 혹은 실패 일시
대외계 통신 로그 테이블 (kftc_api_log)
- 로그 고유 식별자 (log_id) — BIGINT — 기본 키 — NOT NULL — 로그 고유 식별자로 snowflake 방식으로 ID채번
- 거래 고유 아이디 (transfer_id) — BIGINT — NOT NULL — [논리적FK] Asset 도메인의 transaction_history 테이블의 id를 참조 ( 어떤 거래에 대한 통신인지 파악)
- 외부 고유기관 추적번호 (external_ref_no) — VARCHAR(100) — 통신 성공 후 KFTC에서 발급해 준 외부 기관 고유 추적번호
- 외부망 전송 데이터 본문 (request_payload) — TEXT — NOT NULL — KFTC 요청 전문. (단, 주민번호/계좌번호 등 민감 PII 데이터는 마스킹 처리하거나 AES-256 양방향 암호화하여 적재해야 함. 절대 평문 저장 불가)
- 외부망 응답 코드 (response_code) — VARCHAR(10) — 응답받은 HTTP 또는 KFTC 고유 에러코드
- 통신 상태 (status) — VARCHAR(20) — NOT NULL — 통신상태 (SENT: 전송됨, COMPLETED: 완료응답, TIMEOUT: 타임아웃, REVERSED: 망취소)
- 로그 기록최초일시 (created_at) — DATETIME — NOT NULL — 로그 기록 일시 (문제 발생 시 타임라인 추적전용)