Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/schema-and-data-contracts/case/case-grpc-advanced-edition-f01.md
T
DongHyeonkaandClaude Opus 5 b2963105a8 docs(keycloak-session-store): import the session-storage lab as a new project
The keycloak project ended with four open questions that design could not
settle. A two-VM lab was built to answer them by measurement, and this is
that material: 26 experiments, 125 raw command outputs, 22 browser captures.

Follows the import procedure in README.md.

  source/     the originating repository verbatim — 78 documents, 28 SVGs,
              8 manifests, plus .source-revision recording the commit
  final/      the SSOT
    document.md   729 lines written from the 29 experiment documents, not
                  concatenated: what was predicted, what was measured, and
                  where the measurement itself was wrong
    evidence/raw    125 outputs, flattened to <experiment>__<file> because
                    the originals collided (01-baseline.txt appeared three
                    times) and the audit only globs the top level
    evidence/meta   one per raw file; command and exitCode are null and the
                    README says why rather than inventing them
    evidence/browser  22 captures
    assets/       three diagrams through techviz
    .techviz/     their VizSpecs

A separate project rather than an addition to keycloak: the B-layer answers
that project's four questions, but the A, C and D layers are about cluster
failure, SSO and operations, and one document.md should hold one subject.
The four question records there can point here through 관계.

Recorded rather than papered over: only three of the 28 diagrams were
remade. The repository forbids hand-drawn SVG and forbids titles inside the
canvas; all 28 originals carry both, so converting them is redrawing, not
reformatting. They stay in source/ and the gap is written into the document.

verify-pipeline.py passes. audit-records.py reports no issues.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 22:51:59 +09:00

4.3 KiB

kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, evidenceCapturedOn, assets, evidence, source, module, priority
kind slug title topic project status sourceRevision rootTreeNode evidenceCapturedOn assets evidence source module priority
CASE grpc-advanced-edition-f01 비교 픽스처에 비교 대상이 없다 schema-and-data-contracts clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 case:grpc-advanced-edition-f01 2026-09-01
key file
grpc-advanced-edition-f01 ../../../final/evidence/rendered/grpc-advanced-edition-f01.svg
key file
grpc-advanced-edition-f01-diagram ../../../final/assets/diagrams/grpc-advanced-edition-f01.svg
../../../final/evidence/raw/grpc-advanced-edition-f01.txt
원본 분석 절은 analysis/grpc/grpc-advanced-edition.md#L180 이다.
grpc-advanced-edition P2

비교 픽스처에 비교 대상이 없다

compatibility.proto 의 주석이 존재 이유를 적는다. 그 쌍둥이가 저장소에 없다.

문제

compatibility.proto 의 주석이 존재 이유를 적는다.

그 쌍둥이가 저장소에 없다.

결론

한 곳뿐이다.

같은 필드와 번호를 proto3 로 선언한 파일이 없으므로 비교가 성립하지 않는다.

그리고 두 번째 전제도 없다.

이 저장소에는 protobuf 플러그인이 어디에도 없다 — grpc-proto-contract 와 adapter-inbound-grpc 의 build.gradle 이 그 사실을 주석으로 명시한다.

그러므로 편집 파일도 proto3 파일도 컴파일되지 않고, 유선 바이트와 JSON 을 비교할 산출물 자체가 만들어지지 않는다.

결과적으로 GrpcEditionCompatibilityReport 는 사람이 손으로 채우는 기록이 된다.

승격 게이트가 그것을 읽어 판정하므로, 게이트의 입력이 측정이 아니라 선언이다.

Advanced 가족이라 오늘의 배포에는 영향이 없다.

검증 환경

OpenJDK : 21.0.12 java -version 으로 확인 Gradle : 9.0.0 src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인 확인 방식 : GrpcEditionCompatibilityReport 참조 7건 검색과 픽스처 디렉터리의 파일 목록 확인 소스 수정 : x

재현 조건

원문은 analysis/grpc/grpc-advanced-edition.md#L180 에 있다.

본문

compatibility.proto 의 주석이 존재 이유를 적는다. 그 쌍둥이가 저장소에 없다.

비교에 필요한 것

:::evidence key="grpc-advanced-edition-f01-diagram" alt="edition 픽스처만 저장소 안에 놓이고 proto3 짝 픽스처와 컴파일 산출물이 바깥에 빗금으로 놓인다" caption="비교에 필요한 것" zoom="false" :::

같은 필드와 번호를 proto3 로 선언한 파일이 없으므로 비교가 성립하지 않는다.

GrpcEditionCompatibilityReport 참조 위치

:::evidence key="grpc-advanced-edition-f01" alt="코드베이스에서 GrpcEditionCompatibilityReport 를 검색한 출력 7줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="GrpcEditionCompatibilityReport 코드베이스 검색 — 7줄 · exit 0" zoom="true" :::

두 번째 전제도 없다

이 저장소에는 protobuf 플러그인이 어디에도 없다 — grpc-proto-contractadapter-inbound-grpc 의 build.gradle 이 그 사실을 주석으로 명시한다. 그러므로 편집 파일도 proto3 파일도 컴파일되지 않고, 유선 바이트와 JSON 을 비교할 산출물 자체가 만들어지지 않는다.

게이트의 입력이 측정이 아니라 선언이다

GrpcEditionCompatibilityReport 는 사람이 손으로 채우는 기록이 되고, 승격 게이트가 그것을 읽어 판정한다. Advanced 가족이라 오늘의 배포에는 영향이 없다.

기록하는 이유

이 리프의 목적이 "공개 서비스가 옮겨 가기 전에 그 실패를 찾는 것" 이고, 그 실패를 찾을 장치가 픽스처 하나만 있고 짝이 없다. compatibility_proto3.proto 를 같은 디렉터리에 두어 필드·번호·JSON 이름을 맞추고, 두 파일을 컴파일해 산출물을 비교하는 레인을 만든다. 그 레인이 생기기 전까지는 이 보고서가 측정이 아니라 선언이라는 것을 자바독에 적는 편이 낫다.

확인하지 못한 것

protoc 을 돌려 이 편집 파일이 실제로 컴파일되는지 확인하지 않았다. 저장소에 protobuf 플러그인이 없다.