From 81f054d3a3014a4eea320dc210c2a81dcb2176f6 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 17 Jun 2026 16:50:03 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog):=20=E4=B8=AA=E4=BA=BA=E8=BD=A6?= =?UTF-8?q?=E5=B8=B8=E9=A9=BB=E5=8F=8C=E5=90=91=E5=90=8C=E6=AD=A5=E5=8F=B8?= =?UTF-8?q?=E6=9C=BA=E8=BD=A6=E7=89=8C=20(PR=20#3929,=20=E7=AE=A1=E7=90=86?= =?UTF-8?q?=E5=90=8E=E5=8F=B0)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 后端数据一致性修复:个人车绑/解/换常驻→司机侧 primary_vehicle_plate 双向同步 (公司车豁免)。无接口契约变更,前端无需改动;周知点=司机列表「按常驻车牌筛选」 对个人车现在准确。已部署测试服双实例 + API 实测通过。 --- ...车常驻双向同步司机车牌-行为变更-管理后台.md | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 changelogs-v2/2026-06/17_个人车常驻双向同步司机车牌-行为变更-管理后台.md diff --git a/changelogs-v2/2026-06/17_个人车常驻双向同步司机车牌-行为变更-管理后台.md b/changelogs-v2/2026-06/17_个人车常驻双向同步司机车牌-行为变更-管理后台.md new file mode 100644 index 0000000..1cdaee7 --- /dev/null +++ b/changelogs-v2/2026-06/17_个人车常驻双向同步司机车牌-行为变更-管理后台.md @@ -0,0 +1,36 @@ +【行为变更·管理后台】个人车常驻司机绑定 → 司机侧车牌双向同步（仅自有车，公司车豁免） + +> 服务：hl-fleet-service（车务） +> PR：#3929（合并 dev-v3） +> 类型：后端数据一致性修复，**无接口契约变更**（无新端点 / 无入参出参结构变化） +> 前端：**无需改动**，仅行为更准；本条为周知 + +## ⚠️ 关键说明 + +- 车辆侧权威 1:1 = `fleet_vehicle.primary_driver_id`；司机侧 `fleet_driver.primary_vehicle_plate` 是**去规范化展示列**，用于司机列表「常驻车牌」筛选（`GET /admin/fleet/drivers/page?primaryVehiclePlate=`）。 +- 此前个人车绑/解/换常驻时，司机侧这一列**不会跟着更新**，导致「按常驻车牌筛选司机」对个人车可能筛不到 / 筛错。本次补齐双向同步。 +- **仅自有车（ownerType=personal）同步**；**公司车（调配车，非司机自有）一律不同步**，司机侧车牌保持其自有车牌不被公司调配车覆盖。 + +## 1. 变更内容 + +| 场景 | 此前 | 现在 | +|------|------|------| +| 个人车绑定/改绑常驻司机 | 司机侧 `primary_vehicle_plate` 不更新 | 同步为该车车牌 | +| 个人车解绑常驻 / 司机被换到别的车 | 司机侧车牌残留旧值 | 清空（仅当其当前车牌仍等于这台车，避免误清已改指向别处的司机） | +| 同一次编辑同时改车牌 + 换常驻 | —（功能此前不存在） | 老司机按**旧**车牌清、新司机按**新**车牌设 | +| 个人车 → 公司车切换 | — | 清掉原个人车常驻司机的展示车牌 | +| 公司车绑定常驻 | — | **不同步**（豁免） | +| 车辆批量导入 update 重绑个人车常驻 | 不同步 | 同步（与表单编辑同口径） | + +覆盖 6 个绑定触点：新增车辆、车辆编辑、车辆导入 update、删司机解绑、司机侧改绑常驻车（`PUT /admin/fleet/drivers/{driverId}/resident-vehicle`）。 + +## 2. 测试服实测（api.test.1814.love:9443，真 admin token） + +- 绑定个人车 蒙C03E03 → 司机朝克图：`fleet_driver.primary_vehicle_plate = 蒙C03E03` ✓ +- 解绑：司机侧车牌清空 ✓ +- 绑定公司车 蒙C02E02 → 司机：司机侧车牌**保持空**（豁免）✓ +- 单元 + H2 集成测试：875 passed / 0 failed（含 7 个新增场景用例） + +## 3. 前端动作 + +无。司机列表「按常驻车牌筛选」对个人车现在准确，前端无需改造。