docs(changelog): 5663 fleet 英文/技术黑话提示统一改中文友好（管理后台接口）

changelogs-v2/2026-08/07_5663_fleet英文技术黑话提示统一改中文友好-修改接口-管理后台.md

@@ -0,0 +1,64 @@
+---
+schema: "hl-changelog/v2"
+ticket: "5663"
+title: "fleet 英文/技术黑话提示统一改中文友好（确认弹窗差异中文名称与文案）"
+consumer: "admin"
+author: "wx"
+change_type: "修改接口"
+backend_status: "deployed"
+gateway_status: "verified"
+frontend_status: "pending"
+frontend_owner: "mmg"
+frontend_ref: ""
+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-07"
+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/{id}/confirm | 同上 |
+| POST /admin/fleet/assignments/{id}/change（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。