문제: verifyModuleDependencyPurity는 순수 모듈(application-*, domain-core,
shared-contract)의 compile·runtime·test classpath만 풀어 봤다. test classpath는
testFixturesImplementation을 거쳐 보지만 testFixturesCompileOnly는 보지 않는다. 그래서
공유 fixtures에 Spring을 compileOnly로 두면 순수성 검사를 통과했다. testFixtures를 쓰는
순수 leaf 다섯 곳에 같은 구멍이 있었다.
고친 것: java-test-fixtures를 쓴 순수 모듈은 testFixturesCompileClasspath·
testFixturesRuntimeClasspath도 같은 금지 group으로 본다. 지금 다섯 leaf의 fixtures에는
금지 group이 없어 기존 빌드는 그대로 통과한다(lockfile 대조).
검증: desktop, 기준 4ca61cd9 + 새 functional 시험만 → testFixturesCompileOnly Spring
케이스가 빌드 통과로 실패(RED). 고친 뒤 -p build-logic test 통과(다음 커밋의 GREEN
실행에 포함).
Refs: RR9-04-47
build-logic
이 저장소의 Gradle 규약을 담은 included build다: 아키텍처 핵심, 모든 leaf가 적용하는 규약, 시험 lane 장치 하나. capability 하나에 대한 검사(알림, Mongo, 메시징, GraphQL, JPA)는 여기 없다 — 그것은 그 capability를 가진 leaf의 시험이고, 그 시험이 읽는 파일은 그 시험 태스크의 입력으로 선언한다.
여기 있는 것
| 플러그인 | 가지는 것 |
|---|---|
ca.architecture-registry (settings) |
프로젝트 포함, 디렉터리 대응, 다른 모든 읽는 쪽이 같이 쓰는 파싱된 registry |
ca.architecture |
verifyCleanArchitectureDependencies(모듈별 방향), verifyApplicationCoreDependencyPurity(domain-core, shared-contract, application-*), verifyNoIgnoredSourcePackages, architectureCheck |
ca.java-conventions |
Java toolchain·컴파일러 기준, 의존성 잠금, Mockito 시험 agent, leaf별 mainCheck lifecycle, leaf 버전(릴리스 버전만)과 sourceRevision(JavaConventionsPlugin.sourceRevision. 루트 verifyReleaseProvenance가 검사하는 것도 이것이다) |
ca.quality-conventions |
Java leaf가 같이 쓰는 Spotless, Checkstyle, Error Prone, SpotBugs·FindSecBugs 배선 |
ca.java-library / ca.spring-library / ca.spring-config |
평범한 라이브러리와 Spring 라이브러리를 위한 Java·품질 규약의 leaf 단위 조합 |
ca.platform-module |
플랫폼 성격의 Java 라이브러리 leaf(지금 adapter:outbound:httpclient)가 무엇인가: java-library. 이 규약을 쓰던 메시징·gRPC 플랫폼은 2026-11-08에 별도 repo messaging-library·grpc-library로 옮겼다(gRPC BOM 규약 ca.grpc-platform-module도 함께) |
ca.strict-test-lane |
「이름 댄 시험이 돌았고 건너뛴 것이 없다」를 보는 유일한 장치: tag·이름·자기 source set으로 고른 Test lane이 아무것도 실행하지 않거나, requires 클래스를 빠뜨리거나, (rejectSkipped이면) 무엇이든 건너뛰면 실패한다. performance() lane은 언제나 건너뛰기를 거절하고 performance.assertions.enabled=true로 돈다. 빌드(-P, GRADLE_OPTS)나 lane이 다른 값을 넣으면 시험이 돌기 전에 실패한다. mainStage()는 tag로 고른 lane을 test에서 빼 leaf의 mainCheck로 옮긴다. explicitOnly(reason)는 바깥 입력이 필요한 lane을 모든 묶음 태스크에서 빼고, 묶음 태스크가 그 이유를 출력한다. 시험 source set을 더 두려면 leaf에 Gradle jvm-test-suite suite로 선언한다(testing { suites { … } }). suite 이름을 딴 lane은 그 suite 자신의 Test 태스크를 엄격하게 만들고, ca.java-conventions는 모든 suite에 BOM의 JUnit을 준다 |
ca.strict-lane-stages (주 빌드의 루트) |
lane 장치의 나머지 절반: verifyStrictLaneStages --dry-run은 그 빌드의 explicitOnly가 아닌 strict lane이 strictLaneStages에 선언한 단계 태스크 어느 것의 계획에도 없으면 실패한다(계획은 Gradle 자신의 것). 단계마다 그것을 돌리는 workflow job(파일·이벤트·job·옵션·조건)도 선언하고, 그 job이 정해진 한 줄 모양인지 고정 문자열로 본다(build-logic/AGENTS.md 「단계 job의 모양」). 2026-11-08까지 이 자리에 workflow YAML과 bash를 해석하던 판독기(WorkflowGradleInvocations·ShellScript·TaskSelectors)가 있었고, workflow를 셋으로 접으면서 지웠다 |
ca.redis-topology-lane |
main.yml의 nightly redis-topology job(scripts/ci/redis-topology.sh)이 돌리는 Redis topology lane(모드 고르기, -P 속성 검증, 모드별 필수 클래스) |
ca.api-surface |
읽기 전용 공개 API surface 검증과 따로 둔 갱신 태스크. leaf의 check에 배선한다(소유자 결정 20). 다른 leaf의 import를 리뷰한 adopter 부분집합(adopterBaseline)에 묶을 수도 있다 |
ca.config-contract |
app-bootstrap의 verifyEnvKeys(지운 build-tools included build에서 옮겼다. 소유자 결정 4가 그 태스크를 app-bootstrap에 둔다) |
ca.bootrun-dotenv |
bootRun의 .env |
플러그인이 아니라 평범한 클래스로 둔 것. settings와 project는 플러그인을 서로 다른 방식으로 읽어 들이고, 각각을 부르는 쪽이 둘 이상이기 때문이다:
| 클래스 | 가지는 것 |
|---|---|
dev.caskeleton.buildlogic.ModuleRegistry |
gradle/modules.json을 읽고 검증하기 |
dev.caskeleton.buildlogic.RequiredTestExecution |
「이 빌드가 이름을 댄 시험은 실제로 돌았어야 한다」는 단 하나의 판정 |
dev.caskeleton.buildlogic.JavaPublicTypes |
공개 최상위 타입. 정규식으로 맞추지 않고 javac로 파싱한다 |
JMH benchmark는 커뮤니티 플러그인 me.champeau.jmh를 쓴다. ca.quality-conventions는 benchmark와
생성된 코드에서 Error Prone, -Werror, SpotBugs, Checkstyle을 끄기만 한다.
지운 것과 그것을 대신하는 것
| 지운 것 | 대신하는 것 |
|---|---|
ca.runtime-membership |
방향 게이트: allowed_dependencies 밖의 것은 조립 루트에 닿을 수 없다 |
ca.evidence, ca.conditional-transport-qualification, ca.strict-qualification |
requires + rejectSkipped를 쓴 strictTestLanes lane. 루트 conditionalTransportQualification과 verifyMessagingContracts는 그 lane을 묶기만 한다 |
ca.dependency-policy |
leaf 안의 componentSelection 거절 규칙(notification: YAML dataformat, messaging: Jackson 2와 모든 YAML 모듈)과 registry(web-advanced는 허용된 소비자가 없다). rejectAll() 제약도 써 봤지만 실패하지 않는다: Spring의 의존성 관리가 거절한 버전을 덮어쓴다 |
ca.graphql-platform |
GraphQL leaf의 graphqlStableTest lane과 GraphQlProductionClassesTest |
ca.jpa-test-lanes |
adapter/outbound/persistence-jpa/build.gradle에 선언한 lane |
ca.test-jvm-agents, quarantineTest |
ca.java-conventions. quarantine 묶음에는 시험이 없었다 |
ca.jmh-benchmarks |
me.champeau.jmh |
build-tools ca.jpa-evidence, ca.jpa-qualification(+ junit 증거 읽기) |
소유자 결정 4: persistence-jpa JpaReadinessRegistryTest, 인용한 시나리오를 모두 요구하고 건너뛰기를 거절하는 readiness lane, src/adapter/outbound/persistence-jpa/release/release-registry.json을 묶는 leaf의 jpaReleaseQualification |
build-tools ca.config-contract |
바꾸지 않고 여기로 옮겼다 |
ca.public-path-snapshot |
app-bootstrap PublicPathSnapshotTest(lane publicPathSnapshotTest, 루트 별칭 verifyPublicPathSnapshot) |
ca.archive-hygiene |
치울 것이 없다: leaf 버전이 더는 revision을 싣지 않으니 낡은 추적 가능 jar가 생기지 않는다 |
ca.developer-bootstrap |
scripts/bootstrap-local.sh |
JpaAdopterApiSurfaceTest(persistence-jpa의 정규식 import 검사) |
ca.api-surface adopterBaseline |
규약 시험하기
./gradlew -p build-logic test --console=plain
lane과 registry 규약은 플러그인 소스를 읽는 대신 Gradle TestKit으로 실제 빌드에 대고 시험한다.
중요한 성질 — 아무것도 찾지 못한 lane은 실패한다, lane은 클래스와 lane 정책(rejectSkipped,
requires, tag, category)이 바뀌지 않았고 서버를 띄우지 않을 때만 결과를 다시 쓴다, 잘못된 registry는
어떤 프로젝트도 포함하기 전에 거절된다 — 이 스크립트의 글이 아니라 런타임 동작이기 때문이다. 그중
시험 둘은 Gradle 문서를 그대로 읽으면 틀렸기 때문에 있다: tag 필터가 아무것도 맞추지 못할 때
failOnNoDiscoveredTests가 동작하지 않고, 이름을 댄 시험 중 일부만 없을 때
failOnNoMatchingTests가 동작하지 않는다.