非一卡通卡移卡恢复变更记录

变更日期：2026-09-20

问题与目标

身份证等非一卡通卡返回不兼容的一卡通逻辑响应时，旧实现归类为 PROTOCOL_ERROR 并停止寻卡。本次统一为可恢复的非一卡通状态：不进入读卡或扣款，提示“请移走非一卡通卡”，移卡后自动恢复寻卡。

实现内容

激活和寻卡阶段的不兼容逻辑响应统一归类为 UNSUPPORTED_CARD；真实 USB/HID、超时和 CRC 故障分类不变。
寻卡管理器不启动交易门禁，只进入等待移卡并持续轮询。
状态机连续 3 次确认无卡后，从 WAITING_FOR_REMOVAL 恢复到 WAITING_FOR_CARD。
页面显示“请移走非一卡通卡”，恢复寻卡时自动清除提示。
用户文案使用字符串资源，业务代码不硬编码。
README 同步非一卡通不启动交易、移卡后恢复寻卡的业务边界。

TDD 记录

先增加协议分类与移卡恢复测试。旧实现按预期失败：缺少非一卡通状态事件，且返回 PROTOCOL_ERROR；实现后新增测试转绿。

验证结果

NewcapecProtocolFindCardTest：3 项通过。
CardSearchStateMachineTest：5 项通过。
消费流程、订单协调、交易门禁、UI 映射及初始化重试相关回归测试通过。
:app:assembleDebug 成功；git diff --check 通过。
APK 大小：66,799,720 字节；SHA-256：5579831136dd2f7b3cf761f6adb02b5f69992eb7aaddc9c1b9ab27711419f914

现场验收项

身份证、门禁卡、银行卡及其他非一卡通卡均显示“请移走非一卡通卡”，不启动扣款、不停止读卡器。
非一卡通卡停留期间提示稳定，移走后自动恢复“请放卡片”，随后一卡通可正常结算。
USB 断开、通信超时、CRC 错误等真实硬件异常仍进入原故障流程。

Git 边界

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