ArchUnit으로 코드 구조 규칙을 테스트로 강제하기

class ArchitectureTest {
 
    companion object {
        // import는 한 번만 한다. 테스트 메서드마다 import하면 규칙 수만큼 파싱이 반복된다.
        // 테스트 클래스는 제외한다. 예를 들어 IntegrationTest 같은 기반 클래스에는
        // 애플리케이션 코드와 다른 어노테이션이 붙을 수 있다.
        private val classes: JavaClasses by lazy {
            ClassFileImporter()
                .withImportOption(ImportOption.DoNotIncludeTests())
                .importPackages("dev.joyson.aiworkbench")
        }
    }
 
    @Test
    fun `domain은 infrastructure를 모른다`() {
        noClasses().that().resideInAPackage("..domain..")
            .should().dependOnClassesThat().resideInAPackage("..infrastructure..")
            .because("domain은 port를 선언하고 구현은 infrastructure가 한다")
            .check(classes)
    }
 
    @Test
    fun `엔티티는 모듈 경계를 넘지 않는다`() {
        noClasses().that().areAnnotatedWith(Entity::class.java)
            .should().resideInAPackage("dev.joyson.aiworkbench.*")
            .because("루트는 공개 API다. 엔티티는 서브패키지로 옮기고 경계에는 값을 둔다")
            .check(classes)
    }
}

val haveJsonValue = object : ArchCondition<JavaClass>("@JsonValue 게터를 가진다") {
    override fun check(item: JavaClass, events: ConditionEvents) {
        if (item.methods.none { it.isAnnotatedWith(JsonValue::class.java) }) {
            events.add(
                SimpleConditionEvent.violated(
                    item,
                    "${item.name}에 @JsonValue가 없다"
                )
            )
        }
    }
}

@Test
fun `Instant now 직접 호출 - 기존 위반은 동결하고 새 위반만 막는다`() {
    // 기준선 저장 위치와, 없으면 새로 만들어도 된다는 허락
    ArchConfiguration.get().apply {
        setProperty("freeze.store.default.path", "archunit_store")
        setProperty("freeze.store.default.allowStoreCreation", "true")
    }
 
    // 컴파일된 main 클래스를 읽어 그래프를 만든다. 테스트 클래스는 제외한다.
    val imported = ClassFileImporter()
        .withImportOption(ImportOption.DoNotIncludeTests())
        .importPackages("dev.joyson.aiworkbench")
 
    // 어떤 클래스도 Instant.now()를 직접 부르지 않는다.
    val rule = noClasses().should().callMethod(Instant::class.java, "now")
        .because("time must be injected through a Clock")
 
    // 기존 위반은 동결하고, 새 위반이 추가되면 실패한다.
    FreezingArchRule.freeze(rule).check(imported)
}

stored.rules
99e609b1-0c3c-4241-ba95-1daa7beb119b

#
#Sat Oct 03 16:06:20 KST 2026
no\ classes\ should\ call\ method\ Instant.now(),\ because\ time\ must\ be\ injected\ through\ a\ Clock=99e609b1-0c3c-4241-ba95-1daa7beb119b

Rule 'classes should not call Instant.now() directly' was violated (13 times):
GeneratedFile · 생성자 기본값 → Instant.now() (GeneratedFile.kt:77)
GenerationJob · touch() → Instant.now() (GenerationJob.kt:122)
GenerationJob · 생성자 기본값 → Instant.now() (GenerationJob.kt:98)
GenerationJobTask · 생성자 기본값 → Instant.now() (GenerationJobTask.kt:72)
ProviderCall · 생성자 기본값 → Instant.now() (ProviderCall.kt:128)