# 使用记录页面操作说明

## 页面信息

- 页面名称：使用记录
- 路由：`/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` 展示。

## 状态约定

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

## 异常处理

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