diff --git a/platform-app/src/test/java/com/eip4/platform/app/ArchitectureRulesTest.java b/platform-app/src/test/java/com/eip4/platform/app/ArchitectureRulesTest.java index e2f8961..7514705 100644 --- a/platform-app/src/test/java/com/eip4/platform/app/ArchitectureRulesTest.java +++ b/platform-app/src/test/java/com/eip4/platform/app/ArchitectureRulesTest.java @@ -1,21 +1,112 @@ package com.eip4.platform.app; +import com.tngtech.archunit.base.DescribedPredicate; +import com.tngtech.archunit.core.domain.JavaClass; +import com.tngtech.archunit.core.importer.ImportOption; import com.tngtech.archunit.junit.AnalyzeClasses; import com.tngtech.archunit.junit.ArchTest; import com.tngtech.archunit.lang.ArchRule; +import org.springframework.jdbc.core.JdbcTemplate; +import org.springframework.web.bind.annotation.RestController; +import java.util.Set; + +import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.classes; import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses; +import static com.tngtech.archunit.library.dependencies.SlicesRuleDefinition.slices; /** - * 架构纪律(《架构设计》(docs/架构设计.md)第一节,ArchUnit 固化): - * com.eip4.* 可调 com.dsasp.*,反向禁止——保真层不得感知现代层。 + * 架构纪律(ArchUnit 编译期固化)。规则分两类: + * + *
强制规则(hard,当前已绿):违反即红,守护双层制方向、库模块独立性、模块无环。 + * + *
棘轮规则(ratchet,存量债务基线化):把现存技术债以「已知债务清单」白名单化, + * 只挡新增违规、不强拆旧代码。清单 = 待偿债务台账,清理一个就从清单删一个, + * 直到清单清空即可把该规则升级为强制规则(删去白名单参数)。 + * + *
背景、严重度与偿还路线见 {@code docs/项目进度与路线-总览-2026-06-21.md} §10 + * (控制器 SQL 收口=A4 / 控制器解耦=A3 / Poc 端点移除=§10.1 P0)。 + * + *
原则提醒:架构允许 {@code com.eip4.* → com.dsasp.*}(现代层是保真层的薄门面),
+ * 故「控制器调用保真层引擎服务」不是违规,本测试不拦;真正的坏味道是控制器直拼原始 SQL。
*/
-@AnalyzeClasses(packages = {"com.dsasp", "com.eip4"})
+@AnalyzeClasses(packages = {"com.dsasp", "com.eip4"}, importOptions = ImportOption.DoNotIncludeTests.class)
class ArchitectureRulesTest {
+ // ───────────────────────── 强制规则(hard,当前已绿) ─────────────────────────
+
@ArchTest
static final ArchRule 保真层禁止依赖现代层 =
noClasses().that().resideInAPackage("com.dsasp..")
.should().dependOnClassesThat().resideInAPackage("com.eip4..")
.because("双层制:移植的旧代码不重写、不感知新代码,保证与 framework 源码 diff 最小");
+
+ @ArchTest
+ static final ArchRule 库模块不得依赖应用编排层 =
+ noClasses().that().resideInAnyPackage("com.eip4.platform.converter..", "com.eip4.platform.parity..")
+ .should().dependOnClassesThat().resideInAnyPackage(
+ "com.eip4.platform.metadata..",
+ "com.eip4.platform.ai..",
+ "com.eip4.platform.flowgateway..",
+ "com.eip4.platform.auth..",
+ "com.eip4.platform.app..")
+ .because("转换器/对拍是可独立 CLI 跑批的库,不得反向依赖应用编排层(保持可独立运行)");
+
+ @ArchTest
+ static final ArchRule 模块间无循环依赖 =
+ slices().matching("com.eip4.platform.(*)..").should().beFreeOfCycles()
+ .because("模块化单体:模块间依赖必须是 DAG,出现环说明模块边界被破坏");
+
+ // ───────────────────────── 棘轮规则(ratchet,存量债务基线化) ─────────────────────────
+
+ /**
+ * 控制器直接持有 JdbcTemplate 拼原始 SQL = 现代层退化成第二个「SQL 散落层」的根源(总览 §10 A4)。
+ * 偿还方向:把 SQL 收口到 Service/Repository 层;清理一个就从本清单删一个。
+ */
+ private static final Set