2026-08-27 消费页餐盘扫码状态面板变更记录
目标
在消费页直接显示餐盘码扫码功能状态、扫码结果和 selectPlate 接口请求结果,不改变既有接口或业务流程。
实际改动
- 在左上角读卡器状态下方增加“餐盘扫码器、扫码结果、接口结果”三行面板。
- 黄色表示初始化、等待或请求中;绿色表示硬件可用、扫码成功或查询成功;红色表示硬件/扫码/接口失败或无绑定人员。
- 成功时只展示姓名和 UUID 中可用的信息,错误摘要限制为 80 个字符。
- 所有视图更新集中切换到主线程;保留二维码扫码、后台同步、查询去重及迟到回调隔离。
验证证据
- Corretto JDK 8 执行完整单元测试和 Debug 构建:
BUILD SUCCESSFUL。 - 37 个测试,0 failure,0 error。
git diff --check 和尾随空白扫描通过。- APK:
app/build/outputs/apk/debug/app-debug.apk,约 61 MB。
设备验收边界
实体屏幕布局、串口打开、放盘/移盘事件和真实接口返回待样机与现场服务验证;软件构建成功不等于硬件兼容结论。
评审清单
- 三行状态是否足够醒目。
- 文案长度、换行、位置和字号是否合适。
- 黄、绿、红能否清晰对应处理中、成功、失败。
经验与反模式
已接受经验:分开显示硬件、输入和接口阶段,方便现场定位故障。
拒绝的反模式:仅写日志或只用短暂 Toast,导致当前状态不可持续查看。
人工评审状态
待用户查看实际页面效果后决定是否调整尺寸与文案。
Git 边界
未执行任何 Git 写操作,工作区既有改动保持原样。