docs: 景区列表移除 deinfo(#5407)
所有检测均成功
changelog-filename-gate / validate (push) Successful in 2s

这个提交包含在:
jw 2026-08-01 16:42:34 +08:00
父节点 1d5e0efb43
当前提交 96a73275ca
共有 2 个文件被更改,包括 86 次插入1 次删除

查看文件

@ -11,13 +11,16 @@ frontend_owner: ""
frontend_ref: "" frontend_ref: ""
target_release: "" target_release: ""
verified_at: "" verified_at: ""
status_note: "后端 PR #5406 已合并 xr;测试环境部署和网关验证尚未执行" status_note: "已被后续工单 #5407 撤销;deinfo 将从景区列表响应中移除"
updated_at: "2026-08-01" updated_at: "2026-08-01"
base: "xr" base: "xr"
--- ---
# 景区管理:列表新增 deinfo 返回参数 # 景区管理:列表新增 deinfo 返回参数
> **撤销说明**:本变更已被 [wx/HL #5407](https://git.1814.love:8443/wx/HL/issues/5407)
> 撤销,最新契约以 #5407 的 changelog 为准。
> **服务**hl-resource-service > **服务**hl-resource-service
> **PR**#5406 > **PR**#5406
> **Issue**#5405 > **Issue**#5405

查看文件

@ -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<String, Object>` 接收,当前实现未读取 `deinfo`,移除该键不影响既有映射。
- 请求参数、其余响应字段、分页、筛选和排序行为均不变化。
- 本文撤销 #5405 的新增字段说明,调用方应以本契约为准。
## 四、验证
- JSON 契约测试2 项通过,确认普通记录不含 `deinfo`,空分页结构保持不变。
- `hl-resource-service` reactor1712 项测试通过,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)