Files
crawler-plugin/backend-java/src/test/java/com/nanri/aiimage/ArchitectureBoundaryTest.java
T
huangzd1997 96800a2c88 refactor(boundary): 跨模块循环依赖清零(8 对 → 0),task→业务 依赖归零
共享内核下沉(跨模块共享的"身份/组织/安全"类型进 common)
- AdminUserEntity/AdminUserMapper、ShopManageGroupEntity/ShopManageGroupMapper → common
- AdminAuthSupport(33 文件 17 模块引用)、JwtService、AuthProperties、DeviceSessionPolicy
  → common/security(原先放在 admin/auth 里,任何模块用一次就多一条跨模块边)

端口化(消费方声明接口、数据方实现)
- task/spi:ResultFileJobHandler 新增 resolveResultFileUrl 钩子(BRAND 特例从 Worker 收回);
  Worker 改为调用 handler.onSuccess(该钩子历史上从未被调用,withdraw 的收尾靠 Worker 里的
  WITHDRAW 特判硬编码——现两者都归位,task 侧不再 import withdraw/brand)
- admin/spi/UserSecretCleanupPort(删除用户级联清理密钥)、notification/spi/ProxyBalancePort
  (代理余额探测)、shopdatacrawl/spi/ManagedShopNamesPort(可管店铺名)
- shopkey/spi/GroupDeletionGuardPort:分组删除守卫改由各业务模块实现(invalidasin/dedupe 两个实现),
  shopkey 不再直连它们的 Mapper

棘轮与量化(2026-09-14 实测)
- ArchitectureBoundaryTest:task→业务 119 → **0**(基线钉死为 0,新增跨模块动作必须走 task/spi)
- 跨模块 import 行数 650 → 605;双向依赖对 8 → **0**(usersecret/permission/shopkey 三向环、
  task↔withdraw、task↔brand、admin↔permission、admin↔usersecret、dedup↔shopkey、
  invalidasin↔shopkey、notification↔usersecret、shopdatacrawl↔shopduplicatecheck 全部拆解)

测试同步:接口契约 8→9、品牌 Handler 钩子契约、worker 的 10 个测试构造实参、通知/管理测试端口化。
mvn test 2881 全绿。
2026-09-14 10:05:04 +08:00

126 lines
6.0 KiB
Java
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package com.nanri.aiimage;
import com.tngtech.archunit.core.domain.JavaClasses;
import com.tngtech.archunit.core.importer.ClassFileImporter;
import com.tngtech.archunit.core.importer.ImportOption;
import org.junit.jupiter.api.Test;
import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
import static org.junit.jupiter.api.Assertions.assertTrue;
/**
* task-210/211/212:模块边界 ArchUnit 规则(plan 13)。
*
* 已通过(零违规):任何 Controller 不得直接访问 Mapper 或外部 Client(211)。
* 债务防恶化(210/212,探针 2026-09-05):task 模块经 *ResultFileJobHandler 等依赖具体业务
* Service/Mapper 曾达 128 处、modules 切片存在 collectdata→dedupe→task 等环;Handler 已迁回
* 业务模块(212 大幅收敛)。整体模块切片无环依赖进一步 SPI 化(deletebrand 跨模块扫描/心跳等),
* 尚未达成,故本文件冻结"存量不新增"上限。
*/
class ArchitectureBoundaryTest {
/**
* task → 业务模块的依赖存量棘轮(只允许不增)。
* <p>
* 84 是 task-212(Handler 迁回业务模块)后的存量;此后 TaskHeartbeatService 的跨模块心跳、
* StaleTaskRepairService 的陈旧扫描、ModuleHistoryCleanupService 的历史清理持续增加模块接入
* (imagevideo 等),存量涨到 110 而未同步更新,导致棘轮长期失效(一直红灯=无人看)。
* 这里对齐到当前实测值以恢复告警能力。
* <p>
* <b>若你在 task 模块新增了对业务模块的依赖,本测试会失败——这是预期行为,请走 Handler SPI,
* 不要直接上调此常量。</b>若确需上调,请同时写明是哪些类、为什么无法 SPI 化。
* <p>
* 2026-09-14:上一轮把常量写成 110 但未跑测试核对,实际存量是 119(棘轮仍是红灯)。
* 本次以实测值 119 为准恢复告警能力;经 git diff 核验,当日的 task 模块改动
* (引用计数按 task 收敛、快照 upsert 缓存、心跳条件更新、锁续期重试等)未新增任何业务依赖。
*/
// 2026-09-14 心跳/陈旧修复/历史清理/结果文件 URL 全部 SPI 化后,task → 业务 依赖实测为 0。
// 基线钉死为 0:task 只允许依赖 task.spi 下的接口(业务模块各自实现),不允许回升。
private static final int TASK_TO_BUSINESS_BASELINE = 0;
private static volatile JavaClasses cached;
private static JavaClasses app() {
if (cached == null) {
cached = new ClassFileImporter()
.withImportOption(ImportOption.Predefined.DO_NOT_INCLUDE_TESTS)
.importPackages("com.nanri.aiimage.modules");
}
return cached;
}
@Test
void controllersDoNotAccessMapper() {
noClasses().that().resideInAPackage("..controller..")
.should().dependOnClassesThat().resideInAPackage("..mapper..")
.because("Controller 只经 Service 访问 Mapper(单向分层)")
.check(app());
}
@Test
void controllersDoNotDependOnExternalClient() {
noClasses().that().resideInAPackage("..controller..")
.should().dependOnClassesThat().resideInAPackage("..client..")
.because("外部 Client 细节由 Service 层收敛,Controller 不应感知")
.check(app());
}
@Test
void boundaryRulesCoverAllControllers() {
long controllers = app().stream()
.filter(c -> c.getPackageName().endsWith(".controller")).count();
assertTrue(controllers >= 10, "应覆盖全部 Controller,实际 " + controllers);
}
@Test
void taskToBusinessDependencyDoesNotGrow() {
// 冻结存量:Handler 迁移后 task→业务 依赖已大幅收敛;不允许继续增长
int violations = countViolations(taskRule());
assertTrue(violations <= TASK_TO_BUSINESS_BASELINE,
"task→业务 依赖必须为 0(当前 " + violations + ");跨模块动作 = 在 task/spi 加接口 + 业务模块实现");
assertTrue(violations >= 0,
"task→业务 依赖不得超过基线 " + TASK_TO_BUSINESS_BASELINE + ",当前 " + violations
+ ";新增依赖走 Handler SPI 或先消除存量");
}
@Test
void ruleFailuresCarryClearReason() {
// 规则附 because 说明,失败信息可定位
assertTrue(taskRule().getDescription().contains("no classes that reside in a package"),
"规则描述应可读");
}
@Test
void spiHandlersAreTheSanctionedBridge() {
JavaClasses classes = app();
long handlers = classes.stream()
.filter(c -> c.getSimpleName().endsWith("ResultFileJobHandler"))
.count();
assertTrue(handlers >= 13, "Handler SPI 实现应在各业务模块注册,实际 " + handlers);
}
private static com.tngtech.archunit.lang.ArchRule taskRule() {
return noClasses().that().resideInAPackage("..modules.task..")
.should().dependOnClassesThat().resideInAPackage(
"..modules.(similarasin|appearancepatent|deletebrand|publish|brand|collectdata|"
+ "shopdatacrawl|imagevideo|shopmatch|productrisk|queryasin|withdraw|patroldelete)..")
.because("公共 task 模块不应依赖具体业务模块");
}
private static int countViolations(com.tngtech.archunit.lang.ArchRule rule) {
try {
rule.check(app());
return 0;
} catch (AssertionError e) {
String msg = e.getMessage();
long count = msg.lines()
.filter(l -> l.trim().startsWith("Constructor <")
|| l.trim().startsWith("Field <")
|| l.trim().startsWith("Method <")
|| l.trim().startsWith("Class <"))
.count();
return (int) count;
}
}
}