消费模式取盘取消结算变更记录

变更日期：2026-09-20

变更目标

获取订单后、真实刷卡交易开始前取走餐盘，取消本轮客户端结算并恢复等待放盘；读卡、扣款或反馈已经开始后不强制中断，等待真实结果收敛。

实现内容

• 状态机在订单查询和等待刷卡阶段移盘时返回取消结果并复位到 WAITING_TRAY，在读卡及后续阶段保留在途流程。
• 页面以读卡门禁的原子取消结果判断交易是否已经开始，消除“先查询、后取消”的竞态。
• 可取消时统一清理读卡门禁、订单会话、语音、弹框和页面上下文，立即恢复初始页。
• 订单协调器使迟到响应失效，并允许下一张餐盘创建新会话。
• 本地记录标记为 CANCELLED_TRAY_REMOVED 和 NOT_REQUIRED，不进入任一上传队列。
• 同一取消订单可安全重开；成功、处理中和结果未知记录仍不可覆盖；取消记录按保留策略清理。
• README 已同步业务边界。

TDD 记录

新测试在旧实现上出现 3 个预期失败：查询中和等待刷卡时取盘未复位、迟到订单响应仍被交付。实现后定向测试转绿；审查阶段又以同步门禁的原子取消结果收紧卡交易启动竞态。

验证结果

本次受影响测试

状态机 13 项、订单协调器 6 项、交易门禁 6 项，共 25 项通过，0 失败。:app:assembleDebugAndroidTest 成功，新增 SQLite Android 测试已编译。

全量测试

254 项中 251 项通过、3 项失败。失败均在未修改的 CustomerFullFetchServiceTest：既有分页期望仍按 1000 条，实际实现按 2000 条；单独重跑仍失败，本次未扩大范围修改。

构建与静态检查

• :app:assembleDebug 成功。
• APK 大小：66,798,782 字节。
• SHA-256：0d4dde5e8f148b8a0f640ce80fbfba7473fe124f8547a5bd3babe858f9cee4b2
• git diff --check 通过。

设备验收边界

当前连接设备未安装应用，本次未擅自安装 APK 或运行连接设备测试。仍需现场验证取盘恢复、取盘与刷卡同时发生的竞态、迟到响应隔离、同订单重开以及硬件防抖。

Git 边界

仅执行只读 Git 检查；未暂存、提交、推送、拉取、切换分支、合并、重置或创建工作树。