diff --git a/changelogs-v2/2026-06/11_3690_车辆生命周期停用启用与个人车赛季联动-新增接口-管理后台.md b/changelogs-v2/2026-06/11_3690_车辆生命周期停用启用与个人车赛季联动-新增接口-管理后台.md new file mode 100644 index 0000000..bc7cea6 --- /dev/null +++ b/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