Files
crawler-plugin/admin-frontend-vue/tests/align-operation-guide.test.ts
T
huangzd1997 0002e4eb36 fix(前端): 公司 tab 五处"声称保护但不保护"的钉子补上牙齿
Task 7 评审回文判定 Needs fixes,逐条关掉:
- wiring 正向半支的 api 断言从裸 token 改成 /company_id[:=]/,page 侧再钉
  companyTab.requestCompanyId(页面取公司值的唯一出口),且 api/page 两侧
  都先 stripComments——注释里出现字面量不算接线。
- 同一个双层循环改成收集 problems 后 deepEqual([]):Task 8-12 共用这把尺子,
  fail-fast 会让做完自己那页的人只看到指向别人页的红。现在一次列全 8 页缺口。
- guide 文案补"一页不多"半边:按两个已存在的判别子串反钉 key 全集,外加
  两句都不许进 OPERATION_GUIDE_FALLBACK。删掉模板里的 <OperationGuide />
  这类"留着 import 就绿"的写法一并改掉(wiring 与 align-guide 两处同形)。
- GET /companies 失败原本零痕迹:store catch 出 error 后再抛(口径照
  admin-session.ts),组件侧 .catch + console.warn,loaded 不翻转 => fail-closed
  不画 tab 条。没加任何用户可见文字/提示条。

取证在独立 worktree D:/tmp-wt-19fe 做:注释假接线 2 条、删挂载点 1 条,
HEAD 版用例分别复现盲区(fail 0 / 不列该页),新版全红;对照轮 0 注入
guide 10/10、wiring 6 支 1 红;注入文件逐份 cmp 字节一致,scratch git status 空。

已知一条刻意红灯仍在:company-tab-wiring.test.ts 的正向半支,Task 8-12 接线
完成后由收敛它的那笔提交销账。全量 1726/1725/1,vue-tsc rc=0。
2026-10-05 06:46:23 +08:00

128 lines
7.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 { readSource } from './helpers.ts'
import { adminPages } from '../src/router/routes.ts'
import { COMPANY_SCOPED_PAGES } from '../src/config/company-scope.ts'
import {
OPERATION_GUIDES,
OPERATION_GUIDE_FALLBACK,
OPERATION_GUIDE_STORAGE_KEY,
operationGuideFor,
} from '../src/layout/operation-guides.ts'
/** 对齐旧版 admin-interactions.js guides 表:每业务菜单页顶部展示可折叠「当前页面操作提示」,文案沿用旧版原文;店铺撞款监控(例外)不展示。 */
const EXCEPTED_KEY = 'admin_shop_data_duplicate_check'
test('align_guide_users_matches_reference_text', () => {
const g = operationGuideFor('admin_users')
assert.ok(g)
assert.equal(g.text, '先用筛选定位账号,再编辑角色和菜单权限;删除账号会要求二次确认。')
assert.deepEqual(g.steps, ['筛选账号', '编辑权限', '确认保存'])
})
test('align_guide_history_and_version_reference_text', () => {
assert.match(operationGuideFor('admin_history')!.text, /生成记录可按用户和时间范围回溯/)
assert.deepEqual(operationGuideFor('admin_version')!.steps, ['上传压缩包', '检查版本记录', '维护历史版本'])
})
test('align_guide_group_manage_own_text', () => {
// 2026-10-05 公司 tab(spec §9.3):这页从"沿用旧版通用 fallback"改成自带文案——
// 上一行"对齐旧版 guides 表原文"的约定在这一页是**故意破的**,因为那句 tab 说明
// 不能塞进 fallback(fallback 会被没进 tab 的页共用,等于把 tab 端给它们)。
const g = operationGuideFor('admin_group_manage')
assert.ok(g)
assert.notEqual(g, OPERATION_GUIDE_FALLBACK)
assert.match(g.text, /超级管理员可用页面上方的公司 tab 切换公司/)
assert.deepEqual(g.steps, ['选择分组', '维护负责人与归属账号', '核对店铺可见范围'])
})
test('align_guide_duplicate_check_not_present', () => {
// 例外页:不展示提示条(不参与本轮对齐)。
assert.equal(operationGuideFor(EXCEPTED_KEY), null)
assert.equal(EXCEPTED_KEY in OPERATION_GUIDES, false)
})
test('align_guide_unknown_key_null', () => {
assert.equal(operationGuideFor(undefined), null)
assert.equal(operationGuideFor(null), null)
assert.equal(operationGuideFor('not-a-menu'), null)
assert.equal(operationGuideFor(''), null)
})
test('align_guide_every_router_page_has_guide_except_duplicate_check', () => {
// 路由注册表里的业务页除例外页外都应有独立/兜底提示。
const without = adminPages.filter((p) => p.menuKey !== EXCEPTED_KEY)
assert.ok(without.length >= 15, '业务页至少 15')
for (const page of without) {
assert.ok(operationGuideFor(page.menuKey), `缺少 guide: ${page.menuKey}`)
}
})
test('align_guide_storage_key_matches_legacy', () => {
assert.equal(OPERATION_GUIDE_STORAGE_KEY, 'shufuAdminGuideCollapsed')
})
test('align_guide_component_in_layout_headline', () => {
const layout = readSource('src/layout/AdminLayout.vue')
// 钉**模板挂载点**而不是 import 行(2026-10-05 修复轮 1):
// 只写 /OperationGuide/ 时,删掉模板里的 <OperationGuide /> 、留着那行 import 还是绿
// ——与 company-tab-wiring.test.ts 那条同形状,只覆盖一处等于没覆盖。
assert.match(layout, /<OperationGuide \/>/, '壳层模板必须挂着 <OperationGuide />')
const comp = readSource('src/layout/OperationGuide.vue')
assert.match(comp, /当前页面操作提示/, '标题对齐旧版 adminOperationGuide 语义')
assert.match(comp, /收起提示/, '折叠按钮文案')
assert.match(comp, /展开提示/, '展开按钮文案')
assert.match(comp, /operationGuideFor\(route\.meta\.menuKey\)/, '按菜单 key 查文案')
assert.match(comp, /OPERATION_GUIDE_STORAGE_KEY/, '折叠态读写同一 localStorage key')
})
test('align_guide_fallback_shape', () => {
assert.equal(OPERATION_GUIDE_FALLBACK.steps.length, 3)
assert.ok(OPERATION_GUIDE_FALLBACK.text.length > 10)
})
test('guide_copy_carries_company_tab_note_for_every_scoped_page', () => {
// spec §9.3:tab 会改行数观感,承载方式是既有引导文案(不新做控件)。
// 分母=COMPANY_SCOPED_PAGES,杜绝"加了一页忘了补文案"。
const need = COMPANY_SCOPED_PAGES.map((p) => p.menuKey)
assert.ok(need.length >= 8, '取样集非空自检:注册表应当至少有 8 页进了 tab 范围')
for (const key of need) {
const g = operationGuideFor(key)
assert.ok(g, `注册表页缺 guide: ${key}`)
assert.match(g.text, /超级管理员可用页面上方的公司 tab 切换公司/, `${key} 缺 §9.3 那句`)
}
// C 类两页(spec §5):它们要的是**另一句**——"这页不参与",不是"会随 tab 变"。
// 分母**取注册表里显式写 companyScoped:false 的页**,不抄名单:漏写一条 ⇒ 这支在自检那句红。
const scoped = new Set(COMPANY_SCOPED_PAGES.map((p) => p.menuKey))
const cClass = adminPages.filter((p) => p.companyScoped === false).map((p) => p.menuKey)
assert.ok(cClass.length >= 2, '取样集非空自检:注册表里显式 companyScoped:false 的至少 C 类那两页')
for (const key of cClass) {
assert.equal(scoped.has(key), false, `${key} 既声明 false 又在清单里,两处口径打架`)
const g = operationGuideFor(key)
assert.ok(g, `不参与 tab 的页缺 guide: ${key}`)
assert.match(g.text, /全平台共享,不按公司区分/, `${key} 缺 §5 那句`)
assert.equal(g.text.includes('公司 tab 切换公司'), false, `${key} 不该带 tab 那句(它不参与)`)
}
// 「一页不多」的另一半(2026-10-05 修复轮 1):上面只钉了「8 页必须有」+「C 类两页不得有」,
// 没钉「其余页都不得有」。今天 21 个 key 里 admin_columns / admin_version / admin_tutorial 等 10 条 text
// 没有任何内容锚 ⇒ 把 tab 那句追加到其中任一页,全套用例仍然绿;而那句等于把 tab 端给一页不参与 tab 的页,
// 正是 Step 7.2 禁止把它塞进 fallback 的同一个理由。判别子串取**已存在的字面量**,不新造句子。
// 反向分母取 OPERATION_GUIDES 的全部 key(不是 adminPages):没带文案的页走 fallback,由下面那支单独钉。
const withTabNote = Object.keys(OPERATION_GUIDES).filter((k) => operationGuideFor(k)!.text.includes('公司 tab 切换公司'))
assert.deepEqual(withTabNote.sort(), [...need].sort(),
'tab 那句只能出现在 COMPANY_SCOPED_PAGES 那 8 页:多一页 = 把公司 tab 端给一页不参与 tab 的页')
const withNotAppliedNote = Object.keys(OPERATION_GUIDES).filter((k) => operationGuideFor(k)!.text.includes('全平台共享,不按公司区分'))
assert.deepEqual(withNotAppliedNote.sort(), [...cClass].sort(),
'「本页不参与」那句只能出现在注册表显式 companyScoped:false 的页:多一页 = 给了它没有的口径')
// fallback 会被所有没带独立文案的页共用,所以这两句都不许进它(Step 7.2 的理由,上面按 key 的分母盖不到)。
assert.equal(OPERATION_GUIDE_FALLBACK.text.includes('公司 tab 切换公司'), false,
'tab 那句不许进 OPERATION_GUIDE_FALLBACK:等于把 tab 端给所有没有独立文案的页')
assert.equal(OPERATION_GUIDE_FALLBACK.text.includes('全平台共享,不按公司区分'), false, '同上:「本页不参与」那句也不许进 fallback')
// 反向钉:这句话只能由文案承载。tab 组件里再长出"当前公司:X"就是第二处表达(§12 第 5 条未批)。
const tabs = readSource('src/layout/CompanyTabs.vue')
assert.ok(tabs.length > 0, '取样集非空自检:CompanyTabs.vue 读到了')
assert.equal(tabs.includes('company-tab-hint'), false, '不许有页头"当前公司"提示条')
assert.equal(tabs.includes('当前公司'), false, '同上:当前公司只由 is-active 的 tab 表达')
})