From 28e3bc46cb80bffb42b1674339873c09b4f003d3 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Tue, 11 Aug 2026 09:42:11 +0800 Subject: [PATCH] =?UTF-8?q?changelog(#5810):=20requirementFleetText=20?= =?UTF-8?q?=E6=A0=BC=E5=BC=8F=E6=94=B9=E8=BD=A6=E9=98=9F=E7=BB=84=E6=88=90?= =?UTF-8?q?=E5=86=99=E6=B3=95=EF=BC=88PR=20#5817=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...车型语句改车队组成写法-修改接口-管理后台.md | 65 +++++++++++++++++++ 1 file changed, 65 insertions(+) create mode 100644 changelogs-v2/2026-08/11_5810b_需求车型语句改车队组成写法-修改接口-管理后台.md diff --git a/changelogs-v2/2026-08/11_5810b_需求车型语句改车队组成写法-修改接口-管理后台.md b/changelogs-v2/2026-08/11_5810b_需求车型语句改车队组成写法-修改接口-管理后台.md new file mode 100644 index 0000000..201d3c1 --- /dev/null +++ b/changelogs-v2/2026-08/11_5810b_需求车型语句改车队组成写法-修改接口-管理后台.md @@ -0,0 +1,65 @@ +--- +schema: "hl-changelog/v2" +ticket: "5810" +title: "需求车型语句 requirementFleetText 格式调整：座位内联 + 加号连接（商务车7座×1 + SUV5座×1）" +consumer: "admin" +change_type: "修改接口" +author: "wx(GIT)" +backend_status: "deployed" +gateway_status: "not_required" +frontend_status: "pending" +frontend_owner: "mmg" +frontend_ref: "" +target_release: "" +verified_at: "2026-08-11" +status_note: "" +updated_at: "2026-08-11" +base: "dev-v3" +--- + +# 需求车型语句格式调整（#5810 展示口径跟进，PR #5817） + +> **服务**: hl-fleet-service +> **PR**: #5817（已合并 dev-v3，已部署测试服） +> **日期**: 2026-08-11 +> **关联**: `11_5810_换版槽位人工制-需求语句与派车日期门禁-修改接口-管理后台.md` §1 的格式部分被本条取代；配套布局要求见 `11_frontend_派单Step2需求展示区与统一选车弹窗空白-前端缺陷-管理后台.md` §3 + +--- + +## 变更接口 + +`GET /admin/fleet/board/orders/{orderId}` 根级字段 `requirementFleetText`，**仅格式变化，字段名/类型/位置/可空性全不变**： + +| | 拼接规则 | 26-9313 实例 | +|---|---------|-------------| +| 改前 | `{车型}×{数量}({座位}座)`，中文顿号 `、` 连接 | `商务车×1(7座)、SUV×1(5座)` | +| **改后** | `{车型}{座位}座×{数量}`，**` + `**（空格加号空格）连接 | **`商务车7座×1 + SUV5座×1`** | + +座位数内联到车型后、多项用加号连接，对齐车务口头表述车队组成的习惯写法，一眼读出"这单要几台什么车"（wx 2026-08-11 定稿）。 + +**兜底语义完全不变**：车型标签走归一字典（未知车型回退原始编码）、`count` 为空或非正按 1、`seats` 为空时省略座位段（形如 `SUV×2`）、需求不可达时整字段为 `null`。 + +## 前端影响 + +**接入方式零变化** —— 本字段的用法一直是「后端给什么就原样显示什么」： + +- ✅ 直接把字符串渲染出来即可 +- 🔴 **不要解析这个字符串**（不要按 `×`/`、`/`+` 切分取车型或数量） +- 🔴 **不要自己按 `vehicleSlots` 或需求明细拼**——拼法口径归后端一处收口，否则日后改口径要改两边 +- `null` 时整块不渲染（不要出现「当前需求：」空冒号或「当前需求：null」） + +展示位置见配套 changelog：派单弹窗 Step2「排车」页槽位表格下方常驻一行，形如 `当前需求：商务车7座×1 + SUV5座×1`。 + +## 验证证据 + +2026-08-11 09:4x，PR #5817 合并 dev-v3 → Deploy Panel 部署 hl-fleet-service（exit_code=0）→ SSH 确认进程 09:40 重启 → 网关 `https://api.test.1814.love:9443` 车务管理员 token 实测： + +| 订单 | `requirementFleetText` 实测值 | +|------|------------------------------| +| 26-9313（两车型混合） | `商务车7座×1 + SUV5座×1` ✅ | +| 26-3698 | `商务车7座×2` | +| 26-0821 | `商务车7座×2` | +| 26-3420 / 26-9452 / 26-7944 | `SUV5座×1` | +| 26-4789 / 26-6575 / 26-3281 | `商务车7座×1` | + +单测：`BoardOrderServiceTest` 4 个 requirementFleetText 用例全绿（常规两项 / 空需求返 null / 缺座位缺数量兜底 / 未知车型回退原始值）；fleet 全量 3382 tests 除存量环境依赖用例外全绿；`FleetRedLineArchTest` 12 tests 绿。