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)