feat(用户授权): 非超管授权树只下发自己可授予的菜单,保存按操作者范围替换

- 授权树读接口新增 grantableOnly:非超管只返回自己已持有的菜单,可授予项的
  祖先分组随行但置灰不可勾;否则勾父会连带授予树上未下发的范围外后代
- 保存的整树替换把删除范围收窄到操作者可授予集,范围外既有授权(超管直接
  分配的)原样保留——隐藏项不在提交里,全类型删除会把它们静默清掉
- 前端提交剔除置灰分组的派生勾选;菜单权限配置页仍走全量目录
This commit is contained in:
2026-09-23 15:56:50 +08:00
parent 9b4a25e8ae
commit 2c47b27746
8 changed files with 203 additions and 48 deletions
@@ -55,9 +55,11 @@ public class PermissionMenuController {
@GetMapping("/permission-menus")
@Operation(summary = "查询菜单权限列表")
public ApiResponse<List<PermissionMenuItemVo>> listMenus(HttpServletRequest request,
@Parameter(description = "菜单类型: app/admin") @RequestParam(required = false) String menuType) {
// 传入操作者:授权树据此把「非超管无权授予」的菜单标记为不可勾选
return ApiResponse.success(permissionMenuService.list(requireAdmin(request), menuType));
@Parameter(description = "菜单类型: app/admin") @RequestParam(required = false) String menuType,
@Parameter(description = "授权树语义: true 时非超管只返回自己可授予的菜单")
@RequestParam(required = false, defaultValue = "false") boolean grantableOnly) {
// 传入操作者:授权树据此只下发(并把范围外节点标成不可勾选)操作者有权授予的菜单
return ApiResponse.success(permissionMenuService.list(requireAdmin(request), menuType, grantableOnly));
}
@PostMapping("/permission-menus")
@@ -57,19 +57,34 @@ public class PermissionMenuService {
/** Returns the flat menu catalog, including each item's direct parent ID. */
public List<PermissionMenuItemVo> list(String menuType) {
return list(null, menuType);
return list(null, menuType, false);
}
/** 菜单目录(菜单权限配置页):全量下发,只按操作者标记 grantable。 */
public List<PermissionMenuItemVo> list(AdminUserEntity operator, String menuType) {
return list(operator, menuType, false);
}
/**
* 授权树用:非超管只能授予自己已持有的菜单(与 {@link #ensureGrantable} 同一判据),
* 这里把结论标进 {@code grantable},让前端把不可授予的节点置灰,避免「勾了才在保存时
* 整单被 403 回滚」——创建用户与保存权限共用这一棵树,勾到一个越权项会连建号一起失败。
* operator 为空或超管时不限制。
* @param grantableOnly 授权树语义:非超管只返回自己已持有的菜单,范围外的项不再下发
* (判据与 {@link #ensureGrantable} 同一套 {@link #resolveGrantableMenuIds})。
* 为了让树上仍保留「一级分组 + 子页面」层级,可授予项的祖先分组一并返回,
* 但标成 {@code grantable=false} 让前端置灰——分组自身不在操作者范围内,
* 一旦可勾,「勾父覆盖全部后代」就会把树上未展示的范围外菜单一起授出去。
* 保存侧必须配套按操作者范围替换,见
* {@link #updateUserColumnPermissions(AdminUserEntity, Long, UserColumnPermissionUpdateRequest, String, boolean)}。
*/
public List<PermissionMenuItemVo> list(AdminUserEntity operator, String menuType) {
public List<PermissionMenuItemVo> list(AdminUserEntity operator, String menuType, boolean grantableOnly) {
List<PermissionMenuEntity> menus = loadMenus(menuType);
List<PermissionMenuItemVo> items = toItemVos(menus, menus);
Set<Long> grantableIds = resolveGrantableMenuIds(operator);
List<PermissionMenuEntity> visibleMenus = menus;
if (grantableOnly && grantableIds != null) {
Set<Long> visibleIds = includeAncestorIds(grantableIds, menus);
visibleMenus = menus.stream()
.filter(menu -> menu.getId() != null && visibleIds.contains(menu.getId()))
.toList();
}
List<PermissionMenuItemVo> items = toItemVos(visibleMenus, menus);
for (PermissionMenuItemVo item : items) {
item.setGrantable(grantableIds == null || grantableIds.contains(item.getId()));
}
@@ -497,7 +512,7 @@ public class PermissionMenuService {
/**
* Replaces direct grants. A non-super admin may only grant effective menus
* that the operator already has, and only to themself or a directly-created
* normal user.
* normal user. Grants outside the operator's set are left untouched.
*/
@Transactional
public void updateUserColumnPermissions(AdminUserEntity operator,
@@ -506,7 +521,10 @@ public class PermissionMenuService {
updateUserColumnPermissions(operator, userId, request, null);
}
/** Replaces direct grants only within menuType; a blank type keeps legacy full-replacement behavior. */
/**
* Replaces direct grants only within menuType; a blank type replaces every type.
* For a non-super admin both cases narrow to the operator's grantable set.
*/
@Transactional
public void updateUserColumnPermissions(AdminUserEntity operator,
Long userId,
@@ -533,6 +551,7 @@ public class PermissionMenuService {
String normalizedType = menuType == null || menuType.isBlank()
? null
: normalizeMenuTypeRequired(menuType);
Set<Long> grantableIds = resolveGrantableMenuIds(operator);
Set<Long> scopedMenuIds = new LinkedHashSet<>();
if (normalizedType == null) {
if (!requestedIds.isEmpty()) {
@@ -570,7 +589,7 @@ public class PermissionMenuService {
.filter(id -> !protectedIds.contains(id))
.toList();
}
ensureGrantable(operator, grantIds, userId);
ensureGrantable(operator, grantIds, userId, grantableIds);
LinkedHashSet<Long> finalGrantIds = new LinkedHashSet<>(grantIds);
if (!protectedIds.isEmpty()) {
@@ -582,10 +601,23 @@ public class PermissionMenuService {
}
}
if (normalizedType == null) {
// 「整树替换」的替换范围要跟着授权树的可见范围收窄:非超管的授权树已不再下发
// 自己范围外的菜单(见 list(operator, menuType, true)),这些既有授权(通常由超管
// 直接分配)不会出现在提交里,按全类型删除等于把它们静默清掉——与 09-13
// 「权限自己没掉」、09-16「整单 403」是同一类事故。范围外项保持原样,
// 既不会被本次保存删除,也不会被新增(新增越权仍由 ensureGrantable 拒绝)。
Set<Long> deleteScope = normalizedType == null ? null : scopedMenuIds;
if (grantableIds != null) {
deleteScope = deleteScope == null
? new LinkedHashSet<>(grantableIds)
: deleteScope.stream()
.filter(grantableIds::contains)
.collect(Collectors.toCollection(LinkedHashSet::new));
}
if (deleteScope == null) {
userColumnPermissionMapper.deleteByUserId(userId);
} else if (!scopedMenuIds.isEmpty()) {
userColumnPermissionMapper.deleteByUserIdAndColumnIds(userId, new ArrayList<>(scopedMenuIds));
} else if (!deleteScope.isEmpty()) {
userColumnPermissionMapper.deleteByUserIdAndColumnIds(userId, new ArrayList<>(deleteScope));
}
for (Long columnId : finalGrantIds) {
UserColumnPermissionEntity entity = new UserColumnPermissionEntity();
@@ -867,13 +899,16 @@ public class PermissionMenuService {
* 编辑该用户时整树提交会把它原样带回,若一并判为越权,整笔事务会回滚——连建号、改密
* 都做不成(生产 2026-09-16 现象:勾到一个越权项,创建用户与保存权限双双失败)。
* 只放行「保留已有」不放行「新增」,因此不构成提权。
*
* @param grantableIds 调用方算好的操作者可授予全集,null 表示不限制
*/
private void ensureGrantable(AdminUserEntity operator, List<Long> requestedIds, Long targetUserId) {
private void ensureGrantable(AdminUserEntity operator, List<Long> requestedIds, Long targetUserId,
Set<Long> grantableIds) {
if (operator == null || isSuperAdmin(operator)) {
return;
}
// 操作者自身 id 缺失(异常数据)时按「无任何可授予项」从严处理,不放行
Set<Long> effective = Objects.requireNonNullElse(resolveGrantableMenuIds(operator), Set.of());
Set<Long> effective = Objects.requireNonNullElse(grantableIds, Set.of());
Set<Long> keptIds = targetUserId == null
? Set.of()
: new LinkedHashSet<>(loadDirectColumnIds(targetUserId));
@@ -126,12 +126,12 @@ class PermissionMenuControllerTest {
when(request.getHeader("X-Internal-Token")).thenReturn("shared-token");
when(request.getParameter("operatorId")).thenReturn("12");
when(service.requireAdminOperator(12L)).thenReturn(operator);
when(service.list(operator, "app")).thenReturn(List.of());
when(service.list(operator, "app", false)).thenReturn(List.of());
controller.listMenus(request, "app");
controller.listMenus(request, "app", false);
verify(service).requireAdminOperator(12L);
verify(service).list(operator, "app");
verify(service).list(operator, "app", false);
verify(request, never()).getParameter("superAdmin");
}
@@ -147,10 +147,10 @@ class PermissionMenuControllerTest {
when(authSupport.requireAdmin(request)).thenThrow(authFailure);
when(request.getHeader("X-Internal-Token")).thenReturn("wrong-token");
assertThatThrownBy(() -> controller.listMenus(request, "app"))
assertThatThrownBy(() -> controller.listMenus(request, "app", false))
.isSameAs(authFailure);
verify(service, never()).requireAdminOperator(anyLong());
verify(service, never()).list(any(AdminUserEntity.class), eq("app"));
verify(service, never()).list(any(AdminUserEntity.class), eq("app"), eq(false));
}
@Test
@@ -171,12 +171,12 @@ class PermissionMenuControllerTest {
when(request.getHeader("X-Internal-Token")).thenReturn("file-token");
when(request.getParameter("operatorId")).thenReturn("12");
when(service.requireAdminOperator(12L)).thenReturn(operator);
when(service.list(operator, "admin")).thenReturn(List.of());
when(service.list(operator, "admin", false)).thenReturn(List.of());
controller.listMenus(request, "admin");
controller.listMenus(request, "admin", false);
verify(service).requireAdminOperator(12L);
verify(service).list(operator, "admin");
verify(service).list(operator, "admin", false);
}
@Test
@@ -194,7 +194,7 @@ class PermissionMenuControllerTest {
when(request.getRemoteAddr()).thenReturn("127.0.0.1");
when(request.getParameter("operatorId")).thenReturn("12");
assertThatThrownBy(() -> controller.listMenus(request, "admin"))
assertThatThrownBy(() -> controller.listMenus(request, "admin", false))
.isSameAs(authFailure);
verify(service, never()).requireAdminOperator(anyLong());
verify(service, never()).list("admin");
@@ -216,7 +216,7 @@ class PermissionMenuControllerTest {
when(request.getHeader("X-Internal-Token")).thenReturn("file-token");
when(request.getParameter("operatorId")).thenReturn("12");
assertThatThrownBy(() -> controller.listMenus(request, "admin"))
assertThatThrownBy(() -> controller.listMenus(request, "admin", false))
.isSameAs(authFailure);
verify(service, never()).requireAdminOperator(anyLong());
verify(service, never()).list("admin");
@@ -27,6 +27,7 @@ import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.assertThatThrownBy;
import static org.assertj.core.api.Assertions.tuple;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.argThat;
import static org.mockito.ArgumentMatchers.eq;
import static org.mockito.Mockito.mock;
import static org.mockito.Mockito.never;
@@ -472,9 +473,12 @@ class PermissionMenuServiceTest {
}
@Test
void ordinaryAdminReplacementRemovesDirectGrantsOutsideOwnEffectiveScope() {
// 管理员权限被回收后,其名下员工超出管理员范围的直接授权必须一并移除,
// 否则回收了管理员的菜单权限,员工权限却还在(也永远删不掉)。
void nonSuperAdminSaveLeavesGrantsOutsideOwnScopeUntouched() {
// 授权树对非超管只下发自己可授予的菜单(list(..., true)),范围外的既有授权
// (由超管直接分配给该员工)不会出现在提交里。整树替换的范围必须跟着收窄,
// 否则一次保存就把它们静默清掉——与 09-13「权限自己没掉」同类。
// 回收路径不受影响:超管回收管理员的菜单时由 cascadeCleanupSubordinateOverreach
// 清掉其名下员工的越权项,见 adminPermissionRevocationCascadesToCreatedSubordinates。
PermissionMenuMapper menuMapper = mock(PermissionMenuMapper.class);
UserColumnPermissionMapper permissionMapper = mock(UserColumnPermissionMapper.class);
AdminUserMapper userMapper = mock(AdminUserMapper.class);
@@ -502,6 +506,37 @@ class PermissionMenuServiceTest {
assertThat(inserted.getAllValues())
.extracting(UserColumnPermissionEntity::getColumnId)
.containsExactly(1L);
// 只删自己范围内的项(1),员工超管的既有授权 2 原样保留
verify(permissionMapper).deleteByUserIdAndColumnIds(20L, List.of(1L));
verify(permissionMapper, never()).deleteByUserId(any());
verify(permissionMapper, never()).deleteByUserIdAndColumnIds(eq(20L), argThat(ids -> ids.contains(2L)));
}
@Test
void superAdminSaveStillReplacesWholePartition() {
// 超管不受范围收窄影响:未提交的授权按整树替换语义移除。
PermissionMenuMapper menuMapper = mock(PermissionMenuMapper.class);
UserColumnPermissionMapper permissionMapper = mock(UserColumnPermissionMapper.class);
AdminUserMapper userMapper = mock(AdminUserMapper.class);
PermissionMenuService service = new PermissionMenuService(menuMapper, permissionMapper, userMapper);
AdminUserEntity operator = user(1L, "super_admin", 1);
AdminUserEntity target = user(20L, "normal", 0);
target.setCreatedById(10L);
when(userMapper.selectById(20L)).thenReturn(target);
when(menuMapper.selectCount(any())).thenReturn(1L);
when(menuMapper.selectOne(any())).thenReturn(null);
when(menuMapper.selectList(any())).thenReturn(List.of(
menu(1L, null, "app", 1),
menu(2L, null, "app", 2)));
when(permissionMapper.selectByUserId(any())).thenReturn(List.of(grant(20L, 2L)));
UserColumnPermissionUpdateRequest request = new UserColumnPermissionUpdateRequest();
request.setColumnIds(List.of(1L));
service.updateUserColumnPermissions(operator, 20L, request);
verify(permissionMapper).deleteByUserId(20L);
verify(permissionMapper, never()).deleteByUserIdAndColumnIds(any(), any());
}
@Test
@@ -1209,6 +1244,47 @@ class PermissionMenuServiceTest {
verify(permissionMapper, never()).selectByUserId(any());
}
/**
* 授权树语义(grantableOnly=true):范围外的菜单根本不下发,只保留可授予项以及
* 为还原层级带上的祖先分组,分组自身标 grantable=false 让前端置灰不可勾。
*/
@Test
void listGrantableOnlyHidesMenusOutsideOperatorSetButKeepsDisabledAncestors() {
PermissionMenuMapper menuMapper = mock(PermissionMenuMapper.class);
UserColumnPermissionMapper permissionMapper = mock(UserColumnPermissionMapper.class);
AdminUserMapper userMapper = mock(AdminUserMapper.class);
PermissionMenuService service = new PermissionMenuService(menuMapper, permissionMapper, userMapper);
when(menuMapper.selectList(any())).thenReturn(List.of(
menu(1L, null, "admin", 1), // 一级分组:操作者并未持有,只是 2 的父级
menu(2L, 1L, "admin", 2), // 操作者持有的子菜单
menu(3L, null, "admin", 3), // 范围外
menu(4L, 3L, "admin", 4))); // 范围外分组的子菜单
when(permissionMapper.selectByUserId(30L)).thenReturn(List.of(grant(30L, 2L)));
List<PermissionMenuItemVo> items = service.list(user(30L, "admin", 1), "admin", true);
assertThat(items)
.extracting(PermissionMenuItemVo::getId, PermissionMenuItemVo::getGrantable)
.containsExactlyInAnyOrder(tuple(1L, false), tuple(2L, true));
}
/** 超管的授权树不受过滤影响,仍拿到全量目录且全部可授予。 */
@Test
void listGrantableOnlyKeepsFullCatalogForSuperAdmin() {
PermissionMenuMapper menuMapper = mock(PermissionMenuMapper.class);
UserColumnPermissionMapper permissionMapper = mock(UserColumnPermissionMapper.class);
AdminUserMapper userMapper = mock(AdminUserMapper.class);
PermissionMenuService service = new PermissionMenuService(menuMapper, permissionMapper, userMapper);
when(menuMapper.selectList(any())).thenReturn(List.of(
menu(1L, null, "admin", 1),
menu(3L, null, "admin", 3)));
List<PermissionMenuItemVo> items = service.list(user(31L, "super_admin", 1), "admin", true);
assertThat(items).extracting(PermissionMenuItemVo::getId).containsExactly(1L, 3L);
assertThat(items).extracting(PermissionMenuItemVo::getGrantable).containsOnly(true);
}
/**
* 目标用户已持有的授权(通常由超管分配)不参与「只能授自己已有的」校验:
* 普通管理员编辑该用户时整树提交会把它原样带回,若一并判为越权,整笔事务回滚,