refactor: 문서 개선 중

2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -10,18 +10,18 @@

 ## Elements and evidence

- **계약 ProjectDecisionItem** (participant): 공개 주소를 앵커로 규정한 OpenAPI 계약. Evidence: L676–L678.
- **PublicPaths.forKind** (participant): 게시할 때 공개 주소를 만드는 코드. Evidence: L677–L678.
- **public_resource_projection** (participant): 만들어진 주소가 저장되는 투영 테이블. Evidence: L682–L683.
- **PublicSql.pathOf** (participant): 조회할 때 공개 주소를 만드는 코드. Evidence: L677–L678.
- **방문자** (actor): 「다음에 읽을 것」 링크를 따라간 사람. Evidence: L670–L671.
- **공개 라우트** (participant): 결정에는 상세 화면이 없어 라우트가 하나뿐이다. Evidence: L675–L676.
+- **계약 ProjectDecisionItem** (participant): 공개 주소를 앵커로 규정한 OpenAPI 계약. Evidence: L919–L921.
+- **PublicPaths.forKind** (participant): 게시할 때 공개 주소를 만드는 코드. Evidence: L919–L921.
+- **public_resource_projection** (participant): 만들어진 주소가 저장되는 투영 테이블. Evidence: L925–L926.
+- **PublicSql.pathOf** (participant): 조회할 때 공개 주소를 만드는 코드. Evidence: L919–L921.
+- **방문자** (actor): 「다음에 읽을 것」 링크를 따라간 사람. Evidence: L913–L914.
+- **공개 라우트** (participant): 결정에는 상세 화면이 없어 라우트가 하나뿐이다. Evidence: L918–L919.

 ## Relationships

- **계약 ProjectDecisionItem → PublicPaths.forKind:** …/decisions#{slug} 로 규정. Evidence: L676–L678.
- **PublicPaths.forKind → public_resource_projection:** …/decisions/{slug} 저장. Evidence: L675–L678.
- **public_resource_projection → PublicSql.pathOf:** 저장된 주소 조회. Evidence: L682–L683.
- **PublicSql.pathOf → 방문자:** 같은 형태로 링크 전달. Evidence: L677–L678.
- **방문자 → 공개 라우트:** …/decisions/{slug} 요청. Evidence: L670–L675.
- **공개 라우트 → 방문자:** 404. Evidence: L670–L675.
+- **계약 ProjectDecisionItem → PublicPaths.forKind:** …/decisions#{slug} 로 규정. Evidence: L919–L921.
+- **PublicPaths.forKind → public_resource_projection:** …/decisions/{slug} 저장. Evidence: L919–L921, L925–L926.
+- **public_resource_projection → PublicSql.pathOf:** 저장된 주소 조회. Evidence: L919–L926.
+- **PublicSql.pathOf → 방문자:** 같은 형태로 링크 전달. Evidence: L913–L921.
+- **방문자 → 공개 라우트:** …/decisions/{slug} 요청. Evidence: L913–L919.
+- **공개 라우트 → 방문자:** 404. Evidence: L913–L919.
@@ -5,22 +5,22 @@
      <root>
        <mxCell id="0"/>
        <mxCell id="1" parent="0"/>
-        <mxCell id="n_contract" value="계약 ProjectDecisionItem" tooltip="공개 주소를 앵커로 규정한 OpenAPI 계약. | Evidence: L676-L678" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
+        <mxCell id="n_contract" value="계약 ProjectDecisionItem" tooltip="공개 주소를 앵커로 규정한 OpenAPI 계약. | Evidence: L919-L921" 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="45.0" y="35.0" width="188.0" height="64.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_publish-path" value="PublicPaths.forKind&lt;br/&gt;게시 시점" tooltip="게시할 때 공개 주소를 만드는 코드. | Evidence: L677-L678" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
+        <mxCell id="n_publish-path" value="PublicPaths.forKind&lt;br/&gt;게시 시점" tooltip="게시할 때 공개 주소를 만드는 코드. | Evidence: L919-L921" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
          <mxGeometry x="255.0" y="35.0" width="167.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_projection" value="public_resource_projection" tooltip="만들어진 주소가 저장되는 투영 테이블. | Evidence: L682-L683" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
+        <mxCell id="n_projection" value="public_resource_projection" tooltip="만들어진 주소가 저장되는 투영 테이블. | Evidence: L925-L926" 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="465.0" y="35.0" width="190.0" height="64.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_read-path" value="PublicSql.pathOf&lt;br/&gt;조회 시점" tooltip="조회할 때 공개 주소를 만드는 코드. | Evidence: L677-L678" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
+        <mxCell id="n_read-path" value="PublicSql.pathOf&lt;br/&gt;조회 시점" tooltip="조회할 때 공개 주소를 만드는 코드. | Evidence: L919-L921" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
          <mxGeometry x="675.0" y="35.0" width="150.0" height="71.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_visitor" value="방문자" tooltip="「다음에 읽을 것」 링크를 따라간 사람. | Evidence: L670-L671" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;dashed=1;fillColor=#f5f7fa;" vertex="1" parent="1">
+        <mxCell id="n_visitor" value="방문자" tooltip="「다음에 읽을 것」 링크를 따라간 사람. | Evidence: L913-L914" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;dashed=1;fillColor=#f5f7fa;" vertex="1" parent="1">
          <mxGeometry x="885.0" y="35.0" width="150.0" height="78.0" as="geometry"/>
        </mxCell>
-        <mxCell id="n_public-route" value="공개 라우트&lt;br/&gt;/projects/{slug}/decisions 하나뿐" tooltip="결정에는 상세 화면이 없어 라우트가 하나뿐이다. | Evidence: L675-L676" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
+        <mxCell id="n_public-route" value="공개 라우트&lt;br/&gt;/projects/{slug}/decisions 하나뿐" tooltip="결정에는 상세 화면이 없어 라우트가 하나뿐이다. | Evidence: L918-L919" 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="1095.0" y="35.0" width="190.0" height="71.0" as="geometry"/>
        </mxCell>
        <mxCell id="e_m1" value="…/decisions#{slug} 로 규정" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_contract" target="n_publish-path">
@@ -2,22 +2,22 @@
  "harness_version": "0.2.0",
  "spec_id": "decision-path-404",
  "spec_version": "1.1",
-  "spec_sha256": "277ea0b16980c58b052895bdd09c2dcc15aa24b33173785c3b9b37d6888e0daf",
+  "spec_sha256": "ea5cad43e1a5d76650bbe4bd30ce3bc070c30aa2bf778fbf7b2a81cee8e6c4e5",
  "source_context": {
-    "document": "document.md",
-    "document_sha256": "93b9fec4884efa0e6231de07dc27e2b0ac36c9052d3720e28d102d9747ac4f8f",
+    "document": "docs/TechLog/final/document.md",
+    "document_sha256": "c3a7de37b778fff7b6ea555a3ad7338c91c6fb15d685e7734f89472b4924d955",
    "anchor": {
      "kind": "marker",
      "value": "decision-path-404",
-      "line": 673
+      "line": 916
    }
  },
  "outputs": [
    "decision-path-404.svg",
+    "decision-path-404.drawio",
    "decision-path-404.mmd",
    "decision-path-404.d2",
    "decision-path-404.dot",
-    "decision-path-404.drawio",
    "decision-path-404.excalidraw",
    "decision-path-404.alt.md"
  ],
@@ -2,7 +2,7 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1330" height="542" viewBox="0 0 1330 542" role="img" aria-labelledby="diagram-title diagram-description">
 <title id="diagram-title">결정 주소가 게시 시점에 굳어져 방문자가 404 를 만나기까지</title>
 <desc id="diagram-description">위에서 아래로 여섯 번의 이동이 있다. 계약 ProjectDecisionItem 은 공개 주소가 decisions#{slug} 앵커라고 규정한다. 게시 시점의 PublicPaths.forKind 는 그 대신 decisions/{slug} 를 만들어 public_resource_projection 에 저장한다. 조회 시점의 PublicSql.pathOf 가 저장된 주소를 읽고 방문자에게 링크로 내보낸다. 방문자가 그 주소를 요청하면 공개 라우트에는 projects/{slug}/decisions 하나뿐이라 맞는 라우트가 없고 404 가 돌아온다.</desc>
-<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;decision-path-404&quot;,&quot;profile&quot;:&quot;sequence&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;document.md&quot;,&quot;document_sha256&quot;:&quot;93b9fec4884efa0e6231de07dc27e2b0ac36c9052d3720e28d102d9747ac4f8f&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;marker&quot;,&quot;value&quot;:&quot;decision-path-404&quot;,&quot;line&quot;:673}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
+<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;decision-path-404&quot;,&quot;profile&quot;:&quot;sequence&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/TechLog/final/document.md&quot;,&quot;document_sha256&quot;:&quot;c3a7de37b778fff7b6ea555a3ad7338c91c6fb15d685e7734f89472b4924d955&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;marker&quot;,&quot;value&quot;:&quot;decision-path-404&quot;,&quot;line&quot;:916}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;: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" />
@@ -50,48 +50,48 @@
  </style>
 </defs>
 <rect class="canvas" width="1330" height="542" />
-<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="676-678" x="45.0" y="35.0" width="188.0" height="64.0" rx="7" />
+<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="919-921" x="45.0" y="35.0" width="188.0" height="64.0" rx="7" />
 <text class="node-label" x="139.0" y="65.0">계약 ProjectDecisionItem</text>
 <line class="lifeline" x1="139.0" y1="99.0" x2="139.0" y2="512.0" />
-<rect class="node-shape kind-participant emphasis-warning role-participant" data-evidence="677-678" x="255.0" y="35.0" width="167.0" height="71.0" rx="7" />
+<rect class="node-shape kind-participant emphasis-warning role-participant" data-evidence="919-921" x="255.0" y="35.0" width="167.0" height="71.0" rx="7" />
 <text class="node-label" x="338.5" y="62.0">PublicPaths.forKind</text>
 <line class="node-detail-divider" x1="269.0" y1="83.0" x2="408.0" y2="83.0" />
 <text class="node-detail" x="271.0" y="100.0">게시 시점</text>
 <line class="lifeline" x1="338.5" y1="106.0" x2="338.5" y2="512.0" />
-<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="682-683" x="465.0" y="35.0" width="190.0" height="64.0" rx="7" />
+<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="925-926" x="465.0" y="35.0" width="190.0" height="64.0" rx="7" />
 <text class="node-label" x="560.0" y="65.0">public_resource_projection</text>
 <line class="lifeline" x1="560.0" y1="99.0" x2="560.0" y2="512.0" />
-<rect class="node-shape kind-participant emphasis-warning role-participant" data-evidence="677-678" x="675.0" y="35.0" width="150.0" height="71.0" rx="7" />
+<rect class="node-shape kind-participant emphasis-warning role-participant" data-evidence="919-921" x="675.0" y="35.0" width="150.0" height="71.0" rx="7" />
 <text class="node-label" x="750.0" y="62.0">PublicSql.pathOf</text>
 <line class="node-detail-divider" x1="689.0" y1="83.0" x2="811.0" y2="83.0" />
 <text class="node-detail" x="691.0" y="100.0">조회 시점</text>
 <line class="lifeline" x1="750.0" y1="106.0" x2="750.0" y2="512.0" />
-<g class="actor-symbol emphasis-normal" data-evidence="670-671"><circle cx="960.0" cy="55.0" r="11.0" /><line x1="960.0" y1="71.0" x2="960.0" y2="74.0" /><line x1="942.0" y1="81.0" x2="978.0" y2="81.0" /><line x1="960.0" y1="74.0" x2="945.0" y2="91.0" /><line x1="960.0" y1="74.0" x2="975.0" y2="91.0" /></g>
+<g class="actor-symbol emphasis-normal" data-evidence="913-914"><circle cx="960.0" cy="55.0" r="11.0" /><line x1="960.0" y1="71.0" x2="960.0" y2="84.0" /><line x1="942.0" y1="81.0" x2="978.0" y2="81.0" /><line x1="960.0" y1="84.0" x2="945.0" y2="101.0" /><line x1="960.0" y1="84.0" x2="975.0" y2="101.0" /></g>
 <text class="node-label" x="960.0" y="106.0">방문자</text>
 <line class="lifeline" x1="960.0" y1="113.0" x2="960.0" y2="512.0" />
-<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="675-676" x="1095.0" y="35.0" width="190.0" height="71.0" rx="7" />
+<rect class="node-shape kind-participant emphasis-normal role-participant" data-evidence="918-919" x="1095.0" y="35.0" width="190.0" height="71.0" rx="7" />
 <text class="node-label" x="1190.0" y="62.0">공개 라우트</text>
 <line class="node-detail-divider" x1="1109.0" y1="83.0" x2="1271.0" y2="83.0" />
 <text class="node-detail" x="1111.0" y="100.0">/projects/{slug}/decisions 하나뿐</text>
 <line class="lifeline" x1="1190.0" y1="106.0" x2="1190.0" y2="512.0" />
-<polyline class="edge kind-request style-solid emphasis-normal" points="139.0,140.0 338.5,140.0" data-evidence="676-678" />
+<polyline class="edge kind-request style-solid emphasis-normal" points="139.0,140.0 338.5,140.0" data-evidence="919-921" />
 <rect class="edge-label-bg" x="142.6" y="114.0" width="192.2" height="22" rx="3" />
 <text class="edge-label" x="238.8" y="129.0">1. …/decisions#{slug} 로 규정</text>
-<polyline class="edge kind-request style-solid emphasis-warning" points="338.5,202.0 560.0,202.0" data-evidence="675-678" />
+<polyline class="edge kind-request style-solid emphasis-warning" points="338.5,202.0 560.0,202.0" data-evidence="919-921,925-926" />
 <rect class="edge-label-bg" x="359.9" y="176.0" width="178.8" height="22" rx="3" />
 <text class="edge-label" x="449.2" y="191.0">2. …/decisions/{slug} 저장</text>
 <line class="failure-mark" x1="547.0" y1="189.0" x2="573.0" y2="215.0" />
 <line class="failure-mark" x1="573.0" y1="189.0" x2="547.0" y2="215.0" />
-<polyline class="edge kind-response style-solid emphasis-normal semantic-dashed" points="560.0,264.0 750.0,264.0" data-evidence="682-683" />
+<polyline class="edge kind-response style-solid emphasis-normal semantic-dashed" points="560.0,264.0 750.0,264.0" data-evidence="919-926" />
 <rect class="edge-label-bg" x="605.8" y="238.0" width="98.4" height="22" rx="3" />
 <text class="edge-label" x="655.0" y="253.0">3. 저장된 주소 조회</text>
-<polyline class="edge kind-response style-solid emphasis-normal semantic-dashed" points="750.0,326.0 960.0,326.0" data-evidence="677-678" />
+<polyline class="edge kind-response style-solid emphasis-normal semantic-dashed" points="750.0,326.0 960.0,326.0" data-evidence="913-921" />
 <rect class="edge-label-bg" x="795.8" y="300.0" width="118.5" height="22" rx="3" />
 <text class="edge-label" x="855.0" y="315.0">4. 같은 형태로 링크 전달</text>
-<polyline class="edge kind-request style-solid emphasis-normal" points="960.0,388.0 1190.0,388.0" data-evidence="670-675" />
+<polyline class="edge kind-request style-solid emphasis-normal" points="960.0,388.0 1190.0,388.0" data-evidence="913-919" />
 <rect class="edge-label-bg" x="985.6" y="362.0" width="178.8" height="22" rx="3" />
 <text class="edge-label" x="1075.0" y="377.0">5. …/decisions/{slug} 요청</text>
-<polyline class="edge kind-response style-solid emphasis-warning semantic-dashed" points="1190.0,450.0 960.0,450.0" data-evidence="670-675" />
+<polyline class="edge kind-response style-solid emphasis-warning semantic-dashed" points="1190.0,450.0 960.0,450.0" data-evidence="913-919" />
 <rect class="edge-label-bg" x="1045.9" y="424.0" width="58.2" height="22" rx="3" />
 <text class="edge-label" x="1075.0" y="439.0">6. 404</text>
 <line class="failure-mark" x1="947.0" y1="437.0" x2="973.0" y2="463.0" />