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="716" viewBox="0 0 680 716" role="img" aria-labelledby="diagram-title diagram-description">
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="1302" viewBox="0 0 680 1302" 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>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;cache-temperature-outcomes&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;A-7 · A-7a — 전부 뒤집는 설정 하나, 그리고 그 표에도 조건이 있었다&quot;,&quot;line&quot;:283}},&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;cache-temperature-outcomes&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;A-7 · A-7a — 전부 뒤집는 설정 하나, 그리고 그 표에도 조건이 있었다&quot;,&quot;line&quot;:644}},&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="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="173.1" y="345.0" width="64.9" height="22" rx="3" />
<text class="edge-label" x="205.5" y="360.0">스코프 재계산</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="179.8" y="512.0" width="51.5" height="22" rx="3" />
<text class="edge-label" x="205.5" y="527.0">캐시 미스</text>
<rect class="canvas" width="680" height="1302" />
<polyline class="edge kind-read style-solid emphasis-normal" points="153.0,526.0 153.0,682.0 135.5,682.0 135.5,838.0" data-evidence="646-652" />
<rect class="edge-label-bg" x="111.8" y="640.0" width="64.9" height="22" rx="3" />
<text class="edge-label" x="144.2" y="655.0">스코프 재계산</text>
<polyline class="edge kind-read style-solid emphasis-normal" points="110.0,229.0 110.0,342.0 153.0,342.0 153.0,455.0" data-evidence="667-673" />
<rect class="edge-label-bg" x="95.7" y="300.0" width="71.6" height="22" rx="3" />
<text class="edge-label" x="131.5" y="315.0">클라이언트 확인</text>
<polyline class="edge kind-read style-solid emphasis-normal" points="135.5,909.0 135.5,1047.5 116.5,1047.5 116.5,1186.0" data-evidence="657-662" />
<rect class="edge-label-bg" x="100.2" y="1005.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="126.0" y="1020.5">캐시 미스</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 class="actor-symbol emphasis-primary" data-evidence="646-657"><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">로그인 · 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>
<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="667-673" x="41.5" y="455.0" width="223.0" height="71.0" rx="7" />
<text class="node-label" x="153.0" y="482.0">CLIENT 조회</text>
<line class="node-detail-divider" x1="55.5" y1="503.0" x2="250.5" y2="503.0" />
<text class="node-detail" x="57.5" y="520.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="87.5" y="407.0" width="188.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="101.5" y1="455.0" x2="261.5" y2="455.0" />
<text class="node-detail" x="103.5" y="472.0">DEFAULT_SCOPE=&#x27;f&#x27;</text>
<rect class="node-shape kind-process emphasis-warning role-control" data-evidence="646-652" x="41.5" y="838.0" width="188.0" height="71.0" rx="7" />
<text class="node-label" x="135.5" y="865.0">CLIENT_SCOPE_CLIENT 조회</text>
<line class="node-detail-divider" x1="55.5" y1="886.0" x2="215.5" y2="886.0" />
<text class="node-detail" x="57.5" y="903.0">DEFAULT_SCOPE=&#x27;f&#x27;</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>
<rect class="node-shape kind-datastore emphasis-primary role-target" data-evidence="657-662" x="41.5" y="1197.8" width="150.0" height="47.3" /><ellipse class="node-shape kind-datastore emphasis-primary role-target" cx="116.5" cy="1197.8" rx="75.0" ry="11.8" /><path class="storage-bottom" d="M 41.5 1245.2 A 75.0 11.8 0 0 0 191.5 1245.2" />
<text class="node-label" x="116.5" y="1213.0">PostgreSQL</text>
<line class="node-detail-divider" x1="55.5" y1="1234.0" x2="177.5" y2="1234.0" />
<text class="node-detail" x="57.5" y="1251.0">캐시 미스 시에만 도달</text>
</g>
</svg>

Before

Width:  |  Height:  |  Size: 7.2 KiB

After

Width:  |  Height:  |  Size: 7.2 KiB