미스터리 크레딧
테이블 (12)
게임 (games)
- id — UUID — 기본 키 — NOT NULL
- 방 id (room_id) — UUID — 외래 키 → 방 목록.id — NOT NULL
- 게임 상태 (game_status) — enum('preparing', 'active', 'paused', 'finished', 'cancelled') — NOT NULL
- 전체 라운드 수 (total_rounds) — smallint — NOT NULL
- 현재 라운드 수 (current_round) — smallint — NOT NULL
- 시작 시각 (start_time) — timestamptz — NOT NULL
- 종료 시각 (end_time) — timestamptz — NOT NULL
- 게임 시작 설정 스냅샷 (game_setting) — jsonb — 게임 시작 시점의 설정 스냅샷
- 게임 종료 설정 스냅샷 (final_result) — jsonb — 게임 종료 시 최종 결과 및 통계 스냅샷
- 생성 시각 (created_at) — timestamptz — NOT NULL
- 수정 시각 (updated_at) — timestamptz — NOT NULL
- 버전 (version) — integer — NOT NULL — Optimistic Lock 버전
게임 라운드 (game_rounds)
- id — UUID — 기본 키 — NOT NULL
- 게임 id (game_id) — UUID — 외래 키 → 게임.id — NOT NULL
- 라운드 번호 (round_number) — smallint — NOT NULL — 1부터 시작, 게임 내 유니크
- 라운드 상태 (round_status) — enum('preparing', 'active', 'finished', 'cancelled') — NOT NULL
- 시작 시각 (start_time) — timestamptz — NOT NULL
- 종료 시각 (end_time) — timestamptz
- 진행 시간 (duration_seconds) — integer — NOT NULL — (초 단위)
- 정답자 수 (correct_answer_count) — smallint
- 문제 (content) — jsonb — NOT NULL — 사건 설명, 이미지 URL, 난이도 등 미스터리 문제 내용
- 정답 키워드 (correct_keyword) — jsonb — NOT NULL — 정답 판정에 사용하는 키워드 목록
- 생성 시각 (created_at) — timestamptz — NOT NULL
- 수정 시각 (updated_at) — timestamptz
경매 (auctions)
- id — UUID — 기본 키 — NOT NULL
- 게임 id (game_id) — UUID — 외래 키 → 게임 라운드.게임 id — NOT NULL
- 힌트 id (hint_id) — UUID — 외래 키 → 힌트.id — NOT NULL
- 경매 라운드 (auction_number) — smallint — NOT NULL — 경매 순번 (1,2차)
- 경매 상태 (auction_status) — enum('pending', 'active', 'finished', 'cancelled') — NOT NULL
- 시작 입찰가 (starting_bid) — integer — NOT NULL
- 최종 입찰가 (winning_bid) — integer
- 낙찰 유저 id (winning_user_id) — UUID — 외래 키 → 유저.id
- 시작 시각 (start_time) — timestamptz
- 종료 시각 (end_time) — timestamptz
- 경매 진행시간 (duration_seconds) — integer — NOT NULL — (초 단위)
- 생성 시각 (created_at) — timestamptz — NOT NULL
- 수정 시각 (updated_at) — timestamptz — NOT NULL
경매 입찰 (auction_bids)
- id — UUID — 기본 키 — NOT NULL
- 경매 id (auction_id) — UUID — 외래 키 → 경매.id — NOT NULL
- 유저 id (user_id) — UUID — 외래 키 → 유저.id — NOT NULL
- 입찰 금액 (bid_amount) — integer — 양수여야 함
- 입찰 상태 (bid_status) — enum('pending', 'active', 'outbid', 'winning', 'refund', 'cancelled') — NOT NULL
- 입찰 시각 (bid_time) — timestamptz — NOT NULL
- 정산 시각 (processed_at) — timestamptz — 정산/ 환불 등 처라
방 목록 (rooms)
- id — UUID — 기본 키 — NOT NULL
- 방 참가 코드 (code) — varchar(50) — NOT NULL — ex) room_XXXXX
- 방 이름 (name) — varchar(100) — NOT NULL
- 방 상태 (status) — enum('waiting', 'active', 'finished', 'closed') — NOT NULL
- 참여중인 인원 (participant_count) — smallint — NOT NULL — 최대수용 인원을 넘길 수 없음
- 최대수용 인원 (max_participant) — smallint — NOT NULL
- 방 단위 게임 설정 (setting) — jsonb — NOT NULL — 라운드 수, 제한 시간 등 세팅
- 생성 시각 (created_at) — timestamptz — NOT NULL
- 수정 시각 (updated_at) — timestamptz — NOT NULL
- 종료 시각 (closed_at) — timestamptz
방 참가 이력 (room_participants)
- id — UUID — 기본 키 — NOT NULL
- 유저 id (user_id) — UUID — 외래 키 → 유저.id — NOT NULL
- 방 id (room_id) — UUID — 외래 키 → 방 목록.id — NOT NULL
- 상태 (status) — enum('active', 'left', 'kicked', 'banned') — NOT NULL
- 입장 시각 (joined_at) — timestamptz — NOT NULL
- 퇴장 시각 (left_at) — timestamptz
사용자 통계 (user_statistics)
- id — UUID — 기본 키 — NOT NULL
- 유저 id (user_id) — UUID — 외래 키 → 유저.id — NOT NULL
- 플레이한 게임 수 (total_played) — integer — NOT NULL
- 승리한 게임 수 (total_won) — integer — NOT NULL
- 질문한 횟수 (total_questions) — integer — NOT NULL
- 정답 맞춘 횟수 (total_correct_answers) — integer — NOT NULL
- 누적 획득 크레딧 (total_credits_earned) — bigint — NOT NULL
- 누적 사용 크레딧 (total_credits_spent) — bigint — NOT NULL
- 낙찰 받은 경매 수 (total_auctions_won) — integer — NOT NULL
- 생성 시각 (created_at) — timestamptz — NOT NULL
- 수정 시각 (updated_at) — timestamptz — NOT NULL
유저 (users)
- id — UUID — 기본 키 — NOT NULL
- 닉네임 (nickname) — varchar(50) — NOT NULL
- 보유 크레딧 (current_credit) — int — NOT NULL — 음수가 될 수 없음
- 누적 점수 (total_score) — bigint — NOT NULL
- 접속 상태 (connection_status) — enum('offline', 'online') — NOT NULL
- 최근 활동 시간 (last_active_at) — timestamptz
- 탈퇴 여부 (is_deleted) — boolean — NOT NULL
- 생성 시각 (created_at) — timestamptz — NOT NULL
- 수정 시각 (updated_at) — timestamptz — NOT NULL
- 버전 (version) — integer — NOT NULL — Optimistic Lock 버전
정답 (answers)
- id — UUID — 기본 키 — NOT NULL
- 유저 id (user_id) — UUID — 외래 키 → 유저.id — NOT NULL
- 라운드 id (round_id) — UUID — 외래 키 → 게임 라운드.id — NOT NULL
- 게임 id (game_id) — UUID — 외래 키 → 게임 라운드.게임 id — NOT NULL
- 정답 내용 (content) — text — NOT NULL
- 정답 여부 (is_correct) — boolean
- 정답자 순위 (ranking) — smallint — 1~3, 정답일 경우 존재
- 보상 크레딧 (reward_credit) — integer — 정답 순위에 따른 보상
- 추가 크레딧 (bonus_credit) — integer — 키워드에 따른 추가 보상
- 보상 합계 (total_credit) — integer
- 차감 크레딧 (penalty_credit) — integer — 오답 시 차감된 크레딧
- 정답 매칭 키워드 (matched_keywords) — jsonb — 정답 판정 시 매칭된 키워드 목록
- 제출 시각 (submitted_at) — timestamptz — NOT NULL
- 판정 시각 (judged_at) — timestamptz
- 버전 (version) — integer — NOT NULL — Optimistic Lock 버전
질문 (questions)
- id — UUID — 기본 키 — NOT NULL
- 라운드 id (round_id) — UUID — 외래 키 → 게임 라운드.id — NOT NULL
- 게임 id (game_id) — UUID — 외래 키 → 게임 라운드.게임 id — NOT NULL
- 유저 id (user_id) — UUID — 외래 키 → 유저.id — NOT NULL
- 질문 내용 (content) — text — NOT NULL
- 응답 (response_type) — enum('yes', 'no', 'maybe', 'irrelevant')
- 설명 (response_detail) — text — 딜러의 추가 설명
- 차감 크레딧 (penalty_credit) — integer — 질문 시 차감된 크레딧
- 제출 시각 (submitted_at) — timestamptz — NOT NULL
- 응답 시각 (responded_at) — timestamptz
크레딧 내역 (credit_transactions)
- id — UUID — 기본 키 — NOT NULL
- 유저 id (user_id) — UUID — 외래 키 → 유저.id — NOT NULL
- 라운드 id (round_id) — UUID — 외래 키 → 게임 라운드.id — NOT NULL
- 게임 id (game_id) — UUID — 외래 키 → 게임 라운드.게임 id — NOT NULL
- 연결 엔티티 id (related_entity_id) — UUID — NOT NULL — 어떤 내역인지 UUID (질문, 정답, 경매 테이블에서 가져옴)
- 연결 유형 (related_entity_type) — enum('question', 'answer', 'auction') — NOT NULL
- 거래 유형 (transaction_type) — enum('earn', 'refund', 'penalty', 'initial') — NOT NULL
- 거래 금약 (amount) — integer — NOT NULL
- 거래 전 잔액 (balance_before) — integer — NOT NULL
- 거래 후 잔액 (balance_after) — integer — NOT NULL
- 거래 사유 (reason) — varchar(200)
- 발생 시각 (created_at) — timestamptz — NOT NULL
힌트 (hints)
- id — UUID — 기본 키 — NOT NULL
- 라운드 id (round_id) — UUID — 외래 키 → 게임 라운드.id — NOT NULL
- 게임 id (game_id) — UUID — 외래 키 → 게임 라운드.게임 id — NOT NULL
- 힌트 내용 (content) — text — NOT NULL
- 힌트 유형 (hint_type) — enum('general', 'personal', 'location', 'time', 'character', 'object') — NOT NULL
- 노출 범위 (visibility_scope) — enum('public', 'private', 'auction_winner') — NOT NULL
- 공개 우선순위 (priority) — smallint — NOT NULL — 숫자가 낮을수록 먼저 공개되는 힌트
- 공개 여부 (is_revealed) — boolean — NOT NULL
- 공개 시각 (revealed_at) — timestamptz
- 생성 시각 (created_at) — timestamptz — NOT NULL