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 @@ redis-cli config set appendonly yes 를 켜도 아무것도 달라지지 않았

 ## Relationships

- **appendonly yes → /data:** AOF 파일을 쓴다. Evidence: L406–L412.
- **/data → 컨테이너:** 컨테이너와 함께 죽는다. Evidence: L406–L412.
- **/data → PersistentVolume:** 볼륨을 붙여야 남는다. Evidence: L406–L412.
+- **appendonly yes → /data:** AOF 기록. Evidence: L406–L412.
+- **/data → 컨테이너:** 컨테이너와 함께 소멸. Evidence: L406–L412.
+- **/data → PersistentVolume:** 볼륨 마운트. Evidence: L406–L412.
@@ -13,6 +13,6 @@ n2: "컨테이너" {
 n3: "PersistentVolume" {
  shape: cylinder
 }
-n0 -> n1: "AOF 파일을 쓴다"
-n1 -> n2: "컨테이너와 함께 죽는다"
-n1 -> n3: "볼륨을 붙여야 남는다"
+n0 -> n1: "AOF 기록"
+n1 -> n2: "컨테이너와 함께 소멸"
+n1 -> n3: "볼륨 마운트"
@@ -6,7 +6,7 @@ digraph techviz {
  n1 [label="/data", shape=cylinder, style="rounded,filled"];
  n2 [label="컨테이너", shape=box, style="rounded,filled"];
  n3 [label="PersistentVolume", shape=cylinder, style="rounded,filled"];
-  n0 -> n1 [label="AOF 파일을 쓴다", style=solid];
-  n1 -> n2 [label="컨테이너와 함께 죽는다", style=solid];
-  n1 -> n3 [label="볼륨을 붙여야 남는다", style=solid];
+  n0 -> n1 [label="AOF 기록", style=solid];
+  n1 -> n2 [label="컨테이너와 함께 소멸", style=solid];
+  n1 -> n3 [label="볼륨 마운트", style=solid];
 }
@@ -8,26 +8,26 @@
        <mxCell id="n_config" value="appendonly yes&lt;br/&gt;redis-cli config set" tooltip="설정은 적용된다. | Evidence: L406-L412" 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="163.0" y="60.0" width="174.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_datadir" value="/data&lt;br/&gt;appendonlydir 이 만들어졌다 버려진다" tooltip="컨테이너 파일시스템이다. | Evidence: L406-L412" 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=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
-          <mxGeometry x="142.0" y="227.0" width="216.0" height="97.0" as="geometry"/>
+        <mxCell id="n_datadir" value="/data&lt;br/&gt;appendonlydir" tooltip="컨테이너 파일시스템이다. | Evidence: L406-L412" 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=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
+          <mxGeometry x="175.0" y="227.0" width="150.0" height="97.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_container" value="컨테이너&lt;br/&gt;볼륨이 없으면 여기까지다" tooltip="죽으면 /data 도 같이 사라진다. | Evidence: L406-L412" 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_container" value="컨테이너&lt;br/&gt;볼륨 없음" tooltip="죽으면 /data 도 같이 사라진다. | Evidence: L406-L412" 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="429.5" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_volume" value="PersistentVolume" tooltip="여기 있어야 설정이 뜻을 갖는다. | Evidence: L406-L412" 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="280.0" y="420.0" width="150.0" height="90.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_c-d" value="AOF 파일을 쓴다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_config" target="n_datadir">
+        <mxCell id="e_c-d" value="AOF 기록" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_config" target="n_datadir">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="274.0" y="179.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_d-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_datadir" target="n_container">
+        <mxCell id="e_d-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_datadir" target="n_container">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="193.0" y="348.8" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_d-v" value="볼륨을 붙여야 남는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_datadir" target="n_volume">
+        <mxCell id="e_d-v" value="볼륨 마운트" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_datadir" target="n_volume">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="307.0" y="344.0" as="offset"/>
          </mxGeometry>
@@ -94,11 +94,11 @@
      "locked": false,
      "fontSize": 13,
      "fontFamily": 5,
-      "text": "AOF 파일을 쓴다",
+      "text": "AOF 기록",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "AOF 파일을 쓴다",
+      "originalText": "AOF 기록",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -165,9 +165,9 @@
    {
      "id": "edge-label-d-c",
      "type": "text",
-      "x": 145.0,
+      "x": 148.0,
      "y": 336.75,
-      "width": 96,
+      "width": 90,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -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
    },
@@ -372,9 +372,9 @@
    {
      "id": "node-datadir",
      "type": "rectangle",
-      "x": 142.0,
+      "x": 175.0,
      "y": 227.0,
-      "width": 216.0,
+      "width": 150.0,
      "height": 97.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -402,9 +402,9 @@
    {
      "id": "node-label-datadir",
      "type": "text",
-      "x": 152.0,
+      "x": 185.0,
      "y": 237.0,
-      "width": 196.0,
+      "width": 130.0,
      "height": 77.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -430,11 +430,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "/data\nappendonlydir 이 만들어졌다 버려진다",
+      "text": "/data\nappendonlydir",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "/data\nappendonlydir 이 만들어졌다 버려진다",
+      "originalText": "/data\nappendonlydir",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -499,11 +499,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "컨테이너\n볼륨이 없으면 여기까지다",
+      "text": "컨테이너\n볼륨 없음",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "컨테이너\n볼륨이 없으면 여기까지다",
+      "originalText": "컨테이너\n볼륨 없음",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "b5-b6-storage-and-keys",
  "spec_version": "1.1",
-  "spec_sha256": "51b618881bf3ef23a734b2beb319e756c12a9a7ff1ae578b7b5ef78a1461b0e9",
+  "spec_sha256": "6be204030cc95c5d9aec2ec4f07eae62bd88e7f344d00c2e014a20e18d6f8dba",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -5,6 +5,6 @@ flowchart TB
    n1[("/data")]
    n2["컨테이너"]
    n3[("PersistentVolume")]
-    n0 -->|"AOF 파일을 쓴다"| n1
-    n1 -->|"컨테이너와 함께 죽는다"| n2
-    n1 -->|"볼륨을 붙여야 남는다"| n3
+    n0 -->|"AOF 기록"| n1
+    n1 -->|"컨테이너와 함께 소멸"| n2
+    n1 -->|"볼륨 마운트"| n3
@@ -51,14 +51,14 @@
 </defs>
 <rect class="canvas" width="680" height="555" />
 <polyline class="edge kind-write style-solid emphasis-normal" points="250.0,131.0 250.0,179.0 250.0,179.0 250.0,227.0" data-evidence="406-412" />
-<rect class="edge-label-bg" x="231.5" y="165.0" width="85.0" height="22" rx="3" />
-<text class="edge-label" x="274.0" y="180.0">AOF 파일을 쓴다</text>
+<rect class="edge-label-bg" x="244.9" y="165.0" width="58.2" height="22" rx="3" />
+<text class="edge-label" x="274.0" y="180.0">AOF 기록</text>
 <polyline class="edge kind-blocked style-solid emphasis-normal" points="241.0,324.0 241.0,376.8 145.0,376.8 145.0,429.5" data-evidence="406-412" />
-<rect class="edge-label-bg" x="143.8" y="334.8" width="98.4" height="22" rx="3" />
-<text class="edge-label" x="193.0" y="349.8">컨테이너와 함께 죽는다</text>
+<rect class="edge-label-bg" x="147.2" y="334.8" width="91.7" height="22" rx="3" />
+<text class="edge-label" x="193.0" y="349.8">컨테이너와 함께 소멸</text>
 <polyline class="edge kind-write style-solid emphasis-normal" points="259.0,324.0 259.0,372.0 355.0,372.0 355.0,420.0" data-evidence="406-412" />
-<rect class="edge-label-bg" x="261.1" y="330.0" width="91.7" height="22" rx="3" />
-<text class="edge-label" x="307.0" y="345.0">볼륨을 붙여야 남는다</text>
+<rect class="edge-label-bg" x="277.9" y="330.0" width="58.2" height="22" rx="3" />
+<text class="edge-label" x="307.0" y="345.0">볼륨 마운트</text>
 <g id="node-config">
 <rect class="node-shape kind-process emphasis-warning role-source" data-evidence="406-412" x="163.0" y="60.0" width="174.0" height="71.0" rx="7" />
 <text class="node-label" x="250.0" y="87.0">appendonly yes</text>
@@ -66,16 +66,16 @@
 <text class="node-detail" x="179.0" y="125.0">redis-cli config set</text>
 </g>
 <g id="node-datadir">
-<rect class="node-shape kind-datastore emphasis-warning role-control" data-evidence="406-412" x="142.0" y="240.0" width="216.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-warning role-control" cx="250.0" cy="240.0" rx="108.0" ry="13.0" /><path class="storage-bottom" d="M 142.0 311.0 A 108.0 13.0 0 0 0 358.0 311.0" />
+<rect class="node-shape kind-datastore emphasis-warning role-control" data-evidence="406-412" x="175.0" y="240.0" width="150.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-warning role-control" cx="250.0" cy="240.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 175.0 311.0 A 75.0 13.0 0 0 0 325.0 311.0" />
 <text class="node-label" x="250.0" y="267.0">/data</text>
-<line class="node-detail-divider" x1="156.0" y1="288.0" x2="344.0" y2="288.0" />
-<text class="node-detail" x="158.0" y="305.0">appendonlydir 이 만들어졌다 버려진다</text>
+<line class="node-detail-divider" x1="189.0" y1="288.0" x2="311.0" y2="288.0" />
+<text class="node-detail" x="191.0" y="305.0">appendonlydir</text>
 </g>
 <g id="node-container">
 <rect class="node-shape kind-component emphasis-warning role-target" data-evidence="406-412" x="70.0" y="429.5" width="150.0" height="71.0" rx="7" />
 <text class="node-label" x="145.0" y="456.5">컨테이너</text>
 <line class="node-detail-divider" x1="84.0" y1="477.5" x2="206.0" y2="477.5" />
-<text class="node-detail" x="86.0" y="494.5">볼륨이 없으면 여기까지다</text>
+<text class="node-detail" x="86.0" y="494.5">볼륨 없음</text>
 </g>
 <g id="node-volume">
 <rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="406-412" x="280.0" y="433.0" width="150.0" height="64.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="355.0" cy="433.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 280.0 497.0 A 75.0 13.0 0 0 0 430.0 497.0" />