b7acfc0eef
本批两件事,加上随本批一起入仓的并行会话在制品: 一、菜单权限按公司隔离(批次 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
105 lines
7.3 KiB
TypeScript
105 lines
7.3 KiB
TypeScript
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 的护栏读不到文件必须红,不许静默跳过)`)
|
||
}
|
||
})
|