2cae0d742c
「切 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 未在生产执行。
137 lines
9.1 KiB
TypeScript
137 lines
9.1 KiB
TypeScript
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)
|
||
// 批次 4 起这页参与公司 tab ⇒ 原文之后追加那句 §9.3,不再逐字相等(同 group-manage 那处故意偏离)。
|
||
assert.match(g.text, /^先用筛选定位账号,再编辑角色和菜单权限;删除账号会要求二次确认。/)
|
||
assert.match(g.text, /超级管理员可用页面上方的公司 tab 切换公司/)
|
||
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,杜绝"加了一页忘了补文案"。
|
||
// 唯一豁免 = EXCEPTED_KEY(撞款监控不展示提示条,那句没有可挂的地方);豁免是**显式列出的**,
|
||
// 新页缺文案仍会红(operationGuideFor 对没登记的 key 返回 null ⇒ assert.ok(g) 当场红,没有兜底可糊)。
|
||
const scopedKeys = COMPANY_SCOPED_PAGES.map((p) => p.menuKey)
|
||
const need = scopedKeys.filter((k) => k !== EXCEPTED_KEY)
|
||
assert.ok(need.length >= 15, `取样集非空自检:注册表今天有 ${scopedKeys.length} 页进了 tab 范围(批次 1 的 8 页 + 批次 2 的 5 页 + 批次 3 的 2 页 + 批次 4 的 1 页),减去唯一豁免页后只剩 ${need.length} 页`)
|
||
assert.ok(scopedKeys.includes(EXCEPTED_KEY),
|
||
'取样集前提自检:撞款监控已不在 COMPANY_SCOPED_PAGES 里,上面那道豁免就成了空豁免——把它连同 EXCEPTED_KEY 一起删掉')
|
||
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 的页**,不抄名单:漏写一条 ⇒ 这支在自检那句红。
|
||
// 批次 2 之前这里是 2 页(店铺密钥 + 商品类目),商品类目已接上公司口径 ⇒ 今天只剩 admin_shop_keys
|
||
// 一条,所以自检降到 1;再往下掉就是有人把注册表里那条 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 >= 1, '取样集非空自检:注册表里显式 companyScoped:false 的一条都不剩了——那这句判据就是空跑')
|
||
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 那 ' + need.length + ' 页:多一页 = 把公司 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 表达')
|
||
})
|