- 결정 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>
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.