112 行
3.9 KiB
Markdown
112 行
3.9 KiB
Markdown
---
|
||
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`。
|