From 51ddac08deb0960895582e5f24cb245dcc98741d Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Thu, 11 Jun 2026 14:35:18 +0800 Subject: [PATCH] =?UTF-8?q?changelog:=20=E8=BD=A6=E8=BE=86=E7=94=9F?= =?UTF-8?q?=E5=91=BD=E5=91=A8=E6=9C=9F=20serviceStatus+=E5=81=9C=E7=94=A8?= =?UTF-8?q?=E5=90=AF=E7=94=A8=E6=8E=A5=E5=8F=A3+=E4=B8=AA=E4=BA=BA?= =?UTF-8?q?=E8=BD=A6=E8=B5=9B=E5=AD=A3=E8=81=94=E5=8A=A8=20(PR=20#3690)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...期停用启用与个人车赛季联动-新增接口-管理后台.md | 49 +++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 changelogs-v2/2026-06/11_3690_车辆生命周期停用启用与个人车赛季联动-新增接口-管理后台.md 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