changelog-filename-gate / validate (push) Successful in 2s

详情

2026-08-01 16:42:34 +08:00

2.8 KiB

原始文件 Blame 文件历史

schema, ticket, title, consumer, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base

schema	ticket	title	consumer	change_type	backend_status	gateway_status	frontend_status	frontend_owner	frontend_ref	target_release	verified_at	status_note	updated_at	base
hl-changelog/v2	5407	景区列表移除 deinfo 返回参数	multiple	修改接口	pending	pending	pending					后端 PR #5408 已创建；待合并 xr，测试环境部署和网关验证尚未执行	2026-08-01	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`

移除后的响应示例：

{
  "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。

2.8 KiB 原始文件 Blame 文件历史 Unescape Escape