DongHyeonkaandClaude Opus 5
b2963105a8
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>
104 lines
16 KiB
XML
104 lines
16 KiB
XML
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1712" viewBox="0 0 1200 1712" role="img">
|
|
<title>terminal evidence</title>
|
|
<desc>Terminal-style rendering generated from retained command output. Sensitive-looking values are redacted in the visual asset.</desc>
|
|
<rect x="1" y="1" width="1198" height="1710" rx="14" fill="#0d1117" stroke="#30363d"/>
|
|
<rect x="1" y="1" width="1198" height="44" rx="14" fill="#161b22"/>
|
|
<rect x="1" y="30" width="1198" height="14" fill="#161b22"/>
|
|
<circle cx="24" cy="22" r="6" fill="#ff5f57"/>
|
|
<circle cx="44" cy="22" r="6" fill="#febc2e"/>
|
|
<circle cx="64" cy="22" r="6" fill="#28c840"/>
|
|
<text x="92" y="27" fill="#8b949e" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace">terminal evidence</text>
|
|
<text x="24" y="68" fill="#c9d1d9" font-size="15" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">$ SELF=adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/Transactio</tspan><tspan x="24" dy="22">nProfileRegistry.java
|
|
|
|
echo '# 자리 — 이 리프의 공개 API 패키지인가, 구현 패키지인가'
|
|
grep -n '^package' "$SELF"
|
|
echo -</tspan><tspan x="24" dy="22">n '# 리프의 api/** 아래 main 파일: '
|
|
find adapter/outbound/persistence-jpa/src/main/java -path '*/api/*' -name '*.java</tspan><tspan x="24" dy="22">' | wc -l
|
|
echo -n '# 그중 이 파일: '
|
|
find adapter/outbound/persistence-jpa/src/main/java -path '*/api/*' -name 'Transa</tspan><tspan x="24" dy="22">ctionProfileRegistry.java' | wc -l
|
|
|
|
echo
|
|
echo '# 제거 조건 하나 — 외부 프로덕션 참조'
|
|
echo -n '# 자기 파일을 뺀 main </tspan><tspan x="24" dy="22">참조: '
|
|
grep -rnw 'TransactionProfileRegistry' --include=*.java . | grep '/main/' | grep -vc "$SELF"
|
|
echo -n '# 자동설</tspan><tspan x="24" dy="22">정 등록 리소스와 spring.factories: '
|
|
grep -rl 'TransactionProfileRegistry' --include=*.imports --include=spring.factorie</tspan><tspan x="24" dy="22">s . 2>/dev/null | wc -l
|
|
echo '# 패키지는 스캔 대상이지만 이 클래스에 스테레오타입이 없다'
|
|
grep -rn 'persistence.transa</tspan><tspan x="24" dy="22">ction' --include=JpaAdapterComponentsConfig.java . | sed 's|.*/||'
|
|
echo -n '# 이 파일의 스테레오타입 애너테이션: '
|
|
gre</tspan><tspan x="24" dy="22">p -c '^@\|^ @Component\|^ @Service' "$SELF"
|
|
echo -n '# 전용 단위 테스트 한 파일 안의 참조: '
|
|
grep -rcw 'TransactionP</tspan><tspan x="24" dy="22">rofileRegistry' adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/T</tspan><tspan x="24" dy="22">ransactionProfileRegistryTest.java
|
|
|
|
echo
|
|
echo '# 제거 조건 둘 — 설정 경로'
|
|
echo -n '# 출하 yml 전부에서 프로파일을 이</tspan><tspan x="24" dy="22">름으로 등록하는 키: '
|
|
grep -rl 'transaction-profile\|transactionProfile' app-bootstrap/src/main/resources sample-portfol</tspan><tspan x="24" dy="22">io/src/main/resources 2>/dev/null | wc -l
|
|
echo -n '# @ConfigurationProperties 클래스 전부에서의 참조: '
|
|
grep -rln '@Co</tspan><tspan x="24" dy="22">nfigurationProperties' --include=*.java . | grep '/main/' | xargs grep -lw 'TransactionProfileRegistry' 2>/dev/null | wc</tspan><tspan x="24" dy="22"> -l
|
|
|
|
echo
|
|
echo '# 제거 조건 셋 — 대체 경로가 같은 동작을 증명하는가'
|
|
echo -n '# 레지스트리가 담는 타입 TransactionPro</tspan><tspan x="24" dy="22">file 이 나타나는 main 줄: '
|
|
grep -rnw 'TransactionProfile' --include=*.java . | grep '/main/' | grep -v 'api/transaction</tspan><tspan x="24" dy="22">/TransactionProfile.java' | grep -vc "$SELF"
|
|
echo -n '# 그중 import 와 javadoc 을 뺀 타입 사용: '
|
|
grep -rnw 'Transac</tspan><tspan x="24" dy="22">tionProfile' --include=*.java . | grep '/main/' | grep -v 'api/transaction/TransactionProfile.java' | grep -v "$SELF" | </tspan><tspan x="24" dy="22">grep -vc 'import \|{@link'
|
|
echo '# 그 줄이 있는 파일'
|
|
grep -rlw 'TransactionProfile' --include=*.java . | grep '/main/</tspan><tspan x="24" dy="22">' | grep -v 'api/transaction/TransactionProfile.java' | grep -v "$SELF" | sed 's|.*/||' | sed 's/^/# /'
|
|
echo '# 포</tspan><tspan x="24" dy="22">트 시그니처 — 프로파일은 이름이 아니라 두 번째 인자의 객체다'
|
|
grep -n 'T execute(' adapter/outbound/persistence-jpa/src</tspan><tspan x="24" dy="22">/main/java/dev/caskeleton/adapter/outbound/persistence/api/transaction/JpaTransactionExecutor.java
|
|
echo -n '# 자기 파</tspan><tspan x="24" dy="22">일 밖 main 에서 TransactionProfile 을 만드는 곳: '
|
|
grep -rn 'TransactionProfile\.write(\|TransactionProfile\.read(\|new </tspan><tspan x="24" dy="22">TransactionProfile(' --include=*.java . | grep '/main/' | grep -vc 'api/transaction/TransactionProfile.java'
|
|
echo '# </tspan><tspan x="24" dy="22">포트 자체를 참조하는 main 파일 (단어 경계, 구현체와 구분)'
|
|
grep -rlnw 'JpaTransactionExecutor' --include=*.java . | grep</tspan><tspan x="24" dy="22"> '/main/' | sed 's|.*/||' | sed 's/^/# /'
|
|
|
|
echo
|
|
echo '# 프로덕션 트랜잭션이 실제로 지나는 곳은 다른 타입이다'
|
|
grep -</tspan><tspan x="24" dy="22">n 'implements PolicyTransactionPort' adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/pers</tspan><tspan x="24" dy="22">istence/transaction/SpringTransactionPort.java
|
|
grep -n 'inTransaction(TransactionRequest' adapter/outbound/persistence-j</tspan><tspan x="24" dy="22">pa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java
|
|
echo -n '# 그 파일</tspan><tspan x="24" dy="22"> 안의 TransactionProfile 참조: '
|
|
grep -cw 'TransactionProfile' adapter/outbound/persistence-jpa/src/main/java/dev/caskel</tspan><tspan x="24" dy="22">eton/adapter/outbound/persistence/transaction/SpringTransactionPort.java
|
|
echo -n '# PolicyTransactionPort 를 쓰는 main</tspan><tspan x="24" dy="22"> 파일: '
|
|
grep -rlw 'PolicyTransactionPort' --include=*.java . | grep -c '/main/' </tspan></text>
|
|
<text x="24" y="794" fill="#8b949e" font-size="13" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">cwd: /shared/codebase/clean-architecture-backend-template/src</tspan></text>
|
|
<text x="24" y="816" fill="#8b949e" font-size="13" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">time: 2026-09-02T03:32:47+00:00 · exit 0</tspan></text>
|
|
<line x1="24" y1="830" x2="1176" y2="830" stroke="#30363d"/>
|
|
<text x="24" y="870" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 자리 — 이 리프의 공개 API 패키지인가, 구현 패키지인가</tspan></text>
|
|
<text x="24" y="892" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">1:package dev.caskeleton.adapter.outbound.persistence.transaction;</tspan></text>
|
|
<text x="24" y="914" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 리프의 api/** 아래 main 파일: 49</tspan></text>
|
|
<text x="24" y="936" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 그중 이 파일: 0</tspan></text>
|
|
<text x="24" y="958" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"></tspan></text>
|
|
<text x="24" y="980" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 제거 조건 하나 — 외부 프로덕션 참조</tspan></text>
|
|
<text x="24" y="1002" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 자기 파일을 뺀 main 참조: 0</tspan></text>
|
|
<text x="24" y="1024" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 자동설정 등록 리소스와 spring.factories: 0</tspan></text>
|
|
<text x="24" y="1046" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 패키지는 스캔 대상이지만 이 클래스에 스테레오타입이 없다</tspan></text>
|
|
<text x="24" y="1068" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">JpaAdapterComponentsConfig.java:66: "dev.caskeleton.adapter.outbound.persistence.transaction"</tspan></text>
|
|
<text x="24" y="1090" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 이 파일의 스테레오타입 애너테이션: 0</tspan></text>
|
|
<text x="24" y="1112" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 전용 단위 테스트 한 파일 안의 참조: 3</tspan></text>
|
|
<text x="24" y="1134" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"></tspan></text>
|
|
<text x="24" y="1156" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 제거 조건 둘 — 설정 경로</tspan></text>
|
|
<text x="24" y="1178" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 출하 yml 전부에서 프로파일을 이름으로 등록하는 키: 0</tspan></text>
|
|
<text x="24" y="1200" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># @ConfigurationProperties 클래스 전부에서의 참조: 0</tspan></text>
|
|
<text x="24" y="1222" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"></tspan></text>
|
|
<text x="24" y="1244" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 제거 조건 셋 — 대체 경로가 같은 동작을 증명하는가</tspan></text>
|
|
<text x="24" y="1266" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 레지스트리가 담는 타입 TransactionProfile 이 나타나는 main 줄: 11</tspan></text>
|
|
<text x="24" y="1288" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 그중 import 와 javadoc 을 뺀 타입 사용: 7</tspan></text>
|
|
<text x="24" y="1310" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 그 줄이 있는 파일</tspan></text>
|
|
<text x="24" y="1332" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># FullTransactionRetryCoordinator.java</tspan></text>
|
|
<text x="24" y="1354" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># TransactionDefinitionMapper.java</tspan></text>
|
|
<text x="24" y="1376" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># SpringJpaTransactionExecutor.java</tspan></text>
|
|
<text x="24" y="1398" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># JpaTransactionExecutor.java</tspan></text>
|
|
<text x="24" y="1420" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 포트 시그니처 — 프로파일은 이름이 아니라 두 번째 인자의 객체다</tspan></text>
|
|
<text x="24" y="1442" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">23: <T> T execute(PersistenceOperationName operation, TransactionProfile profile, Supplier<T> work);</tspan></text>
|
|
<text x="24" y="1464" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 자기 파일 밖 main 에서 TransactionProfile 을 만드는 곳: 0</tspan></text>
|
|
<text x="24" y="1486" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 포트 자체를 참조하는 main 파일 (단어 경계, 구현체와 구분)</tspan></text>
|
|
<text x="24" y="1508" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># SpringJpaTransactionExecutor.java</tspan></text>
|
|
<text x="24" y="1530" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># JpaTransactionExecutor.java</tspan></text>
|
|
<text x="24" y="1552" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"></tspan></text>
|
|
<text x="24" y="1574" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 프로덕션 트랜잭션이 실제로 지나는 곳은 다른 타입이다</tspan></text>
|
|
<text x="24" y="1596" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">31:public class SpringTransactionPort implements PolicyTransactionPort {</tspan></text>
|
|
<text x="24" y="1618" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">165: public <T> TransactionResult<T> inTransaction(TransactionRequest request, Supplier<T> action) {</tspan></text>
|
|
<text x="24" y="1640" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># 그 파일 안의 TransactionProfile 참조: 0</tspan></text>
|
|
<text x="24" y="1662" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># PolicyTransactionPort 를 쓰는 main 파일: 3</tspan></text>
|
|
</svg>
|