refactor(phase-3): 首迁 ShopMatch 接入管线底座,顺手补齐三件实测缺件

蓝图 §5 Phase 2 那条「两支公共件目前零生产调用方、契约可用只由单测证明」在本笔解除:
ShopMatchTaskService 现在真的继承 AbstractShopPayloadTaskPipeline,submitResult 的
「准入→取锁→按店名建索引→逐行合并→changed 闸门→重算状态」整段改为骨架调用,
本支只留 applyShopResultRow 与 onShopRowsRecomputed 两个钩子——判序(先合并再判 error)
留在被迁支里,家族层 javadoc 点名「刻意不沉」的就是它,没动。

底座缺件三件,都是「换不上就是本类缺件」那条规则的实测产物:
① newTaskHeader/newScopeRow 各加一枚带显式时刻的重载。ShopMatch 建单用的是
   now()=LocalDateTime.now(Asia/Shanghai) 且同一枚时刻复用给每一行结果行,
   底座原来只有默认时区、逐行各取一次那一版——直接套上去就把建单时间整体挪了,
   而这条快照量不出来(时钟刻意不进快照)。PriceTrack 那一派仍用五参/六参默认版。
② writeJson:Phase 2 登记「随 Phase 3 首迁同笔落」的那件,这笔落了。
   捕获账因此是净减(整树 total 1003→1002、RETHROW 387→386 正落在下限上、decoy 0),
   没有放宽任何一格;task 模块内部那三份逐字同名件仍未归并——归并会跌破 RETHROW 下限,
   那是「调整门禁判据」动作,与 Phase 0 三格守卫同批做,不在迁移笔里顺手干。
③ onPayloadIndexed(默认空实现):底座刻意不打日志,而 PriceTrack:617 有一句
   「received payloadShopCount/payloadKeys」卡在准入之后、行循环之前、每次回传恰好一次。
   没有这一格,那句要么丢、要么得挪位置——挪位置就是改现网可观测行为。

迁移登记的三处步序微差(可见结果相同,逐条对过 golden):shops 非空检查从锁内移到锁外、
锁内那次重复的 taskId 检查改由准入序列承担、旧 :670 那枚没人用的 workRoot 死局部变量摘掉
(组装在 processResultFileJob 里各建各的,本层从未写过那个目录)。

证据:shopmatch 两条 golden(建单 5 例+回传流水 5 例)迁移后逐字节未动;
CatchSilence/TaskLifecycleDebt/TaskStatusVocabulary/ArchitectureBoundary(task→业务 0)
四把尺同批复跑全绿;ShopMatchTaskService 2027→2026 行(readability 只许降这条满足)。
This commit is contained in:
2026-10-18 20:47:10 +08:00
parent 121ae9b064
commit 1be4d766bb
5 changed files with 384 additions and 144 deletions
@@ -2,6 +2,7 @@ package com.nanri.aiimage.modules.task.service.pipeline;
import cn.hutool.core.util.IdUtil;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.nanri.aiimage.common.exception.BusinessCodes;
import com.nanri.aiimage.common.exception.BusinessException;
import com.nanri.aiimage.common.security.AdminAuthSupport;
@@ -38,16 +39,17 @@ import java.util.List;
* (AppearancePatent 与 DeleteBrand 全程无事务、Publish/CollectData 用
* {@code TransactionTemplate}、ShopDataCrawl/ShopMatch 用 {@code @Transactional}),
* 返回 VO 字段互不相交。所以 parse 是钩子留在各支,底座只提供落库件。</li>
* <li><b>序列化那半件本轮不沉</b>:七支建单时都写「{@code writeValueAsString} 失败即
* {@code BusinessException}(不带 cause)」,形状一致、只有文案不同,本来是最干净的公共件。
* 但 {@code config/CatchSilenceRatchetTest} 的自述规则是「新增捕获块要么别加,
* 要么同批减掉一处同形状」,而 Phase 2 禁止改七支 ⇒ 减不掉,只能不加。
* 该件随 Phase 3 首支迁移同笔落:那笔删掉被迁支的本地同名件,净增 ≤ 0。
* 现成模板已存在——{@code PublishTaskService:2118-2124} 的私有 {@code writeJson(Object, String)}
* 就是带文案参数的形状,task 模块内部另有三份逐字同名件
* ({@code TaskProgressSnapshotService:186}/{@code TaskResultItemService:405}/
* {@code TaskResultPayloadService:113}),一并归并才是正解(注意 RETHROW 那格是下限,
* 归并必须逐处记名,别悄悄搬)。</li>
* <li><b>序列化那半件已随 Phase 3 首迁落下</b>({@link #writeJson}):七支建单时都写
* 「{@code writeValueAsString} 失败即 {@code BusinessException}(不带 cause)」,形状一致、
* 只有文案不同,是最干净的公共件。Phase 2 当时落不了——{@code config/CatchSilenceRatchetTest}
* 的自述规则是「新增捕获块要么别加,要么同批减掉一处同形状」,而 Phase 2 禁止改七支
* ⇒ 减不掉只能不加(登记见蓝图 §5 Phase 2 那条);首迁这一笔删掉被迁支的本地同名件,
* 净增 ≤ 0 才成立。现成模板 {@code PublishTaskService:2118-2124} 的私有
* {@code writeJson(Object, String)} 就是带文案参数的形状。
* ⚠ task 模块内部那三份逐字同名件({@code TaskProgressSnapshotService:186}/
* {@code TaskResultItemService:405}/{@code TaskResultPayloadService:113})<b>本轮仍未归并</b>:
* 归并会把 RETHROW 那一格跌破下限(它是下限不是上限,实测首迁后正好落在 386),
* 那属于「调整门禁判据」动作,与 Phase 0 那格「三格守卫」同批做,不在迁移笔里顺手干。</li>
* <li><b>跑批</b>:服务端<b>没有属于这七支的可沉件</b>——机制早已收在
* {@link TaskFileJobService}(enqueue/claim/markSuccess/markFailed)+
* {@code TaskResultFileJobWorker}(取锁、重排、重试)+
@@ -176,8 +178,27 @@ public abstract class AbstractFileTaskPipeline<T> {
Long userId,
String deviceId,
int sourceFileCount) {
return newTaskHeader(status, taskMode, userId, deviceId, sourceFileCount, LocalDateTime.now());
}
/**
* 带<b>显式建单时刻</b>的重载——Phase 3 首迁实测出来的缺件,不是锦上添花。
*
* <p>五参版写死 {@code LocalDateTime.now()}(JVM 默认时区),那是 PriceTrack{@code :512-513}
* 的形状;ShopMatch{@code :462 → :484-485} 用的是 {@code now()}=
* {@code LocalDateTime.now(Asia/Shanghai)},并且<b>同一个时刻</b>还要喂给每一行结果行
* ({@code :503})。默认时区一旦不是业务时区(容器换 TZ、换主机、跑在 CI 里),
* 用五参版迁 ShopMatch 就把建单时间整体挪了几个小时——而这条<b>快照量不出来</b>
* (时钟刻意不进快照,否则逐字节对撞无从谈起)。所以时刻必须由被迁支自己交进来,
* 底座不替它选时区。
*/
protected final FileTaskEntity newTaskHeader(String status,
String taskMode,
Long userId,
String deviceId,
int sourceFileCount,
LocalDateTime createdAt) {
requireUserId(userId);
LocalDateTime now = LocalDateTime.now();
FileTaskEntity task = new FileTaskEntity();
task.setTaskNo(moduleType() + "-" + IdUtil.getSnowflakeNextIdStr());
task.setModuleType(moduleType());
@@ -187,8 +208,8 @@ public abstract class AbstractFileTaskPipeline<T> {
task.setCreatedBy("user:" + userId);
task.setUserId(userId);
task.setDeviceId(AdminAuthSupport.normalizeDeviceId(deviceId));
task.setCreatedAt(now);
task.setUpdatedAt(now);
task.setCreatedAt(createdAt);
task.setUpdatedAt(createdAt);
return task;
}
@@ -216,6 +237,22 @@ public abstract class AbstractFileTaskPipeline<T> {
String sourceFileUrl,
Integer rowCount,
Integer success) {
return newScopeRow(taskId, userId, sourceFilename, sourceFileUrl, rowCount, success, LocalDateTime.now());
}
/**
* 带<b>显式时刻</b>的结果行重载。理由与 {@link #newTaskHeader(String, String, Long, String, int, LocalDateTime)}
* 同一处缺件:ShopMatch{@code :503} 把建单那一枚 {@code now()} 复用给<b>每一行</b>,
* 所以同一任务的所有结果行 {@code createdAt} 逐字相同;PriceTrack{@code :538} 则逐行各取一次
* 默认时区的 {@code now()}。底座只有一种写法,就必然有一支被悄悄改掉。
*/
protected final FileResultEntity newScopeRow(Long taskId,
Long userId,
String sourceFilename,
String sourceFileUrl,
Integer rowCount,
Integer success,
LocalDateTime createdAt) {
FileResultEntity row = new FileResultEntity();
row.setTaskId(taskId);
row.setModuleType(moduleType());
@@ -224,7 +261,7 @@ public abstract class AbstractFileTaskPipeline<T> {
row.setRowCount(rowCount);
row.setSuccess(success);
row.setUserId(userId);
row.setCreatedAt(LocalDateTime.now());
row.setCreatedAt(createdAt);
return row;
}
@@ -241,6 +278,35 @@ public abstract class AbstractFileTaskPipeline<T> {
return saved;
}
/**
* 「序列化失败即拒」的公共件——Phase 2 登记为「随 Phase 3 首迁同笔落」的那一件,现在落了。
*
* <p>七支建单与状态回写时都要把对象转成 JSON,失败形状逐字相同:
* 抛 {@code BusinessException(<文案>)} 且<b>不带 cause</b>
* (ShopMatch{@code :510-512} 的文案是「task 不存在」、{@code :1301-1303} 是「序列化任务数据失败」,
* PriceTrack{@code :571-573} 与 Publish{@code :2118-2124} 同款)。
* 文案是各支自己的对外语义(其中「task 不存在」甚至是现网一句会说谎的文案——序列化失败跟任务存不存在
* 没关系,但 Python 侧按这句决定要不要重试,改它=改线协议),所以底座只收形状、文案由调用方给。
*
* <p><b>为什么 Phase 2 不能落、首迁这一笔必须落。</b>{@code CatchSilenceRatchetTest} 的自述规则是
* 「新增捕获块要么别加,要么同批减掉一处同形状」,而 Phase 2 禁止改七支 ⇒ 当时只能不加。
* 首迁这一笔把被迁支的本地同名件删掉,净增才是 ≤ 0(实测:本件 +1 处重抛,
* ShopMatch 两处 −2 处 ⇒ 整树 total 由 1003 降到 1002、RETHROW 由 387 落到下限 386,
* 两个判据一条都没放宽)。
*
* <p>捕获面是宽的一类({@code Exception})而不是只收 {@code JsonProcessingException}:被迁支原样就是宽捕获,
* 收窄会让「序列化器自己抛的 RuntimeException」从「拒单」变成「冒出去」——那是行为变更,不归本件。
*
* @param failureMessage 失败时对外的文案,逐字取被迁支现网那句
*/
protected final String writeJson(ObjectMapper objectMapper, Object value, String failureMessage) {
try {
return objectMapper.writeValueAsString(value);
} catch (Exception ex) {
throw new BusinessException(failureMessage);
}
}
// ------------------------------------------------------------------
// 段 3:回传落库——准入序列
// ------------------------------------------------------------------
@@ -84,6 +84,20 @@ public abstract class AbstractShopPayloadTaskPipeline<T> extends AbstractFileTas
return moduleType();
}
/**
* 索引建好、行循环开始之前的观察点。默认空实现。
*
* <p><b>为什么要有这一格——它是首迁实测出来的缺件,不是预留扩展点。</b>底座刻意不打日志
* (见 {@link AbstractFileTaskPipeline#admitSubmission} 那句「日志不是公共形状」),
* 而 PriceTrack{@code :617} 在现网有一句 {@code [price-track] submitResult received
* payloadShopCount=.. payloadKeys=..},位置正好卡在「准入已通过+载荷已建索引+行循环还没开始」。
* 那句话巡检按它数过回传批次,删掉就是改现网可观测行为;但除了这一格,模板里没有别的点
* 能同时满足「在拒绝路径之后、在逐行处理之前、每次回传恰好一次」。
* 所以给一个默认空的观察点:不需要它的支(ShopMatch)一个字都不用改。
*/
protected void onPayloadIndexed(FileTaskEntity task, Map<String, T> payloadByShopKey) {
}
/**
* 段 3「回传落库」整段骨架。入参 {@code incoming} 即各支请求里的 {@code shops} 列表。
*
@@ -112,6 +126,7 @@ public abstract class AbstractShopPayloadTaskPipeline<T> extends AbstractFileTas
acquireSubmissionLockOrThrow(taskId, submissionLockLogTag())) {
FileTaskEntity task = admitSubmission(taskId, terminalRejection, ownershipOperation);
Map<String, T> payloadByShopKey = indexByShopKey(incoming, rawShopNameOf);
onPayloadIndexed(task, payloadByShopKey);
boolean changed = false;
for (FileResultEntity row : listScopeRows(taskId)) {
String shopKey = row.getSourceFilename();