From df3c7838b6d4c65cfa9e0cd03f01b85deb5624e4 Mon Sep 17 00:00:00 2001 From: donghyeon-ka Date: Thu, 17 Sep 2026 15:22:32 +0900 Subject: [PATCH] =?UTF-8?q?refactor:=20=EB=B9=8C=EB=93=9C=20=EC=B5=9C?= =?UTF-8?q?=EC=A0=81=ED=99=94=20=EB=B0=8F=20ci=20=EC=88=98=EC=A0=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/workflows/messaging-certification.yml | 2 +- messaging/CLAUDE.md | 29 +++++-------------- messaging/messaging-admin-api/build.gradle | 4 ++- .../messaging-admin-runtime/build.gradle | 4 ++- messaging/messaging-claim-check/build.gradle | 4 ++- messaging/messaging-cloudevents/build.gradle | 4 ++- messaging/messaging-core-api/build.gradle | 4 ++- .../build.gradle | 4 ++- .../build.gradle | 4 ++- messaging/messaging-kafka/build.gradle | 4 ++- .../messaging-nats-experimental/build.gradle | 4 ++- .../messaging-observability/build.gradle | 4 ++- .../build.gradle | 4 ++- messaging/messaging-policy/build.gradle | 4 ++- .../build.gradle | 4 ++- messaging/messaging-rabbit/build.gradle | 4 ++- .../messaging-reliability-api/build.gradle | 4 ++- messaging/messaging-runtime-core/build.gradle | 4 ++- messaging/messaging-schema-api/build.gradle | 4 ++- messaging/messaging-schema-avro/build.gradle | 4 ++- messaging/messaging-schema-json/build.gradle | 4 ++- .../messaging-schema-protobuf/build.gradle | 4 ++- messaging/messaging-security/build.gradle | 4 ++- .../build.gradle | 6 ++-- .../build.gradle | 4 ++- messaging/messaging-testkit/build.gradle | 4 ++- .../messaging-transport-spi/build.gradle | 4 ++- 27 files changed, 85 insertions(+), 48 deletions(-) diff --git a/.github/workflows/messaging-certification.yml b/.github/workflows/messaging-certification.yml index 26ae5b6..d20e9ca 100644 --- a/.github/workflows/messaging-certification.yml +++ b/.github/workflows/messaging-certification.yml @@ -41,7 +41,7 @@ jobs: working-directory: src # GITHUB_SHA is read by the lane and written into every evidence line, because "certified" # is a claim about one source tree. - run: ./gradlew :messaging:messaging-kafka:verifyMessagingCertificationEvidence --no-daemon --stacktrace + run: ./gradlew :messaging:messaging-kafka:verifyMessagingCertificationEvidence --stacktrace - name: Publish the certification evidence if: always() uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # actions/upload-artifact@v4.6.2 diff --git a/messaging/CLAUDE.md b/messaging/CLAUDE.md index c7036b2..e99d76b 100644 --- a/messaging/CLAUDE.md +++ b/messaging/CLAUDE.md @@ -43,29 +43,16 @@ leaf의 정확한 id는 registry에서 읽는다. family는 **디렉터리 이 등장하고 adopter가 이름 부를 일이 없다. - 새 public 타입은 그 모듈의 계약이다. 삭제·시그니처 변경은 breaking change로 취급한다. -## Runtime membership이 비어 있다는 것의 의미 +## Application runtime에 포함되는 기준 -**이 절은 한동안 사실이 아닌 채로 남아 있었다.** "registry의 모든 messaging leaf는 -`runtime_memberships`가 비어 있고 따라서 build-only"라고 쓰여 있었는데, 다섯 어댑터 remediation이 -`messaging-spring-boot-starter`를 `app-bootstrap` 의존성으로 넣으면서 그 closure 전체가 런타임 -classpath에 올라갔다. 정확한 목록은 registry가 소유하므로 여기서 세지 않는다 — 세는 순간 다시 -drift한다. +Messaging family는 기본 application이 `messaging-spring-boot-starter`를 dependency로 가지므로 그 +transitive project graph가 runtime에 포함된다. 이 사실의 SSOT는 Gradle `runtimeClasspath`이며 registry에 +동일한 membership 목록을 복제하지 않는다. `app.messaging.enabled=false`가 기본값이고 master switch가 +activation을 결정한다. -지금 의미는 이렇다: - -- 대부분의 leaf는 `runtime_memberships`에 `app-bootstrap`을 갖는다. **배포된 아티팩트가 싣고 있고, - master switch `app.messaging.enabled`로 켜진다.** 기본값은 `false`다. -- 여전히 비어 있는 leaf(experimental transport, 일부 codec, bridge, testkit)만이 build-only / - incubating이다. -- **런타임에 있다는 것과 자격이 증명됐다는 것은 다르다.** Kafka publish 경로만 실브로커 round trip으로 - 자격 검증됐고(`MessagingLiveRoundTripQualificationTest`), Rabbit·JDBC inbox/outbox·claim check·admin - plane은 shipped, inactive, unqualified다. 이 구분은 - `MessagingMembershipQualificationTest`가 문서가 아니라 테스트로 붙들고 있다. -- 애플리케이션에 새로 배선하려면 registry의 `runtime_memberships`를 먼저 바꾸고 - `verifyRuntimeModuleMembership`을 통과시켜야 한다. 코드만 추가하는 것으로는 런타임에 들어가지 - 않는다. -- 지원 상태 문서(`docs/messaging/support-matrix.md`)의 tier는 이 사실과 별개다. tier는 "무엇이 - 증명되었는가", membership은 "무엇이 실행되는가"다. +experimental transport, 일부 codec/bridge/testkit처럼 starter graph에 들어오지 않는 leaf는 build-only다. +새 leaf를 application에 채택할 때는 starter 또는 composition dependency와 architecture edge policy, +qualification/support 상태를 함께 변경한다. ## application이 이 family에 도달하는 경로 (MSG-015, 미해결) diff --git a/messaging/messaging-admin-api/build.gradle b/messaging/messaging-admin-api/build.gradle index 082a083..55c8be5 100644 --- a/messaging/messaging-admin-api/build.gradle +++ b/messaging/messaging-admin-api/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-admin-runtime/build.gradle b/messaging/messaging-admin-runtime/build.gradle index bb00b83..feb5781 100644 --- a/messaging/messaging-admin-runtime/build.gradle +++ b/messaging/messaging-admin-runtime/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-claim-check/build.gradle b/messaging/messaging-claim-check/build.gradle index ee6baf3..a145cc4 100644 --- a/messaging/messaging-claim-check/build.gradle +++ b/messaging/messaging-claim-check/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-cloudevents/build.gradle b/messaging/messaging-cloudevents/build.gradle index 26d72f7..b65cf72 100644 --- a/messaging/messaging-cloudevents/build.gradle +++ b/messaging/messaging-cloudevents/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-core-api/build.gradle b/messaging/messaging-core-api/build.gradle index ff4ac8c..d202f8b 100644 --- a/messaging/messaging-core-api/build.gradle +++ b/messaging/messaging-core-api/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { } diff --git a/messaging/messaging-inbox-jdbc-postgresql/build.gradle b/messaging/messaging-inbox-jdbc-postgresql/build.gradle index f14fb9b..1cd44c7 100644 --- a/messaging/messaging-inbox-jdbc-postgresql/build.gradle +++ b/messaging/messaging-inbox-jdbc-postgresql/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-kafka-share-experimental/build.gradle b/messaging/messaging-kafka-share-experimental/build.gradle index 40bd1ba..fd42b56 100644 --- a/messaging/messaging-kafka-share-experimental/build.gradle +++ b/messaging/messaging-kafka-share-experimental/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-kafka/build.gradle b/messaging/messaging-kafka/build.gradle index 849755a..355925d 100644 --- a/messaging/messaging-kafka/build.gradle +++ b/messaging/messaging-kafka/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.jmh-benchmarks' +plugins { + id 'ca.jmh-benchmarks' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-nats-experimental/build.gradle b/messaging/messaging-nats-experimental/build.gradle index aee4eb3..d635cef 100644 --- a/messaging/messaging-nats-experimental/build.gradle +++ b/messaging/messaging-nats-experimental/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-observability/build.gradle b/messaging/messaging-observability/build.gradle index 35931a0..b255ee7 100644 --- a/messaging/messaging-observability/build.gradle +++ b/messaging/messaging-observability/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-outbox-jdbc-postgresql/build.gradle b/messaging/messaging-outbox-jdbc-postgresql/build.gradle index 5746458..8aabecd 100644 --- a/messaging/messaging-outbox-jdbc-postgresql/build.gradle +++ b/messaging/messaging-outbox-jdbc-postgresql/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-policy/build.gradle b/messaging/messaging-policy/build.gradle index 04f7b4f..f2ca78e 100644 --- a/messaging/messaging-policy/build.gradle +++ b/messaging/messaging-policy/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-pulsar-experimental/build.gradle b/messaging/messaging-pulsar-experimental/build.gradle index f07f5dc..c98d34a 100644 --- a/messaging/messaging-pulsar-experimental/build.gradle +++ b/messaging/messaging-pulsar-experimental/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-rabbit/build.gradle b/messaging/messaging-rabbit/build.gradle index dd68727..b45f5fb 100644 --- a/messaging/messaging-rabbit/build.gradle +++ b/messaging/messaging-rabbit/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.jmh-benchmarks' +plugins { + id 'ca.jmh-benchmarks' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-reliability-api/build.gradle b/messaging/messaging-reliability-api/build.gradle index 13f62eb..fac7b20 100644 --- a/messaging/messaging-reliability-api/build.gradle +++ b/messaging/messaging-reliability-api/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-runtime-core/build.gradle b/messaging/messaging-runtime-core/build.gradle index e1baddf..5fb6829 100644 --- a/messaging/messaging-runtime-core/build.gradle +++ b/messaging/messaging-runtime-core/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} // The central publish and delivery orchestration. // diff --git a/messaging/messaging-schema-api/build.gradle b/messaging/messaging-schema-api/build.gradle index 13f62eb..fac7b20 100644 --- a/messaging/messaging-schema-api/build.gradle +++ b/messaging/messaging-schema-api/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-schema-avro/build.gradle b/messaging/messaging-schema-avro/build.gradle index 9fd42ad..4044538 100644 --- a/messaging/messaging-schema-avro/build.gradle +++ b/messaging/messaging-schema-avro/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-schema-json/build.gradle b/messaging/messaging-schema-json/build.gradle index f7b2d4d..aebe0fe 100644 --- a/messaging/messaging-schema-json/build.gradle +++ b/messaging/messaging-schema-json/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-schema-protobuf/build.gradle b/messaging/messaging-schema-protobuf/build.gradle index 588b944..054e094 100644 --- a/messaging/messaging-schema-protobuf/build.gradle +++ b/messaging/messaging-schema-protobuf/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-security/build.gradle b/messaging/messaging-security/build.gradle index 13f62eb..fac7b20 100644 --- a/messaging/messaging-security/build.gradle +++ b/messaging/messaging-security/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-spring-boot-starter/build.gradle b/messaging/messaging-spring-boot-starter/build.gradle index 0174f1d..448d06a 100644 --- a/messaging/messaging-spring-boot-starter/build.gradle +++ b/messaging/messaging-spring-boot-starter/build.gradle @@ -1,5 +1,7 @@ -apply plugin: 'ca.platform-module' -apply plugin: 'ca.spring-config' +plugins { + id 'ca.platform-module' + id 'ca.spring-config' +} // Scopes, not a flat list of `api`. // diff --git a/messaging/messaging-spring-cloud-stream-bridge/build.gradle b/messaging/messaging-spring-cloud-stream-bridge/build.gradle index 87d33c7..e9bd8ef 100644 --- a/messaging/messaging-spring-cloud-stream-bridge/build.gradle +++ b/messaging/messaging-spring-cloud-stream-bridge/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-testkit/build.gradle b/messaging/messaging-testkit/build.gradle index c8fca95..559464f 100644 --- a/messaging/messaging-testkit/build.gradle +++ b/messaging/messaging-testkit/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.jmh-benchmarks' +plugins { + id 'ca.jmh-benchmarks' +} dependencies { api project(':messaging:messaging-core-api') diff --git a/messaging/messaging-transport-spi/build.gradle b/messaging/messaging-transport-spi/build.gradle index b2e7001..81e3e70 100644 --- a/messaging/messaging-transport-spi/build.gradle +++ b/messaging/messaging-transport-spi/build.gradle @@ -1,4 +1,6 @@ -apply plugin: 'ca.platform-module' +plugins { + id 'ca.platform-module' +} dependencies { api project(':messaging:messaging-core-api')