import test from 'node:test' import assert from 'node:assert/strict' import { readSource } from './helpers.ts' import { adminPages } from '../src/router/routes.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.match(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', () => { const g = operationGuideFor('admin_group_manage') assert.ok(g) assert.notEqual(g, OPERATION_GUIDE_FALLBACK) 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/ 时,删掉模板里的 、留着那行 import 还是绿 // ——与 company-tab-wiring.test.ts 那条同形状,只覆盖一处等于没覆盖。 assert.match(layout, //, '壳层模板必须挂着 ') 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) }) /** * 2026-10-14 控制方把公司 tab 那几句观感说明撤了:提示条按 menuKey 取、不分支角色, * 谁能进这一页谁就看得到。「超级管理员可用上方 tab 切换」「本页全平台共享」这类只对超管成立的话 * 会摊到普通账号脸上,所以整批撤掉。这支用例是反向钉:**不允许回流**。 * * 两把尺子:① ASCII 的 `tab`,②那四句原文(从已提交的那一版操作提示表里拿回来的,不是抄写)。 * ②单独不可信——中文串在工具链里被插进一个字就会永远匹配不上,而负向断言照样绿; * 所以下面先钉死「这四句都含 ASCII 的 tab」,让①成为即使②坏了也还有牙的那一把。 */ test('company_tab_copy_is_pulled_from_every_guide_and_must_not_come_back', () => { const REMOVED = [ '\u8d85\u7ea7\u7ba1\u7406\u5458\u53ef\u7528\u9875\u9762\u4e0a\u65b9\u7684\u516c\u53f8 tab \u5207\u6362\u516c\u53f8\uff0c\u5207\u6362\u540e\u884c\u6570\u4f1a\u53d8\u5316\u2014\u2014\u884c\u6570\u53d8\u5c11\u4e0d\u662f\u6570\u636e\u4e22\u4e86\u3002', '\u672c\u9875\u5168\u5e73\u53f0\u5171\u4eab\uff0c\u4e0d\u6309\u516c\u53f8\u533a\u5206\uff1a\u8d85\u7ea7\u7ba1\u7406\u5458\u5207\u6362\u4e0a\u65b9\u516c\u53f8 tab \u65f6\u5b83\u4e0d\u4f1a\u53d8\uff0c\u8fd9\u4e0d\u662f\u7b5b\u9009\u574f\u4e86\u3002', '\u5e97\u94fa\u5f52\u54ea\u5bb6\u516c\u53f8\u7531\u300c\u8d1f\u8d23\u4eba\u300d\u51b3\u5b9a\uff0c\u4e0d\u7531\u516c\u53f8 tab \u51b3\u5b9a\uff1a\u8d1f\u8d23\u4eba\u9009\u81ea\u5df1\uff0c\u5e97\u94fa\u5c31\u843d\u5728\u4f60\u81ea\u5df1\u90a3\u5bb6\u3002', '\u8d85\u7ea7\u7ba1\u7406\u5458\u5207\u6362\u4e0a\u65b9\u516c\u53f8 tab \u540e\uff0c\u5217\u8868\u53ea\u4fdd\u7559\u5f53\u524d\u516c\u53f8\u8d26\u53f7\u76f8\u5173\u7684\u5206\u7ec4\u3002', ] const keys = Object.keys(OPERATION_GUIDES) assert.ok(keys.length >= 20, `分母只有 ${keys.length} 页,不像整张注册表`) // 禁句自检:四条互不相同、都够长、且都含 ASCII 锚 tab —— 少一条下面那把 ASCII 尺子就盖不住。 assert.equal(new Set(REMOVED).size, 4, '禁句清单塌了') for (const s of REMOVED) { assert.ok(s.length > 20, `禁句短得可疑:${s}`) assert.ok(s.includes('tab'), `禁句不含 ASCII 锚 tab,反向断言会失明:${s}`) } for (const key of keys) { const text = operationGuideFor(key)!.text assert.equal(text.includes('tab'), false, `${key} 的文案又出现了 tab`) for (const s of REMOVED) { assert.equal(text.includes(s), false, `${key} 又带回了撤掉的那句:${s}`) } } // fallback 会被所有没有独立文案的页共用,那四句同样不许进它。 assert.equal(OPERATION_GUIDE_FALLBACK.text.includes('tab'), false, 'tab 那句不许进 fallback') // 撤的是文案,不是功能:tab 条还在,而且仍然只由 tab 自己表达"当前哪家"。 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 表达') assert.ok(tabs.includes('useCompanyTabStore'), '公司 tab 本身没被一起撤掉') })