From 22a51bdd091d0f217519b66344c8b705ef3b161e Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 22 Jul 2026 16:23:43 +0800 Subject: [PATCH] docs(api): notify fleet team and product type fields --- ...团号与产品类型-修改接口-前端待处理-管理后台.md | 110 ++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 changelogs-v2/2026-07/84_5149_派单详情补充团号与产品类型-修改接口-前端待处理-管理后台.md diff --git a/changelogs-v2/2026-07/84_5149_派单详情补充团号与产品类型-修改接口-前端待处理-管理后台.md b/changelogs-v2/2026-07/84_5149_派单详情补充团号与产品类型-修改接口-前端待处理-管理后台.md new file mode 100644 index 0000000..9408685 --- /dev/null +++ b/changelogs-v2/2026-07/84_5149_派单详情补充团号与产品类型-修改接口-前端待处理-管理后台.md @@ -0,0 +1,110 @@ +--- +schema: "hl-changelog/v1" +ticket: "5149" +title: "派单详情补充团号与产品类型" +consumer: "admin" +backend: "verified" +gateway: "pending" +frontend: "pending" +base: "dev-v3" +generated: "2026-07-22T16:22:00+08:00" +--- + +# 【修改接口·前端待处理·管理后台】派单详情补充团号与产品类型 + +## 目标前端 + +- 端类型：管理后台（Web） +- 目标仓库：`mmg/hl-ui` +- 仓库地址： +- 目标分支：`v2.1` +- 联调/验收环境： +- 小程序：无需处理 + +> **服务**: 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` 通过。 +- 测试环境部署与网关验收结果将在完成后回写。 + +> 本文是前端接入通知，不代表已修改或发布 `mmg/hl-ui`。