DongHyeonkaandClaude Opus 5
75bed382c8
The originating repository's SVGs were drawn by hand and every one of them
put a title, a subtitle and an explanation band inside the canvas. This
repository forbids both, so they could not be carried over — the whole set
was rebuilt through the skill's pipeline instead.
Each diagram went through prepare, references, prompt, a VizSpec 1.1 citing
document line ranges, lint, and render. All 28 pass lint and produce the
same eight formats the existing keycloak project has. Sentences moved out of
the canvas into <desc> and the paragraph beside each figure; the drawings
carry names only.
Two lint rules did real work rather than formatting work:
edge-through-node caught arrows crossing an unrelated
node and implying an adjacency that
does not exist — four diagrams had to
be restructured, not just relaid out
evidence-outside-prepared-context caught a diagram citing another
section; its anchor moved from B-0 to
B-1 so all three sections it draws on
are inside the prepared context
lab-topology also had to change profile: its context offers a different
candidate set, and query-fanout with shard roles is what the section
actually shows — one entry point spreading to two Keycloak nodes.
The document now carries all 28 inline, one per claim that needed one, and
the section recording what was still missing is updated: the diagram gap is
closed, Studio records remain.
verify-pipeline.py passes. audit-records.py reports no issues.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
85 lines
7.3 KiB
XML
85 lines
7.3 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="716" viewBox="0 0 680 716" role="img" aria-labelledby="diagram-title diagram-description">
|
|
<title id="diagram-title">캐시 온도가 결과를 가른다</title>
|
|
<desc id="diagram-description">volatile 모드에서 로그인은 SQL 을 0개 쏜다. refresh 는 딱 한 문장을 쏘는데 CLIENT_SCOPE_CLIENT 의 선택적 스코프 조회이며, 그것도 첫 번째만 쏘고 이후 캐시된다. 그래서 DB 를 세웠을 때 완전 냉시동이면 클라이언트 조회부터 실패해 로그인이 400 이고, CLIENT 캐시만 더우면 refresh 가 500 이며, 완전히 더우면 둘 다 200 이다. A-7 이 표에 적은 것은 그 사이의 한 상태였다.</desc>
|
|
<metadata>{"techviz":{"spec_version":"1.1","id":"cache-temperature-outcomes","profile":"component-flow"},"source_context":{"document":"docs/keycloak-session-store/final/document.md","document_sha256":"1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe","anchor":{"kind":"heading","value":"A-7 · A-7a — 전부 뒤집는 설정 하나, 그리고 그 표에도 조건이 있었다","line":283}},"evidence_policy":"Each factual element cites source lines or is marked assumption.","diagram_only":true}</metadata>
|
|
<defs>
|
|
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
|
|
<path d="M 0 0 L 10 5 L 0 10 z" />
|
|
</marker>
|
|
<style>
|
|
:root { color-scheme: light; }
|
|
text { font-family: Inter, Pretendard, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #111827; }
|
|
.canvas { fill: #ffffff; }
|
|
.group-box { fill: #ffffff; stroke: #9ca3af; stroke-width: 1.4; stroke-dasharray: 7 5; }
|
|
.group-label-bg { fill: #ffffff; }
|
|
.group-label { font-size: 13px; font-weight: 650; fill: #374151; }
|
|
.edge { fill: none; stroke: #374151; stroke-width: 1.8; stroke-linejoin: round; stroke-linecap: round; marker-end: url(#arrow); }
|
|
.edge.style-dashed, .edge.semantic-dashed, .edge.assumption { stroke-dasharray: 7 5; }
|
|
.edge.style-dotted { stroke-dasharray: 2 5; }
|
|
.edge.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
|
|
.edge.emphasis-muted { stroke: #9ca3af; }
|
|
.edge.emphasis-warning, .edge.kind-failure, .edge.kind-error { stroke: #dc2626; stroke-width: 2.2; }
|
|
.edge-label-bg { fill: #ffffff; }
|
|
.edge-label { font-size: 12px; font-weight: 560; text-anchor: middle; }
|
|
.node-shape { fill: #ffffff; stroke: #4b5563; stroke-width: 1.7; }
|
|
.node-shape.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
|
|
.node-shape.emphasis-muted { stroke: #9ca3af; fill: #f9fafb; }
|
|
.node-shape.emphasis-warning { stroke: #d97706; stroke-width: 2; fill: #fffdf5; }
|
|
.node-shape.kind-database, .node-shape.kind-datastore, .node-shape.kind-storage { fill: #f8fafc; }
|
|
.node-shape.kind-queue, .node-shape.kind-event, .node-shape.kind-topic { fill: #fafafa; }
|
|
.node-shape.assumption { stroke-dasharray: 4 4; }
|
|
.storage-bottom, .controller-divider { fill: none; stroke: #4b5563; stroke-width: 1.4; }
|
|
.controller-led { fill: #4b5563; }
|
|
.actor-symbol { fill: none; stroke: #4b5563; stroke-width: 1.8; stroke-linecap: round; }
|
|
.actor-symbol.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
|
|
.node-label { font-size: 14px; font-weight: 650; text-anchor: middle; }
|
|
.node-role { font-size: 10px; letter-spacing: 0.04em; text-anchor: middle; fill: #6b7280; }
|
|
.node-detail-divider { stroke: #d1d5db; stroke-width: 1; }
|
|
.node-detail { font-size: 11px; fill: #374151; }
|
|
.assumption-badge { font-size: 9px; font-weight: 700; fill: #92400e; }
|
|
.failure-mark { stroke: #dc2626; stroke-width: 4; stroke-linecap: round; }
|
|
.lifeline { stroke: #9ca3af; stroke-width: 1.2; stroke-dasharray: 5 5; }
|
|
.timeline-axis { stroke: #374151; stroke-width: 1.8; marker-end: url(#arrow); }
|
|
.timeline-stem { stroke: #6b7280; stroke-width: 1.3; }
|
|
.timeline-marker { fill: #ffffff; stroke: #374151; stroke-width: 1.7; }
|
|
.timeline-marker.primary { fill: #2563eb; stroke: #2563eb; }
|
|
.timeline-marker.warning { fill: #dc2626; stroke: #dc2626; }
|
|
.timeline-label { font-size: 13px; font-weight: 650; text-anchor: middle; }
|
|
.timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
|
|
</style>
|
|
</defs>
|
|
<rect class="canvas" width="680" height="716" />
|
|
<polyline class="edge kind-read style-solid emphasis-normal" points="181.5,311.0 181.5,359.0 181.5,359.0 181.5,407.0" data-evidence="284-292" />
|
|
<rect class="edge-label-bg" x="122.8" y="345.0" width="165.4" height="22" rx="3" />
|
|
<text class="edge-label" x="205.5" y="360.0">refresh 는 스코프도 다시 계산한다</text>
|
|
<polyline class="edge kind-read style-solid emphasis-normal" points="181.5,144.0 181.5,192.0 181.5,192.0 181.5,240.0" data-evidence="306-312" />
|
|
<rect class="edge-label-bg" x="169.7" y="178.0" width="71.6" height="22" rx="3" />
|
|
<text class="edge-label" x="205.5" y="193.0">클라이언트 확인</text>
|
|
<polyline class="edge kind-read style-solid emphasis-normal" points="181.5,478.0 181.5,526.0 181.5,526.0 181.5,574.0" data-evidence="296-302" />
|
|
<rect class="edge-label-bg" x="146.2" y="512.0" width="118.5" height="22" rx="3" />
|
|
<text class="edge-label" x="205.5" y="527.0">캐시에 없으면 여기까지 간다</text>
|
|
<g id="node-request">
|
|
<g class="actor-symbol emphasis-primary" data-evidence="284-296"><circle cx="181.5" cy="80.0" r="11.0" /><line x1="181.5" y1="96.0" x2="181.5" y2="105.0" /><line x1="163.5" y1="106.0" x2="199.5" y2="106.0" /><line x1="181.5" y1="105.0" x2="166.5" y2="122.0" /><line x1="181.5" y1="105.0" x2="196.5" y2="122.0" /></g>
|
|
<text class="node-label" x="181.5" y="137.0">로그인 · refresh 요청</text>
|
|
</g>
|
|
<g id="node-client-lookup">
|
|
<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="306-312" x="70.0" y="240.0" width="223.0" height="71.0" rx="7" />
|
|
<text class="node-label" x="181.5" y="267.0">CLIENT 조회</text>
|
|
<line class="node-detail-divider" x1="84.0" y1="288.0" x2="279.0" y2="288.0" />
|
|
<text class="node-detail" x="86.0" y="305.0">select ce1_0.ID from CLIENT</text>
|
|
</g>
|
|
<g id="node-scope-lookup">
|
|
<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="284-292" x="70.0" y="407.0" width="223.0" height="71.0" rx="7" />
|
|
<text class="node-label" x="181.5" y="434.0">CLIENT_SCOPE_CLIENT 조회</text>
|
|
<line class="node-detail-divider" x1="84.0" y1="455.0" x2="279.0" y2="455.0" />
|
|
<text class="node-detail" x="86.0" y="472.0">DEFAULT_SCOPE='f' — 선택적 스코프</text>
|
|
</g>
|
|
<g id="node-db">
|
|
<rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="296-302" x="106.5" y="587.0" width="150.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="181.5" cy="587.0" rx="75.0" ry="13.0" /><path class="storage-bottom" d="M 106.5 658.0 A 75.0 13.0 0 0 0 256.5 658.0" />
|
|
<text class="node-label" x="181.5" y="614.0">PostgreSQL</text>
|
|
<line class="node-detail-divider" x1="120.5" y1="635.0" x2="242.5" y2="635.0" />
|
|
<text class="node-detail" x="122.5" y="652.0">캐시에 있으면 닿지 않는다</text>
|
|
</g>
|
|
</svg>
|