금융 프로젝트

테이블 (14)

discrepancies

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • transaction_id — BIGINT — NOT NULL — 어느 거래인지
  • merchant_id — BIGINT — NOT NULL — 조회 성능용 비정규화
  • type — VARCHAR(30) — NOT NULL — CAPTURE_PENDING / PAYOUT_PENDING / CANCEL_RECLAIMED / AMOUNT_MISMATCH
  • detected_at — DATE — NOT NULL — 탐지 기준일
  • expected_amount — NUMERIC(15,0) — 기대 금액
  • actual_amount — NUMERIC(15,0) — 실제 금액
  • diff_amount — NUMERIC(15,0) — 차액
  • status — VARCHAR(20) — NOT NULL — OPEN / RESOLVED / CLOSED
  • resolved_at — TIMESTAMP — 해소 시각
  • resolve_reason — VARCHAR(200) — 해소 사유
  • created_at — TIMESTAMP — NOT NULL

injected_defects

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • transaction_id — BIGINT — NOT NULL — 어느 거래에 주입했는지
  • defect_type — VARCHAR(30) — NOT NULL — 주입한 이탈 유형 (discrepancies.type과 동일 값)
  • injected_at — TIMESTAMP — NOT NULL — 주입 시각
  • batch_id — VARCHAR(50) — 어느 생성 배치에서 주입됐는지
  • detected — BOOLEAN — NOT NULL — 탐지 배치가 잡았는지
  • detected_at — TIMESTAMP — 탐지 시각

가맹점 (merchants)

  • 가맹점 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 가맹점 이름 (name) — VARCHAR(100) — NOT NULL — 상호명
  • 사업자 번호(마스킹) (business_no_masked) — VARCHAR(20)
  • 업종 코드 (industry_code) — VARCHAR(10)
  • 세금 유형 (tax_type) — VARCHAR(20) — NOT NULL — GENERAL / SIMPLIFIED
  • 개업일 (opened_at) — DATE
  • 생성 일시 (created_at) — TIMESTAMP — NOT NULL

거래 원장 (transactions)

  • 거래 원장 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 승인번호 (approval_no) — VARCHAR(30) — NOT NULL
  • 승인일 (approved_date) — DATE — NOT NULL — 멱등키 구성
  • 승인일시 (approved_at) — TIMESTAMP — NOT NULL — cutoff 판정
  • 카드 마스킹 번호 (card_no_masked) — VARCHAR(20)
  • 카드 뒷자리 4개 (card_no_last4) — VARCHAR(4) — 2차 매칭 키
  • 승인 금액 (approved_amount) — NUMERIC(15,0) — NOT NULL
  • 매입 금액 (captured_amount) — NUMERIC(15,0)
  • 입금금액 (paid_amount) — NUMERIC(15,0)
  • 누적 취소액 (canceled_amount) — NUMERIC(15,0) — NOT NULL
  • 현재상태 (status) — VARCHAR(30) — NOT NULL
  • 매입 기대일 (expected_capture_date) — DATE
  • 입금 기대일 (expected_payout_date) — DATE
  • 매입 시각 (captured_at) — TIMESTAMP
  • 입금시각 (paid_at) — TIMESTAMP
  • 생성 시각 (created_at) — TIMESTAMP — NOT NULL
  • 업데이트 시각 (updated_at) — TIMESTAMP
  • 가맹점 아이디 (merchant_id) — BIGSERIAL — 외래 키 → 가맹점.가맹점 아이디 — NOT NULL
  • 채널 아이디 (channel_id) — BIGSERIAL — 외래 키 → 정산 채널.채널 아이디 — NOT NULL
  • 카드사 아이디 (card_company_id) — BIGSERIAL — 외래 키 → 카드사.카드사 아이디 — NOT NULL

거래별 수수료 내역 (payout_details)

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • schedule_id — BIGINT — 외래 키 → 입금 예정.id — NOT NULL — 어느 집계에 속하는지
  • 거래 원장 아이디 (transaction_id) — BIGSERIAL — 외래 키 → 거래 원장.거래 원장 아이디 — NOT NULL
  • gross_amount — NUMERIC(15,0) — NOT NULL — 이 거래의 금액
  • fee_breakdown — JSONB — NOT NULL — 수수료 구성요소별 금액 (JSON)
  • fee_amount — NUMERIC(15,0) — NOT NULL — 수수료 합계
  • net_amount — NUMERIC(15,0) — NOT NULL — 이 거래의 실수령액
  • created_at — TIMESTAMP — NOT NULL

매칭 실패 격리 (unmatched_events)

  • 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 데이터 출처 채널 (source) — VARCHAR(30) — NOT NULL
  • 이벤트 유형 (event_type) — VARCHAR(20) — NOT NULL
  • 원문 (raw_payload) — JSONB — NOT NULL
  • 수신시각 (received_at) — TIMESTAMP — NOT NULL
  • 재시도 횟수 (retry_count) — INT — NOT NULL
  • 상태 (status) — VARCHAR(20) — NOT NULL — PENDING / MATCHED / ORPHANED
  • 매칭 성공 시 기록 (Field) — BIGINT

상태 전이 이력 (transaction_events)

  • 전이 이력 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 이벤트 타입 (event_type) — VARCHAR(20) — NOT NULL
  • 이전 상태 (from_status) — VARCHAR(30)
  • 다음 상태 (to_status) — VARCHAR(30) — NOT NULL
  • 해당 이벤트 금액 (amount) — NUMERIC(15,0)
  • 발생 시각 (occured_at) — TIMESTAMP — NOT NULL
  • 수신 시각 (received_at) — TIMESTAMP — NOT NULL
  • 데이터 출처 채널 (source) — VARCHAR(30) — NOT NULL
  • 상태 변경 주체 (actor) — VARCHAR(20) — NOT NULL
  • 원문 (raw_payload) — JSONB
  • 거래 원장 아이디 (transaction_id) — BIGSERIAL — 외래 키 → 거래 원장.거래 원장 아이디 — NOT NULL

수수료 구성 요소 (fee_components)

  • 구성 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 정책 아이디 (policy_id) — BIGSERIAL — 외래 키 → 정산 정책.정책 아이디 — NOT NULL
  • 구성 유형 (component_type) — VARCHAR(30) — NOT NULL — MERCHANT_FEE/BROKERAGE/ PAYMENT/ DELIVERY_FEE/ AD
  • 계산 유형 (calc_type) — VARCHAR(20) — NOT NULL — RATE / FIXED_PER_TX / FIXED_MONTHLY
  • 요율/금액 (value) — NUMERIC(10,4) — NOT NULL
  • 부가세 포함 여부 (vat_included) — BOOLEAN — NOT NULL
  • 계산 순서 (sort_order) — INT — NOT NULL

영업일 캘린더 (business_days)

  • 날짜 (date) — DATE — 기본 키 — NOT NULL
  • 영업일 여부 (is_business_day) — BOOLEAN — NOT NULL
  • 공휴일 명칭 (holiday_name) — VARCHAR(50)

입금 예정 (payout_schedules)

  • id — BIGSERIAL — 기본 키 — NOT NULL
  • payout_date — DATE — NOT NULL — 지급 예정일
  • tx_count — INT — NOT NULL — 거래 건수
  • gross_amount — NUMERIC(15,0) — NOT NULL — 총 거래금액
  • fee_amount — NUMERIC(15,0) — NOT NULL — 총 수수료
  • cancel_amount — NUMERIC(15,0) — NOT NULL — 취소 반영액
  • net_amount — NUMERIC(15,0) — NOT NULL — 실수령액
  • status — VARCHAR(20) — NOT NULL — EXPECTED / CONFIRMED / PAID
  • confirmed_at — TIMESTAMP — 확정 시각
  • paid_at — TIMESTAMP — 입금 확인 시각
  • created_at — TIMESTAMP — NOT NULL
  • updated_at — TIMESTAMP
  • 가맹점 아이디 (merchant_id) — BIGSERIAL — 외래 키 → 가맹점.가맹점 아이디 — NOT NULL
  • 채널 아이디 (channel_id) — BIGSERIAL — 외래 키 → 정산 채널.채널 아이디 — NOT NULL

정산 정책 (settlement_policies)

  • 정책 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 채널 아이디 (channel_id) — BIGSERIAL — 외래 키 → 정산 채널.채널 아이디 — NOT NULL
  • 주기 (cycle_days) — INT — NOT NULL — D+N의 N
  • 주기 유형 (cycle_type) — VARCHAR(20) — NOT NULL — BUSINESS_DAY / CALENDAR_DAY / WEEKLY
  • 컷오프 시간 (cutoff_time) — TIME — NOT NULL — 이 시각 이후 익일 산입
  • 입금 유예 (grace_days) — INT — NOT NULL — 입금 유예 (탐지 여유)
  • 정책 적용 시작일 (effective_from) — DATE — NOT NULL
  • 정책 마감일 (effective_to) — DATE — NULL이면 유효한 정책
  • 생성 일시 (created_at) — TIMESTAMP — NOT NULL

정산 채널 (channels)

  • 채널 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 채널 코드 (code) — VARCHAR(30) — NOT NULL — SHINHAN_CARD, BAEMIN, COUPANG_EATS
  • 채널 이름 (name) — VARCHAR(50) — NOT NULL
  • 채널 유형 (type) — VARCHAR(20) — NOT NULL — CARD / DELIVERY / EASY_PAY
  • 활성화 여부 (is_active) — BOOLEAN — NOT NULL — 사용 중단 채널 처리
  • 생성 일시 (created_at) — TIMESTAMP — NOT NULL

카드사 (card_companies)

  • 카드사 아이디 (id) — BIGSERIAL — 기본 키 — NOT NULL
  • 카드사 코드 (code) — VARCHAR(20) — NOT NULL — SHINHAN, SAMSUNG, KB
  • 카드사 이름 (name) — VARCHAR(50) — NOT NULL
  • 매입 기한 (capture_deadline_days) — INT — NOT NULL — 매입 기한(영업일 기준)
  • 생성 일시 (created_at) — TIMESTAMP — NOT NULL

허용 전이 규칙 (state_transitions)

  • 이전 상태 (from_status) — VARCHAR(30) — 기본 키 — NOT NULL
  • 이벤트 유형 (event_type) — VARCHAR(20) — 기본 키 — NOT NULL
  • 다음 상태 (to_status) — VARCHAR(30) — NOT NULL
  • 설명 (description) — VARCHAR(100)