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:
@@ -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) {
|
||||
|
||||
@@ -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 的护栏读不到文件必须红,不许静默跳过)`)
|
||||
}
|
||||
})
|
||||
|
||||
Reference in New Issue
Block a user