refactor: 문서 개선 중
This commit is contained in:
@@ -0,0 +1,22 @@
|
||||
# 새 CONCEPT 종류가 세 영역의 손 목록으로 퍼진 구조
|
||||
|
||||
## Alternative text
|
||||
|
||||
새 CONCEPT 노드에서 프론트엔드 손 목록, 백엔드 손 목록, 계약 enum 세 갈래로 퍼지는 팬아웃 그림. 각 갈래에는 실제 누락 건수 9, 1, 3이 적혀 있다.
|
||||
|
||||
## Long description
|
||||
|
||||
왼쪽의 새 CONCEPT가 세 갈래로 퍼진다. 프론트엔드에는 게이트웨이 분기, 매퍼, 필터 같은 손 목록이 아홉 곳 있었고, 백엔드에는 PublicSql.pathOf 한 곳이 빠졌다. 계약에는 CatalogEntry.kind, ResolvedRelation.targetKind, RelatedEntry.type 세 enum 누락이 있었다. 아래 본문 표가 열세 위치를 정확히 나열하고, 그림은 왜 한 종류 변경이 세 영역으로 퍼졌는지만 보여 준다.
|
||||
|
||||
## Elements and evidence
|
||||
|
||||
- **CONCEPT** (message): No additional description. Evidence: L316–L331.
|
||||
- **Frontend 손 목록** (component): No additional description. Evidence: L335–L345.
|
||||
- **Backend 손 목록** (component): No additional description. Evidence: L345–L349.
|
||||
- **Contract enums** (component): No additional description. Evidence: L346–L352.
|
||||
|
||||
## Relationships
|
||||
|
||||
- **CONCEPT → Backend 손 목록:** kind 추가. Evidence: L345–L349.
|
||||
- **CONCEPT → Contract enums:** enum 추가. Evidence: L346–L352.
|
||||
- **CONCEPT → Frontend 손 목록:** kind 추가. Evidence: L330–L345.
|
||||
@@ -0,0 +1,18 @@
|
||||
# 새 CONCEPT 종류가 세 영역의 손 목록으로 퍼진 구조
|
||||
# Question: CONCEPT 하나를 추가했는데 왜 계약·백엔드·프론트엔드 여러 위치를 동시에 고쳐야 했는가?
|
||||
direction: right
|
||||
n0: "CONCEPT" {
|
||||
shape: rectangle
|
||||
}
|
||||
n1: "Frontend 손 목록" {
|
||||
shape: rectangle
|
||||
}
|
||||
n2: "Backend 손 목록" {
|
||||
shape: rectangle
|
||||
}
|
||||
n3: "Contract enums" {
|
||||
shape: rectangle
|
||||
}
|
||||
n0 -> n1: "kind 추가"
|
||||
n0 -> n2: "kind 추가"
|
||||
n0 -> n3: "enum 추가"
|
||||
@@ -0,0 +1,12 @@
|
||||
digraph techviz {
|
||||
graph [rankdir=LR, splines=ortho, nodesep=0.55, ranksep=0.85];
|
||||
node [fontname=Helvetica, fontsize=11, margin="0.18,0.12", style="rounded,filled", fillcolor=white, color="#2d4357", penwidth=1.5];
|
||||
edge [fontname=Helvetica, fontsize=10, color="#364b5f", penwidth=1.4, arrowsize=0.75];
|
||||
n0 [label="CONCEPT", shape=box, style="rounded,filled"];
|
||||
n1 [label="Frontend 손 목록", shape=box, style="rounded,filled"];
|
||||
n2 [label="Backend 손 목록", shape=box, style="rounded,filled"];
|
||||
n3 [label="Contract enums", shape=box, style="rounded,filled"];
|
||||
n0 -> n1 [label="kind 추가", style=solid];
|
||||
n0 -> n2 [label="kind 추가", style=solid];
|
||||
n0 -> n3 [label="enum 추가", style=solid];
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<mxfile host="app.diagrams.net" modified="2026-07-23T00:00:00.000Z" agent="techviz-harness" version="24.7.17" type="device">
|
||||
<diagram id="record-kind-fanout" name="새 CONCEPT 종류가 세 영역의 손 목록으로 퍼진 구조">
|
||||
<mxGraphModel dx="680" dy="547" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
|
||||
<root>
|
||||
<mxCell id="0"/>
|
||||
<mxCell id="1" parent="0"/>
|
||||
<mxCell id="n_concept" value="CONCEPT<br/>새 Record Kind" tooltip="message | Evidence: L316-L331" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
|
||||
<mxGeometry x="70.0" y="245.5" width="150.0" height="71.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="n_backend" value="Backend 손 목록<br/>1곳<br/>PublicSql.pathOf" tooltip="component | Evidence: L345-L349" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
|
||||
<mxGeometry x="416.5" y="60.0" width="150.0" height="88.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="n_contract" value="Contract enums<br/>3곳<br/>CatalogEntry.kind<br/>ResolvedRelation.targetKind<br/>RelatedEntry.type" tooltip="component | Evidence: L346-L352" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
|
||||
<mxGeometry x="380.0" y="220.0" width="223.0" height="122.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="n_frontend" value="Frontend 손 목록<br/>9곳<br/>gateway · mapper · filter" tooltip="component | Evidence: L335-L345" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
|
||||
<mxGeometry x="387.0" y="414.0" width="209.0" height="88.0" as="geometry"/>
|
||||
</mxCell>
|
||||
<mxCell id="e_to-backend" value="kind 추가" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_concept" target="n_backend">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="342.2" y="183.5" as="offset"/>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e_to-contract" value="enum 추가" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_concept" target="n_contract">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="300.0" y="253.0" as="offset"/>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
<mxCell id="e_to-frontend" value="kind 추가" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_concept" target="n_frontend">
|
||||
<mxGeometry relative="1" as="geometry">
|
||||
<mxPoint x="327.5" y="378.5" as="offset"/>
|
||||
</mxGeometry>
|
||||
</mxCell>
|
||||
</root>
|
||||
</mxGraphModel>
|
||||
</diagram>
|
||||
</mxfile>
|
||||
@@ -0,0 +1,586 @@
|
||||
{
|
||||
"type": "excalidraw",
|
||||
"version": 2,
|
||||
"source": "techviz-harness",
|
||||
"elements": [
|
||||
{
|
||||
"id": "edge-to-backend",
|
||||
"type": "arrow",
|
||||
"x": 220.0,
|
||||
"y": 104.0,
|
||||
"width": 196.5,
|
||||
"height": 159.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 2,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 1,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": null,
|
||||
"seed": 1147872718,
|
||||
"version": 1,
|
||||
"versionNonce": 125969590,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"points": [
|
||||
[
|
||||
0.0,
|
||||
159.0
|
||||
],
|
||||
[
|
||||
98.25,
|
||||
159.0
|
||||
],
|
||||
[
|
||||
98.25,
|
||||
0.0
|
||||
],
|
||||
[
|
||||
196.5,
|
||||
0.0
|
||||
]
|
||||
],
|
||||
"lastCommittedPoint": null,
|
||||
"startBinding": {
|
||||
"elementId": "node-concept",
|
||||
"focus": 0,
|
||||
"gap": 4
|
||||
},
|
||||
"endBinding": {
|
||||
"elementId": "node-backend",
|
||||
"focus": 0,
|
||||
"gap": 4
|
||||
},
|
||||
"startArrowhead": null,
|
||||
"endArrowhead": "arrow",
|
||||
"elbowed": true
|
||||
},
|
||||
{
|
||||
"id": "edge-label-to-backend",
|
||||
"type": "text",
|
||||
"x": 297.25,
|
||||
"y": 171.5,
|
||||
"width": 90,
|
||||
"height": 24,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 1,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 0,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 627649163,
|
||||
"version": 1,
|
||||
"versionNonce": 1917519641,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"fontSize": 13,
|
||||
"fontFamily": 5,
|
||||
"text": "kind 추가",
|
||||
"textAlign": "center",
|
||||
"verticalAlign": "middle",
|
||||
"containerId": null,
|
||||
"originalText": "kind 추가",
|
||||
"autoResize": true,
|
||||
"lineHeight": 1.25
|
||||
},
|
||||
{
|
||||
"id": "edge-to-contract",
|
||||
"type": "arrow",
|
||||
"x": 220.0,
|
||||
"y": 281.0,
|
||||
"width": 160.0,
|
||||
"height": 0.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 2,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 1,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": null,
|
||||
"seed": 1165353134,
|
||||
"version": 1,
|
||||
"versionNonce": 1321109342,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"points": [
|
||||
[
|
||||
0.0,
|
||||
0.0
|
||||
],
|
||||
[
|
||||
80.0,
|
||||
0.0
|
||||
],
|
||||
[
|
||||
80.0,
|
||||
0.0
|
||||
],
|
||||
[
|
||||
160.0,
|
||||
0.0
|
||||
]
|
||||
],
|
||||
"lastCommittedPoint": null,
|
||||
"startBinding": {
|
||||
"elementId": "node-concept",
|
||||
"focus": 0,
|
||||
"gap": 4
|
||||
},
|
||||
"endBinding": {
|
||||
"elementId": "node-contract",
|
||||
"focus": 0,
|
||||
"gap": 4
|
||||
},
|
||||
"startArrowhead": null,
|
||||
"endArrowhead": "arrow",
|
||||
"elbowed": true
|
||||
},
|
||||
{
|
||||
"id": "edge-label-to-contract",
|
||||
"type": "text",
|
||||
"x": 255.0,
|
||||
"y": 241.0,
|
||||
"width": 90,
|
||||
"height": 24,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 1,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 0,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 1321731880,
|
||||
"version": 1,
|
||||
"versionNonce": 1614676317,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"fontSize": 13,
|
||||
"fontFamily": 5,
|
||||
"text": "enum 추가",
|
||||
"textAlign": "center",
|
||||
"verticalAlign": "middle",
|
||||
"containerId": null,
|
||||
"originalText": "enum 추가",
|
||||
"autoResize": true,
|
||||
"lineHeight": 1.25
|
||||
},
|
||||
{
|
||||
"id": "edge-to-frontend",
|
||||
"type": "arrow",
|
||||
"x": 220.0,
|
||||
"y": 299.0,
|
||||
"width": 167.0,
|
||||
"height": 159.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 2,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 1,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": null,
|
||||
"seed": 1693329255,
|
||||
"version": 1,
|
||||
"versionNonce": 696160331,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"points": [
|
||||
[
|
||||
0.0,
|
||||
0.0
|
||||
],
|
||||
[
|
||||
83.5,
|
||||
0.0
|
||||
],
|
||||
[
|
||||
83.5,
|
||||
159.0
|
||||
],
|
||||
[
|
||||
167.0,
|
||||
159.0
|
||||
]
|
||||
],
|
||||
"lastCommittedPoint": null,
|
||||
"startBinding": {
|
||||
"elementId": "node-concept",
|
||||
"focus": 0,
|
||||
"gap": 4
|
||||
},
|
||||
"endBinding": {
|
||||
"elementId": "node-frontend",
|
||||
"focus": 0,
|
||||
"gap": 4
|
||||
},
|
||||
"startArrowhead": null,
|
||||
"endArrowhead": "arrow",
|
||||
"elbowed": true
|
||||
},
|
||||
{
|
||||
"id": "edge-label-to-frontend",
|
||||
"type": "text",
|
||||
"x": 282.5,
|
||||
"y": 366.5,
|
||||
"width": 90,
|
||||
"height": 24,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 1,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 0,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 1043396341,
|
||||
"version": 1,
|
||||
"versionNonce": 269712647,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"fontSize": 13,
|
||||
"fontFamily": 5,
|
||||
"text": "kind 추가",
|
||||
"textAlign": "center",
|
||||
"verticalAlign": "middle",
|
||||
"containerId": null,
|
||||
"originalText": "kind 추가",
|
||||
"autoResize": true,
|
||||
"lineHeight": 1.25
|
||||
},
|
||||
{
|
||||
"id": "node-concept",
|
||||
"type": "rectangle",
|
||||
"x": 70.0,
|
||||
"y": 245.5,
|
||||
"width": 150.0,
|
||||
"height": 71.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "#ffffff",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 2,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 1,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 1783847077,
|
||||
"version": 1,
|
||||
"versionNonce": 1835405496,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false
|
||||
},
|
||||
{
|
||||
"id": "node-label-concept",
|
||||
"type": "text",
|
||||
"x": 80.0,
|
||||
"y": 255.5,
|
||||
"width": 130.0,
|
||||
"height": 51.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 1,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 0,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 956305639,
|
||||
"version": 1,
|
||||
"versionNonce": 1674164108,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"fontSize": 15,
|
||||
"fontFamily": 5,
|
||||
"text": "CONCEPT\n새 Record Kind",
|
||||
"textAlign": "center",
|
||||
"verticalAlign": "middle",
|
||||
"containerId": null,
|
||||
"originalText": "CONCEPT\n새 Record Kind",
|
||||
"autoResize": true,
|
||||
"lineHeight": 1.25
|
||||
},
|
||||
{
|
||||
"id": "node-backend",
|
||||
"type": "rectangle",
|
||||
"x": 416.5,
|
||||
"y": 60.0,
|
||||
"width": 150.0,
|
||||
"height": 88.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "#ffffff",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 2,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 1,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 430450037,
|
||||
"version": 1,
|
||||
"versionNonce": 288855291,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false
|
||||
},
|
||||
{
|
||||
"id": "node-label-backend",
|
||||
"type": "text",
|
||||
"x": 426.5,
|
||||
"y": 70.0,
|
||||
"width": 130.0,
|
||||
"height": 68.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 1,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 0,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 349920174,
|
||||
"version": 1,
|
||||
"versionNonce": 257387561,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"fontSize": 15,
|
||||
"fontFamily": 5,
|
||||
"text": "Backend 손 목록\n1곳\nPublicSql.pathOf",
|
||||
"textAlign": "center",
|
||||
"verticalAlign": "middle",
|
||||
"containerId": null,
|
||||
"originalText": "Backend 손 목록\n1곳\nPublicSql.pathOf",
|
||||
"autoResize": true,
|
||||
"lineHeight": 1.25
|
||||
},
|
||||
{
|
||||
"id": "node-contract",
|
||||
"type": "rectangle",
|
||||
"x": 380.0,
|
||||
"y": 220.0,
|
||||
"width": 223.0,
|
||||
"height": 122.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "#ffffff",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 2,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 1,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 179232308,
|
||||
"version": 1,
|
||||
"versionNonce": 606575263,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false
|
||||
},
|
||||
{
|
||||
"id": "node-label-contract",
|
||||
"type": "text",
|
||||
"x": 390.0,
|
||||
"y": 230.0,
|
||||
"width": 203.0,
|
||||
"height": 102.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 1,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 0,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 165738200,
|
||||
"version": 1,
|
||||
"versionNonce": 285005378,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"fontSize": 15,
|
||||
"fontFamily": 5,
|
||||
"text": "Contract enums\n3곳\nCatalogEntry.kind\nResolvedRelation.targetKind\nRelatedEntry.type",
|
||||
"textAlign": "center",
|
||||
"verticalAlign": "middle",
|
||||
"containerId": null,
|
||||
"originalText": "Contract enums\n3곳\nCatalogEntry.kind\nResolvedRelation.targetKind\nRelatedEntry.type",
|
||||
"autoResize": true,
|
||||
"lineHeight": 1.25
|
||||
},
|
||||
{
|
||||
"id": "node-frontend",
|
||||
"type": "rectangle",
|
||||
"x": 387.0,
|
||||
"y": 414.0,
|
||||
"width": 209.0,
|
||||
"height": 88.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "#ffffff",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 2,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 1,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 286799291,
|
||||
"version": 1,
|
||||
"versionNonce": 1685391574,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false
|
||||
},
|
||||
{
|
||||
"id": "node-label-frontend",
|
||||
"type": "text",
|
||||
"x": 397.0,
|
||||
"y": 424.0,
|
||||
"width": 189.0,
|
||||
"height": 68.0,
|
||||
"angle": 0,
|
||||
"strokeColor": "#1e1e1e",
|
||||
"backgroundColor": "transparent",
|
||||
"fillStyle": "solid",
|
||||
"strokeWidth": 1,
|
||||
"strokeStyle": "solid",
|
||||
"roughness": 0,
|
||||
"opacity": 100,
|
||||
"groupIds": [],
|
||||
"frameId": null,
|
||||
"index": null,
|
||||
"roundness": {
|
||||
"type": 3
|
||||
},
|
||||
"seed": 1548189542,
|
||||
"version": 1,
|
||||
"versionNonce": 237285990,
|
||||
"isDeleted": false,
|
||||
"boundElements": [],
|
||||
"updated": 0,
|
||||
"link": null,
|
||||
"locked": false,
|
||||
"fontSize": 15,
|
||||
"fontFamily": 5,
|
||||
"text": "Frontend 손 목록\n9곳\ngateway · mapper · filter",
|
||||
"textAlign": "center",
|
||||
"verticalAlign": "middle",
|
||||
"containerId": null,
|
||||
"originalText": "Frontend 손 목록\n9곳\ngateway · mapper · filter",
|
||||
"autoResize": true,
|
||||
"lineHeight": 1.25
|
||||
}
|
||||
],
|
||||
"appState": {
|
||||
"gridSize": 10,
|
||||
"viewBackgroundColor": "#ffffff",
|
||||
"currentItemFontFamily": 5
|
||||
},
|
||||
"files": {}
|
||||
}
|
||||
+32
@@ -0,0 +1,32 @@
|
||||
{
|
||||
"harness_version": "0.2.0",
|
||||
"spec_id": "record-kind-fanout",
|
||||
"spec_version": "1.1",
|
||||
"spec_sha256": "4edc64969f367edfd400651cd9e0c1787d63847dab3cdc3835ac6eee75fb377e",
|
||||
"source_context": {
|
||||
"document": "docs/TechLog/final/document.md",
|
||||
"document_sha256": "c3a7de37b778fff7b6ea555a3ad7338c91c6fb15d685e7734f89472b4924d955",
|
||||
"anchor": {
|
||||
"kind": "heading",
|
||||
"value": "3. 손으로 나열한 목록이 새 종류를 삼킨다",
|
||||
"line": 311
|
||||
}
|
||||
},
|
||||
"outputs": [
|
||||
"record-kind-fanout.svg",
|
||||
"record-kind-fanout.drawio",
|
||||
"record-kind-fanout.mmd",
|
||||
"record-kind-fanout.d2",
|
||||
"record-kind-fanout.dot",
|
||||
"record-kind-fanout.excalidraw",
|
||||
"record-kind-fanout.alt.md"
|
||||
],
|
||||
"lint_issue_count": 0,
|
||||
"assumption_count": 0,
|
||||
"assumptions_allowed": false,
|
||||
"composition_profile": "component-flow",
|
||||
"reference_ids": [
|
||||
"payment-event-flow"
|
||||
],
|
||||
"diagram_only": true
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
%% 새 CONCEPT 종류가 세 영역의 손 목록으로 퍼진 구조
|
||||
%% question: CONCEPT 하나를 추가했는데 왜 계약·백엔드·프론트엔드 여러 위치를 동시에 고쳐야 했는가?
|
||||
flowchart LR
|
||||
n0["CONCEPT"]
|
||||
n1["Frontend 손 목록"]
|
||||
n2["Backend 손 목록"]
|
||||
n3["Contract enums"]
|
||||
n0 -->|"kind 추가"| n1
|
||||
n0 -->|"kind 추가"| n2
|
||||
n0 -->|"enum 추가"| n3
|
||||
@@ -0,0 +1,91 @@
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="547" viewBox="0 0 680 547" role="img" aria-labelledby="diagram-title diagram-description">
|
||||
<title id="diagram-title">새 CONCEPT 종류가 세 영역의 손 목록으로 퍼진 구조</title>
|
||||
<desc id="diagram-description">왼쪽의 새 CONCEPT가 세 갈래로 퍼진다. 프론트엔드에는 게이트웨이 분기, 매퍼, 필터 같은 손 목록이 아홉 곳 있었고, 백엔드에는 PublicSql.pathOf 한 곳이 빠졌다. 계약에는 CatalogEntry.kind, ResolvedRelation.targetKind, RelatedEntry.type 세 enum 누락이 있었다. 아래 본문 표가 열세 위치를 정확히 나열하고, 그림은 왜 한 종류 변경이 세 영역으로 퍼졌는지만 보여 준다.</desc>
|
||||
<metadata>{"techviz":{"spec_version":"1.1","id":"record-kind-fanout","profile":"component-flow"},"source_context":{"document":"docs/TechLog/final/document.md","document_sha256":"c3a7de37b778fff7b6ea555a3ad7338c91c6fb15d685e7734f89472b4924d955","anchor":{"kind":"heading","value":"3. 손으로 나열한 목록이 새 종류를 삼킨다","line":311}},"evidence_policy":"Each factual element cites source lines or is marked assumption.","diagram_only":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" />
|
||||
</marker>
|
||||
<style>
|
||||
:root { color-scheme: light; }
|
||||
text { font-family: Inter, Pretendard, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; fill: #111827; }
|
||||
.canvas { fill: #ffffff; }
|
||||
.group-box { fill: #ffffff; stroke: #9ca3af; stroke-width: 1.4; stroke-dasharray: 7 5; }
|
||||
.group-label-bg { fill: #ffffff; }
|
||||
.group-label { font-size: 13px; font-weight: 650; fill: #374151; }
|
||||
.edge { fill: none; stroke: #374151; stroke-width: 1.8; stroke-linejoin: round; stroke-linecap: round; marker-end: url(#arrow); }
|
||||
.edge.style-dashed, .edge.semantic-dashed, .edge.assumption { stroke-dasharray: 7 5; }
|
||||
.edge.style-dotted { stroke-dasharray: 2 5; }
|
||||
.edge.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
|
||||
.edge.emphasis-muted { stroke: #9ca3af; }
|
||||
.edge.emphasis-warning, .edge.kind-failure, .edge.kind-error { stroke: #dc2626; stroke-width: 2.2; }
|
||||
.edge-label-bg { fill: #ffffff; }
|
||||
.edge-label { font-size: 12px; font-weight: 560; text-anchor: middle; }
|
||||
.node-shape { fill: #ffffff; stroke: #4b5563; stroke-width: 1.7; }
|
||||
.node-shape.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
|
||||
.node-shape.emphasis-muted { stroke: #9ca3af; fill: #f9fafb; }
|
||||
.node-shape.emphasis-warning { stroke: #d97706; stroke-width: 2; fill: #fffdf5; }
|
||||
.node-shape.kind-database, .node-shape.kind-datastore, .node-shape.kind-storage { fill: #f8fafc; }
|
||||
.node-shape.kind-queue, .node-shape.kind-event, .node-shape.kind-topic { fill: #fafafa; }
|
||||
.node-shape.assumption { stroke-dasharray: 4 4; }
|
||||
.storage-bottom, .controller-divider { fill: none; stroke: #4b5563; stroke-width: 1.4; }
|
||||
.controller-led { fill: #4b5563; }
|
||||
.actor-symbol { fill: none; stroke: #4b5563; stroke-width: 1.8; stroke-linecap: round; }
|
||||
.actor-symbol.emphasis-primary { stroke: #2563eb; stroke-width: 2.2; }
|
||||
.node-label { font-size: 14px; font-weight: 650; text-anchor: middle; }
|
||||
.node-role { font-size: 10px; letter-spacing: 0.04em; text-anchor: middle; fill: #6b7280; }
|
||||
.node-detail-divider { stroke: #d1d5db; stroke-width: 1; }
|
||||
.node-detail { font-size: 11px; fill: #374151; }
|
||||
.assumption-badge { font-size: 9px; font-weight: 700; fill: #92400e; }
|
||||
.failure-mark { stroke: #dc2626; stroke-width: 4; stroke-linecap: round; }
|
||||
.lifeline { stroke: #9ca3af; stroke-width: 1.2; stroke-dasharray: 5 5; }
|
||||
.timeline-axis { stroke: #374151; stroke-width: 1.8; marker-end: url(#arrow); }
|
||||
.timeline-stem { stroke: #6b7280; stroke-width: 1.3; }
|
||||
.timeline-marker { fill: #ffffff; stroke: #374151; stroke-width: 1.7; }
|
||||
.timeline-marker.primary { fill: #2563eb; stroke: #2563eb; }
|
||||
.timeline-marker.warning { fill: #dc2626; stroke: #dc2626; }
|
||||
.timeline-label { font-size: 13px; font-weight: 650; text-anchor: middle; }
|
||||
.timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
|
||||
</style>
|
||||
</defs>
|
||||
<rect class="canvas" width="680" height="547" />
|
||||
<polyline class="edge kind-data style-solid emphasis-normal" points="220.0,263.0 318.2,263.0 318.2,104.0 416.5,104.0" data-evidence="345-349" />
|
||||
<rect class="edge-label-bg" x="309.8" y="169.5" width="64.9" height="22" rx="3" />
|
||||
<text class="edge-label" x="342.2" y="184.5">kind 추가</text>
|
||||
<polyline class="edge kind-data style-solid emphasis-normal" points="220.0,281.0 300.0,281.0 300.0,281.0 380.0,281.0" data-evidence="346-352" />
|
||||
<rect class="edge-label-bg" x="267.6" y="239.0" width="64.9" height="22" rx="3" />
|
||||
<text class="edge-label" x="300.0" y="254.0">enum 추가</text>
|
||||
<polyline class="edge kind-data style-solid emphasis-normal" points="220.0,299.0 303.5,299.0 303.5,458.0 387.0,458.0" data-evidence="330-345" />
|
||||
<rect class="edge-label-bg" x="295.1" y="364.5" width="64.9" height="22" rx="3" />
|
||||
<text class="edge-label" x="327.5" y="379.5">kind 추가</text>
|
||||
<g id="node-concept">
|
||||
<rect class="node-shape kind-message emphasis-primary role-source" data-evidence="316-331" x="70.0" y="245.5" width="150.0" height="71.0" rx="7" />
|
||||
<text class="node-label" x="145.0" y="272.5">CONCEPT</text>
|
||||
<line class="node-detail-divider" x1="84.0" y1="293.5" x2="206.0" y2="293.5" />
|
||||
<text class="node-detail" x="86.0" y="310.5">새 Record Kind</text>
|
||||
</g>
|
||||
<g id="node-backend">
|
||||
<rect class="node-shape kind-component emphasis-normal role-service" data-evidence="345-349" x="416.5" y="60.0" width="150.0" height="88.0" rx="7" />
|
||||
<text class="node-label" x="491.5" y="87.0">Backend 손 목록</text>
|
||||
<line class="node-detail-divider" x1="430.5" y1="108.0" x2="552.5" y2="108.0" />
|
||||
<text class="node-detail" x="432.5" y="125.0">1곳</text>
|
||||
<text class="node-detail" x="432.5" y="141.0">PublicSql.pathOf</text>
|
||||
</g>
|
||||
<g id="node-contract">
|
||||
<rect class="node-shape kind-component emphasis-normal role-sink" data-evidence="346-352" x="380.0" y="220.0" width="223.0" height="122.0" rx="7" />
|
||||
<text class="node-label" x="491.5" y="247.0">Contract enums</text>
|
||||
<line class="node-detail-divider" x1="394.0" y1="268.0" x2="589.0" y2="268.0" />
|
||||
<text class="node-detail" x="396.0" y="285.0">3곳</text>
|
||||
<text class="node-detail" x="396.0" y="301.0">CatalogEntry.kind</text>
|
||||
<text class="node-detail" x="396.0" y="317.0">ResolvedRelation.targetKind</text>
|
||||
<text class="node-detail" x="396.0" y="333.0">RelatedEntry.type</text>
|
||||
</g>
|
||||
<g id="node-frontend">
|
||||
<rect class="node-shape kind-component emphasis-normal role-service" data-evidence="335-345" x="387.0" y="414.0" width="209.0" height="88.0" rx="7" />
|
||||
<text class="node-label" x="491.5" y="441.0">Frontend 손 목록</text>
|
||||
<line class="node-detail-divider" x1="401.0" y1="462.0" x2="582.0" y2="462.0" />
|
||||
<text class="node-detail" x="403.0" y="479.0">9곳</text>
|
||||
<text class="node-detail" x="403.0" y="495.0">gateway · mapper · filter</text>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 7.2 KiB |
Reference in New Issue
Block a user