금융 프로젝트
테이블 (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)