83 行
2.8 KiB
Markdown
83 行
2.8 KiB
Markdown
---
|
||
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` 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)
|