YOJEONG
테이블 (22)
DDB 발신함 (outbox_events)
- id — UUID — 기본 키 — NOT NULL
- 대상 종류 (aggregate_type) — VARCHAR(50) — NOT NULL — subscription, subscription_activated, subscription_suspended, subscription_terminated, billing_method_update_required
- 대상 ID (aggregate_id) — UUID — NOT NULL
- 이벤트 종류 (event_type) — VARCHAR(100) — NOT NULL — subscription, subscription_activated, subscription_suspended, subscription_terminated, billing_method_update_required
- 이벤트 내용 (payload) — JSONB — NOT NULL
- 상태 (status) — VARCHAR(30) — NOT NULL — pending, processing, processed, failed
- 재시도 횟수 (retry_count) — INTEGER — NOT NULL
- 처리 가능 시각 (available_at) — TIMESTAMPTZ — NOT NULL
- 완료 시각 (processed_at) — TIMESTAMPTZ
- 에러 메시지 (error_message) — TEXT
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 순서 보장 (seq) — BIGINT — NOT NULL
PG 별 고객 식별자 (provider_customer_keys)
- id — UUID — 기본 키 — NOT NULL
- 결제 고객 ID (payment_customer_id) — UUID — 외래 키 → 결제 고객.id — NOT NULL
- PG사 (provider) — VARCHAR(30) — NOT NULL
- PG 고객 키 (provider_customer_key) — VARCHAR(300) — NOT NULL
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
가맹점 정산 원천 (settlements)
- id — UUID — 기본 키 — NOT NULL
- 결제 ID (payment_id) — UUID — 외래 키 → 결제.id
- 결제 취소 ID (payment_cancel_id) — UUID — 외래 키 → 결제 취소.id
- 가맹점 ID (mid) — VARCHAR(50) — NOT NULL
- PG 사 (provider) — VARCHAR(30) — NOT NULL
- 결제 키 (payment_key) — VARCHAR(200) — NOT NULL
- 거래 키 (transaction_key) — VARCHAR(100)
- 정산 구분 (settlement_type) — VARCHAR(20) — NOT NULL — payment, canceled
- 정산 대상 금액 (amount) — BIGINT — NOT NULL
- 수수료 합계 (fee_amount) — BIGINT — NOT NULL
- 수수료 공급가액 (fee_supply_amount) — BIGINT
- 지급 금액 (payout_amount) — BIGINT — NOT NULL
- 수수료 부가세 (fee_vat) — BIGINT
- 정산 매출일 (sold_date) — DATE — NOT NULL
- 정산 지급일 (paid_out_date) — DATE
- 거래 승인 시각 (approved_at) — TIMESTAMPTZ
- 수수료 상세 (fee_details) — JSONB
- 응답 원본 (raw) — JSONB — NOT NULL
- 수집 시각 (fetched_at) — TIMESTAMPTZ — NOT NULL
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
- API 버전 (source_api_version) — VARCHAR(20)
결제 (payments)
- id — UUID — 기본 키 — NOT NULL
- 주문 번호 (order_id) — UUID — 외래 키 → 주문.id — NOT NULL
- 성공 주문 시도 ID (successful_attempt_id) — UUID — 외래 키 → 결제 시도.id — NOT NULL
- PG 사 (provider) — VARCHAR(30) — NOT NULL
- 결제 키 (payment_key) — VARCHAR(200) — NOT NULL
- 결제 유형 (payment_type) — VARCHAR(30) — NOT NULL — normal, billing
- 결제 수단 (payment_method) — VARCHAR(50)
- 상태 (status) — VARCHAR(40) — NOT NULL — in_progress, waiting_for_deposit, done, canceled, partial_canceled, aborted, expired
- 총결제액 (total_amount) — BIGINT — NOT NULL
- 잔여액 (balance_amount) — BIGINT — NOT NULL
- 통화 (currency) — VARCHAR(3) — NOT NULL
- 승인 시각 (approved_at) — TIMESTAMPTZ
- 원본 응답 (provider_payload) — JSONB
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
결제 감사 로그 (payment_audit_logs)
- id — UUID — 기본 키 — NOT NULL
- 로그 순번 (seq) — BIGINT — NOT NULL
- 행위자 유형 (actor_type) — VARCHAR(20) — NOT NULL — admin, system, customer
- 행위자 ID (actor_id) — VARCHAR(100) — NOT NULL
- 행위 (action) — VARCHAR(100) — NOT NULL
- 대상 테이블 (entity_type) — VARCHAR(50) — NOT NULL
- 조작 대상 행 ID (entity_id) — VARCHAR(100) — NOT NULL
- 요청 원문 스냅샷 (request_snapshot) — JSONB
- 기록 시각 (created_at) — TIMESTAMPTZ — NOT NULL
결제 고객 (payment_customers)
- id — UUID — 기본 키 — NOT NULL
- 회원 ID (user_id) — VARCHAR(100) — NOT NULL
- OTP 앵커 (cognito_sub) — VARCHAR(100)
- 전화번호 (phone) — VARCHAR(20) — NOT NULL
- 이름 (name) — VARCHAR(100) — NOT NULL
- 상태 (status) — VARCHAR(30) — NOT NULL — active, inactive
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
결제 세션 (checkout_sessions)
- id — UUID — 기본 키 — NOT NULL
- 주문ID (order_id) — UUID — 외래 키 → 주문.id — NOT NULL
- 링크 토큰 해시 (link_token_hash) — VARCHAR(255) — NOT NULL
- 상태 (status) — VARCHAR(30) — NOT NULL — active, paid, expired, canceled
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
결제 시도 (payment_attempts)
- id — UUID — 기본 키 — NOT NULL
- 주문 ID (order_id) — UUID — 외래 키 → 주문.id — NOT NULL
- PG 사 (provider) — VARCHAR(30) — NOT NULL
- 재시도 횟수 (attempt_number) — INTEGER — NOT NULL
- 멱등성 키 (idempotency_key) — VARCHAR(255) — NOT NULL
- 상태 (status) — VARCHAR(30) — NOT NULL — pending, processing, succeeded, failed, unknown, expired
- 결제사 주문 번호 (provider_order_id) — VARCHAR(64) — NOT NULL
- 오류 코드 (provider_error_code) — VARCHAR(100)
- 오류 메시지 (provider_error_message) — TEXT
- 요청 시각 (requested_at) — TIMESTAMPTZ
- 완료 시각 (completed_at) — TIMESTAMPTZ
- 만료 시각 (lease_expires_at) — TIMESTAMPTZ
- 다음 재시도 시각 (next_retry_at) — TIMESTAMPTZ
- 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL
결제 취소 (payment_cancels)
- id — UUID — 기본 키 — NOT NULL
- 결제 ID (payment_id) — UUID — 외래 키 → 결제.id — NOT NULL
- 해지 요청 ID (termination_request_id) — UUID — 외래 키 → 해지 요청.id
- PG 취소 주문번호 (provider_order_id) — VARCHAR(64)
- 거래 식별자 (transaction_key) — VARCHAR(100)
- 멱등키 (idempotency_key) — VARCHAR(255) — NOT NULL
- 취소 유형(전액/부분) (cancel_type) — VARCHAR(20) — NOT NULL — full, partial
- 취소 사유 (cancel_reason) — VARCHAR(200) — NOT NULL
- 취소 금액 (cancel_amount) — BIGINT — NOT NULL
- 잔여 금액 (refundable_amount_after) — BIGINT
- 상태 (status) — VARCHAR(30) — NOT NULL — requested, processing, done, failed, unknown
- 거절 사유 (provider_error_code) — VARCHAR(100)
- 재시도 횟수 (attempt_number) — INTEGER
- 에러 메시지 (provider_error_message) — TEXT
- 원본 메시지 (provider_payload) — JSONB
- 요청 시각 (requested_at) — TIMESTAMPTZ — NOT NULL
- 취소 시각 (canceled_at) — TIMESTAMPTZ
- 만료 시각 (lease_expires_at) — TIMESTAMPTZ
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
구독 (subscriptions)
- id — UUID — 기본 키 — NOT NULL
- 플랜 가격 ID (plan_price_id) — UUID — 외래 키 → 플랜 가격.id — NOT NULL
- 결제 고객 ID (payment_customer_id) — UUID — 외래 키 → 결제 고객.id — NOT NULL
- 등록 결제 수단 ID (payment_method_id) — UUID — 외래 키 → 등록 결제 수단.id — NOT NULL
- 가구 ID (household_id) — VARCHAR(100) — NOT NULL
- 상태 (status) — VARCHAR(40) — NOT NULL — pending_activation, active, past_due, suspended, termination_pending, canceled, expired
- 월 요금 (monthly_amount) — BIGINT — NOT NULL
- 통화 (currency) — VARCHAR(3) — NOT NULL
- 약정 개월 수 (commitment_months) — INTEGER — NOT NULL
- 중도 해지 위약금 요율 (early_termination_rate) — NUMERIC(5, 4) — NOT NULL
- 청구 기준일 (billing_anchor_day) — SMALLINT
- 이용 개시일 (service_started_at) — TIMESTAMPTZ
- 약정 만료일 (commitment_ends_at) — TIMESTAMPTZ
- 해지 신청 시각 (cancel_requested_at) — TIMESTAMPTZ
- 해지 확정 시각 (canceled_at) — TIMESTAMPTZ
- 서비스 종료 시각 (ended_at) — TIMESTAMPTZ
- 버전 (version) — INTEGER — NOT NULL
- 셍성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
등록 결제 수단 (payment_methods)
- id — UUID — 기본 키 — NOT NULL
- 결제 고객 ID (payment_customer_id) — UUID — 외래 키 → 결제 고객.id — NOT NULL
- PG사 (provider) — VARCHAR(30) — NOT NULL
- 빌링키 암호문 (billing_key_ciphertext) — TEXT — NOT NULL
- 결제 수단 종류 (method_type) — VARCHAR(30) — NOT NULL
- 카드사 (card_company) — VARCHAR(100)
- 마스킹 카드번호 (card_number_masked) — VARCHAR(30)
- 카드 유형 (card_type) — VARCHAR(30)
- 소유자 유형 (owner_type) — VARCHAR(30)
- 상태 (status) — VARCHAR(30) — NOT NULL — active, inactive, deleted
- 등록 시각 (registered_at) — TIMESTAMPTZ — NOT NULL
- 삭제 시각 (deleted_at) — TIMESTAMPTZ
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
알림 발송 이력 (notification_logs)
- id — UUID — 기본 키 — NOT NULL
- 결제 고객 ID (payment_customer_id) — UUID — 외래 키 → 결제 고객.id — NOT NULL
- 구독 ID (subscription_id) — UUID — 외래 키 → 구독.id
- 청구 회차 ID (billing_cycle_id) — UUID — 외래 키 → 청구 회차.id
- 알림 종류 (kind) — VARCHAR(50) — NOT NULL
- 채널 (channel) — VARCHAR(20) — NOT NULL — alimtalk, sms
- 발송 기준일 (dedup_date) — DATE
- 알림 템플릿 코드 (template_code) — VARCHAR(100)
- 발송사 메시지 ID (provider_message_id) — VARCHAR(200)
- 상태 (status) — VARCHAR(20) — NOT NULL — pending, sent, failed
- 발송 완료 시각 (sent_at) — TIMESTAMPTZ
- 에러 메시지 (error_message) — TEXT
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
- 고객 번호 스냅샷 (recipient_phone) — VARCHAR(20) — NOT NULL
약관 동의 내역 (term_agreements)
- id — UUID — 기본 키 — NOT NULL
- 카드 등록 세션 ID (session_id) — UUID — 외래 키 → 카드 등록 세션.id — NOT NULL
- 약관 ID (term_id) — UUID — 외래 키 → 이용 약관.id — NOT NULL
- 동의 여부 (agreed) — BOOLEAN — NOT NULL
- 동의 시각 (agreed_at) — TIMESTAMPTZ — NOT NULL
웹훅 이벤트 (webhook_events)
- id — UUID — 기본 키 — NOT NULL
- 연결 주문 (order_id) — UUID — 외래 키 → 주문.id — NOT NULL
- PG 사 (provider) — VARCHAR(30) — NOT NULL
- 전송 ID (transmission_id) — VARCHAR(255) — NOT NULL
- 이벤트 종류 (event_type) — VARCHAR(100) — NOT NULL — approved, cancelled, billing_key_deleted, ignored
- 수신 원문 (payload) — JSONB — NOT NULL
- 처리 상태 (status) — VARCHAR(30) — NOT NULL — received, processing, processed, deferred, failed, ignored, orphan, flagged
- 수신 시각 (received_at) — TIMESTAMPTZ — NOT NULL
- 처리 완료 시각 (processed_at) — TIMESTAMPTZ
- 실패 사유 (error_message) — TEXT
- 서명 검증 상태 (signature_state) — VARCHAR(20) — ok, missing, mismatch, unchecked
- 발신 IP (source_ip) — VARCHAR(45)
- 선점 시각 (claimed_at) — TIMESTAMPTZ
이용 약관 (terms)
- id — UUID — 기본 키 — NOT NULL
- 약관 코드 (code) — VARCHAR(50) — NOT NULL
- 약관 버전 (version) — VARCHAR(50) — NOT NULL
- 약관 제목 (title) — VARCHAR(200) — NOT NULL
- 약관 본문 주소 (content_url) — TEXT
- 필수 여부 (is_required) — BOOLEAN — NOT NULL
- 적용 범위 (scope) — VARCHAR(30) — NOT NULL — common, one_time, subscription
- 적용 시작 일시 (effective_from) — TIMESTAMPTZ — NOT NULL
- 적용 종료 일시 (effective_to) — TIMESTAMPTZ
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
주문 (orders)
- id — UUID — 기본 키 — NOT NULL
- 플랜 가격 ID (plan_price_id) — UUID — 외래 키 → 플랜 가격.id
- 결제 고객 ID (payment_customer_id) — UUID — 외래 키 → 결제 고객.id — NOT NULL
- 구독 ID (subscription_id) — UUID — 외래 키 → 구독.id
- 청구 회차 ID (billing_cycle_id) — UUID — 외래 키 → 청구 회차.id
- 노출 주문번호 (public_id) — VARCHAR(64) — NOT NULL
- 주문명 (order_name) — VARCHAR(200) — NOT NULL
- 수량 (amount) — BIGINT — NOT NULL
- 주문 상태 (status) — VARCHAR(40) — NOT NULL — pending, processing, paid, payment_failed, canceled, expired
- expires_at — TIMESTAMPTZ
- created_at — TIMESTAMPTZ — NOT NULL
- updated_at — TIMESTAMPTZ — NOT NULL
- 청구 종류 (order_type) — VARCHAR(40) — NOT NULL — subscription_cycle, early_termination_fee, installation_fee, device_compensation, one_time_goods
청구 회차 (billing_cycles)
- id — UUID — 기본 키 — NOT NULL
- 구독 ID (subscription_id) — UUID — 외래 키 → 구독.id — NOT NULL
- 회차 번호 (cycle_number) — INTEGER — NOT NULL
- 이용 기간 시작 (period_start) — TIMESTAMPTZ — NOT NULL
- 이용 기간 종료 (period_end) — TIMESTAMPTZ — NOT NULL
- 청구 예정 시각 (scheduled_charge_at) — TIMESTAMPTZ — NOT NULL
- 금액 (amount) — BIGINT — NOT NULL
- 통화 (currency) — VARCHAR(3) — NOT NULL
- 상태 (status) — VARCHAR(40) — NOT NULL — scheduled, processing, paid, payment_failed, canceled, partially_refunded, refunded
- 결제 완료 시각 (paid_at) — TIMESTAMPTZ
- 최종 실패 시각 (failed_at) — TIMESTAMPTZ
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
카드 등록 세션 (billing_registration_sessions)
- id — UUID — 기본 키 — NOT NULL
- 결제 고객 ID (payment_customer_id) — UUID — 외래 키 → 결제 고객.id — NOT NULL
- 구독 ID (subscription_id) — UUID — 외래 키 → 구독.id
- 등록 결제 수단 ID (payment_method_id) — UUID — 외래 키 → 등록 결제 수단.id
- 플랜 가격 ID (plan_price_id) — UUID — 외래 키 → 플랜 가격.id
- 가구 ID (household_id) — VARCHAR(100)
- purpose — VARCHAR(30) — NOT NULL — initial_registration, method_change
- link_token_hash — VARCHAR(255) — NOT NULL
- 상태 (status) — VARCHAR(30) — NOT NULL — active, processing, completed, expired, revoked, failed
- last_error_code — VARCHAR(100)
- last_error_message — TEXT
- 만료일 (expires_at) — TIMESTAMPTZ — NOT NULL
- 완료일 (completed_at) — TIMESTAMPTZ
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
- PG사 (provider) — VARCHAR(30) — NOT NULL
플랜 (plans)
- id — UUID — 기본 키 — NOT NULL
- 플랜 코드 (code) — VARCHAR(100) — NOT NULL
- 플랜명 (name) — VARCHAR(200) — NOT NULL
- 플랜 설명 (description) — TEXT
- 상태 (status) — VARCHAR(30) — NOT NULL — active, inactive
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
플랜 가격 (plan_prices)
- id — UUID — 기본 키 — NOT NULL
- 플랜 Id (plan_id) — UUID — 외래 키 → 플랜.id — NOT NULL
- 가격 코드 (code) — VARCHAR(100) — NOT NULL
- 청구 방식 (billing_type) — VARCHAR(20) — NOT NULL — one_time, recurring
- 수량 (amount) — BIGINT — NOT NULL
- 통화 단위 (currency) — VARCHAR(3) — NOT NULL
- 판매 상태 (status) — VARCHAR(30) — NOT NULL — active, inactive
- 적용 시작 일시 (effective_from) — TIMESTAMPTZ — NOT NULL
- 적용 종료 일시 (effective_to) — TIMESTAMPTZ
- 생성 일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 청구 주기(개월) (interval_months) — INTEGER
- 최소 약정(개월) (commitment_months) — INTEGER
- 이용 개월수(단건) (duration_months) — INTEGER
해지 사유 (termination_reasons)
- 해지 사유 코드 (code) — VARCHAR(100) — 기본 키 — NOT NULL
- 사유 표시명 (label) — VARCHAR(200) — NOT NULL
- 사유 설명 (description) — TEXT
- 사용 여부 (is_active) — BOOLEAN — NOT NULL
- 표시 순서 (display_order) — INTEGER — NOT NULL
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
해지 요청 (termination_requests)
- id — UUID — 기본 키 — NOT NULL
- 구독 ID (subscription_id) — UUID — 외래 키 → 구독.id — NOT NULL
- 해지 사유 코드 (reason_code) — VARCHAR(100) — 외래 키 → 해지 사유.해지 사유 코드
- 신청자 ID(DDB) (requested_by_user_id) — VARCHAR(100) — NOT NULL
- 해지 유형 (request_type) — VARCHAR(40) — NOT NULL — pre_activation_cancel, cooling_off, early_termination, normal_termination, company_fault, unpaid_forced
- 상세 (reason_detail) — TEXT
- 신청 시각 (requested_at) — TIMESTAMPTZ — NOT NULL
- 효력 시각 (effective_at) — TIMESTAMPTZ
- 잔여 약정 금액 (commitment_remaining_amount) — BIGINT — NOT NULL
- 미사용분 환불액 (unused_period_refund_amount) — BIGINT — NOT NULL
- 위약금 (penalty_amount) — BIGINT — NOT NULL
- 설치 실비 (installation_fee_amount) — BIGINT — NOT NULL
- 최종 환불액 (final_refund_amount) — BIGINT — NOT NULL
- 최종 청구액 (final_charge_amount) — BIGINT — NOT NULL
- 적용 정책 (calculation_policy) — VARCHAR(100)
- 계산 입력 스냅샷 (calculation_snapshot) — JSONB
- 상태 (status) — VARCHAR(40) — NOT NULL — requested, calculated, settlement_pending, settlement_partial, settlement_failed, return_pending, return_failed, manual…
- 완료 시각 (completed_at) — TIMESTAMPTZ
- 생성일 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일 (updated_at) — TIMESTAMPTZ — NOT NULL
- 기기 배상액 (device_compensation_amount) — BIGINT — NOT NULL
- 기기회수 필요 여부 (device_return_required) — BOOLEAN — NOT NULL
- 회수 요청 ID (device_return_request_id) — VARCHAR(100)