feat: 문서 구조 변경 및 tech-visual 스킬 추가
This commit is contained in:
DongHyeonka
@@ -0,0 +1,252 @@
|
||||
{
|
||||
"version": "1.1",
|
||||
"id": "topic-variant-model",
|
||||
"title": "주제 안의 축과 기록을 잇는 자리",
|
||||
"question": "하나의 질문에 대한 네 답을 무엇으로 담고, 기록은 어떻게 축에 걸리는가?",
|
||||
"type": "architecture",
|
||||
"direction": "LR",
|
||||
"audience": [
|
||||
"백엔드 개발자",
|
||||
"아키텍처 검토자"
|
||||
],
|
||||
"summary": "주제가 축의 이름을 정하고, 축의 값들이 그 아래 있고, record_variant 가 종류와 아이디 쌍으로 세 기록 테이블을 가리킨다.",
|
||||
"alt": "왼쪽부터 topic, topic_variant, record_variant 로 이어지고 record_variant 가 document·open_question·project_decision 세 테이블을 가리키는 구조도.",
|
||||
"long_description": "왼쪽에 topic 이 있고 variant_label 로 축의 이름을 스스로 정한다. 그 오른쪽에 topic_variant 가 있고 SPA, Mediator, BFF, Forward-Auth 같은 축의 값들을 담는다. 그 오른쪽에 record_variant 가 있고 어느 기록이 어느 축에 걸리는지를 종류와 아이디의 쌍으로 적는다. record_variant 는 오른쪽의 document, open_question, project_decision 세 테이블을 가리키는데, 기록이 종류마다 다른 테이블에 살기 때문에 외래키를 걸지 못하고 쌍으로만 가리킨다.",
|
||||
"source_context": {
|
||||
"document": "document.md",
|
||||
"document_sha256": "93b9fec4884efa0e6231de07dc27e2b0ac36c9052d3720e28d102d9747ac4f8f",
|
||||
"anchor": {
|
||||
"kind": "marker",
|
||||
"value": "topic-variant-model",
|
||||
"line": 1064
|
||||
}
|
||||
},
|
||||
"composition": {
|
||||
"profile": "component-flow",
|
||||
"diagram_only": true,
|
||||
"reference_ids": [
|
||||
"payment-event-flow"
|
||||
],
|
||||
"rationale": "본문은 topic 에서 topic_variant 로, 다시 record_variant 로 내려가고 그것이 세 기록 테이블을 가리키는 참조 방향을 적는다. 방향이 있는 참조 사슬이므로 component-flow 다. 자동 선택이 고른 후보(two-zone-pipeline, sequence, comparison)는 이 절에 시간 순서도 두 구역도 비교 대상도 없어서 맞지 않는다.",
|
||||
"focus_node": "record-variant"
|
||||
},
|
||||
"groups": [
|
||||
{
|
||||
"id": "record-tables",
|
||||
"label": "기록은 종류마다 다른 테이블에 산다",
|
||||
"kind": "system",
|
||||
"role": "zone",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1071,
|
||||
"end_line": 1073
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
}
|
||||
],
|
||||
"nodes": [
|
||||
{
|
||||
"id": "topic",
|
||||
"label": "topic",
|
||||
"kind": "database",
|
||||
"shape": "box",
|
||||
"role": "source",
|
||||
"details": [
|
||||
"variant_label 로 축 이름을 정한다"
|
||||
],
|
||||
"description": "주제. 축의 이름을 주제가 정한다.",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1057,
|
||||
"end_line": 1059
|
||||
},
|
||||
{
|
||||
"start_line": 1067,
|
||||
"end_line": 1068
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "topic-variant",
|
||||
"label": "topic_variant",
|
||||
"kind": "database",
|
||||
"shape": "box",
|
||||
"role": "store",
|
||||
"details": [
|
||||
"SPA · Mediator · BFF · Forward-Auth"
|
||||
],
|
||||
"description": "축의 값들.",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1060,
|
||||
"end_line": 1060
|
||||
},
|
||||
{
|
||||
"start_line": 1047,
|
||||
"end_line": 1048
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "record-variant",
|
||||
"label": "record_variant",
|
||||
"kind": "database",
|
||||
"shape": "box",
|
||||
"role": "store",
|
||||
"details": [
|
||||
"(kind, id) 쌍 · 외래키 없음"
|
||||
],
|
||||
"emphasis": "primary",
|
||||
"description": "어느 기록이 어느 축에 걸리는지 적는 자리. 외래키를 걸지 못한다.",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1061,
|
||||
"end_line": 1061
|
||||
},
|
||||
{
|
||||
"start_line": 1071,
|
||||
"end_line": 1073
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "document",
|
||||
"label": "document",
|
||||
"kind": "database",
|
||||
"shape": "box",
|
||||
"role": "store",
|
||||
"group": "record-tables",
|
||||
"description": "기록 테이블 하나.",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1071,
|
||||
"end_line": 1072
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "open-question",
|
||||
"label": "open_question",
|
||||
"kind": "database",
|
||||
"shape": "box",
|
||||
"role": "store",
|
||||
"group": "record-tables",
|
||||
"description": "기록 테이블 하나.",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1071,
|
||||
"end_line": 1072
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "project-decision",
|
||||
"label": "project_decision",
|
||||
"kind": "database",
|
||||
"shape": "box",
|
||||
"role": "store",
|
||||
"group": "record-tables",
|
||||
"description": "기록 테이블 하나.",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1071,
|
||||
"end_line": 1072
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
}
|
||||
],
|
||||
"edges": [
|
||||
{
|
||||
"id": "t1",
|
||||
"from": "topic",
|
||||
"to": "topic-variant",
|
||||
"label": "1 : N",
|
||||
"kind": "data",
|
||||
"style": "solid",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1057,
|
||||
"end_line": 1060
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "t2",
|
||||
"from": "topic-variant",
|
||||
"to": "record-variant",
|
||||
"label": "축에 건다",
|
||||
"kind": "data",
|
||||
"style": "solid",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1060,
|
||||
"end_line": 1061
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "t3",
|
||||
"from": "record-variant",
|
||||
"to": "document",
|
||||
"label": "(kind, id)",
|
||||
"kind": "data",
|
||||
"style": "dashed",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1061,
|
||||
"end_line": 1073
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "t4",
|
||||
"from": "record-variant",
|
||||
"to": "open-question",
|
||||
"label": "(kind, id)",
|
||||
"kind": "data",
|
||||
"style": "dashed",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1061,
|
||||
"end_line": 1073
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
},
|
||||
{
|
||||
"id": "t5",
|
||||
"from": "record-variant",
|
||||
"to": "project-decision",
|
||||
"label": "(kind, id)",
|
||||
"kind": "data",
|
||||
"style": "dashed",
|
||||
"evidence": [
|
||||
{
|
||||
"start_line": 1061,
|
||||
"end_line": 1073
|
||||
}
|
||||
],
|
||||
"assumption": false
|
||||
}
|
||||
],
|
||||
"legend": [
|
||||
{
|
||||
"symbol": "점선",
|
||||
"meaning": "외래키 없이 (kind, id) 쌍으로만 가리킨다"
|
||||
}
|
||||
],
|
||||
"metadata": {
|
||||
"rationale": "축에 걸리지 않은 기록이 공통 기록이 된다는 규칙과 editorial 칸(thesis·summary·conclusion) 이야기는 같은 절의 문장으로 남긴다. 그림은 자리와 참조 방향만 담는다.",
|
||||
"profile_deviation": "techviz references 가 고른 후보(two-zone-pipeline, sequence, comparison) 밖의 프로필이다. 이 절에는 시간 순서도 두 구역도 비교 대상도 없어 후보로는 그릴 수 없었다."
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user