종욱 멘토님 멘토링 7.15

테이블 (26)

Copy Of ai_cooking_session (CopyOfai_cooking_session)

  • ai_session_id — UUID — 기본 키 — NOT NULL
  • recipe_id (레시피 ID) — UUID — NOT NULL
  • model_config_id — UUID — NOT NULL
  • backend_cook_session_id — BIGINT — NOT NULL
  • status — VARCHAR(20) -> ENUM — NOT NULL
  • provider_resume_handle — TEXT — NOT NULL
  • provider_resume_expires_at — TIMESTAMPTZ — NOT NULL
  • started_at — TIMESTAMPTZ — NOT NULL
  • ended_at — TIMESTAMPTZ
  • created_at — TIMESTAMPTZ — NOT NULL
  • updated_at — TIMESTAMPTZ — NOT NULL

app_feedbacks

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • content — VARCHAR(1000) — NOT NULL
  • created_at — DATETIME — NOT NULL

cooking_history

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • completed_at — DATETIME — NOT NULL
  • cooked_seconds — INT — 실측 여부 미정(COOK-13 플래그)
  • created_at — DATETIME — NOT NULL

extraction_jobs

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL — 요청자 - 게스트 포함
  • source_video_id — UUID — 외래 키 → source_videos.id
  • recipe_id — UUID — 외래 키 → recipes.id — 완료 시 결과 레시피
  • source_url — VARCHAR(500) — NOT NULL
  • platform — ENUM('YOUTUBE', 'INSTAGRAM', 'TIKTOK') — 파싱 결과 - 파싱 실패 시 NULL로 즉시 FAILED
  • platform_video_id — VARCHAR(64) — 파싱 결과 - 중복 판정은 source_videos (platform, platform_video_id) 조회
  • status — ENUM('QUEUED', 'FETCHING', 'PARSING', 'COMPLETED', 'FAILED', 'REJECTED') — NOT NULL — REJECTED=비요리 차단(EXTRACT-06)
  • error_code — VARCHAR(50)
  • error_message — TEXT — 사용자 알림(EXTRACT-08)+개발자 모니터링(SYS-03) 공용
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

home_curations

  • id — UUID — 기본 키 — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • section — ENUM('POPULAR', 'RECOMMENDED') — NOT NULL
  • position — INT — NOT NULL
  • created_at — DATETIME — NOT NULL

notifications

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • type — ENUM('EXTRACT_DONE', 'NOTICE', 'TIP_LIKE', 'ETC') — NOT NULL — 알림 항목(NOTI-01) - 목록 확정 필요 플래그
  • payload — JSON — 랜딩 대상 등
  • read_at — DATETIME
  • created_at — DATETIME — NOT NULL

recipe_ingredients

  • id — UUID — 기본 키 — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • grp — ENUM('MAIN', 'SEASONING') — NOT NULL
  • display_order — INT — NOT NULL
  • name — VARCHAR(100) — NOT NULL
  • amount — VARCHAR(50) — 분량 원문 보존
  • created_at — DATETIME — NOT NULL

recipe_metrics_log

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • action — ENUM('VIEW','COOK_START','COOK_COMPLETE') — NOT NULL
  • created_at — DATETIME — NOT NULL

recipe_steps

  • id — UUID — 기본 키 — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • sort_order — INT — NOT NULL
  • title — VARCHAR(100) — NOT NULL
  • video_start_sec — INT — 구간 재생(COOK-03). NULL=통 임베드 폴백(COOK-06)
  • video_end_sec — INT
  • created_at — DATETIME — NOT NULL

recipe_tags

  • id — UUID — 기본 키 — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • tag_id — UUID — 외래 키 → tags.id — NOT NULL
  • created_at — DATETIME — NOT NULL

recipe_tips

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • content — VARCHAR(500) — NOT NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

recipes

  • id — UUID — 기본 키 — NOT NULL
  • source_video_id — UUID — 외래 키 → source_videos.id — NOT NULL
  • name — VARCHAR(100) — NOT NULL — 요리명 - 이름 검색 대상(LIST-02)
  • 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 — 필터 축(LIST-07). 원문 없으면 단계·영상 기반 추정(v2.9)
  • difficulty — ENUM('EASY', 'NORMAL', 'HARD') — NOT NULL — 필터 축(LIST-07). LLM 추정 허용(v2.9)
  • status — ENUM('ACTIVE', 'HIDDEN') — NOT NULL — 운영 숨김 - 신고 처리·부적절 콘텐츠(DETAIL-10). 홈·목록·검색은 ACTIVE만(v2.8)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

reports

  • id — UUID — 기본 키 — NOT NULL
  • reporter_id — UUID — 외래 키 → users.id — NOT NULL
  • target_type — ENUM('RECIPE', 'TIP', 'REVIEW') — NOT NULL — 레시피 품질(DETAIL-10)+UGC(SOCIAL-07) 통합. USER(프로필)는 확장
  • target_id — UUID — NOT NULL
  • reason_code — VARCHAR(50) — NOT NULL
  • detail — VARCHAR(500)
  • status — ENUM('RECEIVED', 'PROCESSED', 'REJECTED') — NOT NULL — 어드민(ADMIN-01) 처리 상태
  • 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 — 외래 키 → users.id — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • cooking_history_id — UUID — 외래 키 → cooking_history.id — NOT NULL — 완주 1회당 후기 1건(SOCIAL-04) - UNIQUE로 보장
  • rating — TINYINT — NOT NULL — 별점 1~5
  • content — VARCHAR(1000)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

source_videos

  • id — UUID — 기본 키 — NOT NULL
  • platform — ENUM('YOUTUBE', 'INSTAGRAM', 'TIKTOK') — NOT NULL
  • url — VARCHAR(500) — NOT NULL
  • platform_video_id — VARCHAR(64) — NOT NULL — 플랫폼 제공 영상 고유 ID(유튜브 11자, 인스타 shortcode, 틱톡 숫자) - 중복 판정(EXTRACT-01)·통계 API 호출 키
  • title — VARCHAR(200)
  • author — VARCHAR(100) — 채널명
  • thumbnail_url — VARCHAR(500)
  • duration_sec — INT
  • created_at — DATETIME — NOT NULL

step_details

  • id — UUID — 기본 키 — NOT NULL
  • step_id — UUID — 외래 키 → recipe_steps.id — NOT NULL
  • sort_order — INT — NOT NULL
  • content — VARCHAR(300) — NOT NULL
  • created_at — DATETIME — NOT NULL

tags

  • id — UUID — 기본 키 — NOT NULL
  • kind — ENUM('CUISINE','FLAVOR','TEMPERATURE','ETC') — NOT NULL
  • name — VARCHAR(50) — NOT NULL
  • created_at — DATETIME — NOT NULL

tip_likes

  • id — UUID — 기본 키 — NOT NULL
  • tip_id — UUID — 외래 키 → recipe_tips.id — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • created_at — DATETIME — NOT NULL

user_consents

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • doc_type — ENUM('TOS', 'PRIVACY', 'MARKETING') — NOT NULL
  • doc_version — VARCHAR(20) — NOT NULL
  • action — ENUM('AGREE', 'REVOKE') — NOT NULL — 철회도 행으로 append - 최신 행이 현재 상태(v2.6)
  • occurred_at — DATETIME — NOT NULL — 동의/철회 발생 시각
  • created_at — DATETIME — NOT NULL

user_devices

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • device_key — VARCHAR(128) — NOT NULL — 기기 행 식별(토큰 UPSERT 키) - 게스트 신원은 서버 발급 user_id(v2.4)
  • platform — ENUM('IOS', 'ANDROID')
  • push_token — VARCHAR(255) — 푸시 토큰(NOTI-02, 1차 공지 발송)
  • last_seen_at — DATETIME
  • created_at — DATETIME — NOT NULL

user_identities

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • provider — ENUM('GOOGLE', 'APPLE') — NOT NULL
  • provider_uid — VARCHAR(255) — NOT NULL
  • refresh_token — VARCHAR(500) — 암호화 보관. 애플 행만 사용 - 탈퇴 시 revoke 호출용(USER-03, 앱 심사 요건). 구글은 NULL
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL — 재로그인 시 토큰 갱신 추적

user_recipes

  • id — UUID — 기본 키 — NOT NULL
  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • recipe_id — UUID — 외래 키 → recipes.id — NOT NULL
  • origin — ENUM('IMPORTED', 'SAVED') — NOT NULL — 데이터 전용 - 사용자 미노출(팀 결정). 삭제 분기(BOOK-04)·승계 판단
  • created_at — DATETIME — NOT NULL

user_settings

  • user_id — UUID — 외래 키 → users.id — NOT NULL
  • preferences — JSON — 재생 기본값, 온보딩/가이드 플래그(AI-02,SYS-04,MY-03) - 승계 대상
  • updated_at — DATETIME — NOT NULL
  • created_at — DATETIME — NOT NULL

users

  • id — UUID — 기본 키 — NOT NULL
  • type — ENUM('GUEST', 'MEMBER') — NOT NULL — 로그인 시 GUEST->MEMBER 승격(USER-01,02)
  • status — ENUM('ACTIVE', 'WITHDRAWN') — NOT NULL — 탈퇴=WITHDRAWN soft delete(USER-03)
  • nickname — VARCHAR(30) — 1차 게스트는 없음. 2차 가입 시 앱에서 필수 강제 - OAuth 프로필명 프리필, 수정 가능(USER-06)
  • profile_image_url — VARCHAR(500)
  • gender — ENUM('M', 'F') — 선택 입력(USER-07)
  • age_group — VARCHAR(10) — 연령대, 선택 입력(USER-07)
  • withdrawn_at — DATETIME
  • purge_due_at — DATETIME — 탈퇴 30일 후 삭제 예정일(USER-03)
  • created_at — DATETIME — NOT NULL
  • updated_at — DATETIME — NOT NULL

video_stats_snapshots

  • id — UUID — 기본 키 — NOT NULL
  • source_video_id — UUID — 외래 키 → source_videos.id — NOT NULL
  • view_count — BIGINT — NOT NULL
  • like_count — BIGINT
  • fetched_at — DATETIME — NOT NULL
  • created_at — DATETIME — NOT NULL