# 주제: gRPC 플랫폼 18개 리프 전체가 어떤 배포에도 도달하지 않는다 (블록 수준 사실) # revision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 # 이 파일은 grpc-* 18개 리프 문서 전부가 인용하는 공통 근거다. # ---- (1) 18개 전부 runtime_memberships: [] ---- # command: modules.json 에서 id 가 grpc- 로 시작하는 항목 전수 leaf memberships allowed_dependencies grpc-core-api [] 0: grpc-policy [] 1: grpc-core-api grpc-proto-contract [] 1: grpc-core-api grpc-observability [] 1: grpc-core-api grpc-operation-ledger-jpa [] 1: grpc-core-api grpc-advanced-bootstrap [] 1: grpc-core-api grpc-server [] 2: grpc-core-api, grpc-policy grpc-client [] 2: grpc-core-api, grpc-policy grpc-admin [] 2: grpc-core-api, grpc-server grpc-codegen [] 2: grpc-core-api, grpc-proto-contract grpc-discovery [] 2: grpc-client, grpc-core-api grpc-advanced-diagnostics [] 3: grpc-advanced-bootstrap, grpc-client, grpc-core-api grpc-advanced-edition [] 3: grpc-advanced-bootstrap, grpc-core-api, grpc-proto-contract grpc-advanced-streaming [] 3: grpc-advanced-bootstrap, grpc-core-api, grpc-policy grpc-advanced-compat [] 5: grpc-advanced-bootstrap, grpc-client, grpc-core-api, grpc-policy, grpc-server grpc-advanced-resilience [] 5: grpc-advanced-bootstrap, grpc-client, grpc-core-api, grpc-discovery, grpc-policy grpc-spring-boot-starter [] 10: admin, client, codegen, core-api, discovery, observability, operation-ledger-jpa, policy, proto-contract, server grpc-testkit [] 10: (동일 10개) # => 18/18 이 빈 멤버십이다. messaging 은 25개 중 8개가 app-bootstrap 에 속한다. # ---- (2) grpc 밖에서 이 코드를 import 하는 파일이 0건 ---- # command: git grep -ln "import dev.caskeleton.grpc" -- src | grep -v "^src/grpc/" | grep -v "^src/grpc-advanced/" # exit: 1 (출력 없음) # => 29,245 LOC 짜리 플랫폼 전체의 외부 소비자가 0이다. # ---- (3) app-bootstrap 이 의존하는 것은 다른 계보다 ---- # command: grep -n "grpc" src/app-bootstrap/build.gradle # 199: conditionalTransportTestImplementation project(':adapter:inbound:grpc') # => (a) src/grpc/* 가 아니라 src/adapter/inbound/grpc 다. # (b) conditionalTransportTestImplementation — **테스트 전용 구성**이다. # # src/adapter/inbound/grpc/build.gradle 헤더: # "Driving adapter: gRPC API (skeleton machinery, transport-only)." # "A SmartLifecycle bean (GrpcServerRunner) owns the io.grpc Netty server, so this module depends # on NO third-party grpc-spring-boot starter" # "The skeleton compiles NO protobuf: there is no `com.google.protobuf` plugin and no `.proto` # here — health + reflection come from grpc-services at runtime, and a future consuming feature # owns its `.proto`/services." # => 저장소에 gRPC 구현이 **두 계보** 있다: # A. src/adapter/inbound/grpc — 스켈레톤, protobuf 없음, app-bootstrap 이 테스트 의존 # B. src/grpc/* + src/grpc-advanced/* — 18리프 플랫폼, 소비자 0 # 두 계보 사이에 코드 참조가 없다. # ---- (4) 빌드에는 포함된다 ---- # src/settings.gradle 은 grpc 를 명시하지 않는다. 대신: # id 'ca.architecture-registry' # "Reads and validates config/architecture/modules.json, then includes every registered project" # => 18개 리프는 레지스트리를 통해 빌드에 포함되고, 컴파일·테스트·정적분석 게이트를 전부 통과한다. # 배포 그래프에만 들어가지 않는다. # ---- (5) 테스트는 전부 통과한다 ---- # command: ./gradlew :grpc:*:test :grpc-advanced:*:test --console=plain # exit: 0 (BUILD SUCCESSFUL, 81 tasks up-to-date — 입력 불변이므로 이 revision 의 결과다) grpc-admin tests=27 failures=0 skipped=0 grpc-client tests=31 failures=0 skipped=0 grpc-codegen tests=21 failures=0 skipped=0 grpc-core-api tests=63 failures=0 skipped=0 grpc-discovery tests=15 failures=0 skipped=0 grpc-observability tests=10 failures=0 skipped=0 grpc-operation-ledger-jpa tests=10 failures=0 skipped=0 grpc-policy tests=151 failures=0 skipped=0 grpc-proto-contract tests=13 failures=0 skipped=0 grpc-server tests=41 failures=0 skipped=0 grpc-spring-boot-starter tests=12 failures=0 skipped=0 grpc-testkit tests=56 failures=0 skipped=0 grpc-advanced-bootstrap tests=17 failures=0 skipped=0 grpc-advanced-compat tests=27 failures=0 skipped=0 grpc-advanced-diagnostics tests=11 failures=0 skipped=0 grpc-advanced-edition tests=13 failures=0 skipped=0 grpc-advanced-resilience tests=31 failures=0 skipped=0 grpc-advanced-streaming tests=30 failures=0 skipped=0 TOTAL tests=579 failures=0 skipped=0 # 컨테이너 IT 는 없다 (testcontainers 의존을 가진 grpc 리프가 없다). # ---- (6) 규모 ---- leaf files loc main test grpc-policy 80 7581 62 18 <- 최대 grpc-testkit 34 3652 26 8 grpc-core-api 39 2823 32 7 grpc-server 22 1836 17 5 grpc-advanced-resilience 20 1517 16 4 grpc-client 17 1512 13 4 grpc-advanced-compat 22 1485 17 5 grpc-admin 17 1403 13 4 grpc-advanced-streaming 18 1262 14 4 grpc-codegen 13 1139 9 4 grpc-proto-contract 4 929 3 1 grpc-advanced-bootstrap 11 889 9 2 grpc-spring-boot-starter 5 735 4 1 grpc-discovery 9 629 7 2 grpc-advanced-edition 8 537 6 2 grpc-observability 5 526 4 1 grpc-advanced-diagnostics 5 506 4 1 grpc-operation-ledger-jpa 4 484 3 1 TOTAL 332 29245 255 77 # ---- 중요: 이 상태는 이미 정확히 문서화되어 있다 (grpc-testkit 분석 중 발견) ---- # src/grpc/CLAUDE.md:74-98 이 위 측정과 같은 내용을 스스로 서술한다: # "registry의 모든 grpc:* leaf는 현재 runtime_memberships가 비어 있다. … # **배포 아티팩트가 싣고 있지 않다.** build-only다." # "애플리케이션에 배선하려면 registry의 runtime_memberships를 먼저 바꾸고 # verifyRuntimeModuleMembership을 통과시켜야 한다. 코드만 추가하는 것으로는 런타임에 들어가지 않는다." # "현재 adapter:inbound:grpc는 이 family에 의존하지 않는다 — registry의 allowed_dependencies를 # 보라. 배선은 별도 결정이며, 그때 registry edge와 브리지가 함께 들어간다." # "messaging:*의 MSG-015(bridge 부재)를 반복하지 않는 것이 이 family의 목표다." # => 이 파일이 측정한 것은 **드리프트가 아니라 확인**이다. 미배선은 인지되고 서술된 상태이며, # 두 계보가 분리되어 있는 것도 의도된 것이다. # 각 리프 문서의 §12.1 은 이 사실을 기준선으로 쓰되, 그것을 결함으로 제시해서는 안 된다. # (CLAUDE.md 의 세 주장 중 "GrpcStableReleaseGate가 그 구분을 코드로 붙들고 있다" 만 # 절반만 성립한다 — EVD-330 참조.) # ---- 판정 ---- # messaging 플랫폼은 "설계는 완성되었고 조립이 부분적" 이었다 — 발행 경로는 살아 있고 # 소비 경로가 배선되지 않았다. gRPC 플랫폼은 그것과 다르다: **조립이 아예 없다.** # 18개 리프가 서로를 의존하며 닫힌 그래프를 이루고, 그 그래프 밖으로 나가는 참조가 하나도 없다. # 이 사실이 각 리프 문서의 §12.1 판정 기준선이며, 개별 리프의 "미사용" 은 # 그 리프의 결함이 아니라 블록 전체의 상태다.