4.2 KiB
4.2 KiB
执行编辑删除权限口径 - 设计 spec
- 日期：2026-07-07
- 范围：
rdms-project项目对象域下执行编辑、执行删除、执行删除预检 - 状态：已与用户确认设计，待 review 后写实现 plan
1. 背景
任务侧已经采用“业务身份命中直接放行，未命中再回落对象域权限码”的兼容口径。执行侧当前仍主要依赖 @CheckObjectPermission(permission = project:execution:update/delete)，导致执行负责人如果没有对象域权限码，可能无法编辑或删除自己负责的执行。
用户确认执行侧应采用类似任务侧的裁决方式：项目负责人、执行负责人可直接操作；管理员仍走对象域权限码兜底；项目创建者不作为天然放行身份。
2. 权限口径
执行编辑、执行删除、执行删除预检的后端最终放行条件：
| 操作 | 业务身份直接放行 | 权限码兜底 |
|---|---|---|
| 编辑执行 | 项目负责人、执行负责人 | project:execution:update |
| 删除执行 | 项目负责人、执行负责人 | project:execution:delete |
| 删除预检 | 项目负责人、执行负责人 | project:execution:delete |
不放行的身份：
- 项目创建者：只作为审计来源，不代表当前管理责任。
- 执行协办人：参与执行，不代表可管理执行主数据。
- 普通项目成员：除非其对象域角色拥有对应权限码。
这里的“管理员”不是全局超级管理员短路，而是项目对象域内拥有对应权限码的管理员型角色。当前对象域写权限不引入超管无条件绕过。
3. 后端设计
执行侧新增一个私有授权方法，语义与任务侧 requireTaskEditDeletePermission 对齐，但参与身份更少：
- 加载项目与执行。
- 组装候选负责人：
project.managerUserId、execution.ownerId。 - 调用
ProjectObjectAuthorizationService.checkAnyOwnerOrProjectPermission(projectId, ownerUserIds, permission)。 - 命中任一负责人直接返回；否则由
ProjectObjectPermissionService.checkPermission校验对象域权限码。
为了让“执行负责人但无权限码”的用户能进入方法体，执行编辑、执行删除、执行删除预检方法上的 @CheckObjectPermission(permission = ...) 不能继续作为前置拦截；这些入口改由方法内部统一裁决。
保持不变：
- 创建执行仍走
project:execution:create。 - 换执行负责人仍走项目层管理权限，不给执行负责人天然放权。
- 执行状态动作
complete/cancel/pause/resume仍保持执行负责人独占，不纳入本次编辑/删除口径。 - 删除的业务规则不变：已完成执行禁删，非 completed 状态允许删除；删除预检仍不能被无权限用户用于探测下挂任务数量。
4. 前端联调口径
前端按钮展示建议：
- 编辑执行：
currentProject.managerUserId === currentUserId || execution.ownerId === currentUserId || hasPermission('project:execution:update') - 删除执行 / 删除预检：
currentProject.managerUserId === currentUserId || execution.ownerId === currentUserId || hasPermission('project:execution:delete')
后端仍是最终裁决。前端不需要识别项目创建者，也不需要把执行协办人作为执行编辑/删除按钮依据。
5. 测试与验证
优先补单测覆盖：
- 项目负责人可编辑执行，无需
project:execution:update。 - 执行负责人可编辑执行，无需
project:execution:update。 - 普通成员无
project:execution:update时编辑被拒。 - 拥有
project:execution:update的对象域角色可编辑执行。 - 执行负责人可删除预检和删除执行，无需
project:execution:delete。 - 普通成员无
project:execution:delete时删除预检和删除均被拒。
静态检查：
- 执行编辑、删除、删除预检不再由方法注解提前拦截权限码。
- 权限裁决落在 service 层，仍属于项目对象域通道。
- 不新增菜单、角色、权限码或数据库结构。
运行验证需用户同意后执行 Maven 测试命令。
6. 数据与 SQL
本次是纯代码权限裁决调整，不涉及表结构、字典、菜单、角色或权限码种子变更。无需演示库 SQL 补丁。