donghyeon.kang/document-haness
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Files
fc2366087117efb0acff4bbd2e4c3d684fa7253f
document-haness/docs/clean-architecture-backend-template/final/evidence/rendered/a05-f007-transactionprofileregistry-adr.svg
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

94 lines
15 KiB
XML
Raw Blame History

<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1580" viewBox="0 0 1200 1580" 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="1578" 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">$ echo &#x27;# 사슬의 나머지가 사라진 지점&#x27;
git log --oneline -S&#x27;RetryableJpaTransactionInterceptor&#x27; -- . | cat
git show 2f5d</tspan><tspan x="24" dy="22">2fc2 --stat --oneline | grep -i &#x27;RetryableJpaTransaction&#x27;
git show 2f5d2fc2 --stat --oneline | tail -1
echo -n &#x27;# 그 </tspan><tspan x="24" dy="22">클래스가 지금 main 에 남긴 줄: &#x27;
grep -rn &#x27;RetryableJpaTransactionInterceptor&#x27; --include=*.java . | grep -c &#x27;/main/&#x27;
ec</tspan><tspan x="24" dy="22">ho
echo &#x27;# 삭제되기 직전, 그 인터셉터가 레지스트리를 어떻게 썼는가&#x27;
git show 2f5d2fc2^:src/adapter/outbound/persistence-</tspan><tspan x="24" dy="22">jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/RetryableJpaTransactionInterceptor.java \
| </tspan><tspan x="24" dy="22">grep -n &#x27;DEFAULT_ORDER =\|TransactionProfileRegistry profiles\|profiles\.require\|coordinator\.execute&#x27;
echo
echo &#x27;# 같</tspan><tspan x="24" dy="22">은 커밋이 레지스트리 javadoc 에서 애너테이션 이름만 지웠다&#x27;
git show 2f5d2fc2 -- adapter/outbound/persistence-jpa/src/ma</tspan><tspan x="24" dy="22">in/java/dev/caskeleton/adapter/outbound/persistence/transaction/TransactionProfileRegistry.java \
| grep &#x27;^[-+] \*&#x27;
e</tspan><tspan x="24" dy="22">cho
echo &#x27;# 문자열 이름을 fail-closed 로 찾는 형제는 하나뿐이다&#x27;
grep -n &#x27;public SafeSortField require(String&#x27; adapter/o</tspan><tspan x="24" dy="22">utbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/springdata/SafeSortRegistry.java
grep </tspan><tspan x="24" dy="22">-n &#x27;registry\.require(&#x27; adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/sprin</tspan><tspan x="24" dy="22">gdata/SafeSortMapper.java
echo &#x27;# 다른 둘은 키 타입이 달라 오타가 들어올 자리가 없다&#x27;
grep -n -B1 &#x27;require(GrpcChannel</tspan><tspan x="24" dy="22">ProfileName&#x27; grpc/grpc-client/src/main/java/dev/caskeleton/grpc/client/GrpcChannelRuntimeRegistry.java
grep -n -B1 &#x27;requ</tspan><tspan x="24" dy="22">ire(MongoConsistencyProfile&#x27; adapter/outbound/persistence-mongo/src/main/java/dev/caskeleton/adapter/outbound/mongo/api/</tspan><tspan x="24" dy="22">consistency/MongoConsistencyRegistry.java
echo
echo &#x27;# ADR 은 결정 절과 강제 절 양쪽에서 사라진 것을 전제한다&#x27;
grep -n </tspan><tspan x="24" dy="22">&#x27;ordered outside\|DEFAULT_ORDER&#x27; ../docs/adr/ADR-JPA-002-full-transaction-retry.md
echo -n &#x27;# DEFAULT_ORDER 가 소스 전</tspan><tspan x="24" dy="22">체에 있는 줄: &#x27;
grep -rn &#x27;DEFAULT_ORDER&#x27; --include=*.java . | wc -l
echo -n &#x27;# JPA 리프 main 에 MethodInterceptor 나 A</tspan><tspan x="24" dy="22">dvisor 가 있는 줄: &#x27;
grep -rn &#x27;MethodInterceptor\|Advisor&#x27; --include=*.java adapter/outbound/persistence-jpa/src/main | </tspan><tspan x="24" dy="22">wc -l
echo
echo &#x27;# 레지스트리를 지키는 유일한 테스트가 고정하는 것&#x27;
grep -n &#x27;Plan Task\|@DisplayName&#x27; adapter/outbound/</tspan><tspan x="24" dy="22">persistence-jpa/src/test/java/dev/caskeleton/adapter/outbound/persistence/transaction/TransactionProfileRegistryTest.jav</tspan><tspan x="24" dy="22">a</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:33:25+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">2f5d2fc2 feat: jpa, messaging, notification, mongo, graphql 어댑터터 구현체 추가</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">0e61f86e feat(jpa): implement the JPA relational persistence platform</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"> .../transaction/RetryableJpaTransaction.java | 44 -</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"> .../RetryableJpaTransactionInterceptor.java | 109 --</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"> .../RetryableJpaTransactionInterceptorTest.java | 211 ---</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"> 909 files changed, 62488 insertions(+), 6332 deletions(-)</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"># 그 클래스가 지금 main 에 남긴 줄: 0</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"></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"># 삭제되기 직전, 그 인터셉터가 레지스트리를 어떻게 썼는가</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">30: public static final int DEFAULT_ORDER = Ordered.HIGHEST_PRECEDENCE + 100;</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">41: private final TransactionProfileRegistry profiles;</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">45: FullTransactionRetryCoordinator coordinator, TransactionProfileRegistry profiles) {</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">50: FullTransactionRetryCoordinator coordinator, TransactionProfileRegistry profiles, int order) {</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">66: TransactionProfile profile = profiles.require(policy.profile());</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">69: return coordinator.execute(operation, profile, () -&gt; proceed(invocation), transactionKey);</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"># 같은 커밋이 레지스트리 javadoc 에서 애너테이션 이름만 지웠다</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">- * default would mean a typo in {@code @RetryableJpaTransaction(profile = &quot;order-wrtie&quot;)} silently</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">- * runs with someone else&#x27;s isolation, timeout, and retry budget.</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">+ * default would mean a typo in a profile name of {@code &quot;order-wrtie&quot;} silently runs with someone</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">+ * else&#x27;s isolation, timeout, and retry budget.</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"></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"># 문자열 이름을 fail-closed 로 찾는 형제는 하나뿐이다</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">77: public SafeSortField require(String publicName) {</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">65: SafeSortField field = registry.require(parts[0].trim());</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"># 다른 둘은 키 타입이 달라 오타가 들어올 자리가 없다</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">61- */</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">62: public GrpcChannelRuntime require(GrpcChannelProfileName profileName) {</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">150- /** The descriptor for a profile; every enum constant is always present. */</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">151: public MongoConsistencyDescriptor require(MongoConsistencyProfile profile) {</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"># ADR 은 결정 절과 강제 절 양쪽에서 사라진 것을 전제한다</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">16:retry advice is ordered outside Spring&#x27;s transaction advice so each attempt begins a new</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">37:`FullTransactionRetryCoordinatorTest`; `RetryableJpaTransactionInterceptor.DEFAULT_ORDER`.</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"># DEFAULT_ORDER 가 소스 전체에 있는 줄: 0</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"># JPA 리프 main 에 MethodInterceptor 나 Advisor 가 있는 줄: 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"></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"># 레지스트리를 지키는 유일한 테스트가 고정하는 것</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">11:/** Plan Task 9 — profile lookup is fail-closed (design §9.2). */</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">20: @DisplayName(&quot;a registered profile resolves&quot;)</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">27: @DisplayName(&quot;a mistyped profile name fails rather than falling back to a default&quot;)</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">35: @DisplayName(&quot;a duplicate registration is rejected&quot;)</tspan></text>
</svg>
Reference in New Issue View Git Blame Copy Permalink