Files
crawler-plugin/admin-frontend-vue/tests/company-super-admin-only.test.ts
T
huangzd1997 b7acfc0eef feat(菜单权限): 每家公司一套菜单树(V149)+ 公司 tab 只在注册表页渲染
本批两件事,加上随本批一起入仓的并行会话在制品:

一、菜单权限按公司隔离(批次 6)
- V149 给 columns 加 company_id:先可空加列(末位、ALGORITHM=INSTANT)→ 回填公司 1 →
  MODIFY 收紧 NOT NULL;三段式缺一即撞 1048。同时建 (company_id, column_key) 复合键、
  把公司 2 的 16 笔授权按 column_key 改指向它自己的副本,三类 menu_type 全复制,
  admin_companies 作为角色内生闸门行不复制(D3)。
- 第三道归属门 PermissionMenuService.resolveScopeCompanyId:站点超管可带 company_id
  读写任意公司,非超管锁本公司、越界 403。它注册进 CompanyIdParamGoesThroughReadScopeTest
  的 SCOPE_DOORS,四条判据与 readScope / readCompanyIdOrOwn 共用——护栏在代码出口,不靠清单。
- 旁路种子 PermissionMenuSchemaInitializer 只种公司 1:31 段种子逐条钉公司,
  按 column_key 点查的 14 段全部带 company_id,否则摘了 DEFAULT 就是跨公司串写。
- CompanyService.create 同一次写入里给新公司复制模板树(D4)。

二、公司 tab 收口(批次 b)
tab 条挂在壳层,对 22 页全画;改为按正列表 companyTabAppliesTo(menuKey) 判定,
只有注册表页渲染。护栏钉在用户看见的那个出口。

三、并行会话在制品(控制方「全部提交」,未单独拆分——见下)
- V150 店铺密钥 biz_shop_key 按公司(readCompanyIdOrOwn + writeCompanyId 两道门)
- V151 品牌库/商品类目推翻为全平台共享:只退唯一键、company_id DEFAULT 保留为
  NOT NULL 承重约束(摘了每条 1364);删掉 ProductCategoryControllerCompanyScopeTest
  那支"按公司隔离"的旧护栏,readCompanyId 方法一并移除
- invalidasin 字段与外观专利合批的连带改动

为什么不拆笔:后端 3891 例 / 0 红、前端 1731 例 / 0 红这两个读数是"合起来的树"的读数,
拆成多笔会让每一笔落到从未一起验过的组合上,而这一版要直接上两台。

回滚脚本在 backend-java/docs/rollback-V149/V150/V151-*.sql,不放进 Flyway 扫描路径。
设计记录:docs/ops/menu-company-tree-design-2026-10-06.md
2026-10-06 17:17:14 +08:00

105 lines
7.3 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import test from 'node:test'
import assert from 'node:assert/strict'
import { existsSync } from 'node:fs'
import { resolve } from 'node:path'
import { readSource } from './helpers.ts'
import { adminPages, routeOf } from '../src/router/routes.ts'
import { pruneSuperAdminOnly } from '../src/router/helpers.ts'
import { SUPER_ADMIN_ONLY_MENU_KEYS, COMPANY_SCOPED_PAGES } from '../src/config/company-scope.ts'
/** 公司配置是角色内在闸门,不是菜单授权(spec §2:菜单授权可以被人改坏,role 不能)。
* 12:3x 事故的教训是"把页面可见性当数据可见性用",这里反过来防另一个方向:只挂一处会留旁路。 */
test('超管专属页必须同时被注册表与口径清单认领(两处不一致就是漏了一处)', () => {
const flagged = adminPages.filter((p) => p.superAdminOnly).map((p) => p.menuKey)
assert.deepEqual(flagged.sort(), [...SUPER_ADMIN_ONLY_MENU_KEYS].sort())
assert.ok(SUPER_ADMIN_ONLY_MENU_KEYS.includes('admin_companies'))
})
test('路由守卫里必须有一条与菜单树无关的角色判定', () => {
const guard = readSource('src/router/index.ts')
// 锚在真实语句上,不是只扫 token:松散版 /superAdminOnly/ 连注释里的说明文字都能满足(恒绿=没钉)。
// 原先另附的 /isSuperAdmin/ 松散断言已被这条锚定式整段覆盖(`session.isSuperAdmin` 是它的组成部分),
// 且它在本任务之前就被 index.ts:57 的 isRouteAllowed(session.isSuperAdmin, ...) 满足 ⇒ 不构成新增约束,故不再单列。
assert.match(
guard,
/if\s*\(\s*to\.meta\.superAdminOnly\s*&&\s*!\s*session\.isSuperAdmin\s*\)/,
'守卫必须逐字判 `if (to.meta.superAdminOnly && !session.isSuperAdmin)`;这条条件被改名/摘掉 = 非超管拿历史授权深链直进公司管理',
)
})
test('剪枝:非超管拿不到超管专属节点,超管一个字节都不少', () => {
const tree = [
{ key: 'g1', children: [{ key: 'admin_companies', children: [] }, { key: 'admin_users', children: [] }] },
{ key: 'admin_history', children: [] },
]
const forAdmin = pruneSuperAdminOnly(tree, false)
assert.equal(JSON.stringify(forAdmin).includes('admin_companies'), false, '非超管菜单树里不许留公司管理')
assert.ok(JSON.stringify(forAdmin).includes('admin_users'), '普通节点不许被误剪')
assert.equal(pruneSuperAdminOnly(tree, true), tree, '超管原样返回,不做无谓拷贝')
})
test('剪枝是纯函数且幂等(store 里会反复调用)', () => {
const tree = [{ key: 'admin_companies', children: [] as unknown[] }]
const once = pruneSuperAdminOnly(tree, false)
assert.deepEqual(pruneSuperAdminOnly(once, false), once)
})
test('不参与 tab 的页必须显式声明 companyScoped: false(spec §5:声明,不是遗漏)', () => {
// 留空和 false 运行时等价,但只有 false 是"读过普查、决定不参与"的证据。
// 名单批次 1 是两页(店铺密钥 + 商品类目);商品类目在批次 2(2026-10-05)接上了公司口径,
// 2026-10-06 控制方定案品牌库/教程管理/软件版本管理一律全平台共享,同日批次 5 又把店铺密钥
// 改回按公司区分(V150)⇒ 今天这一族是 4 页,一句「与公司无关」都没写给它们的页不许进这张表。
// 想再往这页上加 false 的对向(把某页改回 false)不用改这里:上面那条双向对账会红。
for (const key of ['admin_invalid_asin_data', 'admin_product_categories', 'admin_version', 'admin_tutorial']) {
const page = adminPages.find((p) => p.menuKey === key)
assert.ok(page, `注册表里找不到 ${key}`) // 取样非空自检
assert.equal(page.companyScoped, false, `${key} 必须显式写 companyScoped: false,不能留空`)
}
})
test('闸门②:routeOf 必须把注册表的 superAdminOnly 原样抄进 route meta(实跑 producer,不是扫源码)', () => {
// 三处闸门是 注册表 → routeOf 抄 meta → 守卫读 to.meta 的链条;中间这一环原先零约束。
// 抄丢了 ⇒ to.meta.superAdminOnly 恒 undefined ⇒ 守卫那条对任何页面都不成立 ⇒ 非超管深链直进公司管理。
const sample = adminPages.filter((page) => page.superAdminOnly)
assert.ok(sample.length >= 1, '注册表里一条 superAdminOnly 都没有 ⇒ 取样为空,下面的循环恒绿等于没钉')
assert.ok(sample.some((page) => page.menuKey === 'admin_companies'),
'取样必须含 admin_companies(不写死断言对象,而是保证它没被从注册表里摘走)')
for (const page of sample) {
const meta = routeOf(page).meta as { superAdminOnly?: boolean }
assert.equal(meta.superAdminOnly, true,
`routeOf(${page.menuKey}) 没把 superAdminOnly 抄进 meta ⇒ 闸门②失效,守卫永远放行`)
}
// 反向:没打标记的页不许被无条件写 true(那样闸门②会把所有人都挡在门外,同样是坏约束)。
const plain = adminPages.find((page) => !page.superAdminOnly)
assert.ok(plain, '注册表里必须有非超管专属页,否则反向自检取样为空')
const plainMeta = routeOf(plain).meta as { superAdminOnly?: boolean }
assert.equal(plainMeta.superAdminOnly, undefined, `普通页 ${plain.menuKey} 的 meta 不该出现 superAdminOnly`)
})
test('companyScoped 注册表页与 COMPANY_SCOPED_PAGES 必须双向对账(清单是护栏 G1 的唯一分母)', () => {
const registryKeys = adminPages.filter((page) => page.companyScoped === true).map((page) => page.menuKey as string)
const declaredKeys = COMPANY_SCOPED_PAGES.map((entry) => entry.menuKey)
assert.ok(registryKeys.length >= 8, `注册表 companyScoped: true 只有 ${registryKeys.length} 页(应 >= 8)⇒ 取样塌了,正向对账等于没钉`)
assert.ok(declaredKeys.length >= 8, `COMPANY_SCOPED_PAGES 只有 ${declaredKeys.length} 行(应 >= 8)⇒ 清单被删空,反向对账恒绿`)
// 方向一:注册表认领了 companyScoped: true 的页必须在清单里——少一行就少一页带 company_id,且无人报警。
for (const key of registryKeys) {
assert.ok(declaredKeys.includes(key), `注册表 ${key} 写了 companyScoped: true,但 COMPANY_SCOPED_PAGES 没有它`)
}
// 方向二:清单每一行都必须是注册表里真实存在且确实写 true 的页(凭空加行 = 分母虚增,护栏对着不存在的页假绿)。
for (const entry of COMPANY_SCOPED_PAGES) {
const page = adminPages.find((item) => item.menuKey === entry.menuKey)
assert.ok(page, `COMPANY_SCOPED_PAGES 里的 ${entry.menuKey} 在路由注册表里不存在`)
assert.equal(page.companyScoped, true, `${entry.menuKey} 留空或 false 都不算被清单认领`)
}
})
test('COMPANY_SCOPED_PAGES 声明的每个 api/page 文件必须真实存在(existsSync 是断言,不是守卫)', () => {
const paths = COMPANY_SCOPED_PAGES.flatMap((entry) => [...entry.apiFiles, ...entry.pageFiles])
assert.ok(paths.length >= 17, `清单只声明了 ${paths.length} 个文件路径(应 >= 17)⇒ 路径被删空后这条只会恒绿`)
for (const rel of paths) {
// 不写成 `if (existsSync(rel)) assert(...)`:文件改名后那条断言永久拿不到执行,正是 brief §Step 3 ⚠ 禁止的形状。
assert.ok(existsSync(resolve(rel)), `清单声明的文件不存在: ${rel}(Task 7 的护栏读不到文件必须红,不许静默跳过)`)
}
})