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
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="690" viewBox="0 0 680 690" role="img" aria-labelledby="diagram-title diagram-description">
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="1215" viewBox="0 0 680 1215" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">백채널 로그아웃은 양쪽이 있어야 한다</title>
<desc id="diagram-description">C-1 에서 로그아웃이 다른 앱으로 퍼지지 않는 것을 관측했고 원인은 단순했다. 두 클라이언트 모두 backchannelLogoutUrl 이 비어 있어 Keycloak 은 부를 주소를 몰랐고, BFF 소스에는 oidcLogout 설정이 없어 주소를 알려줘도 받을 곳이 없었다. Keycloak 파드에서 앱 URL 로 요청하면 200 이 돌아오므로 네트워크 문제도 아니다. 설정이 빠졌다와 기능이 없다는 다르게 고쳐야 하는데 여기는 둘 다였다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;c2-backchannel-both-sides&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;C층 — SSO 와 로그아웃 전파&quot;,&quot;line&quot;:464}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;c2-backchannel-both-sides&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;C층 — SSO 와 로그아웃 전파&quot;,&quot;line&quot;:964}},&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" />
@@ -49,36 +49,36 @@
.timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
</style>
</defs>
<rect class="canvas" width="680" height="690" />
<polyline class="edge kind-blocked style-solid emphasis-normal" points="157.0,311.0 157.0,359.0 157.0,359.0 157.0,407.0" data-evidence="458-466" />
<rect class="edge-label-bg" x="138.5" y="345.0" width="85.0" height="22" rx="3" />
<text class="edge-label" x="181.0" y="360.0">호출 (주소 필요)</text>
<polyline class="edge kind-blocked style-solid emphasis-normal" points="157.0,478.0 157.0,526.0 157.0,526.0 157.0,574.0" data-evidence="458-466" />
<rect class="edge-label-bg" x="118.4" y="512.0" width="125.2" height="22" rx="3" />
<text class="edge-label" x="181.0" y="527.0">세션 삭제 (엔드포인트 필요)</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="157.0,144.0 157.0,192.0 157.0,192.0 157.0,240.0" data-evidence="458-466" />
<rect class="edge-label-bg" x="145.2" y="178.0" width="71.6" height="22" rx="3" />
<text class="edge-label" x="181.0" y="193.0">통지 주소 조회</text>
<rect class="canvas" width="680" height="1215" />
<polyline class="edge kind-blocked style-solid emphasis-normal" points="128.5,526.0 128.5,657.5 116.5,657.5 116.5,789.0" data-evidence="952-966" />
<rect class="edge-label-bg" x="80.0" y="615.5" width="85.0" height="22" rx="3" />
<text class="edge-label" x="122.5" y="630.5">호출 (주소 필요)</text>
<polyline class="edge kind-blocked style-solid emphasis-normal" points="116.5,860.0 116.5,979.5 116.5,979.5 116.5,1099.0" data-evidence="952-966" />
<rect class="edge-label-bg" x="77.9" y="965.5" width="125.2" height="22" rx="3" />
<text class="edge-label" x="140.5" y="980.5">세션 삭제 (엔드포인트 필요)</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="110.0,229.0 110.0,342.0 128.5,342.0 128.5,455.0" data-evidence="952-966" />
<rect class="edge-label-bg" x="83.5" y="300.0" width="71.6" height="22" rx="3" />
<text class="edge-label" x="119.2" y="315.0">통지 주소 조회</text>
<g id="node-logout">
<g class="actor-symbol emphasis-primary" data-evidence="458-465"><circle cx="157.0" cy="80.0" r="11.0" /><line x1="157.0" y1="96.0" x2="157.0" y2="105.0" /><line x1="139.0" y1="106.0" x2="175.0" y2="106.0" /><line x1="157.0" y1="105.0" x2="142.0" y2="122.0" /><line x1="157.0" y1="105.0" x2="172.0" y2="122.0" /></g>
<text class="node-label" x="157.0" y="137.0">한 앱의 로그아웃</text>
<g class="actor-symbol emphasis-primary" data-evidence="952-957"><circle cx="110.0" cy="165.0" r="11.0" /><line x1="110.0" y1="181.0" x2="110.0" y2="200.0" /><line x1="92.0" y1="191.0" x2="128.0" y2="191.0" /><line x1="110.0" y1="200.0" x2="95.0" y2="217.0" /><line x1="110.0" y1="200.0" x2="125.0" y2="217.0" /></g>
<text class="node-label" x="110.0" y="222.0">한 앱의 로그아웃</text>
</g>
<g id="node-kc-config">
<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="458-466" x="70.0" y="240.0" width="174.0" height="71.0" rx="7" />
<text class="node-label" x="157.0" y="267.0">backchannelLogoutUrl</text>
<line class="node-detail-divider" x1="84.0" y1="288.0" x2="230.0" y2="288.0" />
<text class="node-detail" x="86.0" y="305.0">주소 없음</text>
<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="952-966" x="41.5" y="455.0" width="174.0" height="71.0" rx="7" />
<text class="node-label" x="128.5" y="482.0">backchannelLogoutUrl</text>
<line class="node-detail-divider" x1="55.5" y1="503.0" x2="201.5" y2="503.0" />
<text class="node-detail" x="57.5" y="520.0">주소 없음</text>
</g>
<g id="node-app-endpoint">
<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="458-466" x="82.0" y="407.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="157.0" y="434.0">앱의 수신 엔드포인트</text>
<line class="node-detail-divider" x1="96.0" y1="455.0" x2="218.0" y2="455.0" />
<text class="node-detail" x="98.0" y="472.0">oidcLogout 설정 없음</text>
<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="952-966" x="41.5" y="789.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="116.5" y="816.0">앱의 수신 엔드포인트</text>
<line class="node-detail-divider" x1="55.5" y1="837.0" x2="177.5" y2="837.0" />
<text class="node-detail" x="57.5" y="854.0">oidcLogout 설정 없음</text>
</g>
<g id="node-app-session">
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="458-466" x="82.0" y="574.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="157.0" y="601.0">다른 앱의 세션</text>
<line class="node-detail-divider" x1="96.0" y1="622.0" x2="218.0" y2="622.0" />
<text class="node-detail" x="98.0" y="639.0">네트워크 도달 200</text>
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="952-966" x="41.5" y="1099.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="116.5" y="1126.0">다른 앱의 세션</text>
<line class="node-detail-divider" x1="55.5" y1="1147.0" x2="177.5" y2="1147.0" />
<text class="node-detail" x="57.5" y="1164.0">네트워크 도달 200</text>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 7.1 KiB

After

Width:  |  Height:  |  Size: 7.1 KiB