refactor: 문서 개선 중

This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -0,0 +1,88 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="1333" height="300" viewBox="0 0 1333 300" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">테스트가 끊긴 곳과 실제 런타임이 지나는 합성 루트</title>
<desc id="diagram-description">왼쪽에서 오른쪽으로 실제 런타임 경로를 읽는다. 화면에서 게이트웨이로 가고 합성 루트에서 credential을 결정한 뒤 실제 런타임 어댑터가 배포된 백엔드의 실제 404 본문을 읽는다. 화면 테스트는 게이트웨이를 스텁하고 게이트웨이 테스트는 실행기를 스텁했기 때문에 가운데 합성 루트의 credential 결정은 두 테스트가 지나지 않았다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;composition-root-seam&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/TechLog/final/document.md&quot;,&quot;document_sha256&quot;:&quot;c3a7de37b778fff7b6ea555a3ad7338c91c6fb15d685e7734f89472b4924d955&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;7. 테스트가 지나지 않는 이음매&quot;,&quot;line&quot;:690}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;: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="1333" height="300" />
<polyline class="edge kind-request style-solid emphasis-normal" points="620.0,104.0 700.0,104.0 700.0,104.0 780.0,104.0" data-evidence="766-771" />
<rect class="edge-label-bg" x="657.5" y="62.0" width="85.0" height="22" rx="3" />
<text class="edge-label" x="700.0" y="77.0">runtime 조립</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="947.0,104.0 1027.0,104.0 1027.0,104.0 1107.0,104.0" data-evidence="755-767,769-771" />
<rect class="edge-label-bg" x="974.5" y="62.0" width="105.1" height="22" rx="3" />
<text class="edge-label" x="1027.0" y="77.0">credential 판정</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="244.0,104.0 324.0,104.0 324.0,104.0 404.0,104.0" data-evidence="740-742,766-771" />
<rect class="edge-label-bg" x="302.0" y="62.0" width="44.0" height="22" rx="3" />
<text class="edge-label" x="324.0" y="77.0">요청</text>
<g id="node-screen">
<rect class="node-shape kind-component emphasis-normal role-source" data-evidence="740-742,770-771" x="70.0" y="68.5" width="174.0" height="71.0" rx="7" />
<text class="node-label" x="157.0" y="95.5">화면</text>
<line class="node-detail-divider" x1="84.0" y1="116.5" x2="230.0" y2="116.5" />
<text class="node-detail" x="86.0" y="133.5">화면 테스트: gateway stub</text>
</g>
<g id="node-gateway">
<rect class="node-shape kind-service emphasis-normal role-service" data-evidence="766-771" x="404.0" y="68.5" width="216.0" height="71.0" rx="7" />
<text class="node-label" x="512.0" y="95.5">Gateway</text>
<line class="node-detail-divider" x1="418.0" y1="116.5" x2="606.0" y2="116.5" />
<text class="node-detail" x="420.0" y="133.5">gateway 테스트: executor stub</text>
</g>
<g id="node-composition-root">
<rect class="node-shape kind-component emphasis-warning role-service" data-evidence="748-767" x="780.0" y="60.0" width="167.0" height="88.0" rx="7" />
<text class="node-label" x="863.5" y="87.0">Composition Root</text>
<line class="node-detail-divider" x1="794.0" y1="108.0" x2="933.0" y2="108.0" />
<text class="node-detail" x="796.0" y="125.0">credential decision</text>
<text class="node-detail" x="796.0" y="141.0">테스트 공백</text>
</g>
<g id="node-runtime-adapter">
<rect class="node-shape kind-service emphasis-normal role-sink" data-evidence="769-771" x="1107.0" y="60.0" width="181.0" height="88.0" rx="7" />
<text class="node-label" x="1197.5" y="87.0">Runtime Adapter + 404</text>
<line class="node-detail-divider" x1="1121.0" y1="108.0" x2="1274.0" y2="108.0" />
<text class="node-detail" x="1123.0" y="125.0">실제 어댑터</text>
<text class="node-detail" x="1123.0" y="141.0">배포된 백엔드 404 본문</text>
</g>
</svg>

After

Width:  |  Height:  |  Size: 7.1 KiB