餐饮服务

餐饮服务是HandyCafe中的集成餐饮服务模块。它允许您构建桌位的数字平面图，在handy.cafe/{your-slug}上发布品牌自助菜单，并从服务器控制台实时跟踪每个传入订单。

顾客扫描桌上的二维码，输入6位安全码，浏览自己语言的菜单并下单。订单会在几秒钟内出现在您的餐饮服务订单屏幕上。您的员工确认每个准备阶段，服务完成后，通过“结账”操作一步关闭账单。

适用对象

餐饮服务专为在顾客座位提供餐饮服务的网吧、游戏中心和电竞场馆设计。它取代了纸质订单单和口头请求。它与标准的HandyCafe会话和定价系统协同工作；餐饮订单单独跟踪，但在同一网吧许可证上。

核心功能

餐饮服务在服务器UI中的位置

餐饮服务有两个入口点：

1. 侧边栏中的餐饮服务部分。 这是日常使用的操作工作区。它包含五个标签：桌位、平面图、菜单、订单和日程安排。订单标签在有新订单等待时显示待处理徽章。
2. 设置 > 餐饮服务。 这是配置区域。它包含业务资料（slug、显示名称、logo、头部图像、地址、货币、时区）、打印机设置、楼层管理和可选功能开关。

配置网吧

首次启用餐饮服务时，服务器会自动使用您的HandyCafe许可证作为授权令牌。您无需手动粘贴任何内容。配置向导会询问四项信息：

1. Slug。 这将成为handy.cafe/{slug}的公共URL。允许的字符为小写字母、数字和短划线。slug长度为3到62个字符。系统实时检查可用性，并拒绝保留的slug，如“admin”、“api”或“dashboard”。
2. 显示名称。 在客户菜单顶部显示的人性化名称。
3. 国家和货币。 菜单价格的默认货币。价格以小单位存储（例如分）并以配置的货币符号显示。
4. 时区。 用于动态准备时间计算、订单时间戳和结算记录。

配置完成后，网吧会在云数据库中创建，餐饮服务工作区会打开。您可以添加楼层、桌位和菜单项。

业务资料

业务资料可随时在设置 > 餐饮服务下编辑。关键字段：

打印机设置

打印机部分接受以下配置：

• 类型。 可选禁用或TCP。本版本不支持USB直接打印。
• IP和端口。 您的收据打印机的网络地址。大多数ESC POS TCP打印机监听9100端口。
• 自动切纸。 在每张打印的收据后添加切纸命令。
• 新订单自动打印。 开启时，每个传入订单会自动触发收据打印。
• 声音通知。 在新订单到达时，除了桌面通知外，还播放音频提醒。
• 测试打印。 向配置的打印机发送样本收据以验证连接。

架构概述

餐饮服务使用云优先数据模型。每个桌位、类别、产品、订单和结算记录都存储在handy.cafe云数据库中。您的本地HandyCafe服务器镜像此状态，并每3秒轮询订单端点以获取新活动。客户页面由handy.cafe云直接提供；它们不需要您的服务器可从互联网访问。

由于数据存储在云中：

• 即使服务器离线，二维码仍然有效，但员工无法在控制台上看到订单，直到连接恢复。
• 菜单更改在保存后几秒钟内推送到handy.cafe。
• 顾客下的订单在下一个3秒轮询后到达订单控制台。

下一步

• 平面图和桌位：构建场地的空间布局并配置每个桌位。
• 菜单管理：创建类别、产品和变体。
• 订单：传入订单的实时控制台。
• 客户菜单：顾客扫描桌上二维码时看到的内容。
• 设置餐饮服务：端到端设置指南。