智慧食堂消费终端系统

一、概述

智慧食堂消费终端系统用于食堂档口、餐饮窗口和团餐现场的快速消费结算。系统围绕消费终端的高频操作，将菜单消费、定额消费、自定义金额消费、刷卡支付、扫码支付、人脸支付、订餐核销、出餐处理、订单查询、人员人脸数据管理和基础参数配置集中在同一软件中完成。

本说明书面向现场操作人员、食堂管理人员和设备运维人员，重点说明日常业务怎么操作、首次上线需要配置什么、异常情况如何处理。

二、主要功能与界面对应说明

1. 首页功能入口

首页为消费终端主入口，集中展示菜单消费、定额消费、自定义消费和订单管理等业务卡片，并提供余额查询、出餐、订餐核销、人脸消费等快捷入口。页面顶部显示系统名称、网络状态、日期时间等信息，便于现场人员确认终端运行状态。

点击首页设置图标可进入系统设置；设置页退出时会校验基础配置和支付方式，未完成关键配置时不能返回业务首页。

2. 菜单消费

菜单消费用于按菜品明细进行收款。操作人员进入“菜单消费”后，系统加载菜品列表，点击菜品加入购物车；也可以通过“新增商品”录入临时金额作为自定义菜品。核对购物车数量和合计金额后，点击“快速支付”进入收款流程。

若开启菜名播报，点击菜品时设备会播报菜名；若启用营养展示，支付成功弹框可展示餐盘营养相关信息。

3. 定额消费

定额消费用于固定金额收款场景。操作人员进入“定额消费”后输入或确认固定消费金额，再选择刷卡、扫码或人脸方式完成支付。不同设备类型会自动使用带键盘或无键盘界面。

4. 自定义消费

自定义消费用于临时金额、补录金额或无菜品明细的快速收款。操作人员输入应收金额，系统校验金额后进入支付流程，并生成对应消费订单记录。

5. 支付方式

系统支持刷卡支付、扫码支付和人脸支付。支付设置中可多选启用支付方式；只启用一种方式时系统直接进入该支付方式，启用多种方式时会弹出支付方式选择界面。

刷卡支付会读取卡号并查询本地人员；扫码支付会读取付款码或订单码；人脸支付会打开摄像头识别人员，识别成功后由操作人员确认支付或核销。

6. 余额查询

余额查询用于现场快速查询人员账户余额。进入“余额查询”后刷卡，系统按卡号向服务端查询并展示卡号、部门、姓名、现金余额、补贴余额等信息。若未开启刷卡支付或网络不可用，页面会提示对应异常。

7. 出餐处理

出餐页面用于将订单从备餐状态推进到待取餐状态。操作人员可扫描订单码，也可手动输入订单号后点击确认。出餐成功后系统展示订单号和叫号次数；失败时展示服务端返回的失败原因。

8. 订餐核销

订餐核销页面用于核销已有订餐订单，也支持现场生成消费订单并扣款。操作人员可扫描订单二维码、手动输入订单号，或点击人脸识别进行核销。二维码扫码在页面打开后即处于可用状态，点击二维码图标主要用于提示“请扫描订单二维码”。

人脸核销会复用系统人脸识别弹框，确认按钮显示为“去核销”，不会影响其他消费页面的“去支付”文案。

9. 人脸消费

人脸消费用于顾客直接刷脸完成消费。启用该功能前必须保证设备有摄像头、人脸识别 SDK 已激活、人员和人脸数据已同步，并在支付设置中开启人脸支付。

10. 订单管理

订单管理用于查询消费订单和营业概况。页面默认显示今日订单，可按日期筛选，查看订单笔数、订单总额以及订单编号、消费人、消费时间、订单金额、实付金额、支付方式、订单来源等明细。首页卡片当前进入在线订单管理；本地订单用于离线留存和补偿上传。

11. 人员与人脸管理

人员与人脸数据由系统启动、定时任务或 MQTT 推送进行同步。进入“人员管理”或基础设置中的“查看人脸”，可查看本机已落地的人脸人员列表和头像。

12. 系统设置

系统设置分为基础设置、设备管理、支付设置三类。基础设置维护 API 地址、配对码、设备编号、人脸激活码、人脸识别超时时间、订单保存时长、语音开关、菜名播报、营养展示和版本更新；设备管理提供刷卡测试；支付设置维护支付方式和支付结果弹框显示时长。

三、首次使用与基础配置

首次安装或重新配对设备时，按以下顺序完成配置：

1. 进入系统设置，打开“基础设置”。
2. 填写 API 地址。API 地址切换后，当前数据可能被清空，切换前应确认现场允许重新同步。
3. 填写配对码，系统获取并保存设备编号、餐厅信息、接口鉴权和 MQTT 等配置信息。
4. 如需使用人脸支付或人脸核销，填写人脸识别激活码。
5. 设置人脸识别超时时间，可按现场识别效率选择 5 秒或 10 秒。
6. 设置订单保存时长，可选择 0 天、7 天或 30 天。
7. 按需要开启语音提示、菜名播报和营养展示。
8. 进入“支付设置”，至少开启刷卡、扫码、人脸中的一种支付方式。
9. 返回首页。若配置不完整，系统会提示需要补齐的项目。

四、日常业务操作流程

1. 菜单消费收款

1. 在首页点击“菜单消费”。
2. 等待菜品列表加载完成，选择顾客购买的菜品。
3. 在购物车核对菜品、数量和合计金额；如需临时金额，点击新增商品并录入金额。
4. 点击“快速支付”。
5. 按现场配置选择刷卡、扫码或人脸支付。
6. 支付成功后确认成功弹框，系统自动保存订单；支付失败时按提示重新支付或更换支付方式。

2. 定额消费收款

1. 在首页点击“定额消费”。
2. 输入或确认本次固定消费金额。
3. 选择支付方式并完成支付。
4. 查看支付结果，成功后可继续下一笔。

3. 自定义消费收款

1. 在首页点击“自定义消费”。
2. 输入实际应收金额。
3. 确认金额无误后进入支付。
4. 完成刷卡、扫码或人脸支付。

4. 出餐操作

1. 在首页点击出餐入口。
2. 扫描订单码，或手动输入订单号后点击确认。
3. 等待系统返回出餐结果。成功时展示订单号和叫号次数；失败时根据提示核对订单状态或网络。

5. 订餐核销操作

1. 在首页点击“订餐核销”。
2. 使用扫码设备扫描订单二维码，或在输入框录入订单号后确认。
3. 如需按人员核销，点击人脸识别图标，对准摄像头完成识别后点击“去核销”。
4. 核销成功后查看消费人、订单金额、实付金额和余额；失败时按提示处理。

6. 余额查询操作

1. 在首页点击“余额查询”。
2. 提示现场顾客刷卡。
3. 查看系统展示的姓名、部门、现金余额和补贴余额。
4. 如提示未开启刷卡支付，需到支付设置开启刷卡支付后再查询。

五、订单查询与日终核对

订单管理页面默认查询当天订单，支持按日期选择历史订单。现场收银或管理人员可通过订单数、订单总额和订单明细进行日终核账。

订单列表支持分页加载。点击订单明细可查看该笔订单的菜品、金额、支付方式和人员信息。网络订单查询依赖服务端；本地订单主要用于离线场景下的留存和后续补偿上传。

六、人员、人脸与数据同步

系统启动时会检查配置并同步人员、人脸数据；后续可通过定时任务或 MQTT 推送更新。人员数据同步完成后，本地刷卡、人脸识别和消费支付才能正确关联顾客身份。

若人脸支付不可用，应依次确认：设备是否有摄像头、是否已填写人脸激活码、是否开启人脸支付、人员和人脸数据是否已同步、现场光线和摄像头角度是否满足识别要求。

七、系统设置说明

配置项说明

八、常见异常与处理方法

异常处理表

九、现场维护注意事项

保持终端网络稳定，网络异常会影响在线支付、订单查询、余额查询和人员同步。

更换 API 地址、重新配对或切换设备前，应确认是否需要保留本地订单和人员数据。

启用人脸支付前，应完成摄像头检查、人脸激活和人员人脸同步。

日终核账时优先使用订单管理中的订单数、订单总额和明细核对；若存在离线记账或补偿上传，应确认后台最终订单状态。

刷卡器、扫码器、摄像头等外设异常时，先使用设备管理或对应页面测试，再联系运维处理。