From 9aef56dfe0e9fb2a9380e7bf1fdad8ed8c9da229 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 4 Aug 2026 10:44:40 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E5=90=88=E5=90=8C=E5=9F=9F?= =?UTF-8?q?=20v1/v3=20=E5=88=87=E6=8D=A2=E5=8F=A3=E5=BE=84=EF=BC=88#5368?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...统一补齐真实团号与团号搜索-修改接口-管理后台.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) 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`