From 0a082cd3bbbfd4f741593956631df9a52141d927 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 13 Jul 2026 14:03:48 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=88=A0=E9=99=A4=E8=8D=89=E5=8E=9F?=
 =?UTF-8?q?=E6=8C=87=E5=8D=97=E6=97=A0=E7=94=A8=E5=87=BA=E5=93=81=E8=A7=92?=
 =?UTF-8?q?=E6=A0=87=E5=AD=97=E6=AE=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../12_feat_grassland_guide_admin_mp_oss.md   | 20 ++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md b/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md
index bd02755..2db8ee7 100644
--- a/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md
+++ b/changelogs/2026-07/12_feat_grassland_guide_admin_mp_oss.md
@@ -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 的中间发布版本完成步骤 1～3，再切换到包含 #4948 的最终版本。该变更不涉及 Nacos 配置修改。
+
 ## 9. 前端改造检查单
 
 - [ ] 新增“草原指南管理”列表、编辑和发布页面。
@@ -364,6 +377,7 @@ file:
 - [ ] 使用素材库通用上传接口处理 `PRESIGNED_URL` 和 `STS_MULTIPART`。
 - [ ] 支持单独上传/选择图片作为自定义封面，并允许清空后恢复自动封面。
 - [ ] 草原指南内容保存 `videoMaterialId`，不保存 VOD 字段。
+- [ ] 不展示“呼籁出品”开关或角标，不提交、不读取 `showProducedBadge`。
 - [ ] 发布日期只读：草稿显示未发布，首次发布成功后刷新详情回显后端时间。
 - [ ] 删除管理员手工选择相关推荐的控件，不提交 `relatedVideoIds`。
 - [ ] 小程序列表接入分页参数和分页结果。