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

schema, ticket, title, branch, module, type, surfaces, backend_status, gateway_status, frontend_status, related, contacts, created

schema	ticket	title	branch	module	type	surfaces	backend_status	gateway_status	frontend_status	related	contacts	created
hl-changelog/v2	5663	fleet 英文/技术黑话提示统一改中文友好（确认弹窗差异中文名称与文案）	dev-v3	hl-fleet-service	修改接口	frontend_api	deployed	verified	pending	5644 5640	backend wx	2026-08-07

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。