Files
crawler-plugin/admin-frontend-vue/tests/company-super-admin-only.test.ts
T
huangzd1997 2cae0d742c feat(公司tab): 批次 2/3/4 再接 8 页,注册表收到 16 页——用户页回流 company_id 按新边界改写反向钉
「切 tab 数据还一样」的根因一直是分母小于现实:批次 1 只登记 8 页,本轮按控制方
三次点名扩到 16 页(company-scope.ts 是唯一清单,routes.ts 的 companyScoped 逐页对平)。

批次 2(五页 ASIN 中心):去重总数据 / 不符合ASIN / 查询ASIN / 最低价ASIN / 商品类目。
批次 3(两页店铺中心):撞款监控、店铺数据记录。这两页没有归属列可筛,归属口径是
「本公司账号名下的店铺」——后端由 DataReadScope 推公司 → 成员账号 → biz_shop_manage.
created_by_id,前端只把 activeId 当 company_id 送下去。空成员集必须交空集合,绝不能
退化成 null(null 在这里=全量,那样第二家会看到全部数据)。
批次 4(用户管理):后端早就认 company_id(只对站点超管生效,公司超管恒锁本公司),
断的是前端——UserListQuery 里连这个字段都没有,三家 tab 看的是同一份全量列表。

三处口径改动,逐条说明:
1)company-user-list.test.ts 的反向钉被改写。2026-10-04 定案把公司维度从用户页整体摘掉,
   那条钉的原文是「列表查询/筛选/行渲染不允许出现公司维度」。控制方 2026-10-05 明确要
   用户管理区分公司 tab,所以钉的边界收窄成两半:渲染层(行级公司列、「所属公司」标签、
   筛选状态、顶栏公司名)仍不得回流;请求层的 company_id 是这次加回来的,尺子换成
   「取值口唯一」——页面每处 companyId 都必须等于 companyTab.requestCompanyId,且
   normalizeUserPageParams/toUserListQuery 两只白名单构造器体内不许出现公司值。
   新增一支行为钉:往归一化里传 companyId 必须被丢掉,这是 users.ts 读原始入参的全部理由
   (写成 normalized.companyId 时 TS 照样绿、运行时恒 undefined)。
2)align-dup-console 那条 watch 看守的 token 扩到含 reload。变异自证里「删掉 void
   loadConsole()」当场全绿:体里的清筛选项守住了,重新取数那半没人守。批次 3/4 三对
   token 一起写到 reload 为止(批次 1/2 的老条目不动)。
3)公司管理页补正/反向两把尺子:company-config-entry-super-only 新增「吃公司 tab 的页面
   集合恰好等于 COMPANY_SCOPED_PAGES 的 pageFiles」——按代码真值比,不按清单比,所以
   清单不改一字而往 CompaniesPage.vue 里塞 store 也会红。谓词带括号,否则 import 行也算消费者。

菜单权限(admin_columns)本轮不动:MenusPage 只消费 /api/admin/permission-menus 这一份全局
菜单字典,切 tab 一样是数据本身全局,不是筛选坏了。真问题在写侧——PermissionMenuService
create/update/delete 只有 ensureAdminOperatorIfPresent(isAdmin 即放行),公司管理员改的是
全平台的菜单行。收窄为仅站点超管 vs 给 permission_menu 加归属列,两种改法代价差一个量级,
留给控制方定档。

护栏:G1 发送口 22 个 / 页面分组 17、watch 体看守 10 对、operation-guide 的 tab 文案 15 页
(撞款监控是显式豁免,另有一条自检盯「豁免落空」)。
变异自证 12/12 全杀(前端 10 + 公司管理反向钉 2),分母钉死在 27 例。
门禁:后端全量 3823 例 / 0 失败 / 0 错误 / 7 skipped,BUILD SUCCESS;admin-frontend-vue
1741 例 / 0 红;vue-tsc rc=0。首轮后端 4 红是另一路 task_partial 改动与本轮编译抢跑,
单跑 13 例已绿,本笔不含他们的任何文件。

未上线:jar 与 admin-vue 都没出包,V147 未在生产执行。
2026-10-06 02:32:59 +08:00

104 lines
7.1 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)接上了公司口径,
// 今天只剩紫鸟令牌这一页真的是"全平台共享、与公司无关"。
// 想再往这页上加 false 的对向(把某页改回 false)不用改这里:上面那条双向对账会红。
for (const key of ['admin_shop_keys']) {
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 的护栏读不到文件必须红,不许静默跳过)`)
}
})