# 待使用页面操作说明

## 页面信息

- 页面名称：待使用
- 路由：`/pages/pending-use/pending-use`
- 源码：`pages/pending-use/pending-use.uvue`
- 入口：使用记录中的“待核销”记录。
- 当前状态：设计图视觉、核销码展示、商家联系、订单信息及退款申请交互已完成，真实订单、动态核销码和退款接口待接入。

## 功能点

| 功能 | 当前实现 | 后续接口目标 |
| --- | --- | --- |
| 核销二维码 | 展示演示二维码、核销数字码和出示提示。 | 后台返回短时效动态码、过期时间及刷新策略，禁止使用长期固定核销码。 |
| 商品摘要 | 展示商品图片、名称、原价和实付金额。 | 使用下单时的商品快照。 |
| 商家信息 | 展示商家名称和攀枝花市东区演示地址。 | 使用订单中的商家快照、联系电话及经纬度。 |
| 导航 | 调用 `uni.openLocation` 打开外部导航选择。 | 使用后台返回的经纬度。 |
| 电话 | 调用 `uni.makePhoneCall` 联系商家。 | 使用后台返回的联系电话。 |
| 订单信息 | 展示订单号、金额构成、下单时间和核销时间。 | 所有金额与状态均以后端订单详情为准。 |
| 申请退款 | 点击后先弹出确认框，确认后展示提交成功反馈。 | 校验退款资格、提交退款申请并返回退款单状态。 |

## 操作说明

1. 用户从使用记录点击“待核销”记录进入待使用页面。
2. 向商家出示二维码或数字码完成核销。
3. 可点击导航或电话获取商家服务。
4. 核对商品和订单金额信息。
5. 如订单允许退款，点击“申请退款”并二次确认。

## 异常处理

| 场景 | 页面处理要求 |
| --- | --- |
| 核销码加载失败 | 展示重新加载入口，不显示无效或过期码。 |
| 核销码过期 | 自动刷新短时效核销码；刷新失败时隐藏旧码并提示重试。 |
| 订单已核销 | 刷新为已完成状态，不再提供退款入口。 |
| 订单已退款/退款中 | 展示真实退款状态，禁止重复提交。 |
| 不满足退款条件 | 明确展示后台返回的不可退款原因。 |
| 地图或电话调用失败 | 展示明确失败提示，不影响核销主流程。 |

## 数据安全约定

- 核销码必须由后台按用户、订单和有效期生成，客户端不得自行构造。
- 页面隐藏或退出后应停止刷新核销码，重新进入时获取最新状态。
- 退款提交必须携带订单号、退款原因和幂等信息，最终结果以后端退款单状态为准。