Files
device-voice-h5/openspec/changes/add-package-silence-extension/proposal.md
邹进 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

2.4 KiB
Raw Blame History

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