test(权限): 三处出口的闸门扫描改成只数可执行行,补超管仍可见公司那一半与剪目录的反向钉

Fix round 1(review-898a8e22..3f0f1064),行为一字未改,只补护栏:
- Important 1:扫描不再数"全文出现 ≥4 次"(1 处定义 + 3 处 javadoc 就凑得满,三处过滤器全删照样绿),
  改成剔注释后的逐口锚点:负向 filter ×2(出口 1 list、出口 2 getUserColumnPermissions)
  + 正向 ×1(出口 3 superAdminOnlyMenuIds),并自带取样集非空自检(约束 #15)。
- Important 2:B2 补超管那一半——getUserColumnPermissions(31L) 必须仍含 109,
  钉住出口 2 的过滤排在超管早返回之后(变异 R9:提到前面就剪掉超管自己的「公司管理」)。
- Important 3:运维合同按 marker 串 GRANT_SUPER_ADMIN_ONLY_STRIPPED 断言,不再是 log.warn。
- Minor 5:字面量正则标注为"字面量依赖、惰性",真护栏改成切片 ensureGrantable 方法体,
  钉"SUPER_ADMIN_ONLY_KEYS 挨着 BusinessException"这一未来作者会写的形状(变异 R13 只有它接得住)。
- Minor 9:新增 B2b 夹具(受控 key 当分组、下面挂两个子页面),变异 R12 连层级查找表一起剪时
  只有它红——叶子夹具接不住这一向。
- Minor 10:变异自证脚本从 git-ignored 的计划目录搬进 backend-java/scripts/(与 n1_scan.py 同处)并纳入跟踪,
  轮次从 8 记加到 13 记,八条硬规矩不变(pristine 重写、只认内存字节还原、CRLF 对齐锚、
  本轮 Tests run 当分母、跑前删旧 surefire 报告、R0 不绿则后面不作数)。
This commit is contained in:
2026-10-04 22:33:34 +08:00
parent 3f0f106447
commit 7557cdb27a
2 changed files with 433 additions and 9 deletions
@@ -26,7 +26,9 @@ import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
import org.apache.ibatis.builder.MapperBuilderAssistant;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
@@ -39,26 +41,42 @@ import org.mockito.ArgumentCaptor;
* 所以断言的是"从可授予集合摘掉 + 提交时剥离",不是"库里删行"。</p>
*
* <p>两支源码扫描是绊线(防"三处出口里少了一处"),但源码文本判不出闸门是真在跑还是被写成
* {@code if (false)},所以同一文件里另按出口补了四支实跑用例(B1、B2、B3 两种操作者各一支),
* 逐个出口正反两面都钉:</p>
* {@code if (false)},所以同一文件里另按出口补了五支实跑用例(B1、B2 含超管那一半、B2b、
* B3 两种操作者各一支),逐个出口正反两面都钉:</p>
* <ul>
* <li>B1 出口 1(授权树 {@code list}):grantableOnly=true 时连超管都拿不到这一项(授不出去),
* grantableOnly=false(菜单管理页)时必须照旧看得到(这一行没被从目录里删掉)。</li>
* <li>B2 出口 2(当前用户有效菜单 {@code getUserColumnPermissions}):非超管历史上被授过也不下发,
* 但它的父分组与同组兄弟页必须原样保留——"顺手剪掉整组"是把用户管理页弄红的经典改法。</li>
* 但它的父分组与同组兄弟页必须原样保留——"顺手剪掉整组"是把用户管理页弄红的经典改法;
* <b>超管那一半反过来钉"这条必须仍然下发"</b>——「公司管理」是超管自己的页面,
* 谁把出口 2 的过滤提到超管早返回之前(变异 R9)就把超管的侧边栏弄没了。</li>
* <li>B2b 出口 2 的另一向:受控 key 挂在<b>分组</b>上时,剪的只能是下发集合、不许是全量目录——
* 目录一被剪,子页面既解析不出父分组、连展开都展开不出来(变异 R12 钉这一条)。</li>
* <li>B3 出口 3(提交授权 {@code updateUserColumnPermissions}):带这条 id 的整树提交必须
* 保存成功(绝不 403,09-16 的形状),只剥掉这一项,其余照常落库,且它绝不进"要删除"集合。</li>
* </ul>
*
* <p>每支扫描都带"取样集非空"自检(全局约束 #15):注释里的 {@code { @link }} 不计入代码锚点,
* 拒绝路径切片必须真截到方法体,否则扫描会因为扫不到东西而恒绿。</p>
*/
class PermissionCompanyMenuHiddenTest {
private static final String SERVICE = "PermissionMenuService.java";
private static final String KEY = "admin_companies";
/** 被三处出口引用的那个常量名(扫描只数落在可执行行上的引用,见 executableCodeLines)。 */
private static final String GUARD_SET = "SUPER_ADMIN_ONLY_KEYS";
/** 出口 1/2 的下发过滤与出口 3 的反解过滤各自锚定的那一行形状。 */
private static final String NEGATIVE_FILTER = "!SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey())";
private static final String POSITIVE_FILTER = "SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey())";
/** 批次 0 上线验收 grep 的就是这个 marker 串(brief Step 6 注脚):运维合同是它,不是 log.warn 这个 API 名。 */
private static final String STRIP_LOG_MARKER = "GRANT_SUPER_ADMIN_ONLY_STRIPPED";
/** 生产实查(2026-10 只读取证):这条菜单行 id=109,父分组 id=98,route_path=account/companies。 */
private static final Long GROUP_ID = 98L;
private static final Long COMPANY_MENU_ID = 109L;
private static final Long SIBLING_PAGE_ID = 110L;
/** B2b 夹具用:受控 key 当分组时挂在它下面的第二个子页面。 */
private static final Long SECOND_CHILD_ID = 111L;
/**
* MyBatis-Plus 的 lambda 列解析要实体的 TableInfo;本类不启动 Spring,而
@@ -85,23 +103,105 @@ class PermissionCompanyMenuHiddenTest {
return text;
}
/**
* 只留**可执行行**:空行、行注释、块注释与 javadoc 续行(以星号开头的那几行)全部剔除,
* 但**保留原始缩进**({@link #methodBody} 要靠 4 空格收尾括号截方法体)。
* 同款过滤见 {@code CompanyReadPathMenuGateTest.java:69-75}。
*
* <p>为什么必须过滤:{@code SUPER_ADMIN_ONLY_KEYS} 在 {@code PermissionMenuService.java} 里出现 7 次,
* 其中 4 次是定义 + 三处 javadoc 链接、只有 3 次是代码。旧的"整份文本出现 ≥4 次"于是
* 把三处过滤器全删掉也照样绿(Important 1)。</p>
*/
private static List<String> executableCodeLines(String text) {
return Arrays.stream(text.replace("\r\n", "\n").split("\n", -1))
.filter(line -> !line.isBlank())
.filter(line -> {
String trimmed = line.trim();
return !trimmed.startsWith("//") && !trimmed.startsWith("/*") && !trimmed.startsWith("*");
})
.collect(Collectors.toList());
}
/**
* 从"注释已剔除、缩进仍保留"的代码文本里截出一个方法的正文:签名起始处到它那一列的收尾
* {@code \}}(4 空格 + 右大括号)为止。截不到就直接红,不许静默返回空串让上面的正则恒绿。
*/
private static String methodBody(String code, String signature) {
int from = code.indexOf(signature);
assertThat(from)
.as("扫描取样集非空自检: 代码里没扫到方法签名 " + signature + ",切片断言无从谈起")
.isNotNegative();
assertThat(code.lastIndexOf(signature))
.as("扫描取样唯一: " + signature + " 出现了两处以上,切片会截错")
.isEqualTo(from);
int end = code.indexOf("\n }", from);
assertThat(end)
.as("扫描取样集非空自检: " + signature + " 的方法体没截到收尾括号")
.isGreaterThan(from);
return code.substring(from, end);
}
@Test
void threeExitsAllReferenceTheSuperAdminOnlySet() throws IOException {
String text = source();
assertThat(text).contains("SUPER_ADMIN_ONLY_KEYS");
// 三个出口各自都要引用它:漏一个就留一条旁路(授权树能看见 / 当前用户菜单能带出 / 提交能写回)。
assertThat(text.split("SUPER_ADMIN_ONLY_KEYS", -1).length - 1)
.as("SUPER_ADMIN_ONLY_KEYS 至少被引用 4 次(1 次定义 + 3 处出口)")
.isGreaterThanOrEqualTo(4);
List<String> code = executableCodeLines(text);
// 取样集非空自检(全局约束 #15):过滤一旦把整份文件滤空、或根本没在滤注释,下面几条都会假绿。
assertThat(code).as("扫描取样集非空自检: 可执行行一条都没滤出来就等于没扫").isNotEmpty();
// 注释必须真被滤掉了:javadoc 里那三处 SUPER_ADMIN_ONLY_KEYS 链接一旦混进取样集,上面的计数就又回到"数得出但没数代码"。
assertThat(code).as("扫描取样集自检: 注释行必须已被剔除")
.noneMatch(line -> line.contains("{@link") || line.trim().startsWith("*"));
assertThat(code).as("扫描取样集自检: 三处出口都落在 toItemVos/落库这条链上,扫描必须扫得到它")
.filteredOn(line -> line.contains("toItemVos(")).isNotEmpty();
// 三个出口各自都要引用它,而且只数代码:漏一个就留一条旁路(授权树能看见 / 当前用户菜单能带出 / 提交能写回)。
// 旧写法是"SUPER_ADMIN_ONLY_KEYS 在整份文本里出现 ≥4 次",可 1 处定义 + 3 处 javadoc 就凑得满,
// 三处过滤器全删(或移进注释 / if (false) / 死分支)它照样绿 —— 变异 R10 就是这一记。
// 现在逐口钉:负向("不是受控项才留下")= 出口 1(list :99)+ 出口 2(getUserColumnPermissions :356)各一条;
// 正向("是受控项才进剥离集")= 出口 3 的反解(superAdminOnlyMenuIds :1006)一条。
// 将来真要加第四处出口时,连同这三条期望一起改(当前口径:恰三处出口,不许多也不许少)。
List<String> negative = code.stream().filter(line -> line.contains(NEGATIVE_FILTER)).toList();
List<String> positive = code.stream()
.filter(line -> line.contains(POSITIVE_FILTER))
.filter(line -> !line.contains(NEGATIVE_FILTER))
.toList();
assertThat(negative)
.as("出口 1(授权树)+ 出口 2(当前用户菜单)各一条负向过滤,少一条就是一条旁路")
.hasSize(2);
assertThat(positive)
.as("出口 3(提交剥离)的正向反解恰好一条")
.hasSize(1);
assertThat(code.stream().filter(line -> line.contains(GUARD_SET)).toList())
.as("1 处定义 + 3 处出口,全都得落在可执行行上")
.hasSizeGreaterThanOrEqualTo(4);
}
@Test
void grantIsStrippedInsteadOfRejected() throws IOException {
String text = source();
// 整树提交里带一个历史 admin_companies 绝不能 403:那会让"改密码/建号"这条链整体回滚(09-16 的形状)。
// 注:本仓库 AssertJ 无 doesNotContainMatch,这里用等价的 doesNotContainPattern(同为正则不匹配)。
// 注 1:本仓库 AssertJ 无 doesNotContainMatch,这里用等价的 doesNotContainPattern(同为正则不匹配)。
// 注 2(Minor 5,**字面量依赖**、单独看是惰的):这条要 "admin_companies" 这个**字符串**出现在
// ensureGrantable 之后才可能命中;而它在权限模块里只落在常量定义行
// PermissionMenuService.java:56,永远排在 ensureGrantable(:949) 前面 → find() 恒不命中。
// 留着只当"有人把字面量抄进校验里"的次级绊线,真正咬得住的是下面那条按形状钉的。
assertThat(text).doesNotContainPattern("(?s)ensureGrantable[\\s\\S]{0,600}admin_companies[\\s\\S]{0,200}BusinessException");
assertThat(text).contains("log.warn");
// 真护栏钉"未来作者实际会写的形状":把受控集接进**拒绝路径**(命中就抛),
// 于是哪天剥离被摘掉、或库里 109 换了 id,历史授权回传就变 403 —— 变异 R13 验它真会红。
String reject = methodBody(String.join("\n", executableCodeLines(text)), "private void ensureGrantable(");
assertThat(reject)
.as("反向钉取样集非空自检: 拒绝路径里确实有 BusinessException,否则下面那条正则恒绿")
.contains("BusinessException");
assertThat(reject)
.as("ensureGrantable(唯一的越权拒绝路径)里不许出现 " + GUARD_SET + ":剥离必须在出口 3 的入口,剥而不拒")
.doesNotContainPattern("(?s)SUPER_ADMIN_ONLY_KEYS[\\s\\S]{0,400}BusinessException");
// 运维合同是那条 **marker 串**(批次 0 上线验收按它 grep,见 brief Step 6 注脚),不是 log.warn 这个 API 名:
// 改成 log.info、换成别的措辞、或把整行日志挪走,旧断言都还是绿的,而线上就再也 grep 不到这次剥离了。
assertThat(text)
.as("剥离日志的运维合同: marker 串必须逐字留在 PermissionMenuService 里")
.contains(STRIP_LOG_MARKER);
}
// ---------------------------------------------------------------- B1:出口 1(授权树)
@@ -149,6 +249,9 @@ class PermissionCompanyMenuHiddenTest {
* 一旦换成剪过的集合,只勾了子页面的用户({@code includeAncestorGroups=false} 那条路径,
* 父分组不在下发列表里)就解析不出父分组,rootColumnKey 退化成自己、侧边栏再也挂不上组。
* 下面那段 flat 断言钉的就是这一条,变异 R5 验过它真的会红。</p>
*
* <p>末尾还钉着相反的一半(Important 2):<b>超管必须仍然从这个出口拿到这条菜单</b>——
* 过滤排在超管早返回之后是刻意的,提到它前面(变异 R9)就只有超管侧边栏失去「公司管理」。</p>
*/
@Test
void effectiveMenusForNonSuperAdminExcludeLegacyGrantButKeepGroupAndSibling() {
@@ -185,6 +288,61 @@ class PermissionCompanyMenuHiddenTest {
.as("includeAncestorGroups=false 时父分组不在下发列表里,rootColumnKey 仍要能从全量目录解析出来"
+ "(把剪过的集合喂给 toItemVos 的第二个参数就会让它退化成自己,侧边栏再也挂不上分组)")
.containsExactly("admin_account_group");
// 反方向(Important 2):超管必须仍然从这个出口拿到「公司管理」。
// 出口 2 的过滤之所以排在超管早返回**之后**,是因为这条菜单就是超管自己的页面
// (AdminConsoleController 的 /current-user/menus 侧边栏数据源);谁把它提到早返回之前
// (变异 R9),非超管照样剪掉、看着没错,但唯一的合法角色从此在侧边栏失去公司管理。
when(userMapper.selectById(31L)).thenReturn(user(31L, "super_admin", 1));
List<PermissionMenuItemVo> forSuperAdmin = service.getUserColumnPermissions(null, 31L, "admin", true);
assertThat(forSuperAdmin).extracting(PermissionMenuItemVo::getId)
.as("超管仍要看得见「公司管理」:这条剪的是非超管的下发,不是全角色的菜单")
.contains(COMPANY_MENU_ID);
assertThat(forSuperAdmin).extracting(PermissionMenuItemVo::getColumnKey)
.as("超管的 /current-user/menus 里 admin_companies 这个 key 必须在(Task 1 的前端只剪非超管)")
.contains(KEY);
}
// ---------------------------------------------------------------- B2b:出口 2 的另一向(剪下发集,不剪目录)
/**
* 受控 key 挂在<b>分组</b>上时的形状:剪掉的只能是"下发集合",绝不能去剪 {@code toItemVos}
* 的层级查找表 / {@code expandDescendantIds} 用的目录。
*
* <p>今天的 {@code admin_companies} 是叶子(父分组 98 下的 109),所以 B2 那支从"目录是否完好"
* 上取不到证据——把目录剪掉,兄弟页 110 的根仍是 98,什么都不会变(Minor 9)。这里换成
* "受控 key 自己就是分组、下面挂着两个子页面"的夹具:一旦有人连目录一起剪,
* ① {@code expandDescendantIds} 认不出这个分组,子页面整体消失(用户管理页就此空白),
* ② 子页面的 {@code rootColumnKey} 退化成自己,侧边栏挂不上组。变异 R12 钉的就是第 ② 种,
* 它只会让本用例红,B2 那支叶子夹具接不住。</p>
*/
@Test
void effectiveMenusForNonSuperAdminStripRestrictedGroupButKeepItsChildren() {
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(catalogWithRestrictedGroup());
when(userMapper.selectById(7L)).thenReturn(user(7L, "admin", 1));
// 目标身上挂的直接授权就是那个"受控分组"本身(父授权展开成整棵子树的真实形状)
when(permissionMapper.selectByUserId(7L)).thenReturn(List.of(grant(7L, COMPANY_MENU_ID)));
List<PermissionMenuItemVo> items = service.getUserColumnPermissions(null, 7L, "admin", true);
assertThat(items).extracting(PermissionMenuItemVo::getId)
.as("受控分组自身不下发")
.doesNotContain(COMPANY_MENU_ID);
assertThat(items).extracting(PermissionMenuItemVo::getColumnKey)
.as("下发列表里不许出现受控 key")
.doesNotContain(KEY);
assertThat(items).extracting(PermissionMenuItemVo::getId)
.as("它的两个子页面必须照旧下发:剪的是下发集合,不是全量目录——目录一被剪,"
+ "expandDescendantIds 连这个分组都找不到,子页面会整体消失")
.containsExactly(SIBLING_PAGE_ID, SECOND_CHILD_ID);
assertThat(items).extracting(PermissionMenuItemVo::getRootColumnKey)
.as("子页面的父分组仍要从**全量目录**解析出来(根键指回那个受控分组),"
+ "这条就是『不许剪目录』的正向证据")
.containsExactly(KEY, KEY);
}
// ---------------------------------------------------------------- B3:出口 3(提交授权)
@@ -275,6 +433,17 @@ class PermissionCompanyMenuHiddenTest {
menu(SIBLING_PAGE_ID, GROUP_ID, "admin", 10, "admin_user_manage"));
}
/**
* B2b 夹具(非今天的生产形状):受控 key 本身是个<b>分组</b>,下面挂着两个子页面。
* 只有这种形状才把"剪下发集"与"剪目录"这两种改法区分开——叶子夹具里两者等价。
*/
private List<PermissionMenuEntity> catalogWithRestrictedGroup() {
return List.of(
menu(COMPANY_MENU_ID, null, "admin", 8, KEY),
menu(SIBLING_PAGE_ID, COMPANY_MENU_ID, "admin", 9, "admin_user_manage"),
menu(SECOND_CHILD_ID, COMPANY_MENU_ID, "admin", 10, "admin_shop_manage"));
}
private PermissionMenuEntity menu(Long id, Long parentId, String menuType, int sortOrder, String columnKey) {
PermissionMenuEntity entity = new PermissionMenuEntity();
entity.setId(id);