메뉴 항목 필드
메뉴 항목의 모든 필드에 대한 전체 참조입니다. 필수 필드는 표시되어 있습니다. 그 외의 모든 필드는 선택 사항이지만 최상의 고객 경험을 위해 입력을 권장합니다.
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
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입니다. 상태 폴링에 사용됩니다. |