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 @@ volatile 모드에서 로그인은 SQL 을 0개 쏜다. refresh 는 딱 한 문

 ## Relationships

- **CLIENT 조회 → CLIENT_SCOPE_CLIENT 조회:** refresh 는 스코프도 다시 계산한다. Evidence: L284–L292.
+- **CLIENT 조회 → CLIENT_SCOPE_CLIENT 조회:** 스코프 재계산. Evidence: L284–L292.
 - **로그인 · refresh 요청 → CLIENT 조회:** 클라이언트 확인. Evidence: L306–L312.
- **CLIENT_SCOPE_CLIENT 조회 → PostgreSQL:** 캐시에 없으면 여기까지 간다. Evidence: L296–L302.
+- **CLIENT_SCOPE_CLIENT 조회 → PostgreSQL:** 캐시 미스. Evidence: L296–L302.
@@ -14,5 +14,5 @@ n3: "PostgreSQL" {
  shape: cylinder
 }
 n0 -> n1: "클라이언트 확인"
-n1 -> n2: "refresh 는 스코프도 다시 계산한다"
-n2 -> n3: "캐시에 없으면 여기까지 간다"
+n1 -> n2: "스코프 재계산"
+n2 -> n3: "캐시 미스"
@@ -7,6 +7,6 @@ digraph techviz {
  n2 [label="CLIENT_SCOPE_CLIENT 조회", shape=box, style="rounded,filled"];
  n3 [label="PostgreSQL", shape=cylinder, style="rounded,filled"];
  n0 -> n1 [label="클라이언트 확인", style=solid];
-  n1 -> n2 [label="refresh 는 스코프도 다시 계산한다", style=solid];
-  n2 -> n3 [label="캐시에 없으면 여기까지 간다", style=solid];
+  n1 -> n2 [label="스코프 재계산", style=solid];
+  n2 -> n3 [label="캐시 미스", style=solid];
 }
@@ -11,13 +11,13 @@
        <mxCell id="n_client-lookup" value="CLIENT 조회&lt;br/&gt;select ce1_0.ID from CLIENT" tooltip="냉시동에서 여기서 실패한다. | Evidence: L306-L312" 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="223.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_scope-lookup" value="CLIENT_SCOPE_CLIENT 조회&lt;br/&gt;DEFAULT_SCOPE=&#x27;f&#x27; — 선택적 스코프" tooltip="refresh 만 쏘고 첫 번째만 쏜다. | Evidence: L284-L292" 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="407.0" width="223.0" height="71.0" as="geometry"/>
+        <mxCell id="n_scope-lookup" value="CLIENT_SCOPE_CLIENT 조회&lt;br/&gt;DEFAULT_SCOPE=&#x27;f&#x27;" tooltip="refresh 만 쏘고 첫 번째만 쏜다. | Evidence: L284-L292" 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="87.5" y="407.0" width="188.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_db" value="PostgreSQL&lt;br/&gt;캐시에 있으면 닿지 않는다" tooltip="세운 상태다. 여기 닿는 조회만 실패한다. | Evidence: L296-L302" 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">
+        <mxCell id="n_db" value="PostgreSQL&lt;br/&gt;캐시 미스 시에만 도달" tooltip="세운 상태다. 여기 닿는 조회만 실패한다. | Evidence: L296-L302" 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="106.5" y="574.0" width="150.0" height="97.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_c-s" value="refresh 는 스코프도 다시 계산한다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_client-lookup" target="n_scope-lookup">
+        <mxCell id="e_c-s" 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-lookup" target="n_scope-lookup">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="205.5" y="359.0" as="offset"/>
          </mxGeometry>
@@ -27,7 +27,7 @@
            <mxPoint x="205.5" y="192.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_s-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_scope-lookup" target="n_db">
+        <mxCell id="e_s-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_scope-lookup" target="n_db">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="205.5" y="526.0" as="offset"/>
          </mxGeometry>
@@ -66,9 +66,9 @@
    {
      "id": "edge-label-c-s",
      "type": "text",
-      "x": 117.5,
+      "x": 160.5,
      "y": 347.0,
-      "width": 176,
+      "width": 90,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -94,11 +94,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "refresh 는 스코프도 다시 계산한다",
+      "text": "스코프 재계산",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "refresh 는 스코프도 다시 계산한다",
+      "originalText": "스코프 재계산",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -264,9 +264,9 @@
    {
      "id": "edge-label-s-db",
      "type": "text",
-      "x": 145.5,
+      "x": 160.5,
      "y": 514.0,
-      "width": 120,
+      "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
    },
@@ -441,9 +441,9 @@
    {
      "id": "node-scope-lookup",
      "type": "rectangle",
-      "x": 70.0,
+      "x": 87.5,
      "y": 407.0,
-      "width": 223.0,
+      "width": 188.0,
      "height": 71.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -471,9 +471,9 @@
    {
      "id": "node-label-scope-lookup",
      "type": "text",
-      "x": 80.0,
+      "x": 97.5,
      "y": 417.0,
-      "width": 203.0,
+      "width": 168.0,
      "height": 51.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -499,11 +499,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "CLIENT_SCOPE_CLIENT 조회\nDEFAULT_SCOPE='f' — 선택적 스코프",
+      "text": "CLIENT_SCOPE_CLIENT 조회\nDEFAULT_SCOPE='f'",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "CLIENT_SCOPE_CLIENT 조회\nDEFAULT_SCOPE='f' — 선택적 스코프",
+      "originalText": "CLIENT_SCOPE_CLIENT 조회\nDEFAULT_SCOPE='f'",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -568,11 +568,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "PostgreSQL\n캐시에 있으면 닿지 않는다",
+      "text": "PostgreSQL\n캐시 미스 시에만 도달",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "PostgreSQL\n캐시에 있으면 닿지 않는다",
+      "originalText": "PostgreSQL\n캐시 미스 시에만 도달",
      "autoResize": true,
      "lineHeight": 1.25
    }
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "cache-temperature-outcomes",
  "spec_version": "1.1",
-  "spec_sha256": "d29d1507f8c0801290e71152181fc3427617ae85cd3f1d72493352841cb60224",
+  "spec_sha256": "ef12517d7e1783c23b34a19ae285946eaf73ec600e5487c5d9bca1c086e0c22d",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -6,7 +6,7 @@ flowchart TB
    n2["CLIENT_SCOPE_CLIENT 조회"]
    n3[("PostgreSQL")]
    n0 -->|"클라이언트 확인"| n1
-    n1 -->|"refresh 는 스코프도 다시 계산한다"| n2
-    n2 -->|"캐시에 없으면 여기까지 간다"| n3
+    n1 -->|"스코프 재계산"| n2
+    n2 -->|"캐시 미스"| n3
    classDef external stroke-dasharray: 6 4
    class n0 external
@@ -51,14 +51,14 @@
 </defs>
 <rect class="canvas" width="680" height="716" />
 <polyline class="edge kind-read style-solid emphasis-normal" points="181.5,311.0 181.5,359.0 181.5,359.0 181.5,407.0" data-evidence="284-292" />
-<rect class="edge-label-bg" x="122.8" y="345.0" width="165.4" height="22" rx="3" />
-<text class="edge-label" x="205.5" y="360.0">refresh 는 스코프도 다시 계산한다</text>
+<rect class="edge-label-bg" x="173.1" y="345.0" width="64.9" height="22" rx="3" />
+<text class="edge-label" x="205.5" y="360.0">스코프 재계산</text>
 <polyline class="edge kind-read style-solid emphasis-normal" points="181.5,144.0 181.5,192.0 181.5,192.0 181.5,240.0" data-evidence="306-312" />
 <rect class="edge-label-bg" x="169.7" y="178.0" width="71.6" height="22" rx="3" />
 <text class="edge-label" x="205.5" y="193.0">클라이언트 확인</text>
 <polyline class="edge kind-read style-solid emphasis-normal" points="181.5,478.0 181.5,526.0 181.5,526.0 181.5,574.0" data-evidence="296-302" />
-<rect class="edge-label-bg" x="146.2" y="512.0" width="118.5" height="22" rx="3" />
-<text class="edge-label" x="205.5" y="527.0">캐시에 없으면 여기까지 간다</text>
+<rect class="edge-label-bg" x="179.8" y="512.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="205.5" y="527.0">캐시 미스</text>
 <g id="node-request">
 <g class="actor-symbol emphasis-primary" data-evidence="284-296"><circle cx="181.5" cy="80.0" r="11.0" /><line x1="181.5" y1="96.0" x2="181.5" y2="105.0" /><line x1="163.5" y1="106.0" x2="199.5" y2="106.0" /><line x1="181.5" y1="105.0" x2="166.5" y2="122.0" /><line x1="181.5" y1="105.0" x2="196.5" y2="122.0" /></g>
 <text class="node-label" x="181.5" y="137.0">로그인 · refresh 요청</text>
@@ -70,15 +70,15 @@
 <text class="node-detail" x="86.0" y="305.0">select ce1_0.ID from CLIENT</text>
 </g>
 <g id="node-scope-lookup">
-<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="284-292" x="70.0" y="407.0" width="223.0" height="71.0" rx="7" />
+<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="284-292" x="87.5" y="407.0" width="188.0" height="71.0" rx="7" />
 <text class="node-label" x="181.5" y="434.0">CLIENT_SCOPE_CLIENT 조회</text>
-<line class="node-detail-divider" x1="84.0" y1="455.0" x2="279.0" y2="455.0" />
-<text class="node-detail" x="86.0" y="472.0">DEFAULT_SCOPE=&#x27;f&#x27; — 선택적 스코프</text>
+<line class="node-detail-divider" x1="101.5" y1="455.0" x2="261.5" y2="455.0" />
+<text class="node-detail" x="103.5" y="472.0">DEFAULT_SCOPE=&#x27;f&#x27;</text>
 </g>
 <g id="node-db">
 <rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="296-302" x="106.5" y="587.0" width="150.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="181.5" cy="587.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 106.5 658.0 A 75.0 13.0 0 0 0 256.5 658.0" />
 <text class="node-label" x="181.5" y="614.0">PostgreSQL</text>
 <line class="node-detail-divider" x1="120.5" y1="635.0" x2="242.5" y2="635.0" />
-<text class="node-detail" x="122.5" y="652.0">캐시에 있으면 닿지 않는다</text>
+<text class="node-detail" x="122.5" y="652.0">캐시 미스 시에만 도달</text>
 </g>
 </svg>