# 【新增·管理后台】车辆档案:生命周期状态 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" }
```

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

```json
{ "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
