diff --git a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java index c8ef31398..6ed05982c 100644 --- a/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java +++ b/backend-java/src/main/java/com/nanri/aiimage/modules/task/service/pipeline/AbstractFileTaskPipeline.java @@ -27,7 +27,8 @@ import java.util.List; * *
本类只沉「七支巨石实测逐字相同的那一截」,不承诺统一四段。签名逐条来自 * 2026-10-18 对七支现网代码的定点实贴(AppearancePatent 3,377/ShopDataCrawl 3,195/ - * DeleteBrand 2,304/PriceTrack 2,302/Publish 2,249/CollectData 2,162/ShopMatch 2,027), + * DeleteBrand 2,304/PriceTrack 2,302/Publish 2,249/CollectData 2,162/ShopMatch 2,027) + * ——这组数是「签名的来源」,不是现状:被迁支逐笔只降不升,现状认蓝图 §4 各格实录, * 每段方法的注释里都写了它的出处行号,Phase 3 迁移时被迁移支必须能逐字替换, * 换不上就是本类缺件,不是迁移方自由发挥。 * @@ -44,8 +45,8 @@ import java.util.List; * 只有文案不同,是最干净的公共件。Phase 2 当时落不了——{@code config/CatchSilenceRatchetTest} * 的自述规则是「新增捕获块要么别加,要么同批减掉一处同形状」,而 Phase 2 禁止改七支 * ⇒ 减不掉只能不加(登记见蓝图 §5 Phase 2 那条);首迁这一笔删掉被迁支的本地同名件, - * 净增 ≤ 0 才成立。现成模板 {@code PublishTaskService:2118-2124} 的私有 - * {@code writeJson(Object, String)} 就是带文案参数的形状。 + * 净增 ≤ 0 才成立。现成模板 {@code PublishTaskService} 的私有 + * {@code writeJson(Object, String)} 就是带文案参数的形状(认方法名不认行号;那一格 3D 未并档)。 * ⚠ task 模块内部那三份逐字同名件({@code TaskProgressSnapshotService:186}/ * {@code TaskResultItemService:405}/{@code TaskResultPayloadService:113})本轮仍未归并: * 归并会把 RETHROW 那一格跌破下限(它是下限不是上限;首迁后落在 386,3B 并掉 ShopDataCrawl @@ -61,7 +62,9 @@ import java.util.List; * shop-payload/DeleteBrand 自有存储),shop-payload 那族见 * {@link AbstractShopPayloadTaskPipeline}。 *
3D 补记:Publish 从本笔起真走这格——它把原本一次三条件的 {@code requireTaskRecord}
+ * 拆成「加载+模块校验交 {@link #requireSubmissionTask},归属那一格留本地(因为它还认
+ * {@code userId} 可空)」,异常类型/文案/检查之间无副作用三条都同源,判据未动。
+ * 换句话说本钩子在被迁支身上不是为了满足抽象签名而写的死件。
*/
protected abstract FileTaskEntity loadTaskForSubmission(Long taskId);
@@ -157,9 +166,13 @@ public abstract class AbstractFileTaskPipeline Publish 那支的本体必须保持 {@code public}:{@code PublishTaskHeartbeatSpi:28} 从类外调它
+ * (心跳入口要先验归属再动任务),覆写只许放宽不许收窄,所以 3D 迁移保持 {@code public}
+ * + {@code @Override},没收成 {@code protected}。
*/
protected void ensureTaskOwnedByCurrentInstance(FileTaskEntity task, String operation) {
}
@@ -175,7 +188,8 @@ public abstract class AbstractFileTaskPipeline {@code taskMode} 六支 {@code "PYTHON_QUEUE"}、DeleteBrand 一支 {@code "IMMEDIATE"};
* {@code status} 建单时各不相同——{@code RUNNING}(ShopDataCrawl/PriceTrack/DeleteBrand)、
* {@code PENDING}(AppearancePatent/CollectData)、{@code SCHEDULED}(ShopMatch 带排期时)、
- * 乃至 Publish 在全部文件解析失败时直接 {@code FAILED}({@code :1058})。
+ * 乃至 Publish 在全部文件解析失败时直接 {@code FAILED}(现由它的 {@code persistTask} 显式传入)。
* 两者一律由调用方显式传入,不在底座设默认值——设了就会有人不再想它。
*
* {@code successFileCount}/{@code failedFileCount} 刻意不由底座初始化:建单时五支写 0
* (AppearancePatent{@code :202-203}/ShopDataCrawl{@code :581-582}/ShopMatch{@code :479-480}/
- * PriceTrack{@code :507-508}/CollectData{@code persistParsedTask} 里那两行 {@code set*(0)}),Publish{@code :1060-1061} 写的是
- * 真实失败数,而 DeleteBrand{@code :146-157} 首次 insert 两列都留 NULL、到 {@code :268-278}
+ * PriceTrack{@code :507-508}/CollectData{@code persistParsedTask} 里那两行 {@code set*(0)}),Publish 的
+ * {@code persistTask} 写的是真实失败数(3D 迁移后那两行仍留在本支,本件不代它统计),而 DeleteBrand{@code :146-157} 首次 insert 两列都留 NULL、到 {@code :268-278}
* 循环后才回填。底座一旦默认写 0,就把 DeleteBrand 的「还没统计」偷换成了「零成功零失败」。
* 其余模块专有列({@code requestJson}/{@code resultJson}/{@code scheduledAt}
* /{@code errorMessage}/{@code finishedAt})同样请在返回的实体上继续 set,再交 {@link #insertTask}。
@@ -305,7 +319,8 @@ public abstract class AbstractFileTaskPipeline 七支建单与状态回写时都要把对象转成 JSON,失败形状逐字相同:
* 抛 {@code BusinessException(<文案>)} 且不带 cause
* (ShopMatch{@code :510-512} 的文案是「task 不存在」、{@code :1301-1303} 是「序列化任务数据失败」,
- * PriceTrack{@code :571-573} 与 Publish{@code :2118-2124} 同款)。
+ * PriceTrack{@code :571-573} 与 Publish 的私有 {@code writeJson} 同款;Publish 那一格 3D 迁移
+ * 未并档——它要动 {@code RETHROW_FLOOR},属门禁判据动作、须逐处记名授权)。
* 文案是各支自己的对外语义(其中「task 不存在」甚至是现网一句会说谎的文案——序列化失败跟任务存不存在
* 没关系,但 Python 侧按这句决定要不要重试,改它=改线协议),所以底座只收形状、文案由调用方给。
*
@@ -464,9 +479,17 @@ public abstract class AbstractFileTaskPipeline 3D 核过的真数:调本件的是四支(ShopMatch/PriceTrack/ShopDataCrawl/
+ * DeleteBrand{@code :1609/:1717})。本注释此前写「三支」,是把出处里那句「DeleteBrand 同款」
+ * 读成了「形状同款、还没接」——它 3E 就接上了,这句一直没跟着改。其余三支
+ * (AppearancePatent/CollectData/Publish)虽都在底线上,却没有一支调本件,因为它们读的不是
+ * 「按 taskId 取全部结果行」这一形:AP 那些 {@code selectList} 带 {@code .select(...)} 投影
+ * ({@code AppearancePatentTaskService:346}),CollectData 的是跨任务历史分页
+ * ({@code :699} 按 userId+{@code orderByDesc(createdAt)+limit}),Publish 回传侧用
+ * {@code ensureTaskResult} 那句 {@code selectOne(... limit 1)}、查不到就 insert。
+ * 别说成「七支都用它」,也别把「在底线上」读成「用过每一格」。
*/
protected final List 3C 实测:列形状同形不等于接得上——{@code CollectData} 接不上,卡在上传的时序。