Mimingguang
87ed9d0a3f
changelog-filename-gate / validate (push) Failing after 2s
处置明细(mmg 2026-09-18): - 68 条机械核验通过批量翻 verified:frontend_ref 均可达且为 v2.1 祖先、 交付文件 HEAD 均在、关联 spec 批量 58 文件 891 例全绿。 - 11 条带演进史的例外逐条核后翻 verified:3 条交付自删文件(06_5610/ 07_5655/11_5810,删除即交付内容且终态保持);8 条被后续 changelog 预期 演进(10_5784→#5810、07_5664/08_5592→#5827、07_5665→去槽位化 U1、 01_5380/05_5356/06_5567/06_5581→settlement 族A扁平化与 mock 清理), status_note 均如实记录演进链。 - 05_5552 改判 not_required:frontend_ref 自述前端无需改动,grep 实证 vehicleFeeAmount.js 直接读后端 calendarPrice/calendarPriceMissing。 - 11_5827 frontend_ref 原空,经核交付即 753503c8(向导 4 步改 3 步提交 即派定),补登全哈希 753503c87cc635e5646b4368a8ed506746c79cf1。 另:保险域 2 条相邻条目(05_5530/06_5593)同标准复核翻 verified。 2026-07 历史月 45 条按规则不回扫,保持原状。
5.3 KiB
5.3 KiB
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
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | 5533 | 司机列表新增车型大类/所属车队展示与筛选，详情关联订单补齐接送机/金额/定制师 | admin | wx(GIT) | 修改接口 | deployed | verified | verified | pi-main-session | hl-admin@005ba4cf9151e39aac5bcf4c5e5480411d68264e | 2026-09-18 | [mmg 2026-09-18 批量复核翻 verified] ref 005ba4cf 可达且为 v2.1 祖先;交付文件 HEAD 均在;关联 spec 批量 891 例全绿。 | 2026-09-18 | dev-v3 |
车务司机管理：列表车型大类/所属车队展示与筛选 + 详情关联订单字段补齐
服务: hl-fleet-service PR: #5538 Issue: #5533 日期: 2026-08-05 影响范围: 管理后台司机列表 / 司机详情关联订单区域
变更接口
| 接口 | 方法 | 路径 | 变更 |
|---|---|---|---|
| 司机档案分页查询 | GET | /admin/fleet/drivers/page |
列表项新增车型大类/所属车队字段；新增 vehicleTypeKeys、teamIds 筛选参数 |
| 司机档案详情查询 | GET | /admin/fleet/drivers/（司机ID） |
relatedOrders[] 新增接送机地点、日费/总费、定制师字段 |
二、响应字段
2.1 司机列表 records[]（顶层新增）
| 字段 | 类型 | 必填性 | 值 | 说明 |
|---|---|---|---|---|
residentVehicleTypeKey |
String / null |
否 | suv2/mpv/sedan/bus 等 |
权威常驻车辆第一辆的车型大类 key（与派单候选弹窗分类一致）；无常驻车辆为 null |
residentVehicleTypeName |
String / null |
否 | SUV系列/商务车/轿车系列/大巴系列 |
车型大类中文名；无常驻车辆为 null |
residentTeamId |
String / null |
否 | 车队雪花 ID（JSON 字符串） | 权威常驻车辆第一辆的所属车队 ID；无常驻车辆为 null |
residentTeamName |
String / null |
否 | 合作车队B |
所属车队名；无常驻车辆为 null |
residentVehicles[] 子项同步新增：vehicleTypeKey、vehicleTypeName、fleetTeamId、fleetTeamName。
2.2 司机列表新增筛选参数
| 参数 | 类型 | 必填性 | 说明 |
|---|---|---|---|
vehicleTypeKeys |
List<String> |
否 | 车型大类 key 多选过滤（逗号分隔），常驻车辆挂在任一大类下即命中；不传不过滤 |
teamIds |
List<Long> |
否 | 所属车队 ID 多选过滤，常驻车辆属于任一支车队即命中；不传不过滤 |
2.3 司机详情 relatedOrders[]（新增）
| 字段 | 类型 | 必填性 | 值 | 说明 |
|---|---|---|---|---|
pickupAt |
String / null |
否 | 满洲里 |
接机地点（fleet_assignment.pickup_at 快照）；无记录为 null |
dropoffAt |
String / null |
否 | 满洲里 |
送机地点（fleet_assignment.dropoff_at 快照）；无记录为 null |
dailyFee |
String / null |
否 | 800.00 |
协议日费（protocol_price 快照，JSON 字符串）；无费用为 null |
totalFee |
String / null |
否 | 800.00 |
派车组总费（vehicle_fee_total 快照，JSON 字符串）；无费用为 null |
customizerName |
String / null |
否 | 王骁 |
定制师名（planner_name 快照） |
原有字段（orderId/orderNo/teamNo/customerName/tripStartDate/tripEndDate/destination/orderStatus/vehicleType/licensePlate）不变；destination 保留为 pickup/dropoff 兼容拼接。
三、兼容性与前端事项
- 全部为向后兼容的响应字段扩展 + 可选筛选参数，不改既有字段语义、分页结构。
- 车型大类 key 以 vehicle_type 表 type_key 为准（与派单候选弹窗分类一致，如
suv2），前端筛选值应复用候选弹窗/字典数据源。 - 后端未修改
mmg/hl-ui，前端消费状态保持pending。
验证证据
- 定向测试 158 项全绿（DriverServiceTest 144 / VehicleResidentReadPortImplTest 7 / DriverMapperPageExcludeTest 3 / DriverRelatedOrderReadPortImplTest 4）；fleet verify 3130 项仅 1 既有基线 flaky 失败（Step2CanonicalSnapshotServiceTest 时间敏感，stash 验证与本次无关），0 Errors；spotless 0 违规。
- 测试环境网关实测：
- 列表：朝鲁门（suv2/SUV系列/北疆协作车队）、菜单师傅46622（mpv/商务车/自有）、王信（sedan/轿车系列/合作车队A）；无常驻车辆司机全字段 null
- 筛选：
vehicleTypeKeys=suv23 人、suv2,mpv多选 8 人、teamIds=合作车队B1 人、组合筛选 1 人、不存在大类空结果正确 - 详情：乌云毕力格 relatedOrders 2 条——pickup/dropoff=满洲里、teamNo=26-4081、status=in_progress、dailyFee=0.00/totalFee=800.00、customizer=王骁、customer=卫予轩
五、关联 / 联系人
5.1 链接
5.2 联系人
- 后端负责人: @wx
关联/联系人
链接
- 后端工单 #5533
- 后端 PR #5538
- Merge commit:
9215f86ee6
联系人
- 后端负责人: @wx