feat(collect-channel): 采集执行方按单判定并随 /parse 落库

「这一单交本机还是线上」原先是全局 yml aiimage.collect-routing.local-enabled,
一台服务器一个值,把同机所有账号捆成同一个执行方:本机开着的用户被迫走线上,
跑 Linux 兜底的用户也没法把某一单留在本机。现改为建单时逐单登记
biz_file_task.collect_channel(V183,可空=按模块默认),全局开关只留兜底窗口。

- 列可空且不回填:空值按模块默认解释,APPEARANCE_PATENT/SIMILAR_ASIN 读作 LOCAL、
  其余读作 ONLINE,与撤掉的 AIIMAGE_COLLECT_LOCAL_* 出厂值逐字节等价,
  历史单与未升级前端行为不变。
- TaskRetryCloneSupport.buildChild 必须继承通道:原单选了线上,重试掉回模块默认
  等于悄悄换执行方。
- CollectChannel 用逐值比对而非 valueOf+catch 判「不可识别」:后者会把静默 catch
  总数顶过 CatchSilenceRatchetTest 上限 1057。
- 两支建单快照 golden 随 collect_channel 键重建(只多出 collectChannel=null)。
This commit is contained in:
2026-10-31 12:33:09 +08:00
parent 7459177bb4
commit 7469c710d7
25 changed files with 400 additions and 131 deletions
@@ -3,21 +3,17 @@ package com.nanri.aiimage.config;
import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
import java.util.LinkedHashMap;
import java.util.Locale;
import java.util.Map;
/**
* 采集执行方路由:哪些模块优先交给本地客户端、多久没人领才由 Linux 兜底。
* 采集执行路由的**兜底窗口**配置(2026-10-31 起只剩这一件事)。
*
* <p>2026-10-29 产品口径:外观专利(APPEARANCE_PATENT)与相似ASIN(SIMILAR_ASIN)默认
* 「本地采集」。本地优先不等于只认本地——页面推了没人领时,PENDING 超过
* {@code linux-fallback-minutes} 就交 Linux 后台认领,否则本地机器全关时任务会无限排队
* (PENDING 已不再按时间判死)。
* <p>「这一单交给本机客户端还是交给 Linux/外机 Windows」已经下沉为任务级字段
* {@code biz_file_task.collect_channel}(V183,界面单选框,默认本机),不再由本类的全局
* 开关决定;原先的 {@code local-enabled} 一台服务器一个值,把同机上所有账号捆成同一个
* 执行方,本地机器开着的用户被迫走线上,反之亦然。
*
* <p><b>未登记在 {@code local-enabled} 里的模块一律按「非本地」处理</b>,保持它们原有的
* 内部认领等待窗口({@code internal-min-pending-minutes})。默认值刻意不是 true:
* 开关只对点名的模块生效,新模块不会被悄悄卷进本地优先。
* <p>本类保留的窗口管的是另一件事:通道选了 LOCAL、但那台机器当天没开,任务会一直停在
* PENDING(PENDING 已不再按时间判死)。超过 {@code linux-fallback-minutes} 还没被本地领走,
* 就允许 Linux 接管,避免无限排队。
*/
@Data
@ConfigurationProperties(prefix = "aiimage.collect-routing")
@@ -29,19 +25,9 @@ public class CollectRoutingProperties {
/** 相似ASIN(货源查询)模块名。 */
public static final String MODULE_SIMILAR_ASIN = "SIMILAR_ASIN";
/** 模块 → 是否本地采集;键为大写模块名。 */
private Map<String, Boolean> localEnabled = new LinkedHashMap<>();
/** 本地采集模块在 PENDING 超过多少分钟后允许 Linux 兜底认领。 */
/** LOCAL 通道的任务在 PENDING 超过多少分钟后允许 Linux 兜底认领。 */
private long linuxFallbackMinutes = 30L;
public boolean isLocal(String moduleType) {
if (moduleType == null || moduleType.isBlank()) {
return false;
}
return Boolean.TRUE.equals(localEnabled.get(moduleType.trim().toUpperCase(Locale.ROOT)));
}
/** 兜底窗口下限 1 分钟:配 0/负数等于关掉本地优先,不允许静默变成「Linux 立刻抢」。 */
public long safeLinuxFallbackMinutes() {
return Math.max(1L, linuxFallbackMinutes);