API Changelog Bot 37e951eb49 docs(api): record fleet detail gateway verification

2026-07-22 16:34:52 +08:00

3.9 KiB

原始文件 Blame 文件历史

schema, ticket, title, consumer, backend, gateway, frontend, base, generated

schema	ticket	title	consumer	backend	gateway	frontend	base	generated
hl-changelog/v1	5149	派单详情补充团号与产品类型	admin	verified	verified	pending	dev-v3	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

工单: wx/HL#5149

影响范围: 管理后台订单派车弹窗 Step1 订单详情

关键变化

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

变更接口

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

响应关键字段：

{
  "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，前端显示 --，不要从产品名称猜测类型。

前端展示口径

弹窗标题

当前：

派单 · {orderNo} · {customerName}

改为：

派单 · {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。

3.9 KiB 原始文件 Blame 文件历史 Unescape Escape