docs(keycloak-session-store): take the sentences out of the diagram canvases

The skill says drawings carry names and sentences go in <desc> and the paragraph beside the figure. I put sentences in node details and edge labels instead, and 27 of the 28 diagrams shipped with prose inside the canvas — "예측 다섯 개가 틀렸다", "아홉 번 조용히 실패했다", "막혀서 닿지 않는다". Only label and details render on the canvas; description does not. So every sentence moved to a noun phrase and the meaning stays in description, which was already carrying it. 막혀서 닿지 않는다 -> 차단 아홉 번 조용히 실패했다 -> 조용한 실패 9건 예측 다섯 개가 틀렸다 -> 틀린 예측 5건 로그아웃이 정리하지 않는다 -> 로그아웃 미정리 볼륨이 없으면 여기까지다 -> 볼륨 없음 Three node labels were sentences too and became names: 세션 스냅샷, 예측 선기록, 대조군 확보. What stays is what the rules protect — identifiers, commands and measured values: PRIMARY KEY (client_registration_id, principal_name), ValidationFailedException: 1 changesets check sum, nginx -t && nginx -s reload, SET LOCAL synchronous_commit TO OFF. Those are names of things, not prose about them. 294 canvas strings across 28 diagrams, none matching a sentence ending, average 11 characters. All 28 still lint clean and re-rendered. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 11:50:33 +09:00
parent 75bed382c8
commit 95c0e680b5
221 changed files with 1156 additions and 1152 deletions
@@ -17,5 +17,5 @@ Keycloak 26 은 persistent-user-sessions 가 기본값이라 세션을 PostgreSQ

 ## Relationships

- **persistent-user-sessions 켜짐 → PostgreSQL 의 세션 행:** 세션을 여기 쓴다. Evidence: L62–L68.
- **persistent-user-sessions 꺼짐 → 노드 메모리의 세션:** 세션이 여기 있다. Evidence: L62–L68.
+- **persistent-user-sessions 켜짐 → PostgreSQL 의 세션 행:** 세션 기록. Evidence: L62–L68.
+- **persistent-user-sessions 꺼짐 → 노드 메모리의 세션:** 세션 보관. Evidence: L62–L68.
@@ -13,5 +13,5 @@ n2: "PostgreSQL 의 세션 행" {
 n3: "노드 메모리의 세션" {
  shape: rectangle
 }
-n0 -> n2: "세션을 여기 쓴다"
-n1 -> n3: "세션이 여기 있다"
+n0 -> n2: "세션 기록"
+n1 -> n3: "세션 보관"
@@ -6,6 +6,6 @@ digraph techviz {
  n1 [label="persistent-user-sessions 꺼짐", shape=box, style="rounded,filled"];
  n2 [label="PostgreSQL 의 세션 행", shape=cylinder, style="rounded,filled"];
  n3 [label="노드 메모리의 세션", shape=box, style="rounded,filled"];
-  n0 -> n2 [label="세션을 여기 쓴다", style=solid];
-  n1 -> n3 [label="세션이 여기 있다", style=solid];
+  n0 -> n2 [label="세션 기록", style=solid];
+  n1 -> n3 [label="세션 보관", style=solid];
 }
@@ -5,10 +5,10 @@
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
-        <mxCell id="n_persistent" value="persistent-user-sessions 켜짐&lt;br/&gt;세션을 DB 에 쓴다" tooltip="Keycloak 26 기본값. | Evidence: L62-L66" 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">
+        <mxCell id="n_persistent" value="persistent-user-sessions 켜짐&lt;br/&gt;세션 → DB" tooltip="Keycloak 26 기본값. | Evidence: L62-L66" 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="202.0" height="91.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_volatile" value="persistent-user-sessions 꺼짐&lt;br/&gt;세션이 메모리에만 있다" tooltip="24 이전 방식. | Evidence: L62-L66" 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">
+        <mxCell id="n_volatile" value="persistent-user-sessions 꺼짐&lt;br/&gt;세션 → 메모리" tooltip="24 이전 방식. | Evidence: L62-L66" 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="223.0" width="202.0" height="91.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_db-session" value="PostgreSQL 의 세션 행&lt;br/&gt;OFFLINE_USER_SESSION" tooltip="노드가 바뀌어도 남는다. 7800 과 무관하다. | Evidence: L67-L73" 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">
@@ -17,12 +17,12 @@
        <mxCell id="n_memory-session" value="노드 메모리의 세션&lt;br/&gt;Infinispan 복제에 의존" tooltip="노드가 죽거나 분단되면 사라진다. | Evidence: L67-L73" 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="442.5" y="236.0" width="153.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_p-to-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_persistent" target="n_db-session">
+        <mxCell id="e_p-to-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_persistent" target="n_db-session">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="376.0" y="110.5" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_v-to-mem" value="세션이 여기 있다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_volatile" target="n_memory-session">
+        <mxCell id="e_v-to-mem" value="세션 보관" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_volatile" target="n_memory-session">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="381.2" y="270.0" as="offset"/>
          </mxGeometry>
@@ -94,11 +94,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "세션을 여기 쓴다",
+      "text": "세션 기록",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "세션을 여기 쓴다",
+      "originalText": "세션 기록",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -193,11 +193,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "세션이 여기 있다",
+      "text": "세션 보관",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "세션이 여기 있다",
+      "originalText": "세션 보관",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -262,11 +262,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "persistent-user-sessions 켜짐\n세션을 DB 에 쓴다",
+      "text": "persistent-user-sessions 켜짐\n세션 → DB",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "persistent-user-sessions 켜짐\n세션을 DB 에 쓴다",
+      "originalText": "persistent-user-sessions 켜짐\n세션 → DB",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -331,11 +331,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "persistent-user-sessions 꺼짐\n세션이 메모리에만 있다",
+      "text": "persistent-user-sessions 꺼짐\n세션 → 메모리",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "persistent-user-sessions 꺼짐\n세션이 메모리에만 있다",
+      "originalText": "persistent-user-sessions 꺼짐\n세션 → 메모리",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "version-conditional-results",
  "spec_version": "1.1",
-  "spec_sha256": "67137c09f1217d0e2141e8f560c3c6970821cd2a4f5a91591f3729281ab55c04",
+  "spec_sha256": "24fe5d934211da9916c42d3db966c04559e51956a550964296655cbced280750",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -5,5 +5,5 @@ flowchart LR
    n1["persistent-user-sessions 꺼짐"]
    n2[("PostgreSQL 의 세션 행")]
    n3["노드 메모리의 세션"]
-    n0 -->|"세션을 여기 쓴다"| n2
-    n1 -->|"세션이 여기 있다"| n3
+    n0 -->|"세션 기록"| n2
+    n1 -->|"세션 보관"| n3
@@ -51,24 +51,24 @@
 </defs>
 <rect class="canvas" width="680" height="359" />
 <polyline class="edge kind-write style-solid emphasis-normal" points="272.0,105.5 352.0,105.5 352.0,115.5 432.0,115.5" data-evidence="62-68" />
-<rect class="edge-label-bg" x="336.9" y="96.5" width="78.3" height="22" rx="3" />
-<text class="edge-label" x="376.0" y="111.5">세션을 여기 쓴다</text>
+<rect class="edge-label-bg" x="350.2" y="96.5" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="376.0" y="111.5">세션 기록</text>
 <polyline class="edge kind-write style-solid emphasis-normal" points="272.0,268.5 357.2,268.5 357.2,271.5 442.5,271.5" data-evidence="62-68" />
-<rect class="edge-label-bg" x="342.1" y="256.0" width="78.3" height="22" rx="3" />
-<text class="edge-label" x="381.2" y="271.0">세션이 여기 있다</text>
+<rect class="edge-label-bg" x="355.5" y="256.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="381.2" y="271.0">세션 보관</text>
 <g id="node-persistent">
 <rect class="node-shape kind-component emphasis-primary role-source" data-evidence="62-66" x="70.0" y="60.0" width="202.0" height="91.0" rx="7" />
 <text class="node-label" x="171.0" y="87.0">persistent-user-sessions</text>
 <text class="node-label" x="171.0" y="105.0">켜짐</text>
 <line class="node-detail-divider" x1="84.0" y1="126.0" x2="258.0" y2="126.0" />
-<text class="node-detail" x="86.0" y="143.0">세션을 DB 에 쓴다</text>
+<text class="node-detail" x="86.0" y="143.0">세션 → DB</text>
 </g>
 <g id="node-volatile">
 <rect class="node-shape kind-component emphasis-warning role-source" data-evidence="62-66" x="70.0" y="223.0" width="202.0" height="91.0" rx="7" />
 <text class="node-label" x="171.0" y="250.0">persistent-user-sessions</text>
 <text class="node-label" x="171.0" y="268.0">꺼짐</text>
 <line class="node-detail-divider" x1="84.0" y1="289.0" x2="258.0" y2="289.0" />
-<text class="node-detail" x="86.0" y="306.0">세션이 메모리에만 있다</text>
+<text class="node-detail" x="86.0" y="306.0">세션 → 메모리</text>
 </g>
 <g id="node-db-session">
 <rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="67-73" x="432.0" y="80.0" width="174.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="519.0" cy="80.0" rx="87.0" ry="13.0" /><path class="storage-bottom" d="M 432.0 151.0 A 87.0 13.0 0 0 0 606.0 151.0" />