HandyCafe Docs
owner it-admin

如何设置餐饮模块

本指南将逐步指导您完成餐饮模块的首次设置。完成后，您将在 handy.cafe/{your-slug} 上拥有一个发布的客户菜单，一个包含至少一个可用桌子的平面图，一个包含产品的菜单，以及一个成功下达的测试订单。

您需要准备的

  • 一个有效的 HandyCafe 许可证。餐饮模块的身份验证会自动使用许可证，您无需手动粘贴密钥。
  • 服务器上的互联网连接。餐饮模块优先使用云服务，因此配置、菜单同步和订单轮询都需要访问云 API。
  • 您想用于公共菜单 URL 的 slug。允许的字符为小写字母、数字和短横线。长度为 3 到 62 个字符。
  • 可选：一个 logo 和头图。推荐格式为 WebP，大小不超过 2 MB。
  • 可选：本地网络上的 TCP 收据打印机。

步骤 1：启用餐饮模块

  1. 打开 HandyCafe 服务器。
  2. 在侧边栏中导航到 设置。
  3. 打开 餐饮 标签。
  4. 切换 启用餐饮 为开启。
  5. 服务器使用您的许可证作为授权令牌联系云 API。如果成功，配置向导将打开。

预期结果： 配置向导屏幕出现。如果您看到有关许可证或连接的错误，请检查您的互联网连接并确认您的 HandyCafe 许可证是有效的。

步骤 2：配置您的咖啡馆

向导要求填写四个字段。

  1. Slug。 输入您想要的 URL 后缀。可用性指示器会在一秒内更新。如果 slug 已被占用或保留，请选择其他的。
  2. 显示名称。 在客户菜单顶部显示的人性化名称，例如 "Atilla's Gaming Lounge"。
  3. 国家和货币。 选择咖啡馆运营的国家。货币根据国家默认设置，可以更改。
  4. 时区。 选择订单和结算时间戳的时区。
  5. 点击 创建咖啡馆。

预期结果： 向导关闭，餐饮工作区打开。您的公共 URL handy.cafe/{slug} 现在已上线，但菜单为空。

步骤 3：填写业务资料

  1. 仍在设置 > 餐饮下，滚动到业务资料部分。
  2. 上传一个 Logo（方形图片）。
  3. 上传一个 头图（宽横幅）。
  4. 输入 地址 和 电话，以显示在客户菜单的页脚。
  5. 根据您是否希望客户看到预计准备时间，切换 在菜单上显示准备时间 为开或关。
  6. 点击 保存。

预期结果： Logo 和头图出现在预览中。在浏览器中访问 handy.cafe/{slug} 现在显示品牌化的头图，但内容仍为空。

步骤 4：创建楼层

  1. 在设置 > 餐饮中，找到楼层部分。
  2. 点击 添加楼层 并命名（例如 "Main Hall"）。
  3. 如果您的场地有多个区域，请添加其他楼层（例如 "Mezzanine", "Outdoor Patio"）。
  4. 使用上移和下移按钮重新排序楼层。顶层在平面图编辑器中成为默认楼层。

预期结果： 您的楼层出现在列表中。餐饮 > 平面图标签现在在顶部显示楼层标签。

步骤 5：构建平面图

  1. 打开 餐饮 > 平面图。
  2. 从标签中选择第一层楼。
  3. 点击 添加桌子。一个方形桌子出现在画布原点。
  4. 拖动桌子到所需位置。释放以保存。
  5. 点击桌子以打开其属性面板。配置：
    • 代码（例如 "T1", "Window 3"）。
    • 显示名称（可选的较长标签）。
    • 座位数（座位数量）。
    • 形状（方形、横向矩形、纵向矩形或圆形）。
    • 大小（1 到 10）。
  6. 为楼层中的每张桌子重复此操作。
  7. 可选择切换到 3D 视图，从建筑师的角度查看布局。

预期结果： 您的平面图在实际位置渲染所有桌子。在 3D 视图中拖动被禁用；切换回 2D 以移动桌子。

步骤 6：构建菜单

  1. 打开 餐饮 > 菜单。
  2. 点击 添加类别。输入名称并从图标选择器中选择一个 MDI 图标。点击保存。
  3. 为每个类别重复此操作（例如 "热饮", "冷饮", "汉堡", "甜点"）。
  4. 在一个类别中，点击 添加产品。输入：
    • 名称。
    • 描述（支持 Markdown）。
    • 配料行。
    • 基础价格。
    • 增值税率。
    • 准备时间（静态备用）。
    • 可选：单位标签、库存跟踪标志、库存数量。
  5. 上传产品 照片。接受任何格式；推荐使用 WebP，大小不超过 2 MB。
  6. 点击保存。
  7. 如果产品有选项，滚动到变体部分并点击 添加变体。为每个选项创建一行并设置价格差。切换 必选 如果客户必须选择一个。
  8. 为菜单中的每个产品重复此操作。

预期结果： 客户菜单在 handy.cafe/{slug} 现在显示您的类别和产品。用浏览器访问以验证。

步骤 7：配置打印机（可选）

  1. 仍在设置 > 餐饮下，滚动到打印机设置。
  2. 将 类型 设置为 TCP。
  3. 输入打印机 IP 和 端口。大多数 ESC POS TCP 打印机监听端口 9100。
  4. 如果打印机支持，启用 自动切纸。
  5. 启用 新订单自动打印 以触发每个新订单的打印。
  6. 启用 声音通知 以在桌面通知旁播放音频提醒。
  7. 点击 测试打印。几秒钟内应打印出示例收据。

预期结果： 测试收据成功打印。如果没有打印，请验证 IP、端口，并确保打印机与服务器在同一局域网中。

步骤 8：安排桌位并进行测试订单

  1. 打开 餐饮 > 桌子（或使用平面图操作菜单）。
  2. 选择一张桌子并点击 安排顾客（也标记为 "打开桌子"）。
  3. 记下显示的 6 位安全码。写下来或保持对话框打开。
  4. 在手机上，导航到 handy.cafe/{slug}/{table-code}。如果您有打印的贴纸，也可以扫描二维码。
  5. 输入 6 位代码。
  6. 浏览菜单并将商品添加到购物车。
  7. 继续结账。选择 现金 作为支付方式（Stripe 设置是可选的，可以稍后添加）。
  8. 提交订单。
  9. 在服务器上，切换到 餐饮 > 订单。

预期结果： 在 3 秒内，新的订单卡片出现在订单仪表板上。桌面通知触发。如果启用了声音通知，会播放音频提醒。订单标签上的待处理计数徽章增加。

步骤 9：推进并结算测试订单

  1. 在订单卡片上，点击下一个状态按钮。订单从 已下单 移动到 已确认。
  2. 继续点击以推进到 准备中、已准备 和 已上桌。
  3. 在桌子页面，打开同一张桌子并点击 结算账单。
  4. 选择 现金 作为支付方式并确认。

预期结果： 桌子返回到 空闲 状态。安全码过期。创建结算记录，可以稍后审核。

常见错误避免

  • 跳过业务资料。 如果您在保存资料前启动，客户会看到默认显示名称和一个破损的 logo 区域。
  • 在更改 slug 后未重新打印二维码。 更改 slug 会使所有现有二维码失效。打印新的贴纸并替换每张桌子上的。
  • 在启动时发布太多类别。 目标是 6 到 10 个顶级类别。菜单适合屏幕时，客户浏览更快。
  • 在第一次真正的班次前忘记配置打印机。 如果没有新订单自动打印，员工可能会在繁忙时段错过订单。至少运行一次测试打印。
  • 在没有动态历史的情况下启用默认的在菜单上显示准备时间。 在前 30 天，客户看到的是静态值。设置现实的静态时间或禁用芯片，直到动态估算经过训练。
  • 使用同一设备进行员工和客户测试。 客户会话持续 24 小时；如果您的测试设备后来交给客户，他们会在没有验证的情况下直接进入菜单。清除设备或使用干净的浏览器配置文件进行测试。