앞 커밋이 메시징 플랫폼을 지웠지만 살아 있는 문서는 아직 src/platforms 경로와 docs/messaging/을 부른다. 기록 8개의 머리 블록 「현재 정본」도 지운 docs/messaging/support-matrix.md를 가리킨다. - docs/messaging/(10개)을 지운다. 같은 이름의 파일이 이력째 messaging-library에 있다. 이 repo에서 그 내용을 부르던 문서(manual 09, messaging-kafka README·AGENTS)는 그 repo 파일로 링크한다. - 기록(설계서 3, 계획서 3, 납품 패키지 2): 본문은 두고 머리 블록만 고쳤다. 플랫폼을 다룬 것은 「없음 — messaging-library로 옮겼다」, 앱 쪽 발행·소비를 다룬 것은 docs/manual/09-outbox-events.md. - docs/work/reference/related-repos.md: 관련 저장소 표(메시징 줄 채움), 라이브러리를 고치는 법, 템플릿에서 버전 올리는 법, 같이 고칠 때 composite build(Gradle 루트가 src/라 ../../messaging-library), registry 라이브러리 칸. 설계 14절이 근거다. - src/config/architecture/README.md: library_groups·allowed_libraries 설명. - docs/upgrade/2026-11-maturity-review.md 3.9절: B-57(지운 것), B-58(받는 법·패키지·auto-config 이름), B-59(registry 칸). - 진입 문서와 지역 지침(AGENTS.md, README.md, delegate, decisions, review-criteria, defect-patterns, gates, capability-status, manual 07, build-logic·persistence-jpa·inbound messaging·shared-contract 지침, env-keys 주석)에서 「들여온 제품」·src/platforms 문장을 별도 repo 라이브러리 문장으로 바꿨다. 위험: 다른 repo 파일을 가리키는 링크는 lychee가 외부 URL로 본다(공개 repo라 익명으로 읽힌다). 검증: python3 scripts/check-docs.py OK, check-work-docs.py OK(상대 링크 깨짐 0), check-repo-layout.py OK, python3 -m unittest discover -s scripts/tests OK. BREAKING CHANGE: docs/messaging/이 없어졌다. 메시징 문서는 messaging-library repo의 docs/messaging/에 있다. Refs: design-docs repo-structure/05-library-repos.md 4.3·14절
2.7 KiB
아키텍처 모듈 registry
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는 칸이 비어 있으니 라이브러리를 쓸 수 없다.