MINE

Tables (20)

card_attempts (카드 학습 시도)

  • id (Key4) — BIGINT — Primary key — NOT NULL — 시도 식별자
  • card_id — BIGINT — Foreign key — NOT NULL — 소속 카드 ID
  • attempt_no — SMALLINT — NOT NULL — 회차 (1~5)
  • audio_url — VARCHAR(500) — 녹음 파일 URL
  • stt_text — TEXT — STT 결과 텍스트
  • status — VARCHAR(20) — NOT NULL — 처리 상태 (PENDING, UPLOADED, PROCESSING, COMPLETED, FAILED)
  • created_at — TIMESTAMPTZ — NOT NULL — 시도(업로드) 시각
  • submitted_at — TIMESTAMPTZ — 분석 요청(제출) 시각
  • finished_at — TIMESTAMPTZ — 분석 완료 시각

card_feedbacks (카드 피드백)

  • attempt_id (Key4) — BIGINT — Foreign key → card_attempts.id — NOT NULL — 시도 ID(1:1 관계)
  • overall_score — INT — NOT NULL — 성취도 점수(0~100)
  • level — SMALLINT — NOT NULL — 성취도 레벨(1~5)
  • feedback_json — LONGTEXT — NOT NULL — AI 피드백 원본
  • model_version — VARCHAR(20) — NOT NULL — 프롬프트/모델 버전
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 시각

cards (학습 카드)

  • id — BIGINT — Primary key — NOT NULL — 카드 식별자
  • user_id — BIGINT — Foreign key — NOT NULL — 소유 유저 ID
  • category_id — BIGINT — Foreign key — NOT NULL — 학습 카테고리 ID
  • keyword_id — BIGINT — Foreign key — NOT NULL — 학습 키워드 ID
  • title — VARCHAR(20) — NOT NULL — 카드 이름(중복 허용)
  • best_level — SMALLINT — NOT NULL — 최고 달성 레벨 (1~5)
  • attempt_count — SMALLINT — NOT NULL — 총 학습 시도 횟수 (1~5)
  • learning_context — TEXT — AI 학습 기억 (요약 / 시도 횟수 1~4일 때 존재)
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시
  • updated_at — TIMESTAMPTZ — NOT NULL — 수정 일시
  • deleted_at — TIMESTAMPTZ — 삭제 일시 (Soft Delete)

categories (카테고리)

  • id — BIGINT — Primary key — NOT NULL — 카테고리 식별자
  • name — VARCHAR(20) — NOT NULL — 카테고리명
  • display_order — INT — NOT NULL — 화면 노출 순서
  • is_active — BOOLEAN — NOT NULL — 활성 여부
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시
  • updated_at — TIMESTAMPTZ — 수정 일시

challenge_attempts (챌린지 도전)

  • id — BIGINT — Primary key — NOT NULL — 도전 식별자
  • challenge_id — BIGINT — Foreign key — NOT NULL — 챌린지 ID
  • user_id — BIGINT — Foreign key — 도전 유저 ID
  • audio_url — VARCHAR(500) — 녹음 파일 URL
  • stt_text — TEXT — STT 변환 텍스트
  • status — VARCHAR(20) — NOT NULL — 처리 상태 (PENDING, UPLOADED, PROCESSING, COMPLETED, FAILED)
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
  • submitted_at — TIMESTAMPTZ — 제출 완료 시각
  • finished_at — TIMESTAMPTZ — 분석 완료 시각

challenge_rankings (챌린지 랭킹)

  • id — BIGINT — Primary key — NOT NULL — 랭킹 레코드 식별자
  • challenge_id — BIGINT — Foreign key — NOT NULL — 챌린지 ID
  • user_id — BIGINT — Foreign key — 유저 ID
  • user_nickname — VARCHAR(20) — NOT NULL — 유저 닉네임
  • user_profile_image_url — VARCHAR(500) — 유저 프로필 이미지
  • rank_no — INT — NOT NULL — 등수
  • score — INT — NOT NULL — 점수
  • attempt_id — BIGINT — Foreign key — 근거 도전 ID
  • created_at — TIMESTAMPTZ — NOT NULL — 스냅샷 생성 시각

challenge_results (챌린지 결과)

  • attempt_id — BIGINT — Foreign key → challenge_attempts.id — NOT NULL — 도전 ID (1:1 관계)
  • score — INT — NOT NULL — AI 평가 점수
  • feedback_json — LONGTEXT — NOT NULL — 피드백 원본
  • model_version — VARCHAR(20) — NOT NULL — 프롬프트/모델 버전
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 시각

challenges (일일 챌린지)

  • id — BIGINT — Primary key — NOT NULL — 챌린지 식별자
  • keyword_id — BIGINT — Foreign key — NOT NULL — 오늘의 키워드 ID
  • keyword_text — VARCHAR(50) — NOT NULL — 키워드 텍스트
  • challenge_date — DATE — NOT NULL — 챌린지 날짜
  • start_at — DATETIME — NOT NULL — 시작 시간 (22:00:00)
  • end_at — DATETIME — NOT NULL — 종료 시간 (22:09:59)
  • status — VARCHAR(20) — NOT NULL — 챌린지 상태 (SCHEDULED, OPEN, CLOSED, ANALYZING, COMPLETED)
  • best_submission_id — BIGINT — Foreign key — 1등 제출 ID
  • result_summary_json — LONGTEXT — 1~3위 정보 및 전체 요약
  • participant_count — INT — NOT NULL — 참여자 수
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시
  • Key — Foreign key → challenge_attempts.id — NOT NULL

forbidden_words (금지어)

  • id — BIGINT — Primary key — NOT NULL — 금지어 식별자
  • word — VARCHAR(50) — NOT NULL — 금지어 텍스트
  • type — VARCHAR(20) — NOT NULL — 적용 범위 (COMMON, NICKNAME, ROOM_NAME)
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시

keywords (키워드)

  • id — BIGINT — Primary key — NOT NULL — 키워드 식별자
  • category_id — BIGINT — Foreign key — NOT NULL — 소속 카테고리 ID
  • name — VARCHAR(50) — NOT NULL — 키워드명
  • display_order — INT — NOT NULL — 화면 노출 순서
  • is_active — BOOLEAN — NOT NULL — 활성 여부
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시
  • updated_at — TIMESTAMPTZ — NOT NULL — 수정 일시

notification_logs (알림 전송 이력)

  • id — BIGINT — Primary key — NOT NULL — 로그 ID
  • notification_id — BIGINT — Foreign key — NOT NULL — 원본 알림 ID
  • device_id — BIGINT — Foreign key — NOT NULL — 수신 기기 ID
  • user_id — BIGINT — Foreign key — NOT NULL — 수신 유저 ID
  • status — VARCHAR(20) — NOT NULL — 전송 상태 (PENDING, SENT, DELIVERED, FAILED)
  • provider — VARCHAR(10) — NOT NULL — 사용된 제공자 (FCM, APNS)
  • error_code — VARCHAR(50) — 실패 시 에러 코드
  • error_message — TEXT — 실패 상세 메시지
  • retry_count — SMALLINT — NOT NULL — 재시도 횟수
  • sent_at — TIMESTAMPTZ — 전송 시각
  • delivered_at — TIMESTAMPTZ — 수신 확인 시각
  • created_at — TIMESTAMPTZ — NOT NULL — 생성일

notifications (알림)

  • id — BIGINT — Primary key — NOT NULL — 알림 식별자
  • user_id — BIGINT — Foreign key — NOT NULL — 수신 유저 ID
  • type — VARCHAR(30) — NOT NULL — 알림 유형 (LEVEL_UP, CARD_COMPLETE, PVP_MATCHED, PVP_RESULT, CHALLENGE_OPEN, CHALLENGE_RESULT, SYSTEM)
  • title — VARCHAR(100) — NOT NULL — 알림 제목
  • content — VARCHAR(500) — 알림 내용
  • reference_id — BIGINT — 참조 ID
  • reference_type — VARCHAR(20) — 참조 타입 (CARD, PVP_ROOM, CHALLENGE, USER)
  • is_read — BOOLEAN — NOT NULL — 읽음 여부
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시

podcast_cache (팟캐스트 캐시)

  • card_attempt_id (Key4) — BIGINT — Foreign key → card_attempts.id — NOT NULL — 시도 ID (1:1 관계)
  • audio_url — VARCHAR(500) — NOT NULL — TTS 생성 음성 파일 URL
  • duration_seconds — INT — 재생 시간 (초)
  • tts_provider — VARCHAR(20) — NOT NULL — TTS 제공자 (OPENAI_TTS, ELEVENLABS, GOOGLE_TTS)
  • voice_model — VARCHAR(50) — NOT NULL — 음성 모델 (alloy, nova, shimmer)
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시
  • accessed_at — TIMESTAMPTZ — NOT NULL — 최근 접근 일시
  • access_count — INT — NOT NULL — 총 재생 횟수
  • deleted_at — TIMESTAMPTZ — 삭제 일시 (Soft Delete)

pvp_feedbacks (PvP 피드백)

  • id — BIGINT — Primary key — NOT NULL — 피드백 식별자
  • room_id — BIGINT — Foreign key — NOT NULL — 방 ID
  • user_id — BIGINT — Foreign key — NOT NULL — 유저 ID
  • score — INT — 점수 (0~100)
  • pvp_feedback_json — LONGTEXT — NOT NULL — PvP 피드백
  • model_version — VARCHAR(20) — NOT NULL — 프롬프트/모델 버전
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
  • deleted_at — TIMESTAMPTZ — 삭제 시각 (Soft Delete)

pvp_histories

  • id (Key) — BIGINT — Primary key — NOT NULL — 이력 식별자
  • user_id — BIGINT — Foreign key → users.id — NOT NULL — 사용자 ID (검색 기준)
  • room_id — BIGINT — Foreign key → pvp_rooms.id — NOT NULL — 대결 방 ID (상세 조회용)
  • role — VARCHAR(10) — NOT NULL — 'HOST' or 'GUEST'
  • score — INT — NOT NULL — 내 점수 (0~100)
  • level — INT — NOT NULL — 내 레벨 (1~5)
  • is_winner — BOOLEAN — NOT NULL — 승리 여부 (true/false)
  • is_hidden — BOOLEAN — NOT NULL — 숨김 여부 (개인별 설정)
  • opponent_user_id — BIGINT — Foreign key → users.id — 상대방 ID (탈퇴 시 NULL)
  • opponent_nickname — VARCHAR(20) — NOT NULL — 상대방 닉네임 (반정규화)
  • category_id — BIGINT — Foreign key → categories.id — NOT NULL — 대결 카테고리 ID
  • keyword_id — BIGINT — Foreign key → keywords.id — NOT NULL — 키워드 ID
  • created_at — TIMESTAMPTZ — NOT NULL — 이력 생성 시각
  • finished_at — TIMESTAMPTZ — NOT NULL — 게임 종료 시각 (정렬 기준)

pvp_rooms (PvP 대결 방)

  • id — BIGINT — Primary key — NOT NULL — 방 식별자
  • category_id — BIGINT — Foreign key — NOT NULL — 대결 카테고리 ID
  • keyword_id — BIGINT — Foreign key — 확정된 키워드 ID
  • room_name — VARCHAR(10) — NOT NULL — 방 이름 (2~10자)
  • status — VARCHAR(20) — NOT NULL — 방 상태 (OPEN, MATCHED, THINKING, RECORDING, PROCESSING, FINISHED, CANCELED, EXPIRED)
  • host_user_id — BIGINT — Foreign key — 호스트 ID
  • host_nickname — VARCHAR(20) — NOT NULL — 호스트 이름
  • guest_user_id — BIGINT — Foreign key — 게스트 ID
  • guest_nickname — VARCHAR(20) — 게스트 이름
  • winner_user_id — BIGINT — Foreign key — 승자 ID
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시
  • matched_at — TIMESTAMPTZ — 매칭 시각
  • started_at — TIMESTAMPTZ — 대결 시작 시각
  • finished_at — TIMESTAMPTZ — 대결 종료 시각

pvp_submissions (PvP 제출)

  • id (Key4) — BIGINT — Primary key — NOT NULL — 제출 식별자
  • room_id — BIGINT — Foreign key — NOT NULL — 방 ID
  • user_id — BIGINT — Foreign key — NOT NULL — 제출 유저 ID
  • audio_url — VARCHAR(500) — 녹음 파일 URL
  • stt_text — TEXT — STT 변환 텍스트
  • status — VARCHAR(20) — NOT NULL — 제출 상태 (PENDING, UPLOADED, PROCESSING, COMPLETED, FAILED)
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 시각
  • submitted_at — TIMESTAMPTZ — 제출 시각
  • finished_at — TIMESTAMPTZ — 분석 완료 시각

scoring_criteria (채점 기준)

  • id — BIGINT — Primary key — NOT NULL — 채점 기준 식별자
  • keyword_id — BIGINT — Foreign key — NOT NULL — 기준이 적용되는 키워드 ID
  • criteria_json — LONGTEXT — NOT NULL — 채점 기준 원본(JSON)
  • version — INT — NOT NULL — 기준 버전(1부터 시작, 1씩 증가)
  • is_active — BOOLEAN — NOT NULL — 현재 적용 중 여부(활성 기준)
  • created_at — TIMESTAMPTZ — NOT NULL — 생성 일시
  • updated_at — TIMESTAMPTZ — NOT NULL — 수정 일시(비활성화 시점)

user_devices (기기 및 브라우저 알림 토큰)

  • id — BIGINT — Primary key — NOT NULL — 기기 고유 식별자
  • user_id — BIGINT — Foreign key — NOT NULL — 소유 유저 ID
  • fcm_token — TEXT — NOT NULL — FCM 토큰 (또는 Web Push Endpoint)
  • agent_type — VARCHAR(20) — NOT NULL — 브라우저 타입 (CHROME, SAFARI, SAMSUNG, OTHER)
  • platform — VARCHAR(20) — NOT NULL — 플랫폼 (MOBILE_WEB, DESKTOP_WEB)
  • is_standalone — BOOLEAN — NOT NULL — PWA 모드 여부 (홈 화면 추가)
  • last_active_at — TIMESTAMPTZ — NOT NULL — 마지막 활동 일시
  • created_at — TIMESTAMPTZ — NOT NULL — 최초 등록 일시
  • deleted_at — TIMESTAMPTZ — 토큰 만료 일시 (Soft Delete)

users (회원)

  • id — BIGINT — Primary key — NOT NULL — 회원 고유 식별자
  • oauth_id — VARCHAR(100) — NOT NULL — OAuth 고유 ID
  • oauth_provider — VARCHAR(20) — NOT NULL — 로그인 제공자 (KAKAO, GOOGLE, APPLE)
  • nickname — VARCHAR(20) — NOT NULL — 닉네임 (1~20자, 활성 유저 중 유일)
  • profile_image_url — VARCHAR(500) — 프로필 이미지 URL
  • profile_image_key — VARCHAR(200) — S3 객체 키 (삭제 관리용)
  • level — INT — NOT NULL — 유저 레벨 (계단식 상승 규칙 적용)
  • total_card_count — INT — NOT NULL — 누적 생성 학습 카드 수
  • active_card_count — INT — NOT NULL — 현재 보유 학습 카드 수
  • consecutive_days — INT — NOT NULL — 연속 접속일
  • win_count — INT — NOT NULL — PvP 승리 횟수
  • last_login_at — TIMESTAMPTZ — NOT NULL — 마지막 로그인 일시
  • created_at — TIMESTAMPTZ — NOT NULL — 가입 일시
  • updated_at — TIMESTAMPTZ — NOT NULL — 수정 일시
  • deleted_at — TIMESTAMPTZ — 탈퇴 일시 (Soft Delete)