ScriptMeal_ERD

SW인재양성 프로젝트 ScriptMeal의 ERD 입니다.

테이블 (9)

검색 품질 로그 (search_query_log)

  • pk — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • session pk (session_id) — VARCHAR(30) — NOT NULL
  • user_message pk (user_message_id) — VARCHAR(30) — NOT NULL — USER 메시지 참조
  • 질의 원문 (query_text) — TEXT — NOT NULL
  • 구조화 쿼리 (parsed_query) — JSON
  • 유사도 점수 분포 (top_k_scores) — JSON — NOT NULL — number[]
  • 최고 유사도 점수 (top_score) — FLOAT — NOT NULL — 임계값 튜닝용 (top_k_scores0)
  • 적용 임계값 (threshold_used) — FLOAT — NOT NULL
  • 폴백 실행 여부 (fallback_used) — BOOLEAN — NOT NULL
  • 응답 지연 시간 (latency_ms) — INT
  • 로그 생성 일시 (created_at) — TIMESTAMP — NOT NULL

데이터 수집 작업 (etl_job)

  • pk (job_id) — VARCHAR(50) — 기본 키 — NOT NULL — etl_job_YYYYMMDD_NNN
  • source — ENUM('MFDS', 'NAQS',) — NOT NULL
  • 수집 모드 (mode) — ENUM('FULL', 'INCREMENTAL') — NOT NULL
  • 진행 상태 (status) — ENUM('QUEUED', 'RUNNING', 'COMPLETED', 'FAILED') — NOT NULL
  • 테스트 실행 여부 (dry_run) — BOOLEAN — NOT NULL
  • API 수집 건수 (fetched_count) — INT — NOT NULL
  • 정규화 완료 건수 (normalized_count) — INT — NOT NULL
  • LLM 추론 건수 (inferred_count) — INT — NOT NULL
  • 임베딩 완료 건수 (embedded_count) — INT — NOT NULL
  • RDB 적재 건수 (persisted_count) — INT — NOT NULL
  • 중복 건수 (duplicated_count) — INT — NOT NULL
  • 오류 메시지 (error_message) — TEXT
  • 작업 시작 일시 (started_at) — TIMESTAMP — NOT NULL
  • 작업 종료 일시 (finished_at) — TIMESTAMP

레시피 공유 토큰 (share_token)

  • 공유토큰(pk) (share_token) — VARCHAR(20) — 기본 키 — NOT NULL — nanoid 10자
  • recipe pk (recipe_id) — BIGINT — 외래 키 → 레시피 메타 정보.pk — NOT NULL
  • 발급 시각 (created_at) — TIMESTAMP — NOT NULL
  • 회수 시각 (revoked_at) — TIMESTAMP — 관리자 회수 시각

레시피 메타 정보 (recipe)

  • pk — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • 원본 데이터 출처 (source) — ENUM('MFDS', 'NAQS',) — NOT NULL
  • 식약처 레시피 ID (source_mfds_id) — VARCHAR(50)
  • 농림원 레시피 ID (source_naqs_id) — VARCHAR(50)
  • 레시피명 (name) — VARCHAR(200) — NOT NULL
  • 요리 종류 (category) — VARCHAR(50) — NOT NULL
  • 조리 방식 (cooking_method) — VARCHAR(50) — NAQS는 LLM 추론으로 값 생성
  • 대표 이미지 URL (thumbnail_url) — VARCHAR(500)
  • 조리 방식 추론 여부 (is_cm_inferred) — BOOLEAN — NOT NULL
  • 생성시각 (created_at) — TIMESTAMP — NOT NULL
  • 수정시각 (updated_at) — TIMESTAMP — NOT NULL

메시지별 추천 결과 (chat_recommendation)

  • pk — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • message pk (message_id) — VARCHAR(30) — 외래 키 → 채팅 메시지.pk — NOT NULL — ASSISTANT 메시지 참조
  • recipe pk (recipe_id) — BIGINT — 외래 키 → 레시피 메타 정보.pk — NOT NULL — 벡터 검색 추천 시 설정
  • 추천 순위 (rank_order) — INT — NOT NULL — 표시 순서(1부터)
  • 외부 출처명 (fallback_source) — VARCHAR(30) — YOUTUBE / NAVER_BLOG (폴백 전용)
  • 외부 레시피 본문 (fallback_payload) — JSON — 폴백 레시피 원본 (RDB 미적재분 보존용)
  • 유사도 점수 (similarity_score) — FLOAT
  • 추천 사유 (reason) — TEXT

재료 정보 (recipe_ingredient)

  • pk — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • recipe pk (recipe_id) — BIGINT — 외래 키 → 레시피 메타 정보.pk — NOT NULL
  • 식재료명 (name) — VARCHAR(100) — NOT NULL
  • 수량 (amout) — VARCHAR(50)
  • 단위 (unit) — VARCHAR(20)
  • 재료 그룹명 (group_name) — VARCHAR(50)
  • 원본 문자열 (raw_text) — TEXT — MFDS 재료 데이터 원문 파싱 전
  • 원본 데이터 출처 (source) — ENUM('MFDS', 'NAQS') — NOT NULL

조리 단계 (recipe_step)

  • pk — BIGINT — 기본 키 — NOT NULL — AUTO_INCREMENT
  • recipe pk (recipe_id) — BIGINT — 외래 키 → 레시피 메타 정보.pk — NOT NULL
  • 조리 순번 (step_number) — INT — NOT NULL
  • 조리 설명 (instruction) — TEXT — NOT NULL
  • 이미지 경로 (image_url) — VARCHAR(500) — NAQS는 이미지 없음
  • 원본 데이터 출처 (source) — ENUM('MFDS', 'NAQS') — NOT NULL

채팅 메시지 (chat_message)

  • pk — VARCHAR(30) — 기본 키 — NOT NULL — nanoid, prefix: msg_
  • session pk (session_id) — VARCHAR(30) — 외래 키 → 채팅 세션.pk — NOT NULL — nanoid, prefix: sess_
  • 발화 주체 (role) — ENUM('USER', 'ASSISTANT') — NOT NULL
  • 대화 본문 (content) — TEXT — NOT NULL — USER=원문쿼리 / ASSISTANT=reply 텍스트
  • 대화 본문 (parsed_query) — JSON — USER 메시지의 LLM 파싱 결과
  • 외부 검색 사용 여부 (fallback_used) — BOOLEAN — DB 검색 실패로 인한 폴백 수행 여부
  • 전송 시각 (created_at) — TIMESTAMP — NOT NULL

채팅 세션 (chat_session)

  • pk — VARCHAR(30) — 기본 키 — NOT NULL — nanoid, prefix: sess_
  • 생성시각 (created_at) — TIMESTAMP — NOT NULL
  • 세션 만료 시각 (expires_at) — TIMESTAMP — NOT NULL — TTL 24h
  • 최종 활성 일시 (last_active_at) — TIMESTAMP — NOT NULL