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
@@ -18,5 +18,5 @@ revokeRefreshToken 을 켜고 refreshTokenMaxReuse 를 0 으로 둔 상태에서
 ## Relationships

 - **동시 refresh 5건 → 회전 검사:** 동시 도착. Evidence: L369–L377.
- **client session → 이긴 요청의 새 토큰:** 세션이 없으니 못 쓴다. Evidence: L378–L384.
+- **client session → 이긴 요청의 새 토큰:** 사용 불가. Evidence: L378–L384.
 - **회전 검사 → client session:** 경쟁 감지 시 삭제. Evidence: L378–L384.
@@ -15,4 +15,4 @@ n3: "이긴 요청의 새 토큰" {
 }
 n0 -> n1: "동시 도착"
 n1 -> n2: "경쟁 감지 시 삭제"
-n2 -> n3: "세션이 없으니 못 쓴다"
+n2 -> n3: "사용 불가"
@@ -8,5 +8,5 @@ digraph techviz {
  n3 [label="이긴 요청의 새 토큰", shape=box, style="rounded,filled"];
  n0 -> n1 [label="동시 도착", style=solid];
  n1 -> n2 [label="경쟁 감지 시 삭제", style=solid];
-  n2 -> n3 [label="세션이 없으니 못 쓴다", style=solid];
+  n2 -> n3 [label="사용 불가", style=solid];
 }
@@ -5,8 +5,8 @@
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
-        <mxCell id="n_concurrent" value="동시 refresh 5건&lt;br/&gt;&amp; 와 wait 이 없으면 재현되지 않는다" tooltip="같은 refresh token 을 쓴다. | Evidence: L369-L375" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;dashed=1;fillColor=#f5f7fa;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
-          <mxGeometry x="135.0" y="60.0" width="170.0" height="84.0" as="geometry"/>
+        <mxCell id="n_concurrent" value="동시 refresh 5건&lt;br/&gt;&amp; + wait 필요" tooltip="같은 refresh token 을 쓴다. | Evidence: L369-L375" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;dashed=1;fillColor=#f5f7fa;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
+          <mxGeometry x="145.0" y="60.0" width="150.0" height="84.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_rotation" value="회전 검사&lt;br/&gt;revokeRefreshToken=true · refreshTokenMaxReuse=0" tooltip="이미 쓴 토큰인지 본다. | Evidence: L369-L377" 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="300.0" height="71.0" as="geometry"/>
@@ -22,7 +22,7 @@
            <mxPoint x="244.0" y="192.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_cs-nt" value="세션이 없으니 못 쓴다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_client-session" target="n_new-token">
+        <mxCell id="e_cs-nt" value="사용 불가" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_client-session" target="n_new-token">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="244.0" y="519.0" as="offset"/>
          </mxGeometry>
@@ -165,9 +165,9 @@
    {
      "id": "edge-label-cs-nt",
      "type": "text",
-      "x": 196.0,
+      "x": 199.0,
      "y": 507.0,
-      "width": 96,
+      "width": 90,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -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
    },
@@ -303,9 +303,9 @@
    {
      "id": "node-concurrent",
      "type": "rectangle",
-      "x": 135.0,
+      "x": 145.0,
      "y": 60.0,
-      "width": 170.0,
+      "width": 150.0,
      "height": 84.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -333,9 +333,9 @@
    {
      "id": "node-label-concurrent",
      "type": "text",
-      "x": 145.0,
+      "x": 155.0,
      "y": 70.0,
-      "width": 150.0,
+      "width": 130.0,
      "height": 64.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -361,11 +361,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "동시 refresh 5건\n& 와 wait 이 없으면 재현되지 않는다",
+      "text": "동시 refresh 5건\n& + wait 필요",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "동시 refresh 5건\n& 와 wait 이 없으면 재현되지 않는다",
+      "originalText": "동시 refresh 5건\n& + wait 필요",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "b3-rotation-contention",
  "spec_version": "1.1",
-  "spec_sha256": "3fbbe8b3528bbcc2ad23e48a820e9ddc6fe6072857bfbe2fa3df0e566fe99162",
+  "spec_sha256": "31779474e5400d5e719faf81a62da35a657994d952e4e0324a1c76c5d18183e4",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -7,6 +7,6 @@ flowchart TB
    n3["이긴 요청의 새 토큰"]
    n0 -->|"동시 도착"| n1
    n1 -->|"경쟁 감지 시 삭제"| n2
-    n2 -->|"세션이 없으니 못 쓴다"| n3
+    n2 -->|"사용 불가"| n3
    classDef external stroke-dasharray: 6 4
    class n0 external
@@ -54,8 +54,8 @@
 <rect class="edge-label-bg" x="218.2" y="178.0" width="51.5" height="22" rx="3" />
 <text class="edge-label" x="244.0" y="193.0">동시 도착</text>
 <polyline class="edge kind-blocked style-solid emphasis-normal" points="220.0,471.0 220.0,519.0 220.0,519.0 220.0,567.0" data-evidence="378-384" />
-<rect class="edge-label-bg" x="194.8" y="505.0" width="98.4" height="22" rx="3" />
-<text class="edge-label" x="244.0" y="520.0">세션이 없으니 못 쓴다</text>
+<rect class="edge-label-bg" x="218.2" y="505.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="244.0" y="520.0">사용 불가</text>
 <polyline class="edge kind-blocked style-solid emphasis-normal" points="220.0,311.0 220.0,359.0 220.0,359.0 220.0,407.0" data-evidence="378-384" />
 <rect class="edge-label-bg" x="201.5" y="345.0" width="85.0" height="22" rx="3" />
 <text class="edge-label" x="244.0" y="360.0">경쟁 감지 시 삭제</text>