Files
document-haness/docs/clean-architecture-backend-template/final/evidence/rendered/a14-f014-advanced-switches.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

118 lines
11 KiB
XML

<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="1272" viewBox="0 0 1200 1272" 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="1270" 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">$ set -e
set -o pipefail
D=$(mktemp -d); trap &#x27;rm -rf &quot;$D&quot;&#x27; EXIT
C=/shared/codebase/clean-architecture-backend-template
</tspan><tspan x="24" dy="22">M=$C/src/adapter/inbound/web
CACHE=/root/.gradle/caches/modules-2/files-2.1
java -version 2&gt;&amp;1 | grep version
cp=&quot;&quot;
whil</tspan><tspan x="24" dy="22">e IFS= read -r line; do
coord=${line%%=*}; confs=${line#*=}
case &quot;,$confs,&quot; in *&quot;,testRuntimeClasspath,&quot;*) ;; *) con</tspan><tspan x="24" dy="22">tinue ;; esac
g=${coord%%:*}; rest=${coord#*:}; n=${rest%%:*}; v=${rest##*:}
jar=$(find &quot;$CACHE/$g/$n/$v&quot; -name &#x27;*.j</tspan><tspan x="24" dy="22">ar&#x27; ! -name &#x27;*sources*&#x27; ! -name &#x27;*javadoc*&#x27; 2&gt;/dev/null | head -1) || true
[ -n &quot;$jar&quot; ] &amp;&amp; cp=&quot;$cp:$jar&quot;
done &lt; &lt;(gre</tspan><tspan x="24" dy="22">p -E &#x27;^[a-zA-Z0-9._-]+:[^=]+=&#x27; &quot;$M/gradle.lockfile&quot;)
SIB=$(find &quot;$C/src&quot; -path &#x27;*/build/libs/*+21234e38cdb9*.jar&#x27; ! -nam</tspan><tspan x="24" dy="22">e &#x27;*-testkit.jar&#x27; | sort | tr &#x27;\n&#x27; &#x27;:&#x27;)
cat &gt; &quot;$D/AdvancedSwitchProbe.java&quot; &lt;&lt;&#x27;JAVA&#x27;
import dev.caskeleton.adapter.inbou</tspan><tspan x="24" dy="22">nd.web.advanced.WebAdvancedFeature;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.ni</tspan><tspan x="24" dy="22">o.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.stream.Stre</tspan><tspan x="24" dy="22">am;
/** 열거형이 발행하는 속성 이름마다, main 소스에 그 이름을 읽는 자리가 있는지 센다. */
public final class AdvancedS</tspan><tspan x="24" dy="22">witchProbe {
private static final Path SRC = Path.of(&quot;/shared/codebase/clean-architecture-backend-template/src&quot;);
</tspan><tspan x="24" dy="22">/** main 소스 파일 전부. 시험과 빌드 산출물은 뺀다. */
private static List&lt;Path&gt; mainSources() throws IOException {
</tspan><tspan x="24" dy="22"> try (Stream&lt;Path&gt; walk = Files.walk(SRC)) {
return walk.filter(Files::isRegularFile)
.filter(p -&gt; {
</tspan><tspan x="24" dy="22"> String s = p.toString();
return s.contains(&quot;/src/main/&quot;) &amp;&amp; !s.contains(&quot;/build/&quot;)
</tspan><tspan x="24" dy="22"> &amp;&amp; (s.endsWith(&quot;.java&quot;) || s.endsWith(&quot;.yml&quot;) || s.endsWith(&quot;.yaml&quot;)
|| s.endsWith(&quot;.properties&quot;));</tspan><tspan x="24" dy="22">
})
.toList();
}
}
/** 속성 이름의 접두사까지만 읽는 조건도 세도록, .enabled 를 뗀 형태로도</tspan><tspan x="24" dy="22"> 찾는다. */
private static List&lt;String&gt; readers(List&lt;Path&gt; files, String property) throws IOException {
String pre</tspan><tspan x="24" dy="22">fix = property.endsWith(&quot;.enabled&quot;)
? property.substring(0, property.length() - &quot;.enabled&quot;.length())
: p</tspan><tspan x="24" dy="22">roperty;
List&lt;String&gt; hits = new ArrayList&lt;&gt;();
for (Path file : files) {
String text = Files.readString(f</tspan><tspan x="24" dy="22">ile, StandardCharsets.UTF_8);
if (text.contains(property) || text.contains(prefix)) {
hits.add(file.getFil</tspan><tspan x="24" dy="22">eName().toString());
}
}
return hits;
}
public static void main(String[] args) throws IOException {
</tspan><tspan x="24" dy="22"> List&lt;Path&gt; files = mainSources();
System.out.println();
System.out.printf(&quot;[열거형 상수 %d 개 · main 소스 %,</tspan><tspan x="24" dy="22">d 개를 훑는다]%n&quot;,
WebAdvancedFeature.values().length, files.size());
System.out.println();
System.out.p</tspan><tspan x="24" dy="22">rintf(&quot; %-26s %-46s %s%n&quot;, &quot;상수&quot;, &quot;발행하는 속성 이름&quot;, &quot;그 이름을 쓰는 main 파일&quot;);
int unreachable = 0;
for </tspan><tspan x="24" dy="22">(WebAdvancedFeature feature : WebAdvancedFeature.values()) {
List&lt;String&gt; hits = readers(files, feature.propertyNa</tspan><tspan x="24" dy="22">me());
if (hits.isEmpty()) {
unreachable++;
}
System.out.printf(&quot; %-26s %-46s %s%n&quot;, feature.</tspan><tspan x="24" dy="22">name(), feature.propertyName(),
hits.isEmpty() ? &quot;없음&quot; : String.join(&quot; &quot;, hits));
}
System.out.printl</tspan><tspan x="24" dy="22">n();
System.out.printf(&quot; 켤 수 없는 상수 : %d / %d%n&quot;, unreachable, WebAdvancedFeature.values().length);
}
}
JAVA</tspan><tspan x="24" dy="22">
javac -encoding UTF-8 -cp &quot;$SIB$cp&quot; -d &quot;$D/out&quot; &quot;$D/AdvancedSwitchProbe.java&quot; 2&gt;&amp;1 | head -6
java -Dstdout.encoding=UTF</tspan><tspan x="24" dy="22">-8 -cp &quot;$D/out:$SIB$cp&quot; AdvancedSwitchProbe
</tspan></text>
<text x="24" y="728" 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="750" 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-03T03:58:30+00:00 · exit 0</tspan></text>
<line x1="24" y1="764" x2="1176" y2="764" stroke="#30363d"/>
<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">openjdk version &quot;21.0.12&quot; 2026-07-21</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"></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">[열거형 상수 12 개 · main 소스 4,626 개를 훑는다]</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"></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"> 상수 발행하는 속성 이름 그 이름을 쓰는 main 파일</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"> MVC_VIRTUAL_THREADS backend.web.advanced.mvc-virtual-threads.enabled VirtualThreadSettings.java VirtualThreadMvcConfigu</tspan><tspan x="24" dy="22">ration.java</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"> WEBFLUX_BLOCKING_BRIDGE backend.web.advanced.webflux-blocking-bridge.enabled 없음</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"> JSON_MERGE_PATCH backend.web.advanced.json-merge-patch.enabled 없음</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"> JSON_PATCH backend.web.advanced.json-patch.enabled 없음</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"> SSE backend.web.advanced.sse.enabled 없음</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"> NDJSON backend.web.advanced.ndjson.enabled MvcStreamingExecutorConfiguration.java</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"> JSON_SEQUENCE backend.web.advanced.json-sequence.enabled 없음</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"> FUNCTIONAL_WEBFLUX backend.web.advanced.functional-webflux.enabled 없음</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"> CBOR backend.web.advanced.cbor.enabled 없음</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"> XML backend.web.advanced.xml.enabled 없음</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"> OPENAPI_32 backend.web.advanced.openapi-32.enabled 없음</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"> RATELIMIT_DRAFT_HEADERS backend.web.advanced.ratelimit-draft-headers.enabled 없음</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"></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"> 켤 수 없는 상수 : 10 / 12</tspan></text>
</svg>