TalkQQuest

테이블 (37)

Archive_Folders

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • name — VARCHAR(100) — NOT NULL
  • created_at — TIMESTAMP — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

Archive_Items

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • folder_id — CHAR(36) — 외래 키 → Archive_Folders.id
  • item_type — ENUM('conversation','phrase','report','mission') — NOT NULL
  • reference_id — CHAR(36) — NOT NULL
  • tags — JSON
  • created_at — TIMESTAMP — NOT NULL

Auth_Identities

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • provider — ENUM('email', 'kakao', 'naver') — NOT NULL
  • provider_user_id — VARCHAR(255) — OAuth 제공자의 고유 사용자 ID
  • email — VARCHAR(255) — 이메일 (이메일 로그인 또는 OAuth 제공 이메일)
  • password_hash — VARCHAR(255) — provider=EMAIL 전용, bcrypt 해시
  • created_at — TIMESTAMP — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

Badges

  • id — CHAR(36) — 기본 키 — NOT NULL
  • name — VARCHAR(100) — NOT NULL
  • description — TEXT
  • condition — JSON — NOT NULL — 배지 획득 조건
  • icon_url — VARCHAR(500)

Blocked_Users

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL — 차단을 건 사용자
  • blocked_user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL — 차단된 사용자
  • created_at — TIMESTAMP — NOT NULL

Calendar_Events

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • community_id — CHAR(36) — 외래 키 → Communities.id
  • title — VARCHAR(255) — NOT NULL
  • started_at — TIMESTAMP — NOT NULL
  • ended_at — TIMESTAMP
  • created_at — TIMESTAMP — NOT NULL

Chat_Messages

  • id — CHAR(36) — 기본 키 — NOT NULL
  • community_id — CHAR(36) — 외래 키 → Communities.id — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • content — TEXT — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Communities

  • id — CHAR(36) — 기본 키 — NOT NULL
  • host_user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • name — VARCHAR(200) — NOT NULL
  • description — TEXT
  • category — VARCHAR(100)
  • region — VARCHAR(100)
  • capacity — INT — NOT NULL
  • current_members — INT — NOT NULL
  • started_at — TIMESTAMP
  • ended_at — TIMESTAMP
  • cover_image_url — VARCHAR(500)
  • tags — JSON
  • visibility — ENUM('public','private') — NOT NULL
  • status — ENUM('draft','open','closed') — NOT NULL
  • interests — JSON
  • created_at — TIMESTAMP — NOT NULL

Community_Join_Requests

  • id — CHAR(36) — 기본 키 — NOT NULL
  • community_id — CHAR(36) — 외래 키 → Communities.id — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • status — ENUM('pending', 'approved', 'rejected', 'cancelled', 'waitlisted') — NOT NULL
  • waitlist_order — INT — 대기자 순서
  • message — TEXT
  • created_at — TIMESTAMP — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

Community_Members

  • id — CHAR(36) — 기본 키 — NOT NULL
  • community_id — CHAR(36) — 외래 키 → Communities.id — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • role — ENUM('host','member') — NOT NULL
  • joined_at — TIMESTAMP — NOT NULL

Conversation_Messages

  • id — CHAR(36) — 기본 키 — NOT NULL
  • conversation_id — CHAR(36) — 외래 키 → Conversations.id — NOT NULL
  • role — ENUM('user','guide','system') — NOT NULL
  • content — TEXT — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Conversations

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • mission_id — CHAR(36) — 외래 키 → Missions.id — NOT NULL
  • mode — VARCHAR(50) — 대화 모드
  • selected_topic — VARCHAR(255)
  • status — ENUM('in_progress', 'completed', 'abandoned') — NOT NULL
  • started_at — TIMESTAMP — NOT NULL
  • finished_at — TIMESTAMP

Email_Verifications

  • id — CHAR(36) — 기본 키 — NOT NULL
  • email — VARCHAR(255) — NOT NULL
  • code — VARCHAR(10) — NOT NULL
  • expires_at — TIMESTAMP — NOT NULL
  • verified — BOOLEAN — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Feedbacks

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • conversation_id — CHAR(36) — 외래 키 → Conversations.id — NOT NULL
  • kindness_score — INT — 친절한 태도 점수 (0-100)
  • initiative_score — INT — 대화 주도 점수
  • empathy_score — INT — 공감 능력 점수
  • question_link_score — INT — 질문 연결성 점수
  • metrics — JSON — key, label, score, strengths, improvements, bestSentence
  • mission_summary — JSON
  • conversation_summary — STRING
  • summary_chips — JSON
  • saved_phrase — TEXT — 저장 문장
  • status — ENUM('pending', 'ready', 'failed') — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Firebase Cloud Messaging용 (Device_Tokens)

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • fcm_token — VARCHAR(500) — NOT NULL
  • platform — ENUM('android') — NOT NULL
  • last_active_at — TIMESTAMP — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Goals

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • goal_type — VARCHAR(50) — NOT NULL — 목표 유형 (e.g. daily_mission, weekly_conversation)
  • target — VARCHAR(255) — NOT NULL — 목표 내용 또는 수치
  • is_active — BOOLEAN — NOT NULL
  • created_at — TIMESTAMP — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

JWT 재발급 (Refresh_Tokens)

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • token — VARCHAR(512) — NOT NULL
  • device_info — JSON
  • expires_at — TIMESTAMP — NOT NULL
  • revoked — BOOLEAN — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Login_History

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 — NOT NULL
  • device_info — JSON — 기기 정보, 수집 실패 시 NULL
  • ip_address — VARCHAR(45) — IPv6 포함 45자, 수집 실패 시 NULL
  • logged_in_at — TIMESTAMP — NOT NULL

Mission_Prep_Items

  • id — CHAR(36) — 기본 키 — NOT NULL
  • mission_id — CHAR(36) — 외래 키 → Missions.id — NOT NULL
  • type — ENUM('question', 'starter', 'tip') — NOT NULL — question=추천 질문, starter=대화 시작 문장, tip=준비 팁
  • content — TEXT — NOT NULL
  • order_index — INT — NOT NULL — 같은 type 내 표시 순서
  • created_at — TIMESTAMP — NOT NULL

Mission_Records

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • mission_id — CHAR(36) — 외래 키 → Missions.id — NOT NULL
  • conversation_id — CHAR(36) — 외래 키 → Conversations.id
  • 결과 (result) — ENUM('success','failure','avoidance') — NOT NULL
  • memo — TEXT
  • duration_minutes — INT
  • emotion — VARCHAR(50)
  • xp_earned — INT — NOT NULL
  • 진행상황 (status) — ENUM('in_progress','completed') — NOT NULL
  • created_at — TIMESTAMP — NOT NULL
  • completed_at — TIMESTAMP

Mission_Saves

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • mission_id — CHAR(36) — 외래 키 → Missions.id — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Missions

  • id — CHAR(36) — 기본 키 — NOT NULL
  • 제목 (title) — VARCHAR(255) — NOT NULL
  • 설명 (description) — TEXT — NOT NULL
  • 추천 질문 목록 (preparation_tip) — TEXT
  • 주의사항 (caution) — TEXT
  • 난이도 (difficulty) — INT — NOT NULL — 1-3 (쉬움,보통, 어려움)
  • 예상 시간 (estimated_minutes) — INT — NOT NULL
  • 보상 XP (reward_xp) — INT — NOT NULL
  • 카테고리 (category) — VARCHAR(100) — NOT NULL
  • 기본 미션/추천 미션 (is_template) — BOOLEAN — NOT NULL — 관리자가 미리 만들어놓은 미션인지의 여부. 사용자 맞춤 생성/ai추천일 경우와 분리
  • created_at — TIMESTAMP — NOT NULL

Notification_Settings

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • mission_reminder — BOOLEAN — NOT NULL
  • community_approved — BOOLEAN — NOT NULL
  • report_ready — BOOLEAN — NOT NULL
  • marketing — BOOLEAN — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

Notifications

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • type — VARCHAR(50) — NOT NULL — mission_reminder / community_approved / report_ready / marketing
  • title — VARCHAR(255) — NOT NULL
  • body — TEXT
  • reference_id — CHAR(36)
  • reference_type — VARCHAR(50)
  • is_read — BOOLEAN — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Plans

  • id — CHAR(36) — 기본 키 — NOT NULL
  • name — VARCHAR(100) — NOT NULL — free / basic / premium
  • price — DECIMAL(10, 2) — NOT NULL
  • currency — VARCHAR(3) — NOT NULL
  • ai_limit — INT — AI 피드백 월 사용 한도 (NULL=무제한)
  • feedback_limit — INT
  • features — JSON
  • is_active — BOOLEAN — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Recommendation_Logs

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — NOT NULL
  • source — ENUM('llm', 'template', 'fallback') — NOT NULL — 최종 추천을 만든 단계
  • llm_model — VARCHAR(50) — 사용한 LLM 모델명, 비-LLM이면 NULL
  • target_difficulty — INT — 2단계에서 계산한 목표 난이도 (1-3)
  • avoided_categories — JSON — 2단계 회피 카테고리 배열
  • prompt_input — JSON — LLM에 보낸 힌트/메시지, 비-LLM이면 NULL
  • raw_response — TEXT — LLM 원문 응답 (파싱 전)
  • parse_success — BOOLEAN — NOT NULL — 응답 파싱/스키마 검증 성공 여부
  • recommended_mission — JSON — 최종 반환된 추천 미션(RecommendedMission)
  • fallback_reason — VARCHAR(100) — 폴백 사유(no_api_key/http_error/invalid_json/schema_invalid/timeout), 성공 시 NULL
  • created_at — TIMESTAMP — NOT NULL

Reports

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • type — ENUM('monthly', 'weekly') — NOT NULL
  • period — VARCHAR(10) — NOT NULL — YYYY-MM 또는 YYYY-Www
  • data — JSON — 집계 결과 (완료율, 레벨 변화, 주제 등)
  • created_at — TIMESTAMP — NOT NULL

Safety_Reports

  • id — CHAR(36) — 기본 키 — NOT NULL
  • reporter_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • reported_user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • reason — TEXT
  • status — ENUM('pending','reviewed','dismissed') — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Saved_Phrases

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • conversation_id — CHAR(36) — 외래 키 → Conversations.id
  • content — TEXT — NOT NULL — 저장한 문장
  • memo — TEXT
  • created_at — TIMESTAMP — NOT NULL

Terms

  • id — CHAR(36) — 기본 키 — NOT NULL
  • type — ENUM('terms', 'privacy') — NOT NULL — 이용약관 / 개인정보처리방침
  • version — VARCHAR(20) — NOT NULL
  • content — TEXT — NOT NULL
  • is_active — BOOLEAN — NOT NULL
  • created_at — TIMESTAMP — NOT NULL

Usage

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • cycle_start — DATE — NOT NULL
  • ai_count — INT — NOT NULL — AI 피드백 사용 횟수
  • feedback_count — INT — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

User_Badges

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • badge_id — CHAR(36) — 외래 키 → Badges.id — NOT NULL
  • earned_at — TIMESTAMP — NOT NULL

User_Profiles

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • 닉네임 (nickname) — VARCHAR(50)
  • 신분/상황 (학생, 직장인 등) (status_type) — VARCHAR(50) — 신분/상황 (학생, 직장인 등)
  • personality_type — ENUM('introvert', 'extrovert', 'ambivert') — 필요없으면 나중에 행 제거
  • 대화 어려운 상황 배열 (difficult_situations) — JSON
  • 편한 관계 유형 (preferred_style) — VARCHAR(255)
  • 관심사 배열 (interests) — JSON
  • 개인 목표 (purpose) — VARCHAR(255)
  • 캐릭터/이미지 (avatar_url) — VARCHAR(500)
  • 자기소개 (bio) — TEXT
  • 하루 대화 목표 횟수 (daily_conversation_goal) — INT — NOT NULL — 생성시 기본값 1로 설정
  • level — INT — NOT NULL — 생성시 기본값 1로 설정
  • 현재 누적 XP (xp) — INT — NOT NULL — 생성시 기본값 0으로 설정
  • onboarding_completed — BOOLEAN — NOT NULL — 기본값 false
  • onboarding_step — INT — NOT NULL — 기본값 0(시작 전)
  • onboarding_temp_data — JSON
  • created_at — TIMESTAMP — NOT NULL
  • updated_at — TIMESTAMP — NOT NULL

Users

  • id — CHAR(36) — 기본 키 — NOT NULL
  • 이름 (name) — VARCHAR(50) — NOT NULL
  • terms_agreed_at — TIMESTAMP
  • created_at — TIMESTAMP — NOT NULL
  • last_login_at — TIMESTAMP
  • status — ENUM('active','inactive','deleted') — NOT NULL
  • deleted_at — TIMESTAMP

XP_History

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • amount — INT — NOT NULL
  • 지급 사유 (reason) — VARCHAR(255) — NOT NULL — 'mission_complete' 등
  • reference_id — CHAR(36) — 관련 리소스 ID (mission_record 등)
  • reference_type — VARCHAR(50) — mission_complete / badge / event 등
  • created_at — TIMESTAMP — NOT NULL

구독 정보 (Subscriptions)

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • plan_id — CHAR(36) — 외래 키 → Plans.id — NOT NULL
  • status — ENUM('pending','active','expired','cancelled') — NOT NULL — DEFAULT 'pending'
  • started_at — TIMESTAMP — NOT NULL
  • expires_at — TIMESTAMP
  • created_at — TIMESTAMP — NOT NULL

지불 정보 (Payments)

  • id — CHAR(36) — 기본 키 — NOT NULL
  • user_id — CHAR(36) — 외래 키 → Users.id — NOT NULL
  • subscription_id — CHAR(36) — 외래 키 → 구독 정보.id
  • amount — DECIMAL(10, 2) — NOT NULL
  • currency — VARCHAR(3) — NOT NULL
  • method — VARCHAR(50) — NOT NULL
  • status — ENUM('pending', 'completed', 'failed', 'refunded') — NOT NULL
  • external_id — VARCHAR(255) — PG사 주문번호
  • retry_count — INT — NOT NULL
  • created_at — TIMESTAMP — NOT NULL
  • completed_at — TIMESTAMP