docs: 纠正草原指南删除规则

这个提交包含在:
API Changelog Bot 2026-07-14 09:57:24 +08:00
父节点 6e96521aa7
当前提交 dbc1737725

查看文件

@ -1,16 +1,16 @@
# 草原指南管理新增仅下架可删除能力 # 草原指南管理删除能力(草稿/下架可删)
> 日期2026-07-13 > 日期2026-07-13
> >
> 后端 Issue[HL #4959](https://git.1814.love:8443/wx/HL/issues/4959) > 后端 Issue[HL #4959](https://git.1814.love:8443/wx/HL/issues/4959)
> >
> 后端 PR[HL #4960](https://git.1814.love:8443/wx/HL/pulls/4960),已合入 `dev`;随后通过 [HL #4963](https://git.1814.love:8443/wx/HL/pulls/4963) 由 `dev` 合入 `dev-v3` > 历史 PR[HL #4960](https://git.1814.love:8443/wx/HL/pulls/4960)、[HL #4963](https://git.1814.love:8443/wx/HL/pulls/4963) 实现的是旧规则,已被本次业务口径纠正取代
> >
> 当前状态:已合入 `dev``dev-v3`,TEST 双实例部署及真实接口验收通过;尚未合入 `main`、尚未部署正式环境 > 当前状态:后端正在按纠正后的规则重新实现并回归;完成后先合入 `dev`,再由 `dev` 合入 `dev-v3` 部署 TEST;不合入 `main`、不部署正式环境
## 1. 变更范围 ## 1. 变更范围
草原指南管理新增删除接口。业务规则固定为:**只有已下架(`OFFLINE`)的视频可以删除**。 草原指南管理提供删除接口。业务规则固定为:**未上线内容可以删除,其中草稿(`DRAFT`)和已下架(`OFFLINE`)允许删除;已上线(`PUBLISHED`)不允许删除**。
本文件只说明删除能力,不包含 MP4 上传兼容校验、视频时长提取等媒体变更;媒体变更会使用另一份独立 changelog 告知。 本文件只说明删除能力,不包含 MP4 上传兼容校验、视频时长提取等媒体变更;媒体变更会使用另一份独立 changelog 告知。
@ -31,8 +31,8 @@ DELETE /admin/grassland-guide/videos/2076195939797688322
## 3. 前端交互规则 ## 3. 前端交互规则
- 当列表或详情的 `status``OFFLINE` 时展示“删除”按钮。 - 当列表或详情的 `status` `DRAFT` `OFFLINE` 时展示“删除”按钮。
- `DRAFT`、`PUBLISHED` 不展示删除按钮。 - `PUBLISHED` 不展示删除按钮。
- 点击删除前展示二次确认;确认后调用删除接口。 - 点击删除前展示二次确认;确认后调用删除接口。
- 删除成功后刷新当前列表;若正在详情页,应返回列表。 - 删除成功后刷新当前列表;若正在详情页,应返回列表。
- 不要因为界面已判断状态就忽略后端错误,仍需处理并发变更结果。 - 不要因为界面已判断状态就忽略后端错误,仍需处理并发变更结果。
@ -53,7 +53,7 @@ grassland-guide:delete
|---|---|---| |---|---|---|
| `371001` | 视频不存在或已经删除 | 提示内容不存在,并刷新列表 | | `371001` | 视频不存在或已经删除 | 提示内容不存在,并刷新列表 |
| `371002` | 删除过程中数据被其他管理员修改 | 提示刷新后重试 | | `371002` | 删除过程中数据被其他管理员修改 | 提示刷新后重试 |
| `371008` | 当前状态不允许删除 | 提示“只有已下架内容可以删除”,并刷新当前数据 | | `371008` | 已上线内容不允许删除 | 提示“已上线内容不能删除”,并刷新当前数据 |
## 6. 数据语义 ## 6. 数据语义
@ -64,14 +64,14 @@ grassland-guide:delete
## 7. 联调清单 ## 7. 联调清单
后端`origin/dev` 基线上已完成 15 模块编译和 24 项目标单测;TEST 已完成接口验收,管理端 UI 仍需前端联调 后端完成新规则回归及 TEST 验收后更新本节证据。前端联调清单如下
- [x] `OFFLINE` 视频删除成功,管理端详情和小程序详情、列表均不再返回。 - [ ] `DRAFT``OFFLINE` 视频删除成功,管理端详情和小程序详情、列表均不再返回。
- [x] `DRAFT``PUBLISHED` 直接调用删除接口均返回 `371008` - [ ] `PUBLISHED` 直接调用删除接口返回 `371008`,数据和引用关系不变
- [x] 删除请求没有 body,也没有 `version` - [ ] 删除请求没有 body,也没有 `version`
- [x] 重复删除返回 `371001` - [ ] 重复删除返回 `371001`
- [ ] 无 `grassland-guide:delete` 权限时不展示入口。 - [ ] 无 `grassland-guide:delete` 权限时不展示入口。
- [ ] 管理端仅在 `OFFLINE` 状态展示删除入口,并完成二次确认交互。 - [ ] 管理端仅在 `DRAFT`、`OFFLINE` 状态展示删除入口,并完成二次确认交互。
- [x] 删除内容后,素材库中的原视频和封面仍然存在。 - [ ] 删除内容后,素材库中的原视频和封面仍然存在。
TEST 证据:验收内容 ID `2076674584685240321` 已完成 `DRAFT → PUBLISHED → OFFLINE → 删除` 全状态流转;删除前尝试删除被引用素材返回 `371009`,删除内容后素材 `2076658080942116865` 仍保留且状态为 `OSS_MP4_READY_V1` > 注意:前端不提交 `version`;并发控制由后端内部实现。历史 TEST 证据基于旧规则,不作为本次纠正后的验收结论