changelog: 车辆生命周期 serviceStatus+停用启用接口+个人车赛季联动 (PR #3690)

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

@@ -0,0 +1,49 @@
+# 【新增·管理后台】车辆档案:生命周期状态 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