Files
clean-architecture-backend-…/docs/compatibility/grpc-advanced-support-matrix.md
T
donghyeon-kaandClaude Opus 5.5 27f23add08 review-followup Wave 3: 설정 prefix app.* 통일(P20), Wave 3 종료
- 결정 16: `ca-skeleton.*`·`backend.graphql` 등 → `app.*`(APP_* env 키 이름 유지), selector 키 상수 하나(`CapabilitySelectors`),
  바인딩만 되던 `streaming-idle` 삭제
- `StrictSettingsBinder`가 env 오타까지 거부 — 모든 capability(graphql·websocket·mongo는 edge 제약으로 파일만 strict),
  httpclient 리플렉션 `HttpClientEnvironmentKeys` 삭제
- persistence-jpa가 `APP_DATASOURCE_PASSWORD` secret 요구를 기여(bootstrap이 JPA 스위치를 읽지 않음), Redis ACL fixture에서 pub/sub 권한 제거
- 결함 수정: SMTP 설정 env 이름 충돌(P20-new-1), `bindExcept`가 system env까지 filter(P20-new-2), graphql 빈 deployment-mode 메시지(P20-new-6)
- 통합: P30과 충돌 11건(P30의 명시적 bean 구조 유지), P30 코드의 옛 키를 app.*로, persistence-jpa 포맷
- 현황표: 소유자 결정 36(persistence-jpa 설정은 플랫폼 키만 app.persistence-jpa.*로, 공유 기능 트리 예외), 재개 문서에 일시 정지 상태

Wave 3 종료 검증: check · ci verifyDependencyLocks --warning-mode=fail(714 task) · mainCheck · architectureCheck
verifyPublicPathSnapshot :app-bootstrap:verifyEnvKeys configContractCheck · :app-bootstrap:integrationTest
:sample-portfolio:integrationTest :sample-portfolio:systemTest · integrationCheck · -p build-logic test ·
-p optional-platforms ci · :app-bootstrap:qualificationBootJar releaseCheck 통과

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-09-29 17:01:54 +09:00

3.0 KiB

gRPC advanced capability support matrix

Every capability in :grpc-advanced:*, its grade, and what it would take to raise it. GrpcAdvancedSupportMatrix is the machine-readable form; GrpcAdvancedCapability.defaultGrade carries the same values.

All capabilities are off by default. Flags are app.grpc.advanced.<capability>.enabled.

Grades

Grade May start Production needs a separate approval
ADVANCED_STABLE Yes No
EXPERIMENTAL Yes Yes
WATCH No —
DISABLED No —

Capabilities

Capability Flag Grade Real infrastructure its evidence needs
Protobuf Edition 2024 edition-2024 ADVANCED_STABLE —
Protobuf Edition 2026 edition-2026 WATCH —
Client streaming client-streaming ADVANCED_STABLE —
Bidirectional streaming bidi-streaming ADVANCED_STABLE —
Manual flow control manual-flow-control ADVANCED_STABLE —
Read-only unary hedging hedging EXPERIMENTAL —
Custom name resolver custom-resolver ADVANCED_STABLE —
Custom load balancer custom-load-balancer EXPERIMENTAL —
Proxyless xDS xds EXPERIMENTAL xDS control plane
gRPC-Web grpc-web ADVANCED_STABLE gRPC-Web proxy
Servlet HTTP/2 servlet-compat ADVANCED_STABLE (flag only; no Servlet transport code since 2026-09-25) Servlet container
Spring Integration bridge integration-bridge ADVANCED_STABLE —
Reactor adapter reactor ADVANCED_STABLE —
Kotlin coroutine / Flow kotlin ADVANCED_STABLE Kotlin toolchain
Channelz / CSDS diagnostics channel-diagnostics ADVANCED_STABLE —

What the grades mean here, concretely

Grade is a statement about the contract, not about a deployment. Every capability's contract is implemented and tested in this repository. What no capability has is evidence from a real deployment: GrpcAdvancedPromotionEvidence for each one is empty, and no promotion has been granted.

Four capabilities cannot produce meaningful evidence here at all, because the infrastructure they need is absent (gRPC-Web proxy, Servlet container, xDS control plane, Kotlin toolchain), and a suite that runs without its infrastructure passes and establishes nothing.

Kotlin is the sharpest case. This repository has no Kotlin toolchain, so Kotlin is not supportable here until one exists. Only the Java-side coroutine cancellation bridge (GrpcCoroutineContextBridge) is implemented and tested; there is no compile lane.

Promotion thresholds

To Soak Also required
ADVANCED_STABLE 7 days compatibility evidence, security review, fault evidence, performance evidence, ADR, runbook, real-environment test
Stable default 30 days all of the above, plus a dependency, security and operational-cost review

WATCH becomes EXPERIMENTAL before anything else. Promotions are independent: promoting one capability changes no other's grade.