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