补充合同域 v1/v3 切换口径（#5368）

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`