feat(phase-4): 建单凭据需求按 task type 登记进 TaskModuleRegistry(B72-01)

`/newApi` 是整包转发的透传面(客户端只搬字节),载荷里有什么凭据需求客户端猜不出来;
铁律 27 的建单闸门此前只有两处各写一枚枚举,"这一类要什么凭据"没有一处正本。本笔把它
收成表:`TaskModuleRegistry.Module` 新增 `submitSecret`(16 类逐类登记),
`requireSubmitSecret` 新增按 type 的入口,enum 形态降为包内原语——包外再想硬编一把密钥
就编译不过,只能上册表。

两处判断写死在代码里:
- **登记为空是结论,不是漏填**。外观专利/货源查询要 LLM 密钥;其余几类缺的是代理,
  而缺代理在执行侧是「直连降级」不是注定失败(铁律 27 边界 c),拦了会把现在能跑的功能
  判死——所以本笔只登记、不新增任何拦截,`enqueue_json` 那半还等"这台机器直连能不能
  采到"的实测读数(B72-01 后半欠账原样留着)。
- **空登记调到这里当场 IllegalStateException,不静默放行**。空转的闸门比没有闸门更坏,
  它让下一个人以为这条链已经防住了(门禁 1 同族)。同理 `submitSecretModuleOf` 对不在
  清单里的 type 抛错而不回落:「没登记」与「登记过=不需要」不许揉成同一个值。

判据:`TaskModuleCoverageTest` +3 例(登记表与实际问闸门的类型双向对撞/每个模块都
登记过/未知类型当场抛,源码扫描按 ConsoleWideningGuardrailTest 的 mainRoot 口径,
定位不到即抛不空扫)+`UserApiSecretServiceTest` +4 例(按 type 拒/放行不读库/
空登记抛 IllegalStateException 且不碰库/未注册抛 IllegalArgumentException)。
两处快照测试跟着改到类型形态(`anyString()` 消歧重载,摘掉不再使用的 enum 导入)。
反向验证:外观专利不登记→2 红;给 COLLECT_DATA 顺手加登记→2 红;静默放行→1 红;复原复绿。

行为对现网零变化:两个调用点问的还是同一把钥匙、同一句文案。
门禁:`mvn -o test-compile` rc=0;`mvn -o test` 整量 5274/0 失败/0 错误/19 skipped
BUILD SUCCESS(Phase 3 在册 5267+本笔 7)。
This commit is contained in:
2026-11-03 16:19:59 +08:00
parent 51401de2d5
commit b9d23d5936
8 changed files with 275 additions and 30 deletions
@@ -1,8 +1,11 @@
package com.nanri.aiimage.common.module;
import com.nanri.aiimage.modules.usersecret.support.UserSecretModule;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Map;
import java.util.Optional;
import java.util.Set;
import java.util.stream.Collectors;
@@ -16,6 +19,12 @@ import java.util.stream.Collectors;
*
* 心跳与陈旧判死两处是代码分支驱动(switch / 逐模块委派),无法纯数据派生,
* 新增模块时仍需实现对应 Handler,测试会提示缺失。
*
* 建单凭据({@code submitSecret},B72-01)同样登记在本表:「这一类任务要拿用户的哪把密钥跑」
* 的唯一出处。`/newApi` 是整包转发的透传面,客户端猜不出载荷要什么凭据,只能由服务端按 type
* 逐类登记。这里刻意区分两件事:登记了 = 建单口必须问这把;`Optional.empty()` = **登记过的结论**
* 「这一类建单时不需要用户凭据」,不是漏填——`TaskModuleCoverageTest` 把「问了闸门却没登记」与
* 「登记了却没问闸门」两个方向都钉红,空壳闸门比没闸门更坏(铁律 27 边界 c)。
*/
public final class TaskModuleRegistry {
@@ -31,28 +40,34 @@ public final class TaskModuleRegistry {
* @param selfScheduledStaleCheck 该模块的陈旧判死自带更快的调度(publish 60s / collect-data 30s),
* 刻意不并入 2 分钟一轮的巡检线——并入会显著拉长判死时延。
* 这类模块的"不在委托名单"是设计差异,不是漏接;由覆盖面测试固定。
* @param submitSecret 建单口要问的那把用户密钥;{@code Optional.empty()} 是**登记过的结论**
* "这一类不缺凭据也能跑"(例:缺代理在本机执行类是直连降级,
* 不是注定失败——铁律 27 边界 c,拦了会把现在能跑的功能判死)。
*/
public record Module(String type, String label, boolean resultFileJob, boolean ageCleanup,
boolean delegatedStaleCheck, boolean selfScheduledStaleCheck) {
boolean delegatedStaleCheck, boolean selfScheduledStaleCheck,
Optional<UserSecretModule> submitSecret) {
}
private static final List<Module> MODULES = List.of(
new Module("PUBLISH", "上架", true, false, false, true),
new Module("DEDUPE", "数据去重", false, true, false, false),
new Module("SPLIT", "数据拆分", false, true, false, false),
new Module("CONVERT", "格式转换", false, true, false, false),
new Module("DELETE_BRAND", "删除ASIN", true, true, false, false),
new Module("PRODUCT_RISK_RESOLVE", "商品风险解决", true, true, false, false),
new Module("PRICE_TRACK", "跟价", true, true, false, false),
new Module("SHOP_MATCH", "定时匹配", true, true, false, false),
new Module("PATROL_DELETE", "巡店删除", true, true, false, false),
new Module("QUERY_ASIN", "查询ASIN", true, true, false, false),
new Module("WITHDRAW", "取款", true, true, false, false),
new Module("APPEARANCE_PATENT", "外观专利检测", true, true, true, false),
new Module("SIMILAR_ASIN", "货源查询", true, true, true, false),
new Module("COLLECT_DATA", "采集数据", true, true, false, true),
new Module("SHOP_DATA_CRAWL", "店铺数据抓取", true, false, true, false),
new Module("BRAND", "品牌检测", true, false, true, false)
new Module("PUBLISH", "上架", true, false, false, true, Optional.empty()),
new Module("DEDUPE", "数据去重", false, true, false, false, Optional.empty()),
new Module("SPLIT", "数据拆分", false, true, false, false, Optional.empty()),
new Module("CONVERT", "格式转换", false, true, false, false, Optional.empty()),
new Module("DELETE_BRAND", "删除ASIN", true, true, false, false, Optional.empty()),
new Module("PRODUCT_RISK_RESOLVE", "商品风险解决", true, true, false, false, Optional.empty()),
new Module("PRICE_TRACK", "跟价", true, true, false, false, Optional.empty()),
new Module("SHOP_MATCH", "定时匹配", true, true, false, false, Optional.empty()),
new Module("PATROL_DELETE", "巡店删除", true, true, false, false, Optional.empty()),
new Module("QUERY_ASIN", "查询ASIN", true, true, false, false, Optional.empty()),
new Module("WITHDRAW", "取款", true, true, false, false, Optional.empty()),
new Module("APPEARANCE_PATENT", "外观专利检测", true, true, true, false,
Optional.of(UserSecretModule.APPEARANCE_PATENT)),
new Module("SIMILAR_ASIN", "货源查询", true, true, true, false,
Optional.of(UserSecretModule.SIMILAR_ASIN)),
new Module("COLLECT_DATA", "采集数据", true, true, false, true, Optional.empty()),
new Module("SHOP_DATA_CRAWL", "店铺数据抓取", true, false, true, false, Optional.empty()),
new Module("BRAND", "品牌检测", true, false, true, false, Optional.empty())
);
private TaskModuleRegistry() {
@@ -100,6 +115,28 @@ public final class TaskModuleRegistry {
.collect(Collectors.toUnmodifiableSet());
}
/**
* 建单口这一类任务要问的那把用户密钥(B72-01 的唯一出处)。
*
* @throws IllegalArgumentException moduleType 根本不在清单里(拼错的常量名)。
* 刻意不跟 {@link #labelOf} 一样回落原值:「没登记」与「登记过=不需要」是两件事,
* 揉成同一个空值会让调用方把漏接当成结论。
*/
public static Optional<UserSecretModule> submitSecretModuleOf(String moduleType) {
for (Module module : MODULES) {
if (module.type().equals(moduleType)) {
return module.submitSecret();
}
}
throw new IllegalArgumentException("模块不在清单里: " + moduleType);
}
/** 登记了建单凭据的模块(覆盖面测试用它对撞「实际在建单口问闸门的类型」)。 */
public static Set<String> submitSecretModuleTypes() {
return MODULES.stream().filter(module -> module.submitSecret().isPresent())
.map(Module::type).collect(Collectors.toUnmodifiableSet());
}
public static String labelOf(String moduleType) {
for (Module module : MODULES) {
if (module.type().equals(moduleType)) {