fix(产品风险): 启动前拦掉缺筛选值,选到「在售」要用户签字

「商品列表筛选」是产品风险审批唯一的取数条件,但它只随本地队列下发、不建单落库,
选错了界面上不留任何痕迹(2026-10-17 陈先锋·德国站选成在售,白跑 7 小时)。

- listingFilters.ts 新增 productRiskFilterIssues:缺键/空串 = block(Python 端会拿
  空值去页面上找一个不存在的选项,整国以「没有需要审批的商品」假成功收尾),
  「在售」这类非风险状态 = confirm(不禁止选,但要让人知道自己选了它)。
- checkQueuePayload 开一个 extraIssues 口子给业务侧判据用:ok/needsConfirm 与
  「有 block 就不展示 confirm」这条规则仍只在 dispatch-guard 里解释一遍,
  不在组件里拼第二份结果。
This commit is contained in:
2026-10-19 19:16:52 +08:00
parent de38c3ec58
commit a97dbf7f1d
4 changed files with 152 additions and 1 deletions
@@ -155,7 +155,7 @@ import { ElMessage } from 'element-plus'
import AmazonToolPageShell from '@/pages/amazon/components/AmazonToolPageShell.vue';
import TaskCenterPanel from '@/shared/components/tasks/TaskCenterPanel.vue'
import type { TaskItemView, TaskStatCard } from '@/shared/components/tasks/types'
import { LISTING_FILTER_OPTIONS, type ListingFilterValue } from '@/pages/brand/components/listingFilters'
import { LISTING_FILTER_OPTIONS, RISK_LISTING_FILTER_KEY, productRiskFilterIssues, type ListingFilterValue } from '@/pages/brand/components/listingFilters'
import {
addProductRiskCandidate,
createProductRiskTask,
@@ -1109,6 +1109,8 @@ function productRiskPayloadGuard(payload: unknown) {
expectedType: 'product-risk-resolve-run',
requiredDataKeys: ['taskId'],
nonEmptyArrayKeys: ['items', 'country_codes'],
// 结构对得上不代表选对了:筛选状态选到「在售」会整单白跑,缺键会让 Python 端假成功
extraIssues: (data) => productRiskFilterIssues(data[RISK_LISTING_FILTER_KEY]),
})
}
@@ -1,3 +1,5 @@
import type { GuardIssue } from '@/shared/dispatch-guard'
export const LISTING_FILTER_OPTIONS = [
{ value: 'SearchSuppressed', label: '在搜索结果中禁止显示' },
{ value: 'ApprovalRequired', label: '需要批准' },
@@ -7,6 +9,52 @@ export const LISTING_FILTER_OPTIONS = [
export type ListingFilterValue = (typeof LISTING_FILTER_OPTIONS)[number]['value']
/**
* 「在售」不是风险状态:这一档下的商品大多没有解决入口,跑完的结果表里「移除ASIN」列会是空的。
* 2026-10-17 陈先锋·德国站实测:选到在售 ⇒ 394 行里 219 行「没有处理入口」,跑了 7 小时,
* 而任务参数里看不出选错了什么(该键只走本地队列、不落库)。
* 不禁止选它——确实有人只想看在售商品的面板——但必须让用户签字,且缺键直接拦下。
*/
export const NON_RISK_LISTING_FILTERS: readonly ListingFilterValue[] = ['Active']
/** 载荷里「商品列表筛选」的键名,与 app_client/amazon/approve.py 读取的字段逐字一致 */
export const RISK_LISTING_FILTER_KEY = 'risk_listing_filter'
function listingFilterLabel(value: string): string {
return LISTING_FILTER_OPTIONS.find((opt) => opt.value === value)?.label || value
}
/**
* 产品风险审批的筛选值判据:缺键/空串 = block(Python 端会拿它去页面上找一个 value="" 的
* 选项,必然落空并以「没有需要审批的商品」假成功收尾);非风险状态 = confirm。
* 返回的是 dispatch-guard 的 GuardIssue 形状,由 checkQueuePayload 的 extraIssues 承接,
* ok/needsConfirm 与「有 block 就不展示 confirm」那条规则不在这里重复解释。
*/
export function productRiskFilterIssues(filter: unknown): GuardIssue[] {
const value = typeof filter === 'string' ? filter.trim() : ''
if (!value) {
return [{
code: 'product-risk.filter-missing',
severity: 'block',
message:
`任务数据缺少「商品列表筛选」(${RISK_LISTING_FILTER_KEY}),已阻止启动。\n` +
'Python 端拿到空值会去页面上找一个不存在的筛选选项,整国以「没有需要审批的商品」空跑收尾。\n' +
'请先在「商品列表筛选」里选择状态,再点启动任务。',
}]
}
if ((NON_RISK_LISTING_FILTERS as readonly string[]).includes(value)) {
return [{
code: 'product-risk.filter-not-risk',
severity: 'confirm',
message:
`你选的「${listingFilterLabel(value)}」不是风险状态:这一档下的商品大多没有处理入口,` +
'结果表的「移除ASIN」列通常为空。\n' +
'要处理被禁止显示/已删除的商品,请改选对应状态。确定仍按这个筛选执行吗?',
}]
}
return []
}
/**
* 跟价「按商品状态(全量)」可勾选的状态(2026-10-16 多状态立项)。
*
+11
View File
@@ -437,6 +437,13 @@ export interface QueuePayloadOptions {
positiveNumberKeys?: readonly string[]
/** 期望的 type 值;不匹配时 block */
expectedType?: string
/**
* 业务侧自己那条「数据对不对得上功能」的判据,在通用结构校验之后跑。
* 收 data(已通过 isPlainObject 的那一层),返回若干 GuardIssue;block 拦下、confirm 让用户签字。
* 为什么要留这个口子而不是让各 Tab 自己拼结果:结果的 ok/needsConfirm/标题与
* 「有 block 就不展示 confirm」这条规则只在这里解释一遍,抄第二份就会漂。
*/
extraIssues?: (data: Record<string, unknown>) => GuardIssue[]
title?: string
}
@@ -576,6 +583,10 @@ export function checkQueuePayload(
})
}
if (options.extraIssues) {
issues.push(...options.extraIssues(data))
}
return buildResult(title, title, issues)
}