From dbc17377254ec4aaf3501f49329a9878fa063b02 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 14 Jul 2026 09:57:24 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=BA=A0=E6=AD=A3=E8=8D=89=E5=8E=9F?= =?UTF-8?q?=E6=8C=87=E5=8D=97=E5=88=A0=E9=99=A4=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2026-07/13_feat_grassland_guide_delete.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/changelogs/2026-07/13_feat_grassland_guide_delete.md b/changelogs/2026-07/13_feat_grassland_guide_delete.md index d55af31..2684b68 100644 --- a/changelogs/2026-07/13_feat_grassland_guide_delete.md +++ b/changelogs/2026-07/13_feat_grassland_guide_delete.md @@ -1,16 +1,16 @@ -# 草原指南管理新增仅下架可删除能力 +# 草原指南管理删除能力（草稿/下架可删） > 日期：2026-07-13 > > 后端 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. 变更范围 -草原指南管理新增删除接口。业务规则固定为：**只有已下架（`OFFLINE`）的视频可以删除**。 +草原指南管理提供删除接口。业务规则固定为：**未上线内容可以删除，其中草稿（`DRAFT`）和已下架（`OFFLINE`）允许删除；已上线（`PUBLISHED`）不允许删除**。 本文件只说明删除能力，不包含 MP4 上传兼容校验、视频时长提取等媒体变更；媒体变更会使用另一份独立 changelog 告知。 @@ -31,8 +31,8 @@ DELETE /admin/grassland-guide/videos/2076195939797688322 ## 3. 前端交互规则 -- 仅当列表或详情的 `status` 为 `OFFLINE` 时展示“删除”按钮。 -- `DRAFT`、`PUBLISHED` 均不展示删除按钮。 +- 当列表或详情的 `status` 为 `DRAFT` 或 `OFFLINE` 时展示“删除”按钮。 +- `PUBLISHED` 不展示删除按钮。 - 点击删除前展示二次确认；确认后调用删除接口。 - 删除成功后刷新当前列表；若正在详情页，应返回列表。 - 不要因为界面已判断状态就忽略后端错误，仍需处理并发变更结果。 @@ -53,7 +53,7 @@ grassland-guide:delete |---|---|---| | `371001` | 视频不存在或已经删除 | 提示内容不存在，并刷新列表 | | `371002` | 删除过程中数据被其他管理员修改 | 提示刷新后重试 | -| `371008` | 当前状态不允许删除 | 提示“只有已下架内容可以删除”，并刷新当前数据 | +| `371008` | 已上线内容不允许删除 | 提示“已上线内容不能删除”，并刷新当前数据 | ## 6. 数据语义 @@ -64,14 +64,14 @@ grassland-guide:delete ## 7. 联调清单 -后端在 `origin/dev` 基线上已完成 15 模块编译和 24 项目标单测；TEST 已完成接口验收，管理端 UI 仍需前端联调： +后端完成新规则回归及 TEST 验收后更新本节证据。前端联调清单如下： -- [x] `OFFLINE` 视频删除成功，管理端详情和小程序详情、列表均不再返回。 -- [x] `DRAFT`、`PUBLISHED` 直接调用删除接口均返回 `371008`。 -- [x] 删除请求没有 body，也没有 `version`。 -- [x] 重复删除返回 `371001`。 +- [ ] `DRAFT`、`OFFLINE` 视频删除成功，管理端详情和小程序详情、列表均不再返回。 +- [ ] `PUBLISHED` 直接调用删除接口返回 `371008`，数据和引用关系不变。 +- [ ] 删除请求没有 body，也没有 `version`。 +- [ ] 重复删除返回 `371001`。 - [ ] 无 `grassland-guide:delete` 权限时不展示入口。 -- [ ] 管理端仅在 `OFFLINE` 状态展示删除入口，并完成二次确认交互。 -- [x] 删除内容后，素材库中的原视频和封面仍然存在。 +- [ ] 管理端仅在 `DRAFT`、`OFFLINE` 状态展示删除入口，并完成二次确认交互。 +- [ ] 删除内容后，素材库中的原视频和封面仍然存在。 -TEST 证据：验收内容 ID `2076674584685240321` 已完成 `DRAFT → PUBLISHED → OFFLINE → 删除` 全状态流转；删除前尝试删除被引用素材返回 `371009`，删除内容后素材 `2076658080942116865` 仍保留且状态为 `OSS_MP4_READY_V1`。 +> 注意：前端不提交 `version`；并发控制由后端内部实现。历史 TEST 证据基于旧规则，不作为本次纠正后的验收结论。