消费三步页面简化与卡片信息展示设计

版本：V1.0
日期：2026-08-28
适用模块：ConsumptionActivity

1. 目标

保留“放置餐盘—确认订单—卡片结算”三步业务结构，隐藏前读卡、扣款、后读卡、结果反馈等用户无需理解的内部阶段。页面始终只表达当前操作、必要保护提示和最终结果；首次完整读卡后，在第三步原页面展示持卡人、补贴余额和现金余额。

2. 不变边界

• 零元订单仍需真实读卡一次，不执行扣款，携卡信息反馈接口 C。
• 正金额订单仍按前读卡、补贴优先扣款、后读卡、接口 C 的顺序执行。
• 本地交易记录、日志、请求先落库、上传失败补传、防重复扣款和统一复位规则不变。
• 业务状态机保留全部内部状态；本次只增加独立展示状态映射，不删除业务阶段。

3. 用户页面流程

第三步正常状态只保留：

1. 等待操作：正金额显示请放卡片，零元显示请放卡核验；读卡区有遗留卡时显示请先取走卡片。
2. 卡片处理中：正金额统一显示结算处理中 / 请勿移动卡片；零元统一显示卡片核验中 / 请勿移动卡片。
3. 处理完成：正金额显示结算完成，零元显示核验完成，统一提示请取走卡片和餐盘。

REPORTING、COMPLETED、REPORT_PENDING 映射为同一个完成展示。接口反馈和后台补传继续执行，但不再形成用户可见的中间页面。

4. 卡片信息区

首次完整前读卡成功后显示：

• 姓名通过卡片 customerId 查询本地一卡通人员库的 NAME 字段。
• 姓名缺失或查询失败时显示持卡人信息未同步，不阻断交易。
• 首次读卡显示读卡时余额；正金额完整成功后使用真实后读卡结果更新为结算后余额。
• 零元订单始终显示真实读卡余额，不计算或伪造结算后余额。
• 扣款结果不确定或后读卡失败时，保留最后一次已确认的读卡值，但不得标记为结算后余额。
• 新餐盘会话开始和统一复位时立即清空姓名及余额，禁止串显上一位用户信息。
• 姓名仅用于当前页面，不新增普通业务日志字段。

5. 展示状态映射

只有展示状态、卡片信息或必要提示发生变化时才刷新页面。业务日志仍按原状态记录。

6. 配图规范

只新增三张透明背景操作图：放置餐盘、放置卡片、取走卡片。统一使用深蓝、青蓝和白色，保持相同视角、线条、光影与画布比例，不包含文字，不出现大面积纯白设备底图。

• 放盘页使用放置餐盘图。
• 等待放卡和卡片处理中复用放置卡片图，避免阶段切换时闪图。
• 读卡区遗留卡、完成和需要清场的异常状态使用取走卡片图。
• 不再使用 icon_swipe_card、绑定成功图和绑定失败图作为消费主流程配图。

7. 异常展示

技术错误码、接口原文和内部阶段只进入现有日志与诊断记录。

8. 回滚设计

实施前快照保存于 artifacts/rollback/2026-08-28-consumption-ui-before-change.tar.gz，SHA-256 为 1bcc13616f874ffde492ef57608c5dadd16f72c52073416d42a2cee145b90cfa。若现场验收不通过，只还原快照中已有文件，并移除本次新增的展示映射、测试和配图文件，不回退此前零元单及日志改动。

9. 验收标准

1. 三步名称和业务顺序不变。
2. 查单成功后直接进入第三步，不显示订单成功过渡页。
3. 正金额正常流程只显示“放卡—处理中—完成”；零元流程只显示“放卡核验—核验中—核验完成”。
4. 首次完整读卡后立即显示持卡人、补贴余额和现金余额。
5. 正金额成功后余额更新为真实后读卡余额；异常时不把扣款前数据误称为结算后余额。
6. 页面不使用原有风格不一致的支付、绑定成功和绑定失败图片。
7. 下一轮开始前上一位用户的姓名、余额和卡片快照均已清空。
8. 零元读卡、正金额扣款、接口反馈、落库补传和防重业务逻辑保持不变。