From 96a73275ca98cce112b8fe98db173d38eb90573c Mon Sep 17 00:00:00 2001 From: jw Date: Sat, 1 Aug 2026 16:42:34 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=99=AF=E5=8C=BA=E5=88=97=E8=A1=A8?= =?UTF-8?q?=E7=A7=BB=E9=99=A4=20deinfo=EF=BC=88#5407=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...区列表deinfo返回参数-修改接口-管理后台.md | 5 +- ...列表移除deinfo返回参数-修改接口-管理后台.md | 82 +++++++++++++++++++ 2 files changed, 86 insertions(+), 1 deletion(-) create mode 100644 changelogs/2026-08/01_5407_景区列表移除deinfo返回参数-修改接口-管理后台.md diff --git a/changelogs/2026-08/01_5405_景区列表deinfo返回参数-修改接口-管理后台.md b/changelogs/2026-08/01_5405_景区列表deinfo返回参数-修改接口-管理后台.md index 089d05e..9fc654d 100644 --- a/changelogs/2026-08/01_5405_景区列表deinfo返回参数-修改接口-管理后台.md +++ b/changelogs/2026-08/01_5405_景区列表deinfo返回参数-修改接口-管理后台.md @@ -11,13 +11,16 @@ frontend_owner: "" frontend_ref: "" target_release: "" verified_at: "" -status_note: "后端 PR #5406 已合并 xr；测试环境部署和网关验证尚未执行" +status_note: "已被后续工单 #5407 撤销；deinfo 将从景区列表响应中移除" updated_at: "2026-08-01" base: "xr" --- # 景区管理：列表新增 deinfo 返回参数 +> **撤销说明**：本变更已被 [wx/HL #5407](https://git.1814.love:8443/wx/HL/issues/5407) +> 撤销，最新契约以 #5407 的 changelog 为准。 + > **服务**：hl-resource-service > **PR**：#5406 > **Issue**：#5405 diff --git a/changelogs/2026-08/01_5407_景区列表移除deinfo返回参数-修改接口-管理后台.md b/changelogs/2026-08/01_5407_景区列表移除deinfo返回参数-修改接口-管理后台.md new file mode 100644 index 0000000..383be6e --- /dev/null +++ b/changelogs/2026-08/01_5407_景区列表移除deinfo返回参数-修改接口-管理后台.md @@ -0,0 +1,82 @@ +--- +schema: "hl-changelog/v2" +ticket: "5407" +title: "景区列表移除 deinfo 返回参数" +consumer: "multiple" +change_type: "修改接口" +backend_status: "pending" +gateway_status: "pending" +frontend_status: "pending" +frontend_owner: "" +frontend_ref: "" +target_release: "" +verified_at: "" +status_note: "后端 PR #5408 已创建；待合并 xr，测试环境部署和网关验证尚未执行" +updated_at: "2026-08-01" +base: "xr" +--- + +# 景区管理：列表移除 deinfo 返回参数 + +> **服务**：hl-resource-service +> **PR**：#5408 +> **Issue**：#5407 +> **日期**：2026-08-01 +> **影响范围**：管理后台景区管理列表；内部小程序景区列表共用响应 VO + +## 一、撤销背景 + +工单 #5405 曾为景区列表增加固定返回 `文旅info` 的 `deinfo` 字段。本次按 #5407 +撤销该契约扩展，列表响应不再包含 `deinfo`。其他字段、分页结构、查询条件和排序逻辑不变。 + +## 二、变更接口 + +| 接口 | 方法 | 路径 | 变更 | +|---|---|---|---| +| 景区管理查询列表 | GET | `/admin/scenic/spots` | 每条列表记录移除 `deinfo` | +| 内部小程序景区列表 | GET | `/internal/mp/scenic/list` | 共用 VO，不再序列化 `deinfo` | + +移除后的响应示例： + +```json +{ + "code": 200, + "data": { + "records": [ + { + "scenicId": "1001", + "name": "九寨沟" + } + ], + "total": 1, + "current": 1, + "size": 20 + }, + "success": true +} +``` + +空列表仍沿用原分页结构，`records` 为 `[]`，不会生成占位记录。 + +## 三、兼容性与调用方事项 + +- 管理后台不得再读取或展示 `deinfo`。 +- 内部小程序消费者以 `Map` 接收，当前实现未读取 `deinfo`，移除该键不影响既有映射。 +- 请求参数、其余响应字段、分页、筛选和排序行为均不变化。 +- 本文撤销 #5405 的新增字段说明，调用方应以本契约为准。 + +## 四、验证 + +- JSON 契约测试：2 项通过，确认普通记录不含 `deinfo`，空分页结构保持不变。 +- `hl-resource-service` reactor：1712 项测试通过，0 失败；38 项为仓库既有跳过测试。 +- `hl-mp-service` 景区聚合消费方：13 项测试通过，0 失败。 +- oasdiff：`not_configured`，一期项目没有稳定 OAS3 导出与已配置工具，使用源码和 JSON 序列化测试回退。 +- Spring Cloud Contract：`not_configured`，使用生产者及消费者 reactor 测试回退。 +- 测试环境部署和网关验证尚未执行，因此 `backend_status`、`gateway_status` 保持 `pending`。 + +## 五、关联 + +- [本次工单 #5407](https://git.1814.love:8443/wx/HL/issues/5407) +- [本次后端 PR #5408](https://git.1814.love:8443/wx/HL/pulls/5408) +- [被撤销工单 #5405](https://git.1814.love:8443/wx/HL/issues/5405) +- [被撤销后端 PR #5406](https://git.1814.love:8443/wx/HL/pulls/5406)