(08.25 ERD)

Tables (13)

Refresh_token (리프레시 토큰)

  • id (리프레시 토큰 ID) — BIGINT — Primary key — NOT NULL
  • user_id (사용자ID) — CHAR(36) — Foreign key → user.id — NOT NULL
  • token_hash (토큰 해시) — VARCHAR(64) — NOT NULL
  • expires_at (만료 일시) — DATETIME(6) — NOT NULL
  • created_at (생성 일시) — DATETIME(6) — NOT NULL

cooking_session (조리 세션(AI))

  • id — BIGINT — Primary key — NOT NULL
  • user_id (사용자 ID) — CHAR(36) — Foreign key → user.id — NOT NULL
  • recipe_id (레시피 ID) — BIGINT — Foreign key → 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

feedback (피드백, 문의)

  • id (피드백 ID) — BIGINT — Primary key — NOT NULL
  • user_id (사용자 ID) — CHAR(36) — Foreign key → user.id
  • type (피드백 유형) — VARCHAR(30) — 피드백 유형(사용자 선택) - 오류/제안/좋았던 점/문의/기타(v2.29)
  • content (내용) — VARCHAR(1000) — NOT NULL
  • created_at (생성 일시) — DATETIME(6) — NOT NULL

notice (공지)

  • id (공지 ID) — BIGINT — Primary key — 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)

recipe (레시피)

  • id (레시피 ID) — BIGINT — Primary key — NOT NULL
  • source_video_id (원본 영상 ID) — BIGINT — Foreign key → 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) — BIGINT — Primary key — NOT NULL
  • recipe_id (레시피 ID) — BIGINT — Foreign key → 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_step (조리 단계)

  • id (조리 단계 ID) — BIGINT — Primary key — NOT NULL
  • recipe_id (레시피 ID) — BIGINT — Foreign key → 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) — BIGINT — Primary key — NOT NULL
  • recipe_id (레시피 ID) — BIGINT — Foreign key → recipe.id — NOT NULL
  • tag_id (태그 ID) — BIGINT — Foreign key → tag.id — NOT NULL
  • created_at (생성 일시) — DATETIME(6) — NOT NULL

source_video (원본 영상)

  • id (원본 영상 ID) — BIGINT — Primary key — 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) — BIGINT — Primary key — NOT NULL
  • recipe_step_id (단계 ID) — BIGINT — Foreign key → 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) — BIGINT — Primary key — NOT NULL
  • kind (태그 종류(축)) — VARCHAR(30) — NOT NULL
  • name (태그명) — VARCHAR(50) — NOT NULL
  • created_at (생성 일시) — DATETIME(6) — NOT NULL
  • updated_at (수정 일시) — DATETIME(6) — NOT NULL

user (사용자)

  • id (사용자ID) — CHAR(36) — Primary key — 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) — BIGINT — Primary key — NOT NULL
  • user_id (사용자 ID) — CHAR(36) — Foreign key → 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)