3.8 KiB
schema, ticket, title, consumer, change_type, author, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
| schema | ticket | title | consumer | change_type | author | backend_status | gateway_status | frontend_status | frontend_owner | frontend_ref | target_release | verified_at | status_note | updated_at | base |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | 5810 | 需求车型语句 requirementFleetText 格式调整:座位内联 + 加号连接(商务车7座×1 + SUV5座×1) | admin | 修改接口 | wx(GIT) | deployed | not_required | not_required | mmg | 2026-08-11 | 前端实证 not_required(2026-08-11,mmg):本条仅后端 requirementFleetText 拼接格式变化(座位内联+加号连接),字段名/类型/位置/可空性全不变,接入方式零变化(原样显示)。grep 实证前端两消费点(AssignModal.vue:791、OrderDrawer.vue:115)均 `当前需求:{{ requirementFleetText }}` 原样渲染 + v-if 防空(null 不渲染),computed 纯 `String(...??'').trim()` 透传,零解析/零自拼(无 split/×/、/+ 处理),三条红线(不解析/不自拼/null 不渲染)全满足,后端新格式自动呈现。 | 2026-08-11 | 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 绿。