주요 콘텐츠로 건너뛰기

참조

메뉴 항목 필드

메뉴 항목 필드

메뉴 항목의 모든 필드에 대한 전체 참조입니다. 필수 필드는 표시되어 있습니다. 그 외의 모든 필드는 선택 사항이지만 최상의 고객 경험을 위해 입력을 권장합니다.

필드 유형 필수 설명
name String 예 메뉴에 표시되는 요리 이름입니다. 최대 200자입니다.
description String 아니요 요리에 대한 짧은 설명입니다. 주요 재료와 조리 방식을 언급하세요. 두세 문장을 권장합니다.
price Decimal 예 표시 가격입니다(예: 14.99). 메뉴에서 고객에게 표시됩니다.
priceCents Integer 자동 센트 단위로 저장된 가격입니다(예: 1499). price 필드에서 자동으로 계산됩니다. 정확성을 위해 내부적으로 사용됩니다.
category String 아니요 이 항목이 속한 카테고리입니다(예: "Appetizers", "Mains", "Desserts"). 공개 메뉴에서 항목을 묶는 데 사용됩니다.
photoUrl URL 예 업로드된 사진의 URL입니다. 업로드 및 AI 처리 후 자동으로 설정됩니다.
isActive Boolean 아니요 공개 메뉴에 항목을 표시할지 여부입니다. 기본값은 true입니다. 삭제하지 않고 숨기려면 false로 설정합니다.
position Integer 아니요 항목이 속한 카테고리 내 정렬 순서입니다. 숫자가 낮을수록 먼저 표시됩니다. position이 없는 항목은 생성일 기준으로 정렬됩니다.
restaurantId UUID 자동 이 항목이 속한 레스토랑입니다. 세션에서 자동으로 설정됩니다.
createdAt DateTime 자동 항목이 생성된 시각의 타임스탬프입니다. 자동으로 설정됩니다.
updatedAt DateTime 자동 마지막 업데이트의 타임스탬프입니다. 저장할 때마다 자동으로 업데이트됩니다.

3D 모델 필드(3D Menu Pro 전용)

3D Menu Pro를 사용하는 경우 각 메뉴 항목에는 다음과 같은 추가 필드를 가진 3D 모델이 연결될 수 있습니다.

필드 유형 설명
modelUrl URL 최적화된 GLB 모델 파일의 URL입니다. 처리가 완료된 후 설정됩니다.
status Enum 처리 상태: PENDING, GENERATING, PROCESSING, READY 또는 FAILED.
provider String 3D 생성에 사용된 AI 제공업체입니다.
providerTaskId String 3D 생성 제공업체의 외부 작업 ID입니다. 상태 폴링에 사용됩니다.