# gradle/ — 빌드가 고정하는 것 이 폴더에는 빌드가 버전과 목록을 고정하는 파일만 둔다. Gradle 루트(저장소 루트)의 표준 자리다. | 파일 | 고정하는 것 | 읽는 곳 | | --- | --- | --- | | `wrapper/` | Gradle 버전과 배포본 해시 | `gradlew` | | `libs.versions.toml` | 프로젝트 밖 의존: 라이브러리·플러그인 버전 | Gradle 버전 카탈로그(`libs.*`), `build-logic/settings.gradle` | | `modules.json` | 프로젝트 안 의존: leaf 목록(id, Gradle 경로, 폴더)과 허용 edge | settings 플러그인 `ca.architecture-registry`, 방향 검사, `scripts/` 검사 | | `container-images.properties` | 시험이 띄우는 컨테이너 이미지(digest 고정) | `ca.java-conventions`가 시험 JVM에 `ca.test.image.*`로 넘긴다 | registry와 이미지 목록은 버전 카탈로그와 같은 종류라 여기에 둔다: 카탈로그가 밖에서 받는 것을, registry가 안에서 서로 쓰는 것을, 이미지 목록이 시험이 띄우는 것을 고정한다. `config/`는 코드 검사 도구 설정(checkstyle, spotbugs)만 둔다. > 이력: 2026-11-11 저장소 재배치 전에는 registry가 `src/config/architecture/`, 이미지 목록이 `src/config/testing/`에 > 있었다(`docs/upgrade/2026-11-relayout.md`). ## 아키텍처 모듈 registry(`modules.json`) Gradle 경로와 폴더는 다르다. `:app-bootstrap`은 `src/bootstrap/app`, `:application-core`는 `src/application/core`, `:composition:outbox-relay`는 `src/bootstrap/outbox-relay`에 있다. 폴더를 찾을 때는 `source_path`를, 명령을 쓸 때는 `gradle_path`를 읽는다. `modules.json`은 Gradle 프로젝트의 정체(id, Gradle 경로, 소스 경로)와 각 leaf가 볼 수 있는 운영 프로젝트 edge를 정확히 적는다. 빈 `allowed_dependencies` 목록에도 뜻이 있다: 그 leaf가 일부러 다른 프로젝트에 기대지 않는다는 뜻이지, registry 항목을 덜 채웠다는 뜻이 아니다. `domain-core`, `shared-contract`가 그 예다. 빈 목록은 분명한 경계이고, 실제 프로젝트 edge를 들여와 리뷰하기 전까지 비어 있어야 한다. 반대로 목록에 적힌 edge는 빌드가 실제로 쓰는 것과 맞아야 한다. 예를 들어 `adapter-outbound-persistence-mongo`의 목록은 `["application-core", "shared-contract"]`이고 `MongoRegistryPermissionParityTest`가 두 방향을 모두 본다. 런타임 조립 구성원은 빌드 로직이 해석된 runtime classpath에서 얻는다. 이 registry에 모듈마다 칸으로 다시 적지 않는다. ### 별도 repo 라이브러리: `library_groups`와 `allowed_libraries` 소유자가 다른 repo에서 배포하는 라이브러리(메시징 `dev.cakit.messaging`, gRPC `dev.cakit.grpc`)는 이 빌드의 프로젝트가 아니라 외부 좌표다. 그래서 프로젝트 edge 규칙(`allowed_dependencies`)이 보지 못한다. 그 빈자리를 두 칸이 메운다(설계 design-docs `repo-structure/05-library-repos.md` 10.2절 T2, 소유자 승인 2026-11-07). - 맨 위 `library_groups`: 다스릴 라이브러리의 Maven group 접두사. 지금 `["dev.cakit"]`이다. 이 접두사와 같거나 그 아래(`dev.cakit.` 다음) group만 다스린다. 다른 group(Spring, Kafka client 등)은 이 칸과 상관없다. - 행마다 선택 칸 `allowed_libraries`: 그 leaf가 쓸 수 있는 라이브러리 모듈의 `group:artifact` 목록. 없으면 빈 목록과 같다. 값은 `library_groups` 안의 group이어야 하고 겹치면 안 된다(registry를 읽을 때 거절). - 방향 검사(`verifyModuleDependencyDirection`, `verifyCleanArchitectureDependencies` 아래)는 프로젝트 edge와 같은 방식으로 대조한다: 운영 선언(`api`·`implementation`·`compileOnly`·`runtimeOnly`)의 소유 group 좌표와, `compileClasspath`에서 보이는 소유 group 모듈(라이브러리 모듈이 `api`로 내보낸 것 포함)이 모두 칸에 있어야 한다. 시험 구성은 보지 않는다. - 그래서 지금 지키는 약속 셋이 검사로 남는다: bridge(`adapter-outbound-messaging`)는 `messaging-core-api`만 본다. Kafka capability(`adapter-outbound-messaging-kafka`)는 starter-kafka를 `runtimeOnly`로만 싣는다. 계층 leaf는 칸이 비어 있으니 라이브러리를 쓸 수 없다.