---
schema: "hl-changelog/v2"
ticket: "5663"
title: "fleet 英文/技术黑话提示统一改中文友好（确认弹窗差异中文名称与文案）"
consumer: "admin"
author: "wx"
change_type: "修改接口"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "implemented"
frontend_owner: "mmg"
frontend_ref: "9784e7aa"
target_release: ""
verified_at: "2026-08-07"
status_note: "后端完成：PR #5672 已合并 dev-v3（2f6b043dd）并部署 TEST（hl-fleet-service 双实例 UP）。确认/创建/改派弹窗逐日差异新增 differenceLabel 中文名称，message 全部改中文友好（动作+原因+怎么办）；600211 去配置 key 名、600112 去 busy 英文；内部异常消息（含保险 long 溢出）转中文。网关验证 8/8：605041 差异返回 label=服务日期缺少派车、message=该日期缺少有效的派车安排，请补派后重试，无英文码名透出，differenceType 枚举保留。"
updated_at: "2026-08-08"
base: "dev-v3"
generated: "2026-08-07T21:38:00+08:00"
---

# fleet 英文/技术黑话提示统一改中文友好（#5663）

## 背景

派车页确认执行弹窗透出英文错误码（如 `DAILY_VEHICLE_PLAN_BASELINE_MISMATCH 逐日逐车方案、价格或只读状态已发生变化`），用户看不懂。全面排查 fleet 车务域英文/技术黑话提示，统一中文友好（动作 + 原因 + 怎么办）。

## 方案

1. **确认/创建/改派弹窗逐日差异**：`ConfirmRespVO.DailyDifferenceVO`（及 AssignmentWriteRespVO/ChangeAssignmentRespVO 的 dailyDifferences）新增 **`differenceLabel` 中文名称字段**；差异 `message` 全部改为「动作 + 原因 + 怎么办」中文，去除「切片 / 冻结 / 快照 / 槽位」等黑话。
2. **错误码文案**：600211 去掉 Nacos 配置 key 名透出；600112 去掉 `(busy)` 英文。
3. **内部异常消息**：快照工厂 / 加密 / occupancy 等英文异常消息转中文（日志与兜底透出均友好）。

## 变更接口

| 接口 | 变更 |
| --- | --- |
| POST /admin/fleet/assignments（holdMode=0） | 605041 响应 `data.dailyDifferences[].differenceLabel` 新增（中文名称）；message 文案更新 |
| POST /admin/fleet/assignments/batch | 同上 |
| POST /admin/fleet/assignments/确认执行 | 同上 |
| POST /admin/fleet/assignments/改派（holdMode=0） | 同上 |
| 全部 fleet 管理接口 | 600211/600112 message 文案更新（无字段变更） |

## 行为变化

- `differenceType` 英文枚举 **保留不变**（供前端逻辑判断），新增 `differenceLabel` 中文名称与 `message` 用于用户展示。
- `differenceLabel` 枚举与中文名称映射：
  - REQUIREMENT_VERSION_MISMATCH → 用车需求已更新
  - ORDER_DATE_MISMATCH → 订单日期已调整
  - ITINERARY_DATE_MISMATCH → 行程日期不一致
  - ASSIGNMENT_DATE_MISSING → 服务日期缺少派车
  - ASSIGNMENT_DATE_EXTRA → 服务日期多出派车
  - HEADCOUNT_BASELINE_MISMATCH → 乘车人数不一致
  - CAPACITY_INSUFFICIENT → 座位数不足

## 前端动作

- **确认/创建/改派失败弹窗**：差异列表展示优先使用 `differenceLabel`（中文名称）+ `message`（动作+原因+怎么办），不要再拼接展示英文 `differenceType` 码名；现有按 `differenceType` 做逻辑判断的分支可保持不变。
- 如前端有硬编码的英文码名映射（如 DAILY_VEHICLE_PLAN_BASELINE_MISMATCH），请同步删除或改为按 `differenceLabel` 展示。

## 验证证据

- fleet 全量 verify：3261 tests，0 failures，4 skipped；spotless:check 通过（PR #5672）。
- 网关实测（TEST）：create(holdMode=0) 基线不一致 → code=605041，`dailyDifferences[].differenceLabel="服务日期缺少派车"`、`message="该日期缺少有效的派车安排，请补派后重试"`，无英文码名透出，`differenceType=ASSIGNMENT_DATE_MISSING` 保留。8/8 断言通过。
- 部署：hl-fleet-service dev-v3=2f6b043dd 双实例 UP。
