wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态

docs(changelog): #5368 后端合并部署+网关验证完成，交接前端

浏览代码 
- backend_status=deployed、gateway_status=verified（2026-08-03）
- PR #5386 合并至 dev-v3@07834e4c5；4 服务部署 TEST 成功
- 网关实测：profile/orders teamNo=groupCode+keyword 搜索、contract teamNo 过滤分页正确、
  fleet insurance/board teamNo 返回与查询、chat 会话 teamNo、月度对账 teamNo、雪花 ID String
- 补充 yst 契约裁决（2026-08-03）：internal designer-list 不新增 teamNo，
  user-service 公开边界执行 teamNo=groupCode
- frontend_status 保持 pending，待前端消费
这个提交包含在：
API Changelog Bot 2026-08-03 19:49:59 +08:00
父节点 3bf849cf93
当前提交 b61a2f89a0
共有 1 个文件被更改，包括 17 次插入 和 14 次删除
显示统计 下载 Patch 文件 下载 Diff 文件 展开所有文件 折叠所有文件

31
changelogs-v2/2026-07/31_5368_非订单页面统一补齐真实团号与团号搜索-修改接口-管理后台.md
查看文件

@ -4,15 +4,15 @@ ticket: "5368"
title: "非订单页面统一补齐真实团号与团号搜索"
consumer: "admin"
change_type: "修改接口"
backend_status: "pending"
gateway_status: "pending"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "pending"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "后端 Draft PR #5386 已推送且最终 HEAD 独立复审无 P0-P2；尚未合并、部署或完成网关 E2E，OpenAPI/oasdiff 与 Spring Cloud Contract 当前 not_configured，frontend_status 保持 pending"
updated_at: "2026-07-31"
verified_at: "2026-08-03"
status_note: "PR #5386 已合并（dev-v3@07834e4c5）；order-v2/order-v3/user/fleet 已部署 TEST（tasks 03b0fecb/2b54e87b/258865cf/d290d667）并经网关验证：profile/orders teamNo=groupCode+keyword 搜索、contract teamNo 过滤分页正确、fleet insurance/board teamNo 返回与查询（orderNo 片段不命中）、chat 会话 teamNo、月度对账 teamNo、雪花 ID JSON String。OpenAPI/oasdiff 与 Spring Cloud Contract 仍 not_configured（人工回退证据见 D:/tmp/hl5368-gateway-evidence/）。frontend_status 保持 pending，待前端按自身流程消费。"
updated_at: "2026-08-03"
base: "dev-v3"
---
@ -23,10 +23,11 @@ base: "dev-v3"
> **前端交接 Issue**: `wx/hl-api-changelog#64`
> **日期**: 2026-07-31
> **影响范围**: 管理后台工作台、订单列表、合同、评价、车务、房务、会话等订单关联页面
> **候选基线**: `dev-v3@cbb6c062540b8b6836c3d93efec608c2a42f20bc` + Draft PR [#5386](https://git.1814.love:8443/wx/HL/pulls/5386) HEAD `60c747e40f390c00ca3901c86c176a25dc38d98b`
> **最终 diff SHA-256**: `0d251e8f32d4e38cc362515ebc115596e600df9e893fda2d652ff7f3377e9837`
> **候选基线**: `dev-v3@07834e4c5`（PR #5386 已合并）
> **合并 PR**: [#5386](https://git.1814.love:8443/wx/HL/pulls/5386) head `b65cff23a`，merge commit `07834e4c5`
> **后端/网关状态**: backend=deployed，gateway=verified（2026-08-03）
当前 #5368 仍为 OPEN、0/13 验收。后端实现已提交并推送至 Draft PR #5386，最终 HEAD 独立只读复审未发现 P0-P2；但 PR 尚未合并，MySQL 8、OpenAPI/oasdiff、测试环境部署与真实网关跨服务 E2E 仍未闭环。本文用于冻结字段、路径、空值和兼容口径，不得据此把后端、网关或前端状态提前升级。
> **契约裁决（yst 2026-08-03T16:24，承接 #5372）**: `/internal/order/designer-list` 仅扩展 keyword 对真实 `groupCode` 的模糊搜索，保留原响应字段，**不新增 `teamNo`**；对外 `/admin/order/list` 与 `/admin/profile/orders` 返回 `teamNo: String|null`，user-service 在公开边界执行 `teamNo=groupCode`。后端已按此实现并合并。
---
@ -89,6 +90,8 @@ const visibleTeamNo = teamNo?.trim() || '-'
内部 Feign 链路同步透传 `teamNo`，供 `/admin/profile/dashboard` 和管理端会话使用；前端不得直接调用 internal API。
> **契约裁决（yst 2026-08-03，承接 #5372）**：`GET /internal/order/designer-list` 仅扩展既有 `keyword` 对真实 `groupCode` 的模糊搜索，**保留原响应字段，不新增 `teamNo`**；对外 `/admin/order/list` 与 `/admin/profile/orders` 返回 `teamNo: String|null`，user-service 在公开边界执行 `teamNo = groupCode`。
---
## 三、接口详情与搜索口径
@ -250,12 +253,12 @@ const visibleTeamNo = teamNo?.trim() || '-'
## 验证证据（已完成项与剩余门禁）
- [x] 后端实现已提交并推送至 Draft PR #5386；专用 worktree clean，本地、远端分支与 PR HEAD 均为 `60c747e40f390c00ca3901c86c176a25dc38d98b`。
- [x] 上游 #5371/#5384 对齐后，order-v3 `test-compile` 与 Contract/Review/HOUSE/Dashboard 定向 319 tests 通过；Fleet、user、order-v2 的既有完整 reactor 证据通过。最终 HEAD 独立复审无 P0-P2。
- [ ] Fleet `FleetInsuranceTeamNoMysqlTest` 与最新 order-v3 MySQL 8 Testcontainers 尚未实跑；当前机器无 Docker，skip 或 Docker environment error 不计通过。
- [ ] 生成合并候选 OpenAPI，与 `dev-v3` 基线执行 oasdiff；当前无可复现 Swagger 2 → OAS3/oasdiff 证据，Spring Cloud Contract 同样 `not_configured`。
- [ ] 合并并部署测试环境后，逐接口验证 `teamNo` 有值/null、搜索命中/不命中以及雪花 ID 字符串。
- [ ] 网关路径、鉴权及同一 `orderId` 跨 profile/contract/review/fleet/house/chat 的真实 HTTP/E2E 通过。
- [x] PR #5386 已合并至 `dev-v3@07834e4c5`；合并前独立只读复审 P0/P1=0、唯一 P2（profile/orders 镜像缺 displayStatus/displayStatusLabel/updateTime 透传）已修复并回归。
- [x] 全量验证通过：order-v2 3496 tests、order-v3 7272 tests、user 3512 tests、fleet 2887 tests，全 0 failures；fleet spotless:check 通过；`FleetInsuranceTaskTeamNoMysqlTest` 以外部 MySQL 8 实跑 3/3。证据：`D:/tmp/hl5368-fleet-verify-final2.log`、`D:/tmp/hl5368-user-test4.log`。
- [x] 4 服务已部署 TEST：order-v2 task `03b0fecb`、order-v3 `2b54e87b`、user `258865cf`、fleet `d290d667`（均 success）。
- [x] 网关实测（`api.test.1814.love:9443`）：profile/orders 返回 `teamNo=groupCode` 且 keyword 团号搜索 total 正确；`/admin/order/list` 同；contract list 团号过滤分页前生效（精确 total=1/模糊 total=2）且 detail 返回 teamNo；fleet insurance tasks 返回并可按 teamNo 查询（命中 4/不存在 0）；fleet board teamNo 搜索仅匹配真实团号（orderNo 片段不命中）；chat 订单会话返回 teamNo、非订单会话 null；house 月度对账返回 teamNo；所有雪花 ID 均 JSON String；同一订单 2079576729147338754 在 contract 与月度对账均返回 `26-4165`。证据：`D:/tmp/hl5368-gateway-evidence/gateway-evidence.md`。
- [ ] OpenAPI/oasdiff 与 Spring Cloud Contract 仍未配置（`not_configured`）；已用上述生产者/消费者 JUnit 与真实网关 HTTP 作为人工回退证据。
- [ ] 测试环境 review 列表与 grab-pool 无业务数据（total=0），团号 OR 搜索由 Mapper 单测覆盖，未做真数据命中验证。
- [ ] 前端完成展示、搜索、路由与动作回归后，由前端 owner 更新 `frontend_status`；当前保持 `pending`。
---