233 lines
6.5 KiB
JSON
233 lines
6.5 KiB
JSON
{
|
|
"version": "1.1",
|
|
"id": "decision-path-404",
|
|
"title": "결정 주소가 게시 시점에 굳어져 방문자가 404 를 만나기까지",
|
|
"question": "계약은 앵커 주소를 적어 두었는데 방문자는 왜 404 를 만났는가?",
|
|
"type": "sequence",
|
|
"direction": "TB",
|
|
"audience": [
|
|
"백엔드 개발자",
|
|
"프론트엔드 개발자"
|
|
],
|
|
"summary": "만드는 쪽 두 곳이 계약과 다른 슬래시 주소를 만들었고, 그 주소가 게시 시점에 저장돼 방문자에게 그대로 나갔다.",
|
|
"alt": "계약, 게시 시점 경로 생성, 저장 테이블, 조회 시점 경로 생성, 방문자, 공개 라우트 여섯 참가자 사이에서 주소가 만들어져 저장되고 방문 시 404 로 끝나는 순서도.",
|
|
"long_description": "위에서 아래로 여섯 번의 이동이 있다. 계약 ProjectDecisionItem 은 공개 주소가 decisions#{slug} 앵커라고 규정한다. 게시 시점의 PublicPaths.forKind 는 그 대신 decisions/{slug} 를 만들어 public_resource_projection 에 저장한다. 조회 시점의 PublicSql.pathOf 가 저장된 주소를 읽고 방문자에게 링크로 내보낸다. 방문자가 그 주소를 요청하면 공개 라우트에는 projects/{slug}/decisions 하나뿐이라 맞는 라우트가 없고 404 가 돌아온다.",
|
|
"source_context": {
|
|
"document": "docs/TechLog/final/document.md",
|
|
"document_sha256": "c3a7de37b778fff7b6ea555a3ad7338c91c6fb15d685e7734f89472b4924d955",
|
|
"anchor": {
|
|
"kind": "marker",
|
|
"value": "decision-path-404",
|
|
"line": 916
|
|
}
|
|
},
|
|
"composition": {
|
|
"profile": "sequence",
|
|
"diagram_only": true,
|
|
"reference_ids": [
|
|
"payment-approval-sequence"
|
|
],
|
|
"rationale": "본문은 주소가 계약에서 규정되고, 게시 시점에 만들어져 저장되고, 조회 시점에 읽혀 방문자에게 나가고, 방문했을 때 404 가 되는 순서를 적는다. 「주소가 게시 시점에 굳는다」가 이 결함의 핵심이라 시점의 순서가 그림의 뼈대여야 한다."
|
|
},
|
|
"nodes": [
|
|
{
|
|
"id": "contract",
|
|
"label": "계약 ProjectDecisionItem",
|
|
"kind": "participant",
|
|
"role": "participant",
|
|
"description": "공개 주소를 앵커로 규정한 OpenAPI 계약.",
|
|
"evidence": [
|
|
{
|
|
"start_line": 919,
|
|
"end_line": 921
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "publish-path",
|
|
"label": "PublicPaths.forKind",
|
|
"kind": "participant",
|
|
"role": "participant",
|
|
"details": [
|
|
"게시 시점"
|
|
],
|
|
"emphasis": "warning",
|
|
"description": "게시할 때 공개 주소를 만드는 코드.",
|
|
"evidence": [
|
|
{
|
|
"start_line": 919,
|
|
"end_line": 921
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "projection",
|
|
"label": "public_resource_projection",
|
|
"kind": "participant",
|
|
"role": "participant",
|
|
"description": "만들어진 주소가 저장되는 투영 테이블.",
|
|
"evidence": [
|
|
{
|
|
"start_line": 925,
|
|
"end_line": 926
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "read-path",
|
|
"label": "PublicSql.pathOf",
|
|
"kind": "participant",
|
|
"role": "participant",
|
|
"details": [
|
|
"조회 시점"
|
|
],
|
|
"emphasis": "warning",
|
|
"description": "조회할 때 공개 주소를 만드는 코드.",
|
|
"evidence": [
|
|
{
|
|
"start_line": 919,
|
|
"end_line": 921
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "visitor",
|
|
"label": "방문자",
|
|
"kind": "actor",
|
|
"role": "participant",
|
|
"description": "「다음에 읽을 것」 링크를 따라간 사람.",
|
|
"evidence": [
|
|
{
|
|
"start_line": 913,
|
|
"end_line": 914
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "public-route",
|
|
"label": "공개 라우트",
|
|
"kind": "participant",
|
|
"role": "participant",
|
|
"details": [
|
|
"/projects/{slug}/decisions 하나뿐"
|
|
],
|
|
"description": "결정에는 상세 화면이 없어 라우트가 하나뿐이다.",
|
|
"evidence": [
|
|
{
|
|
"start_line": 918,
|
|
"end_line": 919
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"edges": [
|
|
{
|
|
"id": "m1",
|
|
"from": "contract",
|
|
"to": "publish-path",
|
|
"label": "…/decisions#{slug} 로 규정",
|
|
"kind": "request",
|
|
"order": 1,
|
|
"evidence": [
|
|
{
|
|
"start_line": 919,
|
|
"end_line": 921
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "m2",
|
|
"from": "publish-path",
|
|
"to": "projection",
|
|
"label": "…/decisions/{slug} 저장",
|
|
"kind": "request",
|
|
"order": 2,
|
|
"emphasis": "warning",
|
|
"evidence": [
|
|
{
|
|
"start_line": 919,
|
|
"end_line": 921
|
|
},
|
|
{
|
|
"start_line": 925,
|
|
"end_line": 926
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "m3",
|
|
"from": "projection",
|
|
"to": "read-path",
|
|
"label": "저장된 주소 조회",
|
|
"kind": "response",
|
|
"order": 3,
|
|
"evidence": [
|
|
{
|
|
"start_line": 919,
|
|
"end_line": 926
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "m4",
|
|
"from": "read-path",
|
|
"to": "visitor",
|
|
"label": "같은 형태로 링크 전달",
|
|
"kind": "response",
|
|
"order": 4,
|
|
"evidence": [
|
|
{
|
|
"start_line": 913,
|
|
"end_line": 921
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "m5",
|
|
"from": "visitor",
|
|
"to": "public-route",
|
|
"label": "…/decisions/{slug} 요청",
|
|
"kind": "request",
|
|
"order": 5,
|
|
"evidence": [
|
|
{
|
|
"start_line": 913,
|
|
"end_line": 919
|
|
}
|
|
],
|
|
"assumption": false
|
|
},
|
|
{
|
|
"id": "m6",
|
|
"from": "public-route",
|
|
"to": "visitor",
|
|
"label": "404",
|
|
"kind": "response",
|
|
"order": 6,
|
|
"emphasis": "warning",
|
|
"evidence": [
|
|
{
|
|
"start_line": 913,
|
|
"end_line": 919
|
|
}
|
|
],
|
|
"assumption": false
|
|
}
|
|
],
|
|
"legend": [],
|
|
"metadata": {
|
|
"rationale": "고친 것 세 갈래(만드는 쪽 수정·V15 마이그레이션·resolvesToPublicRoute)는 같은 절의 문장으로 남긴다. 그림은 결함이 생긴 순서만 담는다.",
|
|
"profile_deviation": "없음. sequence 는 techviz references 가 고른 후보 안에 있다."
|
|
}
|
|
}
|