2026-08-28 消费页面简化与持卡人余额展示变更记录

需求

保留“放置餐盘—确认订单—卡片结算”三步，省略订单成功过渡和用户不需要理解的内部交易阶段页面。刷卡后在第三步显示持卡人、补贴余额和现金余额，并使用与当前消费页色调一致的新操作配图。

代码实现

• 新增 ConsumptionUiStateMapper，把完整业务状态归并为等待放盘、确认订单、放卡/取卡、处理中、完成和异常展示状态；业务状态机、阶段日志和交易流程不变。
• 删除订单确认成功后的固定停留；有效订单返回后直接武装读卡并进入第三步。
• ConsumptionCardTransactionExecutor 在首次完整读卡成功后立即发布 CardInfo 快照，发生在零元返回或正金额扣款指令之前。
• ConsumptionCardSearchManager 只向当前有效会话转发快照，防止迟到回调污染下一单。
• ConsumptionActivity 根据 customerId 查询本地一卡通人员库 NAME，显示持卡人、补贴余额和现金余额；查询缺失或异常降级为“持卡人信息未同步”，不阻断交易。
• 正金额完整成功后用真实 afterCard 更新为结算后余额；零元使用真实读卡余额；异常场景只显示最近一次真实读卡值，不伪造结算后余额。
• 新会话开始和统一复位时清空卡片姓名与余额，避免上一位用户信息残留。
• 正常读卡器连接状态退出主视觉区，只在读卡器异常阻断操作时显示。

页面与资源

• 第二步只显示“正在确认订单 / 请稍候”，成功后直接进入第三步。
• 第三步正金额只显示“请放卡片—结算处理中—结算完成”，零元只显示“请放卡核验—卡片核验中—核验完成”。
• 卡片信息区显示持卡人、补贴余额、现金余额及“读卡时余额/卡片余额/结算后余额”语义。
• 使用 imagegen 内置模式生成并落入 Android 项目的三张 1024×576、实际 Alpha 透明 PNG：
  • consumption_illustration_place_tray.png
  • consumption_illustration_place_card.png
  • consumption_illustration_remove_card.png
• 消费主流程不再引用旧 icon_swipe_card、icon_bind_success 或 icon_home_bind_fail。

新增文件

• app/src/main/java/com/zhct/traybinding/consumption/ConsumptionUiStateMapper.java
• app/src/test/java/com/zhct/traybinding/consumption/ConsumptionUiStateMapperTest.java
• app/src/main/res/drawable/consumption_ui_card_info_panel.xml
• app/src/main/res/drawable-nodpi/consumption_illustration_place_tray.png
• app/src/main/res/drawable-nodpi/consumption_illustration_place_card.png
• app/src/main/res/drawable-nodpi/consumption_illustration_remove_card.png

轻量验证

• 定向测试：ConsumptionUiStateMapperTest、ConsumptionCardTransactionExecutorTest 通过。
• Debug 编译：:app:assembleDebug，结果 BUILD SUCCESSFUL in 54s。
• XML：相关布局、字符串、尺寸、颜色、样式和卡片信息背景通过 xmllint --noout。
• 静态检查：相关代码、资源和测试通过 git diff --check。
• 按用户要求未运行全量回归、真机自动化或截图对比，最终视觉与现场交互由用户真机验收。

回滚方式

变更前源文件快照：

artifacts/rollback/2026-08-28-consumption-ui-before-change.tar.gz

SHA-256：

1bcc13616f874ffde492ef57608c5dadd16f72c52073416d42a2cee145b90cfa

若验收不通过：

1. 从快照恢复其中已有源文件。
2. 删除本记录“新增文件”中列出的 6 个源代码、测试及资源文件。
3. 不回退此前零元单读卡、接口 C、日志或其他用户已有改动。
4. 不使用 git reset、git checkout、git stash 或历史改写。

Git 边界

本次只修改代码、资源、测试和文档，不执行暂存、提交、推送、拉取、分支切换或历史改写。