Files
crawler-plugin/admin-frontend-vue/tests/company-tab-wiring.test.ts
T
huangzd1997 ca78bd27e9 feat(前端): 公司 tab(store+组件+G1 双向对账)+ §9.3 引导文案承载
批次 1 的 tab 机制半边:默认选中 id 最小的启用公司、不允许「全部」;「该不该画
tab 条」只住 store 一处(组件里再数一遍 length 就是第二把尺子);两家全停用时
activeId 为 null ⇒ 整条不渲染,不画出按钮为零的空 tab 条。

G1 双向对账 + 跨端常量钉子(后端 SUPER_ADMIN_ONLY_KEYS ↔ 前端
SUPER_ADMIN_ONLY_MENU_KEYS 由代码执行地相等,读不到/抽不到/空集三种都判红)
+ pageFiles↔routes.ts load() 对账,把 Task 8-12 的接线欠债钉成会红的尺子。

§9.3 的「行数会随 tab 变」由既有引导文案承载(8 页 + C 类 2 页各一句,句子抽成
常量防手抄差异),不新做页头控件/提示条。

已知一条刻意红灯:company-tab-wiring.test.ts 的正向半支在 Task 12 接线完成前必红
(plan 19 Step 8 明令),下一条补齐接线的提交收敛它。全量 1726 例仅此 1 红,
vue-tsc --noEmit 通过。

AdminLayout.vue / operation-guides.ts / company-config-entry-super-only.test.ts
三支文件此刻同时带着另一路会话的未提交改动,本提交按 hunk 逐行只入自己的部分。
2026-10-05 06:06:42 +08:00

143 lines
9.8 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, readFileSync, readdirSync } from 'node:fs'
import { readSource } from './helpers.ts'
import { adminPages } from '../src/router/routes.ts'
import { COMPANY_SCOPED_PAGES, SUPER_ADMIN_ONLY_MENU_KEYS } from '../src/config/company-scope.ts'
const read = (p: string) => {
assert.ok(existsSync(p), `护栏读不到 ${p}:api 文件改名了,清单必须同步(别把用例改成"不存在就跳过")`)
return readFileSync(p, 'utf8')
}
test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company_id,页面组件必须 watch activeId', () => {
for (const page of COMPANY_SCOPED_PAGES) {
assert.ok(adminPages.some((p) => p.menuKey === page.menuKey && p.companyScoped),
`${page.menuKey} 在清单里但注册表没声明 companyScoped`)
for (const file of page.apiFiles) {
assert.match(read(file), /company_id|companyId/, `${file} 声明参与公司 tab 却没下传 company_id`)
}
for (const file of page.pageFiles) {
assert.match(read(file), /watch\(\(\)\s*=>\s*companyTab\.activeId/,
`${file} 没监听公司 tab:切 tab 不重取数 = 这页的 tab 是装饰品`)
}
}
})
test('反向:把 company_id 当查询参数用的取数模块必须被清单认领(防止"筛了但没人知道这页参与")', () => {
const claimed = new Set(COMPANY_SCOPED_PAGES.flatMap((p) => p.apiFiles))
const scanned = requestModules()
// 取样自检:扫描本身失效(目录改名/递归参数写错)时下面这支会"零文件 ⇒ 恒绿"。
assert.ok(scanned.length >= 35, `只扫到 ${scanned.length} 个取数模块,requestModules 八成是坏了`)
for (const file of scanned) {
if (claimed.has(file)) continue
const text = stripComments(readFileSync(file, 'utf8'))
assert.equal(/['"]company_id['"]|\bcompany_id\s*[:=]/.test(text), false,
`${file} 自己塞了 company_id 参数但没进 COMPANY_SCOPED_PAGES——它绕过了唯一清单`)
}
})
test('两张清单不许重叠:超管专属页不可能同时是按公司看数据的页', () => {
const scoped = new Set(COMPANY_SCOPED_PAGES.map((p) => p.menuKey))
for (const key of SUPER_ADMIN_ONLY_MENU_KEYS) assert.equal(scoped.has(key), false)
})
/** 分母 = **会把 company_id 发出去的模块**:`src/api` 下的 .ts 与 `src/pages` 下名字以 `-api.ts` 结尾的模块,实测 40 个。
* 不是"所有 .ts"(135 个):查询对象的**类型**声明住在 `history-dto.ts`、`image-video-filter.ts`、`shop-dto.ts`
* 这些兄弟模块里(Task 8/10/11 要给它们加 `company_id?: number`),类型行本身长得像"用了 company_id",
* 拿全量 .ts 当分母会让反向用例红在一行类型声明上,而那一行本来就该存在。 */
function requestModules(): string[] {
return ['src/api', 'src/pages'].flatMap(listTs)
.filter((f) => f.startsWith('src/api/') || f.endsWith('-api.ts'))
}
function listTs(dir: string): string[] {
// Node 24 的 readdirSync 支持 recursive + withFileTypes;parentPath 是新字段,path 是旧字段,两个都要兜。
// Windows 上递归结果的 parentPath 带反斜杠(`src\pages\shop\shop-manage-api.ts`),不转正斜杠就永远匹配不上 claimed。
return readdirSync(dir, { withFileTypes: true, recursive: true })
.filter((e) => e.isFile() && e.name.endsWith('.ts'))
.map((e) => `${(e as { parentPath?: string }).parentPath ?? e.path}/${e.name}`.split(/[\\/]+/).join('/'))
}
// 去掉注释再匹配:**这是这支用例能不能用的关键**。
// 全仓目前只有一处 company_id 字面量——src/pages/account/user-create-model.ts:68 的注释
// 「故意不带 company_id:归属由后端 resolveTargetCompanyId 落操作者自己的公司」。
// 不剥注释,反向用例会在一条**说明为什么不传参**的注释上红,然后下一个人把它写成行级临时豁免,整支用例就废了。
// 剥注释的写法要连 `//` 行注释一起剥,但**不许**顺手放宽成"整文件不匹配"。
// (这一段用 `//` 而不是 `/** */`:brief 原文里的示例正则 `if (!/^\s*\*/.test(line))` 含 `*/`,
// 放进块注释会把注释当场截断,node 的 TS 解析器随即报 ERR_INVALID_TYPESCRIPT_SYNTAX——整支用例加载都失败。)
function stripComments(source: string): string {
return source
.replace(/\/\*[\s\S]*?\*\//g, '')
.split(/\r?\n/)
.filter((line) => !line.trimStart().startsWith('//'))
.join('\n')
}
/** 从 routes.ts 逐行解析 `menuKey` → `load: () => import('@/pages/…')` 的目标文件(相对工程根的正斜杠路径)。
* 注册表今天是「一页一行」的字面量数组,所以按行取;解析不出来由用例判红,不静默放行。 */
function loadSpecByMenuKey(): Map<string, string> {
const map = new Map<string, string>()
for (const line of readSource('src/router/routes.ts').split(/\r?\n/)) {
const menuKey = /menuKey:\s*'([^']+)'/.exec(line)?.[1]
const spec = /load:\s*\(\)\s*=>\s*import\(['"]@\/([^'"]+)['"]\)/.exec(line)?.[1]
if (menuKey && spec) map.set(menuKey, `src/${spec}`)
}
return map
}
test('清单的 pageFiles 必须就是注册表里同页的 load 组件:改名或挪目录时这支要红,不能让 tab 静默指向不存在的页', () => {
const loads = loadSpecByMenuKey()
assert.ok(loads.size >= 20, `只从 routes.ts 解析出 ${loads.size} 条 load,解析式八成是坏了`)
for (const page of COMPANY_SCOPED_PAGES) {
const target = loads.get(page.menuKey)
assert.ok(target, `${page.menuKey} 在注册表里没解析出 load 组件:routes.ts 的写法变了,分母不能静默放行`)
assert.ok(page.pageFiles.includes(target),
`${page.menuKey} 的路由组件是 ${target},清单 pageFiles 却列了别处——护栏盯的就不是这页真正渲染的那个文件`)
for (const file of [...page.pageFiles, ...page.apiFiles]) {
assert.ok(existsSync(file), `${page.menuKey} 的清单指向不存在的文件:${file}`)
}
}
})
test('跨端常量钉子:后端 SUPER_ADMIN_ONLY_KEYS 与前端 SUPER_ADMIN_ONLY_MENU_KEYS 由代码执行地逐字相等', () => {
// Task 4 的出口 1/2/3 全靠后端那份 Set,前端侧边栏/守卫靠这份数组,两份各写各的迟早漂移。
// readSource 以 admin-frontend-vue 为根,'../backend-java/…' 落在大仓里(先例:tests/align-menu-auto-key.test.ts:36)。
// 判红口径:读不到文件(readSource 直接抛)/ 抽不到常量 / 取样集为空,三种都算红,不许"文件不存在就跳过"。
const java = readSource('../backend-java/src/main/java/com/nanri/aiimage/modules/permission/service/PermissionMenuService.java')
const def = /SUPER_ADMIN_ONLY_KEYS\s*=\s*Set\.of\(([^)]*)\)/.exec(java)
assert.ok(def, '没从 PermissionMenuService.java 抽到 SUPER_ADMIN_ONLY_KEYS = Set.of(…) 这一句:后端换了写法就得同步这份钉子')
const backend = [...def[1].matchAll(/"([^"]+)"/g)].map((m) => m[1])
assert.ok(backend.length >= 1, '后端那份常量取样为空(Set.of() 空集 = 闸门没写)')
assert.ok(SUPER_ADMIN_ONLY_MENU_KEYS.length >= 1, '前端名单为空 = 这道闸门等于没写')
assert.deepEqual([...backend].sort(), [...SUPER_ADMIN_ONLY_MENU_KEYS].sort(),
'超管专属菜单两份名单不等值:后端摘掉的那项前端仍会显示(或反之),§8.1 的口径就分成两处')
})
test('挂载与单一尺子:tab 条挂在壳层、公司名读 companyName、「该不该画」只住 store 一处', () => {
const layout = readSource('src/layout/AdminLayout.vue')
assert.ok(layout.includes(`import CompanyTabs from '@/layout/CompanyTabs.vue'`), '壳层没 import CompanyTabs')
assert.ok(layout.includes('<CompanyTabs />'), '壳层没挂 <CompanyTabs />')
assert.ok(layout.includes('OperationGuide'), '挂 tab 时不许把 OperationGuide 摘掉(align_guide_component_in_layout_headline 钉着)')
const tabs = readSource('src/layout/CompanyTabs.vue')
assert.ok(tabs.length > 0, '取样集非空自检:CompanyTabs.vue 读到了')
assert.ok(tabs.includes('item.companyName'), 'CompanyTabs 的标签文本必须读 companyName(CompanyItem 没有 name 字段)')
// 排他断言:\bitem\.name\b 不匹配 item.companyName,写错字段名只会渲染出空白 tab,不会编译报错。
assert.equal(/item\.name\b/.test(tabs), false, '不许写 item.name:模板属性访问不受 vue-tsc 约束,只会静默渲染空白 tab')
// 「该不该画 tab 条」只许有一把尺子(store 的 visibleForOperator):组件里再数一遍 length 就是第二把。
assert.ok(tabs.includes('tab.visibleForOperator'), '组件的 show 必须直接抄 store 的 visibleForOperator')
assert.equal(tabs.includes('length > 1'), false, '组件里不许再数一遍 length——停用一家时与 store 的口径会差 1')
const store = readSource('src/stores/company-tab.ts')
assert.ok(store.includes('visibleForOperator(): boolean'), 'store 缺 visibleForOperator')
assert.match(store, /visibleForOperator\(\)[\s\S]{0,160}isSuperAdmin/, 'visibleForOperator 必须含 isSuperAdmin 判定')
assert.match(store, /visibleForOperator\(\)[\s\S]{0,160}this\.loaded/, 'visibleForOperator 必须含 loaded 判定,免得先闪出空 tab')
// 第三把条件不是新尺子:activeId 由 firstSelectableCompanyId 算,它本身就是「存在至少一家启用公司」。
// 少了它,两家全停用时 companies.length > 1 照样成立 ⇒ 画出一条容器在、按钮为零的空 tab 条。
assert.match(store, /visibleForOperator\(\)[\s\S]{0,260}this\.activeId !== null/,
'visibleForOperator 必须含「有可选公司」判定,全是停用公司时 tab 条整体不渲染')
assert.match(store, /requestCompanyId\(\)[\s\S]{0,120}companyIdForRequest/,
'requestCompanyId 必须是 companyIdForRequest 的唯一出口(页面只读这个 getter)')
})