2.4 KiB
2.4 KiB
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;测试环境验证前需要打开。