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
@@ -5,7 +5,7 @@
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
-        <mxCell id="n_client" value="클라이언트&lt;br/&gt;로그인 153건 성공" tooltip="200 과 토큰을 받는다. | Evidence: L207-L213" 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">
+        <mxCell id="n_client" value="클라이언트&lt;br/&gt;성공 응답 153건" tooltip="200 과 토큰을 받는다. | Evidence: L207-L213" 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="134.5" y="60.0" width="150.0" height="84.0" as="geometry"/>
        </mxCell>
        <mxCell id="n_keycloak" value="Keycloak&lt;br/&gt;SET LOCAL synchronous_commit TO OFF" tooltip="트랜잭션마다 synchronous_commit 을 끈다. | Evidence: L211-L215" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
@@ -14,7 +14,7 @@
        <mxCell id="n_pg" value="PostgreSQL&lt;br/&gt;wal_writer_delay 200ms" tooltip="COMMIT 을 즉시 반환한다. WAL 은 아직 메모리에 있다. | Evidence: L211-L215" 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="115.5" y="407.0" width="188.0" height="97.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_disk" value="디스크의 WAL&lt;br/&gt;DB 에 실제로 존재 149건" tooltip="여기 닿아야 살아남는다. | Evidence: L207-L215" 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_disk" value="디스크의 WAL&lt;br/&gt;DB 존재 149건" tooltip="여기 닿아야 살아남는다. | Evidence: L207-L215" 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="134.5" y="600.0" width="150.0" height="97.0" as="geometry"/>
        </mxCell>
        <mxCell id="e_c-k" 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" target="n_keycloak">
@@ -361,11 +361,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "클라이언트\n로그인 153건 성공",
+      "text": "클라이언트\n성공 응답 153건",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "클라이언트\n로그인 153건 성공",
+      "originalText": "클라이언트\n성공 응답 153건",
      "autoResize": true,
      "lineHeight": 1.25
    },
@@ -568,11 +568,11 @@
      "locked": false,
      "fontSize": 15,
      "fontFamily": 5,
-      "text": "디스크의 WAL\nDB 에 실제로 존재 149건",
+      "text": "디스크의 WAL\nDB 존재 149건",
      "textAlign": "center",
      "verticalAlign": "middle",
      "containerId": null,
-      "originalText": "디스크의 WAL\nDB 에 실제로 존재 149건",
+      "originalText": "디스크의 WAL\nDB 존재 149건",
      "autoResize": true,
      "lineHeight": 1.25
    }
@@ -2,7 +2,7 @@
  "harness_version": "0.2.0",
  "spec_id": "a3-commit-to-disk-gap",
  "spec_version": "1.1",
-  "spec_sha256": "29e279f39e07ba519e4e0685e5719d5d63b3ecf8b61a18816cbd5a1529baf854",
+  "spec_sha256": "1dfb52c8df3953df103ea2d515cf5a4f3cfed507d286e093fad31b583a851ce2",
  "source_context": {
    "document": "docs/keycloak-session-store/final/document.md",
    "document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
@@ -79,6 +79,6 @@
 <rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="207-215" x="134.5" y="613.0" width="150.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="209.5" cy="613.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 134.5 684.0 A 75.0 13.0 0 0 0 284.5 684.0" />
 <text class="node-label" x="209.5" y="640.0">디스크의 WAL</text>
 <line class="node-detail-divider" x1="148.5" y1="661.0" x2="270.5" y2="661.0" />
-<text class="node-detail" x="150.5" y="678.0">DB 에 실제로 존재 149건</text>
+<text class="node-detail" x="150.5" y="678.0">DB 존재 149건</text>
 </g>
 </svg>