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