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>
154 lines
4.2 KiB
JSON
154 lines
4.2 KiB
JSON
{
|
|
"version": "1.1",
|
|
"id": "a5-partition-asymmetry",
|
|
"title": "비대칭 차단은 가르지 못한다",
|
|
"question": "한 방향만 막으면 클러스터가 갈라지는가",
|
|
"type": "architecture",
|
|
"direction": "TB",
|
|
"audience": [
|
|
"네트워크 분단을 재현하려는 엔지니어"
|
|
],
|
|
"summary": "한 방향만 막으면 열린 방향으로 재연결한다. 양방향을 다 막아야 갈라지고, 갈라져도 한쪽만 DOWN 이 된다.",
|
|
"alt": "한 방향이 막혀도 반대 방향으로 연결이 성립하는 구성. 양방향을 다 막아야 두 멤버가 분리된다.",
|
|
"long_description": "JGroups 는 한 방향이 막혀도 열린 방향으로 재연결한다. 그래서 비대칭 차단으로는 cluster_size 가 2 로 유지된다. 양방향을 다 막으면 양쪽 모두 멤버 1개가 되지만 한쪽만 DOWN 이 된다. 코디네이터 쪽이 살아남고 분단된 쪽은 스스로 readiness 를 떨어뜨려 로드밸런서에서 빠지므로 외부 응답은 200 을 유지한다. 전면 장애 경로가 없다.",
|
|
"source_context": {
|
|
"document": "docs/keycloak-session-store/final/document.md",
|
|
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
|
|
"anchor": {
|
|
"kind": "heading",
|
|
"value": "A-5 · 비대칭 분단 — 전면 장애 경로가 없다",
|
|
"line": 246
|
|
}
|
|
},
|
|
"composition": {
|
|
"profile": "component-flow",
|
|
"diagram_only": true,
|
|
"reference_ids": [
|
|
"payment-event-flow"
|
|
],
|
|
"rationale": "차단 방향의 수가 결과를 가르는 것이 지배적 질문이다. 경로의 유무이므로 component-flow 를 골랐다."
|
|
},
|
|
"groups": [],
|
|
"nodes": [
|
|
{
|
|
"id": "k0",
|
|
"label": "keycloak-0",
|
|
"kind": "service",
|
|
"role": "source",
|
|
"emphasis": "primary",
|
|
"description": "코디네이터. 분단돼도 살아남는다.",
|
|
"details": [
|
|
"cluster_size 1"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 226,
|
|
"end_line": 236
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "fwd",
|
|
"label": "막은 방향",
|
|
"kind": "channel",
|
|
"role": "control",
|
|
"emphasis": "warning",
|
|
"description": "raw 테이블 PREROUTING 에서 끊는다.",
|
|
"details": [
|
|
"conntrack 보다 먼저"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 226,
|
|
"end_line": 236
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "k1",
|
|
"label": "keycloak-1",
|
|
"kind": "service",
|
|
"role": "target",
|
|
"emphasis": "normal",
|
|
"description": "분단되면 스스로 로드밸런서에서 빠진다.",
|
|
"details": [
|
|
"readiness 실패"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 226,
|
|
"end_line": 236
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "rev",
|
|
"label": "열린 반대 방향",
|
|
"kind": "channel",
|
|
"role": "support",
|
|
"emphasis": "normal",
|
|
"description": "비대칭 차단에서는 여기로 재연결한다.",
|
|
"details": [
|
|
"가르지 못한다"
|
|
],
|
|
"evidence": [
|
|
{
|
|
"start_line": 226,
|
|
"end_line": 232
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"edges": [
|
|
{
|
|
"id": "k0-f",
|
|
"from": "k0",
|
|
"to": "fwd",
|
|
"label": "JGroups 메시지",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 226,
|
|
"end_line": 232
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "f-k1",
|
|
"from": "fwd",
|
|
"to": "k1",
|
|
"label": "막혀서 닿지 않는다",
|
|
"kind": "blocked",
|
|
"evidence": [
|
|
{
|
|
"start_line": 226,
|
|
"end_line": 232
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "k1-rev",
|
|
"from": "k1",
|
|
"to": "rev",
|
|
"label": "반대 방향으로 재연결",
|
|
"kind": "request",
|
|
"evidence": [
|
|
{
|
|
"start_line": 226,
|
|
"end_line": 232
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"legend": [],
|
|
"metadata": {
|
|
"rationale": "방향 하나를 막는 것과 둘을 막는 것의 차이를 그렸다. 주입이 세 번 실패한 곳이기도 하다."
|
|
}
|
|
} |