fix(phase-2): B51-R1 收口——failure_category 落库+写点全接线+双读按文案优先

判死/重试/重开原先只读 biz_file_task.error_message 里的中文子串决定:改一句用户看得见的
文案=静默改一次整单生死,而且改的人不会知道。V186 补 failure_category(可空、存量不回填),
TaskFailureLedger 作为唯一写入口把「那次判断的结果」与文案同笔落库——词汇表仍只有
TaskRetryEligibility 一处,ledger 不抄第二份 markers(B52 那族的复发形状)。

- wrapper 面 22 处写点全部同笔派生写列;实体面接线第二批(外观专利 4/相似ASIN 4/采集 1),
  正是 DELIVERY/BALANCE 那几族被判死消费的文案
- 读侧 category(task) 取「文案判得出按文案、判不出才按列」:名单外的实体写点改文案带不动列,
  无条件读列=让一列陈旧判决判死当前这一单,那是本笔自己引入的漂移,比它要修的 bug 更糟
- FileTaskEntity.failureCategory 标 @TableField(updateStrategy = ALWAYS):updateById 默认跳过
  null 字段,「清错误」的分支会留下陈旧列;让 null 真落库,最坏只退回文案判定=加列前的今天
- 判据:TaskFailureCategoryGuardrailTest(5)+TaskFailureCategoryMigrationV186Test(5),已反向验证
  「删任一处配对即红」;SourceScanTest 台账裸名 24→25、调用方 17→18
- 门禁:mvn -o test 整量 5267/0 失败/0 错误/19 skipped;_push_gate.py full overall=pass

Contract 阶段(收 contains(<中文>) 判定)按蓝图登记留到读侧全切之后,本轮不动。
This commit is contained in:
2026-11-03 12:49:45 +08:00
parent 34f730d403
commit 51401de2d5
22 changed files with 588 additions and 12 deletions
@@ -0,0 +1,30 @@
-- V186: 任务失败分类列(B51-R1,Expand-and-Contract 的 Expand 半边)
--
-- 背景(蓝图 docs/REFACTOR_PLAN.md §3.1,立项自 docs/audit/SLIMMING_REPORT.md 的 B51):
-- 重试/重开/判死全部读 `biz_file_task.error_message` 里的**中文子串**决定
-- (TaskRetryEligibility 六组 markers、TaskResultFileJobWorker 的孤儿判死、
-- SimilarAsinStaleReopenSupport 的重开白名单)。后果是"改一句用户看得见的文案"=
-- 静默改一次整单生死,而且改的人不会知道——文案是给看的,判定是拿它当枚举用的。
--
-- 设计口径:
-- * 可空:NULL=「这一行没登记分类」。存量行一律不回填(历史行的文案还在,读侧照旧能判),
-- 实体式写入面(若干 `task.setErrorMessage(...)`)本轮尚未接 ledger,落库时列为空——
-- 这两种 NULL 都是**有意的**,读侧按「文案判得出按文案、判不出按列」双读(列与文案背离时
-- 列是陈旧的,按文案才等于加列之前的行为),不许把空列读成「无类别」;
-- * 不自造第二套词汇表:值域就是 `TaskRetryEligibility.Category.name()`
-- (BALANCE/SERVICE_DOWN/CREDENTIAL/DELIVERY/STOPPED),判定逻辑仍只有那一处;
-- * VARCHAR(16) 与 V183 的 `collect_channel` 同档:五个枚举名最长 12(SERVICE_DOWN),
-- 留余量给后续分类名,不用 ENUM(ENUM 改值域要再发一次迁移,且 MyBatis 侧映射成字符串更直白);
-- * 不加索引:这一列现在只被"读某一行的分类"用到(按主键),没有按分类筛整表的查询;
-- 真要按类别统计再说,别让一条推测性索引进基线。
--
-- Contract 阶段(本轮**不做**,读侧全切之后才许动):
-- 把 `contains("<中文>")` 那批判定收掉,并让 `TaskFailureCategoryGuardrailTest`
-- 的"文案写点必须同笔写列"绊线继续守着新增点。
--
-- 回滚(手工):
-- ALTER TABLE `biz_file_task` DROP COLUMN `failure_category`;
ALTER TABLE `biz_file_task`
ADD COLUMN `failure_category` VARCHAR(16) NULL
COMMENT '失败分类(TaskRetryEligibility.Category 值域):空=未登记,读侧回落到 error_message 文案判定' AFTER `error_message`;