docs: 补充车队菜单层级与删除契约 (#5131)

changelogs-v2/2026-07/5131-fleet-team-management.md

@@ -40,6 +40,7 @@ generated: "2026-07-22T10:46:00+08:00"
 | GET | `/admin/fleet/teams/:fleetTeamId` | 详情；负责人电话返回原值供编辑 |
 | POST | `/admin/fleet/teams` | 新增 |
 | PUT | `/admin/fleet/teams/:fleetTeamId` | 编辑 |
+| DELETE | `/admin/fleet/teams/:fleetTeamId` | 删除；仅名下无车辆且无未完结司机自助录入时允许 |
 | POST | `/admin/fleet/teams/:fleetTeamId/disable` | 停用；仍有在役车辆返回 `601103` |
 | POST | `/admin/fleet/teams/:fleetTeamId/enable` | 启用 |
 
@@ -104,13 +105,16 @@ generated: "2026-07-22T10:46:00+08:00"
 - 实际结算保存新增 `fleetTeamId`；旧 `fleet` 废弃。
 - 后端按车队类型派生 `OWN_COST/COOP_QUOTE`，不再把 `own` 当特殊业务编码。
 
+历史字典迁入的车队可能没有负责人资料。新增、编辑请求中的 `leaderName`、`leaderPhone`、
+`settleType`、`sortOrder` 均为必填；前端编辑存量车队时必须提示车务人员补录真实资料，禁止用占位姓名或虚假电话自动填充。
+
 ## 独立菜单与权限
 
-user-service 新增顶级菜单：
+user-service 在“车务管理”目录下新增子菜单：
 
 - 路由：`/fleet/teams`
 - 组件：`fleet/teams/index`
-- 权限：`fleet:team:list`、`fleet:team:create`、`fleet:team:update`、`fleet:team:status`
+- 权限：`fleet:team:list`、`fleet:team:create`、`fleet:team:update`、`fleet:team:status`、`fleet:team:delete`
 - 默认角色：`SUPER_ADMIN`、`ADMIN`、`VEHICLE_MANAGER`
 
 前端必须新增对应组件，否则菜单发布后会出现空路由。
@@ -119,7 +123,11 @@ user-service 新增顶级菜单：
 
 ### 管理后台
 
-1. 新增 `src/api/fleet/teams.js` 和 `src/views/fleet/teams/index.vue`，完成车队分页、新增、编辑、启停。
+1. 新增 `src/api/fleet/teams.js` 和 `src/views/fleet/teams/index.vue`，完成车队分页、新增、编辑、启停和删除：
+   - “车队管理”必须显示在“车务管理”目录内，不得作为一级菜单处理。
+   - 仅 `vehicleCount === 0` 时展示/启用删除动作；调用删除接口后刷新列表。
+   - 后端仍会独立校验车辆及未完结司机录入关联，返回 `601107` 时提示“请先完成车辆/司机转移”。
+   - 编辑历史迁入车队时补齐负责人、负责人电话、付款方式和排序。
 2. 车辆档案：
    - `src/views/fleet/vehicles/index.vue`
    - `src/views/fleet/vehicles/components/VehicleEditModal.vue`
@@ -173,6 +181,7 @@ DELETE FROM sys_dict_type WHERE dict_type = 'fleet_attribution';
 - 车队已关联车辆后不能切换自有/合作类型，防止历史结算语义漂移。
 - 停用车队不出现在普通下拉；存量车辆编辑可回显当前停用车队，但不能切入其他停用车队。
 - 车队下仍有 `ACTIVE` 车辆时禁止停用，须先转移或停用车辆。
+- 车队只有在名下无车辆、无未完结司机自助录入时才能删除；正式司机通过常驻车辆归属，车辆未转移时删除同样会被拒绝（`601107`）。
 - 停用车队的存量车辆不得恢复在役，也不会进入派车候选或矩阵。
 - 对账保存车队名称、类型和付款方式快照，后续改主档不修改历史账期。
 - 负责人电话属于敏感信息，列表只展示脱敏值，不得写日志或进入前端埋点。
@@ -180,6 +189,8 @@ DELETE FROM sys_dict_type WHERE dict_type = 'fleet_attribution';
 ## 验收清单
 
 - [ ] 独立车队菜单可分页、新增、编辑、启停，付款方式与资源页选项一致。
+- [ ] “车队管理”位于“车务管理”目录下；空车队可删除，非空车队删除入口禁用或明确提示后端 `601107`。
+- [ ] 历史迁入车队可通过编辑补齐负责人、负责人电话、付款方式和排序，保存时不允许提交空资料。
 - [ ] 车辆新增/编辑/筛选/详情/导入均使用动态车队，不再出现固定三项。
 - [ ] 司机 H5 新招、续签和管理端自带车审核均可选择动态车队并正确回显。
 - [ ] 派车候选、矩阵、甘特和对账能展示任意新增车队，颜色和分组稳定。