donghyeon.kang/document-haness
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs(keycloak-session-store): remake all 28 diagrams through the techviz pipeline

Browse Source 
The originating repository's SVGs were drawn by hand and every one of them
put a title, a subtitle and an explanation band inside the canvas. This
repository forbids both, so they could not be carried over — the whole set
was rebuilt through the skill's pipeline instead.

Each diagram went through prepare, references, prompt, a VizSpec 1.1 citing
document line ranges, lint, and render. All 28 pass lint and produce the
same eight formats the existing keycloak project has. Sentences moved out of
the canvas into <desc> and the paragraph beside each figure; the drawings
carry names only.

Two lint rules did real work rather than formatting work:

  edge-through-node                  caught arrows crossing an unrelated
                                     node and implying an adjacency that
                                     does not exist — four diagrams had to
                                     be restructured, not just relaid out
  evidence-outside-prepared-context  caught a diagram citing another
                                     section; its anchor moved from B-0 to
                                     B-1 so all three sections it draws on
                                     are inside the prepared context

lab-topology also had to change profile: its context offers a different
candidate set, and query-fanout with shard roles is what the section
actually shows — one entry point spreading to two Keycloak nodes.

The document now carries all 28 inline, one per claim that needed one, and
the section recording what was still missing is updated: the diagram gap is
closed, Studio records remain.

verify-pipeline.py passes. audit-records.py reports no issues.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-09-05 11:03:10 +09:00
co-authored by Claude Opus 5
parent b2963105a8
commit 75bed382c8
286 changed files with 65385 additions and 710 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.alt.md
+22
View File
@@ -0,0 +1,22 @@
# 비대칭 차단은 가르지 못한다
## Alternative text
한 방향이 막혀도 반대 방향으로 연결이 성립하는 구성. 양방향을 다 막아야 두 멤버가 분리된다.
## Long description
JGroups 는 한 방향이 막혀도 열린 방향으로 재연결한다. 그래서 비대칭 차단으로는 cluster_size 가 2 로 유지된다. 양방향을 다 막으면 양쪽 모두 멤버 1개가 되지만 한쪽만 DOWN 이 된다. 코디네이터 쪽이 살아남고 분단된 쪽은 스스로 readiness 를 떨어뜨려 로드밸런서에서 빠지므로 외부 응답은 200 을 유지한다. 전면 장애 경로가 없다.
## Elements and evidence
- **keycloak-0** (service): 코디네이터. 분단돼도 살아남는다. Evidence: L226–L236.
- **막은 방향** (channel): raw 테이블 PREROUTING 에서 끊는다. Evidence: L226–L236.
- **keycloak-1** (service): 분단되면 스스로 로드밸런서에서 빠진다. Evidence: L226–L236.
- **열린 반대 방향** (channel): 비대칭 차단에서는 여기로 재연결한다. Evidence: L226–L232.
## Relationships
- **막은 방향 → keycloak-1:** 막혀서 닿지 않는다. Evidence: L226–L232.
- **keycloak-0 → 막은 방향:** JGroups 메시지. Evidence: L226–L232.
- **keycloak-1 → 열린 반대 방향:** 반대 방향으로 재연결. Evidence: L226–L232.
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.d2
+18
View File
@@ -0,0 +1,18 @@
# 비대칭 차단은 가르지 못한다
# Question: 한 방향만 막으면 클러스터가 갈라지는가
direction: down
n0: "keycloak-0" {
shape: rectangle
}
n1: "막은 방향" {
shape: rectangle
}
n2: "keycloak-1" {
shape: rectangle
}
n3: "열린 반대 방향" {
shape: rectangle
}
n0 -> n1: "JGroups 메시지"
n1 -> n2: "막혀서 닿지 않는다"
n2 -> n3: "반대 방향으로 재연결"
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.dot
+12
View File
@@ -0,0 +1,12 @@
digraph techviz {
graph [rankdir=TB, splines=ortho, nodesep=0.55, ranksep=0.85];
node [fontname=Helvetica, fontsize=11, margin="0.18,0.12", style="rounded,filled", fillcolor=white, color="#2d4357", penwidth=1.5];
edge [fontname=Helvetica, fontsize=10, color="#364b5f", penwidth=1.4, arrowsize=0.75];
n0 [label="keycloak-0", shape=box, style="rounded,filled"];
n1 [label="막은 방향", shape=box, style="rounded,filled"];
n2 [label="keycloak-1", shape=box, style="rounded,filled"];
n3 [label="열린 반대 방향", shape=box, style="rounded,filled"];
n0 -> n1 [label="JGroups 메시지", style=solid];
n1 -> n2 [label="막혀서 닿지 않는다", style=solid];
n2 -> n3 [label="반대 방향으로 재연결", style=solid];
}
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.drawio
+38
View File
@@ -0,0 +1,38 @@
<?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="a5-partition-asymmetry" name="비대칭 차단은 가르지 못한다">
<mxGraphModel dx="680" dy="677" 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_k0" value="keycloak-0&lt;br/&gt;cluster_size 1" tooltip="코디네이터. 분단돼도 살아남는다. | Evidence: L226-L236" 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="60.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_fwd" value="막은 방향&lt;br/&gt;conntrack 보다 먼저" tooltip="raw 테이블 PREROUTING 에서 끊는다. | Evidence: L226-L236" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="70.0" y="227.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_k1" value="keycloak-1&lt;br/&gt;readiness 실패" tooltip="분단되면 스스로 로드밸런서에서 빠진다. | Evidence: L226-L236" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
<mxGeometry x="70.0" y="394.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_rev" value="열린 반대 방향&lt;br/&gt;가르지 못한다" tooltip="비대칭 차단에서는 여기로 재연결한다. | Evidence: L226-L232" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
<mxGeometry x="70.0" y="561.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="e_f-k1" value="막혀서 닿지 않는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_fwd" target="n_k1">
<mxGeometry relative="1" as="geometry">
<mxPoint x="169.0" y="346.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_k0-f" value="JGroups 메시지" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_k0" target="n_fwd">
<mxGeometry relative="1" as="geometry">
<mxPoint x="169.0" y="179.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_k1-rev" value="반대 방향으로 재연결" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_k1" target="n_rev">
<mxGeometry relative="1" as="geometry">
<mxPoint x="169.0" y="513.0" as="offset"/>
</mxGeometry>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.excalidraw
+586
View File
@@ -0,0 +1,586 @@
{
"type": "excalidraw",
"version": 2,
"source": "techviz-harness",
"elements": [
{
"id": "edge-f-k1",
"type": "arrow",
"x": 145.0,
"y": 298.0,
"width": 0.0,
"height": 96.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 754052919,
"version": 1,
"versionNonce": 1393818205,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-fwd",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-k1",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-f-k1",
"type": "text",
"x": 124.0,
"y": 334.0,
"width": 90,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1611436970,
"version": 1,
"versionNonce": 1646108018,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "막혀서 닿지 않는다",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "막혀서 닿지 않는다",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-k0-f",
"type": "arrow",
"x": 145.0,
"y": 131.0,
"width": 0.0,
"height": 96.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 251939064,
"version": 1,
"versionNonce": 443740378,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-k0",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-fwd",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-k0-f",
"type": "text",
"x": 124.0,
"y": 167.0,
"width": 90,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1066092082,
"version": 1,
"versionNonce": 522159602,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "JGroups 메시지",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "JGroups 메시지",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-k1-rev",
"type": "arrow",
"x": 145.0,
"y": 465.0,
"width": 0.0,
"height": 96.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 978841079,
"version": 1,
"versionNonce": 1381835331,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-k1",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-rev",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-k1-rev",
"type": "text",
"x": 124.0,
"y": 501.0,
"width": 90,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 635184409,
"version": 1,
"versionNonce": 253961448,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "반대 방향으로 재연결",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "반대 방향으로 재연결",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-k0",
"type": "rectangle",
"x": 70.0,
"y": 60.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 772945349,
"version": 1,
"versionNonce": 30235372,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-k0",
"type": "text",
"x": 80.0,
"y": 70.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1107535317,
"version": 1,
"versionNonce": 630670490,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "keycloak-0\ncluster_size 1",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "keycloak-0\ncluster_size 1",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-fwd",
"type": "rectangle",
"x": 70.0,
"y": 227.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 535996259,
"version": 1,
"versionNonce": 1320060582,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-fwd",
"type": "text",
"x": 80.0,
"y": 237.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1947049900,
"version": 1,
"versionNonce": 493507574,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "막은 방향\nconntrack 보다 먼저",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "막은 방향\nconntrack 보다 먼저",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-k1",
"type": "rectangle",
"x": 70.0,
"y": 394.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1338591829,
"version": 1,
"versionNonce": 367320954,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-k1",
"type": "text",
"x": 80.0,
"y": 404.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1741943564,
"version": 1,
"versionNonce": 368770159,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "keycloak-1\nreadiness 실패",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "keycloak-1\nreadiness 실패",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-rev",
"type": "rectangle",
"x": 70.0,
"y": 561.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1979585501,
"version": 1,
"versionNonce": 1354430280,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-rev",
"type": "text",
"x": 80.0,
"y": 571.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 697822121,
"version": 1,
"versionNonce": 1254339695,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "열린 반대 방향\n가르지 못한다",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "열린 반대 방향\n가르지 못한다",
"autoResize": true,
"lineHeight": 1.25
}
],
"appState": {
"gridSize": 10,
"viewBackgroundColor": "#ffffff",
"currentItemFontFamily": 5
},
"files": {}
}
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.manifest.json
+32
View File
@@ -0,0 +1,32 @@
{
"harness_version": "0.2.0",
"spec_id": "a5-partition-asymmetry",
"spec_version": "1.1",
"spec_sha256": "26b2dc620b94c979befdef3808475899361f52b7f622fc06a78b5c6c59cd72a7",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
"anchor": {
"kind": "heading",
"value": "A-5 · 비대칭 분단 — 전면 장애 경로가 없다",
"line": 246
}
},
"outputs": [
"a5-partition-asymmetry.svg",
"a5-partition-asymmetry.mmd",
"a5-partition-asymmetry.d2",
"a5-partition-asymmetry.dot",
"a5-partition-asymmetry.drawio",
"a5-partition-asymmetry.excalidraw",
"a5-partition-asymmetry.alt.md"
],
"lint_issue_count": 0,
"assumption_count": 0,
"assumptions_allowed": false,
"composition_profile": "component-flow",
"reference_ids": [
"payment-event-flow"
],
"diagram_only": true
}
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.mmd
+10
View File
@@ -0,0 +1,10 @@
%% 비대칭 차단은 가르지 못한다
%% question: 한 방향만 막으면 클러스터가 갈라지는가
flowchart TB
n0["keycloak-0"]
n1["막은 방향"]
n2["keycloak-1"]
n3["열린 반대 방향"]
n0 -->|"JGroups 메시지"| n1
n1 -->|"막혀서 닿지 않는다"| n2
n2 -->|"반대 방향으로 재연결"| n3
docs/keycloak-session-store/final/assets/a5-partition-asymmetry/a5-partition-asymmetry.svg
+86
View File
@@ -0,0 +1,86 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="677" viewBox="0 0 680 677" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">비대칭 차단은 가르지 못한다</title>
<desc id="diagram-description">JGroups 는 한 방향이 막혀도 열린 방향으로 재연결한다. 그래서 비대칭 차단으로는 cluster_size 가 2 로 유지된다. 양방향을 다 막으면 양쪽 모두 멤버 1개가 되지만 한쪽만 DOWN 이 된다. 코디네이터 쪽이 살아남고 분단된 쪽은 스스로 readiness 를 떨어뜨려 로드밸런서에서 빠지므로 외부 응답은 200 을 유지한다. 전면 장애 경로가 없다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;a5-partition-asymmetry&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;A-5 · 비대칭 분단 — 전면 장애 경로가 없다&quot;,&quot;line&quot;:246}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
<defs>
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" />
</marker>
<style>
:root { color-scheme: light; }
text { font-family: Inter, Pretendard, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #111827; }
.canvas { fill: #ffffff; }
.group-box { fill: #ffffff; stroke: #9ca3af; stroke-width: 1.4; stroke-dasharray: 7 5; }
.group-label-bg { fill: #ffffff; }
.group-label { font-size: 13px; font-weight: 650; fill: #374151; }
.edge { fill: none; stroke: #374151; stroke-width: 1.8; stroke-linejoin: round; stroke-linecap: round; marker-end: url(#arrow); }
.edge.style-dashed, .edge.semantic-dashed, .edge.assumption { stroke-dasharray: 7 5; }
.edge.style-dotted { stroke-dasharray: 2 5; }
.edge.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
.edge.emphasis-muted { stroke: #9ca3af; }
.edge.emphasis-warning, .edge.kind-failure, .edge.kind-error { stroke: #dc2626; stroke-width: 2.2; }
.edge-label-bg { fill: #ffffff; }
.edge-label { font-size: 12px; font-weight: 560; text-anchor: middle; }
.node-shape { fill: #ffffff; stroke: #4b5563; stroke-width: 1.7; }
.node-shape.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
.node-shape.emphasis-muted { stroke: #9ca3af; fill: #f9fafb; }
.node-shape.emphasis-warning { stroke: #d97706; stroke-width: 2; fill: #fffdf5; }
.node-shape.kind-database, .node-shape.kind-datastore, .node-shape.kind-storage { fill: #f8fafc; }
.node-shape.kind-queue, .node-shape.kind-event, .node-shape.kind-topic { fill: #fafafa; }
.node-shape.assumption { stroke-dasharray: 4 4; }
.storage-bottom, .controller-divider { fill: none; stroke: #4b5563; stroke-width: 1.4; }
.controller-led { fill: #4b5563; }
.actor-symbol { fill: none; stroke: #4b5563; stroke-width: 1.8; stroke-linecap: round; }
.actor-symbol.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
.node-label { font-size: 14px; font-weight: 650; text-anchor: middle; }
.node-role { font-size: 10px; letter-spacing: 0.04em; text-anchor: middle; fill: #6b7280; }
.node-detail-divider { stroke: #d1d5db; stroke-width: 1; }
.node-detail { font-size: 11px; fill: #374151; }
.assumption-badge { font-size: 9px; font-weight: 700; fill: #92400e; }
.failure-mark { stroke: #dc2626; stroke-width: 4; stroke-linecap: round; }
.lifeline { stroke: #9ca3af; stroke-width: 1.2; stroke-dasharray: 5 5; }
.timeline-axis { stroke: #374151; stroke-width: 1.8; marker-end: url(#arrow); }
.timeline-stem { stroke: #6b7280; stroke-width: 1.3; }
.timeline-marker { fill: #ffffff; stroke: #374151; stroke-width: 1.7; }
.timeline-marker.primary { fill: #2563eb; stroke: #2563eb; }
.timeline-marker.warning { fill: #dc2626; stroke: #dc2626; }
.timeline-label { font-size: 13px; font-weight: 650; text-anchor: middle; }
.timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
</style>
</defs>
<rect class="canvas" width="680" height="677" />
<polyline class="edge kind-blocked style-solid emphasis-normal" points="145.0,298.0 145.0,346.0 145.0,346.0 145.0,394.0" data-evidence="226-232" />
<rect class="edge-label-bg" x="126.5" y="332.0" width="85.0" height="22" rx="3" />
<text class="edge-label" x="169.0" y="347.0">막혀서 닿지 않는다</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="145.0,131.0 145.0,179.0 145.0,179.0 145.0,227.0" data-evidence="226-232" />
<rect class="edge-label-bg" x="123.2" y="165.0" width="91.7" height="22" rx="3" />
<text class="edge-label" x="169.0" y="180.0">JGroups 메시지</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="145.0,465.0 145.0,513.0 145.0,513.0 145.0,561.0" data-evidence="226-232" />
<rect class="edge-label-bg" x="123.2" y="499.0" width="91.7" height="22" rx="3" />
<text class="edge-label" x="169.0" y="514.0">반대 방향으로 재연결</text>
<g id="node-k0">
<rect class="node-shape kind-service emphasis-primary role-source" data-evidence="226-236" x="70.0" y="60.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="87.0">keycloak-0</text>
<line class="node-detail-divider" x1="84.0" y1="108.0" x2="206.0" y2="108.0" />
<text class="node-detail" x="86.0" y="125.0">cluster_size 1</text>
</g>
<g id="node-fwd">
<rect class="node-shape kind-channel emphasis-warning role-control" data-evidence="226-236" x="70.0" y="227.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="254.0">막은 방향</text>
<line class="node-detail-divider" x1="84.0" y1="275.0" x2="206.0" y2="275.0" />
<text class="node-detail" x="86.0" y="292.0">conntrack 보다 먼저</text>
</g>
<g id="node-k1">
<rect class="node-shape kind-service emphasis-normal role-target" data-evidence="226-236" x="70.0" y="394.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="421.0">keycloak-1</text>
<line class="node-detail-divider" x1="84.0" y1="442.0" x2="206.0" y2="442.0" />
<text class="node-detail" x="86.0" y="459.0">readiness 실패</text>
</g>
<g id="node-rev">
<rect class="node-shape kind-channel emphasis-normal role-support" data-evidence="226-232" x="70.0" y="561.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="588.0">열린 반대 방향</text>
<line class="node-detail-divider" x1="84.0" y1="609.0" x2="206.0" y2="609.0" />
<text class="node-detail" x="86.0" y="626.0">가르지 못한다</text>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 6.9 KiB