diff --git a/admin-frontend-vue/tests/company-tab-wiring.test.ts b/admin-frontend-vue/tests/company-tab-wiring.test.ts index 38c2464e9..19b46867c 100644 --- a/admin-frontend-vue/tests/company-tab-wiring.test.ts +++ b/admin-frontend-vue/tests/company-tab-wiring.test.ts @@ -289,6 +289,88 @@ test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company + problems.map((p) => ` - ${p}`).join('\n')) }) +/** + * 1b ④ 的守卫(控制方裁决 1,2026-10-05):上面那支正向用例的取值口判据是**文本**判据——它只问 + * 「`company_id` 的右半边取的是不是本函数自己的入参」,**看不见那个 query 对象有没有真交给 http**。 + * `http.get(url, { params: query })` 一旦退回 `http.get(url)`: + * - `if (companyId != null) query.company_id = companyId` 那一行逐字还在 ⇒ 五处 shape 全绿; + * - `vue-tsc` 也不红(本仓 tsconfig 没开 `noUnusedLocals`/`noUnusedParameters`,`query` 变成一个 + * 没人读的局部变量编译器一声不响,与 `TASK_CENTER_SEND_POINTS` 注释里记的 `noUnusedParameters` 同族); + * - 后端照旧 200、页面照旧渲染,只是 URL 里根本没有 `company_id` ⇒ 切 tab 一动不动。 + * 这正是本轮要杀的「前端发了、参数没有」那一型,尺子原本看不见,所以单独钉「第二实参必须带 params」。 + * + *

判据形状(一条钉 = 一个发送口):`http.get('<这一支自己的 url>',` 之后紧跟一个含 `params` 键的 + * 对象实参。锚**端点 URL 字面量**而不是行号(api 文件一改行号就漂),也不锚函数体窗口: + * 函数名另有一条身份断言钉着(改名或把发送口挪进别的函数同样红),两半合起来才是「这一支 GET 带了 params」。 + * 排他:同一 URL 的调用次数必须**恰好一条**——出现第二处同 URL 的调用时,`test()` 会被第一处糊弄过去, + * 所以这里数次数而不是只 `test()`。分母取本轮实扫的 `http.get(` 条数(对平闸门), + * 新增第六处 GET 而没登记 ⇒ 当场红,不给我自己留"文件里还有别人在发"的默认分支。

+ */ +const TASK_CENTER_HTTP_FILE = 'src/api/task-center.ts' + +/** 这一页的五个发送口(fn 是函数身份,url 是这一支的稳定身份,两者都必须对得上)。 */ +const TASK_CENTER_HTTP_GET_CALLS: ReadonlyArray<{ readonly fn: string; readonly url: string }> = [ + { fn: 'fetchTaskCenterOverview', url: '/api/admin/task-center/overview' }, + { fn: 'fetchTaskCenterShopOptions', url: '/api/admin/task-center/shop-options' }, + { fn: 'fetchTaskCenterTasks', url: '/api/admin/task-center/tasks' }, + { fn: 'fetchTaskCenterTaskDetail', url: '/api/admin/task-center/tasks/detail' }, + { fn: 'fetchTaskCenterVariantTasks', url: '/api/admin/task-center/variant-tasks' }, +] + +/** 一个发送口一条钉:`http.get('',` 后必须紧跟带 `params` 键的第二实参(`{ params }` 与 `{ params: query }` 都认)。 */ +function sendArgsShape(url: string): RegExp { + const quoted = url.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + return new RegExp(`http\\.get\\(\\s*'${quoted}'\\s*,\\s*\\{[^}]*\\bparams\\b`) +} + +/** 正样本:逐字照抄真实发送口那一行(两格缩进 + `const { data } = await`),证明判据匹配得出、不恒红。 */ +function sendArgsCompliant(url: string): string { + return ` const { data } = await http.get('${url}', { params: query })\n` +} + +/** 负样本:删掉第二实参(变异自证 1b ④ 注入的就是这一形),证明判据匹配不出、能红。 */ +function sendArgsDropped(url: string): string { + return ` const { data } = await http.get('${url}')\n` +} + +test('发送口的第二实参:task-center 五处 http.get 必须把 query 交给带 params 的实参(1b ④ 的守卫)', () => { + const api = stripComments(read(TASK_CENTER_HTTP_FILE)) + // 取样自检 1:登记表非空(这一页今天恰有五处 GET;被人删剩几条就是有人把钉摘了)。 + assert.ok(TASK_CENTER_HTTP_GET_CALLS.length >= 5, + `1b ④ 登记表只剩 ${TASK_CENTER_HTTP_GET_CALLS.length} 条发送口 ⇒ 这条看守被改窄了,下面的对平判据失去分母`) + // 取样自检 2(同链前提,全局约束 15):这一页确实还在按公司下传,「把 query 交给 http」才有意义。 + // 分母与上面那张发送口表同源(不写死 3):表改了这里跟着改,两边不会漂出两个口径。 + const sendPointsHere = TASK_CENTER_SEND_POINTS.filter((p) => p.file === TASK_CENTER_HTTP_FILE).length + assert.ok(sendPointsHere >= 1, `${TASK_CENTER_HTTP_FILE} 在 TASK_CENTER_SEND_POINTS 里一条都没登记:前提无从判定`) + assert.equal(occurrences(api, TASK_CENTER_SEND_LINE), sendPointsHere, + `${TASK_CENTER_HTTP_FILE} 里「${TASK_CENTER_SEND_LINE}」的实际条数与发送口表登记(${sendPointsHere} 条)不等 ⇒ ` + + '这一页的 company_id 与 params 两条看守必须同链在场,不许只剩一半') + // 对平闸门:分母 = 本轮实扫的 http.get( 条数。多一处没登记的 GET ⇒ 红(不许"新增那处还没人管"过关)。 + const actualGets = occurrences(api, 'http.get(') + assert.equal(actualGets, TASK_CENTER_HTTP_GET_CALLS.length, + `${TASK_CENTER_HTTP_FILE} 实扫到 ${actualGets} 处 http.get(,登记表却只有 ${TASK_CENTER_HTTP_GET_CALLS.length} 条 —— ` + + '新增发送口没登记(或有人删了登记),这条看守盖不住那一处') + + for (const p of TASK_CENTER_HTTP_GET_CALLS) { + // ① 正样本(判据不恒红)。 + assert.ok(sendArgsShape(p.url).test(sendArgsCompliant(p.url)), + `(1b ④ 取样自检·正样本)${p.fn} 的合规样本都匹配不出 ${sendArgsShape(p.url).source} ⇒ 这条钉恒红,带没带 params 都会红,等于没看守`) + // ② 负样本(判据能红):删掉第二实参就必须匹配不出——变异自证注入的正是这一形。 + assert.equal(sendArgsShape(p.url).test(sendArgsDropped(p.url)), false, + `(1b ④ 取样自检·负样本)${p.fn} 删掉 { params: query } 仍然匹配 ⇒ 判据只看得到 URL,杀不了这一记变异`) + // ③ 函数身份:这一支的 GET 必须由它自己的函数发出(改名或挪进别的函数 ⇒ 这条钉指向不存在的口)。 + assert.equal(occurrences(api, `function ${p.fn}(`), 1, + `${p.fn} 在 ${TASK_CENTER_HTTP_FILE} 里出现 ${occurrences(api, `function ${p.fn}(`)} 次(要求 1):` + + '发送口换了函数名或被复制,这条按 URL 钉的看守就对不上是谁发的') + // ④ 真文件求值 + 排他(同一 URL 只许一处调用)。 + const hits = api.match(new RegExp(sendArgsShape(p.url).source, 'g')) ?? [] + assert.equal(hits.length, 1, + `${TASK_CENTER_HTTP_FILE} 里「${p.url}」带 params 实参的调用匹配到 ${hits.length} 处(要求恰好 1):` + + `0 处 = ${p.fn} 的 http.get 没把 query 交给 params(后端收不到 company_id、接口照旧 200、切 tab 一动不动);` + + '多于 1 处 = 同 URL 有第二处调用没人钉,test() 会被第一处糊弄') + } +}) + test('反向:把 company_id 当查询参数用的取数模块必须被清单认领(防止"筛了但没人知道这页参与")', () => { const claimed = new Set(COMPANY_SCOPED_PAGES.flatMap((p) => p.apiFiles)) const scanned = requestModules() diff --git a/backend-java/docs/mutation-company-tab.md b/backend-java/docs/mutation-company-tab.md new file mode 100644 index 000000000..d029a8ddc --- /dev/null +++ b/backend-java/docs/mutation-company-tab.md @@ -0,0 +1,71 @@ +# 公司 tab(批次 0-1)变异自证台账 — 2026-10-05 + +对应计划 `docs/plans/19-company-tab.md` Task 13 Step 1 / Step 1b。口径与一期、二期相同:**一条护栏只有在它的注入点真的变红时,才算钉住了**;没做过注入的"代码里写了 if"不构成证据。 + +## 执行环境与判据 + +| 项 | 值 | +|---|---| +| 后端 | `D:/tmp-wt-t13`(detached @ `99687f46`,`backend-java`)· Maven 3.9.16 + JDK 21 · 每轮先 `rmtree target/surefire-reports`,分母只取本轮 XML | +| 前端 | 主树 `admin-frontend-vue` · `node --test`(**不是 vitest**)· 5 支文件 33 例为分母:`company-tab-wiring` 8 / `align-operation-guide` 10 / `company-user-create` 7 / `company-user-list` 4 / `company-tab-model` 4 | +| 杀没杀的判据 | Java:本轮 XML `Tests run` 与 `Failures ≥ 1` **且** mvn rc=1;FE:`ℹ fail N`(U+2139 那三行)且 rc=1。摘要一律锚 `failed`/`fail` 这个词,不取"第一个数字" | +| 还原 | 每轮开跑前把被注入文件写回**注入前读进内存的字节**;**全程没有用 `git checkout` / `restore` / `stash` / `clean` 做还原**(这个仓库同时有另一路会话在提交)。FE 轮末 `FINAL-RESTORE OK all touched files byte-identical`,后端两轮末 `FINAL-RESTORE OK all 7 files byte-identical` | +| 锚点 | 每个注入锚串命中数必须恰好 1,否则本轮作废(`anchor hit exactly 1, injected` 逐轮打);CRLF 文件按 `\r\n` 对齐行尾 | +| 对照 | FE `FR0` + `FRZ`;Java `R0` / `R06` / `R0Z` —— 全部 `rc=0` 无红,且 `R0` 是**改完用例之后又重跑过一次**的 | + +## 表 1 · 前端 11 支(全 KILLED) + +| 轮次 | 注入 | 红在哪 | +|---|---|---| +| FG-1a | 从 `COMPANY_SCOPED_PAGES` 删一行(`admin_device_logs`) | 2 条红(正向那支 + 缺口清单分母那支) | +| FG-1b | 从 `src/api/user-secrets.ts` 删掉 `company_id = companyId` 那一行 | `company-tab-wiring` 正向 | +| FG-7-3 | 往 `CompanyTabs.vue` 加回 `当前公司:…`(未批的界面暴露回流) | `align-operation-guide` 反向那半 | +| FG-7-4 | 从 8 支引导文案里删掉"超级管理员可用页面上方的公司 tab 切换公司"(`admin_user_secrets`) | `align-operation-guide` 分母那半 | +| F1b-4a / 4b | `fetchTaskCenterOverview` / `fetchTaskCenterShopOptions` 的 `http.get(url, { params: query })` 退回 `http.get(url)` | 本轮新写的守卫「发送口的第二实参」(逐 URL 报 `匹配到 0 处(要求恰好 1)`) | +| F1b-6a | 删掉 `DeviceLogsPage` 里 `watch(() => companyTab.activeId, …)` | `company-tab-wiring` 页面 reach 那半 | +| F1b-6b | `companyTab.requestCompanyId` 换成 `companyTab.activeId` | 同上 | +| F1b-6c | 直接删掉 getter 调用(`companyId: null`) | 同上 | +| FG-7-5 | 往 `UsersPage.vue` 加回「所属公司」列头(SUPPL 反向钉) | `company-user-list` | +| FG-7-6 | 建号的 `companyId` 闸门不再要求 `company_super_admin` 角色 | `company-user-create` | + +## 表 2 · 后端 15 支(BG3-a 首轮 SURVIVED,修好后复跑 KILLED ⇒ 15/15) + +| 轮次 | 注入 | 结果 · 红在哪 | +|---|---|---| +| BG2-1 | `AdminDeviceLogController.files` 整个不调 scope 出口(`memberUids = null`) | KILLED · `CompanyIdParamGoesThroughReadScopeTest` + `DeviceLogServiceTest` | +| BG2-2 | `ShopManageController.page` 的绑定改成驼峰 `@RequestParam Long companyId`(静默失效那一形) | KILLED · G2 + `ShopManageServiceTest` | +| B1b-1 | 绑定与 `readScope(` 都留着,**实参改成 `null`** | KILLED · G2 **断言 D**(这条正是断言 D 存在的理由) | +| BG3-a | 非超管"传别家 ⇒ 空集"那一支整个删掉(忽略参数、按本公司重算) | 首轮 **SURVIVED** → 见下节 → 复跑 **KILLED** · `DataReadScopeTest.adminPassingForeignCompanyGetsEmptyNot403` | +| BG3-b | 同一分支改成"不筛"(真正的越权逃逸读法) | KILLED · 同上那条用例 | +| BG4-1/2/3 | 三个出口里逐个注释掉 `SUPER_ADMIN_ONLY_KEYS` | KILLED ×3 · `PermissionCompanyMenuHiddenTest` | +| BG5 | `listVisible` 退回"非超管也可以" | KILLED · `CompanyReadPathMenuGateTest` | +| BG6 | `MEMBER_WARN_THRESHOLD` 改成 `Integer.MAX_VALUE` | KILLED · `CompanyScopeSupportTest` 哨兵用例(该轮 selector 只点这一支,`tests=1` 是设计,不是漏跑) | +| BG7-1 | 给写入口 `ShopManageController.create` 加一个 `company_id` 参数 | KILLED · G2 + `ShopManageServiceTest.writeEntryPointsCarryNoCompanyId` | +| BG7-2 | 给 `AdminDeviceLogController.content` 加 `dataReadScope`(钉"刻意不配写侧") | KILLED · `DeviceLogServiceTest.singleFileEndpointsStayUnscoped` | +| B1b-2a/2b | `ShopManageGroupService.list` 的 `and(w -> …or(x -> …))` 改成平铺 | KILLED ×2 · `ShopManageGroupServiceTest.groupListWrapsTheOrBeforeNarrowing` | +| B1b-3 | 删掉 `page` 签名里的 `@RequestParam(name = "company_id")`,**留着** `@Operation` 那句文案 | KILLED · G2 取样自检 + `ShopManageServiceTest` | + +## 1b ⑤:`grep -c "@Test"` 与本轮 surefire `Tests run` 逐类对平 + +`R0` 那一轮(无注入)实测:`CompanyIdParamGoesThroughReadScopeTest 2/2`、`DataReadScopeTest 7/7`、`PermissionCompanyMenuHiddenTest 7/7`、`CompanyReadPathMenuGateTest 3/3`、`ShopManageServiceTest 9/9`、`ShopManageGroupServiceTest 3/3`、`TaskCenterScopeServiceTest 13/13`、`DeviceLogServiceTest 19/19` ⇒ 合计 **63 = 本轮分母**,逐类相等。`CompanyScopeSupportTest` 不在 `CLASSES` 里(BG6 单独按方法点跑,`tests=1`),它的 11 支全量由后端全量门禁覆盖。这一条之所以要单列:**删掉一支用例的 `@Test`、留着方法体和 `@DisplayName`,没有任何尺子会红**——"全绿"和"那支根本没跑"同形。 + +## 作废的一轮(照实留,不当证据) + +`t13-back-all.txt`:**15 支全部 VOIDED**,每轮读数都是 `tests=None failures=None`=解析没抓到本轮 XML 的计数。那一轮的两处控制(`R0` / `R06` / `R0Z`)却是 `GREEN` 并打印 `SURVIVED rounds: none` —— 这正是 memory「字符串断言必须排他」里"解析断言抓不到就恒绿"的形状:读不到数不等于杀掉了,也不等于没杀掉。处理方式是**整轮判 VOIDED 并重跑**(`t13-back-run2.txt`),而不是报成"0 红"。重跑轮 `VOIDED rounds: none`。 + +## BG3-a 为什么活下来,以及怎么修的 + +不是"注入没被执行到"(锚点命中恰好 1,同分支的 BG3-b 会红),而是**用例自己给了错误理由**:`DataReadScopeTest.adminPassingForeignCompanyGetsEmptyNot403` 只桩了 `companyScope.requireCompanyId(any()) → 2L`,从没桩过 `memberUserIds(2L)`,而 Mockito 对返回 `List` 的未桩方法**默认交空表**。于是"删掉 foreign 分支、按本公司重算"这条注入交出的也是空集,`assertThat(scope.userIds()).isEmpty()` 照绿——它验的其实不是"别家被折成空集",而是"什么桩都没加"。 + +修法(一处,两个桩):本公司两列都桩成**非空**——`memberUserIds(2L) → [21, 22]`、`resolveVisibleUserIds(5L) → [21, 99]`(形状照同文件 `adminIsAlwaysPinnedToOwnCompany` 已有的桩)。这样"空集"只能由 foreign 分支产生。 + +复跑证据(`t13-back-run3-bg3a.txt`,只重跑 `R0` / `BG3-a` / `BG3-b` 三轮):`R0` 先绿(`tests=63 rc=0`,`DataReadScopeTest=7/0/0`,加桩没把别的用例带红)⇒ `BG3-a` **KILLED**(`rc=1`,红点逐字 `DataReadScopeTest.adminPassingForeignCompanyGetsEmptyNot403`)⇒ `BG3-b` 仍 **KILLED**(同一条用例)。该轮末 `SURVIVED rounds: none`、`VOIDED rounds: none`、`FINAL-RESTORE OK all 7 files byte-identical`。 + +## 这一份台账没证明的东西 + +- **另一路的第二道门不在此列**。批次 2/3 正在把 `DataReadScope.readCompanyId(operator, companyId)` 变成第二个被认可的正门,并给 G2 加了 276 行的扩展样本(去重库/品牌库/查询ASIN/最低价ASIN/商品类目)。那些改动此刻**未提交**,本台账的后端证据全部跑在 `99687f46` 的 G2 上——第二道门的变异由那一路自己做。 +- 后端全量**在 BG3-a 用例修复之后重跑过**:`mvn -B test` @ `D:/tmp-wt-t13c`(detached `09aab729` + 本支修复后的 `DataReadScopeTest`)⇒ **3760 例 / 0 失败 / 0 错误 / 7 skipped / BUILD SUCCESS**(`rc=0`,9:16 min)。分母独立复算:本轮 `target/surefire-reports/TEST-*.xml` 共 **450** 个文件,逐个抓 `tests/failures/errors/skipped` 求和 = 3760/0/0/7,与 Maven 摘要逐数相符(两个读数来自两条通道,不是同一次解析)。修复前那版基线也是 3760/0(`gate_full_backend.log`)⇒ 加桩没改变例数(`DataReadScopeTest` 仍 7 支,本轮 XML 里就是 7)。**这一轮的第一次尝试是 BUILD FAILURE**,红的 20 条全是 `ExplainIndexAuditDocTest` / `ArchitecturePlanSection6DocTest` / `IndexMigrationV101Test` 的 `NoSuchFileException`——那三支读的是 **gitignore 的** `backend-java/docs/explain-index-audit.md`、`java-architecture-optimization-plan.md`、`docs/specs/*`,新出包 worktree 里没有;补件后单跑那三支 27/27 绿,才跑的全量。⇒ **"worktree 全量红"要先问是不是缺件,别当成回归**(`git check-ignore -v` 一查就分明)。 +- 前端已重跑:`admin-frontend-vue` **1739/1739/0**、`vue-tsc` rc=0;`frontend-vue` 710 例里唯一红是 `dead-code-cleanup.test.ts::test_bundle_build`,它断的是 `.gitignore` 的出包目录,worktree 里必红、主树 ✔。 +- `admin-frontend-vue/tests/live/*` 是真 E2E,没有 `AIIMAGE_LLM_*` 凭据会整批 skip ⇒ **从没跑过**。 +- 计划 Step 3 那八条人工实跑(非超管回归、越权实验、八页 tab 有效性、建号 vs 店铺归属口径、按 id 凭据闸门、麦象日志、保存权限、三眼看文案)**一条都没执行**——它们验的是生产长什么样,`mvn test` 与变异都盖不到。 +- 界面逐页视觉验证欠着(真人浏览器回读)。 diff --git a/backend-java/src/test/java/com/nanri/aiimage/common/service/DataReadScopeTest.java b/backend-java/src/test/java/com/nanri/aiimage/common/service/DataReadScopeTest.java index 557a9f125..931deea11 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/common/service/DataReadScopeTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/common/service/DataReadScopeTest.java @@ -93,7 +93,12 @@ class DataReadScopeTest { @Test @DisplayName("非超管传别家 = 空结果,不报错也不越权(照 AdminUserService:75-81)") void adminPassingForeignCompanyGetsEmptyNot403() { + // 本公司两列都必须**非空**,否则「删掉 foreign 分支、改按本公司重算」这一形杀不掉: + // memberUserIds(2L)/resolveVisibleUserIds(5L) 不桩时 Mockito 对 List 返回默认空表, + // 忽略参数重算出来的也是空集,下面 isEmpty() 会因为错误的理由通过(变异 BG3-a 实测存活)。 when(companyScope.requireCompanyId(any(AdminUserEntity.class))).thenReturn(2L); + when(companyScope.memberUserIds(2L)).thenReturn(List.of(21L, 22L)); + when(userDataScope.resolveVisibleUserIds(5L)).thenReturn(List.of(21L, 99L)); ReadScope scope = dataReadScope.readScope(user(5L, "admin", 2L), 7L); assertThat(scope.isUnfiltered()).isFalse(); assertThat(scope.userIds()).isEmpty(); diff --git a/docs/ops/company-tab-design-2026-10-04.md b/docs/ops/company-tab-design-2026-10-04.md index 9bd39278d..ef9d69058 100644 --- a/docs/ops/company-tab-design-2026-10-04.md +++ b/docs/ops/company-tab-design-2026-10-04.md @@ -1,6 +1,9 @@ # 公司 tab(超管按公司看数据)+ 公司配置读写只超管 —— 设计 日期:2026-10-04 +状态:**批次 0-1 已实施**(计划 `docs/plans/19-company-tab.md` Task 1-12 出厂,Task 13 变异自证见 `backend-java/docs/mutation-company-tab.md`;人工实跑清单与上线命令另计)。**批次 2/3 由另一路会话在实施**(去重库/品牌库/查询ASIN/最低价ASIN/商品类目 + `V147`),本文件不替它写任务。 +关于 V145(§12 第 1 条当时留的那个决定):**它不是本批带的**——V145 早在 10-05 18:3x 那版 jar(出包树 `a9c74b9a`)之前就随历史进入生产,生产 Flyway 现 146;也就是"两张规则库表补 `company_id` + 唯一键改每公司一套"已落地,而它的消费侧正是上面那路批次 2/3。跨公司串扰的窗口因此由那一路收口,不由本批。 +线上现状(`git diff a9c74b9a..HEAD` 逐文件核过,10-06 00:0x):**批次 0-1 的大部分已经在这版线上 jar/构建里**——`DataReadScope`、日志管理与店铺管理两页的接线、以及前端 `src/layout/CompanyTabs.vue`(`AdminLayout.vue` 已挂载它,两处引用)都在出包树 `a9c74b9a` 中。**还没上线的只有一支功能提交** `3654d022`(任务看板五个端点按公司筛:`AdminTaskCenterController` + `TaskCenterScopeService`);其余 `a9c74b9a..HEAD` 的后端 `src/main` 改动(共 8 支,另 6 支为角色叫法/文案与按需注册修复)来自另一路会话。这一段区间**新增迁移 0 支**(`git diff --name-only a9c74b9a..HEAD -- backend-java/src/main/resources/db` 为空)⇒ 下一版 jar 不会动 Flyway 版本;`V147__product_category_company_scope.sql` 属批次 2/3,此刻仍未跟踪,一旦提交进区间,上线口径要重算。 需求来源:用户三句话,逐字记录 1. 「公司管理和创建用户选公司只能超管才能看到」 2. 「除了超管都不能操作公司配置 读写都不行」