消费模式一卡通读卡器启动门禁变更记录

变更日期：2026-09-15

变更目标

一卡通读卡器完成 USB 权限和协议初始化后才允许进入消费业务。未就绪时不进入消费页、不识别餐盘、不查询订单，也不读卡或扣款。

实现内容

• ConsumptionStartActivity 增加读卡器前置门禁。
• 新增 ConsumptionReaderStartupController，管理发现、权限、USB 广播、协议初始化、过期回调和连接交接。
• 新增 ConsumptionReaderStartupGate，只有协议初始化成功才开放入口。
• 未检测到时确认后等待 USB 接入，取消后用 finishAffinity() 退出应用。
• 权限拒绝或初始化失败时确认重试、取消退出。
• 固定模式、手动功能选择和设置返回均经过启动页。
• 消费页只在一卡通进入寻卡状态后打开餐盘读码器；设备缺失、权限拒绝、断开或连接异常会立即关闭餐盘入口，并拦截已投递的旧餐盘回调。
• 在途扣款不被强制并发中断，结果收敛前不启动新业务。
• 提示文本、职责注释、README 已同步。

TDD 记录

• 启动门禁、功能入口路由和强制不可用恢复均先出现预期编译/断言失败，再由最小实现转绿。

验证结果

定向测试

42 项全部通过，0 失败。覆盖启动门禁、恢复门禁、设备状态、三类入口路由、消费流程和交易门禁。

全量测试

247 项中 244 项通过、3 项失败。失败仍是既有 CustomerFullFetchServiceTest 第 32、49、89 行的分页大小旧预期；生产实现为 2000，测试仍按 1000 断言，本次未修改该服务。

构建

• :app:assembleDebug 成功。
• APK 大小：66,844,437 字节。
• SHA-256：48dadb3110ed1e41bb8bcffe73175d9b798622deae06c1e533668dba86f67df0
• git diff --check 通过。

现场验收边界

1. 冷启动缺少读卡器时的弹框、等待和退出。
2. 等待中插入设备后的授权、初始化和自动进入。
3. 设置期间拔出，返回时重新门禁。
4. 权限拒绝和初始化失败重试。
5. 运行期拔出后停止餐盘识别。
6. 在途扣款时断开的结果收敛。

Git 边界

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