消费页餐盘扫码状态面板设计
目标
在消费页左上角持续显示餐盘码扫描链路的三类信息:扫码器功能状态、最近一次扫码结果、selectPlate 接口请求结果。
来源与证据
- 用户要求三类状态全部在页面显示。
- 当前页面已经打开餐盘码扫描器,并在放盘后调用既有
POST /p/api/selectPlate。 - 代码现状已确认;实体设备显示和真实扫码链路待样机验证。
方案
在读卡器状态条下方增加白色三行面板。
- 餐盘扫码器:初始化或打开中黄色,已打开可用绿色,打开或扫码异常红色。
- 扫码结果:等待或移盘黄色,有效餐盘码绿色,无效结果红色。
- 接口结果:等待或请求中黄色,查询到人员绿色,接口失败或无绑定人员红色。
页面只展示必要的餐盘码、错误摘要和就餐人姓名/UUID,不展示完整人员对象、人脸特征或原始串口数据。
范围边界
- “扫码”仅指触发
selectPlate 的餐盘码扫描链路。 - 不改变人员二维码扫码器、接口契约、扣费流程或后台同步。
- 不执行 Git 写操作。
评审清单
- 三行状态信息是否齐全。
- 黄、绿、红是否与处理、成功、失败一致。
- 面板位置、字号和长文本是否适合实体屏幕。
人工评审状态
待用户查看实际页面效果;实体设备视觉、串口和真实接口返回待样机验证。