菜品字段
以下是菜品所有字段的完整参考。必填字段已标出。其他所有字段均为可选,但为了提供最佳顾客体验,建议填写。
| 字段 | 类型 | 必填 | 描述 |
|---|---|---|---|
name |
String | 是 | 显示在菜单上的菜品名称。最多 200 个字符。 |
description |
String | 否 | 对菜品的简短描述。提及主要食材和烹饪方式。建议两到三句话。 |
price |
Decimal | 是 | 显示价格(例如 14.99)。在菜单上向顾客展示。 |
priceCents |
Integer | 自动 | 以分为单位存储的价格(例如 1499)。根据 price 字段自动计算。在内部使用以保证精度。 |
category |
String | 否 | 该菜品所属的分类(例如"开胃菜"、"主菜"、"甜点")。用于在公开菜单上对菜品进行分组。 |
photoUrl |
URL | 是 | 已上传照片的 URL。在上传和 AI 处理完成后自动设置。 |
isActive |
Boolean | 否 | 该菜品是否在公开菜单上可见。默认为 true。设置为 false 可隐藏而不删除。 |
position |
Integer | 否 | 在该菜品所属分类中的排序顺序。数字越小越靠前。没有位置值的菜品按创建日期排序。 |
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。用于状态轮询。 |