96800a2c88
共享内核下沉(跨模块共享的"身份/组织/安全"类型进 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 全绿。
126 lines
6.0 KiB
Java
126 lines
6.0 KiB
Java
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;
|
||
}
|
||
}
|
||
}
|