docs(phase-3): 3D 前置出处账——底座把 Publish 记成 TerminalRejection#ERROR 的出处这一笔不实,改记成第三种形状

纯 javadoc,一行生产逻辑未动(`git diff --stat` = 12+/4−,全在注释块内)。

3D 前置 golden(上一枚 commit)逐段读完 publish 的终态后,发现底座 `TerminalRejection#ERROR` 那段注释里两处不实:
- **Publish 从来不是本档位的使用方**。Phase 2 把它按「不带 code」这一维归了类并留了个 `:1344` 指针,但 `PublishTaskService` 全文零次出现「任务已结束」;它真实的两处是 `:1104-1108`/`:1137-1141`,形状是本枚举**没建模的第三种**:SUCCESS 静默返回(不抛),FAILED 才抛「任务已失败,拒绝继续回传」。golden 的 `taskSuccessShortCircuitsWithoutThrowing` = 两次 `task.load` + `tx.begin/commit`、零写入、`result=void` 就是这条的物证。
- **ShopDataCrawl 的 `:633` 指针也已漂**(那行现在是建单段的 `newTaskHeader`),真出处是 `submitResult` 里 `:676`。连同 `IDEMPOTENT` 段的 ShopMatch `:652`/PriceTrack `:603`(实测在 `:675`/`:642`)一起,本笔一律改成**认方法名不认行号**——这正是 3C 那笔给 CollectData 立过的规矩,当时只改了 CollectData 一支的行,剩下三支的行号照旧漂着。

对 3D 的直接结论:publish 接底座时这一格既不能套 IDEMPOTENT 也不能套 ERROR,只能留本地写法、或先给枚举加第三档;加档属公共形状变更,要单独授权。这一格与 `:1104` 那处的「锁外预检」合起来,是 publish 与 collectdata 虽同属 chunk+scope 族、却不能照抄迁移的两处硬差。

门禁:`mvn -o test-compile` rc=0;ratchet/护栏七类合跑 `Tests run: 77, Failures: 0`(含 `CatchSilenceRatchetTest` 9、`SourceScanTest` 40、`LockSkipSilentExitGuardrailTest` 4);ops readability ratchet 9 passed——本件现 551 行(ruler 口径),距 800 报警线尚有 249 行,注释变厚不构成新 offender。全量 4537 已在上枚 commit 前跑过,本笔只动注释、不重复消耗。
This commit is contained in:
2026-10-19 17:56:34 +08:00
parent f5c64b3b23
commit 6a43a7e745
@@ -89,20 +89,28 @@ 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——3C 实测这一支是**七支里
* 唯一把本件用两次的**({@code submitResult} 的锁外预检+锁内复核;迁移前那两个 {@code 40901}
* 抛出点在 {@code :864/:904},迁后行号不再作数,认方法名)。
* 现网出处(一律认方法名, migrated 件的行号每笔都在漂):ShopMatch/PriceTrack 的 {@code submitResult}
* 把本档位当参数交给 {@code submitShopScopedResults};CollectData 的 {@code submitResult} 是**七支里
* 唯一把本件用两次的**(锁外预检+锁内复核)。
*/
IDEMPOTENT,
/**
* 不带 code({@code BusinessException(String)}):响应 success=false,调用方会当错误处理。
* 现网出处:ShopDataCrawl {@code :633}/Publish {@code :1344}——两支文案就是本件那句
* 现网出处**只有 ShopDataCrawl 一支**——它的 {@code submitResult} 用本档位,文案即本件那句
* 「任务已结束,拒绝重复提交」。
*
* <p><b>3E 实测补正:{@code DeleteBrandRunService:1384} 同属不带 code 这一形,文案却只有
* 「任务已结束」。</b>本件把文案写死了,所以那一支接不上、留本地写法(它的回传段 golden
* {@code terminalTaskRejected} 逐字钉着这句)。Phase 2 原先把 DeleteBrand 列在本件出处里,
* 是按「有无 code」这一维归的类,文案那一维当时没数过。
*
* <p><b>3D 前置测绘第二处补正:Phase 2 把 Publish 列在本档位出处里,那条不实。</b>
* {@code PublishTaskService} 全文零次出现「任务已结束」,它的终态是本枚举<b>没建模的第三种形状</b>:
* SUCCESS 不抛、静默返回({@code prepareResultSubmission} 返回空 prepared、{@code submitResultLocked}
* 返回 {@code commit(false, 空集)}),只有 FAILED 抛「任务已失败,拒绝继续回传」。
* 证据:回传段 golden {@code taskSuccessShortCircuitsWithoutThrowing} 逐段钉着「两次 task.load +
* tx.begin/commit、零写入、result=void」。所以 3D 接底座的这一格既不能套 IDEMPOTENT 也不能套 ERROR,
* 得留本地写法或先给枚举加第三档——这是形状差,不是行号差。
*/
ERROR
}