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

6.8 KiB
Raw Blame History

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 延期页面提示"延期功能暂未开放",不显示下单按钮