Files
邹进 b2f802e6f8
All checks were successful
构建并部署前端到测试环境 / build-and-deploy (push) Successful in 25m59s
docs: 新增 C 端套餐沉默期展示与自助延期提案 add-package-silence-extension
2026-11-07 11:29:33 +09:00

98 lines
6.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## 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** 延期页面提示"延期功能暂未开放",不显示下单按钮