docs: 删除草原指南无用出品角标字段

这个提交包含在:
API Changelog Bot 2026-07-13 14:03:48 +08:00
父节点 61f23b9190
当前提交 0a082cd3bb

查看文件

@ -2,9 +2,9 @@
> 日期2026-07-12
>
> 后端 Issue[HL #4919](https://git.1814.love:8443/wx/HL/issues/4919)、[HL #4922](https://git.1814.love:8443/wx/HL/issues/4922)、[HL #4927](https://git.1814.love:8443/wx/HL/issues/4927)
> 后端 Issue[HL #4919](https://git.1814.love:8443/wx/HL/issues/4919)、[HL #4922](https://git.1814.love:8443/wx/HL/issues/4922)、[HL #4927](https://git.1814.love:8443/wx/HL/issues/4927)、[HL #4940](https://git.1814.love:8443/wx/HL/issues/4940)
>
> 后端 PR[HL #4921](https://git.1814.love:8443/wx/HL/pulls/4921)、[HL #4924](https://git.1814.love:8443/wx/HL/pulls/4924)、[HL #4929](https://git.1814.love:8443/wx/HL/pulls/4929)、[HL #4930](https://git.1814.love:8443/wx/HL/pulls/4930)
> 后端 PR[HL #4921](https://git.1814.love:8443/wx/HL/pulls/4921)、[HL #4924](https://git.1814.love:8443/wx/HL/pulls/4924)、[HL #4929](https://git.1814.love:8443/wx/HL/pulls/4929)、[HL #4930](https://git.1814.love:8443/wx/HL/pulls/4930)、[HL #4946](https://git.1814.love:8443/wx/HL/pulls/4946)、[HL #4948](https://git.1814.love:8443/wx/HL/pulls/4948)
>
> 测试分支:`dev-v3`
>
@ -24,6 +24,7 @@
- 小程序列表支持分页,详情直接把 `videoUrl` 交给原生 `<video>` 组件播放。
- 相关推荐由后端自动计算,并提供独立分页接口供前端滑动加载;后台不再手工选择推荐内容。
- 视频时长和首次发布时间均为只读字段:时长从视频素材派生,发布时间在首次发布时由后端生成。
- 原型没有“呼籁出品”角标开关,管理端和小程序端均不提供 `showProducedBadge` 字段;前端不要提交、读取或展示该字段。
前端必须删除旧版草原指南 VOD 方案中的以下内容:
@ -189,7 +190,6 @@ OSS 自动封面格式:
"contentHtml": "<p>正文内容</p>",
"contentImageMaterialIds": [],
"featured": true,
"showProducedBadge": true,
"sortWeight": 3,
"linkedProductId": null,
"version": 2
@ -336,6 +336,7 @@ OSS 自动封面格式:
- 对 4K 原片请求 `Range: bytes=0-1` 返回 `206``Content-Range: bytes 0-1/412360919`,证明 OSS 支持原生 `<video>` 所需的分段读取,流量不经过业务服务器。
- 4K 内容使用独立上传的 JPEG 封面,详情返回 `coverSource=CUSTOM`;推荐分页返回 3 条上架内容且排除了当前视频。
- 当前测试桶默认域名同时返回 `Content-Disposition: attachment``x-oss-force-download: true`。HTTP Range 能正常工作,但小程序仍须做真机播放验收。2026-07-13 最终决定保持默认 OSS 域名,不切换自定义域名;前端不得自行改写域名,若原生 `<video>` 真机播放失败,保留错误码与设备信息后反馈后端处理。
- 2026-07-13 已从管理端和小程序端完整删除 `showProducedBadge`Resource/MP OpenAPI 均无该字段,首页、列表、详情、推荐 4 个实际接口均返回 `200` 且无该字段;Resource Flyway `20260713.001` 执行成功,遗留数据库列已删除。
## 8. 2026-07-14 正式环境 Nacos 部署清单
@ -356,6 +357,18 @@ file:
5. 串行滚动部署 `hl-user-service`,确认两实例均注册健康且配置已生效。
6. 用正式 OSS 做一轮大于 10 MiB 的 MP4 分片上传、确认、`HEAD``Range 206` 验收;不得在日志或交付文档中记录 STS、AccessKey、Token 等凭证。
### 8.1 `showProducedBadge` 删除的正式环境两阶段发布
正式环境必须把应用字段收缩与数据库删列分两次发布,不能将两个阶段合成一次滚动部署:
1. 先将 PR [#4946](https://git.1814.love:8443/wx/HL/pulls/4946) 的应用层变更单独合入正式目标分支。
2. 依次滚动部署 `hl-resource-service``hl-mp-service`,确认两服务的全部正式实例都已升级且健康;此阶段数据库列仍保留。
3. 验证正式 OpenAPI 和草原指南首页、列表、详情、推荐响应均不再含 `showProducedBadge`
4. 再将 PR [#4948](https://git.1814.love:8443/wx/HL/pulls/4948) 的 `V20260713_001` 迁移合入正式目标分支,只滚动部署 `hl-resource-service`
5. 确认 Flyway `20260713.001` 成功、`show_produced_badge` 列不存在、资源服务全部实例健康,再结束发布。
若正式目标分支已经同时包含 #4946#4948,不得直接按该分支首次启动旧实例集群;应先准备仅包含 #4946 的中间发布版本完成步骤 13,再切换到包含 #4948 的最终版本。该变更不涉及 Nacos 配置修改。
## 9. 前端改造检查单
- [ ] 新增“草原指南管理”列表、编辑和发布页面。
@ -364,6 +377,7 @@ file:
- [ ] 使用素材库通用上传接口处理 `PRESIGNED_URL``STS_MULTIPART`
- [ ] 支持单独上传/选择图片作为自定义封面,并允许清空后恢复自动封面。
- [ ] 草原指南内容保存 `videoMaterialId`,不保存 VOD 字段。
- [ ] 不展示“呼籁出品”开关或角标,不提交、不读取 `showProducedBadge`
- [ ] 发布日期只读:草稿显示未发布,首次发布成功后刷新详情回显后端时间。
- [ ] 删除管理员手工选择相关推荐的控件,不提交 `relatedVideoIds`
- [ ] 小程序列表接入分页参数和分页结果。