Consumption Reader Startup Gate Implementation Plan

执行要求：使用 executing-plans 按任务实施。仓库 Git 操作限制为只读，因此不包含暂存或提交步骤。

目标：一卡通 USB 读卡器完成协议初始化前，不得进入或运行消费业务。

架构：ConsumptionStartActivity 通过专用启动控制器发现设备、申请权限并初始化协议，成功后才启动 ConsumptionActivity。纯状态门禁负责可测试的弹框、等待和退出决策；所有消费入口统一经过启动页。消费页自身仅在读卡器进入寻卡状态后启动餐盘识别，并在可用性丢失时立即关闭餐盘入口。

技术栈：Android Java、USB Host API、NewcapecUsbCardReader、SingleTipPop、JUnit 4、JDK 8 Gradle。

任务 1：纯启动门禁状态机

• 创建 ConsumptionReaderStartupGate.java 和 ConsumptionReaderStartupGateTest.java。
• 状态包含 CHECKING、DEVICE_MISSING、WAITING_FOR_DEVICE、CONNECTING、READY、FAILED、EXIT_REQUESTED。
• 先写失败测试，证明设备缺失时禁止进入并请求弹框；确认后只等待；取消后请求退出；仅协议连接成功可进入。

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest --tests '*ConsumptionReaderStartupGateTest'

任务 2：生命周期安全的启动控制器

• 创建 ConsumptionReaderStartupController.java，复用 NewcapecUsbCardReader。
• 负责唯一权限 Action、USB 接入/拔出广播、设备发现、权限申请、后台串行连接、协议初始化和资源释放。
• 无设备时不轮询，保持接入广播；权限与 I/O 回调携带递增会话号，丢弃过期结果。
• 连接成功后先在串行线程释放启动连接，再回调 onReady()，保证消费页能够干净接管。
• 补充 ReaderDeviceStateTest，确认物理设备消失时旧连接不能被视为可用。

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:compileDebugJavaWithJavac

任务 3：启动页门禁与弹框

• 修改 ConsumptionStartActivity.java 和 strings.xml。
• 配置合法后启动补传调度和读卡器门禁，不再直接进入消费页。
• 未检测到时提示“未检测到一卡通读卡器，请连接读卡器”。确认后停留并等待 USB 接入；取消后关闭控制器并调用 finishAffinity()。
• 权限或初始化失败保持门禁关闭，确认重试、取消退出；所有文本进入资源文件。
• 用 enteringConsumption 防止重复导航；销毁时关闭控制器和弹框。

任务 4：统一消费入口

• 创建可测试的 FunctionSelectionRouter.java 与 FunctionSelectionRouterTest.java。
• FunctionSelectActivity 的消费入口改为 ConsumptionStartActivity。
• 回归 ModeTargetResolverTest 与 SettingReturnRouterTest，确保固定模式、功能选择和设置返回均经过门禁。

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest --tests '*FunctionSelectionRouterTest' --tests '*ModeTargetResolverTest' --tests '*SettingReturnRouterTest'

任务 5：运行期撤销餐盘及新业务资格

• 修改 ConsumptionActivity.java、ReaderInitializationRetryGate.java 和对应测试。
• onStart() 只启动一卡通管理器；只有 onSearching() 可以打开餐盘识别。
• 设备未发现、权限拒绝、断开和连接类错误立即关闭餐盘识别并拒绝新订单。
• 确认后等待接入或重试连接；取消后安全停止未使用硬件并退出应用。
• 在途扣款不强制中断，但结果收敛和读卡器恢复前不能开始新业务。

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest --tests '*ReaderInitializationRetryGateTest' --tests '*ConsumptionFlowStateMachineTest' --tests '*ConsumptionTransactionGateTest'

任务 6：文档和完整验证

• 检查改动范围、避免硬编码、补齐职责及生命周期注释，并执行 git diff --check。
• 新建同名 Markdown/HTML 变更记录，记录 RED/GREEN、全量测试、APK 和现场验证边界。
• 全量测试若仍只有三个既有 CustomerFullFetchServiceTest 分页预期失败，单独记录，不声称全绿。
• 构建 Debug APK 并记录路径、大小和 SHA-256。

JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:testDebugUnitTest --rerun-tasks
JAVA_HOME=$(/usr/libexec/java_home -v 1.8) bash gradlew :app:assembleDebug
shasum -a 256 app/build/outputs/apk/debug/app-debug.apk

现场验收边界

需要真机验证 USB 接入、授权、协议初始化、设置返回时重新校验、取消退出，以及消费运行期间拔出读卡器后的业务阻断。