12
테이블 (13)
가챠 뽑기 (gacha_draws)
- 뽑기 ID (id) — BIGINT — 기본 키 — NOT NULL
- 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 지급 출처 구분 (source_type) — VARCHAR(20) — NOT NULL — LOG_REWARD / PURCHASE / EVENT / ADMIN
- 지급 출처 ID (source_id) — BIGINT — NOT NULL — LOG_REWARD=plant_journals.id, PURCHASE=order_items.id, ADMIN=idempotency_keys.id
- 처리 상태 (status) — VARCHAR(20) — NOT NULL — PENDING / PROCESSING / COMPLETED / RETRYABLE_FAILED / MANUAL_REVIEW
- 뽑기 장수 (draw_count) — INT — NOT NULL
- 확률 버전 (rate_version) — INT — NOT NULL
- 결과 확인 일시 (result_viewed_at) — DATETIME(6)
- 시도 횟수 (attempt_count) — INT — NOT NULL
- 다음 재시도 일시 (next_retry_at) — DATETIME(6)
- 최근 오류 코드 (last_error_code) — VARCHAR(100)
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
- 수정 일시 (updated_at) — DATETIME(6) — NOT NULL
- 완료 일시 (completed_at) — DATETIME(6)
가챠 뽑기 상세 (gacha_draw_items)
- 뽑기 상세 ID (id) — BIGINT — 기본 키 — NOT NULL
- 뽑기 ID (gacha_draw_id) — BIGINT — 외래 키 → 가챠 뽑기.뽑기 ID — NOT NULL
- 팩 내 순번 (draw_seq) — INT — NOT NULL
- 카드 ID (card_id) — BIGINT — 외래 키 → 트레이딩 카드.카드 ID — NOT NULL
- 추첨 난수값 (roll_value) — INT — NOT NULL — 0..2099999
- 최초 추첨 등급 (rolled_rarity) — VARCHAR(20) — NOT NULL
- 최종 확정 등급 (final_rarity) — VARCHAR(20) — NOT NULL
- 획득 후 보유 수량 (owned_count_after) — INT — NOT NULL
- 골든 개체 ID (golden_instance_id) — BIGINT — 외래 키 → 골든 카드 개체.골든 개체 ID
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
골든 카드 개체 (golden_card_instances)
- 골든 개체 ID (id) — BIGINT — 기본 키 — NOT NULL
- 카드 ID (card_id) — BIGINT — 외래 키 → 트레이딩 카드.카드 ID — NOT NULL
- 현재 소유자 ID (owner_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 최초 획득자 ID (origin_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 최초 획득 경로 (origin_type) — VARCHAR(20) — NOT NULL — GACHA / ADMIN
- 최초 획득 순번 (golden_origin_rank) — BIGINT — 가챠 생성 골든만 부여하며 거래 후에도 유지
- 최초 획득 일시 (origin_acquired_at) — DATETIME(6) — NOT NULL
- 현재 소유 시작 일시 (current_owner_since) — DATETIME(6) — NOT NULL
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
사용자 (users)
- 사용자 ID (id) — BIGINT — 기본 키 — NOT NULL
사용자 카드 도감 (user_card_collections)
- 도감 ID (id) — BIGINT — 기본 키 — NOT NULL
- 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 카드 ID (card_id) — BIGINT — 외래 키 → 트레이딩 카드.카드 ID — NOT NULL
- 보유 수량 (owned_count) — INT — NOT NULL
- 최초 획득 일시 (first_acquired_at) — DATETIME(6) — NOT NULL
- 골든 가챠 획득 일시 (golden_gacha_acquired_at) — DATETIME(6) — 종류별 골든 가챠 평생 1회 판정 정본
- 수정 일시 (updated_at) — DATETIME(6) — NOT NULL
사용자 카드 조각 지갑 (user_card_shard_wallets)
- 사용자 아이디 (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 현재 조각 잔액 (balance) — BIGINT — NOT NULL
- 누적 획득 조각 (lifetime_earned) — BIGINT — NOT NULL
- 누적 사용 조각 (lifetime_spent) — BIGINT — NOT NULL
- 낙관적 락 버전 (version) — BIGINT — NOT NULL
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
- 수정 일시 (updated_at) — DATETIME(6) — NOT NULL
사용자 카드 코스메틱 (user_card_cosmetics)
- 아이디 (id) — BIGINT — 기본 키 — NOT NULL
- 사용자 아이디 (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 코스메틱 코드 (cosmetic_code) — VARCHAR(100) — NOT NULL
- 코스메틱 종류 (cosmetic_type) — VARCHAR(20) — NOT NULL
- 해금 가격 스냅샷 (shard_price_snapshot) — BIGINT — NOT NULL
- 해금 일시 (unlocked_at) — DATETIME(6) — NOT NULL
- 장착 일시 (equipped_at) — DATETIME(6)
카드 거래 가격 제안 이력 (card_market_proposals)
- 제안 ID (id) — BIGINT — 기본 키 — NOT NULL
- 협상 ID (negotiation_id) — BIGINT — 외래 키 → 카드 거래 가격 협상.협상 ID — NOT NULL
- 제안자 ID (proposer_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 가격을 제시한 사용자
- 제안자 구분 (proposer_type) — VARCHAR(10) — NOT NULL — BUYER / SELLER
- 제안 순서 (sequence_no) — INT — NOT NULL — 협상 내 제안 순서
- 제안 가격 (proposed_price) — BIGINT — NOT NULL
- 선택형 메시지 코드 (message_code) — VARCHAR(30) — 선택형 메시지. 자유 채팅 내용은 저장하지 않는다
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
카드 거래 가격 협상 (card_market_negotiations)
- 협상 ID (id) — BIGINT — 기본 키 — NOT NULL
- 판매글 ID (listing_id) — BIGINT — 외래 키 → 카드 거래소 판매글.판매글 ID — NOT NULL
- 구매 희망자 ID (buyer_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 구매 희망자
- 협상 상태 (status) — VARCHAR(20) — NOT NULL — NEGOTIATING / ACCEPTED / REJECTED / CANCELLED / EXPIRED / LISTING_CLOSED
- 응답 차례 (turn) — VARCHAR(10) — NOT NULL — 현재 응답 차례 BUYER / SELLER
- 마지막 제안자 구분 (current_proposer_type) — VARCHAR(10) — NOT NULL — 마지막 제안자 BUYER / SELLER
- 현재 제안 가격 (current_price) — BIGINT — NOT NULL — 현재 제안 가격
- 임시 보관 유상 포인트 (escrowed_paid_point) — BIGINT — NOT NULL — 임시 보관 중인 구매자 유상 포인트
- 판매자 역제안 횟수 (seller_counter_count) — INT — NOT NULL — 판매자 역제안 횟수. 최대 3회
- 다음 제안 순서 (next_sequence) — INT — NOT NULL — 다음 제안 순서
- 현재 제안 만료 일시 (expires_at) — DATETIME(6) — NOT NULL — 현재 제안 만료 시각. 마지막 제안 후 24시간
- 종료 사유 (closed_reason) — VARCHAR(30)
- 협상 종료 일시 (closed_at) — DATETIME(6)
- 낙관적 락 버전 (version) — BIGINT — NOT NULL — 낙관적 락
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
- 수정 일시 (updated_at) — DATETIME(6) — NOT NULL
- 활성 구매자 ID (생성 컬럼) (active_buyer_user_id) — BIGINT — 물리 SQL 생성 컬럼(STORED). 애플리케이션 입력 금지. status=NEGOTIATING 일 때만 buyer_user_id 를 노출하여 동일 구매자 활성 협상 중복을 UNIQUE 로 차단
카드 거래 완료 기록 (card_market_trades)
- 거래 ID (id) — BIGINT — 기본 키 — NOT NULL
- 판매글 ID (listing_id) — BIGINT — 외래 키 → 카드 거래소 판매글.판매글 ID — NOT NULL
- 협상 ID (negotiation_id) — BIGINT — 외래 키 → 카드 거래 가격 협상.협상 ID — 협상 거래일 때만 사용. BUY_NOW 는 NULL
- 거래 유형 (trade_type) — VARCHAR(20) — NOT NULL — BUY_NOW / NEGOTIATED
- 판매자 ID (seller_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 구매자 ID (buyer_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 카드 ID (card_id) — BIGINT — 외래 키 → 트레이딩 카드.카드 ID — NOT NULL
- 골든 개체 ID (golden_instance_id) — BIGINT — 외래 키 → 골든 카드 개체.골든 개체 ID
- 카드 코드 스냅샷 (card_code_snapshot) — VARCHAR(100) — NOT NULL — 거래 당시 카드 코드
- 카드명 스냅샷 (card_name_snapshot) — VARCHAR(100) — NOT NULL — 거래 당시 카드 이름
- 등급 스냅샷 (rarity_snapshot) — VARCHAR(20) — NOT NULL — HYPER_RARE / GOLDEN_RARE
- 이미지 키 스냅샷 (image_key_snapshot) — VARCHAR(500) — 거래 당시 S3 이미지 키
- 등록 가격 스냅샷 (asking_price_snapshot) — BIGINT — NOT NULL — 판매글 등록 가격
- 실제 거래 가격 (trade_price) — BIGINT — NOT NULL — 실제 거래 가격
- 수수료율 (fee_rate_bps) — INT — NOT NULL — 수수료율 basis point. 10퍼센트 = 1000
- 수수료 (fee_point) — BIGINT — NOT NULL
- 판매자 정산액 (seller_received_point) — BIGINT — NOT NULL — 판매자 최종 정산액
- 거래 완료 일시 (completed_at) — DATETIME(6) — NOT NULL
카드 거래소 판매글 (card_market_listings)
- 판매글 ID (id) — BIGINT — 기본 키 — NOT NULL
- 판매자 ID (seller_user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 판매자 users.id
- 카드 ID (card_id) — BIGINT — 외래 키 → 트레이딩 카드.카드 ID — NOT NULL — 판매 카드 trading_cards.id
- 골든 개체 ID (golden_instance_id) — BIGINT — 외래 키 → 골든 카드 개체.골든 개체 ID — 골든 카드 개체. HYPER_RARE 는 NULL
- 거래 자산 구분 (asset_type) — VARCHAR(20) — NOT NULL — HYPER_RARE / GOLDEN_RARE
- 즉시 구매 가격 (asking_price) — BIGINT — NOT NULL — 즉시 구매 가격
- 판매글 상태 (status) — VARCHAR(20) — NOT NULL — OPEN / SOLD / CANCELLED / EXPIRED
- 종료 사유 (closed_reason) — VARCHAR(30) — 판매 종료 상세 사유
- 판매글 만료 일시 (expires_at) — DATETIME(6) — NOT NULL — 판매글 만료 시각
- 판매 완료 일시 (sold_at) — DATETIME(6)
- 취소 일시 (cancelled_at) — DATETIME(6)
- 낙관적 락 버전 (version) — BIGINT — NOT NULL — 낙관적 락
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
- 수정 일시 (updated_at) — DATETIME(6) — NOT NULL
- 활성 골든 개체 ID (생성 컬럼) (active_golden_instance_id) — BIGINT — 물리 SQL 생성 컬럼(STORED). 애플리케이션 입력 금지. status=OPEN 일 때만 golden_instance_id 를 노출하여 활성 골든 판매 중복을 UNIQUE 로 차단
카드 조각 거래 원장 (card_shard_transactions)
- 아이디 (id) — BIGINT — 기본 키 — NOT NULL
- 사용자 아이디 (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
- 거래 유형 (transaction_type) — VARCHAR(30) — NOT NULL
- 트레이딩 카드 아이디 (card_id) — BIGINT — 외래 키 → 트레이딩 카드.카드 ID
- 코스메틱 코드 (cosmetic_code) — VARCHAR(100)
- 분해 카드 수량 (card_quantity) — INT
- 장당 조각 스냅샷 (shard_per_card_snapshot) — BIGINT
- 조각 증감량 (amount) — BIGINT — NOT NULL
- 처리 후 잔액 (balance_after) — BIGINT — NOT NULL
- 멱등 요청 아이디 (request_id) — BIGINT — NOT NULL
- 요청 내 순번 (line_no) — INT — NOT NULL
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
트레이딩 카드 (trading_cards)
- 카드 ID (id) — BIGINT — 기본 키 — NOT NULL
- 시리즈 코드 (series_code) — VARCHAR(50) — NOT NULL
- 카드 코드 (code) — VARCHAR(100) — NOT NULL
- 카드명 (name) — VARCHAR(100) — NOT NULL
- 등급 (rarity) — VARCHAR(20) — NOT NULL — COMMON / RARE / SUPER_RARE / HYPER_RARE / GOLDEN_RARE
- 설명 (description) — TEXT
- 이미지 키 (image_key) — VARCHAR(500) — S3 또는 CDN base URL을 제외한 객체 키
- 추첨 가중치 (draw_weight) — INT — NOT NULL — 현재 단일 팩 기준 1/2100000 가중치. 활성 카드 전체 draw_weight 합계는 2100000이어야 한다.
- 표시 순서 (display_order) — INT — NOT NULL
- 상태 (status) — VARCHAR(20) — NOT NULL — ACTIVE / HIDDEN
- 생성 일시 (created_at) — DATETIME(6) — NOT NULL
- 수정 일시 (updated_at) — DATETIME(6) — NOT NULL