From cf2861ee029a04eadd78dec94b0ab3e5ca55feaa Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Fri, 7 Aug 2026 21:37:22 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=205663=20fleet=20=E8=8B=B1?= =?UTF-8?q?=E6=96=87/=E6=8A=80=E6=9C=AF=E9=BB=91=E8=AF=9D=E6=8F=90?= =?UTF-8?q?=E7=A4=BA=E7=BB=9F=E4=B8=80=E6=94=B9=E4=B8=AD=E6=96=87=E5=8F=8B?= =?UTF-8?q?=E5=A5=BD=EF=BC=88=E7=AE=A1=E7=90=86=E5=90=8E=E5=8F=B0=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...术黑话提示统一改中文友好-修改接口-管理后台.md | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 changelogs-v2/2026-08/07_5663_fleet英文技术黑话提示统一改中文友好-修改接口-管理后台.md diff --git a/changelogs-v2/2026-08/07_5663_fleet英文技术黑话提示统一改中文友好-修改接口-管理后台.md b/changelogs-v2/2026-08/07_5663_fleet英文技术黑话提示统一改中文友好-修改接口-管理后台.md new file mode 100644 index 0000000..db9e224 --- /dev/null +++ b/changelogs-v2/2026-08/07_5663_fleet英文技术黑话提示统一改中文友好-修改接口-管理后台.md @@ -0,0 +1,64 @@ +--- +schema: hl-changelog/v2 +ticket: "5663" +title: "fleet 英文/技术黑话提示统一改中文友好（确认弹窗差异中文名称与文案）" +branch: dev-v3 +module: hl-fleet-service +type: 修改接口 +surfaces: + - frontend_api +backend_status: deployed +gateway_status: verified +frontend_status: pending +related: + - "5644" + - "5640" +contacts: + backend: "wx" +created: 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。