docs(changelog): 前端任务——改派页加选择司机按钮(后端 change 已支持 newDriverId)

这个提交包含在:
API Changelog Bot 2026-08-07 19:07:46 +08:00
父节点 d65e40a936
当前提交 a6475f4efa
共有 2 个文件被更改,包括 110 次插入0 次删除

查看文件

@ -0,0 +1,66 @@
---
schema: "hl-changelog/v2"
ticket: "5656"
title: "派单详情 travelers 补 nativePlace 跨服务透传(#5642 链路补全)"
consumer: "admin"
author: "wx"
change_type: "修改接口"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "pending"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "后端完成PR #5661 合并 dev-v33ee5770af并部署 TESTorder-v3+fleet 双服务);网关实测派单详情与 travelers 端点 nativePlace 解析正确150784→内蒙古呼伦贝尔市等 5 场景)。"
updated_at: "2026-08-07"
base: "dev-v3"
generated: "2026-08-07T18:40:00+08:00"
---
# 派单详情 travelers 补 nativePlace 跨服务透传(#5656
## 背景
#5642 仅为 order 管理端 `TravelerVO`traveler/list 等)加了 `nativePlace`;派单详情走跨服务链路order `GET /v3/internal/order/orders/{orderId}/fleet-detail-context` → fleet `BoardOrderDetailVO.travelers`),该链路 traveler DTO 未带 `nativePlace`,派单页/看板详情展示出行人时缺所属地。本单补全该链路。
## 变更内容
| 层 | 变更 |
|---|---|
| hl-common | `OrderTravelerForFleetDTO` 新增可空 `nativePlace`(身份证所属地,省+地级行政区名;非身份证/未命中为 null |
| order 生产者 | `OrderFleetProviderService#toMaskedTraveler` 填充(复用 #5642 `IdCardParser` 解析结果,同源 `idProvinceName` |
| fleet 消费者 | `BoardOrderDetailVO.travelers` / `GET /admin/fleet/board/orders/{id}/travelers` / `FleetTravelerAccessService#listMasked` 均直接复用共享 DTO,无逐字段映射,自动获得字段 |
受影响接口(均为新增只读字段,无破坏性):
- `GET /admin/fleet/board/orders/{orderId}`(派单详情聚合)→ `data.travelers[].nativePlace`
- `GET /admin/fleet/board/orders/{orderId}/travelers``data[].nativePlace`
- internal`GET /v3/internal/order/orders/{orderId}/fleet-detail-context``GET /v3/internal/order/orders/{orderId}/fleet-travelers` 的 traveler 投影同步带 `nativePlace`
取值口径与 #5642 一致:大陆身份证命中地级码→省短名+地市名(如 `150784…`→内蒙古呼伦贝尔市;直辖市→市名;省直辖县级4190/4290/4690/6590→6 位精确映射;非身份证或未命中(含已撤销历史码)→`null` 不报错。
## 关联 / 联系人
- 工单https://git.1814.love:8443/wx/HL/issues/5656
- PRhttps://git.1814.love:8443/wx/HL/pulls/5661
- 后端wx
## 变更接口或验证证据
### 接口契约
- 接口路径/方法/请求体:不变。
- 响应 travelers 项新增 `nativePlace`string | null
### 验证证据
- 定向测试order `OrderFleetProviderServiceTest` 53 全过(含 fleet-detail-context nativePlace 断言;fleet `BoardOrderServiceTest` 87 + `BoardControllerTest` 11 全过(含派单详情 travelers.nativePlace 透传断言)。
- 全量fleet `mvn -pl hl-fleet-service -am verify` 3256 测试,失败仅 ReleaseEMixedBinaryHarnessTest(1F)+ReleaseEOccupancyMysql8033RecoveryTest(10E) 两个 harness 类,git stash 基线复跑同类同败;order `-pl hl-order-service-v3 -am verify` 7610 测试 7F/95E 失败类集与 #5642 基线逐一相同;fleet spotless:check 通过。
- 部署 TEST 成功hl-order-service-v3 + hl-fleet-service
- 网关验证(自建 HLTEST 订单 2085637067265449985,复用 #5642 五场景出行人):派单详情与 travelers 端点均断言 150784→内蒙古呼伦贝尔市、469001→海南五指山市、110101→北京市、PASSPORT→null、371201已撤销码→null;脱敏与省级字段回归通过。
## 前端/调用方动作
- 派单页/看板详情展示出行人所属地时直接使用 `travelers[].nativePlace``null` 展示空(如 "-")。
- 与 #5642 traveler/list 口径一致,前端两处共用同一展示逻辑即可。

查看文件

@ -0,0 +1,44 @@
---
schema: "hl-changelog/v2"
ticket: ""
title: "改派页面缺「选择司机」按钮(无法改派司机)"
consumer: "admin"
author: "wx"
change_type: "前端修复"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "pending"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: ""
updated_at: "2026-08-07"
base: "origin/dev-v3"
generated: "2026-08-07"
---
# 改派页面缺「选择司机」按钮(前端修复)
## 问题wx 实测)
派单【改派】页面:显示"当前司机 xxx / 当前车辆 xxx"+"车辆和司机可任选一侧先选",但**只有选车入口,没有「选择司机」按钮**——无法改派司机。
## 后端已就绪(前端直接用)
改派接口 `POST /admin/fleet/assignments/{assignmentId}/change` 的 ReqVO **已支持 `newDriverId`**(改司机)——后端能力在,前端缺入口。
## 前端要做
改派弹窗/页面**加「选择司机」按钮**(与选车并列):
- 点【选择司机】→ 打开司机候选(可用现有候选组件,按当前派单日期/需求过滤空闲司机)
- 选定司机 → 调 change 接口传 `newDriverId` 完成改派司机
- 改派司机的校验(档期冲突/黑名单/跨常驻确认/保险)与改派车一致(后端 change 已处理)
## 验收
- [ ] 改派页有【选择司机】按钮,可选新司机
- [ ] 选定后调 change 传 newDriverId,改派司机生效
- [ ] 改派司机校验(冲突/跨常驻/保险)正常提示
## 关联
- 后端 change 接口:`POST /admin/fleet/assignments/{assignmentId}/change`ReqVO 含 newDriverId/newVehicleId
## 联系人
- 后端/协调台wx