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