62 lines
6.3 KiB
Markdown
62 lines
6.3 KiB
Markdown
# 执行记录：订单分类与沉默期
|
||
|
||
## 当前结论
|
||
|
||
本后台代码已按汇总文档及用户授权的 Apifox 定义补齐，原先因缺少 DTO 挂起的延期办理、政策、批次异常和记录弹窗已实现。未修改独立 C 端，未推送、部署或调用真实业务写入；不能把本地 mock 验证等同于线上验收。
|
||
|
||
## 契约来源与差异
|
||
|
||
21 个后台操作读取自用户授权的 Apifox 分享文档，留存无密码快照 [package-silence.openapi.json](../../../docs/api/package-silence.openapi.json)。本会话通过官方 Apifox MCP Server 0.0.18 的 --oas 模式验证文档读取，不代表直接实时连接整个私有项目；线上变更后需重新读取快照。
|
||
|
||
- 所有延期金额、单价均为整数分；元输入做精确整数转换，不能使用浮点金额直接提交。
|
||
- 首次购买记录真实路径为 `GET /api/admin/assets/{asset_type}/{id}/first-purchase-records`，不是汇总里带 package-silence 前缀的路径。
|
||
- 首次购买记录、沉默期流水为数组；政策列表也是数组且有 page/page_size，因此政策页不伪造 total。
|
||
- 更新政策与启停请求含 id；特殊收款时间是 offline_paid_at，线下订单是 paid_at。
|
||
- 两个沉默期导出场景依据 orders/usages 各自文档启用，filters 与列表同范围；通用导出接口对 query 的类型为字符串值，沿用 JSON 字符串 filters。之前三类普通订单仍保留汇总明确要求的对象 filters。
|
||
|
||
## 实现覆盖
|
||
|
||
| 范围 | 已实现 |
|
||
| --- | --- |
|
||
| 分类订单 | 平台/代理/在线三页、独立精确路径与 scene、旧列表详情及历史导出保留；代理禁止 online、企业禁止普通订单 |
|
||
| 企业资产限制 | 有效期、已用量、停用、轮询、实名状态五类入口和处理函数限制；授权资产停复机保持；未找到仍为普通未找到 |
|
||
| 套餐与购买 | 商品默认 1–90 天、加油包剔除、生效条件限制；单项/批量/系列分配写前校验；两处下单覆盖无 90 天上限并有权限及原因校验 |
|
||
| 资产沉默期 | 按可选 silence 展示真实状态/截止/累计；真实 usage ID 打开延期与流水；对象缺失隐藏 |
|
||
| 扫码延期 | 资格、后端报价、wechat/alipay 二维码、确认后创建、订单刷新；终态/错误/关闭停止刷新；不复制计价算法 |
|
||
| 线下登记 | 实收元转分、与报价一致、收款方式字典、交易单号、RFC3339 付款时间、1–5 张凭证、申请依据；待审批不显示已生效 |
|
||
| 特殊与批量 | 五类特殊延期、原因/依据、优惠价收款；CSV 两列转 items[]，校验表头/整数/重复 ID；批量需 extend 和 extend_batch；展示真实批次与错误行 |
|
||
| 订单与批次 | 列表/详情/筛选、订单导出；批次详情逐行异常；重试/关闭需原因及确认，关闭提示可能原路退款 |
|
||
| 临期与过期 | expiring/expired/all 视图、默认 7 天、资产/店铺/套餐/截止范围及导出；延期与流水入口 |
|
||
| 延期政策 | 列表、详情加载、新增/全量编辑、启停、匹配、重叠错误；系列/套餐名称搜索；无 DELETE 不提供删除 |
|
||
| 首次购买 | 卡/设备时间列、RFC3339 筛选/导出、资产详情；列表记录入口和只读世代历史，展示来源/订单/结束原因；不伪造绑定卡或换货时间 |
|
||
| 配置与兼容 | 专用总开关/precheck/failed_items、通用配置只读、企微审批类型、六项真实权限识别、1260–1275 提示及零元退款 |
|
||
|
||
同一二维码/线下请求快照重试使用相同 request_id，不自动重发写请求。特殊延期没有文档定义的幂等参数，传输结果不确定时阻止再次提交并提示先核对批次；不得直接修改截止时间替代异常处理。
|
||
|
||
CSV 为本地解析的 `package_usage_id,days` 两列格式，经文档 items[] 提交，未猜测后端 import_file_key 的文件格式。政策免审批场景完整枚举未在 OpenAPI 列出：提供明确的 offline_paid、batch，并保留服务端现有值；其他编码由后端提供后填写，不根据中文自行造值。批次及明细未知状态原样显示，不推断“已完成”。
|
||
|
||
## 验证
|
||
|
||
当前全量 **236 项测试通过**（保留原 198 项，上一阶段 18 项，本阶段 20 项）。覆盖 21 个精确 HTTP 操作、金额精度与 0、CSV、报价失效、权限撤销/确认取消、幂等重试、迟到响应、线下凭证与审批、特殊结果不确定防重复、政策完整提交、异常 ID/原因、导出白名单与模板编译。
|
||
|
||
类型检查、生产构建、受影响代码 ESLint/Prettier/Stylelint、UTF-8 检查通过。生产构建仍有项目既有常量 v-model、API 循环依赖及大 chunk 警告，未在本轮扩大重构。
|
||
|
||
本地浏览器使用 `127.0.0.1:5190` 全 /api 拦截 mock，核验临期状态与格式化截止时间、31 天后端试算为 60 天、提交确认及订单刷新、政策编辑与 390px 窄屏、批次异常原因确认。上一阶段三类订单/角色门禁/套餐配置/总开关 mock 检查仍保留。没有请求真实支付或审批接口。
|
||
|
||
```powershell
|
||
$tests = @(rg --files scripts/tests -g '*.test.mjs')
|
||
node --import ./scripts/tests/register-esbuild.mjs --test --test-reporter=spec $tests
|
||
.\node_modules\.bin\vue-tsc.cmd --noEmit
|
||
node scripts/tests/verifyBuild.mjs
|
||
node scripts/tests/verifyBuild.mjs --serve --order-silence
|
||
openspec validate add-order-segmentation-and-package-silence --strict
|
||
```
|
||
|
||
## 菜单、权限和 C 端
|
||
|
||
完整菜单/URL/父菜单与普通按钮编码见 [权限清单](../../../docs/权限.md#订单分类与沉默期2026-10-28)。不列仅超管专属设置，不写入服务器菜单或伪造权限 ID。
|
||
|
||
C 端需要另行接入：可选 silence 状态/截止与 extendable 入口；资格、后端报价、自助订单/qr_content、订单状态刷新、我的延期订单和流水；总开关关闭或对象缺失隐藏入口；金额为分、不能复制计费/审批规则。对应 `/api/c/v1/package-silence`，不复用后台 URL；资产归属鉴权交给后端。本仓库未修改 C 端代码。
|
||
|
||
真实测试环境仍需验收：数据范围与权限、实际商户支付及查单、企微通过/驳回、异常关闭退款、上传文件和导出下载内容。全部检查只证明前端实现及本地契约行为，不证明后端已部署兼容。
|