一人多车,数据源

docs/DriverVehicleBindingApi.md

@@ -6,12 +6,13 @@
 
 1. 三检流程未完成时，禁止进行车辆换绑操作。
 2. 三检流程未完成时，禁止新增出车检查。
-3. 新增查询接口：返回指定驾驶员已绑定车辆列表，以及所在公司仍可绑定的车辆列表。
-4. 新增查询接口：仅返回指定驾驶员已绑定车辆列表。
-5. 新增覆盖式批量绑定接口：前端传驾驶员ID和车辆ID串，后端先清空该驾驶员原有绑定，再绑定最新车辆列表。
-6. 新增追加式批量绑定接口：前端传驾驶员ID和车辆ID串，后端保留该驾驶员已有绑定，仅追加绑定新车辆。
-7. 驾驶员表保留单值字段 `vehicleId` 作为默认车辆ID。
-8. 驾驶员表新增字段 `vehicleIds`，用于存储已绑定车辆ID集合，多个以英文逗号分隔。
+3. 新增驾驶员自助切换默认车辆接口，允许当前登录驾驶员在自己已绑定车辆之间切换 `vehicleId`。
+4. 新增查询接口：返回指定驾驶员已绑定车辆列表，以及所在公司仍可绑定的车辆列表。
+5. 新增查询接口：仅返回指定驾驶员已绑定车辆列表。
+6. 新增覆盖式批量绑定接口：前端传驾驶员ID和车辆ID串，后端先清空该驾驶员原有绑定，再绑定最新车辆列表。
+7. 新增追加式批量绑定接口：前端传驾驶员ID和车辆ID串，后端保留该驾驶员已有绑定，仅追加绑定新车辆。
+8. 驾驶员表保留单值字段 `vehicleId` 作为默认车辆ID。
+9. 驾驶员表新增字段 `vehicleIds`，用于存储已绑定车辆ID集合，多个以英文逗号分隔。
 
 ## 2. 三检限制规则
 
@@ -25,7 +26,18 @@
 - 提示文案：
   - `当前车辆三检流程未完成，不可进行换绑操作`
 
-### 2.2 新增出车检查限制
+### 2.2 默认车辆切换限制
+
+- 生效范围：
+  - 当前登录驾驶员调用默认车辆切换接口时
+- 限制规则：
+  - 仅允许切换到当前驾驶员自己已绑定的车辆
+  - 切换前要求当前默认车辆对应三检流程已完成
+- 提示文案：
+  - 非本人车辆：`驾驶员只能切换属于自己的车辆`
+  - 当前车未完成三检：`当前车辆三检流程未完成，不可切换车辆`
+
+### 2.3 新增出车检查限制
 
 - 生效范围：
   - 新增车辆进出场检查接口
@@ -34,7 +46,7 @@
 - 提示文案：
   - `当前车辆三检流程未完成，不能新增出车检查`
 
-### 2.3 未完成三检流程判定
+### 2.4 未完成三检流程判定
 
 - 判定口径：
   - 查询车辆最新一条三检记录
@@ -140,10 +152,48 @@
 - `currentDriverName`：当前绑定驾驶员姓名
 - `vehicleType`：车辆类型
 
-## 6. 驾驶员追加批量绑定车辆接口
+## 6. 驾驶员切换默认车辆接口
 
 ### 6.1 接口信息
 
+- 路径：`POST /driverManagement/driver/switchVehicle`
+- 说明：当前登录驾驶员自助切换默认车辆
+
+### 6.2 请求体
+
+```json
+{
+  "vehicleId": "1002"
+}
+```
+
+### 6.3 参数说明
+
+- `vehicleId`：必填，目标车辆ID
+
+### 6.4 业务规则
+
+接口执行过程如下：
+
+1. 仅允许驾驶员端已登录用户调用。
+2. 根据当前登录信息获取驾驶员，不允许前端指定其他 `driverId`。
+3. 校验目标 `vehicleId` 必须存在于当前驾驶员的 `vehicleIds` 中。
+4. 校验目标车辆当前 `currentDriver` 仍然包含当前驾驶员，防止脏数据误切换。
+5. 若切换前当前默认车辆存在未完成三检流程，则禁止切换。
+6. 切换成功后仅更新驾驶员表中的：
+   - `vehicleId`：切换后的默认车辆ID
+   - `plateNumber`：切换后默认车辆对应车牌号
+7. `vehicleIds` 不变，车辆表 `currentDriver` 不变。
+
+### 6.5 返回结果
+
+- 成功：返回通用成功响应
+- 失败：抛出业务异常并返回对应提示
+
+## 7. 驾驶员追加批量绑定车辆接口
+
+### 7.1 接口信息
+
 - 路径：`POST /driverManagement/driver/appendBindVehicles`
 - 请求体：
 
@@ -154,7 +204,7 @@
 }
 ```
 
-### 6.2 业务规则
+### 7.2 业务规则
 
 接口执行过程如下：
 
@@ -169,9 +219,9 @@
    - `vehicleIds`
    - `plateNumber`
 
-## 7. 驾驶员解除绑定接口
+## 8. 驾驶员解除绑定接口
 
-### 7.1 接口信息
+### 8.1 接口信息
 
 - 路径：`POST /driverManagement/driver/unbindVehicles`
 - 请求体：
@@ -183,7 +233,7 @@
 }
 ```
 
-### 7.2 参数说明
+### 8.2 参数说明
 
 - `driverId`：必填，驾驶员ID
 - `vehicleIds`：
@@ -192,7 +242,7 @@
   - 为空时表示清空该驾驶员当前全部绑定车辆
   - 有值时表示仅解绑指定车辆
 
-### 7.3 业务规则
+### 8.3 业务规则
 
 接口执行过程如下：
 
@@ -207,7 +257,7 @@
    - `vehicleIds`
    - `plateNumber`
 
-## 8. 绑定模型说明
+## 9. 绑定模型说明
 
 - 当前车辆表实际是一车单人绑定，`currentDriver` 仅保留单个驾驶员ID。
 - 驾驶员表支持一个驾驶员绑定多辆车：
@@ -219,7 +269,7 @@
   - 驾驶员侧允许关联多辆车
   - 移动端与司机端默认取 `vehicleId` 作为当前车辆
 
-## 9. 数据库脚本
+## 10. 数据库脚本
 
 - 脚本文件：`sql/alter_hot_driver_vehicle_ids_20260522.sql`
 - 脚本内容：