meal-fit

테이블 (12)

가격 시계열 기준(추적 기준) (price_series)

  • 가격 정보 ID (series_id) — BIGINT — 기본 키 — NOT NULL
  • 식재료 ID (ingredient_id) — BIGINT — 외래 키 → 식재료.식재료 ID — NOT NULL
  • 정보 출처 (source_name) — VARCHAR(80) — NOT NULL — 예시: KAMIS
  • API 부류 코드 (source_category_code) — VARCHAR(80) — 외부 API의 부류/카테고리 코드
  • API 품목 코드 (source_item_code) — VARCHAR(80) — NOT NULL
  • API 품종 코드 (source_kind_code) — VARCHAR(80) — 외부 API의 품종·형태 코드
  • API 등급/규격 코드 (source_rank_code) — VARCHAR(80) — 외부 API의 등급·크기·규격 코드
  • 품종/형태 (variety) — VARCHAR(80) — NOT NULL — 품종, 원산지, 가공 상태 등 품목 세부 정보
  • 등급/규격 (grade) — VARCHAR(40) — NOT NULL — 상품·중품·대·중·L과 등 가격 구분 기준
  • 가격 유형 (price_type) — VARCHAR(20) — NOT NULL — 도매가인지 소매가인지
  • 시장이름 (market) — VARCHAR(80) — NOT NULL
  • 지역 (region) — VARCHAR(80) — NOT NULL — 해당 가격 조사가 이루어진 행정 구역 또는 지역 단위 예시: "서울", "경기", "부산"
  • 원본 단위 명칭 (original_unit) — VARCHAR(30) — NOT NULL — "kg", "g", "개", "포기", "근", "ml", "박스"
  • 수량 크기 (unit_quantity) — NUMERIC(15, 4) — NOT NULL — 예시: 만약 외부 데이터가 "10kg" 단위로 가격을 준다면 원본 단위(original_unit)는 "kg"이 되고, 수량 크기(unit_quantity)에는 숫자인 10.000000이 들어갑니다.
  • 원가 계산 대표 기준값 사용 여부 (is_cost_basis) — BOOLEAN — NOT NULL — "우리 시설의 실제 메뉴 원가 계산을 산정할 때 대표 지표로 쓸 진짜 기준인가?"를 판별하는 참/거짓(Boolean) 플래그 백엔드 설정값(관리자용 옵션)
  • 생성일자 (created_at) — TIMESTAMPTZ — NOT NULL
  • 수정일자 (updated_at) — TIMESTAMPTZ — NOT NULL

가격 예측 (price_prediction)

  • 예측 데이터 ID (prediction_id) — BIGINT — 기본 키 — NOT NULL
  • 가격 정보 ID (series_id) — BIGINT — 외래 키 → 가격 시계열 기준(추적 기준).가격 정보 ID — NOT NULL
  • 예측 시작 일자 (base_date) — DATE — NOT NULL
  • 예측 목표 일자 (target_date) — DATE — NOT NULL
  • 예측 시작 시점 가격 (base_price) — NUMERIC(18,6) — NOT NULL
  • 예측 가격 (predicted_price) — NUMERIC(18,6) — NOT NULL
  • 예측 시 사용 모델 (model_name) — VARCHAR(60)
  • 모델 버전 (model_version) — VARCHAR(80)
  • 예측 가격 생성 시점 (generated_at) — TIMESTAMPTZ

끼니별 식단 (meal_plan)

  • 식단 ID (plan_id) — BIGINT — 기본 키 — NOT NULL
  • 소속시설 ID (facility_id) — BIGINT — 외래 키 → 시설.소속시설 ID — NOT NULL
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL
  • 식단 제공 날짜 (plan_date) — DATE — NOT NULL
  • 끼니구분 (meal_type) — VARCHAR(20) — NOT NULL — 조식, 중식, 석식
  • 끼니 예상 식수 인원수 (meal_count) — INTEGER — NOT NULL
  • 수정 횟수 (version) — INTEGER — NOT NULL
  • 생성 일자 (created_at) — TIMESTAMPTZ — NOT NULL
  • 수정 일자 (updated_at) — TIMESTAMPTZ — NOT NULL

매뉴 구성 식재료 (menu_ingredient)

  • 메뉴 구성 식재료 번호 (menu_ingredient_id) — BIGINT — 기본 키 — NOT NULL
  • 메뉴 ID (menu_id) — BIGINT — 외래 키 → 메뉴.메뉴 ID — NOT NULL
  • 식재료 ID (ingredient_id) — BIGINT — 외래 키 → 식재료.식재료 ID — NOT NULL
  • 1인분 사용량 기준 단위 (quantity) — NUMERIC(12,3)
  • 주재료 여부 (is_primary) — BOOLEAN — NOT NULL
  • 생성일자 (created_at) — TIMESTAMPTZ
  • 수정일자 (updated_at) — TIMESTAMPTZ

메뉴 (menu)

  • 메뉴 ID (menu_id) — BIGINT — 기본 키 — NOT NULL
  • 메뉴 코드 (menu_code) — VARCHAR(80) — NOT NULL
  • 메뉴 이름 (name) — VARCHAR(150) — NOT NULL
  • 상위분류 (upper_category) — VARCHAR(100) — NOT NULL
  • 하위 분류 (category) — VARCHAR(100)
  • 기본 배치 구분 (slot_type) — VARCHAR(20) — 국인지 밥인지 메인 반찬인지 서브반찬인지
  • 1인분 제공중량 (serving_weight_g) — NUMERIC(10,2)
  • 1인분 열량 kcal (energy_kcal) — NUMERIC(10,2)
  • 1인분 단백질 g (protein_g) — NUMERIC(10,3)
  • 1인분 지방 g (fat_g) — NUMERIC(10,3)
  • 1인분 탄수화물 g (carbohydrate_g) — NUMERIC(10,3)
  • 1인분 나트륨 mg (sodium_mg) — NUMERIC(10,3)
  • 알레르기 유발 재료 (allergen_codes) — TEXT[] — 알레르기 유발 물질 예시: EGGS (난류) MILK (우유) BUCKWHEAT (메밀) PEANUT (땅콩) SOYBEAN (대두) WHEAT (밀) MACKEREL (고등어) 등 법정 알레르기 유발 품목 코드
  • 메뉴 사용 여부 (is_active) — BOOLEAN
  • 생성일자 (created_at) — TIMESTAMPTZ
  • 수정일자 (updated_at) — TIMESTAMPTZ

메뉴 검색 문서 (rag_document)

  • 메뉴 코드 (menu_code) — VARCHAR(80) — 외래 키 → 메뉴.메뉴 ID — NOT NULL
  • 메뉴정보 (content) — TEXT — NOT NULL
  • 부가정보 (metadata) — JSONB — NOT NULL
  • 임베딩 벡터 데이터 (embedding) — vector(1536) — NOT NULL
  • 임베딩 모델명 (embedding_model) — VARCHAR(100) — NOT NULL
  • 내용 해시 (content_hash) — VARCHAR(64) — NOT NULL
  • 임베딩 생성 일시 (embedded_at) — TIMESTAMPTZ — NOT NULL

사용자 (app_user)

  • 사용자 ID (user_id) — BIGINT — 기본 키 — NOT NULL
  • 소속시설 ID (facility_id) — BIGINT — 외래 키 → 시설.소속시설 ID
  • 이메일 (email) — VARCHAR(150) — NOT NULL
  • 비밀번호 (password_hash) — VARCHAR(255) — NOT NULL — 비밀번호 원문(123456 같은 평문)이 아니라, bcrypt 등으로 암호화된 해시(Hash) 값이 통째로 저장되는 자리
  • 사용자 이름 (name) — VARCHAR(50)
  • 권한 (role) — VARCHAR(20) — 일반 사용자: USER 관리자: ADMIN 매장/시설 담당자: MANAGER
  • 상태 (status) — VARCHAR(20) — 활성(정상 이용 중): ACTIVE 휴면 계정: INACTIVE 이용 정지(블랙리스트 등): SUSPENDED 회원 탈퇴: DELETED
  • 생성일자 (created_at) — TIMESTAMPTZ
  • 수정일자 (updated_at) — TIMESTAMPTZ

시설 (facility)

  • 소속시설 ID (facility_id) — BIGINT — 기본 키 — NOT NULL
  • 소속 시설 이름 (name) — VARCHAR(100) — NOT NULL
  • 시설 유형 (facility_type) — VARCHAR(30) — NOT NULL
  • 주소 (address) — VARCHAR(255)
  • 담당자 이름 (contact_name) — VARCHAR(50)
  • 기본 식수인원 (default_meal_count) — INTEGER — NOT NULL
  • 조식 식수인원 (breakfast_meal_count) — INTEGER
  • 중식 식수인원 (lunch_meal_count) — INTEGER
  • 석식 식수인원 (dinner_meal_count) — INTEGER
  • 1명 1끼 목표 식재료비 (target_food_cost) — NUMERIC(12,2) — NOT NULL — "우리 시설은 한 끼에 한 사람당 4,500원을 넘기지 않겠다" 같은 기준 단가를 설정
  • 생성일자 (created_at) — TIMESTAMPTZ — NOT NULL
  • 수정일자 (updated_at) — TIMESTAMPTZ — NOT NULL

식단 메뉴 편성 (meal_plan_item)

  • 메뉴 편성 ID (plan_item_id) — BIGINT — 기본 키 — NOT NULL
  • 식단 ID (plan_id) — BIGINT — 외래 키 → 끼니별 식단.식단 ID — NOT NULL
  • 원본 메뉴 ID (original_menu_id) — BIGINT — 외래 키 → 메뉴.메뉴 ID — NOT NULL
  • 최종 반영 메뉴 ID (menu_id) — BIGINT — 외래 키 → 메뉴.메뉴 ID — NOT NULL
  • 편성 슬롯 (sloy_type) — VARCHAR(20)
  • 메뉴 배치 순서 (display_order) — SMALLINT
  • 현재 편성 여부 (is_active) — BOOLEAN
  • 생성 일자 (created_at) — TIMESTAMPTZ
  • 수정일시 (updated_at) — TIMESTAMPTZ

식재료 (ingredient)

  • 식재료 ID (ingredient_id) — BIGINT — 기본 키 — NOT NULL
  • 식재료 식별용 문자열 코드 (ingredient_code) — VARCHAR(80) — NOT NULL — 시스템 내부나 외부 연동 시 각 식재료를 고유하게 식별하기 위해 부여하는 사람이 읽기 쉬운 식별용 문자열 코드
  • 식재료 이름 (name) — VARCHAR(150) — NOT NULL
  • 식재료 품목 분류군 (category) — VARCHAR(100) — 주요 식재료 분류 예시: 채소류 (예: 양파, 대파, 상추 등) 육류 (예: 소고기, 돼지고기, 닭고기 등) 수산물류 (예: 고등어, 오징어 등) 곡류/전분류 (예: 쌀, 밀가루, 당면 등) 양념/소스류 (예: 고…
  • 기준 단위 (standard_unit) — VARCHAR(10) — NOT NULL — 이 식재료가 시스템 내부에서 계산될 때 KG 기준인지, COUNT(개) 기준인지 명시합니다.
  • 사용 여부 (is_active) — BOOLEAN — NOT NULL — 이 식재료를 현재 시스템에서 사용할 것인가?
  • 생성일자 (created_at) — TIMESTAMPTZ — NOT NULL
  • 수정일자 (updated_at) — TIMESTAMPTZ — NOT NULL

식재료 가격(도매가) (ingredient_price)

  • 식재료 가격 ID (price_id) — BIGINT — 기본 키 — NOT NULL
  • 가격 정보 ID (series_id) — BIGINT — 외래 키 → 가격 시계열 기준(추적 기준).가격 정보 ID — NOT NULL
  • 가격 산정일 (price_date) — DATE — NOT NULL
  • API 응답 가격(원) (original_price) — NUMERIC(15, 2) — NOT NULL
  • 단위 수량 (unit_quantity) — NUMERIC(15, 4) — NOT NULL — 의미: 외부 API나 공급처에서 가격을 가져올 때, 그 가격이 어떤 양(수치)을 기준으로 매겨진 것인지를 숫자로 담아두는 필드입니다. 예시: 외부 API에서 사과 가격이 "10kg에 30,000원"으로 들어왔다면,…
  • 기준 단위 가격 (standard_unit_price) — NUMERIC(18,6) — NOT NULL — 의미: 위에서 수집한 가격을 시스템 내부의 통일된 최소 기준 단위(예: 1g당 혹은 1ml당 가격)로 환산해서 미리 계산해 둔 값입니다. 예시: 위에서 10kg에 30,000원짜리 사과였다면, 이를 1g 단위로 쪼…
  • 수집 시점 (collected_at) — TIMESTAMPTZ — NOT NULL

월간 예산 (monthly_budget)

  • 예산 ID (budget_id) — BIGINT — 기본 키 — NOT NULL
  • 소속시설 ID (facility_id) — BIGINT — 외래 키 → 시설.소속시설 ID — NOT NULL
  • 예산 월의 첫날 (budget_month) — DATE — NOT NULL — 해당 월의 첫 번째 날(예: 2026-05-01)로 고정해서 저장합니다.
  • 월 예산 금액 (budget_amount) — NUMERIC(15,2) — NOT NULL
  • 생성일자 (created_at) — TIMESTAMPTZ — NOT NULL
  • 수정일자 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 실행 예산 (monthly_budget) — NUMERIC(15,2) — 월의 지출된 예산