From 91d12c216e1614076f366be6c2210ce7b6b09063 Mon Sep 17 00:00:00 2001 From: yaosutu <770858045@qq.com> Date: Thu, 30 Jul 2026 17:24:13 +0800 Subject: [PATCH] =?UTF-8?q?=E5=AE=8C=E5=96=84=E6=A0=B8=E5=8D=95=E8=BD=A6?= =?UTF-8?q?=E8=BE=86=E4=B8=8B=E6=8B=89=E6=8E=A5=E5=8F=A3=E8=AF=B4=E6=98=8E?= =?UTF-8?q?=E4=B8=8E=E5=89=8D=E7=AB=AF=E5=9B=9E=E5=86=99=E7=8A=B6=E6=80=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...5360_核单车辆异步下拉-新增接口-管理后台.md | 31 ++++++++++++------- 1 file changed, 20 insertions(+), 11 deletions(-) diff --git a/changelogs-v2/2026-07/30_5360_核单车辆异步下拉-新增接口-管理后台.md b/changelogs-v2/2026-07/30_5360_核单车辆异步下拉-新增接口-管理后台.md index 937a2fb..70cafff 100644 --- a/changelogs-v2/2026-07/30_5360_核单车辆异步下拉-新增接口-管理后台.md +++ b/changelogs-v2/2026-07/30_5360_核单车辆异步下拉-新增接口-管理后台.md @@ -5,29 +5,38 @@ title: "核单车辆异步下拉" consumer: "admin" change_type: "新增接口" backend_status: "deployed" -gateway_status: "verified" +gateway_status: "partial" frontend_status: "pending" frontend_owner: "" frontend_ref: "" target_release: "" verified_at: "" -status_note: "测试网关仅对核单车辆异步下拉 GET 做了只读定向验证：指定订单、keyword 为空、limit=1 返回 code=200 且 data 为 1 条七字段记录；未执行写入，也不构成 Full E2E。" +status_note: "测试服双实例已加载新契约，网关路由与统一鉴权响应已验证；现有测试登录态失效，真实订单正向响应、关键词过滤、limit 边界与角色权限仍待前端或 QA 使用有效登录态复验。" updated_at: "2026-07-30" base: "dev-v3" generated: "2026-07-30T17:18:34+08:00" --- -# ✨ 核单车辆异步下拉 +# ✨【新增接口·管理后台】核单车辆异步下拉 (#5360) + +| 头部字段 | 当前值 | +|---|---| +| PR / 服务 | [#5361](https://git.1814.love:8443/wx/HL/pulls/5361) / `hl-order-service-v3` | +| 后端状态 | `deployed`：已合入 `dev-v3` 并部署测试服 | +| 网关状态 | `partial`：路由和鉴权响应已验证，正向业务响应待有效登录态复验 | +| 前端回写标志 | `frontend_status: pending` | +| 前端认领信息 | `frontend_owner`、`frontend_ref` 暂空，领取和提交后回写 | +| 更新时间 | `2026-07-30` | ## 1. 接口背景 核单页面需要按车牌、品牌型号、车型大类或常驻司机姓名异步检索车辆。新增轻量只读下拉接口，返回可直接作为车辆选项使用的七个字段。 -## 变更接口（第 2 节：变更清单） +## 2. 变更清单 | # | 接口名 | 方法 | 路径 | 变更类型 | 说明 | |---|---|---|---|---|---| -| 1 | 查询核单车辆异步下拉 | `GET` | `/v3/admin/order/:orderId/settlement/vehicle-options` | ✨ 新增接口 | `:orderId` 表示订单 ID；按关键词检索车辆，默认最多返回 10 条，最多返回 20 条 | +| 1 | 查询核单车辆异步下拉 | `GET` | `/v3/admin/order/{orderId}/settlement/vehicle-options` | ✨ 新增接口 | 按关键词检索车辆，默认最多返回 10 条，最多返回 20 条 | ## 3. 接口详情 @@ -79,7 +88,7 @@ generated: "2026-07-30T17:18:34+08:00" | `primaryDriverName` | `String` | 是 | 常驻司机姓名；无常驻司机时为 `null` | | `label` | `String` | 否 | 下拉展示文案，依次包含车牌、品牌型号、车型大类和常驻司机姓名；无常驻司机时最后一段为 `无常驻司机` | -`data[]` 严格只有以上七个字段，不包含车辆费用、支付方式或内部鉴权字段。 +`data[]` 严格只有以上七个字段，不包含车辆费用、支付方式或其他未声明字段。 ## 6. 枚举 / 数据字典 @@ -228,14 +237,14 @@ Authorization: Bearer <管理后台访问令牌> - 前端只依赖 `data[]` 中声明的七个字段；`primaryDriverId`、`primaryDriverName` 允许为 `null`。 - 搜索时传用户输入的 `keyword` 即可；不需要为车牌、车型或司机姓名拆分多次请求。 - 本接口为只读查询，成功响应不表示已选择、保存或核单确认车辆。 -- 测试网关仅完成该 GET 的定向只读验证，未执行 Full E2E。 +- 测试服已确认新路径进入统一鉴权链路；因现有测试登录态失效，真实订单正向响应、关键词过滤、`limit` 边界与角色权限仍待使用有效管理后台登录态复验。 -## 验证证据 +### 12.1 验证状态 - **验证模式**：`TARGETED_FALLBACK`，仅执行只读 GET，无写入。 -- **测试请求**：`GET /v3/admin/order/2079454953641836546/settlement/vehicle-options?limit=1`。 -- **测试结果**：响应 `code=200`，`data` 返回 1 条记录；记录字段严格为 `vehicleId`、`plate`、`modelName`、`typeName`、`primaryDriverId`、`primaryDriverName`、`label`。 -- **验证边界**：本次只证明该下拉 GET 在测试网关可达并返回七字段契约，不代表核单 Full E2E 已完成。 +- **已验证**：测试服双实例 OpenAPI 已加载本接口；真实网关请求已进入统一鉴权链路并返回标准五字段错误体。 +- **待复验**：现有测试登录态已失效，真实订单 `code=200` 响应、七字段运行时值、关键词过滤、`limit` 边界和角色权限尚未形成正向实证。 +- **验证边界**：上述状态不代表核单 Full E2E 已完成。 ## 13. 关联 / 联系人