test(前端): 补 routeOf meta 抄送与 companyScoped 双向对账(闸门②原来是零约束)

F1 闸门②行为用例: routeOf() 实跑 producer, 取样自 adminPages.superAdminOnly(不写死 menuKey),
   含取样非空自检与"普通页 meta 不许出现 superAdminOnly"的反向自检。
F2 守卫断言从松散 /superAdminOnly/ 收紧为锚在 `if (to.meta.superAdminOnly && !session.isSuperAdmin)`
   真实语句上; 原 /isSuperAdmin/ 那条已被锚定式覆盖且被 index.ts:57 预先满足, 不再单列。
F3 新增 companyScoped ↔ COMPANY_SCOPED_PAGES 双向对账(>=8 页自检)与 17 条声明路径存在性
   (existsSync 作断言不作守卫, >=17 自检)——Task 7 护栏 G1 的分母掉一行不再无人报警。
F4 src/types/vue-router.d.ts 补 superAdminOnly?: boolean, producer/consumer 的键从字符串约定
   变为编译期契约(控制方已追认, 与 task-29.test.ts 那条同批)。
F5 剪枝的角色实参改用 store 自己的 isSuperAdmin getter, 与守卫同一谓词; task-29 正则未受影响。

变异自证 4 轮 + 3 轮加强(注入→红→从原始字节还原并 sha256 复核): routeOf 删抄送行→F1 红;
去一个 companyScoped: true→F3 对账红(含分母保持 8 的方向一/虚增一行的方向二);
清单路径改名→F3 存在性红; 守卫条件改名→F2 红(且"删语句只留注释 token"这一形状旧断言恒绿、新断言红)。
node --test 聚焦 6 文件 37/37; vue-tsc --noEmit rc=0; npm test 1701/1701(基线 1698 + 新增 3 支)。
This commit is contained in:
2026-10-04 18:48:03 +08:00
parent 468fd353f3
commit ca910c582f
3 changed files with 61 additions and 5 deletions
@@ -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) {
+2
View File
@@ -6,5 +6,7 @@ declare module 'vue-router' {
title?: string
/** 菜单 key(对应后端菜单节点 key);仅页面级鉴权使用。 */
menuKey?: string
/** 角色内在闸门:由 routeOf() 从注册表抄来,router/index.ts 消费;不声明则两端都只是字符串约定,改名 vue-tsc 认不出。 */
superAdminOnly?: boolean
}
}
@@ -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 的护栏读不到文件必须红,不许静默跳过)`)
}
})