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);