From 265f31681f5e274fffe1e380cae89ab5fa59a477 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Mon, 5 Oct 2026 10:11:08 +0800 Subject: [PATCH] =?UTF-8?q?test(=E5=85=AC=E5=8F=B8tab):=20=E4=B8=A4?= =?UTF-8?q?=E6=8A=8A=E5=B0=BA=E5=AD=90=E8=A1=A5=E6=B4=9E=E2=80=94=E2=80=94?= =?UTF-8?q?=E8=8C=83=E5=9B=B4"=E7=AE=97=E8=BF=87"=E8=A6=81"=E7=94=A8?= =?UTF-8?q?=E5=87=BA=E5=8E=BB"=EF=BC=8Ccompany=5Fid=20=E8=A6=81=E5=86=99?= =?UTF-8?q?=E6=98=8E=E5=8F=96=E5=80=BC=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 评审用变异证明现有护栏各有半个洞,而这两个洞接下来会被 Task 9–12 六页照抄, 所以在本任务收口,不留到批次尾。 - G2 断言 C:handler 里 `readScope(` 的结果必须先赋给变量、再出现在另一条方法调用的 实参列表里。原来只断"体内出现了 readScope(",于是 `listHistory(…, scoped)` 改成 `listHistory(…, null)` 时 20 支用例一支不红(控制方实测 rc=0)——范围算了又丢掉, 页面照样看全量。`if (scoped != null) throw` 这类装饰不算接住。带 2 支负探针 + 1 支 正探针 + 第二形探针,分母三条自检(取样集非空 / 走完两步的支数为正 / 射程必须覆盖 已接线的两页),不许恒绿也不许恒红。 - G1 取值口登记表:`/company_id\s*[:=]/` 对"右半边从哪个对象读"是瞎的, `= normalized.companyId` 与 baseline 缺口清单逐字相同(normalizeHistoryParams 是 白名单构造,运行时恒 undefined)。每页登记该页 api 函数自己的入参形状;8 页全覆盖、 缺条目红、接了线没登记同样红——没有"未登记就退回宽松判据"的默认分支。 - helpers.readSource 归一行尾:仓库 autocrlf=true,新检出是 CRLF 而源码 blob 是 LF, `[\s\S]{0,N}` 这类有界窗口会被多出来的 `\r` 挤红——同一份 company-tab store (LF 3565B / CRLF 3629B,内容等价)在干净检出树上多红一条无关用例。归一后实测 CRLF 树回到 6/5/1(只剩批次那条刻意留红)。 读数:后端全量 3663/0/0 Skipped 7 BUILD SUCCESS(最终字节亲跑);定向 9/0,变异 `scoped`→`null` 后 1 Failures 红在 CompanyIdParamGoesThroughReadScopeTest:393; 前端全量 1726/1725/1、`vue-tsc` rc=0;`= normalized.companyId`(连守卫一起换的静默变体) 实测红且点名 admin_history。产品码一支未动。 --- .../tests/company-tab-wiring.test.ts | 103 ++++++++- admin-frontend-vue/tests/helpers.ts | 12 +- ...ompanyIdParamGoesThroughReadScopeTest.java | 214 ++++++++++++++++++ 3 files changed, 326 insertions(+), 3 deletions(-) diff --git a/admin-frontend-vue/tests/company-tab-wiring.test.ts b/admin-frontend-vue/tests/company-tab-wiring.test.ts index deed473bc..84c29afc7 100644 --- a/admin-frontend-vue/tests/company-tab-wiring.test.ts +++ b/admin-frontend-vue/tests/company-tab-wiring.test.ts @@ -7,9 +7,70 @@ import { COMPANY_SCOPED_PAGES, SUPER_ADMIN_ONLY_MENU_KEYS } from '../src/config/ const read = (p: string) => { assert.ok(existsSync(p), `护栏读不到 ${p}:api 文件改名了,清单必须同步(别把用例改成"不存在就跳过")`) - return readFileSync(p, 'utf8') + // 与 helpers.readSource 同口径归一行尾(CRLF 检出树会把有界窗口判据挤红,见 helpers 里的注释)。 + return readFileSync(p, 'utf8').replace(/\r\n/g, '\n') } +/** + * 取值口登记表(2026-10-05 修复轮 1,复评 I-2)。上面那条正向判据原本只问「有没有把 company_id 当成查询 + * 参数下传」,`/company_id\s*[:=]/` 对**右半边从哪儿取值**是瞎的:评审把 + * `history-api.ts` 的 `query.company_id = params.companyId` 改成 `= normalized.companyId` 之后, + * 缺口清单与 baseline **逐字相同**(`admin_history` 都不出现)、`vue-tsc` 也不红 + * (`normalizeHistoryParams` 的返回类型就是 `HistoryListParams`,本轮刚给它加了 `companyId?: number | null`, + * 所以 `normalized.companyId` 类型合法、运行时恒 `undefined`)。tab 画了、请求发了、参数没有—— + * 这正是本批次要杀的那类静默失效,尺子却看不见。 + *

于是每页登记一条"company_id 右侧的根标识符**必须**是该页 api 函数自己的入参"的形状: + * `shape` 为 `RegExp` 时,对**剥完注释的源码**求值,不匹配即红并点名文件;`shape` 为 `null` 是 + * "这一页还没接线"的显式声明(今天 6 页如此,它们本来就在缺口清单里)。 + *

两道不留缝:① `COMPANY_SCOPED_PAGES` 里每一页都必须在表里有条目,缺条目直接红; + * ② 一旦某个文件真的出现了 `company_id` 下传而它的 `shape` 还是 `null`,同样红—— + * 所以"新页接线时顺手不改登记表"过不去,也**没有**"没登记就退回宽松判据"的默认分支。 + */ +type CompanyIdPin = { readonly file: string; readonly shape: RegExp | null; readonly note: string } + +const COMPANY_ID_SOURCE_PINS: Readonly> = { + admin_history: [ + { + file: 'src/pages/records/history-api.ts', + // fetchHistoryList(params: Partial):唯一入参对象是 params(history-api.ts:15 的形状)。 + shape: /company_id\s*=\s*params\.companyId\b/, + note: 'normalizeHistoryParams 是白名单构造(只点名 page/pageSize/userId/timeStart/timeEnd),从 normalized 读 companyId 恒 undefined', + }, + ], + admin_image_video_tasks: [ + { + file: 'src/pages/tasks/image-video-api.ts', + // fetchImageVideoTasks(filter, page, pageSize, companyId):公司值的入参就是第 4 个形参本身(:19 的形状), + // 不是 filter 的字段——toImageVideoQuery 同样是白名单构造。 + shape: /company_id\s*=\s*companyId\b/, + note: 'filter 走 toImageVideoQuery 白名单构造,公司值只能落在 companyId 形参上', + }, + ], + admin_task_center: [ + { file: 'src/api/task-center.ts', shape: null, note: 'Task 9 未接线(已在缺口清单里);谁接线谁把 null 换成本函数真实取值口' }, + { file: 'src/pages/task-center/task-center-model.ts', shape: null, note: '同上:这一页有两个取数模块,两个都得登记' }, + ], + admin_user_secret_usage: [ + { file: 'src/api/user-secret-usage.ts', shape: null, note: 'Task 10 未接线(已在缺口清单里)' }, + ], + admin_user_secrets: [ + { file: 'src/api/user-secrets.ts', shape: null, note: 'Task 10 未接线(已在缺口清单里)' }, + ], + admin_device_logs: [ + { file: 'src/api/device-logs.ts', shape: null, note: 'Task 10 未接线(已在缺口清单里)' }, + ], + admin_group_manage: [ + { file: 'src/pages/account/shop-group-api.ts', shape: null, note: 'Task 11 未接线(已在缺口清单里)' }, + ], + admin_shop_manage: [ + { file: 'src/pages/shop/shop-manage-api.ts', shape: null, note: 'Task 11 未接线(已在缺口清单里)' }, + ], +} + +/** 严格判据的分母由本轮实扫得出(修完不许恒绿也不许恒红):求值了几条 shape、其中几条通过。 */ +let strictPinsEvaluated = 0 +let strictPinsPassed = 0 + test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company_id,页面组件必须 watch activeId', () => { // 循环里**收集**、循环后一次性断言:Task 8-12 是 5 个任务共用这把尺子,fail-fast 时做完自己那页的同事 // 仍然只看到一句指向**别人页**的红(今天只报 src/api/task-center.ts),判断不出本页是否已收敛。 @@ -29,6 +90,31 @@ test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company gaps.push(`${file} 没把 company_id 当成查询参数下传`) } } + // 取值口登记(复评 I-2):光"把 company_id 塞进查询对象"不够,右半边必须取自**本函数自己的入参**。 + for (const pin of COMPANY_ID_SOURCE_PINS[page.menuKey] ?? []) { + if (!page.apiFiles.includes(pin.file)) { + gaps.push(`${pin.file} 登记在 ${page.menuKey} 名下,但 COMPANY_SCOPED_PAGES 的 apiFiles 里没有它:登记表与清单两处口径打架`) + continue + } + const src = stripComments(read(pin.file)) + const wired = /company_id\s*[:=]/.test(src) + if (pin.shape === null) { + // 没登记取值口却已经下传了参数 = 这一页的取值口径没人看守(洞就是这么留下的)。 + if (wired) gaps.push(`${pin.file} 已经把 company_id 当下传参数了,登记表里 shape 却还是 null —— 把它换成"company_id 右侧 = 本函数入参"的正则`) + continue + } + strictPinsEvaluated++ + if (!wired) { + gaps.push(`${pin.file} 登记了取值口 ${pin.shape},文件里却一个 company_id 都没下传:登记表与代码漂移(要么接线回来,要么把 shape 改回 null)`) + continue + } + if (!pin.shape.test(src)) { + gaps.push(`${pin.file} 的 company_id 右半边不是本函数入参(登记表要求 ${pin.shape};${pin.note})` + + '—— tab 画了、请求发了、参数没有;编译器不一定看得见(normalizeHistoryParams 的返回类型里就有这个字段)') + continue + } + strictPinsPassed++ + } for (const file of page.pageFiles) { // 与 api 侧同口径先剥注释(约束 6:注释里出现字面量不算接线)——否则一句 // `// 这里读 companyTab.requestCompanyId` 就能同时骗过下面两条断言。 @@ -43,8 +129,23 @@ test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company gaps.push(`${file} 没读 companyTab.requestCompanyId(页面取公司值的唯一出口)`) } } + // 覆盖性自检:清单里每一页都必须在登记表里有条目。**没有**"没登记就退回宽松判据"这条路。 + if (!(page.menuKey in COMPANY_ID_SOURCE_PINS)) { + gaps.push(`${page.menuKey} 在 COMPANY_ID_SOURCE_PINS 里没有条目:接线的页必须登记取值口,护栏不许留默认分支`) + } if (gaps.length) problems.push(`${page.menuKey}:${gaps.join(';')}`) } + // 正样本自检:求值了却一条都没通过 ⇒ 严格判据恒红(或形状不认),红在缺口清单里、不抢本页的诊断信息。 + if (strictPinsEvaluated > 0 && strictPinsPassed === 0) { + problems.push(`(取值口取样自检)shape 求值了 ${strictPinsEvaluated} 条、通过 0 条 —— 判据恒红或形状不认,不可信`) + } + // 严格半支的取样自检:登记表是空的、或一页都没走完 shape 求值 ⇒ 这半支等于没写,用例自己红。 + assert.ok(strictPinsEvaluated >= 2, + `取值口严格判据本轮只求值了 ${strictPinsEvaluated} 条(登记表里 admin_history / admin_image_video_tasks 两条 shape 都在,` + + `求值数不可能低于已接线页数)——判据空转,normalized-vs-params 那个洞又没人看守了`) + assert.ok(COMPANY_ID_SOURCE_PINS.admin_history.some((p) => p.shape !== null) + && COMPANY_ID_SOURCE_PINS.admin_image_video_tasks.some((p) => p.shape !== null), + 'Task 8 已接线的两页在登记表里的 shape 被改回 null 了:严格判据对这两页不再起作用(正样本归零)') assert.deepEqual(problems, [], `公司 tab 接线缺口(逐页列全;Task 8-12 补齐后这支自动收敛,本轮刻意留红):\n` + problems.map((p) => ` - ${p}`).join('\n')) diff --git a/admin-frontend-vue/tests/helpers.ts b/admin-frontend-vue/tests/helpers.ts index 91224c7c5..62732bc88 100644 --- a/admin-frontend-vue/tests/helpers.ts +++ b/admin-frontend-vue/tests/helpers.ts @@ -6,9 +6,17 @@ const SRC = join(ROOT, 'src') const EXTENSIONS = ['', '.ts', '.tsx', '.vue', '.js', '.json'] const INDEX_CANDIDATES = ['/index.ts', '/index.tsx', '/index.vue', '/index.js'] -/** 读取工程内源码文件(相对工程根)。 */ +/** + * 读取工程内源码文件(相对工程根)。 + * + * 行尾一律归一成 LF:仓库 `core.autocrlf=true`,新检出的工作树是 CRLF 而源码 blob 是 LF, + * 而本仓多数判据是 `[\s\S]{0,N}` 这类**有界窗口**(例如 company-tab-wiring 里 catch→this.error→throw + * 那记 420 字符的钉子)。每个换行多背一个 `\r` 就把窗口预算吃掉一截——实测同一份 `src/stores/company-tab.ts` + * (内容逐字节等价,主树 LF 3565 B / 新检出 CRLF 3629 B)在干净检出树上会多红一条与本任务无关的用例。 + * 归一之后判据只取决于内容,不取决于在哪台机器、哪个 worktree 里跑。 + */ export function readSource(rel: string): string { - return readFileSync(join(ROOT, rel), 'utf8') + return readFileSync(join(ROOT, rel), 'utf8').replace(/\r\n/g, '\n') } /** 统计非重叠子串出现次数(幂等、只读)。 */ diff --git a/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java b/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java index 7ab41212d..0f12231e9 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java @@ -10,6 +10,7 @@ import java.util.ArrayList; import java.util.HashSet; import java.util.List; import java.util.Set; +import java.util.regex.Matcher; import java.util.regex.Pattern; import java.util.stream.Collectors; import java.util.stream.Stream; @@ -85,6 +86,15 @@ import org.junit.jupiter.api.Test; * 可观察证据;私有辅助方法或字段里提一句 {@code companyId}(Task 11 就会写)不再误伤。 * 取舍写在这里:这样会漏掉"公司 token 落在 handler 之外但形状不像参数声明"那一族(如类级常量), * 那一族交给人审与变异测试,换的是"不红在无关代码上"。 + *

  • 算了范围不等于接了出口(复评 I-1;修复轮 1 新增的断言 C)。断言 A 只看 handler 体内有没有 + * {@code readScope(} 这个字面量,于是 {@code listHistory(page, pageSize, userId, timeStart, timeEnd, + * scoped)} 的末位实参被改成 {@code null} 时 A、B 全绿——控制方实测 rc=0、9 支用例一支不红。 + * 范围"算过"而没"用出去",页面照样看全量。断言 C 因此钉两步: + * ① {@code readScope(} 的结果必须被赋值给一个变量({@code List scoped = …readScope(…);} 与 + * {@code ReadScope s = …readScope(…);} 两种形状都认);找不到赋值目标 = 裸语句、结果被丢掉 ⇒ 红。 + * ② 该变量必须出现在 handler 体内另一条方法调用的实参列表里(扣掉它自己那条赋值语句, + * 单层括号够用,今天两页都是这一形)。只要求"在别处被引用一次"不够: + * {@code if (scoped != null) throw …} 是装饰,不算把范围交给谁 ⇒ 控制语句关键字不认。
  • * * *

    取样键:可执行行里出现 {@code company_id} 或 {@code companyId}(裸 token 即入样本,交给逐 handler @@ -120,6 +130,16 @@ class CompanyIdParamGoesThroughReadScopeTest { private static final Set READ_SCOPE_ALLOWLIST = Set.of("com/nanri/aiimage/modules/admin/controller/AdminUserController.java#@GetMapping(\"/users\")"); + /** + * 断言 C 的射程下限(复评 I-1):Task 8 已经接线的两页必须真被 C 扫到。 + * 不钉这一条的话,"取样集非空"自检可以由任何一支别的 handler 满足,而这两页哪天改了 + * mapping 注解 / 换了参数形状就会静默脱离射程——分母由本轮自己造,等于没有分母。 + */ + private static final String SCOPE_CAUGHT_HISTORY_KEY = + "com/nanri/aiimage/modules/imagehistory/controller/ImageHistoryController.java#@GetMapping(\"/history\")"; + private static final String SCOPE_CAUGHT_VIDEO_KEY = + "com/nanri/aiimage/modules/imagevideo/controller/AdminImageVideoTaskController.java#@GetMapping"; + private static final String READ_SCOPE_CALL = "readScope("; private static final String EXPLICIT_PARAM_NAME = "name = \"company_id\""; private static final String SNAKE_PARAM = "company_id"; @@ -128,6 +148,27 @@ class CompanyIdParamGoesThroughReadScopeTest { private static final String GET_PARAMETER = "getParameter("; private static final String WINDOW_OPEN = "{"; private static final String CLOSE_BRACE = "}"; + private static final String SEMICOLON = ";"; + + /** + * 断言 C 第 ① 步的赋值形状:{@code 标识符 =}。比较运算符吃不到——{@code a == b} 的两个 {@code =} + * 前面都不是标识符尾字符({@code =}/{@code空格=} 前面是 {@code =}),{@code !=}/{@code <=}/{@code >=} + * 同理中间隔了别种符号,{@code (ident)\s*=(?!=)} 匹配不上。取最后一个匹配: + * {@code List scoped = dataReadScope.readScope(…)} 里 {@code Long} 后面跟的是 {@code >}, + * 不会被当成目标,目标只能是 {@code scoped}。 + */ + private static final Pattern SCOPE_ASSIGNMENT = Pattern.compile("([A-Za-z_$][\\w$]*)\\s*=(?!=)"); + + /** 断言 C 第 ② 步的消费形状:{@code 名字(实参)},单层括号(现有两页都是这一形)。 */ + private static final Pattern CALL_ARGUMENTS = + Pattern.compile("([A-Za-z_$][\\w$]*)\\s*\\(([^()]*)\\)"); + + /** + * 控制语句关键字:读了变量但没把它交给任何人。{@code if (scoped != null) throw …} 这种装饰 + * 若算"接住了",C 就等于没写(复评点名的正是这一族)。 + */ + private static final Set NOT_VALUE_CONSUMERS = Set.of( + "if", "for", "while", "switch", "do", "catch", "synchronized", "return", "throw", "else", "try"); /** * 参数绑定注解(F-A):一行里出现它们,这一行就是真参数声明,无论同行是否还写着 @@ -171,6 +212,50 @@ class CompanyIdParamGoesThroughReadScopeTest { } """; + /** + * 断言 C 的负探针 1:{@code readScope(} 写成裸语句、结果当场丢掉——第 ① 步就该红。 + * 这合法 Java(方法调用是合法的表达式语句),不是为了让探针"看起来像坏代码"。 + */ + private static final String SCOPE_DISCARD_PROBE = """ + @GetMapping("/probe") + public String discard(@RequestParam(name = "company_id", required = false) Long companyId) { + dataReadScope.readScope(null, companyId); + return "ok"; + } + """; + + /** 断言 C 的负探针 2:变量接住了,但只在 {@code if} 里装饰一次,没交给任何方法调用——第 ② 步该红。 */ + private static final String SCOPE_DECOR_PROBE = """ + @GetMapping("/probe") + public String decor(@RequestParam(name = "company_id", required = false) Long companyId) { + List scoped = dataReadScope.readScope(null, companyId).userIdsOr(null); + if (scoped != null) throw new IllegalStateException("x"); + return "ok"; + } + """; + + /** + * 断言 C 的另一种赋值形状探针:{@code ReadScope s = …readScope(…);}(规格点名的第二形)。 + * 今天真树两页都是 {@code List scoped = …userIdsOr(base);},这一形还没有使用者, + * 但判据必须认它——否则哪天有人改成返回 ReadScope 的写法,红的是护栏而不是接线。 + */ + private static final String SCOPE_TYPE_FORM_PROBE = """ + @GetMapping("/probe") + public String typed(@RequestParam(name = "company_id", required = false) Long companyId) { + ReadScope s = dataReadScope.readScope(null, companyId); + return String.valueOf(imageVideoAdminTaskService.page(1, 20, s)); + } + """; + + /** 断言 C 的正探针:接住并且进了另一条调用的实参列表 ⇒ 判据不许恒红。 */ + private static final String SCOPE_CAUGHT_PROBE = """ + @GetMapping("/probe") + public String caught(@RequestParam(name = "company_id", required = false) Long companyId) { + List scoped = dataReadScope.readScope(null, companyId).userIdsOr(null); + return String.valueOf(imageHistoryService.listHistory(1, 15, null, null, null, scoped)); + } + """; + @Test @DisplayName("每个收公司 id 参数的 handler 都走唯一出口,并且显式写了 name = \"company_id\"") void everyCompanyIdHandlerGoesThroughReadScope() throws IOException { @@ -206,6 +291,29 @@ class CompanyIdParamGoesThroughReadScopeTest { .as("块边界自检的反面证据:readScope( 确实写在收口之后的尾随方法里") .contains(READ_SCOPE_CALL); + // 断言 C 的判据自检(全局约束 15:每条判据都要有"能红"与"能绿"两个方向的证据): + // 两个负探针必须各自红在第 ①/② 步、一个正探针必须绿,且三个探针都得先被切成 + // "1 支 handler + 真收公司 id 参数 + 体内真写了 readScope(" —— 这三条不成立下面的断言就是空跑。 + assertThat(scopeProbeReason(SCOPE_DISCARD_PROBE, "SCOPE_DISCARD_PROBE")) + .as("断言 C 自检(负样本 1,第 ① 步):readScope( 写成裸语句、结果被丢掉时必须判红") + .isNotNull() + .contains("范围算了但没接住"); + assertThat(scopeProbeReason(SCOPE_DECOR_PROBE, "SCOPE_DECOR_PROBE")) + .as("断言 C 自检(负样本 2,第 ② 步):范围赋给了变量但只在 if 里装饰一次、没交给任何方法调用 ⇒ 同样要红") + .isNotNull() + .contains("实参"); + assertThat(scopeProbeReason(SCOPE_CAUGHT_PROBE, "SCOPE_CAUGHT_PROBE")) + .as("断言 C 自检(正样本):范围接住了并当实参传给了 service.listHistory ⇒ 判据不是恒红") + .isNull(); + assertThat(scopeProbeReason(SCOPE_TYPE_FORM_PROBE, "SCOPE_TYPE_FORM_PROBE")) + .as("断言 C 自检(第二形):ReadScope s = dataReadScope.readScope(…) 且 s 进了 service.page(…) 的实参 ⇒ 同样要认") + .isNull(); + + // 断言 C 的分母由本轮实扫得出(不写死数字):扫进射程的 handler 键、走完两步的正样本支数、红因先攒后判。 + List scopeCaughtSample = new ArrayList<>(); + List scopeDiscarded = new ArrayList<>(); + int scopeCaughtHandlers = 0; + List sampled = sampledControllers(); assertThat(sampled) .as("取样集非空自检:一条都没扫到说明扫描失效,护栏等于没写") @@ -242,6 +350,17 @@ class CompanyIdParamGoesThroughReadScopeTest { .as(where + " 的公司 id 参数没写显式 name = \"company_id\"") .contains(EXPLICIT_PARAM_NAME); } + // 断言 C(复评 I-1):体内写了 readScope( 只说明"算过",不说明"用出去了"。 + // 白名单只免 A 不免 C——被豁免的那支哪天自己算了个范围又丢掉,一样得红。 + if (takesCompanyParam && handler.text().contains(READ_SCOPE_CALL)) { + scopeCaughtSample.add(exemptionKey(rel, handler)); + String dropped = handler.scopeCatchFailure(); + if (dropped == null) { + scopeCaughtHandlers++; + } else { + scopeDiscarded.add(where + dropped); + } + } } // 残块(package/import/类级注解/字段,以及 handler 收口之后、下一支 handler 之前的尾随方法) @@ -256,6 +375,22 @@ class CompanyIdParamGoesThroughReadScopeTest { .as(rel + " 的公司参数声明落在 handler 之外(切块没覆盖到,可能是类级注解/字段/尾随方法)—— 必须显式核对,不许静默跳过") .isEmpty(); } + + // 断言 C 的取样自检(全局约束 15):三个读数任一为 0 都是"护栏自己空转",用例必须当场红, + // 不许因为"这一轮没扫到东西"而恒绿,也不许靠放宽判据蒙过去。 + assertThat(scopeCaughtSample) + .as("断言 C 取样集非空自检:一支『收了公司 id 参数、体内又写了 readScope(』的 handler 都没扫到") + .isNotEmpty(); + assertThat(scopeCaughtHandlers) + .as("断言 C 正样本自检:扫到 " + scopeCaughtSample.size() + + " 支 handler,走完『接住变量 → 当实参传出去』两步的是 0 支 —— 判据恒红或形状不认,不可信") + .isPositive(); + assertThat(scopeCaughtSample) + .as("断言 C 的射程必须覆盖 Task 8 已接线的两页(改名/换 mapping 会让它静默脱离射程,分母不能自造)") + .contains(SCOPE_CAUGHT_HISTORY_KEY, SCOPE_CAUGHT_VIDEO_KEY); + assertThat(scopeDiscarded) + .as("范围算了但没接住(断言 C):readScope( 的结果要么没赋给变量,要么赋了却没交给任何方法调用") + .isEmpty(); } @Test @@ -281,6 +416,26 @@ class CompanyIdParamGoesThroughReadScopeTest { .isEmpty(); } + /** + * 断言 C 的探针驱动器:先确认这段样本真被切成"1 支收公司 id 参数、体内写了 readScope(" 的 handler, + * 再跑 {@link Block#scopeCatchFailure()}。切不出 handler / 不认公司参数 / 没有 readScope( 这三种 + * "探针失效"都由调用方的前置断言红,不留静默空跑。 + */ + private static String scopeProbeReason(String probeSource, String probeName) { + List blocks = splitBlocks(sourceLines(probeSource)).handlers(); + assertThat(blocks) + .as(probeName + " 应当恰好切出 1 支 handler;切不出来则断言 C 的自检无从判定") + .hasSize(1); + Block handler = blocks.get(0); + assertThat(handler.takesCompanyParam()) + .as(probeName + " 的 handler 没被认成收公司 id 参数,断言 C 根本不会触发 ⇒ 探针失效") + .isTrue(); + assertThat(handler.text()) + .as(probeName + " 的 handler 体内没有 readScope( ,断言 C 扫不到它 ⇒ 探针失效") + .contains(READ_SCOPE_CALL); + return handler.scopeCatchFailure(); + } + /** 取样=可执行行里出现公司 token(下划线或驼峰),逐 handler 的窗口谓词再判定是否真收参数。 */ private static List sampledControllers() throws IOException { if (!Files.isDirectory(MAIN_ROOT)) fail("找不到 " + MAIN_ROOT + " —— 用例依赖以 backend-java 为工作目录"); @@ -555,6 +710,65 @@ class CompanyIdParamGoesThroughReadScopeTest { boolean takesCompanyParam() { return viaRequestParam() || viaGetParameter(); } + + /** + * 断言 C(复评 I-1):这一支 handler 里每一次 {@code readScope(} 都必须 + * ① 把结果赋给一个变量(认 {@code List scoped = …readScope(…).userIdsOr(base);} + * 与 {@code ReadScope s = …readScope(…);} 两种形状,也认不带类型的重新赋值 {@code scoped = …}); + * ② 让那个变量出现在另一条方法调用的实参列表里(自己那条赋值语句先从文本里扣掉, + * 免得 {@code readScope(operator, scopedCompanyId)} 之类自指算数)。 + *

    返回 {@code null} = 两步都过;否则返回红因片段,由调用方拼上 handler 名。 + *

    已知放过的那一族:把变量喂给 {@code log.info("…", scoped)} 也算"给了实参"。要做成 + * "只有交给 service/mapper 那一层才算"就得枚举消费者名字,那是第二把尺子,本轮不做,交人审。 + */ + String scopeCatchFailure() { + String src = text(); + for (int at = src.indexOf(READ_SCOPE_CALL); at >= 0; + at = src.indexOf(READ_SCOPE_CALL, at + READ_SCOPE_CALL.length())) { + // 语句边界:往前取最近的 ';' 或 '{'(方法体开行),往后取第一个 ';'。 + int stmtStart = Math.max(src.lastIndexOf(SEMICOLON, at), src.lastIndexOf(WINDOW_OPEN, at)) + 1; + int stmtEnd = src.indexOf(SEMICOLON, at); + String statement = stmtEnd < 0 ? src.substring(stmtStart) : src.substring(stmtStart, stmtEnd + 1); + String target = assignedTo(statement, at - stmtStart); + if (target == null) { + return " 的 readScope( 是条裸语句:算完了没赋给任何变量,范围算了但没接住" + + "(要写成 List scoped = dataReadScope.readScope(…)…; 再把 scoped 交出去)"; + } + String rest = src.substring(0, stmtStart) + (stmtEnd < 0 ? "" : src.substring(stmtEnd + 1)); + if (!passedAsArgument(rest, target)) { + return " 的 readScope( 结果赋给了 `" + target + "`,但 handler 体内没有任何方法调用的" + + "实参列表用到 `" + target + "`:范围接住了却没交出去(把 service 那层的实参改成 " + + "null 就是这个形状)"; + } + } + return null; + } + + /** 赋值目标={@code readScope(} 之前最后一个 {@code 标识符 =}({@code == != <= >=} 不算赋值)。 */ + private static String assignedTo(String statement, int readScopeOffset) { + int cut = Math.max(0, Math.min(readScopeOffset, statement.length())); + Matcher m = SCOPE_ASSIGNMENT.matcher(statement.substring(0, cut)); + String target = null; + while (m.find()) { + target = m.group(1); + } + return target; + } + + /** {@code id} 有没有落在某个 {@code 名字(…)} 的实参列表里;控制语句关键字读它不算"交出去"。 */ + private static boolean passedAsArgument(String src, String id) { + Matcher call = CALL_ARGUMENTS.matcher(src); + Pattern use = Pattern.compile("(?