This commit is contained in:
4390
docs/api/package-silence.openapi.json
Normal file
4390
docs/api/package-silence.openapi.json
Normal file
File diff suppressed because it is too large
Load Diff
69
docs/权限.md
69
docs/权限.md
@@ -366,3 +366,72 @@ node scripts/tests/verifyBuild.mjs --serve --polling
|
||||
C 端同步项和接口覆盖/验证见 [本次接入交付说明](./2026-10-26-轮询账户限流-后台接入交付.md)。
|
||||
|
||||
本次验证:191 项回归通过;类型、生产构建、代码/样式/格式与 UTF-8 检查通过。仅本地 mock 验收,没有写入菜单数据、推送或部署;生产构建仍有项目既有循环依赖与大 chunk 警告。
|
||||
|
||||
## 订单分类与沉默期(2026-10-28)
|
||||
|
||||
后台实现已按 Apifox 定义补齐。以下为实际路由和前端权限约定;后端仍需创建真实菜单/按钮记录并独立校验权限与数据范围。未推送、部署或写入服务器菜单,真实支付/审批/退款/导出需测试环境联调。准确范围见 [执行记录](../openspec/changes/add-order-segmentation-and-package-silence/implementation.md)。
|
||||
|
||||
### 新增可见菜单
|
||||
|
||||
| 菜单名称 | URL | 父菜单 | 菜单权限 |
|
||||
| --- | --- | --- | --- |
|
||||
| 平台订单 | `/order-management/platform-orders` | 订单管理 `/order-management` | `orders:platform_page` |
|
||||
| 代理商订单 | `/order-management/agent-orders` | 订单管理 | `orders:agent_page` |
|
||||
| 在线支付订单 | `/order-management/online-orders` | 订单管理 | `orders:online_page` |
|
||||
| 延期订单 | `/package-management/silence-orders` | 套餐管理 `/package-management` | `package_silence:orders_page` |
|
||||
| 延期批次与异常 | `/package-management/silence-batches` | 套餐管理 | `package_silence:batches_page` |
|
||||
| 沉默期临期/过期套餐 | `/package-management/silence-usages` | 套餐管理 | `package_silence:usages_page` |
|
||||
| 延期政策 | `/package-management/silence-policies` | 套餐管理 | `package_silence:policies_page`(并需 `package_silence:policy`) |
|
||||
| 导出平台订单 | `/asset-management/export-task-management/export-order-platform` | 导出管理 `/asset-management/export-task-management` | `export_task:order_platform_page` |
|
||||
| 导出代理商订单 | `/asset-management/export-task-management/export-order-agent` | 导出管理 | `export_task:order_agent_page` |
|
||||
| 导出在线支付订单 | `/asset-management/export-task-management/export-order-online` | 导出管理 | `export_task:order_online_page` |
|
||||
| 导出延期订单 | `/asset-management/export-task-management/export-silence-order` | 导出管理 | `export_task:package_silence_order_page` |
|
||||
| 导出沉默期套餐 | `/asset-management/export-task-management/export-silence-usage` | 导出管理 | `export_task:package_silence_usage_page` |
|
||||
|
||||
代理账号仅可配置平台/代理商普通订单及其导出;在线普通订单及导出只允许 user_type=1/2。企业不得配置普通订单菜单。旧普通订单列表/详情保留。沉默期模块没有额外虚构身份范围,按后端真实授权及数据范围工作。
|
||||
|
||||
### 新增隐藏详情菜单
|
||||
|
||||
| 菜单名称 | URL | 父菜单 | 菜单权限 |
|
||||
| --- | --- | --- | --- |
|
||||
| 延期订单详情 | `/package-management/silence-orders/detail/:id` | 套餐管理 | `package_silence:order_detail_page` |
|
||||
| 延期批次详情 | `/package-management/silence-batches/detail/:id` | 套餐管理 | `package_silence:batch_detail_page` |
|
||||
|
||||
直接访问详情同时要求对应列表页权限、隐藏详情菜单权限和下表详情按钮权限;不能只配隐藏详情菜单。导出详情沿用已有隐藏 `export_task:detail_page` 与已有导出详情 URL。仅超管专属配置不列入普通菜单清单。
|
||||
|
||||
### 新增及沿用按钮权限
|
||||
|
||||
| 操作 | 权限编码 |
|
||||
| --- | --- |
|
||||
| 下单时调整本次沉默期(两个单项购买入口) | `package_silence:override` |
|
||||
| 扫码付费延期、单项特殊延期 | `package_silence:extend` |
|
||||
| 批量特殊延期(含 CSV 导入) | 同时需要 `package_silence:extend`、`package_silence:extend_batch` |
|
||||
| 登记线下付费延期 | `package_silence:offline` |
|
||||
| 异常明细重试/关闭 | `package_silence:exception` |
|
||||
| 政策查询/新增/编辑/启停/匹配 | `package_silence:policy` |
|
||||
| 查看延期订单详情 | `package_silence:order_detail` |
|
||||
| 查看延期批次详情 | `package_silence:batch_detail` |
|
||||
| 创建延期订单导出 | `package_silence:order_export` |
|
||||
| 创建沉默期套餐清单导出 | `package_silence:usage_export` |
|
||||
| 创建普通订单/查看详情/导出 | 沿用 `orders:add` / `orders:view_detail` / `orders:export` |
|
||||
| 平台普通订单导出详情/下载 | `export_task:order_platform_detail` / `export_task:order_platform_download` |
|
||||
| 代理商普通订单导出详情/下载 | `export_task:order_agent_detail` / `export_task:order_agent_download` |
|
||||
| 在线普通订单导出详情/下载 | `export_task:order_online_detail` / `export_task:order_online_download` |
|
||||
| 延期订单导出详情/下载 | `export_task:package_silence_order_detail` / `export_task:package_silence_order_download` |
|
||||
| 沉默期套餐导出详情/下载 | `export_task:package_silence_usage_detail` / `export_task:package_silence_usage_download` |
|
||||
|
||||
沉默期流水、首次购买记录没有在后端文档声明独立按钮权限,继承所属资产/列表页的读取范围,不虚构按钮编码。角色配置继续使用后端真实权限树,需后端提供权限记录和 ID,前端不伪造记录。
|
||||
|
||||
### 操作边界与验证
|
||||
|
||||
- 默认商品沉默期 1–90 天,购买覆盖天数仅最小 1;付费延期天数/金额由资格和试算决定,不复制算法。
|
||||
- 特殊延期 CSV 为前端解析:表头 `package_usage_id,days`,每行两个整数,转换为文档 items[];不假设后端导入文件格式。
|
||||
- 政策免审批完整枚举未在 OpenAPI 给出;已有值原样保留,提供明确的 offline_paid/batch,其他值需填写后端精确编码。政策接口没有 DELETE,不提供删除。
|
||||
- 二维码/线下同一快照重试复用幂等键;特殊请求结果不明时提示核对批次并阻止重复提交。待审批、已支付和已完成严格区分。
|
||||
- 异常关闭必须填写原因并确认,提示在线订单可能原路退款;不直接修改套餐截止时间。
|
||||
- 企业资产五项限制保持;首次购买为只读事实,不回填绑定卡或换货资产;对象缺失隐藏沉默期入口。
|
||||
- 236 项测试、类型与生产构建通过;仅本地 mock 验收,没有真实支付、审批、退款、开关切换、导出、推送或部署。
|
||||
|
||||
### C 端同步(本仓库未修改)
|
||||
|
||||
独立 C 端需接入可选 silence、状态/格式化截止日及 extendable 入口;`/api/c/v1/package-silence` 下的资格、报价、自助下单/qr_content、订单状态刷新、我的延期订单/详情、流水。对象缺失或总开关关闭时隐藏入口;金额单位分、结果取后端,不能复制计费/审批算法,不调用后台 URL。资产归属由后端校验。
|
||||
|
||||
Reference in New Issue
Block a user