commerce
Tables (29)
bank_account
- id — BIGINT — Primary key — NOT NULL — 계좌 식별자
- member_id — BIGINT — NOT NULL — 계좌 소유 회원 식별자(members.member_id)
- bank_name — VARCHAR(30) — NOT NULL — 은행 이름(국민·신한·우리·하나·농협·기업·카카오뱅크·토스뱅크)
- account_last4 — CHAR(4) — NOT NULL — 계좌번호 끝 4자리. 계좌번호 전체는 저장하지 않는다(2026-11-04, 실제 지급을 붙일 때 암호문 칸 추가)
- holder_name — VARCHAR(30) — NOT NULL — 예금주(회원이 입력, 로그 금지)
- used_for_withdrawal — BOOLEAN — NOT NULL — 포인트 출금 계좌로 사용 중(회원당 ACTIVE 하나, 부분 UNIQUE)
- used_for_settlement — BOOLEAN — NOT NULL — 정산 계좌로 사용 중(S-04 연결 전, 아직 쓰지 않음)
- status — VARCHAR(20) — NOT NULL — 상태: 사용 중, 해지(계좌를 바꾸면 이전 계좌는 해지)
- verified_at — TIMESTAMPTZ — NOT NULL — 모의 계좌 확인 시각(확인과 등록을 한 요청에서 한다)
- created_at — TIMESTAMPTZ — NOT NULL — 등록 시각
bid_deposit
- id — BIGINT — Primary key — NOT NULL — 입찰 보증금 식별자
- auction_id — BIGINT — NOT NULL — 경매 식별자(경매 서비스)
- member_id — BIGINT — NOT NULL — 입찰자 회원 식별자
- deposit_key — VARCHAR(200) — NOT NULL — 경매가 만든 보증금 키 bid-deposit:{auctionId}:{bidderId}:{입찰 멱등키}. UNIQUE
- amount — BIGINT — NOT NULL — 묶은 보증금(원) = 그 입찰 금액의 30%. 잠금 전에 해제된 키는 0
- status — VARCHAR(20) — NOT NULL — 상태: 묶임, 환급, 주문 이관, 몰수. 묶임은 경매·회원당 하나(부분 UNIQUE). 끝난 키는 다시 묶지 않음
- order_id — BIGINT — Foreign key → purchase_order.id — 낙찰되어 주문으로 옮긴 경우 주문 식별자
- released_reason — VARCHAR(30) — 환급 사유: 경매 해제 요청, 낙찰 때 남은 보증금 정리, 잠금 전 해제, 결제 확인 미완료 만료 반환, 검수 불합격 반환
- version — BIGINT — NOT NULL — 낙관적 잠금
- created_at — TIMESTAMPTZ — NOT NULL — 처음 묶은 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
- artwork_title — VARCHAR(200) — 포인트 내역 표시용 작품명 사본(잠금 요청 artworkTitle, 없으면 NULL). 같은 키 재요청은 처음 값 유지
certificate_transfer
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- certificate_id — BIGINT — NOT NULL — 보증서 식별자(보증서 서비스)
- from_member_id — BIGINT — NOT NULL — 현재 소유자(판매자)
- to_member_id — BIGINT — NOT NULL — 새 소유자(구매자)
- status — VARCHAR(20) — NOT NULL — 이전 작업 상태: 대기, 보류(분쟁), 허가됨, 이전 확정, 운영자 처리
- authorized_at — TIMESTAMPTZ — 이전 허가 시각. 허가 후에는 취소 상태로 덮어쓰지 않는다
- completed_at — TIMESTAMPTZ — 보증서 서비스의 이전 확정 수신 시각
- version — BIGINT — NOT NULL — 낙관적 잠금
- created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
condition_photo
- id — BIGINT — Primary key — NOT NULL — 상태 사진 식별자
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- kind — VARCHAR(20) — NOT NULL — 구분: 발송 전(ARA), 수령 시(구매자)
- object_key — VARCHAR(1024) — NOT NULL — 사진 객체 저장소 키
- uploaded_by — BIGINT — NOT NULL — 올린 회원 식별자
- created_at — TIMESTAMPTZ — NOT NULL — 등록 시각
dispute
- id — BIGINT — Primary key — NOT NULL — 분쟁 식별자
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- opened_by — BIGINT — NOT NULL — 신고한 구매자 식별자
- reason_type — VARCHAR(20) — NOT NULL — 사유: 미배송(NOT_DELIVERED), 파손(DAMAGED), 불일치(MISMATCH)
- description — VARCHAR(500) — 구매자 설명(파손·불일치는 필수)
- status — VARCHAR(20) — NOT NULL — 분쟁 상태: 접수(OPENED), 처리됨(RESOLVED)
- resolution — VARCHAR(30) — 처리 결과: 구매 확정 진행(CONFIRM_PURCHASE), 전체 환불(FULL_REFUND, 경매와 사유 합의 뒤). 처리 전 NULL
- resolved_by — BIGINT — 처리한 운영자 식별자
- resolution_note — VARCHAR(500) — 운영자 처리 사유
- opened_at — TIMESTAMPTZ — NOT NULL — 접수 시각
- resolved_at — TIMESTAMPTZ — 종료 시각
- version — BIGINT — NOT NULL — 낙관적 잠금
dispute_evidence
- id — BIGINT — Primary key — NOT NULL — 증빙 식별자
- dispute_id — BIGINT — Foreign key → dispute.id — NOT NULL — 분쟁 식별자
- submitted_by — BIGINT — NOT NULL — 제출한 회원 식별자
- party — VARCHAR(20) — NOT NULL — 제출 측: 구매자, 운영자
- object_key — VARCHAR(1024) — 증빙 파일 객체 저장소 키
- note — TEXT — 의견·설명
- created_at — TIMESTAMPTZ — NOT NULL — 제출 시각
forfeit_cancellation
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 몰수를 취소한 주문(주문당 1건)
- operator_id — BIGINT — NOT NULL — 취소한 운영자
- reason — VARCHAR(200) — NOT NULL — 취소 사유
- refunded_amount — BIGINT — NOT NULL — 되돌려준 보증금
- created_at — TIMESTAMPTZ — NOT NULL — 취소 시각
inspection
- id — BIGINT — Primary key — NOT NULL — 검수 기록 식별자(보증서 발급 요청의 검수 근거)
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자(UNIQUE)
- result — VARCHAR(10) — NOT NULL — 검수 결과: 통과, 불합격
- reason — VARCHAR(500) — 불합격 사유(통과면 NULL)
- operator_id — BIGINT — NOT NULL — 검수한 운영자 식별자
- inspected_at — TIMESTAMPTZ — NOT NULL — 검수 시각
journal_entry
- id — BIGINT — Primary key — NOT NULL — 분개 식별자
- order_id — BIGINT — Foreign key → purchase_order.id — 관련 주문 식별자
- entry_type — VARCHAR(30) — NOT NULL — 분개 종류: 결제 수납, 수수료 인식, 판매대금 지급, 환불, 보정
- source_type — VARCHAR(30) — NOT NULL — 원인 종류: 결제, 지급, 분쟁, 운영자
- source_id — BIGINT — NOT NULL — 원인 레코드 식별자
- idempotency_key — VARCHAR(200) — NOT NULL — 같은 원인으로 두 번 기록하지 않는 키(UNIQUE)
- corrects_entry_id — BIGINT — Foreign key → journal_entry.id — 보정 분개가 정정하는 원 분개 식별자. 원 분개는 수정하지 않는다
- memo — VARCHAR(500) — 메모
- occurred_at — TIMESTAMPTZ — NOT NULL — 거래 발생 시각
- created_at — TIMESTAMPTZ — NOT NULL — 기록 시각
journal_line
- id — BIGINT — Primary key — NOT NULL — 분개 행 식별자
- entry_id — BIGINT — Foreign key → journal_entry.id — NOT NULL — 분개 식별자
- account_code — VARCHAR(40) — NOT NULL — 계정: PG 미수금, 회원 포인트 예치금, 보증금으로 묶인 포인트, 구매대금 예치금, 구매수수료 수익, 판매 수수료 수익, 판매자 지급 예정, 배송비 지급 예정, 지급·출금 완료, 환불, 출금 대기(WITHDRAW…
- member_id — BIGINT — 계정 상대 회원(판매자·구매자)
- debit — BIGINT — NOT NULL — 차변(원)
- credit — BIGINT — NOT NULL — 대변(원)
order_delivery_address
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- recipient_name — VARCHAR(50) — NOT NULL — 받는 분
- phone — VARCHAR(30) — NOT NULL — 연락처
- postal_code — VARCHAR(10) — NOT NULL — 우편번호
- address1 — VARCHAR(200) — NOT NULL — 주소
- address2 — VARCHAR(200) — 상세 주소
- request_note — VARCHAR(200) — 배송 요청 사항
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
order_status_history
- id — BIGINT — Primary key — NOT NULL — 이력 식별자
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- from_status — VARCHAR(30) — 이전 상태
- to_status — VARCHAR(30) — NOT NULL — 바뀐 상태
- actor_type — VARCHAR(20) — NOT NULL — 바꾼 주체: 구매자, 판매자, 운영자, 시스템
- actor_id — BIGINT — 바꾼 회원 식별자(시스템이면 NULL)
- reason — VARCHAR(500) — 사유
- changed_at — TIMESTAMPTZ — NOT NULL — 바뀐 시각
outbox_event
- event_id — UUID — Primary key — NOT NULL — 이벤트 고유 식별자
- event_type — VARCHAR(100) — NOT NULL — 이벤트 종류: PaymentConfirmed, PurchaseConfirmed, DisputeOpened 등
- aggregate_id — VARCHAR(100) — NOT NULL — 이벤트가 속한 업무 객체 식별자
- aggregate_version — BIGINT — NOT NULL — 업무 객체의 이벤트 버전
- idempotency_key — VARCHAR(200) — NOT NULL — 같은 업무 이벤트의 중복 생성을 막는 키
- schema_version — VARCHAR(20) — NOT NULL — 이벤트 payload 스키마 버전
- payload — JSONB — NOT NULL — 이벤트 본문 데이터
- occurred_at — TIMESTAMPTZ — NOT NULL — 업무 이벤트 발생 시각
- traceparent — VARCHAR(100) — 분산 추적을 위한 trace context
- attempts — INTEGER — NOT NULL — 이벤트 전송 시도 횟수
- last_attempted_at — TIMESTAMPTZ — 마지막 전송 시도 시각
- published_at — TIMESTAMPTZ — 전송 성공 시각. 미전송이면 NULL
- next_attempt_at — TIMESTAMPTZ — 실패 뒤 다음 전송 시도 시각(5초부터 두 배씩, 최대 5분)
- lease_until — TIMESTAMPTZ — 발행 루프 선점 기한. 이 시각 전에는 다른 서버가 잡지 않음
- last_error_code — VARCHAR(100) — 마지막 전송 실패 코드(SDK 오류 코드만, 본문 없음)
payment
- id — BIGINT — Primary key — NOT NULL — 결제 식별자
- order_id — BIGINT — Foreign key → purchase_order.id — 낙찰 결제면 주문 식별자. 실패 후 재시도하면 한 주문에 여러 결제 시도가 생긴다
- point_charge_id — BIGINT — Foreign key → point_charge.id — 포인트 충전이면 충전 요청 식별자. order_id와 둘 중 하나만 값이 있다
- pg_order_id — VARCHAR(64) — NOT NULL — PG에 보낸 가맹점 주문 번호(UNIQUE). 결제 시도마다 새로 만든다
- payment_key — VARCHAR(200) — PG 결제 키(UNIQUE). 승인 요청 전에는 NULL
- method — VARCHAR(20) — NOT NULL — 요청한 결제 수단: 카드(카드·간편결제 결제창), 가상계좌
- amount — BIGINT — NOT NULL — 결제 요청 금액(원). 승인·웹훅 금액과 대조한다
- point_amount — BIGINT — NOT NULL — 포인트 + 카드에서 이 시도가 묶은 포인트(원). 카드 전액이면 0
- status — VARCHAR(30) — NOT NULL — 결제 상태: 준비, 승인 요청, 입금 대기, 완료, 실패, 취소, 기한 만료
- pg_method — VARCHAR(20) — PG가 알려 준 실제 결제수단: 카드, 간편결제, 가상계좌 등. 카드 결제창에서 간편결제를 고를 수 있어 method와 다를 수 있다
- easy_pay_provider — VARCHAR(30) — 간편결제사(토스 값 그대로, 예: 카카오페이). 간편결제가 아니면 NULL
- cash_receipt_type — VARCHAR(20) — 현금영수증(가상계좌만): 소득공제, 지출증빙, 미발행. 카드는 NULL
- failure_code — VARCHAR(100) — PG 실패 코드
- failure_message — VARCHAR(500) — PG 실패 사유(민감정보 없이)
- requested_at — TIMESTAMPTZ — NOT NULL — 결제 시작 시각(결제 행 생성 시각)
- approved_at — TIMESTAMPTZ — PG 승인 시각
- canceled_at — TIMESTAMPTZ — 취소·환불 시각
- refund_requested_at — TIMESTAMPTZ — 검수 불합격 카드 환불 요청 시각(DONE이면 취소 확인 전, 진행 작업이 다시 보냄)
- version — BIGINT — NOT NULL — 낙관적 잠금
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
payment_deadline_extension
- id — BIGINT — Primary key — NOT NULL — 연장 기록 식별자
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- reason_type — VARCHAR(20) — NOT NULL — 이유: 늦게 받은 낙찰(LATE_ORDER), 거래 서버 멈춤(SERVER_OUTAGE), 운영자 일괄 연장(OPERATOR)
- batch_key — VARCHAR(100) — NOT NULL — 같은 연장 요청을 가르는 값(주문마다 한 번, UNIQUE(batch_key, order_id))
- previous_due_at — TIMESTAMPTZ — NOT NULL — 늘리기 전 결제 기한
- new_due_at — TIMESTAMPTZ — NOT NULL — 늘린 결제 기한
- operator_id — BIGINT — 운영자 식별자(OPERATOR만)
- reason — VARCHAR(200) — 운영자 연장 사유
- created_at — TIMESTAMPTZ — NOT NULL — 기록 시각
payment_deadline_extension_request
- batch_key — VARCHAR(100) — Primary key — NOT NULL — 운영자 연장 요청 키
- operator_id — BIGINT — NOT NULL — 요청한 운영자 식별자
- hours — INTEGER — NOT NULL — 처음 요청의 연장 시간(같은 키를 다시 받으면 이 값을 돌려줌)
- created_at — TIMESTAMPTZ — NOT NULL — 요청 시각
payout
- id — BIGINT — Primary key — NOT NULL — 지급 식별자
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- payee_id — BIGINT — NOT NULL — 받는 판매자 회원 식별자
- kind — VARCHAR(30) — NOT NULL — 지급 종류: 판매대금, 미결제 보증금
- bank_account_id — BIGINT — Foreign key → bank_account.id — 지급 요청 때의 정산 계좌. 없으면 등록할 때까지 보관
- bank_name — VARCHAR(30) — 요청 시점 계좌 사본: 은행 이름
- account_last4 — CHAR(4) — 요청 시점 계좌 사본: 끝 4자리. 0000이면 요청 다음에 실패(시연용)
- holder_name — VARCHAR(30) — 요청 시점 계좌 사본: 예금주
- next_step_at — TIMESTAMPTZ — 진행 작업이 다음 단계로 넘길 시각. 계좌 대기·완료는 NULL
- failed_at — TIMESTAMPTZ — 마지막 지급 실패 시각
- amount — BIGINT — NOT NULL — 지급액(원). 판매대금 = 낙찰가 − 판매수수료 + 배송비, 미결제 보증금 = 보증금 − 보증금의 3%
- status — VARCHAR(20) — NOT NULL — 지급 상태: 보관 중, 보류(분쟁), 지급 요청, 지급 완료, 실패
- attempts — INTEGER — NOT NULL — 모의 지급 시도 횟수(P05 재시도)
- failure_reason — VARCHAR(500) — 실패 사유
- requested_at — TIMESTAMPTZ — 지급 요청 시각
- completed_at — TIMESTAMPTZ — 지급 완료 시각
- version — BIGINT — NOT NULL — 낙관적 잠금
- created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
point_account
- member_id — BIGINT — Primary key — NOT NULL — 회원 식별자(members.member_id)
- available_amount — BIGINT — NOT NULL — 사용 가능 포인트(원). 입찰 보증금·결제·출금에 쓴다
- held_amount — BIGINT — NOT NULL — 입찰 보증금으로 묶인 포인트(원). 보유 = 사용 가능 + 묶임
- version — BIGINT — NOT NULL — 낙관적 잠금
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
point_charge
- id — BIGINT — Primary key — NOT NULL — 충전 요청 식별자
- member_id — BIGINT — NOT NULL — 회원 식별자
- amount — BIGINT — NOT NULL — 충전 금액(원, 1만 원 단위)
- status — VARCHAR(20) — NOT NULL — 상태: 준비(결제 전·결제창 취소), 승인 요청(확인 중), 입금 대기(가상계좌), 완료, 실패, 취소(입금 기한 만료)
- requested_at — TIMESTAMPTZ — NOT NULL — 요청 시각(행 생성 시각)
- completed_at — TIMESTAMPTZ — 잔액 반영 시각(승인 확인 후)
- failed_at — TIMESTAMPTZ — 충전 실패 시각
- canceled_at — TIMESTAMPTZ — 입금 기한 만료로 가상계좌를 취소한 시각(V19)
- version — BIGINT — NOT NULL — 낙관적 잠금
point_transaction
- id — BIGINT — Primary key — NOT NULL — 포인트 내역 식별자
- member_id — BIGINT — NOT NULL — 회원 식별자
- type — VARCHAR(30) — NOT NULL — 종류: 충전, 보증금 차감, 보증금 환급, 결제 사용, 결제 환불, 보증금 몰수, 출금 신청, 출금 실패 되돌림
- amount — BIGINT — NOT NULL — 금액(원, 0보다 큼). 늘었는지 줄었는지는 종류로 판단
- available_after — BIGINT — NOT NULL — 처리 뒤 사용 가능 포인트
- held_after — BIGINT — NOT NULL — 처리 뒤 묶인 포인트
- source_type — VARCHAR(30) — NOT NULL — 원인 종류: 충전, 입찰 보증금, 주문, 출금
- source_id — BIGINT — NOT NULL — 원인 레코드 식별자
- idempotency_key — VARCHAR(200) — NOT NULL — 같은 사건을 두 번 반영하지 않는 키(UNIQUE)
- occurred_at — TIMESTAMPTZ — NOT NULL — 발생 시각
point_withdrawal
- id — BIGINT — Primary key — NOT NULL — 출금 식별자
- member_id — BIGINT — NOT NULL — 회원 식별자
- amount — BIGINT — NOT NULL — 출금 금액(원, 1 이상)
- status — VARCHAR(20) — NOT NULL — 상태: 신청, 처리 중, 완료, 실패
- bank_account_id — BIGINT — Foreign key → bank_account.id — NOT NULL — 신청 때 사용 중이던 출금 계좌(나중에 해지돼도 그대로)
- bank_name — VARCHAR(30) — NOT NULL — 신청 시점 계좌 사본: 은행 이름
- account_last4 — CHAR(4) — NOT NULL — 신청 시점 계좌 사본: 끝 4자리. 0000이면 처리 중 다음에 실패(시연용 테스트 계좌)
- holder_name — VARCHAR(30) — NOT NULL — 신청 시점 계좌 사본: 예금주
- failure_code — VARCHAR(40) — 실패 사유 코드(ACCOUNT_REJECTED). 화면에는 일반 안내만
- requested_at — TIMESTAMPTZ — NOT NULL — 신청 시각. 이때 사용 가능 포인트에서 뺀다
- processing_at — TIMESTAMPTZ — 처리 중으로 넘어간 시각
- completed_at — TIMESTAMPTZ — 완료 시각
- failed_at — TIMESTAMPTZ — 실패 시각(포인트를 되돌린 시각)
- next_step_at — TIMESTAMPTZ — 진행 작업이 다음 단계로 넘길 시각(끝나면 NULL)
- version — BIGINT — NOT NULL — 단계가 바뀔 때마다 1 증가
- idempotency_key — VARCHAR(100) — 화면이 보낸 멱등성 키(V22). 회원별 UNIQUE, 키 없이 들어온 신청은 NULL
processed_event
- consumer — VARCHAR(100) — Primary key — NOT NULL — 이벤트를 처리한 소비자 이름
- event_id — UUID — Primary key — NOT NULL — 처리한 이벤트 식별자
- processed_at — TIMESTAMPTZ — NOT NULL — 처리 시각
purchase_confirmation
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- automatic — BOOLEAN — NOT NULL — 자동 구매 확정 여부
- confirmed_by — BIGINT — 확정한 구매자 식별자(자동 확정이면 NULL)
- confirmed_at — TIMESTAMPTZ — NOT NULL — 구매 확정 시각
purchase_order
- id — BIGINT — Primary key — NOT NULL — 주문 식별자
- auction_id — BIGINT — NOT NULL — 낙찰된 경매 식별자(경매 서비스). AuctionWon 하나에 주문 하나(UNIQUE)
- artwork_id — BIGINT — NOT NULL — 작품 식별자(작품 서비스)
- certificate_id — BIGINT — 디지털 보증서 식별자(보증서 서비스)
- buyer_id — BIGINT — NOT NULL — 구매자(낙찰자) 회원 식별자
- seller_id — BIGINT — NOT NULL — 판매자 회원 식별자(첫 판매는 작가, 재판매는 소장자)
- hammer_price — BIGINT — NOT NULL — 낙찰가(원)
- buyer_fee_rate_bp — INTEGER — NOT NULL — 주문 생성 시 고정한 구매수수료율(만분율, 설정값에서 복사)
- buyer_fee — BIGINT — NOT NULL — 구매수수료(원)
- seller_fee_rate_bp — INTEGER — NOT NULL — 주문 생성 시 고정한 판매 수수료율(만분율, 설정값에서 복사)
- seller_fee — BIGINT — NOT NULL — 판매 수수료(원)
- shipping_tier — VARCHAR(20) — NOT NULL — 배송비 등급 SMALL·MEDIUM·LARGE·XLARGE(AuctionWon으로 받아 고정)
- shipping_fee — BIGINT — NOT NULL — 배송비(원). 종이 규격 등급 배송비의 사본(경매 생성 때 고정)
- total_amount — BIGINT — NOT NULL — 구매자 총액 = 낙찰가 + 구매수수료 + 배송비
- deposit_amount — BIGINT — NOT NULL — 주문으로 옮긴 입찰 보증금(원) = 낙찰가의 30%, 원 미만 올림
- amount_due — BIGINT — NOT NULL — 결제할 금액 = 총액 − 보증금(낙찰가의 70% + 구매수수료 + 배송비)
- point_paid_amount — BIGINT — NOT NULL — 결제할 금액 중 ARA 포인트로 낸 금액(원). 나머지는 PG 결제
- status — VARCHAR(30) — NOT NULL — 주문 상태: 결제 대기, 결제 확인 중, 결제 완료(보관 중), 발송 준비, 배송 중, 배송 완료, 구매 확정, 분쟁 중, 결제 기한 만료, 환불 완료
- payment_due_at — TIMESTAMPTZ — NOT NULL — 결제 기한
- paid_at — TIMESTAMPTZ — 결제 확정 시각
- purchase_confirmed_at — TIMESTAMPTZ — 구매 확정 시각
- auto_confirm_at — TIMESTAMPTZ — 자동 구매 확정 예정 시각(배송 완료 + 이의 제기 기간). 분쟁 중이면 실행하지 않는다
- version — BIGINT — NOT NULL — 낙관적 잠금·이벤트 aggregateVersion
- created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
- updated_at — TIMESTAMPTZ — NOT NULL — 수정 시각
- won_at — TIMESTAMPTZ — NOT NULL — 낙찰 시각(AuctionWon.closedAt). 결제 기한 = 낙찰 시각 + 24시간
- artwork_title — VARCHAR(200) — 포인트 내역 표시용 작품명 사본(AuctionWon.artworkTitle, 없으면 NULL). 받은 뒤 고치지 않음
- artwork_content_revision — BIGINT — 낙찰 때 고정한 출품 작품 정보 버전(AuctionWon.artworkContentRevision). 보증서 발급 요청 contentRevision에 싣는다. 예전 주문은 NULL
- sale_type — VARCHAR(20) — 판매 구분: 첫 판매(FIRST_SALE), 재판매(RESALE). AuctionWon.saleType 사본, 보증서 발급 요청(CertificateIssuanceRequested.saleType)으로 넘김. 없거…
scheduler_gap
- id — BIGINT — Primary key — NOT NULL — 공백 기록 식별자
- name — VARCHAR(50) — NOT NULL — 스케줄러 이름
- started_at — TIMESTAMPTZ — NOT NULL — 공백 시작(직전 정상 실행)
- ended_at — TIMESTAMPTZ — NOT NULL — 공백 끝(다시 실행된 시각)
scheduler_heartbeat
- name — VARCHAR(50) — Primary key — NOT NULL — 주기 작업 이름(payment-expiry)
- last_run_at — TIMESTAMPTZ — NOT NULL — 마지막 실행 시각. 오래 끊기면 그 시간만큼 결제 기한을 늘림
shipment
- order_id — BIGINT — Foreign key → purchase_order.id — NOT NULL — 주문 식별자
- stage — VARCHAR(30) — NOT NULL — 배송 단계: 판매자 발송 대기, 판매자 발송, 입고(검수 대기), 검수 통과, ARA 발송, 배송 완료, 검수 불합격 반송
- carrier — VARCHAR(50) — ARA 발송 택배사 이름(모의 배송은 ARA 배송)
- seller_tracking_number — CHAR(12) — 판매자 → ARA 송장(서버 생성 12자리, UNIQUE)
- tracking_number — CHAR(12) — ARA → 구매자 송장(서버 생성 12자리, UNIQUE)
- recipient_name — VARCHAR(50) — 받는 분(주문 시점 사본)
- phone — VARCHAR(30) — 연락처(주문 시점 사본)
- postal_code — VARCHAR(10) — 우편번호
- address1 — VARCHAR(200) — 주소
- address2 — VARCHAR(200) — 상세 주소
- request_note — VARCHAR(200) — 배송 요청사항
- created_at — TIMESTAMPTZ — NOT NULL — 결제 완료(판매자 발송 대기) 시각
- seller_shipped_at — TIMESTAMPTZ — 판매자 발송 시각
- inbound_at — TIMESTAMPTZ — ARA 도착(입고) 시각
- inspection_passed_at — TIMESTAMPTZ — 실물 검수 통과 시각
- shipped_at — TIMESTAMPTZ — ARA 발송 시각
- delivered_at — TIMESTAMPTZ — 배송 완료 시각
- returned_at — TIMESTAMPTZ — 검수 불합격 판매자 반송 시각
- next_step_at — TIMESTAMPTZ — 다음 단계로 자동으로 넘길 시각(검수 대기·확정 뒤 NULL)
- version — BIGINT — NOT NULL — 단계가 바뀔 때마다 1 증가
shipping_address
- id — BIGINT — Primary key — NOT NULL — 저장 배송지 식별자
- member_id — BIGINT — NOT NULL — 소유 회원 식별자
- recipient_name — VARCHAR(50) — NOT NULL — 받는 분
- phone — VARCHAR(30) — NOT NULL — 연락처
- postal_code — VARCHAR(10) — NOT NULL — 우편번호
- address1 — VARCHAR(200) — NOT NULL — 주소
- address2 — VARCHAR(200) — 상세 주소
- consented_at — TIMESTAMPTZ — NOT NULL — "다음 결제에도 사용" 저장 동의 시각(행 생성 시각)
- last_used_at — TIMESTAMPTZ — 마지막 사용 시각("지난 배송지로 받을까요?")
- deleted_at — TIMESTAMPTZ — 삭제 시각
virtual_account
- payment_id — BIGINT — Foreign key → payment.id — NOT NULL — 결제 식별자
- bank_code — VARCHAR(20) — NOT NULL — 입금 은행 코드
- account_number — VARCHAR(50) — NOT NULL — 발급된 가상계좌 번호(구매자 화면 표시용, 로그 금지)
- deposit_due_at — TIMESTAMPTZ — NOT NULL — 입금 기한(= 주문 결제 기한)
- deposited_at — TIMESTAMPTZ — 입금 확인 시각(웹훅 수신 후 조회 API로 재확인)
- created_at — TIMESTAMPTZ — NOT NULL — 발급 시각
- webhook_secret — VARCHAR(50) — 토스 입금 콜백 검증 값(승인·조회 응답에 옴, 없으면 NULL, 로그 금지)