98 lines
6.8 KiB
Markdown
98 lines
6.8 KiB
Markdown
## ADDED Requirements
|
||
|
||
### Requirement: 套餐历史展示沉默期
|
||
|
||
套餐历史中每笔套餐返回 `silence` 对象时,系统 SHALL 在该套餐卡片中展示沉默期信息:状态名称 `silence_status_name`、截止时间 `silence_deadline_at`、沉默期天数 `silence_period_days`、累计延期天数 `silence_extended_days`(大于 0 时)。`silence_adjust_pending = true` 时 SHALL 显示"调整审批中"。`silence` 为空或缺失时 MUST NOT 显示任何沉默期内容,其余展示保持不变。关联加油包节点同样按此规则处理。
|
||
|
||
#### Scenario: 待实名套餐
|
||
- **WHEN** 套餐历史中一笔套餐的 `silence.silence_status = waiting`,截止时间为 2026-12-05 23:59:59
|
||
- **THEN** 该套餐卡片显示"待实名"(或后端返回的"延期待实名")和截止日期 2026-12-05
|
||
|
||
#### Scenario: 总开关关闭
|
||
- **WHEN** 套餐历史返回的套餐都没有 `silence` 字段
|
||
- **THEN** 页面与改动前一致,不显示沉默期区域和延期入口
|
||
|
||
#### Scenario: 调整审批中
|
||
- **WHEN** 一笔套餐的 `silence.silence_adjust_pending = true`
|
||
- **THEN** 沉默期区域显示"调整审批中"
|
||
|
||
### Requirement: 延期入口
|
||
|
||
系统 SHALL 只在 `silence.extendable = true` 时在该套餐卡片显示"延期"入口;点击后进入该套餐的延期页面,并带上 `package_usage_id`。`extendable` 为 false 或缺失时 MUST NOT 显示入口。
|
||
|
||
#### Scenario: 已过期可延期
|
||
- **WHEN** 一笔套餐 `silence.silence_status = expired` 且 `extendable = true`
|
||
- **THEN** 卡片显示"延期"入口,点击进入延期页面
|
||
|
||
#### Scenario: 不可延期
|
||
- **WHEN** 一笔套餐 `silence.extendable = false`
|
||
- **THEN** 卡片不显示"延期"入口
|
||
|
||
### Requirement: 延期资格与试算
|
||
|
||
进入延期页面时,系统 SHALL 调用 `GET /api/c/v1/package-silence/eligibility?package_usage_id=` 获取资格。`can_extend = false` 时 SHALL 按 `reason` 展示不能办理的原因,MUST NOT 允许下单;`pending_order_no` 非空时 SHALL 提示已有未完成的延期订单,并提供进入该订单详情的入口。可以办理时 SHALL 展示当前截止日期、已过期天数、可选天数范围(`min_days`~`max_days`),并列出 `options` 中每档的计费天数、金额与新截止日期供选择;客户输入自定义天数时 SHALL 调用 `GET /quote` 试算并展示计费天数、金额与新截止日期。金额 MUST 以后端返回为准,前端只传天数、不自行计算金额。输入天数超出 `min_days`~`max_days` 时 MUST 在提交前提示并禁止下单。
|
||
|
||
#### Scenario: 选择档位
|
||
- **WHEN** 资格返回 `options` 含 30 天 / 60 天两档,客户选择 60 天
|
||
- **THEN** 页面显示 60 天档的金额(分换算为元)与新截止日期,可以下单
|
||
|
||
#### Scenario: 输入天数试算
|
||
- **WHEN** 客户输入 31 天
|
||
- **THEN** 页面调用试算接口,显示计费天数 60 天、对应金额与新截止日期
|
||
|
||
#### Scenario: 已有未完成订单
|
||
- **WHEN** 资格返回 `pending_order_no` 非空
|
||
- **THEN** 页面提示已有未完成的延期订单,不能新建,并可进入该订单详情
|
||
|
||
#### Scenario: 不能办理
|
||
- **WHEN** 资格返回 `can_extend = false`、`reason = not_expired`
|
||
- **THEN** 页面显示"套餐沉默期尚未过期,暂不需要延期",下单按钮不可用
|
||
|
||
### Requirement: 自助下单与支付
|
||
|
||
客户确认天数与支付方式后,系统 SHALL 调用 `POST /api/c/v1/package-silence/orders`,参数为 `package_usage_id`、`days`、`payment_method`、`request_id`。支付方式 MUST 只在 `wechat`、`alipay` 中,并取当前资产 `allowed_payment_methods` 的交集;交集为空时 SHALL 提示暂不支持在线延期。同一次提交的网络重试 MUST 复用同一个 `request_id`,客户重新确认(天数或支付方式变化)时 SHALL 生成新的 `request_id`。提交期间 MUST 防止重复点击。下单成功后 SHALL 用返回的 `qr_content` 拉起支付:支付宝走现有支付宝支付页(二维码 + 复制链接);微信按 design 中确定的方式处理。拉起支付后 SHALL 记录待刷新标记,客户返回时刷新订单状态。
|
||
|
||
#### Scenario: 支付宝下单
|
||
- **WHEN** 客户选择 30 天、支付宝支付并确认
|
||
- **THEN** 系统下单后进入支付宝支付页,展示 `qr_content` 二维码与复制链接
|
||
|
||
#### Scenario: 重复点击
|
||
- **WHEN** 客户在下单请求返回前再次点击确认
|
||
- **THEN** 系统不发起第二次下单请求
|
||
|
||
#### Scenario: 无可用支付方式
|
||
- **WHEN** 资产 `allowed_payment_methods` 只有 `wallet`
|
||
- **THEN** 延期页面提示暂不支持在线延期,不显示下单按钮
|
||
|
||
### Requirement: 支付结果与订单查看
|
||
|
||
系统 SHALL 提供"我的延期订单"列表(`GET /api/c/v1/package-silence/orders`,可按支付时间 `paid_start`、`paid_end` 筛选,分页加载)与详情(`GET /orders/:id`)。详情 SHALL 展示订单号、套餐、天数(输入天数与计费天数)、金额、状态名称、支付方式、下单前截止时间、预计新截止时间、支付时间、延期生效时间;状态为 `pending_payment` 且返回 `qr_content` 时 SHALL 提供"继续支付"。从支付返回后 SHALL 重新查询订单详情;状态为 `completed` 时提示延期成功并刷新套餐历史。
|
||
|
||
#### Scenario: 支付成功返回
|
||
- **WHEN** 客户支付完成返回,订单状态为 `completed`
|
||
- **THEN** 页面提示延期成功,套餐历史中该套餐显示新的截止日期
|
||
|
||
#### Scenario: 继续支付
|
||
- **WHEN** 客户打开一笔 `pending_payment` 的延期订单,详情带 `qr_content`
|
||
- **THEN** 页面显示"继续支付",点击后按原支付方式拉起支付
|
||
|
||
### Requirement: 沉默期流水
|
||
|
||
系统 SHALL 在有 `silence` 的套餐上提供"沉默期记录"入口,调用 `GET /api/c/v1/package-silence/records?package_usage_id=` 按时间展示该套餐的沉默期变化记录;无记录时显示空状态。
|
||
|
||
#### Scenario: 查看流水
|
||
- **WHEN** 客户在一笔已延期过的套餐上打开沉默期记录
|
||
- **THEN** 页面按时间列出起算、延期等记录
|
||
|
||
### Requirement: 沉默期错误提示
|
||
|
||
沉默期接口返回错误码 1263~1274 时,系统 SHALL 显示面向客户的中文提示,MUST NOT 直接展示内部错误名称。至少包括:1263 套餐当前不需要延期、1264 该套餐不支持付费延期请联系客服、1265 超过可延期期限、1266 延期天数不在允许范围(带 `min_days`~`max_days`)、1267 免费延期次数已用完、1270 暂未开放延期请联系客服、1271 已有未完成的延期订单、1274 沉默期功能未开启。其他错误码沿用通用错误提示。
|
||
|
||
#### Scenario: 天数超范围
|
||
- **WHEN** 下单返回 1266,`data.min_days = 30`、`data.max_days = 180`
|
||
- **THEN** 页面提示"延期天数需在 30~180 天之间"
|
||
|
||
#### Scenario: 功能未开启
|
||
- **WHEN** 资格接口返回 1274
|
||
- **THEN** 延期页面提示"延期功能暂未开放",不显示下单按钮
|