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
@@ -4,7 +4,7 @@
"title": "실험대의 구성",
"question": "이 실험들은 어떤 기계 위에서 돌았는가",
"type": "architecture",
"direction": "TB",
"direction": "LR",
"audience": [
"같은 실험을 재현하려는 백엔드 엔지니어"
],
@@ -13,20 +13,20 @@
"long_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 으로 들어 있다.",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
"document_sha256": "28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560",
"anchor": {
"kind": "heading",
"value": "실험대",
"line": 85
"line": 120
}
},
"composition": {
"profile": "query-fanout",
"profile": "component-flow",
"diagram_only": true,
"reference_ids": [
"metrics-query-fanout"
"payment-event-flow"
],
"rationale": "호스트 nginx 에서 들어온 요청이 traefik 을 거쳐 두 Keycloak 노드로 갈라지는 것이 이 절의 지배적 구조다. 하나의 진입점에서 여러 백엔드로 퍼지는 모양이므로 query-fanout 을 골랐다."
"rationale": "호스트 nginx에서 traefik과 Keycloak, 저장소로 이어지는 실제 배치 경로가 지배적 질문이다. current context가 선택한 component-flow 문법을 사용한다."
},
"groups": [],
"nodes": [
@@ -42,8 +42,8 @@
],
"evidence": [
{
"start_line": 88,
"end_line": 92
"start_line": 123,
"end_line": 127
}
],
"assumption": false
@@ -60,8 +60,8 @@
],
"evidence": [
{
"start_line": 85,
"end_line": 87
"start_line": 120,
"end_line": 122
}
],
"assumption": false
@@ -78,8 +78,8 @@
],
"evidence": [
{
"start_line": 85,
"end_line": 86
"start_line": 120,
"end_line": 120
}
],
"assumption": false
@@ -96,8 +96,8 @@
],
"evidence": [
{
"start_line": 86,
"end_line": 87
"start_line": 122,
"end_line": 122
}
],
"assumption": false
@@ -114,8 +114,8 @@
],
"evidence": [
{
"start_line": 86,
"end_line": 87
"start_line": 122,
"end_line": 122
}
],
"assumption": false
@@ -130,8 +130,8 @@
"kind": "request",
"evidence": [
{
"start_line": 88,
"end_line": 92
"start_line": 123,
"end_line": 127
}
],
"assumption": false
@@ -144,8 +144,8 @@
"kind": "request",
"evidence": [
{
"start_line": 85,
"end_line": 87
"start_line": 120,
"end_line": 122
}
],
"assumption": false
@@ -158,8 +158,8 @@
"kind": "request",
"evidence": [
{
"start_line": 85,
"end_line": 87
"start_line": 120,
"end_line": 122
}
],
"assumption": false
@@ -172,8 +172,8 @@
"kind": "read",
"evidence": [
{
"start_line": 86,
"end_line": 87
"start_line": 122,
"end_line": 122
}
],
"assumption": false
@@ -183,4 +183,4 @@
"metadata": {
"rationale": "저장소가 kc-lab-2 한 곳에 몰린 것을 그림에서 읽히게 배치했다. A-4 의 두 결과가 이 배치에서 갈린다."
}
}
}