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>
92 lines
17 KiB
XML
92 lines
17 KiB
XML
<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1800" viewBox="0 0 1200 1800" 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="1798" 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">$ M=adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/EvidenceAware</tspan><tspan x="24" dy="22">JpaTransactionManager.java
|
|
A=app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaTransactionAutoCo</tspan><tspan x="24" dy="22">nfiguration.java
|
|
C=adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transactio</tspan><tspan x="24" dy="22">n/CommitFailureClassifier.java
|
|
|
|
echo '# 루트의 몫이라고 적힌 두 가지'
|
|
grep -n '' "$A" | sed -n '51,62p'
|
|
echo -n '# 그 </tspan><tspan x="24" dy="22">분류기 팩토리를 부르는 코드: '
|
|
grep -rn 'commitFailureClassifier()' --include=*.java . | grep -v '/build/' | grep -vc 'p</tspan><tspan x="24" dy="22">ublic CommitFailureClassifier commitFailureClassifier'
|
|
echo '# 이 자동설정 클래스가 스프링 설정인가'
|
|
grep -n 'class Jp</tspan><tspan x="24" dy="22">aTransactionAutoConfiguration\|Plain construction' "$A"
|
|
echo '# 이 클래스를 쓰는 프로덕션 코드가 부르는 메서드'
|
|
grep -</tspan><tspan x="24" dy="22">rn -A2 'new JpaTransactionAutoConfiguration(' --include=*.java . | grep -v '/build/' | grep '\.' | sed 's|^\./||'
|
|
|
|
echo
|
|
</tspan><tspan x="24" dy="22">echo '# 완료 불명 예외가 만들어지는 유일한 곳과 그것을 부르는 유일한 곳'
|
|
grep -rn 'new TransactionCompletionUnknownExcep</tspan><tspan x="24" dy="22">tion' --include=*.java . | grep '/main/' | sed 's|^\./||'
|
|
grep -rn 'translateCommitFailure' --include=*.java . | grep '/</tspan><tspan x="24" dy="22">main/' | grep -v 'CommitFailureClassifier.java' | sed 's|^\./||'
|
|
echo '# 그 분류기가 프레임에서 꺼내는 값'
|
|
grep -n 'fr</tspan><tspan x="24" dy="22">ame\.map\|frame\.flatMap' "$C"
|
|
echo -n '# 단계를 읽는 접근자를 부르는 코드: '
|
|
grep -rn 'committing()' --include=*.java</tspan><tspan x="24" dy="22"> . | grep -v '/build/' | grep -vc 'public boolean committing'
|
|
|
|
echo
|
|
echo '# 조립되는 실행기는 프레임을 만든다'
|
|
grep -n -</tspan><tspan x="24" dy="22">B2 'TransactionEvidenceContext.begin' adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/per</tspan><tspan x="24" dy="22">sistence/transaction/SpringJpaTransactionExecutor.java
|
|
grep -n 'ConditionalOnBean(PlatformTransactionManager\|SpringJpaT</tspan><tspan x="24" dy="22">ransactionExecutor transactionExecutor' app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatfo</tspan><tspan x="24" dy="22">rmRuntimeAutoConfiguration.java
|
|
|
|
echo
|
|
echo '# 그 매니저의 순서를 실행하는 테스트가 있는가'
|
|
echo -n '# EvidenceAwareJpa</tspan><tspan x="24" dy="22">TransactionManagerTest 안의 그 타입 참조: '
|
|
grep -c 'EvidenceAwareJpaTransactionManager' adapter/outbound/persistence-jp</tspan><tspan x="24" dy="22">a/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/EvidenceAwareJpaTransactionManagerTest.java
|
|
grep</tspan><tspan x="24" dy="22"> -n 'The manager itself needs\|exercised end to end' adapter/outbound/persistence-jpa/src/test/java/dev/caskeleton/adapt</tspan><tspan x="24" dy="22">er/outbound/persistence/transaction/EvidenceAwareJpaTransactionManagerTest.java</tspan></text>
|
|
<text x="24" y="530" 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="552" 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:48:09+00:00 · exit 0</tspan></text>
|
|
<line x1="24" y1="566" x2="1176" y2="566" stroke="#30363d"/>
|
|
<text x="24" y="606" 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="628" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">51: /**</tspan></text>
|
|
<text x="24" y="650" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">52: * The commit-phase classifier the evidence-aware transaction manager is built with.</tspan></text>
|
|
<text x="24" y="672" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">53: *</tspan></text>
|
|
<text x="24" y="694" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">54: * <p>The manager itself is constructed inside the persistence leaf, through {@code</tspan></text>
|
|
<text x="24" y="716" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">55: * EvidenceAwareJpaTransactionManager.standard(entityManagerFactory, clock)}. The composition root</tspan></text>
|
|
<text x="24" y="738" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">56: * deliberately does not do it here: that would require {@code jakarta.persistence} and {@code</tspan></text>
|
|
<text x="24" y="760" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">57: * org.hibernate} on the composition root's compile classpath, and this repository keeps ORM types</tspan></text>
|
|
<text x="24" y="782" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">58: * inside the persistence leaf. What the root owns is the decision — whether to install the</tspan></text>
|
|
<text x="24" y="804" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">59: * platform's manager at all — and the classifier it uses.</tspan></text>
|
|
<text x="24" y="826" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">60: */</tspan></text>
|
|
<text x="24" y="848" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">61: public CommitFailureClassifier commitFailureClassifier() {</tspan></text>
|
|
<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">62: return CommitFailureClassifier.standard(clock);</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"># 그 분류기 팩토리를 부르는 코드: 0</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"># 이 자동설정 클래스가 스프링 설정인가</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">29: * <p>Plain construction rather than Spring auto-configuration: this repository's composition root</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">40:public final class JpaTransactionAutoConfiguration {</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">app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java:159: JpaTrans</tspan><tspan x="24" dy="22">actionAutoConfiguration composition = new JpaTransactionAutoConfiguration(clock);</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">app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java-160- VendorFa</tspan><tspan x="24" dy="22">ilureTranslator vendor = vendorFailures.getIfAvailable();</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">app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java-161- return v</tspan><tspan x="24" dy="22">endor == null</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">app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java:172: return n</tspan><tspan x="24" dy="22">ew JpaTransactionAutoConfiguration(clock)</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">app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java-173- .ret</tspan><tspan x="24" dy="22">ryCoordinator(</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">app-bootstrap/src/main/java/dev/caskeleton/bootstrap/autoconfigure/jpa/JpaPlatformRuntimeAutoConfiguration.java-174- </tspan><tspan x="24" dy="22">executor,</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"></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"># 완료 불명 예외가 만들어지는 유일한 곳과 그것을 부르는 유일한 곳</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">adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/CommitFailureClassifier.j</tspan><tspan x="24" dy="22">ava:97: return new TransactionCompletionUnknownException(</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">adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/EvidenceAwareJpaTransacti</tspan><tspan x="24" dy="22">onManager.java:57: throw classifier.translateCommitFailure(failure);</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"># 그 분류기가 프레임에서 꺼내는 값</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">90: frame.map(TransactionEvidenceFrame::operation).orElse(UnknownOperation.NAME);</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">92: frame.map(present -> between(present.startedAt(), now)).orElse(Duration.ZERO);</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">93: int attempt = frame.map(TransactionEvidenceFrame::attempt).orElse(1);</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">99: frame.flatMap(TransactionEvidenceFrame::reconciliationKey).orElse(null),</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"># 단계를 읽는 접근자를 부르는 코드: 0</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"></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">78- // REQUIRES_NEW transaction can no longer delete the frame belonging to the one it suspended.</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">79- try (TransactionEvidenceScope scope =</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">80: TransactionEvidenceContext.begin(operation, transactionKey, clock.instant(), attempt)) {</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">154: @ConditionalOnBean(PlatformTransactionManager.class)</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"></tspan></text>
|
|
<text x="24" y="1684" 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="1706" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0"># EvidenceAwareJpaTransactionManagerTest 안의 그 타입 참조: 1</tspan></text>
|
|
<text x="24" y="1728" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">22: * <p>The manager itself needs an {@code EntityManagerFactory}, so what is asserted here is the</tspan></text>
|
|
<text x="24" y="1750" fill="#e6edf3" font-size="14" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, monospace" xml:space="preserve"><tspan x="24" dy="0">24: * manager's own {@code doCommit} ordering is exercised end to end by the commit-ambiguity contract</tspan></text>
|
|
</svg>
|