44 lines
5.3 KiB
Markdown
44 lines
5.3 KiB
Markdown
# Change: 订单分类拆页与套餐沉默期后台接入
|
||
|
||
## Why
|
||
|
||
依据 `docs/2026-10-27-订单拆分至沉默期-前端修改汇总(1).md`，后台尚未接入订单分类列表、企业账号操作限制、套餐沉默期及延期、首次购买套餐时间。需要保留既有订单详情、付款/审批、套餐分配与资产功能，并区分前端实现和真实后端联调。
|
||
|
||
用户于 2026-10-28 明确要求“根据文档来写提案，然后执行”，本提案完成严格校验后按该授权实施。延续只修改本后台仓库的范围，不修改独立 H5/C 端，不推送或部署。工作区已有四个轮询修复文件必须保留。
|
||
|
||
## What Changes
|
||
|
||
- 订单管理新增平台、代理商、在线支付三页，复用原列表及详情、筛选、创建能力；各自请求 `/orders/platform|agent|online`，不提交类别参数，导出分别使用 `order_platform|order_agent|order_online`。保留旧列表及历史 `order` 导出。代理隐藏在线支付页，企业隐藏订单菜单并阻止页面请求；不改变后端数据范围。
|
||
- 企业账号隐藏并在处理函数阻止资产改有效期、改已用量、停用、开关轮询、改实名状态五项操作，保留授权资产的停复机及读取。未找到不改写为无权限。
|
||
- 正式套餐新增默认沉默期（1–90 天）与付费延期开关；实名即生效必填，新建默认 30 天；购买即生效可选；加油包不显示、不提交。新增未配置筛选与导出参数、详情展示；明确生效条件不可从实名改成购买，购买改实名需同请求带天数。
|
||
- 后台两处单项下单入口增加有权限才可填写的 `silence_period_days`、`silence_reason`；购买覆盖天数仅最小 1、不套用套餐配置 90 天上限，天数存在时原因必填。保留后端审批结果，不将待审批说成已延期。
|
||
- 资产当前套餐、历史套餐按可选 `silence` 对象展示状态、截止日、累计与审批信息；对象缺失时隐藏，入口按 `extendable` 与权限控制。流水使用真实 usage ID。
|
||
- 卡/设备新增首次购买时间列、RFC3339 范围筛选、导出参数、详情与只读记录弹窗；绑定卡不伪造首次购买时间，换货历史以服务端世代与结束原因展示，不在前端推算或回填。
|
||
- 新增沉默期专用开关页（仅超管），展示 `precheck` 与 1275 的 `failed_items`；通用系统配置不写此开关。增加沉默期审批业务类型与六个权限点的前端识别；角色权限树沿用服务器数据，不伪造权限 ID。
|
||
- 完整目标包含延期资格/试算/二维码、线下付款、特殊单项/批量延期、延期订单/批次异常、临期/过期清单、延期政策以及两个沉默期导出场景；金额、审批与状态均以服务端事实为准，不复制后端计费规则。
|
||
- 错误码 1260–1275 保留服务端具体原因、限制与异常行；零元退款允许提交，后台线下购买未实名套餐仍按后端待生效状态展示。
|
||
|
||
## Contract gaps and execution boundary
|
||
|
||
首次执行时，`docs/admin-openapi.yaml`、被引用的沉默期技术方案与后端规范未提供，因此对应可写业务未实施。2026-10-28 用户补充并授权带密码的 Apifox 分享文档访问后，已取得 21 个后台操作，保存为 `docs/api/package-silence.openapi.json`（不含密码）。下面四组缺口现已按该权威定义补齐，任务第 3 节已执行；真实环境支付/审批/导出仍需联调验收。
|
||
|
||
初次记录的缺口（现已由 Apifox 补齐）：
|
||
|
||
1. 延期政策 POST/PUT 字段、字段类型、级别/范围/重叠规则、列表/详情响应与状态枚举。
|
||
2. 资格 options、quote、二维码及线下订单响应的字段结构、金额单位、订单 ID/状态/支付状态；超时重试的 request_id 复用约定。
|
||
3. 特殊延期优惠收款字段名、amount 与 paid_amount 单位、evidence_refs 元素结构、批量部分成功/异常响应完整结构。
|
||
4. 流水、延期订单、批次/明细、usage 清单、首次购买记录的分页结构、筛选、时间与状态字段；未定义处不得擅自命名。
|
||
|
||
执行顺序：先完成本文可确定的订单、企业限制、套餐/下单字段、首次购买字段/筛选、审批类型和错误提示；契约缺口独立保持未完成。若执行期间补齐规范，再继续完成相应延期业务。不得以全部接口存在或本地测试通过代替完整业务验收。
|
||
|
||
## Impact
|
||
|
||
- Affected specs: 新增 `order-segmentation-and-package-silence` 接入约束；当前无已发布 specs，以 ADDED 记录，不伪造 MODIFIED 基线。
|
||
- Affected code: order、packageManage、shopPackageAllocation、asset、card、device、wecom、systemConfig、exportTask 的类型/服务/界面、路由与权限、相关工具及回归测试。
|
||
- 与 `update-october-batch-one-admin-integration` 的订单支付信息、退款审批状态，以及 `update-package-allocation-expiry-base-override` 的分配覆盖保持兼容；不重置此前轮询修复。
|
||
- 不产生真实支付、审批、资产写入、导出、开关切换或 CSV 导入；写操作验证仅本地 mock。
|
||
|
||
## Delivery
|
||
|
||
交付提案、实际改动与测试证据；菜单清单给出名称、URL、父菜单、普通按钮编码，不重复列仅超管专属项；单列 C 端同步要求和确实因契约缺失未完成的工作。
|