hl-api-changelog/changelogs-v2/2026-06/11_3690_车辆生命周期停用启用与个人车赛季联动-新增接口-管理后台.md

【新增·管理后台】车辆档案:生命周期状态 serviceStatus(在役/停用)+停用/启用接口,个人车随常驻司机赛季自动联动

存放目录: changelogs-v2/2026-06/ 涉及服务: hl-fleet-service(8087) PR: #3690(已合并 dev-v3,测试服已部署并 API 实测 11 步全过) | 无关联工单(wx 2026-06-11 拍定) | 日期: 2026-06-11 影响范围: 管理后台车辆档案列表/详情/操作列

⚠️ 关键说明(前端必看 4 点)

1. 列表/详情新增字段 serviceStatus:ACTIVE(在役) / DISABLED(停用)。这是生命周期状态,与占用态 vehicleStatus(idle/busy/maint)正交——停用的车不该出现在派单候选里,列表建议给停用车置灰/标签。
2. 新增两个操作接口(建议放车辆行操作列,仅对公司车 ownerType=company 展示):
   • POST /admin/fleet/vehicles/{vehicleId}/disable 停用
   • POST /admin/fleet/vehicles/{vehicleId}/enable 启用
   • 幂等(重复点不报错);出参 data: null。
3. 个人车(ownerType=personal)不能手动停用/启用:调了返回业务码 600111「个人自带车生命周期随常驻司机自动联动,不支持手动停用/启用」。前端对 personal 车请隐藏/禁用这两个按钮。个人车的 serviceStatus 完全自动:车主常驻司机在册(active)→车在役;司机归档/拉黑→车自动停用;司机回归→车自动恢复(实测全过,见下)。
4. 列表新增筛选参数 serviceStatus(可选,ACTIVE/DISABLED,不传=全部)。

1. 实测示例(测试服)

个人车随司机赛季联动(实测序列):

司机赛季操作	车 serviceStatus
建个人车绑常驻司机(司机在册)	ACTIVE
司机 在册→待续签(pending)	ACTIVE(不变)
司机 待续签→归档	DISABLED(自动停用)
司机 归档→在册	ACTIVE(自动恢复)
司机 在册→黑名单	DISABLED(自动停用)

公司车手动:

POST /admin/fleet/vehicles/{id}/disable → { "code": 200, "data": null, "message": "成功" }
GET  /admin/fleet/vehicles/{id}         → { ..., "serviceStatus": "DISABLED" }

个人车手动(反例实测):

{ "code": 600111, "message": "个人自带车生命周期随常驻司机自动联动，不支持手动停用/启用" }

2. 存量数据

Flyway 自动加列,存量车全部默认 ACTIVE(在役),前端无需兼容处理。

3. 文档

FLEET API → v1.5.57(§2.5a 新端点 + §2.1/§2.2 字段),文档站:https://web.test.1814.love:9443/hl-docs/order-v3/api/API-SPEC-FLEET-V1.5.html