完善核单车辆下拉接口说明与前端回写状态

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`。
+- **已验证**：测试服双实例 OpenAPI 已加载本接口；真实网关请求已进入统一鉴权链路并返回标准五字段错误体。
-- **测试结果**：响应 `code=200`，`data` 返回 1 条记录；记录字段严格为 `vehicleId`、`plate`、`modelName`、`typeName`、`primaryDriverId`、`primaryDriverName`、`label`。
+- **待复验**：现有测试登录态已失效，真实订单 `code=200` 响应、七字段运行时值、关键词过滤、`limit` 边界和角色权限尚未形成正向实证。
-- **验证边界**：本次只证明该下拉 GET 在测试网关可达并返回七字段契约，不代表核单 Full E2E 已完成。
+- **验证边界**：上述状态不代表核单 Full E2E 已完成。
 
 ## 13. 关联 / 联系人