使用记录页面操作说明

页面信息

  • 页面名称:使用记录
  • 路由:/pages/order/order
  • 源码:pages/order/order.uvue
  • 入口:个人中心“使用记录”、支付成功页“查看使用记录”。
  • 当前状态:设计图视觉、状态筛选、分页演示、空状态和失败重试已完成,真实使用记录接口待接入。

功能点

功能 当前实现 后续接口目标
顶部导航 自定义返回导航,按微信胶囊位置适配;正常页面栈返回上一页,结果页重置页面栈后进入时安全返回个人中心。 保持当前实现,禁止在页面栈首个页面直接调用 navigateBack。
状态筛选 支持全部、待支付、待核销、已取消、待处理、已领取;待支付位于全部之后。已完成记录保留在“全部”中查看,不单独提供顶部筛选。 后台返回统一状态枚举与数量。
独立待支付状态 待支付记录使用独立筛选,不再归入待处理。 后台按 pending_payment 状态独立查询。
使用记录列表 卡片标题展示商家或服务机构名称,不再使用“餐饮服务”“酒店消费”等业务类型作为标题;同时展示发生时间、当前状态和金额。 按用户和状态分页查询真实记录,返回稳定的商家快照名称。
类型图标 根据 merchantType 显示餐饮、酒店、影院/剧院、医院、景区、停车、加油、洗车、购物或综合服务图标,未知类型使用综合服务图标兜底。 后台返回统一商家类型枚举,前端维护枚举与本地图标的映射,不直接信任任意图标路径。
分页加载 全部状态首批展示 8 条,触底继续追加,包含首屏/下一页失败重试、加载和到底状态;切换状态会清理旧错误。 接入后台页码或游标分页。
空状态 当前状态无记录时展示“暂无相关使用记录”。 可返回其他筛选状态查看。
记录详情 待支付、待核销、已完成、已取消、待处理记录进入对应状态详情页;已领取电影券进入领券成功/兑换凭证页面。 后续按记录业务类型进入对应订单或权益详情。

操作说明

  1. 用户从个人中心或支付成功页进入使用记录。
  2. 页面默认展示全部记录;支付成功页可直接定位到“待核销”。
  3. 点击顶部标签切换记录状态。
  4. 上滑列表触发下一页加载,加载完成后增量追加。
  5. 点击“待支付”记录进入待支付订单详情;点击“待核销”记录进入待使用详情并出示核销码。
  6. 切换“已领取”后,点击万达影城普通厅兑换券进入领券成功页并查看、复制兑换码。
  7. 当前分类没有数据时展示空状态。
  8. 从支付、酒店预约、体检预约或申请提交结果页进入时,结果流程会被关闭;使用记录左上角返回个人中心,不再返回已完成页面。

接口预留

  • 使用记录列表字段:记录 ID、订单/申请 ID、商家 ID、merchantName 商家快照名称、merchantType 商家类型、detailName 商品/券/服务详情名称、发生时间、状态、金额和目标详情类型;列表使用 merchantName,进入详情后使用 detailName。
  • merchantType 预留枚举:food、hotel、cinema、theatre、medical、scenic、parking、fuel、carWash、shopping、service;未知值按 service 展示。

状态约定

pending_payment      -> 待支付
pending_verification -> 待核销
completed            -> 已完成
cancelled            -> 已取消
processing           -> 待处理
received             -> 已领取

异常处理

场景 页面处理要求
首次加载失败 展示加载失败和重试入口,不显示错误缓存为最新记录。
下一页加载失败 保留已有记录,在列表底部提供重试。
状态为空 展示空状态并允许切换其他状态。
记录已失效 明确展示失效状态,不继续提供核销入口。
登录失效 恢复登录后返回本页并保留当前筛选状态。
页面栈没有上一页 不调用 navigateBack,通过 reLaunch 返回个人中心,避免 cannot navigate back at first page。