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 未在生产执行。
813 lines
62 KiB
TypeScript
813 lines
62 KiB
TypeScript
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'
|
||
|
||
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, '\\$&')
|
||
}
|
||
|
||
/**
|
||
* 全部 22 个字面发送口:批次 1 的任务看板 5 处 + 批次 2(控制方 2026-10-05 点名「切 tab 数据还一样」那五页)12 处
|
||
* + 批次 3(控制方 2026-10-05 点名「店铺撞款监控 店铺数据也要做隔离」那两页)4 处
|
||
* + 批次 4(控制方 2026-10-05 点名「菜单权限和用户管理也要区分公司 tab 的数据」里的用户管理)1 处。
|
||
*
|
||
* <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_invalid_asin_data', file: 'src/pages/invalidasin/invalid-asin-api.ts', fn: 'fetchInvalidAsinPage', line: 'if (query.companyId != null) params.company_id = query.companyId', window: 400, title: 'GET /invalid-asin-data 列表(品牌数据库)' },
|
||
{ 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 不带任何参数=恒导全平台)' },
|
||
{ menuKey: 'admin_product_categories', file: 'src/pages/asin/product-category-api.ts', fn: 'fetchProductCategoryTree', line: 'if (companyId != null) params.company_id = companyId', window: 450, title: 'GET /product-categories 类目树' },
|
||
{ menuKey: 'admin_product_categories', file: 'src/pages/asin/product-category-api.ts', fn: 'searchProductCategories', line: 'if (companyId != null) params.company_id = companyId', window: 450, title: 'GET /product-categories/search 搜索' },
|
||
{ menuKey: 'admin_product_categories', file: 'src/pages/asin/product-category-api.ts', fn: 'fetchProductCategoryChildren', line: 'if (companyId != null) params.company_id = companyId', window: 450, title: 'GET /product-categories/children 懒加载子级' },
|
||
{ menuKey: 'admin_product_categories', file: 'src/pages/asin/product-category-export.ts', fn: 'buildProductCategoryExportUrl', line: 'if (companyId != null) params.push(`company_id=${companyId}`)', window: 400, title: 'GET /product-categories/export 导出(字符串拼接而非对象,锚整条 push)' },
|
||
// ↓ 批次 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 处(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_dedupe_total_data: pinsFor('admin_dedupe_total_data'),
|
||
admin_invalid_asin_data: pinsFor('admin_invalid_asin_data'),
|
||
admin_query_asin: pinsFor('admin_query_asin'),
|
||
admin_skip_price_asin: pinsFor('admin_skip_price_asin'),
|
||
admin_product_categories: pinsFor('admin_product_categories'),
|
||
// 批次 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'),
|
||
admin_users: pinsFor('admin_users'),
|
||
}
|
||
|
||
/** 严格判据的分母由本轮实扫得出(修完不许恒绿也不许恒红):求值了几条 shape、其中几条通过。 */
|
||
let strictPinsEvaluated = 0
|
||
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\s*[:=]/.test(stripComments(read(file)))) {
|
||
gaps.push(`${file} 没把 company_id 当成查询参数下传`)
|
||
}
|
||
}
|
||
// 取值口登记(复评 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\s*[:=]/.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 里那 17 条 shape 对真实文件的求值 + 变异自证。
|
||
// ⚠ 分母是本轮实扫的表条数(批次 1 的 5 + 批次 2 的 12 + 批次 3 的 4 + 批次 4 的 1)。这条只防"整表被摘空/被改窄",
|
||
// 逐处脱管由下面两条(对平闸门 + 窗口对平)负责。
|
||
assert.ok(SEND_POINTS.length >= 22,
|
||
`发送口表只剩 ${SEND_POINTS.length} 条(批次 1+2+3+4 实扫 22 条)⇒ 有人把钉从表里摘了,取值口看守成空`)
|
||
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 计数)在这里只当"钉数与发送口条数对平"的闸门,不当"是哪一处"的判据:
|
||
// 计数回答不了"哪三处"(把一处重复写三遍、另一处删掉,计数照样对平),所以主判据仍是路线 ① 的函数名锚 + 有界窗口。
|
||
// 分母按 (文件, 整行) 而不是按文件:批次 2 的 product-category-api.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, 17,
|
||
`发送口表按 (文件, 整行) 应聚成 17 组(22 处发送口),现在却有 ${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 三处同行(next 实测 705/929/无)是这一族唯一的真冲突面,其余 14 处 own 唯一。
|
||
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() 会被第一处糊弄')
|
||
}
|
||
})
|
||
|
||
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 两对)。
|
||
* `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 数据还一样」那一批)。
|
||
// 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/AsinInvalidPage.vue',
|
||
token: 'filter.groupId = null',
|
||
why: '品牌库的分组下拉按公司收窄,留着上一家的 groupId 就是拿一个新一家看不见的组去筛列表',
|
||
premise: [
|
||
{ file: 'src/pages/invalidasin/invalid-asin-api.ts', shapes: [/company_id\s*=\s*query\.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/] },
|
||
],
|
||
},
|
||
{
|
||
file: 'src/pages/asin/ProductCategoryPage.vue',
|
||
token: 'childrenState.clear()',
|
||
why: '类目树是**懒加载缓存**:childrenState 里存着上一家每个父级的子页与页码,切公司不清它,展开同一父级就'
|
||
+ '直接把别家的子类目画出来(这一处根本不发请求,比"筛成空页"更静默)',
|
||
premise: [
|
||
{ file: 'src/pages/asin/product-category-api.ts', shapes: [/company_id\s*=\s*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/] },
|
||
],
|
||
},
|
||
]
|
||
|
||
/** 取「`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 一页)', () => {
|
||
assert.ok(WATCH_BODY_PINS.length >= 10,
|
||
`watch 体看守只剩 ${WATCH_BODY_PINS.length} 对(批次 1 的店铺管理/任务看板 + 批次 2 的去重库/品牌库/查询ASIN/最低价ASIN/商品类目 + 批次 3 的撞款监控/店铺数据记录 + 批次 4 的用户管理共 10 对)`
|
||
+ '⇒ 这一族又退回"只钉少数几页",被摘掉那一页的"切公司不清筛选项"再次没人看守')
|
||
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')
|
||
})
|