chore: 이전 세션이 남긴 변경을 커밋한다

이번 파이프라인 작업과 무관하게 작업 트리에 남아 있던 것을 그대로 올린다. 사용자가 「전부 커밋」으로 정했고, 이번 작업과 섞이지 않게 커밋만 나눴다. 대부분은 clean-architecture-backend-template 의 그림 정본 재배치다 — final/assets/diagrams/<이름>/ 에 있던 것이 CLAUDE.md 가 적은 배치인 final/assets/<이름>/ 로 옮겨졌고 .techviz/<이름>/ 이 함께 들어왔다. 삽입 줄의 대부분(3.15M)이 그 .techviz context.json 이다. 그 밖에 ca-tmpl·document-haness 의 정리, .claude/agents/ 열한 개, writing-practitioner-guides 스킬, .playwright-mcp 세션 산출물, scripts/check-ssot-facts.py 와 그 시험이 들어 있다. 이 커밋의 내용은 내가 만든 것이 아니라 이전 세션이 남긴 것이고 검증하지 않았다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-17 11:02:02 +09:00
parent 2109f726fe
commit ab59130196
1524 changed files with 3160026 additions and 8369 deletions
@@ -0,0 +1,22 @@
+# 구별하는 세 층위
+
+## Alternative text
+
+논리 층의 논리 RPC 에서 물리 층의 물리 시도와 스트림 수명주기로 화살표가 건너간다.
+
+## Long description
+
+SSOT 는 이 리프가 세 층위를 구별한다고 적는다 — 논리 RPC, 물리 시도, 스트림 수명주기. 재시도가 있는 시스템에서 호출 한 번이 무엇인지가 층위마다 다르고 record 구현이 그 구별을 실제로 지킨다.
+
+## Elements and evidence
+
+- **Boundary: 논리 층** (boundary): No additional description. Evidence: L44428–L44431.
+- **Boundary: 물리 층** (boundary): No additional description. Evidence: L44428–L44431.
+- **논리 RPC** (service): No additional description. Evidence: L44428–L44431.
+- **물리 시도** (service): No additional description. Evidence: L44428–L44431.
+- **스트림 수명주기** (service): No additional description. Evidence: L44428–L44431.
+
+## Relationships
+
+- **논리 RPC → 물리 시도:** 재시도마다. Evidence: L44428–L44431.
+- **물리 시도 → 스트림 수명주기:** 스트림이면. Evidence: L44428–L44431.
@@ -0,0 +1,18 @@
+# 구별하는 세 층위
+# Question: 호출 한 번은 어느 층위에서 무엇으로 세는가?
+direction: right
+g0: "논리 층" {
+  n0: "논리 RPC" {
+    shape: rectangle
+  }
+}
+g1: "물리 층" {
+  n1: "물리 시도" {
+    shape: rectangle
+  }
+  n2: "스트림 수명주기" {
+    shape: rectangle
+  }
+}
+g0.n0 -> g1.n1: "재시도마다"
+g1.n1 -> g1.n2: "스트림이면"
@@ -0,0 +1,28 @@
+{
+  "harness_version": "0.2.0",
+  "spec_id": "grpc-observability-c01",
+  "spec_version": "1.1",
+  "spec_sha256": "6eea68019723c03522faadadfbd4399a38bfcdadc460a99ea07feb8f875839bd",
+  "source_context": {
+    "document": "/home/donghyeon/workspace/chat-gpt-container/document-haness/docs/clean-architecture-backend-template/final/document.md",
+    "document_sha256": "8071fe71b3359d9cf60b95909c26c7b50653ce2f22bbc5fcf6988719bb91236d",
+    "anchor": {
+      "kind": "line",
+      "value": 44428,
+      "line": 44428
+    }
+  },
+  "outputs": [
+    "grpc-observability-c01.svg",
+    "grpc-observability-c01.d2",
+    "grpc-observability-c01.alt.md"
+  ],
+  "lint_issue_count": 0,
+  "assumption_count": 0,
+  "assumptions_allowed": false,
+  "composition_profile": "two-zone-pipeline",
+  "reference_ids": [
+    "localization-pipeline"
+  ],
+  "diagram_only": true
+}
@@ -0,0 +1,77 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="1080" height="300" viewBox="0 0 1080 300" role="img" aria-labelledby="diagram-title diagram-description">
+<title id="diagram-title">구별하는 세 층위</title>
+<desc id="diagram-description">SSOT 는 이 리프가 세 층위를 구별한다고 적는다 — 논리 RPC, 물리 시도, 스트림 수명주기. 재시도가 있는 시스템에서 호출 한 번이 무엇인지가 층위마다 다르고 record 구현이 그 구별을 실제로 지킨다.</desc>
+<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;grpc-observability-c01&quot;,&quot;profile&quot;:&quot;two-zone-pipeline&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;/home/donghyeon/workspace/chat-gpt-container/document-haness/docs/clean-architecture-backend-template/final/document.md&quot;,&quot;document_sha256&quot;:&quot;8071fe71b3359d9cf60b95909c26c7b50653ce2f22bbc5fcf6988719bb91236d&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;line&quot;,&quot;value&quot;:44428,&quot;line&quot;:44428}},&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" />
+  </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="1080" height="300" />
+<rect class="group-box" x="45.0" y="49.0" width="250.0" height="136.0" rx="8" />
+<rect class="group-label-bg" x="59.0" y="39.0" width="90.0" height="22" />
+<text class="group-label" x="69.0" y="54.0">논리 층</text>
+<rect class="group-box" x="565.0" y="49.0" width="470.0" height="136.0" rx="8" />
+<rect class="group-label-bg" x="579.0" y="39.0" width="90.0" height="22" />
+<text class="group-label" x="589.0" y="54.0">물리 층</text>
+<polyline class="edge kind-request style-solid emphasis-primary" points="265.0,127.0 430.0,127.0 430.0,127.0 595.0,127.0" data-evidence="44428-44431" />
+<rect class="edge-label-bg" x="404.2" y="85.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="430.0" y="100.0">재시도마다</text>
+<polyline class="edge kind-request style-dashed emphasis-normal" points="785.0,127.0 815.0,127.0 815.0,59.0 785.0,59.0 785.0,127.0 815.0,127.0" data-evidence="44428-44431" />
+<rect class="edge-label-bg" x="774.2" y="17.0" width="51.5" height="22" rx="3" />
+<text class="edge-label" x="800.0" y="32.0">스트림이면</text>
+<g id="node-logical">
+<rect class="node-shape kind-service emphasis-primary role-stage" data-evidence="44428-44431" x="75.0" y="95.0" width="190.0" height="64.0" rx="7" />
+<text class="node-label" x="170.0" y="125.0">논리 RPC</text>
+</g>
+<g id="node-attempt">
+<rect class="node-shape kind-service emphasis-normal role-stage" data-evidence="44428-44431" x="595.0" y="95.0" width="190.0" height="64.0" rx="7" />
+<text class="node-label" x="690.0" y="125.0">물리 시도</text>
+</g>
+<g id="node-stream">
+<rect class="node-shape kind-service emphasis-normal role-stage" data-evidence="44428-44431" x="815.0" y="95.0" width="190.0" height="64.0" rx="7" />
+<text class="node-label" x="910.0" y="125.0">스트림 수명주기</text>
+</g>
+</svg>