75 行
3.8 KiB
Markdown
75 行
3.8 KiB
Markdown
---
|
||
schema: "hl-changelog/v2"
|
||
ticket: "6112"
|
||
title: "看板详情透出终止行程取消原因"
|
||
consumer: "admin"
|
||
author: "wx"
|
||
change_type: "修改接口"
|
||
backend_status: "deployed"
|
||
gateway_status: "verified"
|
||
frontend_status: "verified"
|
||
frontend_owner: "mmg"
|
||
frontend_ref: "d58ad932"
|
||
target_release: ""
|
||
verified_at: "2026-08-21"
|
||
status_note: "终止行程的真实原因（如「客户中止」）此前在 order 侧，fleet 落库的是写死文案。本次全链路透传：order → Feign DTO 加可选字段 → fleet 落库 → 看板详情 VO 透出。前端只需在已取消行渲染 cancelReason。"
|
||
updated_at: "2026-08-21"
|
||
base: "dev-v3"
|
||
generated: "2026-08-21T12:38:23+08:00"
|
||
---
|
||
|
||
# 看板详情透出终止行程取消原因（#6112）
|
||
|
||
## 背景
|
||
|
||
订单**终止行程**（出行中中止）时运营会填真实原因（如「客户中止」），但车务看板已取消派单只显示「已取消」，看不到原因——fleet 侧落库的是固定文案「订单终止行程，自终止生效日起截断未来派单」。
|
||
|
||
本次把真实原因全链路透传到看板详情，前端补渲染即可。与房务侧 #6111（异常原因透出）对齐。
|
||
|
||
## 变更接口
|
||
|
||
| 接口 | 变更 |
|
||
| --- | --- |
|
||
| `GET /admin/fleet/board/orders/{orderId}` | **响应新增可选字段**：`vehicleSlots[].cancelReason`、`currentAssignment.cancelReason`。已取消（`slotStatus==="canceled"`）的槽位/派单返回终止或取消原因；其他状态为 `null` |
|
||
|
||
内部链路（前端无需关心，仅供联调排查）：order 侧 `terminateTrip` 把 `cancelReason` 经 `TruncateOrderAssignmentsRequest`（内部 Feign DTO，新增可选字段）传给 fleet，fleet 终止截断时落库 `fleet_assignment.cancel_reason`。
|
||
|
||
## 前端动作（本次唯一要改的地方）
|
||
|
||
在车务看板 → 订单详情抽屉 → 已取消派单行/车辆执行段：
|
||
|
||
1. **渲染条件**：`vehicleSlots[]` 中 `slotStatus === "canceled"` 且 `cancelReason` 非空时，在「已取消」badge 旁展示原因文本（如「客户中止」）。
|
||
2. **空态**：历史已取消派单 `cancelReason` 为 `null` → 不渲染原因区，不报错。
|
||
3. 非 canceled 行不展示（字段为 `null`）。
|
||
4. 无新增颜色/状态标签，纯文本。
|
||
|
||
## 取值示例（TEST 实测返回）
|
||
|
||
```json
|
||
{
|
||
"assignmentSlotId": "348032503497494528",
|
||
"slotStatus": "canceled",
|
||
"slotStatusLabel": "已取消",
|
||
"cancelReason": "客户中止（#6112 网关验收）",
|
||
"assignmentId": "2089642687186563073"
|
||
}
|
||
```
|
||
|
||
## 兼容性
|
||
|
||
- 旧版 order 不传 `cancelReason` → fleet 收到 `null`，落库保留原固定文案兜底（双向兼容，可独立发布）。
|
||
- 历史已取消派单 `cancel_reason` 为 NULL → VO 原样透传 `null`，前端不渲染即可。
|
||
- 手动取消（人工填的 cancelReason）写入路径未改动，不受影响。
|
||
|
||
## 验证证据
|
||
|
||
- 单测：fleet `AssignmentServiceTest`（透传落库/空值兜底）、`BoardOrderServiceTest`（已取消槽位透出/在途槽位 null）、order `OrderServiceTest`（透传断言）、`FleetAssignmentExpandFeignContractTest`（DTO wire 往返）全绿；`mvn -pl hl-fleet-service -am verify` BUILD SUCCESS（3846 测试），spotless 0 违规。
|
||
- 部署：hl-fleet-service（8087/8187）、hl-order-service-v3（8086/8186）已滚动部署 TEST。
|
||
- 网关实测（TEST 9443，真 SUPER_ADMIN token）：对出行中订单 `HL20260818171654688` 以「客户中止」终止行程 → fleet 派单截断为 canceled → `GET /admin/fleet/board/orders/2089642686163128322` 返回 `vehicleSlots[].cancelReason="客户中止（#6112 网关验收）"`；历史终止单 `2090093100083904514` 返回原固定文案，无报错。
|
||
|
||
## 关联
|
||
|
||
- Issue: [#6112](https://git.1814.love:8443/wx/HL/issues/6112)
|
||
- PR: [#6124](https://git.1814.love:8443/wx/HL/pulls/6124)
|
||
- Merge commit: [a373d5be2](https://git.1814.love:8443/wx/HL/commit/a373d5be2)
|