32 lines
2.4 KiB
Markdown
32 lines
2.4 KiB
Markdown
## Why
|
||
|
||
后端 8-11 迭代已上线"实名即生效套餐沉默期"：套餐历史返回 `silence` 对象，并提供 H5 自助延期接口（`/api/c/v1/package-silence/*`）。C 端目前没有用上任何沉默期字段和接口，客户看不到沉默期状态，沉默期过期后也无法自助付费延期，只能找运营在后台办理。依据 `junhong_cmp_fiber/docs/2026-11-06-测试环境8-11新功能前端对接与权限现状.md` 第 5.1 节补齐 C 端。
|
||
|
||
本变更基于 `iteration/8-11` 分支，只部署测试环境。
|
||
|
||
## What Changes
|
||
|
||
- 套餐历史每笔套餐展示沉默期：状态、截止时间、沉默期天数、累计延期天数、"调整审批中"标记；`silence` 为空时不显示，保持现有展示。
|
||
- `silence.extendable = true` 时显示"延期"入口。
|
||
- 新增自助延期流程：查询延期资格 → 选择或输入延期天数并试算金额与新截止日 → 选择支付方式下单 → 用返回的 `qr_content` 拉起支付或展示二维码 → 支付后刷新状态。
|
||
- 新增"我的延期订单"列表与详情。
|
||
- 新增套餐沉默期流水查看。
|
||
- 沉默期错误码 1263～1274 给出客户能看懂的提示。
|
||
- 不改现有套餐购买、钱包、实名流程；不改任何停复机相关逻辑（前端本来也不发起停复机）。
|
||
|
||
## Capabilities
|
||
|
||
### New Capabilities
|
||
- `package-silence-extension`：C 端套餐沉默期展示、自助付费延期、延期订单与沉默期流水查看、沉默期错误提示。
|
||
|
||
### Modified Capabilities
|
||
（无。本仓库 `openspec/specs/` 下没有已有规格。）
|
||
|
||
## Impact
|
||
|
||
- 页面：`pages/asset-package-history`、`components/PackageHistoryNode.vue`；新增延期页、延期订单列表与详情页、沉默期流水页，并在 `pages.json` 注册。
|
||
- 接口：新增 `api/modules/packageSilence.js`，在 `api/index.js` 导出；`api/modules/asset.js` 的套餐历史归一化保留 `silence` 字段。
|
||
- 支付：复用 `utils/payment.js` 的支付宝支付页和待刷新标记；微信支付方式取决于后端 `qr_content` 的类型，见 design 待确认事项。
|
||
- 后端接口（8-11 已提供，不改）：`GET /api/c/v1/asset/package-history`，`GET /api/c/v1/package-silence/eligibility`、`/quote`、`/orders`、`/orders/:id`、`/records`，`POST /api/c/v1/package-silence/orders`。
|
||
- 依赖后端总开关 `package.silence.enabled`：关闭时不返回 `silence`、延期接口返回 1274；测试环境验证前需要打开。
|