티샷
테이블 (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='회원 (참조용 발췌 — 실제 테이블에는 컬럼이 더 많