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,7 +18,7 @@

 ## Relationships

- **Liquibase 검증 → databasechangelog 행 수:** 무엇을 보고 판단하나. Evidence: L499–L505.
- **Liquibase 검증 → StatefulSet 롤링 업데이트:** 실패가 여기서 멈춘다. Evidence: L492–L497.
+- **Liquibase 검증 → databasechangelog 행 수:** 판단 기준. Evidence: L499–L505.
+- **Liquibase 검증 → StatefulSet 롤링 업데이트:** 중단 지점. Evidence: L492–L497.
 - **옛 버전으로 되돌리기 → Liquibase 검증:** 기동 시 검증. Evidence: L483–L491.
- **StatefulSet 롤링 업데이트 → 외부 서비스:** 남은 파드가 응답한다. Evidence: L492–L498.
+- **StatefulSet 롤링 업데이트 → 외부 서비스:** 잔여 파드 응답. Evidence: L492–L498.
@@ -17,6 +17,6 @@ n4: "databasechangelog 행 수" {
  shape: cylinder
 }
 n0 -> n1: "기동 시 검증"
-n1 -> n2: "실패가 여기서 멈춘다"
-n2 -> n3: "남은 파드가 응답한다"
-n1 -> n4: "무엇을 보고 판단하나"
+n1 -> n2: "중단 지점"
+n2 -> n3: "잔여 파드 응답"
+n1 -> n4: "판단 기준"
@@ -8,7 +8,7 @@ digraph techviz {
  n3 [label="외부 서비스", shape=box, style="rounded,filled"];
  n4 [label="databasechangelog 행 수", shape=cylinder, style="rounded,filled"];
  n0 -> n1 [label="기동 시 검증", style=solid];
-  n1 -> n2 [label="실패가 여기서 멈춘다", style=solid];
-  n2 -> n3 [label="남은 파드가 응답한다", style=solid];
-  n1 -> n4 [label="무엇을 보고 판단하나", style=solid];
+  n1 -> n2 [label="중단 지점", style=solid];
+  n2 -> n3 [label="잔여 파드 응답", style=solid];
+  n1 -> n4 [label="판단 기준", style=solid];
 }
@@ -11,21 +11,21 @@
        <mxCell id="n_liquibase" value="Liquibase 검증&lt;br/&gt;ValidationFailedException: 1 changesets check sum" tooltip="새 버전이 남긴 체크섬을 거부한다. | Evidence: L483-L491" 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="124.0" y="220.0" width="300.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_changelog" value="databasechangelog 행 수&lt;br/&gt;늘었으면 스키마가 움직였다" tooltip="전후로 같으면 롤백된다. | Evidence: L499-L505" 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_changelog" value="databasechangelog 행 수&lt;br/&gt;전후 행 수 비교" tooltip="전후로 같으면 롤백된다. | Evidence: L499-L505" 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="70.0" y="387.0" width="181.0" height="97.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_rolling" value="StatefulSet 롤링 업데이트&lt;br/&gt;나머지 파드는 건드리지 않는다" tooltip="첫 파드가 실패하면 거기서 멈춘다. | Evidence: L492-L497" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
+        <mxCell id="n_rolling" value="StatefulSet 롤링 업데이트&lt;br/&gt;나머지 파드 유지" tooltip="첫 파드가 실패하면 거기서 멈춘다. | Evidence: L492-L497" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
          <mxGeometry x="311.0" y="400.0" width="167.0" height="71.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_service" value="외부 서비스" tooltip="남은 파드가 계속 200 을 낸다. | Evidence: L492-L498" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
          <mxGeometry x="199.0" y="580.0" width="150.0" height="64.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_l-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_liquibase" target="n_changelog">
+        <mxCell id="e_l-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_liquibase" target="n_changelog">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="212.8" y="311.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_l-ro" value="실패가 여기서 멈춘다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_liquibase" target="n_rolling">
+        <mxCell id="e_l-ro" value="중단 지점" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_liquibase" target="n_rolling">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="338.8" y="317.5" as="offset"/>
          </mxGeometry>
@@ -35,7 +35,7 @@
            <mxPoint x="298.0" y="172.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_ro-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_rolling" target="n_service">
+        <mxCell id="e_ro-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_rolling" target="n_service">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="334.2" y="497.5" 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
    },
@@ -391,11 +391,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "남은 파드가 응답한다",
+      "text": "잔여 파드 응답",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "남은 파드가 응답한다",
+      "originalText": "잔여 파드 응답",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -598,11 +598,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "databasechangelog 행 수\n늘었으면 스키마가 움직였다",
+      "text": "databasechangelog 행 수\n전후 행 수 비교",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "databasechangelog 행 수\n늘었으면 스키마가 움직였다",
+      "originalText": "databasechangelog 행 수\n전후 행 수 비교",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -667,11 +667,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "StatefulSet 롤링 업데이트\n나머지 파드는 건드리지 않는다",
+      "text": "StatefulSet 롤링 업데이트\n나머지 파드 유지",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "StatefulSet 롤링 업데이트\n나머지 파드는 건드리지 않는다",
+      "originalText": "StatefulSet 롤링 업데이트\n나머지 파드 유지",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "d2-upgrade-direction",
  "spec_version": "1.1",
-  "spec_sha256": "30ae7b783f6b33d4364a113637e61b09cbf87be39bac08a41b49f134f2a845be",
+  "spec_sha256": "7f7090d0f9f237909f548d3f67104bb98dba10e94b63ca7e6e0c684d92afe199",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -7,6 +7,6 @@ flowchart TB
    n3["외부 서비스"]
    n4[("databasechangelog 행 수")]
    n0 -->|"기동 시 검증"| n1
-    n1 -->|"실패가 여기서 멈춘다"| n2
-    n2 -->|"남은 파드가 응답한다"| n3
-    n1 -->|"무엇을 보고 판단하나"| n4
+    n1 -->|"중단 지점"| n2
+    n2 -->|"잔여 파드 응답"| n3
+    n1 -->|"판단 기준"| n4
@@ -51,17 +51,17 @@
 </defs>
 <rect class="canvas" width="680" height="689" />
 <polyline class="edge kind-read style-solid emphasis-normal" points="265.0,291.0 265.0,339.0 160.5,339.0 160.5,387.0" data-evidence="499-505" />
-<rect class="edge-label-bg" x="166.9" y="297.0" width="91.7" height="22" rx="3" />
-<text class="edge-label" x="212.8" y="312.0">무엇을 보고 판단하나</text>
+<rect class="edge-label-bg" x="187.0" y="297.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="212.8" y="312.0">판단 기준</text>
 <polyline class="edge kind-blocked style-solid emphasis-normal" points="283.0,291.0 283.0,345.5 394.5,345.5 394.5,400.0" data-evidence="492-497" />
-<rect class="edge-label-bg" x="292.9" y="303.5" width="91.7" height="22" rx="3" />
-<text class="edge-label" x="338.8" y="318.5">실패가 여기서 멈춘다</text>
+<rect class="edge-label-bg" x="313.0" y="303.5" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="338.8" y="318.5">중단 지점</text>
 <polyline class="edge kind-request style-solid emphasis-normal" points="274.0,124.0 274.0,172.0 274.0,172.0 274.0,220.0" data-evidence="483-491" />
 <rect class="edge-label-bg" x="265.6" y="158.0" width="64.9" height="22" rx="3" />
 <text class="edge-label" x="298.0" y="173.0">기동 시 검증</text>
 <polyline class="edge kind-request style-solid emphasis-normal" points="394.5,471.0 394.5,525.5 274.0,525.5 274.0,580.0" data-evidence="492-498" />
-<rect class="edge-label-bg" x="288.4" y="483.5" width="91.7" height="22" rx="3" />
-<text class="edge-label" x="334.2" y="498.5">남은 파드가 응답한다</text>
+<rect class="edge-label-bg" x="298.4" y="483.5" width="71.6" height="22" rx="3" />
+<text class="edge-label" x="334.2" y="498.5">잔여 파드 응답</text>
 <g id="node-rollback">
 <rect class="node-shape kind-process emphasis-warning role-source" data-evidence="483-490" x="199.0" y="60.0" width="150.0" height="64.0" rx="7" />
 <text class="node-label" x="274.0" y="90.0">옛 버전으로 되돌리기</text>
@@ -76,13 +76,13 @@
 <rect class="node-shape kind-datastore emphasis-primary role-support" data-evidence="499-505" x="70.0" y="400.0" width="181.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-support" cx="160.5" cy="400.0" rx="90.5" ry="13.0" /><path class="storage-bottom" d="M 70.0 471.0 A 90.5 13.0 0 0 0 251.0 471.0" />
 <text class="node-label" x="160.5" y="427.0">databasechangelog 행 수</text>
 <line class="node-detail-divider" x1="84.0" y1="448.0" x2="237.0" y2="448.0" />
-<text class="node-detail" x="86.0" y="465.0">늘었으면 스키마가 움직였다</text>
+<text class="node-detail" x="86.0" y="465.0">전후 행 수 비교</text>
 </g>
 <g id="node-rolling">
 <rect class="node-shape kind-process emphasis-primary role-control" data-evidence="492-497" x="311.0" y="400.0" width="167.0" height="71.0" rx="7" />
 <text class="node-label" x="394.5" y="427.0">StatefulSet 롤링 업데이트</text>
 <line class="node-detail-divider" x1="325.0" y1="448.0" x2="464.0" y2="448.0" />
-<text class="node-detail" x="327.0" y="465.0">나머지 파드는 건드리지 않는다</text>
+<text class="node-detail" x="327.0" y="465.0">나머지 파드 유지</text>
 </g>
 <g id="node-service">
 <rect class="node-shape kind-service emphasis-primary role-target" data-evidence="492-498" x="199.0" y="580.0" width="150.0" height="64.0" rx="7" />