Files
crawler-plugin/frontend-vue/src/shared/dispatch-guard-ui.ts
T
huangzd1997 652ec1bbc9 task-101: 上传/解析/入队三道前端拦截,阻止坏数据卡死 Python 自动化
新增 shared/dispatch-guard.ts(纯 TS 校验,可单测)与 dispatch-guard-ui.ts
(ElMessageBox 弹窗层),在数据流的三个位置设闸:

- 选文件:空选择、非 xlsx/xls/csv、空路径直接拦;重复文件弹确认
- 解析结果:taskId 非法、totalRows 为 0、整批行被丢弃、需要分组却无分组直接拦;
  部分行被丢弃弹确认后才允许推送
- 入队前:结构不符、必填字段缺失、items/groups/country_codes 为空数组、
  行数页数为 0、JSON 不安全值(NaN/Infinity/BigInt/循环引用/数组洞)

覆盖 11 个推 Python 队列的 Tab 与 dedupe/split/convert 三个纯 Java Tab。
闸位按 Tab 挑选以免留下孤儿后端状态:collect-data 校验前置到
activateCollectDataTask 之前(任务保持 PENDING 无需回滚)、product-risk 的国家
检查提到建任务之前;已建任务后才拦下的复用各 Tab 原有失败补偿路径。

两处边界:对象属性 undefined 放行(taskNo 这类可选字段是惯用写法),只拦数组
元素 undefined 与数组洞;price-track 的 asin_rows_by_country 仅在 mode=asin
时要求非空,status 模式下 loadAsinRowsForAppClient 本就返回 {}。

顺带修复 similar-asin / appearance-patent 的 selectFiles 缺少 try/catch,
上传失败会残留上一批文件与解析结果。

测试:tests/dispatch-guard.test.ts 新增 37 个 test_task_101_* 用例。
2026-09-01 12:53:12 +08:00

68 lines
2.2 KiB
TypeScript

/**
* dispatch-guard 的界面层(Task 101)。
*
* 把 GuardResult 渲染成模态框:block 级用 alert(红色、只有「知道了」,
* 必须点掉),confirm 级用 confirm(「仍然继续」/「取消」)。之所以不用
* ElMessage toast,是因为这些提示直接决定要不要把任务推给 Python 自动化,
* 3 秒自动消失的 toast 很容易被划过去。
*
* 与 dispatch-guard.ts 分开放,是为了让核心校验保持纯 TS、可以用
* `node --test` 直接跑,不必把 Element Plus 拉进测试环境。
*/
import { ElMessageBox } from 'element-plus'
import type { GuardResult } from './dispatch-guard.ts'
/** 配套样式见 src/styles/main.css 的 .dispatch-guard-box(保留换行、限制宽度) */
const GUARD_BOX_CLASS = 'dispatch-guard-box'
async function alertBlocked(result: GuardResult) {
try {
await ElMessageBox.alert(result.message, result.title, {
type: 'error',
confirmButtonText: '知道了',
customClass: GUARD_BOX_CLASS,
dangerouslyUseHTMLString: false,
})
} catch {
// 用户按 ESC / 点遮罩关闭,同样视为已知悉;拦截结果不受影响
}
}
async function confirmSuspicious(result: GuardResult) {
try {
await ElMessageBox.confirm(result.message, result.title, {
type: 'warning',
confirmButtonText: '仍然继续',
cancelButtonText: '取消',
customClass: GUARD_BOX_CLASS,
dangerouslyUseHTMLString: false,
})
return true
} catch {
return false
}
}
/**
* 按顺序处理若干校验结果,返回是否放行。
*
* - 任一结果含 block 级问题:弹 alert 并返回 false(调用方直接 return)。
* - 只含 confirm 级问题:弹 confirm,用户点「仍然继续」返回 true,否则 false。
* - 全部通过:不弹任何东西,返回 true。
*
* 用法:
* if (!(await passGuard(checkParseResult(vo)))) return
*/
export async function passGuard(...results: GuardResult[]): Promise<boolean> {
const blocked = results.find((result) => !result.ok)
if (blocked) {
await alertBlocked(blocked)
return false
}
for (const result of results) {
if (!result.needsConfirm) continue
if (!(await confirmSuspicious(result))) return false
}
return true
}