87 行
2.8 KiB
Markdown
87 行
2.8 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "5405"
|
||
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: "已被后续工单 #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
|
||
> **日期**：2026-08-01
|
||
> **影响范围**：管理后台景区管理列表；内部小程序景区列表会兼容性携带该新增字段
|
||
|
||
## 一、变更接口
|
||
|
||
| 接口 | 方法 | 路径 | 变更 |
|
||
|---|---|---|---|
|
||
| 景区管理查询列表 | GET | `/admin/scenic/spots` | 每条列表记录新增 `deinfo` |
|
||
|
||
同一响应 VO 也用于内部接口 `GET /internal/mp/scenic/list`。小程序服务以
|
||
`Map<String, Object>` 接收并只读取已有字段，因此新增字段不会改变现有聚合结果。
|
||
|
||
## 二、响应字段
|
||
|
||
| 字段 | 类型 | 必填性 | 值 | 说明 |
|
||
|---|---|---|---|---|
|
||
| `deinfo` | `String` | 列表有记录时每条必返 | 固定为 `文旅info` | 景区扩展信息 |
|
||
|
||
响应示例：
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"data": {
|
||
"records": [
|
||
{
|
||
"scenicId": "1001",
|
||
"name": "九寨沟",
|
||
"deinfo": "文旅info"
|
||
}
|
||
],
|
||
"total": 1,
|
||
"current": 1,
|
||
"size": 20
|
||
},
|
||
"success": true
|
||
}
|
||
```
|
||
|
||
空列表仍沿用原分页结构，`records` 为 `[]`，不会生成占位记录。
|
||
|
||
## 三、兼容性与前端事项
|
||
|
||
- 这是向后兼容的响应字段扩展，不修改请求参数、分页结构、查询条件或既有字段。
|
||
- 管理后台可直接读取每条记录的 `deinfo`；当前值固定为 `文旅info`。
|
||
- 后端未修改 `mmg/hl-ui`，前端消费状态保持 `pending`。
|
||
|
||
## 四、验证
|
||
|
||
- 独立 JSON 契约测试：2 项通过，确认字段名为 `deinfo` 且每条记录值为 `文旅info`。
|
||
- `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`。
|
||
|
||
## 五、关联
|
||
|
||
- [后端工单 #5405](https://git.1814.love:8443/wx/HL/issues/5405)
|
||
- [后端 PR #5406](https://git.1814.love:8443/wx/HL/pulls/5406)
|