test
Tables (6)
checkouts
- id — uuid — Primary key — NOT NULL — 결제 결제 1건. 재판정 앵커
- account_id — bigint — NOT NULL — 결제 결제 회원
- total_amount — bigint — NOT NULL — 결제 결제 총액
- cancelled_amount — bigint — NOT NULL — 결제 ★취소분 누계★ 부분취소가 여기 쌓인다. total_amount 는 안 줄어든다
- status — varchar(20) — NOT NULL — 결제 PENDING / PAID / ...
- paid_at — timestamptz — 결제 결제 확정 시각
insurance_cancel_requests
- id — uuid — Primary key — NOT NULL — app PK. 앱 미노출
- request_group_id — uuid — NOT NULL — app ★신청 단위★ 한 번의 申請する(API-103 1회)로 함께 접수된 행들이 공유. 관리자 검수 묶음. ※환불 실행 키가 아니다
- enrollment_id — uuid — Foreign key → insurance_enrollments.id — NOT NULL — app 소속 가입. 가입 단위 이력 조회용 비정규화. FK
- insured_person_id — uuid — Foreign key → insured_persons.id — NOT NULL — app 취소 대상 加入者. 이 테이블의 주어. FK
- requested_by — bigint — NOT NULL — app 신청 계정(accounts.id). 대표자와 동일하나 이력에 명시
- requested_at — timestamptz — NOT NULL — app 접수 일시. 같은 request_group_id 행들이 동일 값
- refund_amount — bigint — NOT NULL — app 신청 시점 예상 환불액 스냅샷. 🟠 산정 공식 미결(#1178) — 값만 forward
- decision — varchar(20) — NOT NULL — admin RA-20 판정. PENDING(대기·기본값) / APPROVED(승인=환불 실행 대상) / REJECTED(반려). ★행 단위로 갈린다(인원별 판정)★
- decision_batch_id — uuid — admin RA-20 ★승인 단위★ 한 번의 판정 조작으로 승인된 행들이 공유. = service_cancellations.approval_ref. APPROVED 일 때만 NOT NULL
- decided_at — timestamptz — admin RA-20 판정 일시. PENDING 이면 NULL
- decided_by — varchar(255) — admin RA-20 판정 관리자 식별자
- decision_note — text — admin RA-20 판정 메모(운영자 입력). 앱 응답 미노출
- created_at — timestamptz — NOT NULL — app 생성 시각
- updated_at — timestamptz — NOT NULL — app/admin 수정 시각(판정 UPDATE 반영)
insurance_enrollments
- id — uuid — Primary key — NOT NULL — checkout PK. orders.domain_ref_id 가 가리키는 대상. 앱 미노출
- account_id — bigint — NOT NULL — checkout 가입자(대표자·결제 회원). 조회 시 소유자 검증 기준
- travel_start_date — date — NOT NULL — checkout 여행 시작일 = 보장 개시일. 보험나이 기산 기준
- travel_end_date — date — NOT NULL — checkout 여행 종료일(귀국일). 최대 60일
- total_premium — bigint — NOT NULL — checkout파생 총 보험료 스냅샷. ⚠ insured_persons.premium 합계 = orders.order_amount 와 같은 값 → 중복 저장 검토 대상
- agreement_at — timestamptz — NOT NULL — checkout 약관 동의 시각. 결제 트랜잭션 완료 시각으로 보존 (QNA-281)
- enrolled_at — timestamptz — NOT NULL — checkout 보험 효력 발생 시각. 결제 완료 = 효력 성립 (QNA-283)
- meritz_submission_status — varchar(20) — NOT NULL — admin RA-19 메리츠 송부 상태. PENDING / SUBMITTED. v2는 수동 송부
- meritz_submitted_at — timestamptz — admin RA-19 송부 완료 시각. PENDING 이면 NULL
- created_at — timestamptz — NOT NULL — checkout 생성 시각
- updated_at — timestamptz — NOT NULL — checkout/admin 수정 시각. 가입 사실은 불변이나 admin 송부 상태가 갱신됨
- deleted_at — timestamptz — 운영 시정용 소프트 삭제. 법정 5년 보존(POL-026)이 우선
insured_persons
- id — uuid — Primary key — NOT NULL — checkout PK 겸 ★취소 대상 식별자★. service_cancellations.target_refs.ref_id 로 지목됨(ref_kind=INSURED_PERSON)
- enrollment_id — uuid — Foreign key → insurance_enrollments.id — NOT NULL — checkout 소속 가입. FK
- family_name_encrypted — text — NOT NULL — checkout 姓(ローマ字). ★PII 양방향 암호화 POL-030★
- given_name_encrypted — text — NOT NULL — checkout 名(ローマ字). ★PII 양방향 암호화 POL-030★
- birth_date_encrypted — text — NOT NULL — checkout 生年月日. ★PII 양방향 암호화 POL-030★. 앱 상세는 보험나이만 표시
- gender — varchar(10) — NOT NULL — checkout MALE / FEMALE. 요금표 룩업 키라 평문
- insurance_age — integer — NOT NULL — checkout 보험나이 스냅샷(개시일 만나이+6개월↑ 반올림). 룩업 키라 평문. 규칙 바뀌어도 기가입분 불변
- premium — bigint — NOT NULL — checkout 이 사람 1인 보험료. 부분취소 환불액 산정의 근거. 룩업·산정 값이라 평문
- policy_number — varchar(30) — admin RA-19 증권번호 MR-XXXX-XXXXXA. 메리츠 발급 후 관리자 입력. 발급 전 NULL
- cancel_status — varchar(20) — NOT NULL — app/결제/admin ★3주체가 쓴다★ NONE / REQUESTED(app,API-103) / CANCELLED(결제,SETTLED 수신) / REJECTED(admin,반려). 표시용 최신 캐시 — 이력 정본…
- cancel_requested_at — timestamptz — app 취소 신청 접수 시각
- cancel_decided_at — timestamptz — admin 관리자 판정 시각. 반려 후 재신청으로 REQUESTED 되면 NULL 로 되돌림
- refund_amount — bigint — app/admin파생 환불 표시 금액. 🟠 산정 공식 미결(#1178). 이력 최신 행의 복제 — 정본 아님
- version — bigint — NOT NULL — app/결제/admin 낙관적 잠금. ★세 주체가 같은 행을 갱신하므로 필수★
- created_at — timestamptz — NOT NULL — checkout 생성 시각
- updated_at — timestamptz — NOT NULL — app/결제/admin 수정 시각
- deleted_at — timestamptz — 운영 시정용 소프트 삭제
orders
- id — uuid — Primary key — NOT NULL — 결제 주문 1건 = 서비스 1종
- checkout_id — uuid — Foreign key → checkouts.id — NOT NULL — 결제 소속 결제. FK
- account_id — bigint — NOT NULL — 결제 주문자
- service_type — varchar(20) — NOT NULL — 결제 ESIM / TAXI / INSURANCE
- order_no — varchar(20) — NOT NULL — 결제 ★예약번호 정본★ 보험은 RH- + yyMMdd + 랜덤7 = 13자리. 보험 도메인은 이 값을 복제 저장하지 않는다
- order_amount — bigint — NOT NULL — 결제 ★결제 금액 정본★ = insurance_enrollments.total_premium 과 같은 값. 부분취소해도 줄지 않는다("영수증")
- paid_at — timestamptz — NOT NULL — 결제 결제 확정 시각
- domain_ref_id — uuid — 결제 ★도메인 실체 참조★ 보험 = insurance_enrollments.id. ⚠FK 없음(느슨한 결합) — 아래 주석 참고
service_cancellations
- id — uuid — Primary key — NOT NULL — 결제 환불 실행 1건 = 헥토 사용취소 1회. 이 id 가 헥토 mTrdNo
- checkout_id — uuid — Foreign key → checkouts.id — NOT NULL — 결제 원 결제. FK
- cancel_amount — bigint — NOT NULL — 결제 이번 환불 금액. 도메인이 산출한 값과 일치해야 통과(교차검증)
- target_refs — jsonb — NOT NULL — 결제 취소 대상. 구조 고정 {order_id, ref_kind, ref_id}. 보험은 ref_kind=INSURED_PERSON, ref_id=insured_persons.id
- approval_ref — varchar(255) — 결제 ★승인 건 식별자★ 보험은 = insurance_cancel_requests.decision_batch_id. (checkout_id, approval_ref) 부분 유니크로 같은 승인 재실행 차단
- status — varchar(20) — NOT NULL — 결제 REQUESTED / COMPLETED / FAILED / OUTCOME_UNKNOWN. ⚠이건 status 값이지 도메인에 오는 신호가 아니다
- settled_at — timestamptz — 결제 ★진짜 완료 신호★ 잔액 복원 완료 시각. COMPLETED 인데 NULL 이면 아직 돈 안 돌아옴