티샷

테이블 (9)

entitlement_grants (entitlement_grants(이용권 부여기록))

  • grant_id — BIGINT — 기본 키 — NOT NULL
  • payment_id — BIGINT — 외래 키 → payments.id — NOT NULL — 부여 근거 결제
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 회원
  • tier — ENUM('basic', 'premium') — NOT NULL — 이용권 등급
  • granted_from — DATETIME — NOT NULL — 이 결제가 부여한 구간 시작
  • granted_to — DATETIME — NOT NULL — 이 결제가 부여한 구간 종료
  • revoked_at — DATETIME — 회수 시각(전액환불 등). NULL=유효. users 만료일 = 유효 grant의 MAX(granted_to)
  • created_at — DATETIME — NOT NULL

money_ledger(기프트 머니 원장) (money_ledger)

  • ledger_id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 회원
  • delta — INT — NOT NULL — +적립 / -차감 (원)
  • balance_after — INT — NOT NULL — 처리 후 잔액(원)
  • reason — ENUM('opening_balance', 'purchase', 'refund_reversal', 'exchange', 'admin_adjust') — NOT NULL — opening_balance=최초 잔액 이관, purchase=구매 적립, refund_reversal=환불 반전, exchange=환전, admin_adjust=운영자 조정
  • ref_type — VARCHAR(20) — 근거 유형 (payment/exchange 등)
  • ref_id — BIGINT — 근거 id (payments.id 또는 giftmoney_exchange.id)
  • created_at — DATETIME — NOT NULL

payment_audit_log(결제 상태 변경 감사 로그) (payment_audit_log)

  • id — BIGINT — 기본 키 — NOT NULL
  • payment_id — BIGINT — 외래 키 → payments.id — NOT NULL — 대상 결제
  • action — VARCHAR(30) — NOT NULL — 수행 작업 (cancel/delete/refund/restore 등)
  • actor_admin_id — BIGINT — 수행 운영자 ID. NULL=시스템(웹훅 등)
  • before_snapshot — JSON — NOT NULL — 변경 전 스냅샷 (payments row + users.money·만료일)
  • after_snapshot — JSON — NOT NULL — 변경 후 스냅샷
  • created_at — DATETIME — NOT NULL

payment_channels (payment_channels(결제채널 ))

  • channel_code — VARCHAR(20) — 기본 키 — NOT NULL — 채널 코드 (card/apple_iap/google_iap/benepia 등)
  • channel_name — VARCHAR(50) — NOT NULL — 표시명
  • channel_type — ENUM('pg', 'iap', 'manual') — NOT NULL — pg=서버가 결제·환불 API 직접 호출, iap=스토어가 청구·환불 주관, manual=시스템 외부 처리(무통장 등)
  • provider — VARCHAR(50) — NOT NULL — 제공자 (kg_inicis/apple/google 등)
  • adapter_class — VARCHAR(100) — NOT NULL — 서버 어댑터 클래스명 (예: CardPgAdapter)
  • supports_subscription — TINYINT — NOT NULL — 정기결제 지원 여부
  • supports_server_refund — TINYINT — NOT NULL — 서버에서 환불 API 호출 가능 여부. 0이면 스토어 수동 처리 후 확인 기록
  • status — ENUM('active', 'legacy', 'disabled') — NOT NULL — active=사용중, legacy=신규결제 불가·과거 데이터 표시용(benepia), disabled=중지
  • config — JSON — 엔드포인트·머천트ID 등 채널별 설정. 코드 하드코딩 금지
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

payments

  • id — INT — 기본 키 — NOT NULL — 결제 ID
  • user_id — INT — 외래 키 → users.id — NOT NULL — 회원 (users.id)
  • field_id — INT — NOT NULL — 골프장 ID (프리미엄 연계)
  • transaction_id — VARCHAR(255) — 거래 ID — 구글: GPA 주문번호(갱신마다 ..N), 애플: 현재 체인ID(회차전환 후 회차별 ID), PG: 거래번호
  • purchase_id — VARCHAR(255) — 구독 그룹키(iaptic purchaseId: 애플 originalTransactionId/구글 구독 식별자). 회차별 ID는 transaction_id에 저장
  • payment_type — VARCHAR(255) — NOT NULL — 결제 채널 자유 문자열 (inapp/무통장/benepiaPoint) — product_code_map.channel_code로 대체 예정
  • item_code — VARCHAR(30) — NOT NULL — 상품코드 (n1/sub_nn/g10 등) → product_code_map 참조
  • item_name — VARCHAR(255) — NOT NULL — 결제 당시 상품명
  • item_price — INT — NOT NULL — 결제 당시 금액(불변)
  • recurring — TINYINT — NOT NULL — 정기결제 여부
  • realname — VARCHAR(255) — 회원명 스냅샷
  • phone — VARCHAR(255) — 연락처 스냅샷
  • email — VARCHAR(255) — NOT NULL — 이메일 스냅샷
  • receipt — LONGTEXT — 영수증 원문 (검증 재수행용)
  • signature — LONGTEXT — 구글 영수증 서명
  • started_at — DATETIME — 이용권 시작 (기프트머니는 제로날짜)
  • ended_at — DATETIME — 이용권 종료 — 애플은 현재 갱신 시 이 값을 연장(in-place), 회차전환 후 회차별 고정
  • canceled_at — DATETIME — 취소신청/웹훅 취소예약 시각
  • deleted_at — TIMESTAMP — 환불(매출제외) 소프트 삭제
  • price_consent_status — VARCHAR(20) — 가격변경 동의 상태 (Agreed/Declined)
  • price_consent_updated_at — DATETIME
  • subscription_status — VARCHAR(20) — 구독 상태 (billing_retry/expired 등)
  • renewal_number — INT — 갱신 회차 (iaptic renewalNumber)
  • created_at — TIMESTAMP — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

product_code_map(상품코드매핑) (product_code_map)

  • item_code — VARCHAR(50) — 기본 키 — NOT NULL — payments.item_code 문자열 그대로 (n1/sub_nn/sub_kg_n/g10 등)
  • channel_code — VARCHAR(20) — 외래 키 → payment_channels.channel_code — NOT NULL — 판매 채널
  • tier — ENUM('basic', 'premium', 'giftmoney', 'none') — NOT NULL — 상품 등급. none=기타(리워드 등)
  • period_months — INT — 이용기간(개월). 기간 상품만
  • grant_money — INT — 기프트머니 지급액(원). g시리즈만
  • store_product_id — VARCHAR(100) — 스토어 상품ID (Apple product id/Google SKU/PG 상품코드)
  • price — INT — NOT NULL — 판매가(원). PHP 하드코딩 가격 switch 대체
  • use_yn — CHAR(1) — NOT NULL — Y=판매중, N=판매중지(과거 결제 판정용으로만 유지)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

refund_requests(환불 처리 상태관리) (refund_requests)

  • refund_id — BIGINT — 기본 키 — NOT NULL
  • payment_id — BIGINT — 외래 키 → payments.id — NOT NULL — 대상 결제 (정기결제는 해당 회차 row)
  • action_type — ENUM('cancel_subscription', 'refund_and_cancel', 'refund_only') — NOT NULL — cancel_subscription=구독취소만(환불없음), refund_and_cancel=환불+구독취소, refund_only=환불만(구독유지)
  • amount — INT — 환불액(원). 구독취소만이면 NULL
  • refund_type — ENUM('full', 'partial') — full=전액환불→이용권 즉시종료, partial=부분환불→이용권 유지. 구독취소만이면 NULL
  • revoke_entitlement — TINYINT — NOT NULL — 이용권 즉시종료 여부. refund_type에서 자동 결정(full→1, partial→0). 운영자 선택값 아님
  • status — ENUM('requested', 'external_confirmed', 'completed', 'failed') — NOT NULL — requested→(스토어/PG 외부처리)→external_confirmed→(내부 회수 트랜잭션)→completed. 실패 시 failed 후 재처리
  • initiated_by — ENUM('admin', 'store', 'user') — NOT NULL — admin=운영자 시작, store=iaptic 환불신호, user=사용자 스토어 환불(애플)
  • external_ref — VARCHAR(100) — 스토어 주문ID / PG 취소 승인번호
  • confirmed_by — BIGINT — 외부 환불을 확인 기록한 운영자 ID (수동 확인 시)
  • fail_reason — VARCHAR(500) — 실패 사유
  • requested_by — BIGINT — 요청 등록 운영자 ID (store/user 주도면 NULL)
  • requested_at — DATETIME — NOT NULL
  • completed_at — DATETIME

subscription_state (정기결제 구독 상태) (subscription_state)

  • id — BIGINT — 기본 키 — NOT NULL
  • user_id — BIGINT — 외래 키 → users.id — NOT NULL — 회원
  • channel_code — VARCHAR(20) — 외래 키 → payment_channels.channel_code — NOT NULL — 결제 채널
  • store_subscription_id — VARCHAR(255) — 애플 purchaseId / 구글 구독 식별자 / PG 빌링키 참조
  • status — VARCHAR(20) — NOT NULL — active/cancel_scheduled/canceled/expired
  • canceled_at — DATETIME — 구독취소(다음 청구 중단) 시각
  • updated_at — DATETIME — NOT NULL

users

  • id — INT — 기본 키 — NOT NULL — 회원 ID
  • email — VARCHAR(255) — 이메일
  • money — INT — 기프트머니 잔액 — money_ledger 도입 후 캐시로 강등
  • normal_expired_at — DATETIME — 베이직 이용권 만료일 — entitlement_grants 도입 후 계산 캐시
  • expired_at — DATETIME — 프리미엄 이용권 만료일 — entitlement_grants 도입 후 계산 캐시
  • created_at — TIMESTAMP
  • updated_at — TIMESTAMP
  • deleted_at — TIMESTAMP — 회원 탈퇴 시각' ) COMMENT='회원 (참조용 발췌 — 실제 테이블에는 컬럼이 더 많