fix(角色叫法): 管理员就叫管理员、normal 档统一「普通账号」

同一角色此前有两套叫法:admin 档在界面叫「管理员」、在后端 6 条 403 与 Swagger 说明里叫
「普通管理员」;normal 档在界面叫「普通用户」。清到第四轮才清净,所以把口径做进源码出口:
新增 task-048 的旧词扫描用例,两棵源码树(admin-frontend-vue/src 216 文件、
backend-java/src 1415 java 文件)里出现「普通管理员」「普通用户」即红,分母与出口文件成员
一起钉死,防"扫了个空集合"式假绿。

- 后端 6 条用户可见文案:PermissionMenuService 两判、ShopManageGroupService 一判、
  ShopManageController 三条 @Operation 说明
- company_menu_grant_gate_mutation.py 的 DENIED_THROW 锚同步改,16 条锚命中数逐条复算=1
- 注释与 javadoc 同批收口(等长替换不动排版);NotificationControllerTest 那句讲的是
  非后台账号,按本意改写而不是套「普通账号」
This commit is contained in:
2026-10-05 23:15:57 +08:00
parent c2994b80b0
commit 0e6e844929
17 changed files with 105 additions and 34 deletions
@@ -92,7 +92,7 @@ public class PermissionMenuService {
}
// 出口 1(授权树):可授予集合里连超管都不含这些项——超管自己都拿不到,才授不出去。
// 必须挂在 grantableOnly 上而不是 grantableIds != null 上:resolveGrantableMenuIds 对超管
// 返回 null(不限制),挂错了条件就等于只挡住了普通管理员,旁路照旧。
// 返回 null(不限制),挂错了条件就等于只挡住了管理员,旁路照旧。
// 这里是重新赋值 visibleMenus,绝不能改 menus——它是 toItemVos 的层级/父节点查找表。
if (grantableOnly) {
visibleMenus = visibleMenus.stream()
@@ -707,7 +707,7 @@ public class PermissionMenuService {
* 镜像 V84 惯例(已获「店铺数据任务管理」菜单的用户自动获得初始数据查看授权):
* admin 分区授权更新后,若**有效授权**包含店铺数据相关菜单(任务管理/重复检查,
* 含经一级分组「店铺管理」展开覆盖的情形),自动补上内部数据权限
* admin_shop_data_crawl_task_data,避免普通管理员已勾了菜单仍提示
* admin_shop_data_crawl_task_data,避免管理员已勾了菜单仍提示
* “无权查看店铺数据任务”。
* 只增不删:数据授权的回收仍走超管专用的「数据范围授权」UI。
*/
@@ -744,7 +744,7 @@ public class PermissionMenuService {
}
/**
* 删除普通管理员直接创建的员工中,超出该管理员当前有效权限范围的授权。
* 删除管理员直接创建的员工中,超出该管理员当前有效权限范围的授权。
* 只清理越权项,保留员工合法持有的其他授权。超级管理员无此限制。
*
* <p>有效集按目标的<b>完整</b>直接授权(读库,含 admin/app 全类型)计算:
@@ -945,7 +945,7 @@ public class PermissionMenuService {
throw new BusinessException(403, "需要管理员权限");
}
if ("company_super_admin".equals(normalizeRole(operator.getRole()))) {
// 公司超管:本公司管理员/普通用户都可授;同公司的公司超管与站点超管碰不得
// 公司超管:本公司管理员/普通账号都可授;同公司的公司超管与站点超管碰不得
String targetRole = normalizeRole(target.getRole());
if ("company_super_admin".equals(targetRole) || "super_admin".equals(targetRole)) {
throw new BusinessException(403, "只有超级管理员可以修改公司超级管理员");
@@ -960,14 +960,14 @@ public class PermissionMenuService {
&& operator.getId() != null
&& operator.getId().equals(target.getCreatedById());
if (!ownedNormal) {
throw new BusinessException(403, "普通管理员只能管理自己创建的普通账号");
throw new BusinessException(403, "管理员只能管理自己创建的普通账号");
}
}
/**
* Throws 403 when a non-super admin **新增** grants outside their own effective set.
*
* <p>目标用户已持有的直接授权不参与校验:那是既有事实(通常由超管分配),普通管理员
* <p>目标用户已持有的直接授权不参与校验:那是既有事实(通常由超管分配),管理员
* 编辑该用户时整树提交会把它原样带回,若一并判为越权,整笔事务会回滚——连建号、改密
* 都做不成(生产 2026-09-16 现象:勾到一个越权项,创建用户与保存权限双双失败)。
* 只放行「保留已有」不放行「新增」,因此不构成提权。
@@ -989,7 +989,7 @@ public class PermissionMenuService {
.filter(id -> !effective.contains(id))
.collect(Collectors.toCollection(LinkedHashSet::new));
if (!denied.isEmpty()) {
throw new BusinessException(403, "普通管理员只能分配自己已有的菜单权限");
throw new BusinessException(403, "管理员只能分配自己已有的菜单权限");
}
}
@@ -1042,7 +1042,7 @@ public class PermissionMenuService {
}
String role = normalizeRole(user.getRole());
if (!role.isEmpty()) {
// company_super_admin 也是授权链上的一级主管(可给本公司的管理员/普通用户授权)
// company_super_admin 也是授权链上的一级主管(可给本公司的管理员/普通账号授权)
return "super_admin".equals(role) || "admin".equals(role) || "company_super_admin".equals(role);
}
return Integer.valueOf(1).equals(user.getIsAdmin());