读卡器重新初始化提示触发范围修正记录

后续补充：用户确认重新初始化后发生的 PROTOCOL_ERROR，已由协议初始化失败再次提示变更记录纳入专用的“初始化失败”再次确认流程；普通读卡阶段的协议错误仍不提示连接异常。

• 日期：2026-09-13
• 项目：ZhctTrayBindingMachine

结论：重新初始化确认框已收窄为“读卡器成功初始化后的连接异常”专用提示；设备未找到、权限拒绝、首次初始化失败以及卡片或业务错误不再触发该确认框。

Compact Use Case

• Use Case ID / 状态 / DoR：UC-READER-REINIT-002 / Done / READY
• 角色、触发与目标：操作人员在读卡器已经成功初始化后遇到连接断开或连接链路故障时，可确认重新初始化；其他异常继续显示自身准确原因。
• In Scope / Out of Scope：修正重新初始化弹框的初始化状态门禁和错误分类；不修改弹框文案、重新初始化流程、读卡协议、消费规则和订单数据。
• 主流程：读卡器成功进入寻卡状态后记录“已初始化”；此后发生连接断开或连接类错误时，展示“读卡器连接异常，是否重新初始化？”。
• 非触发场景：设备未找到、USB 权限拒绝、首次初始化未成功、协议/卡片/业务错误均不展示重新初始化确认框，只保留原有具体错误提示。
• 连接类错误：OPEN_FAILED、INTERFACE_NOT_FOUND、ENDPOINT_NOT_FOUND、CLAIM_FAILED、NOT_CONNECTED、IO_WRITE_FAILED、DEVICE_RECOVERY_FAILED、IO_TIMEOUT。
• 边界或异常/恢复：只有成功进入寻卡状态才建立提示资格；连接中不误判为初始化成功；连续连接异常仍只显示一个弹框。
• 验收标准：初始化前的连接错误不弹框；初始化后的断开和连接类错误弹框；设备、权限、协议、卡状态等非连接错误不弹框；单元测试及 Debug 构建通过。
• 待确认项：现场需验证首次启动无设备、拒绝 USB 权限、初始化成功后拔线以及通信超时四类场景。

实现

• ReaderInitializationRetryGate 增加成功初始化状态，只在 onReaderInitialized() 后允许连接异常弹框。
• 错误码采用连接类白名单，避免将所有 onError() 回调统一解释为连接异常。
• ConsumptionActivity 移除设备未找到和权限拒绝回调中的重新初始化弹框调用。
• 只有 onDisconnected() 和白名单内的连接类 ReaderError 会申请展示确认框。
• onConnecting() 仅关闭过期提示，不再标记初始化成功；onSearching() 才标记初始化完成。

测试与验证

• TDD RED：先修改门禁测试，旧实现因缺少初始化状态与连接错误分类接口而编译失败。
• 定向测试：ReaderInitializationRetryGateTest 7 个测试通过，覆盖初始化前拦截、非连接错误拦截、断开提示、连接错误白名单、防重复确认、取消恢复和初始化成功状态。
• 完整单元测试：JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest --rerun-tasks，202 个测试，0 failure、0 error、0 skipped。
• Debug 构建：JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:assembleDebug，构建成功。
• APK：app/build/outputs/apk/debug/app-debug.apk，大小 67187505 字节，SHA-256 618eb8c3a23408efaa655fdde1a29e35a50125004479003268ddb596bc4f129e。
• 本次未安装 APK、未操作现场读卡器、未触发真实订单或扣款。

Git 边界

本次未执行暂存、提交、推送、拉取、分支切换或其他 Git 写操作。