아키텍처 적합도 함수로 프로젝트 구조 및 코드의 역할과 책임의 강제성 부여하기

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 static com.tngtech.archunit.core.domain.JavaCall.Predicates.target;
import static com.tngtech.archunit.core.domain.JavaClass.Predicates.resideInAPackage;
import static com.tngtech.archunit.core.domain.properties.HasName.Predicates.name;
import static com.tngtech.archunit.core.domain.properties.HasOwner.Predicates.With.owner;
import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
 
    /**
     *     1. 도메인 빌더 접근제어
     *         - domain계층과 Driving adapter 하위 디렉토리인 mapper를 제외한 다른 패키지에서는
     *         도메인 패키지에 속한 클래스의 builder() 메서드를 호출해서는 안 되는 규칙을 가집니다.
     * 
     *     2. 거짓 양성 방어: allowEmptyShould(false)
     *         - builder 메소드가 프로젝트에서 완전히 제거되어 테스트가 무조건 성공하는 현상을 방지합니다.
     */
@AnalyzeClasses(
        // ArchUnit이 바이트코드를 분석할 루트 패키지를 지정합니다. 이 패키지 하위에 있는 모든 클래스가 분석 대상이 됩니다.
        packages = "io.hirecore.hirecorememberserver",
        // 애플리케이션의 프로덕션 코드(Main)만 검증 대상으로 삼습니다. 테스트 코드(Test)는 검증에서 제외하여 테스트 작성의 자유도를 보장하고 검증 속도를 높입니다.
        importOptions = ImportOption.DoNotIncludeTests.class
)
class DomainRuleArchTest {
 
    // 2. 아키텍처 규칙 정의: 이 필드가 검증해야 할 하나의 '아키텍처 규칙(Rule)'임을 나타냅니다.
    @ArchTest
    static final ArchRule builder_ShouldOnlyBeCalledByDomainOrPersistence =
            // [검증 시작] "어떤 클래스도 ~해서는 안 된다"라는 부정형 검증의 시작점입니다.
            noClasses()
                    // [필터링] 도메인 계층과 영속성 어댑터 계층 '외부'에 위치한 클래스들만 타겟팅합니다.
                    .that().resideOutsideOfPackages(
                            "io.hirecore.hirecorememberserver.modules.*.domain..",
                            "io.hirecore.hirecorememberserver.modules.*.adapter.out.persistence.*.mapper.."
                    )
                    // [행위 검증] 위에서 타겟팅된 외부 클래스들은 아래 조건을 만족하는 메서드를 호출해서는 안 됩니다.
                    .should().callMethodWhere(
                            // 호출 대상 메서드의 이름이 "builder" 이고,
                            target(name("builder"))
                                    // 그 메서드를 소유한(owner) 클래스가 "io.hirecore.hirecorememberserver.modules.*.domain.." 패키지 내부에 위치할 경우.
                                    // 즉, "도메인 객체의 builder() 메서드 호출을 금지한다"는 의미입니다.
                                    .and(target(owner(resideInAPackage("io.hirecore.hirecorememberserver.modules.*.domain.."))))
                    )
                    // [안전 장치] 향후 리팩토링으로 'builder' 메서드가 제거되거나 패키지 구조가 바뀌어 검사할 대상이 아예 없어졌을 때, 
                    // 테스트가 무조건 통과(Pass)해버리는 긍정 오류(False Positive)를 방지하기 위해 강제로 테스트를 실패시킵니다.
                    .allowEmptyShould(false)
                    // [실패 사유] 테스트가 실패했을 때 동료 개발자가 의도를 바로 파악할 수 있도록 출력할 메시지입니다.
                    .because(
                            "도메인 객체의 캡슐화를 훼손하지 않도록, Service 등 외부 계층에서는 빌더 대신 비즈니스 의미가 부여된 정적 팩토리 메서드를 사용해야 합니다."
                    );
}

@AnalyzeClasses(
        packages = "io.hirecore.hirecorememberserver",
        importOptions = ImportOption.DoNotIncludeTests.class
)
class HexagonalArchitectureArchTest {
 
    @ArchTest
    static final ArchRule layer_dependencies_are_respected =
            layeredArchitecture()
                    .consideringAllDependencies()
                    // 1. 계층 정의
                    .layer("Adapter").definedBy("io.hirecore.hirecorememberserver.modules.*.adapter..")
                    .layer("Application").definedBy("io.hirecore.hirecorememberserver.modules.*.application..")
                    .layer("Domain").definedBy("io.hirecore.hirecorememberserver.modules.*.domain..")
 
                    // 2. 의존성 규칙 정의 (접근 허용 주체만 명시)
 
                    // [Domain]은 가장 안쪽에 있으므로 Application과 Adapter만 접근 가능합니다.
                    // (common 패키지 등 외부 계층이 Domain을 직접 호출하는 것을 막습니다)
                    .whereLayer("Domain").mayOnlyBeAccessedByLayers("Application", "Adapter")
 
                    // [Application]은 오직 Adapter에서만 진입할 수 있습니다.
                    // (이 규칙 덕분에 Domain 계층이 Application을 역방향으로 참조하는 것이 자동 차단됩니다)
                    .whereLayer("Application").mayOnlyBeAccessedByLayers("Adapter")
 
                    // [Adapter]는 최외곽이므로 그 어떤 내부 계층도 Adapter에 접근할 수 없습니다.
                    // (이 규칙 덕분에 Application이나 Domain이 Adapter를 참조하는 DIP 위반이 완벽히 차단됩니다)
                    .whereLayer("Adapter").mayNotBeAccessedByAnyLayer()
 
                    .because("헥사고날 아키텍처의 의존성 역전 원칙(DIP)에 따라 내부 계층은 외부 계층을 알 수 없어야 합니다.");
}

@AnalyzeClasses(
        packages = "io.hirecore.hirecorememberserver",
        importOptions = ImportOption.DoNotIncludeTests.class
)
class ModuleBoundaryArchTest {
    @ArchTest
    static final ArchRule root_common_should_not_depend_on_modules =
            noClasses()
                    .that().resideInAPackage("io.hirecore.hirecorememberserver.common..")
                    .should().dependOnClassesThat().resideInAPackage("io.hirecore.hirecorememberserver.modules..")
                    .allowEmptyShould(false)
                    .because("Common 패키지는 전역적인 공통 로직이므로 특정 비즈니스 모듈에 의존해서는 안 됩니다.");
 
    //todo: DDDArchTest로 분리하는 것이 좋을 것 같긴합니다.
    @ArchTest
    static final ArchRule modules_should_be_independent =
            SlicesRuleDefinition.slices()
                    // 동적 매칭: modules 바로 아래 디렉토리(account, profile 등)를 각각의 슬라이스로 인식
                    .matching("io.hirecore.hirecorememberserver.modules.(*)..")
                    //  .should().beFreeOfCycles()   // 순환 참조만 금지 (단방향 참조 허용)
                    .should().notDependOnEachOther() // 순환·단방향 참조 모두 금지 (완전한 모듈 격리)
                    .because("비즈니스 모듈 간의 결합도를 낮추고 독립성을 보장하기 위해 슬라이스 간 순환/직접 참조를 금지합니다.");
}