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/a8-cache-vs-session/a8-cache-vs-session.alt.md
+22
View File
@@ -0,0 +1,22 @@
# 재시작이 지우는 것과 남기는 것
## Alternative text
재시작으로 Infinispan 캐시가 0 이 되지만 PostgreSQL 의 세션 행은 그대로 남아 refresh 가 계속 통하는 구성.
## Long description
롤링 재시작은 한 번에 한 파드씩 바꾼다. 파드가 죽으면 그 노드의 Infinispan sessions 캐시는 0 으로 초기화된다. 그러나 PostgreSQL 의 세션 행은 151개가 그대로 남았고 재시작 전에 발급한 refresh token 이 여전히 200 을 받는다. 전 구간 서비스 중단이 없었다. volatile 모드였다면 같은 재시작에서 400 Session not active 가 되어 전원 로그아웃이 된다.
## Elements and evidence
- **롤링 재시작** (process): 한 번에 한 파드씩 교체한다. Evidence: L270–L274.
- **Infinispan sessions 캐시** (component): 파드와 함께 사라진다. Evidence: L270–L278.
- **PostgreSQL 세션 행** (datastore): 재시작과 무관하다. Evidence: L270–L278.
- **재시작 전 발급한 refresh token** (component): 여전히 통한다. Evidence: L270–L278.
## Relationships
- **PostgreSQL 세션 행 → 재시작 전 발급한 refresh token:** 세션이 남아 있어 통한다. Evidence: L270–L278.
- **롤링 재시작 → Infinispan sessions 캐시:** 비운다. Evidence: L270–L278.
- **롤링 재시작 → PostgreSQL 세션 행:** 건드리지 않는다. Evidence: L270–L278.
docs/keycloak-session-store/final/assets/a8-cache-vs-session/a8-cache-vs-session.d2
+18
View File
@@ -0,0 +1,18 @@
# 재시작이 지우는 것과 남기는 것
# Question: 롤링 재시작 뒤에도 로그인이 유지되는 이유는 무엇인가
direction: down
n0: "롤링 재시작" {
shape: rectangle
}
n1: "Infinispan sessions 캐시" {
shape: rectangle
}
n2: "PostgreSQL 세션 행" {
shape: cylinder
}
n3: "재시작 전 발급한 refresh token" {
shape: rectangle
}
n0 -> n1: "비운다"
n0 -> n2: "건드리지 않는다"
n2 -> n3: "세션이 남아 있어 통한다"
docs/keycloak-session-store/final/assets/a8-cache-vs-session/a8-cache-vs-session.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="롤링 재시작", shape=box, style="rounded,filled"];
n1 [label="Infinispan sessions 캐시", shape=box, style="rounded,filled"];
n2 [label="PostgreSQL 세션 행", shape=cylinder, style="rounded,filled"];
n3 [label="재시작 전 발급한 refresh token", shape=box, style="rounded,filled"];
n0 -> n1 [label="비운다", style=solid];
n0 -> n2 [label="건드리지 않는다", style=solid];
n2 -> n3 [label="세션이 남아 있어 통한다", style=solid];
}
docs/keycloak-session-store/final/assets/a8-cache-vs-session/a8-cache-vs-session.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="a8-cache-vs-session" name="재시작이 지우는 것과 남기는 것">
<mxGraphModel dx="680" dy="556" 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_restart" value="롤링 재시작&lt;br/&gt;kubectl rollout restart" tooltip="한 번에 한 파드씩 교체한다. | Evidence: L270-L274" 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="171.5" y="60.0" width="195.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_cache" value="Infinispan sessions 캐시&lt;br/&gt;entries_unique → 0" tooltip="파드와 함께 사라진다. | Evidence: L270-L278" 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="240.0" width="188.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_db" value="PostgreSQL 세션 행&lt;br/&gt;151 → 151" tooltip="재시작과 무관하다. | Evidence: L270-L278" 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="318.0" y="227.0" width="150.0" height="97.0" as="geometry"/>
</mxCell>
<mxCell id="n_refresh" value="재시작 전 발급한 refresh token&lt;br/&gt;200" tooltip="여전히 통한다. | Evidence: L270-L278" 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="192.5" y="420.0" width="153.0" height="91.0" as="geometry"/>
</mxCell>
<mxCell id="e_db-rt" value="세션이 남아 있어 통한다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_db" target="n_refresh">
<mxGeometry relative="1" as="geometry">
<mxPoint x="331.0" y="344.0" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_r-c" value="비운다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_restart" target="n_cache">
<mxGeometry relative="1" as="geometry">
<mxPoint x="212.0" y="157.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_r-db" value="건드리지 않는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_restart" target="n_db">
<mxGeometry relative="1" as="geometry">
<mxPoint x="335.5" y="151.0" as="offset"/>
</mxGeometry>
</mxCell>
</root>
</mxGraphModel>
</diagram>
</mxfile>
docs/keycloak-session-store/final/assets/a8-cache-vs-session/a8-cache-vs-session.excalidraw
+586
View File
@@ -0,0 +1,586 @@
{
"type": "excalidraw",
"version": 2,
"source": "techviz-harness",
"elements": [
{
"id": "edge-db-rt",
"type": "arrow",
"x": 269.0,
"y": 324.0,
"width": 124.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": 214320726,
"version": 1,
"versionNonce": 1768987917,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
124.0,
0.0
],
[
124.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-db",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-refresh",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-db-rt",
"type": "text",
"x": 279.0,
"y": 332.0,
"width": 104,
"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": 273713751,
"version": 1,
"versionNonce": 286370415,
"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-r-c",
"type": "arrow",
"x": 164.0,
"y": 131.0,
"width": 96.0,
"height": 109.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": 421159370,
"version": 1,
"versionNonce": 1082378856,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
96.0,
0.0
],
[
96.0,
54.5
],
[
0.0,
54.5
],
[
0.0,
109.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-restart",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-cache",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-r-c",
"type": "text",
"x": 167.0,
"y": 145.5,
"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": 738095813,
"version": 1,
"versionNonce": 1982565255,
"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-r-db",
"type": "arrow",
"x": 278.0,
"y": 131.0,
"width": 115.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": 1542068113,
"version": 1,
"versionNonce": 611269416,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
0.0,
48.0
],
[
115.0,
48.0
],
[
115.0,
96.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-restart",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-db",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-r-db",
"type": "text",
"x": 290.5,
"y": 139.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": 953082516,
"version": 1,
"versionNonce": 1040618264,
"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-restart",
"type": "rectangle",
"x": 171.5,
"y": 60.0,
"width": 195.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": 541751545,
"version": 1,
"versionNonce": 112214280,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-restart",
"type": "text",
"x": 181.5,
"y": 70.0,
"width": 175.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": 902264258,
"version": 1,
"versionNonce": 194970368,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "롤링 재시작\nkubectl rollout restart",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "롤링 재시작\nkubectl rollout restart",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-cache",
"type": "rectangle",
"x": 70.0,
"y": 240.0,
"width": 188.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": 1479106285,
"version": 1,
"versionNonce": 377767731,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-cache",
"type": "text",
"x": 80.0,
"y": 250.0,
"width": 168.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": 1704427303,
"version": 1,
"versionNonce": 762747802,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "Infinispan sessions 캐시\nentries_unique → 0",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "Infinispan sessions 캐시\nentries_unique → 0",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-db",
"type": "rectangle",
"x": 318.0,
"y": 227.0,
"width": 150.0,
"height": 97.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#e7f5ff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 285058125,
"version": 1,
"versionNonce": 1824840415,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-db",
"type": "text",
"x": 328.0,
"y": 237.0,
"width": 130.0,
"height": 77.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": 1231096363,
"version": 1,
"versionNonce": 313576462,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "PostgreSQL 세션 행\n151 → 151",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "PostgreSQL 세션 행\n151 → 151",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-refresh",
"type": "rectangle",
"x": 192.5,
"y": 420.0,
"width": 153.0,
"height": 91.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": 1598484681,
"version": 1,
"versionNonce": 1621202109,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-refresh",
"type": "text",
"x": 202.5,
"y": 430.0,
"width": 133.0,
"height": 71.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": 794432888,
"version": 1,
"versionNonce": 204506970,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "재시작 전 발급한 refresh token\n200",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "재시작 전 발급한 refresh token\n200",
"autoResize": true,
"lineHeight": 1.25
}
],
"appState": {
"gridSize": 10,
"viewBackgroundColor": "#ffffff",
"currentItemFontFamily": 5
},
"files": {}
}
docs/keycloak-session-store/final/assets/a8-cache-vs-session/a8-cache-vs-session.manifest.json
+32
View File
@@ -0,0 +1,32 @@
{
"harness_version": "0.2.0",
"spec_id": "a8-cache-vs-session",
"spec_version": "1.1",
"spec_sha256": "60ae0f0551684a3d013de2a0eca5a41d5edf858f99511c29441388c02f7310c2",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
"anchor": {
"kind": "heading",
"value": "A-8 · 롤링 재시작 — 세션은 살아남고 캐시만 사라진다",
"line": 272
}
},
"outputs": [
"a8-cache-vs-session.svg",
"a8-cache-vs-session.mmd",
"a8-cache-vs-session.d2",
"a8-cache-vs-session.dot",
"a8-cache-vs-session.drawio",
"a8-cache-vs-session.excalidraw",
"a8-cache-vs-session.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/a8-cache-vs-session/a8-cache-vs-session.mmd
+10
View File
@@ -0,0 +1,10 @@
%% 재시작이 지우는 것과 남기는 것
%% question: 롤링 재시작 뒤에도 로그인이 유지되는 이유는 무엇인가
flowchart TB
n0["롤링 재시작"]
n1["Infinispan sessions 캐시"]
n2[("PostgreSQL 세션 행")]
n3["재시작 전 발급한 refresh token"]
n0 -->|"비운다"| n1
n0 -->|"건드리지 않는다"| n2
n2 -->|"세션이 남아 있어 통한다"| n3
docs/keycloak-session-store/final/assets/a8-cache-vs-session/a8-cache-vs-session.svg
+87
View File
@@ -0,0 +1,87 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="556" viewBox="0 0 680 556" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">재시작이 지우는 것과 남기는 것</title>
<desc id="diagram-description">롤링 재시작은 한 번에 한 파드씩 바꾼다. 파드가 죽으면 그 노드의 Infinispan sessions 캐시는 0 으로 초기화된다. 그러나 PostgreSQL 의 세션 행은 151개가 그대로 남았고 재시작 전에 발급한 refresh token 이 여전히 200 을 받는다. 전 구간 서비스 중단이 없었다. volatile 모드였다면 같은 재시작에서 400 Session not active 가 되어 전원 로그아웃이 된다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;a8-cache-vs-session&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-8 · 롤링 재시작 — 세션은 살아남고 캐시만 사라진다&quot;,&quot;line&quot;:272}},&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="556" />
<polyline class="edge kind-read style-solid emphasis-normal" points="393.0,324.0 393.0,372.0 269.0,372.0 269.0,420.0" data-evidence="270-278" />
<rect class="edge-label-bg" x="278.4" y="330.0" width="105.1" height="22" rx="3" />
<text class="edge-label" x="331.0" y="345.0">세션이 남아 있어 통한다</text>
<polyline class="edge kind-write style-solid emphasis-normal" points="260.0,131.0 260.0,185.5 164.0,185.5 164.0,240.0" data-evidence="270-278" />
<rect class="edge-label-bg" x="190.0" y="143.5" width="44.0" height="22" rx="3" />
<text class="edge-label" x="212.0" y="158.5">비운다</text>
<polyline class="edge kind-read style-solid emphasis-normal" points="278.0,131.0 278.0,179.0 393.0,179.0 393.0,227.0" data-evidence="270-278" />
<rect class="edge-label-bg" x="299.7" y="137.0" width="71.6" height="22" rx="3" />
<text class="edge-label" x="335.5" y="152.0">건드리지 않는다</text>
<g id="node-restart">
<rect class="node-shape kind-process emphasis-primary role-source" data-evidence="270-274" x="171.5" y="60.0" width="195.0" height="71.0" rx="7" />
<text class="node-label" x="269.0" y="87.0">롤링 재시작</text>
<line class="node-detail-divider" x1="185.5" y1="108.0" x2="352.5" y2="108.0" />
<text class="node-detail" x="187.5" y="125.0">kubectl rollout restart</text>
</g>
<g id="node-cache">
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="270-278" x="70.0" y="240.0" width="188.0" height="71.0" rx="7" />
<text class="node-label" x="164.0" y="267.0">Infinispan sessions 캐시</text>
<line class="node-detail-divider" x1="84.0" y1="288.0" x2="244.0" y2="288.0" />
<text class="node-detail" x="86.0" y="305.0">entries_unique → 0</text>
</g>
<g id="node-db">
<rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="270-278" x="318.0" y="240.0" width="150.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="393.0" cy="240.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 318.0 311.0 A 75.0 13.0 0 0 0 468.0 311.0" />
<text class="node-label" x="393.0" y="267.0">PostgreSQL 세션 행</text>
<line class="node-detail-divider" x1="332.0" y1="288.0" x2="454.0" y2="288.0" />
<text class="node-detail" x="334.0" y="305.0">151 → 151</text>
</g>
<g id="node-refresh">
<rect class="node-shape kind-component emphasis-primary role-target" data-evidence="270-278" x="192.5" y="420.0" width="153.0" height="91.0" rx="7" />
<text class="node-label" x="269.0" y="447.0">재시작 전 발급한 refresh</text>
<text class="node-label" x="269.0" y="465.0">token</text>
<line class="node-detail-divider" x1="206.5" y1="486.0" x2="331.5" y2="486.0" />
<text class="node-detail" x="208.5" y="503.0">200</text>
</g>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 7.2 KiB