ERD v3.1 (7.22) cooking_sessions 추가
테이블 (31)
Refresh_token (리프레시 토큰)
- id (리프레시 토큰 ID) — BINARY(16) — 기본 키 — NOT NULL
- user_id (사용자ID) — BINARY(16) — 외래 키 → user.id — NOT NULL
- token_hash (토큰 해시) — VARCHAR(64) — NOT NULL
- expires_at (만료 일시) — DATETIME(6) — NOT NULL
- created_at (생성 일시) — DATETIME(6) — NOT NULL
cooking_history
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- recipe_id — UUID — 외래 키 → recipe.id — NOT NULL
- completed_at — DATETIME — NOT NULL
- cooked_seconds — INT — 실측 여부 미정(플래그)
- created_at — DATETIME — NOT NULL
cooking_session (조리 세션(AI))
- id — BINARY(16) — 기본 키 — NOT NULL
- user_id (사용자 ID) — BINARY(16) — 외래 키 → user.id — NOT NULL
- recipe_id (레시피 ID) — BINARY(16) — 외래 키 → recipe.id — NOT NULL
- status (조리 상태) — ENUM('ACTIVE', 'COMPLETED', 'CANCELLED', 'EXPIRED') — NOT NULL
- started_at (조리 시작 일시) — DATETIME(6) — NOT NULL
- ended_at (조리 종료 일시) — DATETIME(6)
- created_at (생성 일시) — DATETIME(6) — NOT NULL
- updated_at (수정 일시) — DATETIME(6) — NOT NULL
extraction_jobs
- id — UUID — 기본 키 — NOT NULL
- source_video_id — UUID — 외래 키 → source_video.id — 제출 시점 UPSERT 후 연결(v2.23). NULL = URL 파싱 실패(즉시 FAILED)뿐. 완료 레시피 도달은 이 값 -> recipes 체인
- user_id — UUID — 외래 키 → user.id — NOT NULL — 요청자 - 게스트 포함
- source_url — VARCHAR(500) — NOT NULL
- status — ENUM('QUEUED', 'FETCHING', 'PARSING', 'COMPLETED', 'FAILED', 'REJECTED') — NOT NULL — REJECTED=비요리 차단
- error_code — VARCHAR(50)
- error_message — TEXT — 사용자 알림+개발자 모니터링 공용
- created_at — DATETIME — NOT NULL
- updated_at — DATETIME — NOT NULL
feedback (피드백, 문의)
- id (피드백 ID) — BINARY(16) — 기본 키 — NOT NULL
- user_id (사용자 ID) — BINARY(16) — 외래 키 → user.id
- type (피드백 유형) — VARCHAR(30) — 피드백 유형(사용자 선택) - 오류/제안/좋았던 점/문의/기타(v2.29)
- content (내용) — VARCHAR(1000) — NOT NULL
- created_at (생성 일시) — DATETIME(6) — NOT NULL
folders
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL — 폴더는 개인 소유
- name — VARCHAR(50) — NOT NULL — 입력 제한은 서버 상수(정책 3.6). 기본 폴더는 행 없음 - 가상(정책 3.5)
- created_at — DATETIME — NOT NULL — 폴더 목록 정렬 기준(생성순) - 수동 정렬 요구 시 sort_order additive
- updated_at — DATETIME — NOT NULL — 이름 변경 추적 - 정렬 미사용
home_sections
- id — UUID — 기본 키 — NOT NULL
- recipe_id — UUID — 외래 키 → recipe.id — NOT NULL
- section — ENUM('POPULAR', 'RECOMMENDED') — NOT NULL
- position — INT — NOT NULL
- created_at — DATETIME — NOT NULL
notice (공지)
- id (공지 ID) — BINARY(16) — 기본 키 — NOT NULL
- title (제목) — VARCHAR(100) — NOT NULL
- body (본문) — VARCHAR(500) — NOT NULL
- type (공지 종류) — ENUM('UPDATE', 'NOTICE')
- created_at (생성 일시) — DATETIME(6) — NOT NULL — = 발행 시각(행 생성 = 발행) - 목록 정렬 기준. 어드민 전까지 운영 직접 INSERT
- updated_at (수정 일시) — DATETIME(6) — NOT NULL — 경미 수정 추적(정책 2.3: 원본만 수정, 팬아웃/푸시 불변. 중대 정정 = 새 공지, v2.35)
notifications
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- type — ENUM('EXTRACT_DONE', 'NOTICE', 'TIP_LIKE') — NOT NULL — 알림 종류(탭 전 축: 렌더링 분기 + 항목별 토글 판정). 1차 NOTICE, 2차 나머지 합류. 새 타입 = 값 추가(v2.28)
- title — VARCHAR(100) — NOT NULL — 발송 시점 완성문 저장 - 템플릿 변경에도 과거 알림 불변(v2.26)
- body — VARCHAR(300)
- landing_type — ENUM('RECIPE', 'TIP', 'NOTICE') — 탭 시 랜딩 대상 - NOTICE는 notices(id). 없으면 NULL
- landing_id — UUID
- read_at — DATETIME — 알림함에서 확인된 시각(진입 시 일괄 세팅, 정책 2.3) - NULL = 미확인(v2.34)
- created_at — DATETIME — NOT NULL
recipe (레시피)
- id (레시피 ID) — BINARY(16) — 기본 키 — NOT NULL
- source_video_id (원본 영상 ID) — BINARY(16) — 외래 키 → source_video.id — NOT NULL
- dish_name (요리명) — VARCHAR(100) — NOT NULL — 요리명 - 이름 검색 대상. title(레시피 제목)과 구분
- title (제목) — VARCHAR(200) — NOT NULL
- summary (요약) — VARCHAR(500) — NOT NULL — 4대 메타 - 항상 제공, 없으면 LLM 생성(v2.9)
- servings (인분) — VARCHAR(30) — NOT NULL — 원문 우선, 없으면 재료량 기반 추정(v2.9)
- cook_time_min (조리시간(분)) — INT — NOT NULL — 필터 축. 원문 없으면 단계·영상 기반 추정(v2.9)
- difficulty (난이도) — ENUM('EASY', 'NORMAL', 'HARD') — NOT NULL — 필터 축. LLM 추정 허용(v2.9)
- status (운영 상태) — ENUM('ACTIVE', 'HIDDEN') — NOT NULL — 운영 숨김 - 신고 처리·부적절 콘텐츠. 홈·목록·검색은 ACTIVE만(v2.8)
- created_at (생성 일시) — DATETIME — NOT NULL
- updated_at (수정 일시) — DATETIME — NOT NULL
recipe_ingredient (재료)
- id (재료 ID) — BINARY(16) — 기본 키 — NOT NULL
- recipe_id (레시피 ID) — BINARY(16) — 외래 키 → recipe.id — NOT NULL
- ingredient_group (재료 그룹) — ENUM('MAIN', 'SEASONING') — NOT NULL
- sort_order (표시 순서) — INT — NOT NULL
- name (재료명) — VARCHAR(100) — NOT NULL
- amount (분량) — VARCHAR(50) — 분량 원문 보존
- created_at (생성 일시) — DATETIME(6) — NOT NULL
- updated_at (수정 일시) — DATETIME(6) — NOT NULL
recipe_metrics_log
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- recipe_id — UUID — 외래 키 → recipe.id — NOT NULL
- action — ENUM('VIEW', 'COOK_START', 'COOK_COMPLETE') — NOT NULL
- created_at — DATETIME — NOT NULL
recipe_step (조리 단계)
- id (조리 단계 ID) — BINARY(16) — 기본 키 — NOT NULL
- recipe_id (레시피 ID) — BINARY(16) — 외래 키 → recipe.id — NOT NULL
- sort_order (단계 순서) — INT — NOT NULL
- title (단계 제목) — VARCHAR(100) — NOT NULL
- video_start_ms (구간 시작(밀리초)) — INT — 구간 재생. NULL=통 임베드 폴백
- video_end_ms (구간 끝(밀리초)) — INT
- created_at (생성 일시) — DATETIME(6) — NOT NULL
- updated_at (수정 일시) — DATETIME(6) — NOT NULL
recipe_tag (레시피 태그)
- id (레시피 태그 ID) — BINARY(16) — 기본 키 — NOT NULL
- recipe_id (레시피 ID) — BINARY(16) — 외래 키 → recipe.id — NOT NULL
- tag_id (태그 ID) — BINARY(16) — 외래 키 → tag.id — NOT NULL
- created_at (생성 일시) — DATETIME(6) — NOT NULL
recipe_tips
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- recipe_id — UUID — 외래 키 → recipe.id — NOT NULL
- content — VARCHAR(500) — NOT NULL
- like_count — INT — NOT NULL — 비정규화 카운터 - 원천은 tip_likes, 좋아요 트랜잭션에서 원자 증감(v2.24)
- created_at — DATETIME — NOT NULL
- updated_at — DATETIME — NOT NULL
reports
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- target_type — ENUM('RECIPE', 'TIP', 'REVIEW') — NOT NULL — 레시피 품질+UGC 통합. USER(프로필)는 확장
- target_id — UUID — NOT NULL
- reason_code — VARCHAR(50) — NOT NULL
- detail — VARCHAR(500)
- status — ENUM('RECEIVED', 'PROCESSED', 'REJECTED') — NOT NULL — 어드민 처리 상태
- created_at — DATETIME — NOT NULL
review_images
- id — UUID — 기본 키 — NOT NULL
- review_id — UUID — 외래 키 → reviews.id — NOT NULL
- image_url — VARCHAR(500) — NOT NULL
- display_order — INT — NOT NULL
- created_at — DATETIME — NOT NULL
reviews
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- recipe_id — UUID — 외래 키 → recipe.id — NOT NULL
- cooking_history_id — UUID — 외래 키 → cooking_history.id — NOT NULL — 완주 1회당 후기 1건 - UNIQUE로 보장
- rating — TINYINT — NOT NULL — 별점 1~5(1.0 단위 시). 0.5 단위 확정 시 2~10 반 개 카운트 재해석 - 스키마 무변경(v2.36)
- content — VARCHAR(1000) — DB 상한 = 방어선. 사용자 입력 제한은 서버 검증 상수 500 시작(정책 3.6, v2.36)
- created_at — DATETIME — NOT NULL
- updated_at — DATETIME — NOT NULL
search_logs
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL — 게스트 포함 - 탈퇴 파기 접점(정책 1.5)
- query — VARCHAR(100) — NOT NULL — 입력 원문(트림만) - 정규화 파생은 소급 가능이라 미저장(정책 3.4). 자동완성 확정 시 normalized additive
- created_at — DATETIME — NOT NULL
source_video (원본 영상)
- id (원본 영상 ID) — BINARY(16) — 기본 키 — NOT NULL
- platform (플랫폼) — ENUM('YOUTUBE', 'INSTAGRAM', 'TIKTOK') — NOT NULL
- url (원본 URL) — VARCHAR(500) — NOT NULL
- platform_video_id (플랫폼 영상 ID) — VARCHAR(64) — NOT NULL — 플랫폼 제공 영상 고유 ID(유튜브 11자, 인스타 shortcode, 틱톡 숫자) - 중복 판정·통계 API 호출 키
- title (영상 제목) — VARCHAR(200)
- author (채널, 계정명) — VARCHAR(100) — 채널명
- thumbnail_url (썸네일 URL) — VARCHAR(500)
- duration_ms (영상 길이(밀리초)) — INT
- created_at (생성 일시) — DATETIME(6) — NOT NULL
- updated_at (수정 일시) — DATETIME(6) — NOT NULL
step_detail (세부 단계)
- id (세부 단계 ID) — BINARY(16) — 기본 키 — NOT NULL
- recipe_step_id (단계 ID) — BINARY(16) — 외래 키 → recipe_step.id — NOT NULL
- sort_order (세부 순서) — INT — NOT NULL
- content (세부 안내 문장) — VARCHAR(300) — NOT NULL
- created_at (생성 일시) — DATETIME(6) — NOT NULL
- updated_at (수정 일시) — DATETIME(6) — NOT NULL
tag (태그)
- id (태그 ID) — BINARY(16) — 기본 키 — NOT NULL
- kind (태그 종류(축)) — VARCHAR(30) — NOT NULL
- name (태그명) — VARCHAR(50) — NOT NULL
- created_at (생성 일시) — DATETIME(6) — NOT NULL
- updated_at (수정 일시) — DATETIME(6) — NOT NULL
tip_likes
- id — UUID — 기본 키 — NOT NULL
- tip_id — UUID — 외래 키 → recipe_tips.id — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- created_at — DATETIME — NOT NULL
user (사용자)
- id (사용자ID) — BINARY(16) — 기본 키 — NOT NULL
- type (계정 유형) — ENUM('GUEST', 'MEMBER') — NOT NULL — 로그인 시 GUEST->MEMBER 승격
- nickname (닉네임) — VARCHAR(30) — 게스트는 없음. 가입 온보딩(1차, USER-12)에서 필수 입력 - OAuth 프로필명 프리필, 수정 가능
- profile_image_url (프로필 이미지 URL) — VARCHAR(500)
- gender (성별) — ENUM('M', 'F') — 선택 입력
- birth_year (출생연도) — INT — 출생연도, 선택 입력 - 나이는 계산(저장하면 낡음)
- deleted_at (탈퇴 일시) — DATETIME(6) — NULL=활성. 값=탈퇴 시각(soft delete) - purge 배치는 +30일 경과분 파기(v2.15)
- created_at (생성 일시) — DATETIME(6) — NOT NULL
- updated_at (수정 일시) — DATETIME(6) — NOT NULL
user_agreement (약관·수신 동의 이력)
- id (동의 이력 ID) — BINARY(16) — 기본 키 — NOT NULL
- user_id (사용자 ID) — BINARY(16) — 외래 키 → user.id — NOT NULL
- doc_type (약관 종류) — ENUM('TOS', 'PRIVACY', 'ANALYTICS') — NOT NULL
- doc_version (약관 버전) — VARCHAR(20) — NOT NULL
- action (동의/철회) — ENUM('AGREE', 'REVOKE', 'ACKNOWLEDGE') — NOT NULL — 철회도 행으로 append - 최신 행이 현재 상태(v2.6)
- created_at (생성 일시) — DATETIME(6) — NOT NULL — = 동의/철회 발생 시각(append-only라 생성=사건, v2.19)
user_devices
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- device_key — VARCHAR(128) — NOT NULL — 기기 행 식별(토큰 UPSERT 키) - 게스트 신원은 서버 발급 user_id(v2.4)
- push_token — VARCHAR(255) — 푸시 토큰(1차 공지 발송)
- created_at — DATETIME — NOT NULL
user_recipe_folders
- id — UUID — 기본 키 — NOT NULL
- user_recipe_id — UUID — 외래 키 → user_recipes.id — NOT NULL — 조인 축 = 요리북 항목 - 항목 제거 시 배치 CASCADE 소멸
- folder_id — UUID — NOT NULL
- created_at — DATETIME — NOT NULL
user_recipes
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- recipe_id — UUID — 외래 키 → recipe.id — NOT NULL
- origin — ENUM('IMPORTED', 'SAVED') — NOT NULL — 데이터 전용 - 사용자 미노출(팀 결정). 분석용 소급 불가 사건 속성(정책 3.5)
- created_at — DATETIME — NOT NULL
user_settings
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- preferences — JSON — 가입 시 {} 빈 행 생성(v2.31) - 키 없음=앱 기본값, 사용자가 변경한 값만 축적. 서버 일원 관리(v2.20), 승계 대상
- updated_at — DATETIME — NOT NULL
- created_at — DATETIME — NOT NULL
user_social_accounts
- id — UUID — 기본 키 — NOT NULL
- user_id — UUID — 외래 키 → user.id — NOT NULL
- provider — ENUM('GOOGLE', 'APPLE') — NOT NULL
- provider_uid — VARCHAR(191) — NOT NULL
- refresh_token — VARCHAR(512) — 암호화 보관. 애플 행만 사용 - 탈퇴 시 revoke 호출용(앱 심사 요건). 구글은 NULL
- created_at — DATETIME — NOT NULL
- updated_at — DATETIME — NOT NULL — 재로그인 시 토큰 갱신 추적
video_stats_snapshots
- id — UUID — 기본 키 — NOT NULL
- source_video_id — UUID — 외래 키 → source_video.id — NOT NULL
- view_count — BIGINT — NOT NULL
- like_count — BIGINT
- fetched_at — DATETIME — NOT NULL
- created_at — DATETIME — NOT NULL