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>
44 lines
4.3 KiB
XML
44 lines
4.3 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<mxfile host="app.diagrams.net" modified="2026-07-23T00:00:00.000Z" agent="techviz-harness" version="24.7.17" type="device">
|
|
<diagram id="session-sharing-path" name="세션 공유가 실제로 지나는 경로">
|
|
<mxGraphModel dx="680" dy="364" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
|
|
<root>
|
|
<mxCell id="0"/>
|
|
<mxCell id="1" parent="0"/>
|
|
<mxCell id="n_keycloak-0" value="keycloak-0<br/>자기가 처리한 로그인만 캐시" tooltip="로그인을 처리하고 자기 sessions 캐시에만 엔트리를 남긴다. | Evidence: L49-L51" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
|
<mxGeometry x="92.5" y="82.5" width="150.0" height="71.0" as="geometry"/>
|
|
</mxCell>
|
|
<mxCell id="n_keycloak-1" value="keycloak-1<br/>refresh 요청을 받으면 DB 를 조회" tooltip="다른 노드가 만든 세션을 캐시로 받지 않고 데이터베이스에서 읽는다. | Evidence: L48-L51" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
|
<mxGeometry x="70.0" y="225.5" width="195.0" height="71.0" as="geometry"/>
|
|
</mxCell>
|
|
<mxCell id="n_jgroups-ping" value="JGROUPS_PING" tooltip="노드가 서로를 발견하는 자리. 여기 등록되어 있다는 것과 세션이 복제된다는 것은 다른 사건이다. | Evidence: L44-L46" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;strokeColor=#9ca3af;fillColor=#f9fafb;" vertex="1" parent="1">
|
|
<mxGeometry x="454.5" y="60.0" width="150.0" height="90.0" as="geometry"/>
|
|
</mxCell>
|
|
<mxCell id="n_postgres" value="PostgreSQL<br/>offline_flag='0' 이 온라인 세션" tooltip="OFFLINE_USER_SESSION 에 세션 행을 보관한다. 두 노드가 같은 행을 본다. | Evidence: L48-L52" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;shape=cylinder3;boundedLbl=1;backgroundOutline=1;fillColor=#eef6fb;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
|
<mxGeometry x="425.0" y="222.0" width="209.0" height="97.0" as="geometry"/>
|
|
</mxCell>
|
|
<mxCell id="e_k0-discovery" value="멤버 등록" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-0" target="n_jgroups-ping">
|
|
<mxGeometry relative="1" as="geometry">
|
|
<mxPoint x="372.5" y="102.5" as="offset"/>
|
|
</mxGeometry>
|
|
</mxCell>
|
|
<mxCell id="e_k0-writes" value="세션 INSERT" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-0" target="n_postgres">
|
|
<mxGeometry relative="1" as="geometry">
|
|
<mxPoint x="357.8" y="194.2" as="offset"/>
|
|
</mxGeometry>
|
|
</mxCell>
|
|
<mxCell id="e_k1-discovery" value="멤버 등록" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-1" target="n_jgroups-ping">
|
|
<mxGeometry relative="1" as="geometry">
|
|
<mxPoint x="383.8" y="183.0" as="offset"/>
|
|
</mxGeometry>
|
|
</mxCell>
|
|
<mxCell id="e_k1-reads" value="세션 SELECT" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_keycloak-1" target="n_postgres">
|
|
<mxGeometry relative="1" as="geometry">
|
|
<mxPoint x="369.0" y="274.8" as="offset"/>
|
|
</mxGeometry>
|
|
</mxCell>
|
|
</root>
|
|
</mxGraphModel>
|
|
</diagram>
|
|
</mxfile>
|