diff --git a/admin-frontend-vue/src/stores/admin-session.ts b/admin-frontend-vue/src/stores/admin-session.ts index 1124e5323..42d546be3 100644 --- a/admin-frontend-vue/src/stores/admin-session.ts +++ b/admin-frontend-vue/src/stores/admin-session.ts @@ -28,9 +28,10 @@ export const useAdminSessionStore = defineStore('admin-session', { try { this.user = await fetchCurrentUser() // 剪枝是角色内在闸门的第三处(注册表 + 守卫 + 菜单树),必须在 this.user 赋值之后。 + // 角色判定用 store 自己的 isSuperAdmin getter:守卫读的就是它,两处各算一次会靠约定对齐。 this.menuTree = pruneSuperAdminOnly( canonicalizeMenuTree(await fetchAdminMenuTree()), - isSuperAdminRole(this.user?.role), + this.isSuperAdmin, ) this.initialized = true } catch (error) { diff --git a/admin-frontend-vue/src/types/vue-router.d.ts b/admin-frontend-vue/src/types/vue-router.d.ts index 060c45a52..577e8d780 100644 --- a/admin-frontend-vue/src/types/vue-router.d.ts +++ b/admin-frontend-vue/src/types/vue-router.d.ts @@ -6,5 +6,7 @@ declare module 'vue-router' { title?: string /** 菜单 key(对应后端菜单节点 key);仅页面级鉴权使用。 */ menuKey?: string + /** 角色内在闸门:由 routeOf() 从注册表抄来,router/index.ts 消费;不声明则两端都只是字符串约定,改名 vue-tsc 认不出。 */ + superAdminOnly?: boolean } } diff --git a/admin-frontend-vue/tests/company-super-admin-only.test.ts b/admin-frontend-vue/tests/company-super-admin-only.test.ts index d20e17889..077bf732f 100644 --- a/admin-frontend-vue/tests/company-super-admin-only.test.ts +++ b/admin-frontend-vue/tests/company-super-admin-only.test.ts @@ -1,9 +1,11 @@ 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 } from '../src/router/routes.ts' +import { adminPages, routeOf } from '../src/router/routes.ts' import { pruneSuperAdminOnly } from '../src/router/helpers.ts' -import { SUPER_ADMIN_ONLY_MENU_KEYS } from '../src/config/company-scope.ts' +import { SUPER_ADMIN_ONLY_MENU_KEYS, COMPANY_SCOPED_PAGES } from '../src/config/company-scope.ts' /** 公司配置是角色内在闸门,不是菜单授权(spec §2:菜单授权可以被人改坏,role 不能)。 * 12:3x 事故的教训是"把页面可见性当数据可见性用",这里反过来防另一个方向:只挂一处会留旁路。 */ @@ -16,8 +18,14 @@ test('超管专属页必须同时被注册表与口径清单认领(两处不 test('路由守卫里必须有一条与菜单树无关的角色判定', () => { const guard = readSource('src/router/index.ts') - assert.match(guard, /superAdminOnly/, '守卫没查角色硬闸门') - assert.match(guard, /isSuperAdmin/, '守卫必须先判 session.isSuperAdmin') + // 锚在真实语句上,不是只扫 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('剪枝:非超管拿不到超管专属节点,超管一个字节都不少', () => { @@ -45,3 +53,48 @@ test('C 类两页必须显式声明 companyScoped: false(spec §5:声明, 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 的护栏读不到文件必须红,不许静默跳过)`) + } +})