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>
This commit is contained in:
co-authored by
Claude Opus 5
parent
43bccd08a8
commit
b2963105a8
+117
@@ -0,0 +1,117 @@
|
||||
<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 'rm -rf "$D"' 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>&1 | grep version
|
||||
cp=""
|
||||
whil</tspan><tspan x="24" dy="22">e IFS= read -r line; do
|
||||
coord=${line%%=*}; confs=${line#*=}
|
||||
case ",$confs," in *",testRuntimeClasspath,"*) ;; *) con</tspan><tspan x="24" dy="22">tinue ;; esac
|
||||
g=${coord%%:*}; rest=${coord#*:}; n=${rest%%:*}; v=${rest##*:}
|
||||
jar=$(find "$CACHE/$g/$n/$v" -name '*.j</tspan><tspan x="24" dy="22">ar' ! -name '*sources*' ! -name '*javadoc*' 2>/dev/null | head -1) || true
|
||||
[ -n "$jar" ] && cp="$cp:$jar"
|
||||
done < <(gre</tspan><tspan x="24" dy="22">p -E '^[a-zA-Z0-9._-]+:[^=]+=' "$M/gradle.lockfile")
|
||||
SIB=$(find "$C/src" -path '*/build/libs/*+21234e38cdb9*.jar' ! -nam</tspan><tspan x="24" dy="22">e '*-testkit.jar' | sort | tr '\n' ':')
|
||||
cat > "$D/AdvancedSwitchProbe.java" <<'JAVA'
|
||||
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("/shared/codebase/clean-architecture-backend-template/src");
|
||||
|
||||
</tspan><tspan x="24" dy="22">/** main 소스 파일 전부. 시험과 빌드 산출물은 뺀다. */
|
||||
private static List<Path> mainSources() throws IOException {
|
||||
</tspan><tspan x="24" dy="22"> try (Stream<Path> walk = Files.walk(SRC)) {
|
||||
return walk.filter(Files::isRegularFile)
|
||||
.filter(p -> {
|
||||
</tspan><tspan x="24" dy="22"> String s = p.toString();
|
||||
return s.contains("/src/main/") && !s.contains("/build/")
|
||||
</tspan><tspan x="24" dy="22"> && (s.endsWith(".java") || s.endsWith(".yml") || s.endsWith(".yaml")
|
||||
|| s.endsWith(".properties"));</tspan><tspan x="24" dy="22">
|
||||
})
|
||||
.toList();
|
||||
}
|
||||
}
|
||||
|
||||
/** 속성 이름의 접두사까지만 읽는 조건도 세도록, .enabled 를 뗀 형태로도</tspan><tspan x="24" dy="22"> 찾는다. */
|
||||
private static List<String> readers(List<Path> files, String property) throws IOException {
|
||||
String pre</tspan><tspan x="24" dy="22">fix = property.endsWith(".enabled")
|
||||
? property.substring(0, property.length() - ".enabled".length())
|
||||
: p</tspan><tspan x="24" dy="22">roperty;
|
||||
List<String> hits = new ArrayList<>();
|
||||
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<Path> files = mainSources();
|
||||
System.out.println();
|
||||
System.out.printf("[열거형 상수 %d 개 · main 소스 %,</tspan><tspan x="24" dy="22">d 개를 훑는다]%n",
|
||||
WebAdvancedFeature.values().length, files.size());
|
||||
System.out.println();
|
||||
System.out.p</tspan><tspan x="24" dy="22">rintf(" %-26s %-46s %s%n", "상수", "발행하는 속성 이름", "그 이름을 쓰는 main 파일");
|
||||
int unreachable = 0;
|
||||
for </tspan><tspan x="24" dy="22">(WebAdvancedFeature feature : WebAdvancedFeature.values()) {
|
||||
List<String> hits = readers(files, feature.propertyNa</tspan><tspan x="24" dy="22">me());
|
||||
if (hits.isEmpty()) {
|
||||
unreachable++;
|
||||
}
|
||||
System.out.printf(" %-26s %-46s %s%n", feature.</tspan><tspan x="24" dy="22">name(), feature.propertyName(),
|
||||
hits.isEmpty() ? "없음" : String.join(" ", hits));
|
||||
}
|
||||
System.out.printl</tspan><tspan x="24" dy="22">n();
|
||||
System.out.printf(" 켤 수 없는 상수 : %d / %d%n", unreachable, WebAdvancedFeature.values().length);
|
||||
}
|
||||
}
|
||||
JAVA</tspan><tspan x="24" dy="22">
|
||||
javac -encoding UTF-8 -cp "$SIB$cp" -d "$D/out" "$D/AdvancedSwitchProbe.java" 2>&1 | head -6
|
||||
java -Dstdout.encoding=UTF</tspan><tspan x="24" dy="22">-8 -cp "$D/out:$SIB$cp" 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 "21.0.12" 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>
|
||||
|
After Width: | Height: | Size: 11 KiB |
Reference in New Issue
Block a user