From c3a5b2cd99144b2e25f6f9978856f929c20fe297 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Wed, 22 Jul 2026 17:47:19 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E8=BD=A6=E9=98=9F?= =?UTF-8?q?=E8=8F=9C=E5=8D=95=E5=B1=82=E7=BA=A7=E4=B8=8E=E5=88=A0=E9=99=A4?= =?UTF-8?q?=E5=A5=91=E7=BA=A6=20(#5131)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../2026-07/5131-fleet-team-management.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/changelogs-v2/2026-07/5131-fleet-team-management.md b/changelogs-v2/2026-07/5131-fleet-team-management.md index 50910c6..e9c17ab 100644 --- a/changelogs-v2/2026-07/5131-fleet-team-management.md +++ b/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 新招、续签和管理端自带车审核均可选择动态车队并正确回显。 - [ ] 派车候选、矩阵、甘特和对账能展示任意新增车队，颜色和分组稳定。