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,6 +17,6 @@

 ## Relationships

- **주입한 지연 → 왕복 횟수만큼 누적:** 왕복마다 더해진다. Evidence: L253–L263.
+- **주입한 지연 → 왕복 횟수만큼 누적:** 왕복당 누적. Evidence: L253–L263.
 - **커넥션 풀 대기 → readiness 실패:** 프로브도 타임아웃. Evidence: L264–L273.
- **왕복 횟수만큼 누적 → 커넥션 풀 대기:** 커넥션 점유가 길어진다. Evidence: L259–L268.
+- **왕복 횟수만큼 누적 → 커넥션 풀 대기:** 커넥션 점유. Evidence: L259–L268.
@@ -13,6 +13,6 @@ n2: "커넥션 풀 대기" {
 n3: "readiness 실패" {
  shape: rectangle
 }
-n0 -> n1: "왕복마다 더해진다"
-n1 -> n2: "커넥션 점유가 길어진다"
+n0 -> n1: "왕복당 누적"
+n1 -> n2: "커넥션 점유"
 n2 -> n3: "프로브도 타임아웃"
@@ -6,7 +6,7 @@ digraph techviz {
  n1 [label="왕복 횟수만큼 누적", shape=box, style="rounded,filled"];
  n2 [label="커넥션 풀 대기", shape=box, style="rounded,filled"];
  n3 [label="readiness 실패", shape=box, style="rounded,filled"];
-  n0 -> n1 [label="왕복마다 더해진다", style=solid];
-  n1 -> n2 [label="커넥션 점유가 길어진다", style=solid];
+  n0 -> n1 [label="왕복당 누적", style=solid];
+  n1 -> n2 [label="커넥션 점유", style=solid];
  n2 -> n3 [label="프로브도 타임아웃", style=solid];
 }
@@ -17,7 +17,7 @@
        <mxCell id="n_probe" value="readiness 실패&lt;br/&gt;동시 20건 최대 22.2초" tooltip="느린 노드가 로드밸런서에서 빠진다. | Evidence: L269-L273" 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="71.5" y="561.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_i-r" value="왕복마다 더해진다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_inject" target="n_roundtrips">
+        <mxCell id="e_i-r" value="왕복당 누적" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_inject" target="n_roundtrips">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="170.5" y="179.0" as="offset"/>
          </mxGeometry>
@@ -27,7 +27,7 @@
            <mxPoint x="170.5" y="513.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_r-p" value="커넥션 점유가 길어진다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_roundtrips" target="n_pool">
+        <mxCell id="e_r-p" value="커넥션 점유" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_roundtrips" target="n_pool">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="170.5" y="346.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
    },
@@ -264,9 +264,9 @@
    {
      "id": "edge-label-r-p",
      "type": "text",
-      "x": 122.5,
+      "x": 125.5,
      "y": 334.0,
-      "width": 96,
+      "width": 90,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -292,11 +292,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "커넥션 점유가 길어진다",
+      "text": "커넥션 점유",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "커넥션 점유가 길어진다",
+      "originalText": "커넥션 점유",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "a6-latency-multiplication",
  "spec_version": "1.1",
-  "spec_sha256": "c9d669f597dc9b26d68636bb52e7239c266a8c5985c73d51c3fe0b7ebd7ff231",
+  "spec_sha256": "0b2994cb0a306f6fc1bd7fb2dae907ed79b6fe0bb6e908dba8509b0db1ca9f2b",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -5,6 +5,6 @@ flowchart TB
    n1["왕복 횟수만큼 누적"]
    n2["커넥션 풀 대기"]
    n3["readiness 실패"]
-    n0 -->|"왕복마다 더해진다"| n1
-    n1 -->|"커넥션 점유가 길어진다"| n2
+    n0 -->|"왕복당 누적"| n1
+    n1 -->|"커넥션 점유"| n2
    n2 -->|"프로브도 타임아웃"| n3
@@ -51,14 +51,14 @@
 </defs>
 <rect class="canvas" width="680" height="677" />
 <polyline class="edge kind-request style-solid emphasis-normal" points="146.5,131.0 146.5,179.0 146.5,179.0 146.5,227.0" data-evidence="253-263" />
-<rect class="edge-label-bg" x="131.3" y="165.0" width="78.3" height="22" rx="3" />
-<text class="edge-label" x="170.5" y="180.0">왕복마다 더해진다</text>
+<rect class="edge-label-bg" x="141.4" y="165.0" width="58.2" height="22" rx="3" />
+<text class="edge-label" x="170.5" y="180.0">왕복당 누적</text>
 <polyline class="edge kind-request style-solid emphasis-normal" points="146.5,465.0 146.5,513.0 146.5,513.0 146.5,561.0" data-evidence="264-273" />
 <rect class="edge-label-bg" x="131.3" y="499.0" width="78.3" height="22" rx="3" />
 <text class="edge-label" x="170.5" y="514.0">프로브도 타임아웃</text>
 <polyline class="edge kind-request style-solid emphasis-normal" points="146.5,298.0 146.5,346.0 146.5,346.0 146.5,394.0" data-evidence="259-268" />
-<rect class="edge-label-bg" x="121.3" y="332.0" width="98.4" height="22" rx="3" />
-<text class="edge-label" x="170.5" y="347.0">커넥션 점유가 길어진다</text>
+<rect class="edge-label-bg" x="141.4" y="332.0" width="58.2" height="22" rx="3" />
+<text class="edge-label" x="170.5" y="347.0">커넥션 점유</text>
 <g id="node-inject">
 <rect class="node-shape kind-process emphasis-warning role-source" data-evidence="253-258" x="71.5" y="60.0" width="150.0" height="71.0" rx="7" />
 <text class="node-label" x="146.5" y="87.0">주입한 지연</text>