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 @@ Keycloak 26 미만이면 persistent-user-sessions 가 기본이 아니라 A층

 ## Relationships

- **캐시 온도 → 인스턴스 수:** 그 다음. Evidence: L684–L694.
- **인스턴스 수 → 시계 동기:** 수치를 읽을 때. Evidence: L684–L696.
- **Keycloak 버전 → 캐시 온도:** 버전이 먼저다. Evidence: L684–L690.
+- **캐시 온도 → 인스턴스 수:** 다음 조건. Evidence: L684–L694.
+- **인스턴스 수 → 시계 동기:** 수치 해석. Evidence: L684–L696.
+- **Keycloak 버전 → 캐시 온도:** 선행 조건. Evidence: L684–L690.
@@ -13,6 +13,6 @@ n2: "인스턴스 수" {
 n3: "시계 동기" {
  shape: rectangle
 }
-n0 -> n1: "버전이 먼저다"
-n1 -> n2: "그 다음"
-n2 -> n3: "수치를 읽을 때"
+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="시계 동기", shape=box, style="rounded,filled"];
-  n0 -> n1 [label="버전이 먼저다", style=solid];
-  n1 -> n2 [label="그 다음", style=solid];
-  n2 -> n3 [label="수치를 읽을 때", style=solid];
+  n0 -> n1 [label="선행 조건", style=solid];
+  n1 -> n2 [label="다음 조건", style=solid];
+  n2 -> n3 [label="수치 해석", style=solid];
 }
@@ -5,7 +5,7 @@
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
-        <mxCell id="n_version" value="Keycloak 버전&lt;br/&gt;A층 결론 중 셋이 뒤집힌다" tooltip="26 미만이면 세션의 거처가 다르다. | Evidence: L684-L690" 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_version" value="Keycloak 버전&lt;br/&gt;A층 결론 3건 반전" tooltip="26 미만이면 세션의 거처가 다르다. | Evidence: L684-L690" 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="60.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_cache" value="캐시 온도&lt;br/&gt;400 · 500 · 200" tooltip="volatile 에서 DB 정지 시의 동작을 가른다. | Evidence: L684-L692" 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">
@@ -17,17 +17,17 @@
        <mxCell id="n_clock" value="시계 동기&lt;br/&gt;NTP 미동기 환경" tooltip="이 수치들은 106초 보정을 거친 값이다. | Evidence: L684-L696" 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="554.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_c-i" value="그 다음" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_cache" target="n_instances">
+        <mxCell id="e_c-i" value="다음 조건" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_cache" target="n_instances">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="169.0" y="346.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_i-cl" value="수치를 읽을 때" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_instances" target="n_clock">
+        <mxCell id="e_i-cl" value="수치 해석" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_instances" target="n_clock">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="169.0" y="506.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_v-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_version" target="n_cache">
+        <mxCell id="e_v-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_version" target="n_cache">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="169.0" y="179.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
    },
@@ -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
    },
@@ -361,11 +361,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "Keycloak 버전\nA층 결론 중 셋이 뒤집힌다",
+      "text": "Keycloak 버전\nA층 결론 3건 반전",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "Keycloak 버전\nA층 결론 중 셋이 뒤집힌다",
+      "originalText": "Keycloak 버전\nA층 결론 3건 반전",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "not-applicable-conditions",
  "spec_version": "1.1",
-  "spec_sha256": "781e50387d9e0accfe0ae33366bc7c2352438b31646900d1b1bfa81f4a8dd9e6",
+  "spec_sha256": "5f448f0fb937c134f7e4980085db426a78f33ef1efff5bff13d824f62a093ef3",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -5,6 +5,6 @@ flowchart TB
    n1["캐시 온도"]
    n2["인스턴스 수"]
    n3["시계 동기"]
-    n0 -->|"버전이 먼저다"| n1
-    n1 -->|"그 다음"| n2
-    n2 -->|"수치를 읽을 때"| n3
+    n0 -->|"선행 조건"| n1
+    n1 -->|"다음 조건"| n2
+    n2 -->|"수치 해석"| n3
@@ -51,19 +51,19 @@
 </defs>
 <rect class="canvas" width="680" height="670" />
 <polyline class="edge kind-request style-solid emphasis-normal" points="145.0,298.0 145.0,346.0 145.0,346.0 145.0,394.0" data-evidence="684-694" />
-<rect class="edge-label-bg" x="146.6" y="332.0" width="44.8" height="22" rx="3" />
-<text class="edge-label" x="169.0" y="347.0">그 다음</text>
+<rect class="edge-label-bg" x="143.2" y="332.0" width="51.5" 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,458.0 145.0,506.0 145.0,506.0 145.0,554.0" data-evidence="684-696" />
-<rect class="edge-label-bg" x="133.2" y="492.0" width="71.6" height="22" rx="3" />
-<text class="edge-label" x="169.0" y="507.0">수치를 읽을 때</text>
+<rect class="edge-label-bg" x="143.2" y="492.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="169.0" y="507.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="684-690" />
-<rect class="edge-label-bg" x="136.6" y="165.0" width="64.9" height="22" rx="3" />
-<text class="edge-label" x="169.0" y="180.0">버전이 먼저다</text>
+<rect class="edge-label-bg" x="143.2" y="165.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="169.0" y="180.0">선행 조건</text>
 <g id="node-version">
 <rect class="node-shape kind-component emphasis-warning role-source" data-evidence="684-690" 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 버전</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">A층 결론 중 셋이 뒤집힌다</text>
+<text class="node-detail" x="86.0" y="125.0">A층 결론 3건 반전</text>
 </g>
 <g id="node-cache">
 <rect class="node-shape kind-component emphasis-warning role-control" data-evidence="684-692" x="70.0" y="227.0" width="150.0" height="71.0" rx="7" />