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 @@ C-1 에서 로그아웃이 다른 앱으로 퍼지지 않는 것을 관측했고

 ## Relationships

- **backchannelLogoutUrl → 앱의 수신 엔드포인트:** 주소가 있어야 부른다. Evidence: L458–L466.
- **앱의 수신 엔드포인트 → 다른 앱의 세션:** 받을 곳이 있어야 지운다. Evidence: L458–L466.
- **한 앱에서 로그아웃 → backchannelLogoutUrl:** 통지할 주소를 찾는다. Evidence: L458–L466.
+- **backchannelLogoutUrl → 앱의 수신 엔드포인트:** 호출 (주소 필요). Evidence: L458–L466.
+- **앱의 수신 엔드포인트 → 다른 앱의 세션:** 세션 삭제 (엔드포인트 필요). Evidence: L458–L466.
+- **한 앱에서 로그아웃 → backchannelLogoutUrl:** 통지 주소 조회. Evidence: L458–L466.
@@ -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="backchannelLogoutUrl", 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];
 }
@@ -6,30 +6,30 @@
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
        <mxCell id="n_logout" value="한 앱에서 로그아웃" tooltip="Keycloak 세션이 끝난다. | Evidence: L458-L465" 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="85.5" y="60.0" width="150.0" height="84.0" as="geometry"/>
+          <mxGeometry x="82.0" y="60.0" width="150.0" height="84.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_kc-config" value="backchannelLogoutUrl&lt;br/&gt;Keycloak 은 부를 주소를 모른다" tooltip="클라이언트 설정. 비어 있었다. | Evidence: L458-L466" 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="181.0" height="71.0" as="geometry"/>
+        <mxCell id="n_kc-config" value="backchannelLogoutUrl&lt;br/&gt;주소 없음" tooltip="클라이언트 설정. 비어 있었다. | Evidence: L458-L466" 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="174.0" height="71.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_app-endpoint" value="앱의 수신 엔드포인트&lt;br/&gt;oidcLogout 설정 없음" tooltip="소스에 없었다. | Evidence: L458-L466" 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="85.5" y="407.0" width="150.0" height="71.0" as="geometry"/>
+          <mxGeometry x="82.0" y="407.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_app-session" value="다른 앱의 세션&lt;br/&gt;네트워크는 200 으로 닿는다" tooltip="그대로 남는다. | Evidence: L458-L466" 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="85.5" y="574.0" width="150.0" height="71.0" as="geometry"/>
+        <mxCell id="n_app-session" value="다른 앱의 세션&lt;br/&gt;네트워크 도달 200" tooltip="그대로 남는다. | Evidence: L458-L466" 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="82.0" y="574.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_c-e" value="주소가 있어야 부른다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_kc-config" target="n_app-endpoint">
+        <mxCell id="e_c-e" value="호출 (주소 필요)" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_kc-config" target="n_app-endpoint">
          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="184.5" y="359.0" as="offset"/>
+            <mxPoint x="181.0" y="359.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_e-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_app-endpoint" target="n_app-session">
+        <mxCell id="e_e-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_app-endpoint" target="n_app-session">
          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="184.5" y="526.0" as="offset"/>
+            <mxPoint x="181.0" y="526.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_l-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_logout" target="n_kc-config">
+        <mxCell id="e_l-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_logout" target="n_kc-config">
          <mxGeometry relative="1" as="geometry">
-            <mxPoint x="184.5" y="192.0" as="offset"/>
+            <mxPoint x="181.0" y="192.0" as="offset"/>
          </mxGeometry>
        </mxCell>
      </root>
@@ -6,7 +6,7 @@
    {
      "id": "edge-c-e",
      "type": "arrow",
-      "x": 160.5,
+      "x": 157.0,
      "y": 311.0,
      "width": 0.0,
      "height": 96.0,
@@ -66,7 +66,7 @@
    {
      "id": "edge-label-c-e",
      "type": "text",
-      "x": 139.5,
+      "x": 136.0,
      "y": 347.0,
      "width": 90,
      "height": 24,
@@ -94,18 +94,18 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "주소가 있어야 부른다",
+      "text": "호출 (주소 필요)",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "주소가 있어야 부른다",
+      "originalText": "호출 (주소 필요)",
      "autoResize": true,
      "lineHeight": 1.25
    },
    {
      "id": "edge-e-s",
      "type": "arrow",
-      "x": 160.5,
+      "x": 157.0,
      "y": 478.0,
      "width": 0.0,
      "height": 96.0,
@@ -165,9 +165,9 @@
    {
      "id": "edge-label-e-s",
      "type": "text",
-      "x": 132.5,
+      "x": 117.0,
      "y": 514.0,
-      "width": 104,
+      "width": 128,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -193,18 +193,18 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "받을 곳이 있어야 지운다",
+      "text": "세션 삭제 (엔드포인트 필요)",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "받을 곳이 있어야 지운다",
+      "originalText": "세션 삭제 (엔드포인트 필요)",
      "autoResize": true,
      "lineHeight": 1.25
    },
    {
      "id": "edge-l-c",
      "type": "arrow",
-      "x": 160.5,
+      "x": 157.0,
      "y": 144.0,
      "width": 0.0,
      "height": 96.0,
@@ -264,7 +264,7 @@
    {
      "id": "edge-label-l-c",
      "type": "text",
-      "x": 139.5,
+      "x": 136.0,
      "y": 180.0,
      "width": 90,
      "height": 24,
@@ -292,18 +292,18 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "통지할 주소를 찾는다",
+      "text": "통지 주소 조회",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "통지할 주소를 찾는다",
+      "originalText": "통지 주소 조회",
      "autoResize": true,
      "lineHeight": 1.25
    },
    {
      "id": "node-logout",
      "type": "rectangle",
-      "x": 85.5,
+      "x": 82.0,
      "y": 60.0,
      "width": 150.0,
      "height": 84.0,
@@ -333,7 +333,7 @@
    {
      "id": "node-label-logout",
      "type": "text",
-      "x": 95.5,
+      "x": 92.0,
      "y": 70.0,
      "width": 130.0,
      "height": 64.0,
@@ -374,7 +374,7 @@
      "type": "rectangle",
      "x": 70.0,
      "y": 240.0,
-      "width": 181.0,
+      "width": 174.0,
      "height": 71.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -404,7 +404,7 @@
      "type": "text",
      "x": 80.0,
      "y": 250.0,
-      "width": 161.0,
+      "width": 154.0,
      "height": 51.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -430,18 +430,18 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "backchannelLogoutUrl\nKeycloak 은 부를 주소를 모른다",
+      "text": "backchannelLogoutUrl\n주소 없음",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "backchannelLogoutUrl\nKeycloak 은 부를 주소를 모른다",
+      "originalText": "backchannelLogoutUrl\n주소 없음",
      "autoResize": true,
      "lineHeight": 1.25
    },
    {
      "id": "node-app-endpoint",
      "type": "rectangle",
-      "x": 85.5,
+      "x": 82.0,
      "y": 407.0,
      "width": 150.0,
      "height": 71.0,
@@ -471,7 +471,7 @@
    {
      "id": "node-label-app-endpoint",
      "type": "text",
-      "x": 95.5,
+      "x": 92.0,
      "y": 417.0,
      "width": 130.0,
      "height": 51.0,
@@ -510,7 +510,7 @@
    {
      "id": "node-app-session",
      "type": "rectangle",
-      "x": 85.5,
+      "x": 82.0,
      "y": 574.0,
      "width": 150.0,
      "height": 71.0,
@@ -540,7 +540,7 @@
    {
      "id": "node-label-app-session",
      "type": "text",
-      "x": 95.5,
+      "x": 92.0,
      "y": 584.0,
      "width": 130.0,
      "height": 51.0,
@@ -568,11 +568,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "다른 앱의 세션\n네트워크는 200 으로 닿는다",
+      "text": "다른 앱의 세션\n네트워크 도달 200",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "다른 앱의 세션\n네트워크는 200 으로 닿는다",
+      "originalText": "다른 앱의 세션\n네트워크 도달 200",
      "autoResize": true,
      "lineHeight": 1.25
    }
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "c2-backchannel-both-sides",
  "spec_version": "1.1",
-  "spec_sha256": "43396622cbf01d243efac1f48396163cc64738ef902bddda0ded0d9fb6467eb1",
+  "spec_sha256": "dd700a72a2ec7d5427681b95610e9715385241a81c78e2e9dce2aafdee32b35c",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -5,8 +5,8 @@ flowchart TB
    n1["backchannelLogoutUrl"]
    n2["앱의 수신 엔드포인트"]
    n3["다른 앱의 세션"]
-    n0 -->|"통지할 주소를 찾는다"| n1
-    n1 -->|"주소가 있어야 부른다"| n2
-    n2 -->|"받을 곳이 있어야 지운다"| n3
+    n0 -->|"통지 주소 조회"| n1
+    n1 -->|"호출 (주소 필요)"| n2
+    n2 -->|"세션 삭제 (엔드포인트 필요)"| n3
    classDef external stroke-dasharray: 6 4
    class n0 external
@@ -50,35 +50,35 @@
  </style>
 </defs>
 <rect class="canvas" width="680" height="690" />
-<polyline class="edge kind-blocked style-solid emphasis-normal" points="160.5,311.0 160.5,359.0 160.5,359.0 160.5,407.0" data-evidence="458-466" />
-<rect class="edge-label-bg" x="138.7" y="345.0" width="91.7" height="22" rx="3" />
-<text class="edge-label" x="184.5" y="360.0">주소가 있어야 부른다</text>
-<polyline class="edge kind-blocked style-solid emphasis-normal" points="160.5,478.0 160.5,526.0 160.5,526.0 160.5,574.0" data-evidence="458-466" />
-<rect class="edge-label-bg" x="131.9" y="512.0" width="105.1" height="22" rx="3" />
-<text class="edge-label" x="184.5" y="527.0">받을 곳이 있어야 지운다</text>
-<polyline class="edge kind-request style-solid emphasis-normal" points="160.5,144.0 160.5,192.0 160.5,192.0 160.5,240.0" data-evidence="458-466" />
-<rect class="edge-label-bg" x="138.7" y="178.0" width="91.7" height="22" rx="3" />
-<text class="edge-label" x="184.5" y="193.0">통지할 주소를 찾는다</text>
+<polyline class="edge kind-blocked style-solid emphasis-normal" points="157.0,311.0 157.0,359.0 157.0,359.0 157.0,407.0" data-evidence="458-466" />
+<rect class="edge-label-bg" x="138.5" y="345.0" width="85.0" height="22" rx="3" />
+<text class="edge-label" x="181.0" y="360.0">호출 (주소 필요)</text>
+<polyline class="edge kind-blocked style-solid emphasis-normal" points="157.0,478.0 157.0,526.0 157.0,526.0 157.0,574.0" data-evidence="458-466" />
+<rect class="edge-label-bg" x="118.4" y="512.0" width="125.2" height="22" rx="3" />
+<text class="edge-label" x="181.0" y="527.0">세션 삭제 (엔드포인트 필요)</text>
+<polyline class="edge kind-request style-solid emphasis-normal" points="157.0,144.0 157.0,192.0 157.0,192.0 157.0,240.0" data-evidence="458-466" />
+<rect class="edge-label-bg" x="145.2" y="178.0" width="71.6" height="22" rx="3" />
+<text class="edge-label" x="181.0" y="193.0">통지 주소 조회</text>
 <g id="node-logout">
-<g class="actor-symbol emphasis-primary" data-evidence="458-465"><circle cx="160.5" cy="80.0" r="11.0" /><line x1="160.5" y1="96.0" x2="160.5" y2="105.0" /><line x1="142.5" y1="106.0" x2="178.5" y2="106.0" /><line x1="160.5" y1="105.0" x2="145.5" y2="122.0" /><line x1="160.5" y1="105.0" x2="175.5" y2="122.0" /></g>
-<text class="node-label" x="160.5" y="137.0">한 앱에서 로그아웃</text>
+<g class="actor-symbol emphasis-primary" data-evidence="458-465"><circle cx="157.0" cy="80.0" r="11.0" /><line x1="157.0" y1="96.0" x2="157.0" y2="105.0" /><line x1="139.0" y1="106.0" x2="175.0" y2="106.0" /><line x1="157.0" y1="105.0" x2="142.0" y2="122.0" /><line x1="157.0" y1="105.0" x2="172.0" y2="122.0" /></g>
+<text class="node-label" x="157.0" y="137.0">한 앱에서 로그아웃</text>
 </g>
 <g id="node-kc-config">
-<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="458-466" x="70.0" y="240.0" width="181.0" height="71.0" rx="7" />
-<text class="node-label" x="160.5" y="267.0">backchannelLogoutUrl</text>
-<line class="node-detail-divider" x1="84.0" y1="288.0" x2="237.0" y2="288.0" />
-<text class="node-detail" x="86.0" y="305.0">Keycloak 은 부를 주소를 모른다</text>
+<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="458-466" x="70.0" y="240.0" width="174.0" height="71.0" rx="7" />
+<text class="node-label" x="157.0" y="267.0">backchannelLogoutUrl</text>
+<line class="node-detail-divider" x1="84.0" y1="288.0" x2="230.0" y2="288.0" />
+<text class="node-detail" x="86.0" y="305.0">주소 없음</text>
 </g>
 <g id="node-app-endpoint">
-<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="458-466" x="85.5" y="407.0" width="150.0" height="71.0" rx="7" />
-<text class="node-label" x="160.5" y="434.0">앱의 수신 엔드포인트</text>
-<line class="node-detail-divider" x1="99.5" y1="455.0" x2="221.5" y2="455.0" />
-<text class="node-detail" x="101.5" y="472.0">oidcLogout 설정 없음</text>
+<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="458-466" x="82.0" y="407.0" width="150.0" height="71.0" rx="7" />
+<text class="node-label" x="157.0" y="434.0">앱의 수신 엔드포인트</text>
+<line class="node-detail-divider" x1="96.0" y1="455.0" x2="218.0" y2="455.0" />
+<text class="node-detail" x="98.0" y="472.0">oidcLogout 설정 없음</text>
 </g>
 <g id="node-app-session">
-<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="458-466" x="85.5" y="574.0" width="150.0" height="71.0" rx="7" />
-<text class="node-label" x="160.5" y="601.0">다른 앱의 세션</text>
-<line class="node-detail-divider" x1="99.5" y1="622.0" x2="221.5" y2="622.0" />
-<text class="node-detail" x="101.5" y="639.0">네트워크는 200 으로 닿는다</text>
+<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="458-466" x="82.0" y="574.0" width="150.0" height="71.0" rx="7" />
+<text class="node-label" x="157.0" y="601.0">다른 앱의 세션</text>
+<line class="node-detail-divider" x1="96.0" y1="622.0" x2="218.0" y2="622.0" />
+<text class="node-detail" x="98.0" y="639.0">네트워크 도달 200</text>
 </g>
 </svg>