wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态
hl-api-changelog/changelogs-v2/2026-08/07_5663_fleet英文技术黑话提示统一改中文友好-修改接口-管理后台.md
API Changelog Bot 3041884f3c
所有检测均成功
changelog-filename-gate / validate (push) Successful in 2s
详情
docs(changelog): 5663 fleet 英文/技术黑话提示统一改中文友好（管理后台接口）
2026-08-07 21:38:07 +08:00

3.9 KiB
原始文件 Blame 文件历史

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