From 7557cdb27a1898b9a08e6d4b83ca3a7d6e9fbd49 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com>
Date: Sun, 4 Oct 2026 22:33:34 +0800
Subject: [PATCH] =?UTF-8?q?test(=E6=9D=83=E9=99=90):=20=E4=B8=89=E5=A4=84?=
=?UTF-8?q?=E5=87=BA=E5=8F=A3=E7=9A=84=E9=97=B8=E9=97=A8=E6=89=AB=E6=8F=8F?=
=?UTF-8?q?=E6=94=B9=E6=88=90=E5=8F=AA=E6=95=B0=E5=8F=AF=E6=89=A7=E8=A1=8C?=
=?UTF-8?q?=E8=A1=8C,=E8=A1=A5=E8=B6=85=E7=AE=A1=E4=BB=8D=E5=8F=AF?=
=?UTF-8?q?=E8=A7=81=E5=85=AC=E5=8F=B8=E9=82=A3=E4=B8=80=E5=8D=8A=E4=B8=8E?=
=?UTF-8?q?=E5=89=AA=E7=9B=AE=E5=BD=95=E7=9A=84=E5=8F=8D=E5=90=91=E9=92=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
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 不绿则后面不作数)。
---
.../company_menu_grant_gate_mutation.py | 255 ++++++++++++++++++
.../PermissionCompanyMenuHiddenTest.java | 187 ++++++++++++-
2 files changed, 433 insertions(+), 9 deletions(-)
create mode 100644 backend-java/scripts/company_menu_grant_gate_mutation.py
diff --git a/backend-java/scripts/company_menu_grant_gate_mutation.py b/backend-java/scripts/company_menu_grant_gate_mutation.py
new file mode 100644
index 000000000..f5a33354f
--- /dev/null
+++ b/backend-java/scripts/company_menu_grant_gate_mutation.py
@@ -0,0 +1,255 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""Task 4 变异自证:把 admin_companies 的三处出口逐条改坏,验证 PermissionCompanyMenuHiddenTest 真会红。
+
+源码扫描判不出"闸门在跑"与"闸门被写成 if (false)",所以每支闸门都要一记变异;
+反过来,每根新加的护栏也必须先被一记变异打红一次,否则它可能只是恒绿的字符串比较(全局约束 #15)。
+
+跑法(脚本自带仓库定位,在任意目录都能跑;文件名是 git 跟踪的,克隆后原地可复跑):
+ python backend-java/scripts/company_menu_grant_gate_mutation.py # R0 对照 + 全部 13 轮
+ python backend-java/scripts/company_menu_grant_gate_mutation.py R9 R10 # 只跑指定轮次(先跑 R0 更稳)
+
+轮次与它要钉住的缺陷(review-5902f87d..2d6079c2 的编号写在括号里):
+ R0 对照,不注入(本轮必须全绿,否则后面所有"红了"都不作数)
+ R1 出口 1 闸门失效 R2 出口 1 条件取反 R3 出口 1 挂错条件(超管旁路)
+ R4 出口 2 过滤器摘掉 R5 出口 2 把剪过的集合喂给层级参数
+ R6 出口 3 剥离调用摘掉 R7 出口 3 改成报 403 R8 出口 3 反解集合写反
+ R9 出口 2 的过滤提到超管早返回之前(Important 2:超管失去「公司管理」,改法看着完全正当)
+ R10 三处过滤器全删(Important 1:旧的"出现 ≥4 次"绊线在这一记下面是绿的)
+ R11 保留 log.warn 但换掉 marker 串(Important 3:运维合同是 marker,不是 API 名)
+ R12 连层级查找表/目录一起剪(Minor 9:叶子夹具接不住,只有 B2b 会红)
+ R13 把"命中受控集就 403"写进拒绝路径 ensureGrantable(Minor 5:运行时看不见,只有形状扫描会红)
+
+硬规矩(全局约束 #11):
+ * 每轮开跑前把被注入文件写回 pristine(注入前从磁盘读进内存的那份字节);
+ * 还原只认注入前读进内存的字节,绝不 git checkout / git stash;
+ * 锚串先按文件实际行尾(本仓库 Java 是 CRLF)对齐,锚命中次数 != 1 直接作废该轮并打印 ANCHOR,不猜;
+ * 分母只认本轮 mvn 输出里那一行 Tests run,拿不到或数为 0 就判本轮无效(不许"没扫到"当成"扫过了且绿");
+ * 扫描用例自带取样集非空自检(见 PermissionCompanyMenuHiddenTest 的 executableCodeLines / methodBody);
+ * R0 不绿则整串作废;收尾再写回一次并做 sha256 校验。
+"""
+import hashlib
+import os
+import re
+import subprocess
+import sys
+
+try: # 仓库路径含中文,Windows 默认 cp1252 会在重定向时炸掉 print
+ sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+except Exception:
+ pass
+
+REPO = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", ".."))
+MODULE = os.path.join(REPO, "backend-java")
+TARGET = os.path.join(
+ MODULE, "src", "main", "java", "com", "nanri", "aiimage",
+ "modules", "permission", "service", "PermissionMenuService.java")
+REPORT = os.path.join(
+ MODULE, "target", "surefire-reports",
+ "com.nanri.aiimage.modules.permission.PermissionCompanyMenuHiddenTest.txt")
+TEST = "PermissionCompanyMenuHiddenTest"
+
+SUMMARY = re.compile(r"Tests run: (\d+), Failures: (\d+), Errors: (\d+), Skipped: (\d+)")
+RED_NAME = re.compile(r"^\[ERROR\]\s+%s\.(\w+)" % TEST)
+
+EXIT1_BLOCK = (
+ " if (grantableOnly) {\n"
+ " visibleMenus = visibleMenus.stream()\n"
+ " .filter(menu -> !SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))\n"
+ " .toList();\n"
+ " }\n")
+EXIT2_BLOCK = (
+ " List visibleMenus = effectiveMenus.stream()\n"
+ " .filter(menu -> !SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))\n"
+ " .toList();\n"
+ " return toItemVos(visibleMenus, menus);")
+SUPER_EARLY_RETURN = (
+ " List menus = loadMenus(menuType);\n"
+ " if (isSuperAdmin(user)) {\n"
+ " return toItemVos(menus, menus);\n"
+ " }")
+DENIED_THROW = (
+ " if (!denied.isEmpty()) {\n"
+ " throw new BusinessException(403, \"普通管理员只能分配自己已有的菜单权限\");\n"
+ " }")
+STRIP_CALL = " requestedIds = stripSuperAdminOnlyGrantIds(requestedIds, operator);"
+MARKER_LOG = (" log.warn(\"GRANT_SUPER_ADMIN_ONLY_STRIPPED 已剥离超管专属菜单授权 ids={} operatorId={}\", stripped,")
+
+ROUNDS = [
+ ("R0", "对照:不注入任何变异(本轮必须全绿)", []),
+ ("R1", "出口 1 闸门失效(if (false && grantableOnly))",
+ [(" if (grantableOnly) {\n visibleMenus = visibleMenus.stream()",
+ " if (false && grantableOnly) {\n visibleMenus = visibleMenus.stream()")]),
+ ("R2", "出口 1 条件取反(grantableOnly=false 才剪,等于两半都反)",
+ [(" if (grantableOnly) {\n visibleMenus = visibleMenus.stream()",
+ " if (!grantableOnly) {\n visibleMenus = visibleMenus.stream()")]),
+ ("R3", "出口 1 挂错条件(grantableOnly && grantableIds != null):超管旁路回来了",
+ [(" if (grantableOnly) {\n visibleMenus = visibleMenus.stream()",
+ " if (grantableOnly && grantableIds != null) {\n visibleMenus = visibleMenus.stream()")]),
+ ("R4", "出口 2 过滤器摘掉(非超管仍能拿到历史授权那条)",
+ [(EXIT2_BLOCK,
+ " List visibleMenus = effectiveMenus.stream()\n"
+ " .toList();\n"
+ " return toItemVos(visibleMenus, menus);")]),
+ ("R5", "出口 2 把剪过的集合喂给层级参数",
+ [(" return toItemVos(visibleMenus, menus);",
+ " return toItemVos(visibleMenus, visibleMenus);")]),
+ ("R6", "出口 3 剥离调用摘掉(提交带这条就落库/撞校验)",
+ [(STRIP_CALL, " // MUTANT: 出口 3 未剥离")]),
+ ("R7", "出口 3 改成报 403(09-16「整单失败」形状回来)",
+ [(" log.warn(\"GRANT_SUPER_ADMIN_ONLY_STRIPPED 已剥离超管专属菜单授权 ids={} operatorId={}\", stripped,\n"
+ " operator == null ? null : operator.getId());\n"
+ " return requestedIds.stream().filter(id -> !restricted.contains(id)).toList();",
+ " throw new BusinessException(403, \"MUTANT 超管专属菜单不可授予\");")]),
+ ("R8", "出口 3 反解集合写反(把合法项当超管专属剥掉)",
+ [(" return loadMenus(null).stream()\n"
+ " .filter(menu -> SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))",
+ " return loadMenus(null).stream()\n"
+ " .filter(menu -> !SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))")]),
+ # ---- Fix round 1 新增的四记(每记都对应一根新护栏;先红后绿才允许写进断言) ----
+ ("R9", "出口 2 的过滤提到超管早返回之前(Important 2:超管失去公司管理入口)",
+ [(SUPER_EARLY_RETURN,
+ " List menus = loadMenus(menuType);\n"
+ " // MUTANT R9: 闸门上提到超管分支之前,连超管一起剪\n"
+ " menus = menus.stream()\n"
+ " .filter(menu -> !SUPER_ADMIN_ONLY_KEYS.contains(menu.getColumnKey()))\n"
+ " .toList();\n"
+ " if (isSuperAdmin(user)) {\n"
+ " return toItemVos(menus, menus);\n"
+ " }"),
+ (EXIT2_BLOCK,
+ " List visibleMenus = effectiveMenus.stream()\n"
+ " .toList();\n"
+ " return toItemVos(visibleMenus, menus);")]),
+ ("R10", "三处过滤器全删(Important 1:旧绊线数的是全文出现次数,这一记下它是绿的)",
+ [(EXIT1_BLOCK, " // MUTANT R10: 出口 1 的过滤器被摘掉\n"),
+ (EXIT2_BLOCK,
+ " List visibleMenus = effectiveMenus.stream()\n"
+ " .toList();\n"
+ " return toItemVos(visibleMenus, menus);"),
+ (STRIP_CALL, " // MUTANT R10: 出口 3 未剥离")]),
+ ("R11", "保留 log.warn 但换掉 marker 串(Important 3:运维合同是 marker,不是 API 名)",
+ [(MARKER_LOG,
+ " log.warn(\"MUTANT 已剥离超管专属菜单授权 ids={} operatorId={}\", stripped,")]),
+ ("R12", "出口 2 连层级查找表(目录)一起剪(Minor 9:只有子页面夹具 B2b 会红)",
+ [(" return toItemVos(visibleMenus, menus);",
+ " // MUTANT R12: 目录也被剪了一刀,子页面从此认不出自己的父分组\n"
+ " return toItemVos(visibleMenus, menus.stream()\n"
+ " .filter(menu -> !\"admin_companies\".equals(menu.getColumnKey()))\n"
+ " .toList());")]),
+ ("R13", "把「命中受控集就 403」写进拒绝路径 ensureGrantable(Minor 5:运行时零可见性)",
+ [(DENIED_THROW,
+ DENIED_THROW + "\n"
+ " // MUTANT R13: 受控集被接进拒绝路径;今天的夹具不会触发它,只有形状扫描看得境\n"
+ " if (!SUPER_ADMIN_ONLY_KEYS.isEmpty() && requestedIds.stream().anyMatch(id -> id > 999L)) {\n"
+ " throw new BusinessException(403, \"MUTANT 超管专属菜单不可授予\");\n"
+ " }")]),
+]
+
+
+def read_bytes():
+ with open(TARGET, "rb") as fh:
+ return fh.read()
+
+
+def align(text, eol):
+ return text.replace("\n", eol)
+
+
+def detect_eol(raw):
+ return b"\r\n" in raw and "\r\n" or "\n"
+
+
+def run_case():
+ if os.path.exists(REPORT):
+ os.remove(REPORT) # 上一轮的红点报告不许被当成本轮结果
+ proc = subprocess.run(
+ "mvn test -Dtest=%s -DfailIfNoTests=false" % TEST,
+ cwd=MODULE, shell=True, capture_output=True, text=True,
+ encoding="utf-8", errors="replace", timeout=2400)
+ out = (proc.stdout or "") + (proc.stderr or "")
+ matches = SUMMARY.findall(out)
+ denom = matches[-1] if matches else ("?", "?", "?", "?")
+ red = sorted({m.group(1) for line in out.splitlines() for m in [RED_NAME.match(line)] if m})
+ if not red and os.path.exists(REPORT):
+ with open(REPORT, encoding="utf-8", errors="replace") as fh:
+ body = fh.read()
+ red = sorted({m.group(1) for line in body.splitlines()
+ for m in [re.match(r"^\s+([A-Za-z]\w+)\s.*<<< (FAILURE|ERROR)!", line)] if m})
+ compile_failed = "COMPILATION ERROR" in out
+ sampled = denom[0].isdigit() and int(denom[0]) > 0
+ return proc.returncode, denom, red, compile_failed, sampled
+
+
+def main():
+ wanted = sys.argv[1:] or [r[0] for r in ROUNDS]
+ pristine = read_bytes()
+ digest = hashlib.sha256(pristine).hexdigest()[:16]
+ eol = detect_eol(pristine)
+ text = pristine.decode("utf-8")
+ print("pristine sha256[:16]=%s eol=%r bytes=%d" % (digest, eol, len(pristine)))
+ print("target = %s" % TARGET)
+ r0_green = False
+ ok_all = True
+ try:
+ for rid, title, edits in ROUNDS:
+ if rid not in wanted:
+ continue
+ # 每轮开跑前先写回 pristine(只认注入前读进内存的字节,不碰 git)
+ with open(TARGET, "wb") as fh:
+ fh.write(pristine)
+ assert read_bytes() == pristine, "%s 写回 pristine 失败" % rid
+ note = "—"
+ mutated = text
+ if edits:
+ bad = None
+ for anchor, repl in edits:
+ a, r = align(anchor, eol), align(repl, eol)
+ hits = mutated.count(a)
+ if hits != 1:
+ bad = "锚命中 %d 次: %s" % (hits, anchor[:60].replace(eol, "\\n"))
+ break
+ mutated = mutated.replace(a, r, 1)
+ if bad:
+ print("[%s] ANCHOR 作废本轮 —— %s" % (rid, bad))
+ ok_all = False
+ continue
+ with open(TARGET, "wb") as fh:
+ fh.write(mutated.encode("utf-8"))
+ code, denom, red, cfail, sampled = run_case()
+ # 本轮跑完立刻写回 pristine,再校验字节一致
+ with open(TARGET, "wb") as fh:
+ fh.write(pristine)
+ restored = read_bytes() == pristine
+ state = "GREEN" if code == 0 else ("COMPILE-FAIL" if cfail else "RED")
+ if not sampled:
+ state = "INVALID(没拿到本轮 Tests run)"
+ ok_all = False
+ print("[%s] %-56s -> %-11s run=%s fail=%s err=%s 红: %s" %
+ (rid, title[:56], state, denom[0], denom[1], denom[2], ", ".join(red) or note))
+ if rid == "R0":
+ r0_green = state == "GREEN"
+ ok_all = ok_all and r0_green
+ elif edits:
+ if not r0_green and "R0" not in wanted:
+ print(" ! 本轮没跑 R0 对照 —— 这一记的「红了」要配 R0 绿才算数")
+ ok_all = ok_all and state == "RED" and bool(red)
+ if not restored:
+ ok_all = False
+ print("[%s] 还原校验失败(字节不一致)" % rid)
+ finally:
+ with open(TARGET, "wb") as fh:
+ fh.write(pristine)
+ final = read_bytes()
+ same = hashlib.sha256(final).hexdigest()[:16] == digest
+ print("最终还原校验: %s (sha256[:16]=%s)" % ("OK" if same else "FAILED",
+ hashlib.sha256(final).hexdigest()[:16]))
+ ok_all = ok_all and same
+ if "R0" in wanted and not r0_green:
+ print("R0 不绿:后面所有「红了」都不作数(先确认工作树与 HEAD 一致、没有并发注入)")
+ print("变异自证结论: %s" % ("每轮都红了、且目标已复原" if ok_all else "有轮次不达标,看上面逐行输出"))
+ return 0 if ok_all else 1
+
+
+if __name__ == "__main__":
+ sys.exit(main())
diff --git a/backend-java/src/test/java/com/nanri/aiimage/modules/permission/PermissionCompanyMenuHiddenTest.java b/backend-java/src/test/java/com/nanri/aiimage/modules/permission/PermissionCompanyMenuHiddenTest.java
index 1d69e9967..8ea8b2593 100644
--- a/backend-java/src/test/java/com/nanri/aiimage/modules/permission/PermissionCompanyMenuHiddenTest.java
+++ b/backend-java/src/test/java/com/nanri/aiimage/modules/permission/PermissionCompanyMenuHiddenTest.java
@@ -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;
* 所以断言的是"从可授予集合摘掉 + 提交时剥离",不是"库里删行"。
*
* 两支源码扫描是绊线(防"三处出口里少了一处"),但源码文本判不出闸门是真在跑还是被写成
- * {@code if (false)},所以同一文件里另按出口补了四支实跑用例(B1、B2、B3 两种操作者各一支),
- * 逐个出口正反两面都钉:
+ * {@code if (false)},所以同一文件里另按出口补了五支实跑用例(B1、B2 含超管那一半、B2b、
+ * B3 两种操作者各一支),逐个出口正反两面都钉:
*
* - B1 出口 1(授权树 {@code list}):grantableOnly=true 时连超管都拿不到这一项(授不出去),
* grantableOnly=false(菜单管理页)时必须照旧看得到(这一行没被从目录里删掉)。
* - B2 出口 2(当前用户有效菜单 {@code getUserColumnPermissions}):非超管历史上被授过也不下发,
- * 但它的父分组与同组兄弟页必须原样保留——"顺手剪掉整组"是把用户管理页弄红的经典改法。
+ * 但它的父分组与同组兄弟页必须原样保留——"顺手剪掉整组"是把用户管理页弄红的经典改法;
+ * 超管那一半反过来钉"这条必须仍然下发"——「公司管理」是超管自己的页面,
+ * 谁把出口 2 的过滤提到超管早返回之前(变异 R9)就把超管的侧边栏弄没了。
+ * - B2b 出口 2 的另一向:受控 key 挂在分组上时,剪的只能是下发集合、不许是全量目录——
+ * 目录一被剪,子页面既解析不出父分组、连展开都展开不出来(变异 R12 钉这一条)。
* - B3 出口 3(提交授权 {@code updateUserColumnPermissions}):带这条 id 的整树提交必须
* 保存成功(绝不 403,09-16 的形状),只剥掉这一项,其余照常落库,且它绝不进"要删除"集合。
*
+ *
+ * 每支扫描都带"取样集非空"自检(全局约束 #15):注释里的 {@code { @link }} 不计入代码锚点,
+ * 拒绝路径切片必须真截到方法体,否则扫描会因为扫不到东西而恒绿。
*/
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}。
+ *
+ * 为什么必须过滤:{@code SUPER_ADMIN_ONLY_KEYS} 在 {@code PermissionMenuService.java} 里出现 7 次,
+ * 其中 4 次是定义 + 三处 javadoc 链接、只有 3 次是代码。旧的"整份文本出现 ≥4 次"于是
+ * 把三处过滤器全删掉也照样绿(Important 1)。
+ */
+ private static List 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 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 negative = code.stream().filter(line -> line.contains(NEGATIVE_FILTER)).toList();
+ List 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 验过它真的会红。
+ *
+ * 末尾还钉着相反的一半(Important 2):超管必须仍然从这个出口拿到这条菜单——
+ * 过滤排在超管早返回之后是刻意的,提到它前面(变异 R9)就只有超管侧边栏失去「公司管理」。
*/
@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 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 挂在分组上时的形状:剪掉的只能是"下发集合",绝不能去剪 {@code toItemVos}
+ * 的层级查找表 / {@code expandDescendantIds} 用的目录。
+ *
+ * 今天的 {@code admin_companies} 是叶子(父分组 98 下的 109),所以 B2 那支从"目录是否完好"
+ * 上取不到证据——把目录剪掉,兄弟页 110 的根仍是 98,什么都不会变(Minor 9)。这里换成
+ * "受控 key 自己就是分组、下面挂着两个子页面"的夹具:一旦有人连目录一起剪,
+ * ① {@code expandDescendantIds} 认不出这个分组,子页面整体消失(用户管理页就此空白),
+ * ② 子页面的 {@code rootColumnKey} 退化成自己,侧边栏挂不上组。变异 R12 钉的就是第 ② 种,
+ * 它只会让本用例红,B2 那支叶子夹具接不住。
+ */
+ @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 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 本身是个分组,下面挂着两个子页面。
+ * 只有这种形状才把"剪下发集"与"剪目录"这两种改法区分开——叶子夹具里两者等价。
+ */
+ private List 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);