---
schema: "hl-changelog/v1"
ticket: "5149"
title: "派单详情补充团号与产品类型"
consumer: "admin"
backend: "verified"
gateway: "verified"
frontend: "pending"
base: "dev-v3"
generated: "2026-07-22T16:22:00+08:00"
---

# 【修改接口·前端待处理·管理后台】派单详情补充团号与产品类型

## 目标前端

- 端类型：管理后台（Web）
- 目标仓库：`mmg/hl-ui`
- 仓库地址：<https://git.1814.love:8443/mmg/hl-ui.git>
- 目标分支：`v2.1`
- 联调/验收环境：<http://192.168.100.160:9527>
- 小程序：无需处理

> **服务**: hl-order-service-v3、hl-fleet-service
>
> **后端 PR**: [wx/HL#5154](https://git.1814.love:8443/wx/HL/pulls/5154)
>
> **工单**: [wx/HL#5149](https://git.1814.love:8443/wx/HL/issues/5149)
>
> **影响范围**: 管理后台订单派车弹窗 Step1 订单详情

## 关键变化

`GET /admin/fleet/board/orders/{orderId}` 已有 `teamNo`，但前端当前把 `orderNo` 显示在标题和详情区，造成订单号被误认为团号。本次新增产品类型枚举值和中文名，前端必须改用 `teamNo` 展示团号。

## 变更接口

| 方法 | 路径 | 变更类型 | 说明 |
| --- | --- | --- | --- |
| GET | `/admin/fleet/board/orders/{orderId}` | 响应新增字段 | 新增 `productType/productTypeName`，继续返回 `teamNo` |

响应关键字段：

```json
{
  "code": 200,
  "data": {
    "orderNo": "HL20260721171011648",
    "teamNo": "26-0503",
    "customerName": "孔知悦",
    "productName": "测试核心产品-多档-固定比例",
    "productType": "CORE",
    "productTypeName": "核心产品",
    "relatedDetailReady": true
  }
}
```

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `orderNo` | String/null | 订单号，仅保留业务查询和审计用途，不再作为弹窗团号展示 |
| `teamNo` | String/null | 团号，弹窗标题与详情区的权威展示字段 |
| `productType` | String/null | 产品类型枚举：`CORE/ROUTE/CUSTOM/GROUP` |
| `productTypeName` | String/null | `product_type` 数据字典中文名，页面优先展示该字段 |

order 服务不可用、`relatedDetailReady=false` 时，新产品类型字段可能为 `null`，前端显示 `--`，不要从产品名称猜测类型。

## 前端展示口径

### 弹窗标题

当前：

```text
派单 · {orderNo} · {customerName}
```

改为：

```text
派单 · {teamNo || '--'} · {customerName}
```

- 标题中不再展示 `orderNo`。
- `teamNo` 为空时显示 `--`，不得回退为订单号，以免继续混淆两个业务编号。

### 订单详情区

- 在订单基础信息中明确增加 `团号：{teamNo || '--'}`。
- 增加 `产品类型：{productTypeName || productType || '--'}`。
- 产品名称继续读取 `productName`，与产品类型分开显示。
- 图中顶部原 `HL202607...` 订单号位置改为团号；不要在同一区域重复显示订单号。

## 前端处理清单

- [ ] 弹窗标题将 `orderNo` 替换为 `teamNo`，空值显示 `--`。
- [ ] 订单详情区新增或修正“团号”字段，读取 `teamNo`。
- [ ] 订单详情区展示“产品类型”，优先读取 `productTypeName`，枚举值作为降级。
- [ ] 产品名称与产品类型保持两个独立字段，不从名称推断类型。
- [ ] 雪花 ID 继续按字符串处理。

## 验证证据

- order→fleet 共享 DTO 生产者/消费者定向测试通过。
- `mvn -pl hl-order-service-v3,hl-fleet-service -am test` 通过。
- `mvn -pl hl-fleet-service spotless:check` 通过。
- `mvn -pl hl-order-service-v3,hl-fleet-service -am verify` 通过。
- `hl-order-service-v3` 8086/8186 与 `hl-fleet-service` 8087/8187 已从 `dev-v3` 滚动部署并保持健康。
- 测试网关对截图订单实测 HTTP/业务码 200：`teamNo` 非空，`productType=CORE`，`productTypeName` 非空，且 `orderNo` 与 `teamNo` 为不同编号。

> 本文是前端接入通知，不代表已修改或发布 `mmg/hl-ui`。