task-207(服务层): done=true 终态决策纯语义（SimilarAsinSubmitResultSemantics：done/error→终态回调、chunkIndex/Total 缺省归一）接线回 submit + 8 单测

按 3+2 约定：文件生成/终态落库依赖真实 LLM 流水线，留待真实运行时经 env-gated 回放（CONTRACT_* 已就绪）
2026-09-05 09:10:51 +08:00
parent dacdab7adb
commit c282327a0b
3 changed files with 113 additions and 3 deletions
@@ -0,0 +1,31 @@
+package com.nanri.aiimage.modules.similarasin.model;
+
+/**
+ * similarasin 结果提交语义的纯计算（task-207 提取，防业务漂移）。
+ *
+ * done=true / error 非空 => 本批为终态回调（触发读元数据/终态处理）；
+ * chunkIndex/chunkTotal 缺省归一（0/1）。纯函数，便于离线单测。
+ */
+public final class SimilarAsinSubmitResultSemantics {
+
+    private SimilarAsinSubmitResultSemantics() {
+    }
+
+    /** 是否终态回调：done=true 或 error 非空。 */
+    public static boolean isTerminalRequest(boolean done, String error) {
+        if (done) {
+            return true;
+        }
+        return error != null && !error.isBlank();
+    }
+
+    /** chunkIndex 缺省(含 <=0 之外的 null)归一为 0（与既有 submit 逻辑一致）。 */
+    public static int chunkIndex(Integer chunkIndex) {
+        return chunkIndex == null ? 0 : chunkIndex;
+    }
+
+    /** chunkTotal 缺省归一为 1。 */
+    public static int chunkTotal(Integer chunkTotal) {
+        return chunkTotal == null ? 1 : chunkTotal;
+    }
+}
@@ -1017,12 +1017,15 @@ public class SimilarAsinTaskService {
        }

        ensureTaskOwnedByCurrentInstance(task, "submit result");
-        int chunkIndex = request.getChunkIndex() == null ? 0 : request.getChunkIndex();
-        int chunkTotal = request.getChunkTotal() == null ? 1 : request.getChunkTotal();
+        int chunkIndex = com.nanri.aiimage.modules.similarasin.model.SimilarAsinSubmitResultSemantics
+                .chunkIndex(request.getChunkIndex());
+        int chunkTotal = com.nanri.aiimage.modules.similarasin.model.SimilarAsinSubmitResultSemantics
+                .chunkTotal(request.getChunkTotal());
        boolean done = Boolean.TRUE.equals(request.getDone());
        String scopeKey = firstNonBlank(request.getSubmissionId(), "task:" + taskId);
        String scopeHash = DigestUtil.sha256Hex(scopeKey);
-        boolean terminalCallback = done || request.getError() != null && !request.getError().isBlank();
+        boolean terminalCallback = com.nanri.aiimage.modules.similarasin.model.SimilarAsinSubmitResultSemantics
+                .isTerminalRequest(done, request.getError());
        SubmittedTaskMetadata taskMetadata = terminalCallback
                ? readSubmittedTaskMetadata(task)
                : null;