docs(phase-3): 3C 出处账续笔——底座对 CollectData 的四枚行号指针改指方法名,publishResultFile 的「六支同形」改写成分层事实

迁移把被迁支的行号整体挪动,指针会腐烂(3A 已为此把 :1265 换成方法名,这次同一
失效模式又出现四处):TerminalRejection#IDEMPOTENT/newTaskHeader/successFileCount
/enqueueResultAssembly 的 CollectData 读数一律改指 persistParsedTask、
enqueueFinalWorkbook、processResultFileJob。

publishResultFile 那条「六支逐字相同」在 3C 之后不再成立,按实测改成分层表述:
列形状七支都有,真接上本件的目前只有 shop-payload 两支(grep 全树 publishResultFile
调用点核实),另有三种「接不上」的理由——ShopDataCrawl 批量条件更新、DeleteBrand
的可空 rowCount、CollectData 的上传必须排在 persistStats 之前(那条时序是自愈前提)。
判据与代码一行未动。
This commit is contained in:
2026-10-19 15:45:42 +08:00
parent 49107bb2ad
commit e1bc19d331
@@ -60,9 +60,11 @@ import java.util.List;
* 与结果行列举;<b>不能沉</b>的是合并模型——实测三个家族(chunk+scope/
* shop-payload/DeleteBrand 自有存储),shop-payload 那族见
* {@link AbstractShopPayloadTaskPipeline}。</li>
* <li><b>出结果</b>:六支逐字相同的是「上传对象存储 → 写 6 列 → {@code updateById}」
* ({@link #publishResultFile}),第七支 ShopDataCrawl 走批量条件更新、不在其列
* (见该方法注释)。<b>本类不新建 report SPI</b>——
* <li><b>出结果</b>:「上传对象存储 → 写列 → {@code updateById}」这一形七支都有({@link #publishResultFile}),
* 但<b>真接上本件的目前只有 shop-payload 那两支</b>——其余各支都有独立实测的接不上理由:
* ShopDataCrawl 走批量条件更新(列数与状态位都不同)、DeleteBrand 的 {@code rowCount} 是可空
* {@code Integer}、CollectData 的上传必须排在 {@code persistStats} 之前(那条时序是自愈前提)。
* 三条理由逐条写在方法注释里,别把这句读成「六支都能换」。<b>本类不新建 report SPI</b>——
* {@code ResultFileJobHandler} 已是该段的注册契约(moduleType 唯一、启动 fail-fast),
* 各支的 Handler 实现改为复用这段骨架,而不是再立一套。</li>
* </ul>
@@ -87,7 +89,9 @@ public abstract class AbstractFileTaskPipeline<T> {
/**
* 带 {@link BusinessCodes#TASK_ALREADY_FINISHED}(40901):
* {@code GlobalExceptionHandler} 转 HTTP 200 + success=true,Python 侧按幂等忽略、停止重试。
* 现网出处:ShopMatch {@code :652}/PriceTrack {@code :603}/CollectData {@code :864/:904}。
* 现网出处:ShopMatch{@code :652}/PriceTrack{@code :603}/CollectData——3C 实测这一支是**七支里
* 唯一把本件用两次的**({@code submitResult} 的锁外预检+锁内复核;迁移前那两个 {@code 40901}
* 抛出点在 {@code :864/:904},迁后行号不再作数,认方法名)。
*/
IDEMPOTENT,
/**
@@ -164,7 +168,8 @@ public abstract class AbstractFileTaskPipeline<T> {
* 是一处微差——它们各调了两次 {@code LocalDateTime.now()}(可能差几微秒),底座只取一次;
* 两列都只用于「建单时刻」,无人拿它们互相比较,故按 Majority 的单次写法沉。
* 出处:ShopDataCrawl{@code :575-587}/ShopMatch{@code :473-486}/Publish{@code :1054-1070}
* /CollectData{@code :329-341}/AppearancePatent{@code :196-214}/PriceTrack{@code :501-513}
* /CollectData{@code persistParsedTask}(3C 已改接本件,迁移前是 {@code :329-341})
* /AppearancePatent{@code :196-214}/PriceTrack{@code :501-513}
* /DeleteBrand{@code :146-157}。
*
* <p>{@code taskMode} 六支 {@code "PYTHON_QUEUE"}、DeleteBrand 一支 {@code "IMMEDIATE"};
@@ -175,7 +180,7 @@ public abstract class AbstractFileTaskPipeline<T> {
*
* <p><b>{@code successFileCount}/{@code failedFileCount} 刻意不由底座初始化</b>:建单时五支写 0
* (AppearancePatent{@code :202-203}/ShopDataCrawl{@code :581-582}/ShopMatch{@code :479-480}/
* PriceTrack{@code :507-508}/CollectData{@code :333-334}),Publish{@code :1060-1061} 写的是
* PriceTrack{@code :507-508}/CollectData{@code persistParsedTask} 里那两行 {@code set*(0)}),Publish{@code :1060-1061} 写的是
* 真实失败数,而 DeleteBrand{@code :146-157} 首次 insert 两列都留 NULL、到 {@code :268-278}
* 循环后才回填。底座一旦默认写 0,就把 DeleteBrand 的「还没统计」偷换成了「零成功零失败」。
* 其余模块专有列({@code requestJson}/{@code resultJson}/{@code scheduledAt}
@@ -466,7 +471,7 @@ public abstract class AbstractFileTaskPipeline<T> {
* 挂一个结果文件组装 Job。{@code scopeKey} 实测是<b>四形</b>的,不是笔误:
* 归属实例域 {@code task:{id}:owner:{instance}}(Publish{@code :1046/:1216}、
* ShopDataCrawl{@code :1920}、AppearancePatent{@code :1753})/固定 {@code task:{id}}
* (CollectData{@code :1122})/店铺名(ShopMatch{@code :883}、PriceTrack{@code :905})
* (CollectData{@code enqueueFinalWorkbook},3C 已改接本件)/店铺名(ShopMatch{@code :883}、PriceTrack{@code :905})
* /文件身份(DeleteBrand{@code :1505/:1770})。底座只转发,不解释形状。
*/
protected final void enqueueResultAssembly(Long taskId, Long resultId, String scopeKey) {
@@ -479,10 +484,19 @@ public abstract class AbstractFileTaskPipeline<T> {
/**
* 把已组装好的结果文件上传对象存储,并写回结果行的 6 列后落库。
* 出处(六支同形):ShopMatch{@code :828-840}/PriceTrack{@code :845-857}/
* Publish{@code :590-598}/CollectData{@code :1166-1190}/AppearancePatent{@code :1876}
* 出处(列形状六支相同):ShopMatch{@code :828-840}/PriceTrack{@code :845-857}/
* Publish{@code :590-598}/CollectData{@code processResultFileJob}/AppearancePatent{@code :1876}
* /DeleteBrand{@code :1921-1929}。
*
* <p><b>3C 实测:列形状同形不等于接得上——{@code CollectData} 接不上,卡在上传的时序。</b>
* 本件把「上传」捆在「写列」之内,而本支现网是
* {@code uploadResultFile → persistStats → 失败原因计算 → 写列 → 条件 UPDATE 任务},
* 那条先后是 {@code processResultFileJob} 里「结果文件先于任务成功落库」那句注释立着的
* 自愈前提(进程夹在两步之间退出时任务仍是 RUNNING,会被陈旧巡检重新组装)。
* 套上本件等于把上传挪到 {@code persistStats} 之后——上传失败时落库形状就变了。
* 故 3C 保留本地写法;这里记的是<b>第二种「不适用」理由</b>
* (第一种是 ShopDataCrawl 的批量条件更新,见下)。
*
* <p><b>DeleteBrand 形状同、入参不同,本件对它接不上(3E 实测)</b>:现网
* {@code :1916-1924} 写的是 {@code setRowCount(parsedFile.getTotalRows())},那枚
* {@code DeleteBrandParsedFileCacheDto.totalRows} 是<b>可空 Integer</b>(缓存里读出来的载荷可能没这格),