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>
152 lines
4.2 KiB
JSON
152 lines
4.2 KiB
JSON
{
|
|
"version": "1.1",
|
|
"id": "a4-two-node-losses",
|
|
"title": "노드를 잃는 두 가지",
|
|
"question": "워커를 잃는 것과 컨트롤 플레인을 잃는 것은 어떻게 다른가",
|
|
"type": "architecture",
|
|
"direction": "TB",
|
|
"audience": [
|
|
"단일 노드 의존을 점검하려는 운영 엔지니어"
|
|
],
|
|
"summary": "둘 다 전면 장애지만 이유가 다르다. 하나는 저장소가 같이 죽어서, 하나는 들어갈 길이 없어서다.",
|
|
"alt": "kc-lab-2 를 잃으면 데이터베이스가 함께 사라지고, kc-lab-1 을 잃으면 진입 경로가 사라지는 구성.",
|
|
"long_description": "kc-lab-2 를 잃으면 keycloak-1 은 살아 있지만 PostgreSQL 이 같이 죽어 외부 응답이 503 이 된다. kc-lab-1 을 잃으면 keycloak-0 은 계속 돌고 있는데 traefik 과 API 서버가 사라져 연결 자체가 안 된다. 워크로드가 멀쩡한데 도달할 수 없어 장애다. 진입점이 단일 노드에 있으면 워크로드 이중화는 의미가 없다.",
|
|
"source_context": {
|
|
"document": "docs/keycloak-session-store/final/document.md",
|
|
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
|
|
"anchor": {
|
|
"kind": "heading",
|
|
"value": "A-4 · 노드 상실 — 둘 다 전면 장애지만 이유가 다르다",
|
|
"line": 223
|
|
}
|
|
},
|
|
"composition": {
|
|
"profile": "component-flow",
|
|
"diagram_only": true,
|
|
"reference_ids": [
|
|
"payment-event-flow"
|
|
],
|
|
"rationale": "같은 결과를 내는 두 원인을 가르는 것이 지배적 질문이다. 경로의 차단 지점이 다르므로 component-flow 를 골랐다."
|
|
},
|
|
"groups": [],
|
|
"nodes": [
|
|
{
|
|
"id": "client",
|
|
"label": "외부 요청",
|
|
"kind": "actor",
|
|
"role": "source",
|
|
"emphasis": "primary",
|
|
"description": "사용자.",
|
|
"details": [],
|
|
"evidence": [
|
|
{
|
|
"start_line": 221,
|
|
"end_line": 228
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "entry",
|
|
"label": "진입 경로 (kc-lab-1)",
|
|
"kind": "gateway",
|
|
"role": "control",
|
|
"emphasis": "warning",
|
|
"description": "traefik 과 API 서버. 잃으면 000 이다.",
|
|
"details": [
|
|
"kubectl 도 불통"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 221,
|
|
"end_line": 231
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "workload",
|
|
"label": "keycloak-0 (kc-lab-2)",
|
|
"kind": "service",
|
|
"role": "control",
|
|
"emphasis": "normal",
|
|
"description": "4b 에서는 계속 돌고 있었다.",
|
|
"details": [
|
|
"도달할 수 없을 뿐이다"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 221,
|
|
"end_line": 231
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "store",
|
|
"label": "PostgreSQL (kc-lab-2)",
|
|
"kind": "datastore",
|
|
"role": "target",
|
|
"emphasis": "warning",
|
|
"description": "4a 에서 함께 죽는다. 잃으면 503 이다.",
|
|
"details": [
|
|
"local-path PVC 라 재배치 불가"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 221,
|
|
"end_line": 233
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"edges": [
|
|
{
|
|
"id": "c-e",
|
|
"from": "client",
|
|
"to": "entry",
|
|
"label": "요청",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 221,
|
|
"end_line": 228
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "e-w",
|
|
"from": "entry",
|
|
"to": "workload",
|
|
"label": "라우팅",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 221,
|
|
"end_line": 228
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "w-s",
|
|
"from": "workload",
|
|
"to": "store",
|
|
"label": "세션 조회",
|
|
"kind": "read",
|
|
"evidence": [
|
|
{
|
|
"start_line": 221,
|
|
"end_line": 233
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"legend": [],
|
|
"metadata": {
|
|
"rationale": "저장소 상실과 진입 경로 상실을 한 그림에서 갈랐다. 복구 시간이 같아도 대비가 다르다."
|
|
}
|
|
} |