diff --git a/changelogs-v2/2026-07/31_5368_非订单页面统一补齐真实团号与团号搜索-修改接口-管理后台.md b/changelogs-v2/2026-07/31_5368_非订单页面统一补齐真实团号与团号搜索-修改接口-管理后台.md index ea4616b..1f3ba9e 100644 --- a/changelogs-v2/2026-07/31_5368_非订单页面统一补齐真实团号与团号搜索-修改接口-管理后台.md +++ b/changelogs-v2/2026-07/31_5368_非订单页面统一补齐真实团号与团号搜索-修改接口-管理后台.md @@ -12,7 +12,7 @@ frontend_ref: "" target_release: "" 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/)。管理后台已由 Pi 领取并开始逐页核对真实团号消费。" -updated_at: "2026-08-03" +updated_at: "2026-08-04" base: "dev-v3" --- @@ -150,6 +150,21 @@ const visibleTeamNo = teamNo?.trim() || '-' 下列 ID 以 JSON String 返回:`contractId`、`orderId`、`schemeId`;详情中的 `travelers[].travelerId` 及状态日志中的 `logId`、`contractId` 同样按字符串处理。`schemeId`、`travelerId` 等可空字段保持 `null`。 +#### ⚠️ v1/v3 切换口径(2026-08-04 决策) + +合同页**全量使用 v3 端点**,不再使用 v1: + +- 创建合同:`POST /v3/admin/contract/create`、`POST /v3/admin/contract/create-by-scheme` +- 刷新合同状态:`GET /v3/admin/contract/{id}/status`(实测成功) +- 列表、详情、作废、下载、重发短信:均走 `/v3/admin/contract/*` + +v1(`/admin/contract/*`)不再用于合同页: + +- v1 存量历史合同(约 20 条,SIGNING/VOIDED)自然消亡,**不迁移、不做兼容转换**; +- v1/v3 合同数据隔离不互通:v3 创建的合同 `contractId` 不能调 v1 接口(返回错误码 `510001`);v1 创建的旧合同不会出现在 v3 列表/详情中。 + +前端合同页应统一按上述 v3 端点实现,移除 v1 合同调用,不得混用两套接口。 + ### 4. 评价 #### `GET /v3/admin/review/list`