Files
crawler-plugin/admin-frontend-vue/tests/company-tab-wiring.test.ts
T

1057 lines
84 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 { occurrences, 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'
import { companyTabAppliesTo } from '../src/layout/company-tab-model.ts'
const read = (p: string) => {
assert.ok(existsSync(p), `护栏读不到 ${p}:api 文件改名了,清单必须同步(别把用例改成"不存在就跳过")`)
// 与 helpers.readSource 同口径归一行尾(CRLF 检出树会把有界窗口判据挤红,见 helpers 里的注释)。
return readFileSync(p, 'utf8').replace(/\r\n/g, '\n')
}
/**
* 取值口登记表(2026-10-05 修复轮 1,复评 I-2)。上面那条正向判据原本只问「有没有把 company_id 当成查询
* 参数下传」,`/company_id\s*[:=]/` 对**右半边从哪儿取值**是瞎的:评审把
* `history-api.ts` 的 `query.company_id = params.companyId` 改成 `= normalized.companyId` 之后,
* 缺口清单与 baseline **逐字相同**(`admin_history` 都不出现)、`vue-tsc` 也不红
* (`normalizeHistoryParams` 的返回类型就是 `HistoryListParams`,本轮刚给它加了 `companyId?: number | null`,
* 所以 `normalized.companyId` 类型合法、运行时恒 `undefined`)。tab 画了、请求发了、参数没有——
* 这正是本批次要杀的那类静默失效,尺子却看不见。
* <p>于是每页登记一条"company_id 右侧的根标识符**必须**是该页 api 函数自己的入参"的形状:
* `shape` 为 `RegExp` 时,对**剥完注释的源码**求值,不匹配即红并点名文件;`shape` 为 `null` 是
* "这一页还没接线"的显式声明(批次 1 的 8 页到 Task 10 全部登记完,今天表里没有 null 项了;
* 这一档留着是给将来新页先进清单、后接线的中间状态用的,不是默认分支)。
* <p>两道不留缝:① `COMPANY_SCOPED_PAGES` 里每一页都必须在表里有条目,缺条目直接红;
* ② 一旦某个文件真的出现了 `company_id` 下传而它的 `shape` 还是 `null`,同样红——
* 所以"新页接线时顺手不改登记表"过不去,也**没有**"没登记就退回宽松判据"的默认分支。
*/
type CompanyIdPin = { readonly file: string; readonly shape: RegExp | null; readonly note: string }
/** 任务看板这一页发送口的共同形状:五处都是「函数自己那行把 companyId 塞进 query」(缩进两格,逐字相同)。 */
const TASK_CENTER_SEND_LINE = 'if (companyId != null) query.company_id = companyId'
/**
* 一条钉 = 一个发送口:窗口上界。2026-10-05 复评 N-3 把举证口径写死成判据真正求值的那份文本
* (`stripComments(read(file))`,块注释连内部换行一起删)与那两个端点:
* - 从 `function <fn>(` 的**括号后**起算(这是 `[\s\S]{0,320}` 的实际预算):
* 「→ 它自己那行的 `company_id`」= 121/111/161/214/217,
* 「→ 同文件下一个发送口的 `company_id`」= 438/690/(无)/853/(无)。
* - 从 `function` 这个词的头起算(旧举证用的口径,比上组各多 33~36):154/147/196/238/244 与 471/726/(无)/877/(无)。
* ⇒ 320 够得着自己的行(最紧 217),够不到隔壁(最紧 438,余量 **118 字符**):删掉任一处,那条 shape 就匹配不出
* (不是"文件里还有别人在发"就算过)。
* ⚠ 下面那段「拆条取样自检·负样本」只证明「窗口有界」,它跟着窗口预算自动缩放 ⇒ **证明不了余量还在**。
* 把 320 调大之前必须按第一组口径重测这五个数;api 函数体写长会先假红(fail-closed,可接受)。
* 批次 2 起这一档改成 `SendPoint.window`(每处一个值),举证不再靠这段注释,
* 而由「窗口与真文件对平」那条用例逐处重测 own/next。
*/
const TASK_CENTER_WINDOW = 320
/** 一个登记项 = 一个字面发送口(一函数一处、逐处一条,一条都不许并)。 */
interface SendPoint {
readonly menuKey: string
readonly file: string
/** 这一处所在函数的名字:shape 锚在 `function <fn>(` 的括号后,红点直接报到函数。 */
readonly fn: string
/** 塞键那一整行(缩进不入锚串)。整行入锚而不只锚 `company_id = companyId`:
* 评审把 `params.companyId` 改成 `normalized.companyId` 时形状判据(复评 I-2)要能红,
* 锚右半边的字面量才是举证。 */
readonly line: string
/** 从 `function <fn>(` 括号后到自己那一行的字符预算,见上面 TASK_CENTER_WINDOW 的注释。 */
readonly window: number
readonly title: string
}
/** 正则字面量转义:`line` 里带 `( ) . = { } $ [ ]` 与反引号,不转义就匹配到别处(sendArgsShape 同一把尺子)。 */
function escapeRegExp(text: string): string {
return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
}
/**
* 全部 25 个字面发送口:批次 1 的任务看板 5 处 + 批次 2(控制方 2026-10-05 点名「切 tab 数据还一样」那五页)7 处
* + 批次 3(控制方 2026-10-05 点名「店铺撞款监控 店铺数据也要做隔离」那两页)4 处
* + 批次 4(控制方 2026-10-05 点名「菜单权限和用户管理也要区分公司 tab 的数据」里的用户管理)1 处
* + 批次 5(控制方 2026-10-06 点名「店铺密钥管理的数据按照公司区分」)1 处
* + 批次 6(控制方 2026-10-06 点名「菜单权限也加字段来区分」)3 处:菜单目录 / 新建菜单 / 用户管理里的授权树
* + 批次 7(2026-11-10 v1.3 外观专利无侵权数据)2 处:只读列表 + 导出(2026-11-11 客户需求「数据得导出来」)。
* 批次 2 原 12 处里的品牌库 1 处 + 商品类目 4 处,随 2026-10-06「这两页退回全平台共享」一并摘掉。
*
* <p>`window` 的取法:本轮实扫的 own(到自己那行的距离)+ ≥150 余量,且当同文件还有下一个同名发送口时必须
* `window < next`。own/next 不写死在这里——下面「窗口与真文件对平」那条用例逐处从真文件重算,
* `own >= window`(函数体写长)或 `window >= next`(窗口够到隔壁)都当场红。</p>
*
* <p>三个 `*-export.ts` 的 own 天生比 api 侧大(构造器是多行签名 + 一串前置筛选条件:625/528/827),
* 它们的 `line` 在同文件只出现 1 次(对平闸门数得出),所以"窗口会不会够到隔壁"在这一族是空命题,
* 真正的看守是「这一处脱管就没人钉」。</p>
*
* <p>批次 3 的撞款控制台三个发送口把塞键行的左值各起一个名字(query / params / itemsQuery):
* 三处若逐字同行,(文件, 整行) 分组会把它们并成一组、要求钉 3 条,而「窗口够不到隔壁」这条判据
* 在同一行重复时才有意义——左值不同名既是真代码的样子,也让每条钉各自点到唯一一个发送口。</p>
*/
const SEND_POINTS: ReadonlyArray<SendPoint> = [
{ menuKey: 'admin_task_center', file: 'src/api/task-center.ts', fn: 'fetchTaskCenterOverview', line: TASK_CENTER_SEND_LINE, window: TASK_CENTER_WINDOW, title: 'GET /overview 汇总卡' },
{ menuKey: 'admin_task_center', file: 'src/api/task-center.ts', fn: 'fetchTaskCenterShopOptions', line: TASK_CENTER_SEND_LINE, window: TASK_CENTER_WINDOW, title: 'GET /shop-options 店铺候选' },
{ menuKey: 'admin_task_center', file: 'src/api/task-center.ts', fn: 'fetchTaskCenterTaskDetail', line: TASK_CENTER_SEND_LINE, window: TASK_CENTER_WINDOW, title: 'GET /tasks/detail 详情(brief 点名那一处)' },
{ menuKey: 'admin_task_center', file: 'src/pages/task-center/task-center-model.ts', fn: 'buildTaskQuery', line: TASK_CENTER_SEND_LINE, window: TASK_CENTER_WINDOW, title: '任务列表 query 构造器' },
{ menuKey: 'admin_task_center', file: 'src/pages/task-center/task-center-model.ts', fn: 'buildVariantQuery', line: TASK_CENTER_SEND_LINE, window: TASK_CENTER_WINDOW, title: '变体采集 query 构造器' },
{ menuKey: 'admin_dedupe_total_data', file: 'src/pages/asin/dedupe-total-api.ts', fn: 'fetchDedupeTotalList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 400, title: 'GET /dedupe-total-data 列表' },
{ menuKey: 'admin_dedupe_total_data', file: 'src/pages/asin/dedupe-total-api.ts', fn: 'fetchDedupeTotalGroups', line: 'http.get<unknown>(DEDUPE_GROUPS_ENDPOINT, { params: companyId != null ? { company_id: companyId } : {} })', window: 400, title: 'GET /shop-manages/groups 分组候选(与店铺管理同源,两页口径要对得上)' },
{ menuKey: 'admin_dedupe_total_data', file: 'src/pages/asin/dedupe-total-export.ts', fn: 'buildDedupeExportParams', line: 'if (companyId != null) params.company_id = String(companyId)', window: 800, title: 'GET /dedupe-total-data/export 导出' },
{ menuKey: 'admin_dedupe_total_data', file: 'src/pages/asin/dedupe-import-api.ts', fn: 'startDedupeImport', line: "if (companyId != null) form.append('company_id', String(companyId))", window: 400, title: 'POST /dedupe-total-data/import 新增导入(写侧归属,不发就落进操作者自己那一家)' },
{ menuKey: 'admin_dedupe_total_data', file: 'src/pages/asin/dedupe-import-api.ts', fn: 'startDedupeDeleteImport', line: "if (companyId != null) form.append('company_id', String(companyId))", window: 900, title: 'POST /dedupe-total-data/delete-import 删除导入(不发就会按别家的值删错行)' },
{ menuKey: 'admin_query_asin', file: 'src/pages/asin/query-asin-api.ts', fn: 'fetchQueryAsinList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 400, title: 'GET /query-asins 列表' },
{ menuKey: 'admin_query_asin', file: 'src/pages/asin/query-asin-export.ts', fn: 'buildQueryAsinExportParams', line: 'if (companyId != null) params.company_id = String(companyId)', window: 700, title: 'GET /query-asins/export 导出' },
{ menuKey: 'admin_skip_price_asin', file: 'src/pages/asin/skip-price-api.ts', fn: 'fetchSkipPriceList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 400, title: 'GET /skip-price-asins 列表(最低价 ASIN)' },
{ menuKey: 'admin_skip_price_asin', file: 'src/pages/asin/skip-price-export.ts', fn: 'buildSkipPriceExportParams', line: 'if (companyId != null) params.company_id = String(companyId)', window: 1000, title: 'GET /skip-price-asins/export 导出(本批新建:原先 href 不带任何参数=恒导全平台)' },
// ↓ 批次 3 的两页(控制方 2026-10-05 点名「店铺撞款监控 店铺数据也要做隔离」)。
// 撞款三处各锚一个左值名(query/params/itemsQuery),店铺数据记录一处。
{ menuKey: 'admin_shop_data_duplicate_check', file: 'src/pages/tasks/duplicate-console-api.ts', fn: 'fetchDuplicateConsole', line: 'if (companyId != null) query.company_id = companyId', window: 400, title: 'GET /duplicate-check-console 指标/店铺/撞款全集/分组统计' },
{ menuKey: 'admin_shop_data_duplicate_check', file: 'src/pages/tasks/duplicate-console-api.ts', fn: 'fetchDuplicateLedger', line: 'if (companyId != null) params.company_id = companyId', window: 400, title: 'GET /duplicate-check-ledger 全部 ASIN 台账分页' },
{ menuKey: 'admin_shop_data_duplicate_check', file: 'src/pages/tasks/duplicate-console-api.ts', fn: 'requestDuplicateExportBlob', line: 'if (companyId != null) itemsQuery.company_id = companyId', window: 400, title: 'GET /duplicate-check-export 导出(不带就导全平台)' },
{ menuKey: 'admin_shop_data_crawl_tasks', file: 'src/pages/tasks/shop-data-api.ts', fn: 'fetchShopDataTaskList', line: 'if (companyId != null) query.company_id = companyId', window: 400, title: 'GET /shop-data-crawl-tasks 店铺数据记录列表' },
// ↓ 批次 4(控制方 2026-10-05 点名「菜单权限和用户管理也要区分公司 tab 的数据」)。
{ menuKey: 'admin_users', file: 'src/api/users.ts', fn: 'fetchUserList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 400, title: 'GET /users 用户列表(后端早就认这个参数,断的是前端没发)' },
// ↓ 批次 5(控制方 2026-10-06 点名「店铺密钥管理的数据按照公司区分」)。
{ menuKey: 'admin_shop_keys', file: 'src/pages/shop/shop-key-api.ts', fn: 'fetchShopKeyList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 400, title: 'GET /shop-keys 紫鸟令牌列表(不带 company_id 时非超管仍由后端会话裁剪,超管点了 tab 才会变)' },
// ↓ 批次 6(控制方 2026-10-06 点名「菜单权限也加字段来区分,现在的默认归到 admin 下」,定案「每家公司一套树」)。
// 三处都锚同一串 TASK_CENTER_SEND_LINE,但分属两个文件 ⇒ (文件, 整行) 分组各成一组,钉数与条数仍逐处对平。
// 窗口取 300:两处 menu-manage 的 own 是 110/130,而 fetchMenuManageNodes 到 createMenu 那行的 next 是 611
// ⇒ 300 够得着自己、够不到隔壁(这三个数由下面「窗口与真文件对平」那条用例逐处从真文件重测,注释过期即红)。
// user-menu-auth-api 那处一条发送口喂两个 GET(admin/app 两类各一支,共用同一个 query 展开)⇒ 一函数一钉。
{ menuKey: 'admin_columns', file: 'src/pages/account/menu-manage-api.ts', fn: 'fetchMenuManageNodes', line: TASK_CENTER_SEND_LINE, window: 300, title: 'GET /permission-menus 目录(超管不带就把两家的同名行混成一排下发)' },
{ menuKey: 'admin_columns', file: 'src/pages/account/menu-manage-api.ts', fn: 'createMenu', line: TASK_CENTER_SEND_LINE, window: 300, title: 'POST /permission-menus 新建:归属由端点参数决定,前端不从树里猜' },
{ menuKey: 'admin_users', file: 'src/pages/account/user-menu-auth-api.ts', fn: 'fetchGrantableMenus', line: TASK_CENTER_SEND_LINE, window: 300, title: 'GET /permission-menus?grantableOnly 授权树:一家一套树后取错公司=已授权勾不上、提交必判无效' },
// ↓ 批次 7(2026-11-10 v1.3 外观专利无侵权数据):出表成功自动同步的只读明细,归属物化在行
// company_id 列(V189,同店铺密钥形状)⇒ 后端正门 readCompanyIdOrOwn;2026-11-11 客户需求
// 「数据得导出来」补导出发送口(与列表共用同一过滤面与正门)。这一页共两个发送口
// (同日曾加的 /supervisors 取数与按主管删除两口,随当晚「恢复昨天那个明细表格式」一并
// 下架——后端接口保留,前端发送口撤,重上时从 e1767faf 历史找回再登记)。
// 窗口 500:own 实测 416(groupId 行加入后),同文件两条塞键行的间距 1585 ⇒
// 500 够得着自己、够不到隔壁(对平用例逐处从真文件重算,注释过期即红)。
{ menuKey: 'admin_appearance_patent_clean_items', file: 'src/pages/patent/appearance-patent-clean-api.ts', fn: 'fetchAppearancePatentCleanList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 500, title: 'GET /appearance-patent-clean-items 无侵权只读列表' },
{ menuKey: 'admin_appearance_patent_clean_items', file: 'src/pages/patent/appearance-patent-clean-api.ts', fn: 'exportAppearancePatentCleanList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 500, title: 'GET /appearance-patent-clean-items/export 导出(2026-11-11 客户需求「数据得导出来」,与列表共用同一过滤面)' },
// ↓ 批次 8(2026-11-14 v1.4 京东数据库;2026-11-15 公共化改口径):京麦店铺商品采集落库的
// 只读镜像,行 company_id 只剩"哪家公司客户端同步的"来源标记。2026-11-15 用户定案
// 「京东数据库不区分公司、属于公共的」「分组和亚马逊功能一样」⇒ 详情/编辑/删除/分组管理
// 的 6 个 company_id 发送口整批撤下(后端写侧同窗摘掉公司谓词,重上时从 git 历史找回);
// 留下的两个公司维度出口=只读列表与类目下拉(仅超管生效=筛选管理员,普通管理员没有
// 这个筛选)。导出发送口已随 2026-11-15 客户口径「导出也不用」从前端下线(后端 /export
// 端点保留,前端发送口撤,重上时从 git 历史找回发送行再登记——同批次 7 主管两口的先例)。
{ menuKey: 'admin_jd_database', file: 'src/pages/jd/jd-product-api.ts', fn: 'fetchJdProductList', line: 'if (params.companyId != null) query.company_id = params.companyId', window: 500, title: 'GET /jd-products 京东数据库只读列表(超管公司 tab 筛选=筛选管理员)' },
{ menuKey: 'admin_jd_database', file: 'src/pages/jd/jd-product-api.ts', fn: 'fetchJdProductCategories', line: 'if (companyId != null) query.company_id = companyId', window: 500, title: 'GET /jd-products/categories 类目下拉(选项集与超管当前 tab 行集同源)' },
]
/** 任务看板那 5 处(1b ④ 那条用例按文件筛它们,沿用旧名字不漂;表只有一份,不会漂出两个口径)。 */
const TASK_CENTER_SEND_POINTS: ReadonlyArray<SendPoint> =
SEND_POINTS.filter((p) => p.menuKey === 'admin_task_center')
/** 一条钉 = 一个发送口:锚在自己的函数开行上,要求窗口内出现「塞键」那一整行。 */
function pointShape(p: SendPoint): RegExp {
return new RegExp(`function ${p.fn}\\([\\s\\S]{0,${p.window}}${escapeRegExp(p.line)}`)
}
/** 正样本用的迷你源码:函数开行 + 它自己那行塞键(缩进、形状逐字照抄真实发送口)。 */
function pointCompliant(p: SendPoint): string {
return `function ${p.fn}(companyId?: number | null) {\n const query: QueryParams = {}\n ${p.line}\n`
}
/** 同一页的取值口钉由 SEND_POINTS 现算,不许手写:手写会和表漂开(复评 I-1 拆条的初衷)。 */
function pinsFor(menuKey: string): readonly CompanyIdPin[] {
return SEND_POINTS.filter((p) => p.menuKey === menuKey).map((p) => ({
file: p.file,
shape: pointShape(p),
note: `发送口 ${p.fn}(${p.title}):company_id 的右半边必须是本函数自己的入参(表里登记的整行锚),`
+ '值由页面传 companyTab.requestCompanyId;红点归属见「窗口与真文件对平」那条用例',
}))
}
const COMPANY_ID_SOURCE_PINS: Readonly<Record<string, readonly CompanyIdPin[]>> = {
admin_history: [
{
file: 'src/pages/records/history-api.ts',
// fetchHistoryList(params: Partial<HistoryListParams>):唯一入参对象是 params(history-api.ts:15 的形状)。
shape: /company_id\s*=\s*params\.companyId\b/,
note: 'normalizeHistoryParams 是白名单构造(只点名 page/pageSize/userId/timeStart/timeEnd),从 normalized 读 companyId 恒 undefined',
},
],
admin_image_video_tasks: [
{
file: 'src/pages/tasks/image-video-api.ts',
// fetchImageVideoTasks(filter, page, pageSize, companyId):公司值的入参就是第 4 个形参本身(:19 的形状),
// 不是 filter 的字段——toImageVideoQuery 同样是白名单构造。
shape: /company_id\s*=\s*companyId\b/,
note: 'filter 走 toImageVideoQuery 白名单构造,公司值只能落在 companyId 形参上',
},
],
// 五个发送口五条钉(一函数一条),不是一条文件级钉数五处:判据形状见 SEND_POINTS 的举证。
// 这一页也不许套 Task 8 的 `params.companyId` 形——api 侧 `tasks`/`variant-tasks` 是 `params: QueryParams`
// 直传、没有 params.companyId 这个口,公司键由 model 那两个 builder 补进同一个对象。
admin_task_center: pinsFor('admin_task_center'),
admin_user_secret_usage: [
{
file: 'src/api/user-secret-usage.ts',
// fetchUserSecretUsage(params: UserSecretUsageQuery):唯一入参对象是 params(形参表即形状来源,不写行号——api 文件一改就漂)。
shape: /company_id\s*=\s*params\.companyId\b/,
note: 'query 由本函数自己从零构造,companyId 只能取自 params;api 模块不碰 Pinia store(node --test 直接 import 会抛 no active pinia)',
},
],
admin_user_secrets: [
{
file: 'src/api/user-secrets.ts',
// fetchUserSecretList(params: UserSecretQuery):唯一入参对象是 params(同上,不写行号)。
shape: /company_id\s*=\s*params\.companyId\b/,
note: '同上:值由 UserSecretsPage.vue 传 companyTab.requestCompanyId,api 里不读任何归一化/构造出来的中间对象',
},
],
admin_device_logs: [
{
file: 'src/api/device-logs.ts',
// fetchDeviceLogFiles(params: DeviceLogQuery):唯一入参对象是 params,query 由本函数逐字段从零构造。
shape: /company_id\s*=\s*params\.companyId\b/,
note: 'query 是白名单构造(只点名 page/pageSize/source/uid/startDate/endDate),公司值只许取原始 params 的 companyId——取自任何中间/归一化对象都是 TS 绿、运行时恒 undefined',
},
],
admin_group_manage: [
{
file: 'src/pages/account/shop-group-api.ts',
// fetchShopGroups(companyId?: number | null):唯一发送口,右侧必须是它自己的形参。
shape: /company_id\s*:\s*companyId\b/,
note: 'null 由发送口自己丢掉(`companyId != null ? { company_id: companyId } : {}`,Task 11 修复轮起不再依赖 axios 丢 null)⇒ 非超管不发 company_id,后端按会话裁剪',
},
],
admin_shop_manage: [
{
file: 'src/pages/shop/shop-manage-api.ts',
// fetchShopManageList(params):toShopManagePageQuery 是白名单构造 ⇒ 公司值只许从原始 params 读。
shape: /company_id\s*=\s*params\.companyId\b/,
note: '写成 normalized.companyId 会 TS 绿、运行时恒 undefined(Task 8 复评 I-2 那个洞)',
},
{
file: 'src/pages/shop/shop-manage-api.ts',
// 第二个发送口 fetchShopManageGroups(companyId):同一个 GET /groups,与分组管理页共用这一形。
// 两条各管一处取值口,不许合成一条 alternation —— 那等于把判据放松回「文件里出现过就行」。
shape: /company_id\s*:\s*companyId\b/,
note: '列表窄了而下拉不窄 = 两页口径对不上,且下拉能选到别家的组',
},
],
// 批次 2 剩下的三页:取值口钉全部由 SEND_POINTS 现算(一页几处发送口就几条钉),
// 手写一份就会和表漂开——那正是复评 I-1 拆条要避免的形状。
// admin_invalid_asin_data / admin_product_categories 两页 2026-10-06 退回全平台共享,
// 已不在注册表里 ⇒ 这里的条目一并摘掉(留着是死表项,"不得回流"由文件末尾那条反向钉看守)。
admin_dedupe_total_data: pinsFor('admin_dedupe_total_data'),
admin_query_asin: pinsFor('admin_query_asin'),
admin_skip_price_asin: pinsFor('admin_skip_price_asin'),
// 批次 3 的两页同样由 SEND_POINTS 现算(撞款控制台三处发送口 = 三条钉)。
admin_shop_data_duplicate_check: pinsFor('admin_shop_data_duplicate_check'),
admin_shop_data_crawl_tasks: pinsFor('admin_shop_data_crawl_tasks'),
// 2026-10-25 关键词使用记录:三个 GET 共用 toQuery,company_id 只许取函数自己的 params.companyId。
admin_keyword_usage: [
{
file: 'src/pages/tasks/keyword-usage-api.ts',
shape: /company_id\s*=\s*params\.companyId\b/,
note: 'toQuery 是白名单构造,公司值只能来自调用方传入的 params.companyId(页面从 companyTab.requestCompanyId 取)',
},
],
admin_users: pinsFor('admin_users'),
// 批次 5(店铺密钥)同样由 SEND_POINTS 现算:这一页只有一个发送口(列表),
// 新增/编辑/删除/白名单检测四支都不带公司参数——归属由后端从操作者会话推导(writeCompanyId 闸门)。
admin_shop_keys: pinsFor('admin_shop_keys'),
// 批次 6(菜单权限):菜单目录 + 新建两处,都由 SEND_POINTS 现算。
// 编辑/删除/重排三支**故意不带**参数——归属由那一行的 id 与操作者公司共同判定,跨公司写后端 403
// (见 docs/ops/menu-company-tree-design-2026-10-06.md §5),给它们发 company_id 反而是第三处口径。
admin_columns: pinsFor('admin_columns'),
// 批次 7(v1.3 无侵权只读页):同样由 SEND_POINTS 现算——只有一个发送口(列表)。
admin_appearance_patent_clean_items: pinsFor('admin_appearance_patent_clean_items'),
// 批次 8(v1.4 京东数据库):列表一口(导出发送口 2026-11-15 随客户口径下线),由 SEND_POINTS 现算。
admin_jd_database: pinsFor('admin_jd_database'),
}
/** 严格判据的分母由本轮实扫得出(修完不许恒绿也不许恒红):求值了几条 shape、其中几条通过。 */
let strictPinsEvaluated = 0
/**
* 「company_id 真被下传」的形状。原先只认 `company_id:` / `company_id =` 两形——那是按
* 「一律走查询参数」写的。去重库的导入与删除导入走 multipart body(form.append),
* 同一件事换了载体就被判成没接线;这里把那一形补进来,取值口仍按登记表的 shape 逐条严判。
*/
const COMPANY_ID_WIRED = /company_id\s*[:=]|form\.append\(\s*['"]company_id['"]/
let strictPinsPassed = 0
test('正向:声明 companyScoped 的页,其 api 文件必须真的带 company_id,页面组件必须 watch activeId', () => {
// 循环里**收集**、循环后一次性断言:Task 8-12 是 5 个任务共用这把尺子,fail-fast 时做完自己那页的同事
// 仍然只看到一句指向**别人页**的红,判断不出本页是否已收敛。
// 这条只是让尺子可诊断——红消息里 8 页缺口逐页列全(批次 1 到 Task 10 已全部接线,今天这支应绿)。
const problems: string[] = []
for (const page of COMPANY_SCOPED_PAGES) {
const gaps: string[] = []
if (!adminPages.some((p) => p.menuKey === page.menuKey && p.companyScoped)) {
gaps.push('注册表里这一页没声明 companyScoped:清单与注册表两处口径打架')
}
for (const file of page.apiFiles) {
// 只认「当成了查询参数」那一形(`company_id:` / `company_id =`),不再认裸 token:
// 旧式 /company_id|companyId/ 接近恒真,Task 8-12 只要写一行 `const companyId = null`
// 或一句「// 由 companyId 决定」就能把这页判成已接线,而实际什么都没下传(约束 6:注释不算)。
// 读之前先 stripComments,与反向那半支同口径——说明注释里的 company_id 不是接线。
if (!COMPANY_ID_WIRED.test(stripComments(read(file)))) {
gaps.push(`${file} 没把 company_id 下传(查询参数或 multipart 字段都算,裸 token 不算)`)
}
}
// 取值口登记(复评 I-2):光"把 company_id 塞进查询对象"不够,右半边必须取自**本函数自己的入参**。
for (const pin of COMPANY_ID_SOURCE_PINS[page.menuKey] ?? []) {
if (!page.apiFiles.includes(pin.file)) {
gaps.push(`${pin.file} 登记在 ${page.menuKey} 名下,但 COMPANY_SCOPED_PAGES 的 apiFiles 里没有它:登记表与清单两处口径打架`)
continue
}
const src = stripComments(read(pin.file))
const wired = COMPANY_ID_WIRED.test(src)
if (pin.shape === null) {
// 没登记取值口却已经下传了参数 = 这一页的取值口径没人看守(洞就是这么留下的)。
if (wired) gaps.push(`${pin.file} 已经把 company_id 当下传参数了,登记表里 shape 却还是 null —— 把它换成"company_id 右侧 = 本函数入参"的正则`)
continue
}
strictPinsEvaluated++
if (!wired) {
gaps.push(`${pin.file} 登记了取值口 ${pin.shape},文件里却一个 company_id 都没下传:登记表与代码漂移(要么接线回来,要么把 shape 改回 null)`)
continue
}
if (!pin.shape.test(src)) {
gaps.push(`${pin.file} 的 company_id 右半边不是本函数入参(登记表要求 ${pin.shape};${pin.note})`
+ '—— tab 画了、请求发了、参数没有;编译器不一定看得见(normalizeHistoryParams 的返回类型里就有这个字段)')
continue
}
strictPinsPassed++
}
for (const file of page.pageFiles) {
// 与 api 侧同口径先剥注释(约束 6:注释里出现字面量不算接线)——否则一句
// `// 这里读 companyTab.requestCompanyId` 就能同时骗过下面两条断言。
// 残留面已封:stripComments 现在 JS 的 `//`、`/* */` 与 Vue 模板的 `<!-- -->` 三类都剥。
const source = stripComments(read(file))
if (!/watch\(\(\)\s*=>\s*companyTab\.activeId/.test(source)) {
gaps.push(`${file} 没监听公司 tab:切 tab 不重取数 = 这页的 tab 是装饰品`)
}
// brief Interfaces 明定的唯一取值出口:页面取公司值一律写 companyTab.requestCompanyId。
// 裸调 companyIdForRequest 是纯函数、签名要两个入参,不满足这条 ⇒ 顺带封死第三处取值口径。
if (!/companyTab\.requestCompanyId/.test(source)) {
gaps.push(`${file} 没读 companyTab.requestCompanyId(页面取公司值的唯一出口)`)
}
}
// 覆盖性自检:清单里每一页都必须在登记表里有条目。**没有**"没登记就退回宽松判据"这条路。
if (!(page.menuKey in COMPANY_ID_SOURCE_PINS)) {
gaps.push(`${page.menuKey} 在 COMPANY_ID_SOURCE_PINS 里没有条目:接线的页必须登记取值口,护栏不许留默认分支`)
}
if (gaps.length) problems.push(`${page.menuKey}:${gaps.join(';')}`)
}
// 正样本自检:求值了却一条都没通过 ⇒ 严格判据恒红(或形状不认),红在缺口清单里、不抢本页的诊断信息。
if (strictPinsEvaluated > 0 && strictPinsPassed === 0) {
problems.push(`(取值口取样自检)shape 求值了 ${strictPinsEvaluated} 条、通过 0 条 —— 判据恒红或形状不认,不可信`)
}
// 严格半支的取样自检:登记表是空的、或一页都没走完 shape 求值 ⇒ 这半支等于没写,用例自己红。
assert.ok(strictPinsEvaluated >= 2,
`取值口严格判据本轮只求值了 ${strictPinsEvaluated} 条(登记表里 admin_history / admin_image_video_tasks 两条 shape 都在,`
+ `求值数不可能低于已接线页数)——判据空转,normalized-vs-params 那个洞又没人看守了`)
assert.ok(COMPANY_ID_SOURCE_PINS.admin_history.some((p) => p.shape !== null)
&& COMPANY_ID_SOURCE_PINS.admin_image_video_tasks.some((p) => p.shape !== null),
'Task 8 已接线的两页在登记表里的 shape 被改回 null 了:严格判据对这两页不再起作用(正样本归零)')
// —— 取值口拆条钉的取样自检(全局约束 15:反向钉必须自带同支正样本,
// 不许让另一支用例替我证明"这串本来就会被匹配到")。
// ⚠ 身份要说清:下面这几条是对**字面量字符串**求值的探针,只证明判据形状没写坏
// (正样本匹配得出 ⇒ 不恒红;窗口外的负样本不匹配 ⇒ 窗口真有界,删一处不会靠隔壁过关),
// 任何代码注入都不会让它们红。真覆盖 = 上面 loop 里那批 shape(条数由 strictPinsEvaluated 当场自证)
// 对真实文件的求值 + 变异自证。
// ⚠ 分母是本轮实扫的表条数(批次 1 的 5 + 批次 2 的 7 + 批次 3 的 4 + 批次 4 的 1 + 批次 5 的 1 + 批次 6 的 3;
// 批次 2 原 12 条里的品牌库 1 条 + 商品类目 4 条随 2026-10-06「这两页退回全平台共享」摘掉)。
// 这条只防"整表被摘空/被改窄",逐处脱管由下面两条(对平闸门 + 窗口对平)负责。
// 2026-11-15 京东数据库公共化(用户定案「不区分公司、属于公共的」):批次 8 的详情/删除/
// 分组列表/删分组/编辑 5 条 company_id 发送口随公司谓词整批撤下(后端写侧同窗摘),批次 8
// 只剩列表/类目两条(超管筛选管理员)⇒ 32 → 27。
assert.ok(SEND_POINTS.length >= 27,
`发送口表只剩 ${SEND_POINTS.length} 条(批次 1+2+3+4+5+6 实扫 21 条 + 批次 7 v1.3 无侵权列表/导出 2 条 + 主管聚合 1 条 + 按主管删除 1 条 + 批次 8 v1.4 京东数据库列表/类目 2 条(详情/删除/分组/删分组/编辑 5 口随 2026-11-15 公共化撤、导出口随客户口径下线)= 27 条)⇒ 有人把钉从表里摘了,取值口看守成空`)
for (const p of SEND_POINTS) {
const shape = pointShape(p)
const compliant = pointCompliant(p)
assert.ok(shape.test(compliant),
`(拆条取样自检·正样本)${p.fn} 的合规样本都匹配不出 ${shape} ⇒ 这条钉恒红,删没删发送口都会红,等于没看守`)
const deleted = compliant.replace(` ${p.line}\n`, '')
+ ' '.repeat(p.window + 1) + p.line
assert.equal(shape.test(deleted), false,
`(拆条取样自检·负样本)${p.fn} 删掉自己那一行、只剩窗口外的隔壁发送口却仍然匹配 ⇒ 窗口够得到了隔壁,删一处不会红`)
}
// 拆条的补集(复评 I-1 的另一半):一条钉管一个发送口 ⇒ 每个 (文件, 塞键整行) 登记的钉数
// 必须等于它在该文件的实际条数。
// 红点归属要说实(2026-10-05 复评 N-1):shape 不匹配只往 gaps 里记,得等本用例末尾的
// `assert.deepEqual(problems, [])` 才喊,而这条闸门在同一 test 体内**先执行** ⇒
// 「删源码里的塞键那一行」(变异自证 M1–M5 就是这一形)实际报的是这里的「钉数 ≠ 实际条数」消息
// (点名到文件,点不到函数)。顺序不许倒过来:取样自检与这条闸门先跑,判据坏了要先说"判据坏了"。
// 上面那 5 条 shape 独家点名的字面发送口条数不变,只有它能红——函数名改了(锚点消失)、
// 或那一行还在但离自己函数开行超过了窗口(前面被写长)。
// 这一条杀的是「把 TASK_CENTER_SEND_POINTS 删剩 4 行」——少一条钉就等于少一处看守,而 5 条 shape 谁都不会红。
// 路线 ②(occurrences 计数)在这里只当"钉数与发送口条数对平"的闸门,不当"是哪一处"的判据:
// 计数回答不了"哪三处"(把一处重复写三遍、另一处删掉,计数照样对平),所以主判据仍是路线 ① 的函数名锚 + 有界窗口。
// 分母按 (文件, 整行) 而不是按文件:任务看板的 task-center.ts 一个文件三处发送口、三处是逐字同一行,
// 按文件计只钉得出"3 条"这个数,按行计才和 occurrences 同一粒度;三个 *-export.ts 的行各只出现 1 次,同理。
const grouped = new Map<string, { readonly file: string; readonly line: string; pinned: number }>()
for (const p of SEND_POINTS) {
const key = p.file + '|' + p.line
const hit = grouped.get(key)
if (hit) hit.pinned += 1
else grouped.set(key, { file: p.file, line: p.line, pinned: 1 })
}
assert.equal(grouped.size, 21,
`发送口表按 (文件, 整行) 应聚成 21 组(32 处发送口,批次 7 的列表/导出/主管聚合/按主管删除、批次 8 的京东详情/删除/分组/类目/删分组/编辑逐字同行各走同一组;京东导出口 2026-11-15 随客户口径下线),现在却有 ${grouped.size} 组 —— 表被改形状了,对平判据失去分母`)
for (const g of grouped.values()) {
const actual = occurrences(stripComments(read(g.file)), g.line)
assert.equal(g.pinned, actual,
`${g.file} 里实际有 ${actual} 处「${g.line}」,登记表却只钉了 ${g.pinned} 条 —— `
+ '有一处发送口脱管(一函数一钉:钉数必须与该文件该行的实际条数对平)')
}
// 同支正样本(全局约束 15:计数判据不许"0 == 0 也算对平"就当自己成立):字面样本里有两条,occurrences 必须数得出 2。
const twoSendLines = `function f() {\n ${TASK_CENTER_SEND_LINE}\n}\nfunction g() {\n ${TASK_CENTER_SEND_LINE}\n}\n`
assert.equal(occurrences(twoSendLines, TASK_CENTER_SEND_LINE), 2,
'(计数取样自检·正样本)occurrences 连两条字面发送口都数不出来 ⇒ 上面那条逐行对平恒真,等于没看守')
// 窗口预算与真文件对平:批次 2 把上面 TASK_CENTER_WINDOW 那段"320 够得着自己、够不到隔壁"的举证从注释挪进代码,
// 逐处从**当前源码**重算两个距离,注释过期也不会骗人:
// own = 从 `function <fn>(` 的括号后到自己那一行的距离 ⇒ 必须 < window(函数体写长 = 假红,fail-closed 可接受);
// next = 到同文件**下一条同名发送行**开头的距离 ⇒ 存在时必须 > window(否则删一处还有隔壁顶着,这条钉就是摆设)。
// 隔壁的"名字"用的是自己的整行,所以 next 只在同文件有逐字同行的另一处时才有意义:
// product-category-api.ts 那组(三处同行)2026-10-06 随「商品类目退回全平台共享」摘掉了;
// 这一族剩下的真冲突面只有任务看板:task-center.ts 三处逐字同行、task-center-model.ts 两处,其余各文件唯一。
for (const p of SEND_POINTS) {
const src = stripComments(read(p.file))
const anchor = 'function ' + p.fn + '('
const anchorCount = occurrences(src, anchor)
assert.equal(anchorCount, 1,
`${p.file} 里「${anchor}」出现 ${anchorCount} 次(要求 1):函数改名或被复制,这条按函数名钉的看守就对不上是谁发的`)
const open = src.indexOf(anchor) + anchor.length
const own = src.indexOf(p.line, open) - open
assert.ok(own >= 0 && own < p.window,
`${p.fn} 的塞键行离自己函数开行 ${own} 字符,窗口预算却是 ${p.window}:own<0 = 那一行整段没了或换了写法;`
+ 'own>=window = 函数体写长把这一处挤出了窗口(这条判据宁可假红也不放宽,放宽就等于够得着隔壁)')
const second = src.indexOf(p.line, src.indexOf(p.line, open) + p.line.length)
assert.ok(second < 0 || p.window < second - open,
`${p.fn} 的窗口(${p.window})够得着同文件下一条同名发送口(距离 ${second - open}):`
+ '删掉这一处,隔壁那行会替它过关,这条钉就只守得住"两处一起删"')
}
// 覆盖性自检的另一半:清单里每个 api 文件,只要它已经把 company_id 当参数下传,就必须被**点名到文件**的钉盖住。
// 上面 loop 的 shape 只求值"登记了的那条钉指向的文件",而正向的 `/company_id\s*[:=]/` 问的是整个文件——
// 于是"给某页的 apiFiles 新增一个会发 company_id 的模块、却不给它登记取值口钉"这一手能双双过关
// (新模块的宽松判据绿、旧模块的严格判据也绿)。批次 2 的 dedupe/query/skip-price 三页各有 2 个发送文件,正是这一形。
for (const page of COMPANY_SCOPED_PAGES) {
const pinnedFiles = new Set((COMPANY_ID_SOURCE_PINS[page.menuKey] ?? []).map((p) => p.file))
for (const file of page.apiFiles) {
const wired = /company_id\s*[:=]/.test(stripComments(read(file)))
if (wired && !pinnedFiles.has(file)) {
problems.push(`${page.menuKey}:${file} 已经在下传 company_id,登记表里却没有一条钉指向它`
+ '——正向只问"文件里有没有",那是恒绿的宽松档')
}
}
}
assert.deepEqual(problems, [],
`公司 tab 接线缺口(逐页列全;批次 1 的 8 页到 Task 10 已全部接线,谁再退回未接线就红在这里):\n`
+ problems.map((p) => ` - ${p}`).join('\n'))
})
/**
* 1b ④ 的守卫(控制方裁决 1,2026-10-05):上面那支正向用例的取值口判据是**文本**判据——它只问
* 「`company_id` 的右半边取的是不是本函数自己的入参」,**看不见那个 query 对象有没有真交给 http**。
* `http.get(url, { params: query })` 一旦退回 `http.get(url)`:
* - `if (companyId != null) query.company_id = companyId` 那一行逐字还在 ⇒ 五处 shape 全绿;
* - `vue-tsc` 也不红(本仓 tsconfig 没开 `noUnusedLocals`/`noUnusedParameters`,`query` 变成一个
* 没人读的局部变量编译器一声不响,与 `TASK_CENTER_SEND_POINTS` 注释里记的 `noUnusedParameters` 同族);
* - 后端照旧 200、页面照旧渲染,只是 URL 里根本没有 `company_id` ⇒ 切 tab 一动不动。
* 这正是本轮要杀的「前端发了、参数没有」那一型,尺子原本看不见,所以单独钉「第二实参必须带 params」。
*
* <p>判据形状(一条钉 = 一个发送口):`http.get('<这一支自己的 url>',` 之后紧跟一个含 `params` 键的
* 对象实参。锚**端点 URL 字面量**而不是行号(api 文件一改行号就漂),也不锚函数体窗口:
* 函数名另有一条身份断言钉着(改名或把发送口挪进别的函数同样红),两半合起来才是「这一支 GET 带了 params」。
* 排他:同一 URL 的调用次数必须**恰好一条**——出现第二处同 URL 的调用时,`test()` 会被第一处糊弄过去,
* 所以这里数次数而不是只 `test()`。分母取本轮实扫的 `http.get(` 条数(对平闸门),
* 新增第六处 GET 而没登记 ⇒ 当场红,不给我自己留"文件里还有别人在发"的默认分支。</p>
*/
const TASK_CENTER_HTTP_FILE = 'src/api/task-center.ts'
/** 这一页的五个发送口(fn 是函数身份,url 是这一支的稳定身份,两者都必须对得上)。 */
const TASK_CENTER_HTTP_GET_CALLS: ReadonlyArray<{ readonly fn: string; readonly url: string }> = [
{ fn: 'fetchTaskCenterOverview', url: '/api/admin/task-center/overview' },
{ fn: 'fetchTaskCenterShopOptions', url: '/api/admin/task-center/shop-options' },
{ fn: 'fetchTaskCenterTasks', url: '/api/admin/task-center/tasks' },
{ fn: 'fetchTaskCenterTaskDetail', url: '/api/admin/task-center/tasks/detail' },
{ fn: 'fetchTaskCenterVariantTasks', url: '/api/admin/task-center/variant-tasks' },
]
/** 一个发送口一条钉:`http.get('<url>',` 后必须紧跟带 `params` 键的第二实参(`{ params }` 与 `{ params: query }` 都认)。 */
function sendArgsShape(url: string): RegExp {
const quoted = url.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
return new RegExp(`http\\.get\\(\\s*'${quoted}'\\s*,\\s*\\{[^}]*\\bparams\\b`)
}
/** 正样本:逐字照抄真实发送口那一行(两格缩进 + `const { data } = await`),证明判据匹配得出、不恒红。 */
function sendArgsCompliant(url: string): string {
return ` const { data } = await http.get('${url}', { params: query })\n`
}
/** 负样本:删掉第二实参(变异自证 1b ④ 注入的就是这一形),证明判据匹配不出、能红。 */
function sendArgsDropped(url: string): string {
return ` const { data } = await http.get('${url}')\n`
}
test('发送口的第二实参:task-center 五处 http.get 必须把 query 交给带 params 的实参(1b ④ 的守卫)', () => {
const api = stripComments(read(TASK_CENTER_HTTP_FILE))
// 取样自检 1:登记表非空(这一页今天恰有五处 GET;被人删剩几条就是有人把钉摘了)。
assert.ok(TASK_CENTER_HTTP_GET_CALLS.length >= 5,
`1b ④ 登记表只剩 ${TASK_CENTER_HTTP_GET_CALLS.length} 条发送口 ⇒ 这条看守被改窄了,下面的对平判据失去分母`)
// 取样自检 2(同链前提,全局约束 15):这一页确实还在按公司下传,「把 query 交给 http」才有意义。
// 分母与上面那张发送口表同源(不写死 3):表改了这里跟着改,两边不会漂出两个口径。
const sendPointsHere = TASK_CENTER_SEND_POINTS.filter((p) => p.file === TASK_CENTER_HTTP_FILE).length
assert.ok(sendPointsHere >= 1, `${TASK_CENTER_HTTP_FILE} 在 TASK_CENTER_SEND_POINTS 里一条都没登记:前提无从判定`)
assert.equal(occurrences(api, TASK_CENTER_SEND_LINE), sendPointsHere,
`${TASK_CENTER_HTTP_FILE} 里「${TASK_CENTER_SEND_LINE}」的实际条数与发送口表登记(${sendPointsHere} 条)不等 ⇒ `
+ '这一页的 company_id 与 params 两条看守必须同链在场,不许只剩一半')
// 对平闸门:分母 = 本轮实扫的 http.get( 条数。多一处没登记的 GET ⇒ 红(不许"新增那处还没人管"过关)。
const actualGets = occurrences(api, 'http.get(')
assert.equal(actualGets, TASK_CENTER_HTTP_GET_CALLS.length,
`${TASK_CENTER_HTTP_FILE} 实扫到 ${actualGets} 处 http.get(,登记表却只有 ${TASK_CENTER_HTTP_GET_CALLS.length} 条 —— `
+ '新增发送口没登记(或有人删了登记),这条看守盖不住那一处')
for (const p of TASK_CENTER_HTTP_GET_CALLS) {
// ① 正样本(判据不恒红)。
assert.ok(sendArgsShape(p.url).test(sendArgsCompliant(p.url)),
`(1b ④ 取样自检·正样本)${p.fn} 的合规样本都匹配不出 ${sendArgsShape(p.url).source} ⇒ 这条钉恒红,带没带 params 都会红,等于没看守`)
// ② 负样本(判据能红):删掉第二实参就必须匹配不出——变异自证注入的正是这一形。
assert.equal(sendArgsShape(p.url).test(sendArgsDropped(p.url)), false,
`(1b ④ 取样自检·负样本)${p.fn} 删掉 { params: query } 仍然匹配 ⇒ 判据只看得到 URL,杀不了这一记变异`)
// ③ 函数身份:这一支的 GET 必须由它自己的函数发出(改名或挪进别的函数 ⇒ 这条钉指向不存在的口)。
assert.equal(occurrences(api, `function ${p.fn}(`), 1,
`${p.fn} 在 ${TASK_CENTER_HTTP_FILE} 里出现 ${occurrences(api, `function ${p.fn}(`)} 次(要求 1):`
+ '发送口换了函数名或被复制,这条按 URL 钉的看守就对不上是谁发的')
// ④ 真文件求值 + 排他(同一 URL 只许一处调用)。
const hits = api.match(new RegExp(sendArgsShape(p.url).source, 'g')) ?? []
assert.equal(hits.length, 1,
`${TASK_CENTER_HTTP_FILE} 里「${p.url}」带 params 实参的调用匹配到 ${hits.length} 处(要求恰好 1):`
+ `0 处 = ${p.fn} 的 http.get 没把 query 交给 params(后端收不到 company_id、接口照旧 200、切 tab 一动不动);`
+ '多于 1 处 = 同 URL 有第二处调用没人钉,test() 会被第一处糊弄')
}
})
/**
* 1b ④ 的那一半缺口(批次 5 补,2026-10-06 变异自证 M9 实测存活):上面那支按**端点 URL 字面量**锚,
* 取样文件只有 `src/api/task-center.ts`。店铺密钥这一页的 GET 写的是 `http.get<unknown>(SHOP_KEYS_ENDPOINT, { params: query })`
* ——端点是模块常量、调用还带泛型,那条正则两头都锚不到。把 `{ params: query }` 整段删掉后,
* `if (params.companyId != null) query.company_id = params.companyId` 那一行逐字还在 ⇒ 取值口五判据全绿、
* 编译器一声不响、URL 里没有 company_id:正是 1b ④ 当初要杀的那一形,只是换了一个文件。
*
* <p>判据换成「整行字面量 + 同文件 GET 总条数对平」:锚整行是因为常量名就是这一处的稳定身份,
* 对平是因为只钉一行的话,第二处新 GET 忘了带 params 也照样没人红(与上面「同一 URL 只许一处调用」同理)。</p>
*/
const CONSTANT_ENDPOINT_GET_PINS: ReadonlyArray<{ readonly file: string; readonly fn: string; readonly call: string }> = [
{ file: 'src/pages/shop/shop-key-api.ts', fn: 'fetchShopKeyList', call: 'http.get<unknown>(SHOP_KEYS_ENDPOINT, { params: query })' },
]
test('非字面量端点的发送口:query 必须交给带 params 的第二实参,且同文件 GET 条数与登记表对平(1b ④ 的另一半)', () => {
assert.ok(CONSTANT_ENDPOINT_GET_PINS.length >= 1, '常量端点登记表为空 ⇒ 这一族的第二实参没人看守')
const byFile = new Map<string, number>()
for (const p of CONSTANT_ENDPOINT_GET_PINS) byFile.set(p.file, (byFile.get(p.file) ?? 0) + 1)
for (const p of CONSTANT_ENDPOINT_GET_PINS) {
const src = stripComments(read(p.file))
// ① 判据自证(正样本):登记的那一行本身必须含 params,否则下面的对平是在钉一个坏形状。
assert.ok(p.call.includes(', { params'), `登记表里「${p.call}」不含 params 第二实参 ⇒ 这条判据恒红`)
// ② 判据自证(负样本):删掉第二实参后必须匹配不出自己,否则"带没带 params"都算过。
assert.equal(p.call.replace(', { params: query }', '').includes(p.call), false,
`删掉 { params: query } 之后「${p.call}」仍然自匹配 ⇒ 判据只看得到端点,杀不了这一记变异`)
// ③ 函数身份:这一处 GET 必须由它自己的函数发出。
assert.equal(occurrences(src, `function ${p.fn}(`), 1,
`${p.file} 里「function ${p.fn}(」出现 ${occurrences(src, `function ${p.fn}(`)} 次(要求 1):函数改名或被复制,这一行锚对不上是谁发的`)
// ④ 真文件求值:这一行必须逐字在场一次。
const hits = occurrences(src, p.call)
assert.equal(hits, 1,
`${p.file} 里带 params 实参的「${p.call}」匹配到 ${hits} 处(要求 1):`
+ '0 处 = 发送口把 query 丢了(后端收不到 company_id、接口照旧 200、切 tab 一动不动),多于 1 处 = 有第二处同形调用没人钉')
}
// ⑤ 同文件 GET 总条数对平:新增一处 http.get 而没登记 ⇒ 当场红,不留"新那处还没人管"的默认分支。
for (const [file, pinned] of byFile) {
const src = stripComments(read(file))
const actual = occurrences(src, 'http.get')
assert.equal(actual, pinned,
`${file} 实扫到 ${actual} 处 http.get,登记表只有 ${pinned} 条 —— 有一处 GET 的第二实参没人看守`)
}
})
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——它绕过了唯一清单`)
}
})
/**
* 切公司必须把「上一家选中的筛选项」一起清掉(TaskList #22,控制方 2026-10-05 点名;
* 2026-10-05 修复轮 1 复评 M-2 把它抽成 (file, token) 两对,见下面 WATCH_BODY_PINS)。
*
* <p>为什么单独钉 watch 体:体里那些赋值是**用户选中的值**,不是每次请求重算的。切到另一家公司后,
* 上一家选中的 `filter.groupId` / `filter.shop` 在新一家的可见集与候选字典里根本不存在,列表于是被
* 一个不存在的值筛成空页——症状是「tab 一切页面就白」,而请求、后端、权限三处全对。
* G1 的 pageFiles 只断「watch 了 activeId」与「读过 requestCompanyId」(正向那条用例的末尾两行),
* 看不见 watch 体里到底做了什么,所以体内容必须单独钉。</p>
*
* <p>M-2 的洞:这条看守原本把锚写死在 `ShopManagePage.vue:108` 的 `filter.groupId = null` 上,
* 同形不同页——任务看板页自己那条 `filter.shop = ''`(裁决 1 加的,`TaskCenterBoardPage.vue:176`)
* 当时没有任何看守:删掉那一行时 G1 只断「存在 watch」、G2 不扫 `.vue`、后端用例不涉及前端文本 ⇒ 全绿,
* 症状回到裁决 1 想避免的那一型。</p>
*
* <p>判据形状:从 `watch(() => companyTab.activeId, …)` 那**一条语句**取文本(正则在第一个
* `}` + `)` 处收口 ⇒ 单层,体内再嵌对象字面量会截早;表里这十页今天都没有那种写法,由下面的取样自检兜着)。
* 反向钉与正样本同支(全局约束 15,三条前提不成立就是探针失效、当场红,不许静默空跑),**每一对**都各跑一遍:
* ① 合规样本必须匹配得出且含两把 token ⇒ 判据不恒红;
* ② 删掉那一句的样本必须不含 ⇒ 判据能红(变异自证走的就是这一条);
* ③ 把同一串 token 挪到 watch 之外的样本必须不含 ⇒ 钉的是**位置**,不是「文件里出现过」。
* 每对末尾还配了一条同链前提:那一页的发送口仍在发 `company_id`,清筛选项才有意义。</p>
*
* <p>刻意没钉的部分(判据收在"钉得住"那一档):`taskPage.value = 1` / `variantPage.value = 1`——
* `= 1` 这一形在 watch 体外满篇都是(search/changeTaskPage/resetFilter 都写它),
* 用 `matches[0].includes('taskPage.value = 1')` 只会把判据做成"这一行在不在体内"的第二个 filter.shop,
* 而页码回 1 的红利是观感不是越权,本轮不扩围。</p>
*/
const WATCH_ACTIVE_ID = /watch\(\(\)\s*=>\s*companyTab\.activeId\s*,\s*\(\)\s*=>\s*\{([\s\S]*?)\}\s*\)/
/**
* (文件, 必须出现在 watch 体内的赋值) 十对,同一条 test 里逐对钉(批次 1 两对 + 批次 2 三对 + 批次 3 两对 + 批次 4 一对 + 批次 5 一对 + 批次 6 一对)。
* `premise` 是这一对的反向钉前提:这一页的发送口今天还在发 `company_id`,清筛选项才有意义;
* 哪天发送口退回不带参,watch 看守就变成"清了一个没人用的筛选项",必须一起红。
*/
const WATCH_BODY_PINS: ReadonlyArray<{
readonly file: string
readonly token: string
readonly why: string
readonly premise: ReadonlyArray<{ readonly file: string; readonly shapes: readonly RegExp[] }>
}> = [
{
file: 'src/pages/shop/ShopManagePage.vue',
token: 'filter.groupId = null',
why: '上一家选中的 groupId 在新一家的可见集里根本不存在,列表会被它筛成空页',
premise: [
{
file: 'src/pages/shop/shop-manage-api.ts',
shapes: [/company_id\s*=\s*params\.companyId\b/, /company_id\s*:\s*companyId\b/],
},
],
},
{
file: 'src/pages/task-center/TaskCenterBoardPage.vue',
token: "filter.shop = ''",
why: 'shop 的候选字典 /shop-options 现在按公司下传,上一家选中的店铺名在新一家不存在 ⇒ 切 tab 后首屏被筛成「暂无符合条件的任务」',
premise: [
{ file: 'src/api/task-center.ts', shapes: [/company_id\s*=\s*companyId\b/] },
{ file: 'src/pages/task-center/task-center-model.ts', shapes: [/company_id\s*=\s*companyId\b/] },
],
},
// ↓ 批次 2 剩下的三页(控制方 2026-10-05 点名「切 tab 数据还一样」那一批;
// 品牌库、商品类目两页 2026-10-06 退回全平台共享,条目一并摘掉)。
// token 在两页上同形(`filter.groupId = null` 出现三次),这**不是**漏洞:判据按 (file, token) 成对求值,
// 每一对都各自去读它自己那一页的源码,别家页缺了这行不会红在这一页,反之这一页删掉了也不会被隔壁顶住
// (负样本 ③「挪到 watch 之外」钉的就是位置)。
{
file: 'src/pages/asin/DedupeRegistryPage.vue',
token: 'filter.groupId = null',
why: '分组候选 /shop-manages/groups 现在按公司下传,上一家选中的 groupId 在新一家的字典里不存在 ⇒ 去重库被它筛成空页',
premise: [
{ file: 'src/pages/asin/dedupe-total-api.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
{
file: 'src/pages/asin/QueryAsinPage.vue',
token: "filter.groupId = null; filter.shopName = ''",
why: '这一页的店铺名候选是按分组现拉的(fetchShopNamesByGroup 也透传了公司):只清 groupId 而留着 shopName,'
+ '新一家会被一个不属于它的店铺名筛空,而筛选项 UI 上还显示着上一家填的值',
premise: [
{ file: 'src/pages/asin/query-asin-api.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
{
file: 'src/pages/asin/SkipPricePage.vue',
token: "filter.groupId = null; filter.shopName = ''",
why: '同查询 ASIN 页:分组与店铺名是一对(店铺名候选跟着分组走),切公司必须一起清',
premise: [
{ file: 'src/pages/asin/skip-price-api.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
// ↓ 批次 3 的两页(控制方 2026-10-05 点名「店铺撞款监控 店铺数据也要做隔离」)。
// 这两页的 token 一直写到 reload 那两句为止(批次 1/2 的老条目仍只钉清筛选项,不动它们):
// 变异自证发现「删掉 void loadConsole()」当时全绿——清筛选项那半守住了,重新取数那半没人守。
{
file: 'src/pages/tasks/DuplicateCheckPage.vue',
token: "filter.shop = ''; filter.group = ''; selectedGroup.value = ''; scope.value = 'global'; void loadConsole(); void loadLedger(1)",
why: '这一页的店铺下拉与分组下拉的候选字典都由 /duplicate-check-console 按公司下发(shops/groups 都来自裁剪后的可见集),'
+ '留着上一家选中的店铺名/分组名,新一家首屏就被一个不属于它的值筛成空页;selectedGroup 单独清是因为'
+ ' loadConsole 的重挑分支只在 groupStats 非空时触发,切到没有分组的公司时它会原样留着。'
+ '末尾两句是 reload:清完了却不重取,页面还是上一家的快照',
premise: [
{ file: 'src/pages/tasks/duplicate-console-api.ts', shapes: [/company_id\s*=\s*companyId\b/] },
],
},
{
file: 'src/pages/tasks/ShopDataTasksPage.vue',
token: "filter.shopName = ''; filter.groupName = ''; selection.value = createShopDataSelection(); page.value = 1; cardPage.value = 1; void load()",
why: '两处自由文本筛选项留着上一家填的值 = 拿新一家看不见的店铺名去筛列表;勾选集更硬——它存的是 resultId,'
+ '跨公司不清的话点「批量下载」会把别家店铺的结果文件打进同一个 zip(不发筛选请求,直接按 id 取件);'
+ '页码回 1 是因为新一家的条数更少,末尾的 void load() 才让切 tab 真的换数据',
premise: [
{ file: 'src/pages/tasks/shop-data-api.ts', shapes: [/company_id\s*=\s*companyId\b/] },
],
},
// ↓ 批次 4(控制方 2026-10-05 点名「菜单权限和用户管理也要区分公司 tab 的数据」)。
{
file: 'src/pages/account/UsersPage.vue',
token: "filters.createdByAdminId = null; filters.keyword = ''; filters.page = 1; void loadUsers()",
why: '「所属管理员」的候选 admins 随本公司的列表响应给出,上一家的 adminId 在新一家的下拉里不存在;'
+ '用户名又全平台唯一(V143 的唯一索引),留着上一家填的关键字去筛新一家必然空页,'
+ '而输入框还显示着那个值——两处都不是后端筛坏了。末尾的 void loadUsers() 是本页唯一的数据出口,'
+ '少了它前面三条赋值都只是清了一遍没人看的表单',
premise: [
{ file: 'src/api/users.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
// ↓ 批次 5(控制方 2026-10-06 点名「店铺密钥管理的数据按照公司区分」)。
{
file: 'src/pages/shop/ShopKeysPage.vue',
token: "filter.keyword = ''; filter.token = ''; filter.whitelistStatus = null; page.value = 1; void load()",
why: '2026-10-08 这一页的筛选从客户端挪进请求(keyword/token/whitelist_status 三个参数),'
+ '清筛选项的理由反而更硬:留着上一家填的词去筛新一家,首屏就是一张「暂无匹配密钥」而输入框里还显示着那个词;'
+ '页码回 1 是因为新一家的令牌更少,末尾的 void load() 才让切 tab 真的换数据',
premise: [
{ file: 'src/pages/shop/shop-key-api.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
// ↓ 批次 6(控制方 2026-10-06 点名「菜单权限也加字段来区分」,定案「每家公司一套树」)。
{
file: 'src/pages/account/MenusPage.vue',
token: "filterName.value = ''; filterType.value = ''; page.value = 1; void loadMenus()",
why: '菜单名称/类型是客户端筛选(filteredMenuRows 在本页已取的 rows 上筛,不进请求):留着上一家填的值'
+ '就是拿别家的字符串去筛新一家那一套树 ⇒ 首屏「暂无匹配菜单」,而输入框里还显示着那个值。页码回 1 是因为'
+ '新一家的行数不同,末尾的 void loadMenus() 才是本页唯一的数据出口',
premise: [
{ file: 'src/pages/account/menu-manage-api.ts', shapes: [/company_id\s*=\s*companyId\b/] },
],
},
// ↓ 批次 7(2026-11-10 v1.3 无侵权只读页):任务号/ASIN 是自由文本筛选,上一家填的值在新一家的
// 行集里筛不出东西 ⇒ 首屏「暂无无侵权数据」而输入框里还显示着那个值;页码回 1 同理。
// 2026-11-11 分组筛选(主管=组长,就是分组)落地:分组选项集是公司隔离的(GET /shop-manages/groups
// 带 company_id),上一家选的 groupId 在新一家的选项集里不存在 ⇒ 同罪必清,选项也按新公司重取。
{
file: 'src/pages/patent/AppearancePatentCleanItemsPage.vue',
token: "filter.taskId = ''; filter.asin = ''; filter.groupId = ''; page.value = 1; void loadGroupOptions(); void load()",
why: '任务号/ASIN 是按行集筛的自由文本,上一家的值在新一家的行里不存在 ⇒ 切 tab 后首屏被筛成「暂无无侵权数据」,'
+ '而输入框还显示着上一家填的值;分组(主管)选项集是公司隔离的,上一家选的 groupId 在新一家的选项里不存在,'
+ '同罪必清且选项重取;页码回 1 是因为新一家的行数更少,末尾的 void load() 才让切 tab 真的换数据',
premise: [
{ file: 'src/pages/patent/appearance-patent-clean-api.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
// ↓ 批次 8(2026-11-14 v1.4 京东数据库;2026-11-15 公共化改口径):商品编码/标题是
// 按行集筛的自由文本,类目选项集与超管当前 tab 的行集同源 ⇒ 上一家的筛选值与 category
// 在新一家的行集/选项集里不存在,切 tab 必清且类目选项重取;页码回 1 同外观专利页。
// 分组 2026-11-15 起全平台一份(公共),groupId 与公司维度正交——不清、选项也不随 tab 重取。
// 店铺筛选 2026-11-15 客户口径「店铺不需要」下线(watch 体不再清 shopName,参数面无它)。
{
file: 'src/pages/jd/JdDatabasePage.vue',
token: "filter.productCode = ''; filter.titleKeyword = ''; filter.category = ''; filter.syncedFrom = ''; filter.syncedTo = ''; page.value = 1; void loadCategoryOptions(); void load()",
why: '商品编码/标题是按行集筛的自由文本,上一家的值在新一家的行里不存在 ⇒ 切 tab 后首屏被筛成「暂无商品」,'
+ '而输入框还显示着上一家填的值;类目选项集与超管当前 tab 的行集同源,上一家选的 category 在新一家的选项里不存在,'
+ '同罪必清且选项重取;页码回 1 是因为新一家的行数更少,末尾的 void load() 才让切 tab 真的换数据',
premise: [
{ file: 'src/pages/jd/jd-product-api.ts', shapes: [/company_id\s*=\s*params\.companyId\b/] },
],
},
]
/** 取「`watch(() => companyTab.activeId, () => { … })`」这一条语句的原文;匹配不出返回 null(由调用方判探针失效)。 */
function watchStatement(source: string): string | null {
const m = WATCH_ACTIVE_ID.exec(source)
return m ? m[0] : null
}
test('切公司的 watch 体:每对 (file, token) 都要在该页 watch 体内出现(批次 1 两页 + 批次 2 三页 + 批次 3 两页 + 批次 4 一页 + 批次 5 一页 + 批次 6 一页 + 批次 7 一页 + 批次 8 一页)', () => {
assert.ok(WATCH_BODY_PINS.length >= 11,
`watch 体看守只剩 ${WATCH_BODY_PINS.length} 对(批次 1 的店铺管理/任务看板 + 批次 2 的去重库/查询ASIN/最低价ASIN + 批次 3 的撞款监控/店铺数据记录 + 批次 4 的用户管理 + 批次 5 的店铺密钥 + 批次 6 的菜单管理 + 批次 7 v1.3 无侵权只读页 + 批次 8 v1.4 京东数据库页共 12 对)`
+ '⇒ 这一族又退回"只钉少数几页",被摘掉那一页的"切公司不清筛选项"再次没人看守')
const pinnedFiles = new Set(WATCH_BODY_PINS.map((pin) => pin.file))
for (const pin of WATCH_BODY_PINS) {
// ① 正样本(判据不恒红)——逐字就是这一页今天 watch 体里的那一行。
const positive = watchStatement(`watch(() => companyTab.activeId, () => { ${pin.token}; void loadGroups(); void load() })`)
assert.ok(positive, `探针失效(${pin.file}):合规样本都匹配不出 watch 语句 ⇒ 判据恒红,这条看守等于没写`)
assert.ok(positive.includes('companyTab.activeId') && positive.includes(pin.token),
`探针失效(${pin.file}):合规样本没同时含两把 token ⇒ 下面两条断言无从判定`)
// ② 负样本 1(判据能红):删掉清筛选项那一句——变异自证注入的就是这一形。
const dropped = watchStatement('watch(() => companyTab.activeId, () => { void loadGroups(); void load() })')
assert.ok(dropped, `探针失效(${pin.file}):负样本 1 匹配不出 watch 语句,无从判定它该红`)
assert.equal(dropped.includes(pin.token), false,
`负样本 1 失效(${pin.file}):删掉 ${pin.token} 还判它含 ⇒ 这条看守杀不了变异`)
// ③ 负样本 2(钉位置不钉全文):token 在同一个文件里、但不在 watch 体内。
const elsewhere = watchStatement(`function resetAll() { ${pin.token} }\nwatch(() => companyTab.activeId, () => { void load() })`)
assert.ok(elsewhere, `探针失效(${pin.file}):负样本 2 匹配不出 watch 语句,无从判定它该红`)
assert.equal(elsewhere.includes(pin.token), false,
`负样本 2 失效(${pin.file}):watch 体外的 ${pin.token} 被算成了体内 ⇒ 判据退化成"文件里出现过就行"`)
const source = stripComments(readSource(pin.file))
const matches = source.match(new RegExp(WATCH_ACTIVE_ID.source, 'g')) ?? []
assert.equal(matches.length, 1,
`${pin.file} 里匹配到 ${matches.length} 条 watch(() => companyTab.activeId, () => {…}):`
+ '0 条 = watch 换了写法(判据失明)或被拆成多条,都得先核对再动判据')
assert.ok(matches[0].includes(pin.token),
`切公司没清掉上一家选中的筛选项 ${pin.token}:${pin.why}`
+ '(tab 看起来"坏了",而请求、后端、权限三处都没错,最难查的那一型)')
// 同链前提(反向钉不许独自成立):这一页的发送口仍然在发 company_id。
// 哪天发送口退回不带参,上面这条 watch 看守就变成"清了一个没人用的筛选项"——前提必须一起在场。
for (const link of pin.premise) {
const api = stripComments(read(link.file))
for (const shape of link.shapes) {
assert.ok(shape.test(api),
`${link.file} 不再带 company_id(要求 ${shape}):${pin.file} 那条 watch 看守的前提没了`)
}
}
}
// 覆盖性自检(表别被顺手删空,也别只钉上一对)。
assert.equal(pinnedFiles.size, WATCH_BODY_PINS.length, 'WATCH_BODY_PINS 里出现了重复 file ⇒ 有一对被覆盖掉了')
})
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('/'))
}
// 去掉注释再匹配:**这是这支用例能不能用的关键**。
// 举证口径(2026-10-05 修复轮 1 复核,原举证已失效):分母 = src/api/**.ts + src/pages/**-api.ts,
// 取样集内当前 `company_id` 命中为 **0** ⇒ 这个 helper 今天是惰性的。它防的是 **Task 8-12 写进取样集的
// 说明注释**——那批接线会在这些 api/取数模块里留下「company_id 由公司 tab 决定」之类的散文,
// 不剥注释,反向用例就会红在一条**说明为什么不传参**的注释上,然后下一个人把它写成行级临时豁免,整支用例就废了。
// (旧举证引的 src/pages/account/user-create-model.ts 既不在 src/api/ 下也不以 -api.ts 结尾,
// 根本不在分母里,行号也已漂动——别再照那句话去改那个文件。)
// 剥注释的写法要连 `//` 行注释一起剥,但**不许**顺手放宽成"整文件不匹配"。
// 正向那半支的 api 侧与 page 侧都走它:注释里的 company_id / companyTab.requestCompanyId 都不算接线。
// (这一段用 `//` 而不是 `/** */`:brief 原文里的示例正则 `if (!/^\s*\*/.test(line))` 含 `*/`,
// 放进块注释会把注释当场截断,node 的 TS 解析器随即报 ERR_INVALID_TYPESCRIPT_SYNTAX——整支用例加载都失败。)
function stripComments(source: string): string {
return source
// Vue 模板的 <!-- --> 也要剥:pageFiles 取样全是 .sfc.vue,一句 `<!-- watch(() => companyTab.activeId) -->`
// 在只剥 JS 注释时能同时骗过 page 侧两条钉子(2026-10-05 复评 (a))。
.replace(/<!--[\s\S]*?-->/g, '')
.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 />')
// 钉**模板里的挂载点**而不是 import 行:只写 layout.includes('OperationGuide') 时,删掉 <OperationGuide />
// 而留着那行 import 照样绿——一条"声称保护而不保护"的断言比没有更危险(后续评审会拿它当已核事实)。
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)')
// 失败路径也要有钉子(2026-10-05 复评 (c)):改前 `initialize` 只有 try/finally ⇒ GET /companies 抛错时
// loaded 永远 false、tab 条静默消失、异常落 unhandled rejection(全仓 src 无 errorHandler 兜底)。
// 只补代码不补钉子的话,Task 8-12 里谁把它改回 try/finally,1726 支用例一支都不会红——那是"修好了但没护栏"。
assert.match(store, /catch \(error\)[\s\S]{0,420}this\.error =[\s\S]{0,120}throw error/,
'initialize 必须 catch 出 error 状态再 rethrow(口径照 admin-session.ts:37-39),不许退回只有 try/finally')
// error 只许住 store 与 console:一旦进模板就是§12 第 5 条没批的那一处新界面暴露。
assert.equal(tabs.includes('tab.error'), false, '不许把 error 渲染进模板:提示条/文案都不在已批的两处暴露里')
assert.match(tabs, /initialize\(\)\.catch\(/,
'组件侧必须 .catch 接住 store 的 rethrow,否则又变回 unhandled rejection')
})
test('渲染范围:tab 条只画在按公司取数的页上,公司管理那排点了没反应的 tab 摘掉', () => {
// 2026-10-06 控制方:「公司管理不要有 tab」。10-05 那一轮只钉住了「CompaniesPage 不消费 store」
// (company-config-entry-super-only 最后那条),而 tab 条本身挂在壳层 AdminLayout、对全部页都画
// ⇒ 界面一个字都没变,同一天被第二次点名。这条补的是**渲染侧**那一半。
// 判据取 COMPANY_SCOPED_PAGES 这一张注册表:写黑名单的话,下一个新页默认长出一条装饰 tab。
const pageKeys = adminPages.map((p) => p.menuKey)
assert.ok(pageKeys.length >= 22, `路由注册表只取到 ${pageKeys.length} 页 ⇒ 分母被删空,下面的差集会假绿`)
const scoped = new Set(COMPANY_SCOPED_PAGES.map((p) => p.menuKey))
const unscoped = pageKeys.filter((k) => !scoped.has(k))
assert.ok(scoped.size >= 15, `注册表只剩 ${scoped.size} 页 ⇒ 正向那半的循环没东西可验`)
assert.ok(unscoped.includes('admin_companies'),
'admin_companies 竟在公司 tab 注册表里:与「公司管理仅超管、不做 tab」直接冲突')
const model = stripComments(readSource('src/layout/company-tab-model.ts'))
assert.match(model, /new Set\(COMPANY_SCOPED_PAGES\.map/,
'companyTabAppliesTo 必须从 COMPANY_SCOPED_PAGES 派生,不是另立一张名单')
assert.equal(model.includes("'admin_companies'"), false,
'渲染判据里不许写死菜单名:那是第二张清单,与注册表迟早漂移')
// 真值双向:注册表内 ⇒ 画(漏了就是取值口与渲染口分家),注册表外每一页 ⇒ 不画(点了不重取数)
for (const key of scoped) assert.equal(companyTabAppliesTo(key), true, `${key} 在注册表里却不画 tab`)
for (const key of unscoped) assert.equal(companyTabAppliesTo(key), false, `${key} 没接公司隔离却画着 tab`)
assert.equal(companyTabAppliesTo(undefined), false, '没有 menuKey 的开放页(登录页等)默认不画')
// 组件真把这一条串进了 show:只导出函数不接线=这条护栏恒绿
const tabs = stripComments(readSource('src/layout/CompanyTabs.vue'))
const showLine = tabs.split('\n').find((line) => line.includes('const show ='))
assert.ok(showLine, 'CompanyTabs.vue 找不到 `const show =` 这一行:渲染开关换写法了,先确认它还在不在')
assert.ok(showLine.includes('tab.visibleForOperator'), 'show 少了「目录可用」那条')
assert.ok(showLine.includes('companyTabAppliesTo(route.meta.menuKey)'),
'show 少了「这一页吃公司」那条 ⇒ 退回全页画 tab,公司管理页头顶又会长出那一排')
})
/**
* 2026-10-06 控制方定案:品牌数据库、商品类目「做成所有公司共享的,不区分」。
*
* <p>上面那几条正向判据全是从 {@code COMPANY_SCOPED_PAGES} 派生的,页一退出注册表就自动不再求值 ⇒
* 「退出」这件事本身没有看守:谁把 {@code company_id} 重新塞回这三个取数口,全仓用例一支都不会红,
* 而后端唯一键已经退回全局(V151),带公司参数的读会把共享库筛窄成「只看这一家」,
* 写侧则把一张全平台共享的表按家拆开——两边都是静默改口径,不是报错。所以这一支必须存在。</p>
*
* <p>判据只认「剥完注释的代码」:这三份文件现在各自留有一句说明共享口径的注释,
* 注释里的 {@code company_id} 三个字面字符不是接线(全局约束 6)。正样本用摘掉之前那三行原文,
* 所以下面的 false 是测出来的,不是「正则本来就抓不到」。</p>
*/
const SHARED_PAGE_KEYS = ['admin_invalid_asin_data', 'admin_product_categories'] as const
const SHARED_API_FILES = [
'src/pages/invalidasin/invalid-asin-api.ts',
'src/pages/asin/product-category-api.ts',
'src/pages/asin/product-category-export.ts',
] as const
const SHARED_PAGE_FILES = [
'src/pages/asin/AsinInvalidPage.vue',
'src/pages/asin/ProductCategoryPage.vue',
] as const
/** 公司参数的两种写法:下传用的 snake、形参/字段用的 camel。 */
const COMPANY_PARAM_TOKEN = /(?:company_id|companyId)/
/** 本次摘掉的三行原发送口(逐字取自改动前的源码),做反向钉的同支正样本。 */
const FORMER_SEND_LINES = [
'if (query.companyId != null) params.company_id = query.companyId',
'if (companyId != null) params.company_id = companyId',
'if (companyId != null) params.push(`company_id=${companyId}`)',
]
test('公司维度不得回流:品牌库与商品类目已定案全平台共享,取数口与页面都不许再带公司参数', () => {
// 判据自证(全局约束 15:反向钉不许独自成立)——改动前那三行必须抓得到,否则下面的 false 是空判据。
for (const line of FORMER_SEND_LINES) {
assert.ok(COMPANY_PARAM_TOKEN.test(line), `反向钉判据连原来的发送口「${line}」都匹配不出 ⇒ 这一族恒绿`)
}
// watch 探针同理:它今天还在 WATCH_BODY_PINS 那十对上起作用,这里再就地复验一次形状,
// 免得「页面里没有 watch」是因为正则换了写法而失明。
assert.ok(WATCH_ACTIVE_ID.test('watch(() => companyTab.activeId, () => { void load() })'),
'WATCH_ACTIVE_ID 连合规样本都匹配不出 ⇒ 下面「不许再长出 watch」那条恒绿')
// 注册表本身非空自证:表被删空时 some() 会对所有 key 返回 false,看着像「都退出了」。
assert.ok(COMPANY_SCOPED_PAGES.length >= 15,
`注册表只剩 ${COMPANY_SCOPED_PAGES.length} 页 ⇒ 分母被删空,下面的 some() 会假绿`)
for (const key of SHARED_PAGE_KEYS) {
assert.equal(COMPANY_SCOPED_PAGES.some((p) => p.menuKey === key), false,
`${key} 又回到 COMPANY_SCOPED_PAGES:2026-10-06 已定案这两页全平台共享,不区分公司`)
const page = adminPages.find((p) => p.menuKey === key)
assert.ok(page, `${key} 在路由注册表里找不到:菜单名改了,反向钉对不上页`)
assert.equal(page.companyScoped, false,
`${key} 的 meta.companyScoped 不再是 false:tab 条会画出来,而这一页的取数口没有公司参数 ⇒ 点了没反应)`)
}
for (const file of [...SHARED_API_FILES, ...SHARED_PAGE_FILES]) {
const src = stripComments(read(file))
assert.equal(COMPANY_PARAM_TOKEN.test(src), false,
`${file} 又出现了公司参数:这两页读的是全平台共享的库,带上 company_id 等于把共享口径偷偷改回按家筛`)
assert.ok(COMPANY_PARAM_TOKEN.test(`${src}\n${FORMER_SEND_LINES[0]}`),
`(同支正样本)${file} 的源码喂进判据后连拼上原发送口都匹配不出 ⇒ 上面那条 false 无从判定`)
}
for (const file of SHARED_PAGE_FILES) {
const src = stripComments(read(file))
assert.equal(WATCH_ACTIVE_ID.test(src), false,
`${file} 又 watch 了 companyTab.activeId:这一页不按公司取数,切 tab 重取数只会把用户正在看的页刷掉`)
assert.equal(/useCompanyTabStore|companyTab\.requestCompanyId/.test(src), false,
`${file} 重新引回了公司 tab store,而它对应的 tab 条已经摘掉`)
}
})