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 → 业务模块的依赖存量棘轮(只允许不增)。 *

* 84 是 task-212(Handler 迁回业务模块)后的存量;此后 TaskHeartbeatService 的跨模块心跳、 * StaleTaskRepairService 的陈旧扫描、ModuleHistoryCleanupService 的历史清理持续增加模块接入 * (imagevideo 等),存量涨到 110 而未同步更新,导致棘轮长期失效(一直红灯=无人看)。 * 这里对齐到当前实测值以恢复告警能力。 *

* 若你在 task 模块新增了对业务模块的依赖,本测试会失败——这是预期行为,请走 Handler SPI, * 不要直接上调此常量。若确需上调,请同时写明是哪些类、为什么无法 SPI 化。 *

* 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; } } }