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 @@ oauth2-proxy 는 세션 전체를 쿠키에 담고 replica 는 같은 k8s Secret

 ## Relationships

- **Redis 의 세션 → TTL:** 생성 시각이 여기 남는다. Evidence: L441–L452.
- **k8s Secret → 쿠키의 티켓:** 티켓을 암호화한다. Evidence: L419–L432.
- **쿠키의 티켓 → Redis 의 세션:** 키 이름을 만든다. Evidence: L429–L438.
+- **Redis 의 세션 → TTL:** 생성 시각. Evidence: L441–L452.
+- **k8s Secret → 쿠키의 티켓:** 티켓 암호화. Evidence: L419–L432.
+- **쿠키의 티켓 → Redis 의 세션:** 키 이름 생성. Evidence: L429–L438.
@@ -13,6 +13,6 @@ n2: "Redis 의 세션" {
 n3: "TTL" {
  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="Redis 의 세션", shape=cylinder, style="rounded,filled"];
  n3 [label="TTL", 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];
 }
@@ -8,26 +8,26 @@
        <mxCell id="n_secret" value="k8s Secret&lt;br/&gt;--cookie-secret 은 단수" tooltip="모든 replica 가 같은 값을 읽는다. | Evidence: L419-L428" 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="60.0" width="174.0" height="97.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_ticket" value="쿠키의 티켓&lt;br/&gt;secret 을 바꾸면 못 푼다" tooltip="세션 id 와 복호화 키가 함께 암호화되어 있다. | Evidence: L429-L438" 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="80.5" y="253.0" width="153.0" height="71.0" as="geometry"/>
+        <mxCell id="n_ticket" value="쿠키의 티켓&lt;br/&gt;secret 교체 시 복호화 불가" tooltip="세션 id 와 복호화 키가 함께 암호화되어 있다. | Evidence: L429-L438" 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="77.0" y="253.0" width="160.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_redis-session" value="Redis 의 세션&lt;br/&gt;고아로 남는다" tooltip="티켓을 못 풀면 어느 키인지도 모른다. | Evidence: L429-L440" 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">
+        <mxCell id="n_redis-session" value="Redis 의 세션&lt;br/&gt;고아 세션" tooltip="티켓을 못 풀면 어느 키인지도 모른다. | Evidence: L429-L440" 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="82.0" y="420.0" width="150.0" height="97.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_ttl" value="TTL&lt;br/&gt;역산으로 고아를 고른다" tooltip="요청으로 갱신되지 않아 생성 시각의 함수다. | Evidence: L441-L452" 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_ttl" value="TTL&lt;br/&gt;생성 시각 역산" tooltip="요청으로 갱신되지 않아 생성 시각의 함수다. | Evidence: L441-L452" 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="82.0" y="613.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="e_r-ttl" value="생성 시각이 여기 남는다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_redis-session" target="n_ttl">
+        <mxCell id="e_r-ttl" value="생성 시각" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_redis-session" target="n_ttl">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="181.0" y="565.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_s-t" value="티켓을 암호화한다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_secret" target="n_ticket">
+        <mxCell id="e_s-t" value="티켓 암호화" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_secret" target="n_ticket">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="181.0" y="205.0" as="offset"/>
          </mxGeometry>
        </mxCell>
-        <mxCell id="e_t-r" value="키 이름을 만든다" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_ticket" target="n_redis-session">
+        <mxCell id="e_t-r" value="키 이름 생성" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_ticket" target="n_redis-session">
          <mxGeometry relative="1" as="geometry">
            <mxPoint x="181.0" y="372.0" as="offset"/>
          </mxGeometry>
@@ -66,9 +66,9 @@
    {
      "id": "edge-label-r-ttl",
      "type": "text",
-      "x": 129.0,
+      "x": 136.0,
      "y": 553.0,
-      "width": 104,
+      "width": 90,
      "height": 24,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -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
    },
@@ -372,9 +372,9 @@
    {
      "id": "node-ticket",
      "type": "rectangle",
-      "x": 80.5,
+      "x": 77.0,
      "y": 253.0,
-      "width": 153.0,
+      "width": 160.0,
      "height": 71.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -402,9 +402,9 @@
    {
      "id": "node-label-ticket",
      "type": "text",
-      "x": 90.5,
+      "x": 87.0,
      "y": 263.0,
-      "width": 133.0,
+      "width": 140.0,
      "height": 51.0,
      "angle": 0,
      "strokeColor": "#1e1e1e",
@@ -430,11 +430,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "쿠키의 티켓\nsecret 을 바꾸면 못 푼다",
+      "text": "쿠키의 티켓\nsecret 교체 시 복호화 불가",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "쿠키의 티켓\nsecret 을 바꾸면 못 푼다",
+      "originalText": "쿠키의 티켓\nsecret 교체 시 복호화 불가",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -499,11 +499,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "Redis 의 세션\n고아로 남는다",
+      "text": "Redis 의 세션\n고아 세션",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "Redis 의 세션\n고아로 남는다",
+      "originalText": "Redis 의 세션\n고아 세션",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -568,11 +568,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "TTL\n역산으로 고아를 고른다",
+      "text": "TTL\n생성 시각 역산",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "TTL\n역산으로 고아를 고른다",
+      "originalText": "TTL\n생성 시각 역산",
      "autoResize": true,
      "lineHeight": 1.25
    }
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "b7-cookie-session-tradeoff",
  "spec_version": "1.1",
-  "spec_sha256": "ae4774e0d8dfda387902c00a5d3c933672d4adf799cd6774760a74b8a1ad376a",
+  "spec_sha256": "9a594212157672a9188e296e73a0ab9af3d53992c94afdbfe2e1aeedaf8998bc",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -5,6 +5,6 @@ flowchart TB
    n1["쿠키의 티켓"]
    n2[("Redis 의 세션")]
    n3["TTL"]
-    n0 -->|"티켓을 암호화한다"| n1
-    n1 -->|"키 이름을 만든다"| n2
-    n2 -->|"생성 시각이 여기 남는다"| n3
+    n0 -->|"티켓 암호화"| n1
+    n1 -->|"키 이름 생성"| n2
+    n2 -->|"생성 시각"| n3
@@ -51,14 +51,14 @@
 </defs>
 <rect class="canvas" width="680" height="729" />
 <polyline class="edge kind-read style-solid emphasis-normal" points="157.0,517.0 157.0,565.0 157.0,565.0 157.0,613.0" data-evidence="441-452" />
-<rect class="edge-label-bg" x="128.4" y="551.0" width="105.1" height="22" rx="3" />
-<text class="edge-label" x="181.0" y="566.0">생성 시각이 여기 남는다</text>
+<rect class="edge-label-bg" x="155.2" y="551.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="181.0" y="566.0">생성 시각</text>
 <polyline class="edge kind-write style-solid emphasis-normal" points="157.0,157.0 157.0,205.0 157.0,205.0 157.0,253.0" data-evidence="419-432" />
-<rect class="edge-label-bg" x="141.8" y="191.0" width="78.3" height="22" rx="3" />
-<text class="edge-label" x="181.0" y="206.0">티켓을 암호화한다</text>
+<rect class="edge-label-bg" x="151.9" y="191.0" width="58.2" height="22" rx="3" />
+<text class="edge-label" x="181.0" y="206.0">티켓 암호화</text>
 <polyline class="edge kind-read style-solid emphasis-normal" points="157.0,324.0 157.0,372.0 157.0,372.0 157.0,420.0" data-evidence="429-438" />
-<rect class="edge-label-bg" x="141.8" y="358.0" width="78.3" height="22" rx="3" />
-<text class="edge-label" x="181.0" y="373.0">키 이름을 만든다</text>
+<rect class="edge-label-bg" x="148.6" y="358.0" width="64.9" height="22" rx="3" />
+<text class="edge-label" x="181.0" y="373.0">키 이름 생성</text>
 <g id="node-secret">
 <rect class="node-shape kind-datastore emphasis-primary role-source" data-evidence="419-428" x="70.0" y="73.0" width="174.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-source" cx="157.0" cy="73.0" rx="87.0" ry="13.0" /><path class="storage-bottom" d="M 70.0 144.0 A 87.0 13.0 0 0 0 244.0 144.0" />
 <text class="node-label" x="157.0" y="100.0">k8s Secret</text>
@@ -66,21 +66,21 @@
 <text class="node-detail" x="86.0" y="138.0">--cookie-secret 은 단수</text>
 </g>
 <g id="node-ticket">
-<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="429-438" x="80.5" y="253.0" width="153.0" height="71.0" rx="7" />
+<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="429-438" x="77.0" y="253.0" width="160.0" height="71.0" rx="7" />
 <text class="node-label" x="157.0" y="280.0">쿠키의 티켓</text>
-<line class="node-detail-divider" x1="94.5" y1="301.0" x2="219.5" y2="301.0" />
-<text class="node-detail" x="96.5" y="318.0">secret 을 바꾸면 못 푼다</text>
+<line class="node-detail-divider" x1="91.0" y1="301.0" x2="223.0" y2="301.0" />
+<text class="node-detail" x="93.0" y="318.0">secret 교체 시 복호화 불가</text>
 </g>
 <g id="node-redis-session">
 <rect class="node-shape kind-datastore emphasis-warning role-target" data-evidence="429-440" x="82.0" y="433.0" width="150.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-warning role-target" cx="157.0" cy="433.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 82.0 504.0 A 75.0 13.0 0 0 0 232.0 504.0" />
 <text class="node-label" x="157.0" y="460.0">Redis 의 세션</text>
 <line class="node-detail-divider" x1="96.0" y1="481.0" x2="218.0" y2="481.0" />
-<text class="node-detail" x="98.0" y="498.0">고아로 남는다</text>
+<text class="node-detail" x="98.0" y="498.0">고아 세션</text>
 </g>
 <g id="node-ttl">
 <rect class="node-shape kind-component emphasis-primary role-target" data-evidence="441-452" x="82.0" y="613.0" width="150.0" height="71.0" rx="7" />
 <text class="node-label" x="157.0" y="640.0">TTL</text>
 <line class="node-detail-divider" x1="96.0" y1="661.0" x2="218.0" y2="661.0" />
-<text class="node-detail" x="98.0" y="678.0">역산으로 고아를 고른다</text>
+<text class="node-detail" x="98.0" y="678.0">생성 시각 역산</text>
 </g>
 </svg>