feat(权限): admin_companies 从可见/可授予集合摘掉,提交时剥离不报错

This commit is contained in:
2026-10-04 20:55:43 +08:00
parent 898a8e2258
commit 5717efac92
2 changed files with 377 additions and 1 deletions
@@ -51,6 +51,10 @@ public class PermissionMenuService {
private static final String IMAGE_VIDEO_DATA_PERMISSION_KEY = "admin_image_video_task_data";
private static final String SHOP_DATA_CRAWL_DATA_PERMISSION_KEY = "admin_shop_data_crawl_task_data";
/** 角色内在闸门菜单:非超管看不见、谁也授不出去(设计文档 §8.1)。
* 与前端 src/config/company-scope.ts 的 SUPER_ADMIN_ONLY_MENU_KEYS 必须同值,由 Task 7 的跨端用例钉住。 */
private static final Set<String> SUPER_ADMIN_ONLY_KEYS = Set.of("admin_companies");
private final PermissionMenuMapper permissionMenuMapper;
private final UserColumnPermissionMapper userColumnPermissionMapper;
private final AdminUserMapper adminUserMapper;
@@ -68,6 +72,8 @@ public class PermissionMenuService {
/**
* @param grantableOnly 授权树语义:非超管只返回自己已持有的菜单,范围外的项不再下发
* (判据与 {@link #ensureGrantable} 同一套 {@link #resolveGrantableMenuIds})。
* 另:{@link #SUPER_ADMIN_ONLY_KEYS} 里的角色内在闸门菜单对**所有角色**(含超管)都不下发,
* 超管在树上拿不到就授不出去;为 false 时全量目录照旧,「菜单管理」页仍能管理这些行。
* 为了让树上仍保留「一级分组 + 子页面」层级,可授予项的祖先分组一并返回,
* 但标成 {@code grantable=false} 让前端置灰——分组自身不在操作者范围内,
* 一旦可勾,「勾父覆盖全部后代」就会把树上未展示的范围外菜单一起授出去。
@@ -84,6 +90,15 @@ public class PermissionMenuService {
.filter(menu -> menu.getId() != null && visibleIds.contains(menu.getId()))
.toList();
}
// 出口 1(授权树):可授予集合里连超管都不含这些项——超管自己都拿不到,才授不出去。
// 必须挂在 grantableOnly 上而不是 grantableIds != null 上:resolveGrantableMenuIds 对超管
// 返回 null(不限制),挂错了条件就等于只挡住了普通管理员,旁路照旧。
// 这里是重新赋值 visibleMenus,绝不能改 menus——它是 toItemVos 的层级/父节点查找表。
if (grantableOnly) {
visibleMenus = visibleMenus.stream()
.filter(menu -> !SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))
.toList();
}
List<PermissionMenuItemVo> items = toItemVos(visibleMenus, menus);
for (PermissionMenuItemVo item : items) {
item.setGrantable(grantableIds == null || grantableIds.contains(item.getId()));
@@ -333,7 +348,14 @@ public class PermissionMenuService {
List<PermissionMenuEntity> effectiveMenus = menus.stream()
.filter(menu -> menu.getId() != null && visibleIds.contains(menu.getId()))
.toList();
return toItemVos(effectiveMenus, menus);
// 出口 2(当前用户有效菜单):非超管即使历史上被授过这些项也不下发(前端拿不到 key,
// 侧边栏与守卫都无从显示)。超管分支在上面已经早返回,侧边栏照旧看得到——Task 1 只剪非超管。
// 只剪"下发列表",喂给 toItemVos 的第二个参数(层级/父节点查找表)必须仍是全量 menus:
// 换成剪过的集合会让只勾了子页面的用户解析不出父分组,等于把「用户管理」一起弄红。
List<PermissionMenuEntity> visibleMenus = effectiveMenus.stream()
.filter(menu -> !SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))
.toList();
return toItemVos(visibleMenus, menus);
}
/** Effective authorization check used by backend callers that need a boolean decision. */
@@ -568,6 +590,8 @@ public class PermissionMenuService {
AdminUserEntity target = getUserById(userId);
ensureTargetAccessible(operator, target);
List<Long> requestedIds = request == null ? List.of() : normalizeColumnIds(request.getColumnIds());
// 出口 3(提交授权):超管专属项在这里被剥掉,越权校验与落库都看不到它(剥而不拒)。
requestedIds = stripSuperAdminOnlyGrantIds(requestedIds, operator);
String normalizedType = menuType == null || menuType.isBlank()
? null
: normalizeMenuTypeRequired(menuType);
@@ -941,6 +965,49 @@ public class PermissionMenuService {
}
}
/**
* 出口 3 的实现:把 {@link #SUPER_ADMIN_ONLY_KEYS} 对应的菜单 id 从提交集合里摘掉。
*
* <p><b>剥离而不是报错</b>:授权树已经不再下发这些项,但目标用户身上可能挂着历史直接授权,
* 前端整树提交会把它原样带回;此时若判越权回滚,「保存权限 / 改密码 / 建号」这条链会整体失败
* (生产 2026-09-16 的形状)。摘掉后其余项照常落库,本次保存成功,只留一条 warn 日志。
*
* <p>剥离不许变成静默改数据:摘掉的 id 因此也进不了「无效菜单」校验(摘在前面),
* 而删除范围只由 {@code scopedMenuIds} ∩ {@code grantableIds} 算出、与提交集合无关
* (见下面 deleteScope 那段),所以既不会被它删掉历史授权行,也不会被新增回来。
* 唯一例外是超管且 menuType 为空的「整树替换」分支:{@code deleteByUserId} 先清空目标整个
* 分区再按提交重插,被剥的这条按既有语义就不会回来——那是该分支本来就有的行为,不是剥离引入的。
*/
private List<Long> stripSuperAdminOnlyGrantIds(List<Long> requestedIds, AdminUserEntity operator) {
if (requestedIds.isEmpty()) {
return requestedIds;
}
Set<Long> restricted = superAdminOnlyMenuIds();
if (restricted.isEmpty()) {
return requestedIds;
}
List<Long> stripped = requestedIds.stream().filter(restricted::contains).toList();
if (stripped.isEmpty()) {
return requestedIds;
}
log.warn("GRANT_SUPER_ADMIN_ONLY_STRIPPED 已剥离超管专属菜单授权 ids={} operatorId={}", stripped,
operator == null ? null : operator.getId());
return requestedIds.stream().filter(id -> !restricted.contains(id)).toList();
}
/**
* {@link #SUPER_ADMIN_ONLY_KEYS} 在库里的菜单 id。
*
* <p>一次全量目录查询折出来,绝不按 id 逐条点查:保存权限这个入口上 N 次点查会被日志放大,
* 而 {@code findDataPermission} 每次都是一个 {@code selectOne}。</p>
*/
private Set<Long> superAdminOnlyMenuIds() {
return loadMenus(null).stream()
.filter(menu -> SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))
.map(PermissionMenuEntity::getId)
.collect(Collectors.toCollection(LinkedHashSet::new));
}
private boolean isAdmin(AdminUserEntity user) {
if (user == null) {
return false;