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>
98 lines
7.8 KiB
XML
98 lines
7.8 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<svg xmlns="http://www.w3.org/2000/svg" width="1045" height="456" viewBox="0 0 1045 456" role="img" aria-labelledby="diagram-title diagram-description">
|
|
<title id="diagram-title">실험대의 구성</title>
|
|
<desc id="diagram-description">베어메탈 test-server 위에 VM 두 대를 올렸다. kc-lab-1 이 k3s server 이자 컨트롤 플레인이고 keycloak-1 이 여기 있다. kc-lab-2 는 agent 이며 keycloak-0 과 PostgreSQL, Redis 가 함께 있다. 저장소가 한 노드에 몰려 있어 그 노드를 잃으면 DB 도 같이 잃는다. 호스트 nginx 가 Let's Encrypt 인증서로 TLS 를 끝내고 traefik 으로 넘기며, 인증서 하나에 auth·app1·app2 세 이름이 SAN 으로 들어 있다.</desc>
|
|
<metadata>{"techviz":{"spec_version":"1.1","id":"lab-topology","profile":"query-fanout"},"source_context":{"document":"docs/keycloak-session-store/final/document.md","document_sha256":"1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe","anchor":{"kind":"heading","value":"실험대","line":85}},"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="1045" height="456" />
|
|
<polyline class="edge kind-read style-solid emphasis-normal" points="1000.0,211.0 872.5,211.0 872.5,338.5 745.0,338.5" data-evidence="86-87" />
|
|
<rect class="edge-label-bg" x="870.8" y="260.8" width="51.5" height="22" rx="3" />
|
|
<text class="edge-label" x="896.5" y="275.8">같은 노드</text>
|
|
<polyline class="edge kind-request style-solid emphasis-normal" points="465.0,375.5 495.0,375.5 495.0,119.0 440.0,119.0 440.0,190.5 470.0,190.5" data-evidence="88-92" />
|
|
<rect class="edge-label-bg" x="489.9" y="170.0" width="58.2" height="22" rx="3" />
|
|
<text class="edge-label" x="519.0" y="185.0">TLS 종단</text>
|
|
<polyline class="edge kind-request style-solid emphasis-normal" points="645.0,199.5 695.0,199.5 695.0,211.0 745.0,211.0" data-evidence="85-87" />
|
|
<rect class="edge-label-bg" x="697.0" y="191.2" width="44.0" height="22" rx="3" />
|
|
<text class="edge-label" x="719.0" y="206.2">라우팅</text>
|
|
<polyline class="edge kind-request style-solid emphasis-normal" points="645.0,181.5 695.0,181.5 695.0,86.0 745.0,86.0" data-evidence="85-87" />
|
|
<rect class="edge-label-bg" x="697.0" y="119.8" width="44.0" height="22" rx="3" />
|
|
<text class="edge-label" x="719.0" y="134.8">라우팅</text>
|
|
<g id="node-traefik">
|
|
<polygon class="node-shape kind-gateway emphasis-normal role-control" data-evidence="85-87" points="557.5,155.0 645.0,190.5 557.5,226.0 470.0,190.5" />
|
|
<text class="node-label" x="557.5" y="182.0">traefik (kc-lab-1)</text>
|
|
<line class="node-detail-divider" x1="484.0" y1="203.0" x2="631.0" y2="203.0" />
|
|
<text class="node-detail" x="486.0" y="220.0">k3s server 노드</text>
|
|
</g>
|
|
<g id="node-keycloak-1">
|
|
<rect class="node-shape kind-service emphasis-primary role-shard" data-evidence="85-86" x="745.0" y="40.0" width="255.0" height="92.0" rx="7" />
|
|
<text class="node-role" x="872.5" y="59.0">«shard»</text>
|
|
<text class="node-label" x="872.5" y="86.0">keycloak-1</text>
|
|
<line class="node-detail-divider" x1="759.0" y1="107.0" x2="986.0" y2="107.0" />
|
|
<text class="node-detail" x="761.0" y="124.0">kc-lab-1</text>
|
|
</g>
|
|
<g id="node-keycloak-0">
|
|
<rect class="node-shape kind-service emphasis-primary role-shard" data-evidence="86-87" x="745.0" y="165.0" width="255.0" height="92.0" rx="7" />
|
|
<text class="node-role" x="872.5" y="184.0">«shard»</text>
|
|
<text class="node-label" x="872.5" y="211.0">keycloak-0</text>
|
|
<line class="node-detail-divider" x1="759.0" y1="232.0" x2="986.0" y2="232.0" />
|
|
<text class="node-detail" x="761.0" y="249.0">kc-lab-2</text>
|
|
</g>
|
|
<g id="node-stores">
|
|
<rect class="node-shape kind-datastore emphasis-warning role-store" data-evidence="86-87" x="745.0" y="303.0" width="255.0" height="71.0" /><ellipse class="node-shape kind-datastore emphasis-warning role-store" cx="872.5" cy="303.0" rx="127.5" ry="13.0" /><path class="storage-bottom" d="M 745.0 374.0 A 127.5 13.0 0 0 0 1000.0 374.0" />
|
|
<text class="node-label" x="872.5" y="330.0">PostgreSQL · Redis</text>
|
|
<line class="node-detail-divider" x1="759.0" y1="351.0" x2="986.0" y2="351.0" />
|
|
<text class="node-detail" x="761.0" y="368.0">kc-lab-2</text>
|
|
</g>
|
|
<g id="node-nginx">
|
|
<polygon class="node-shape kind-gateway emphasis-primary role-source" data-evidence="88-92" points="367.5,340.0 465.0,375.5 367.5,411.0 270.0,375.5" />
|
|
<text class="node-label" x="367.5" y="367.0">호스트 nginx</text>
|
|
<line class="node-detail-divider" x1="284.0" y1="388.0" x2="451.0" y2="388.0" />
|
|
<text class="node-detail" x="286.0" y="405.0">SAN: auth · app1 · app2</text>
|
|
</g>
|
|
</svg>
|