refactor: 문서 개선 중

2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -23,7 +23,7 @@ source:
 - **계약은 앵커라고 적었고 만드는 쪽은 경로를 만들었다**
  같은 앵커 구조에서 난 주소 쪽 사건이다.
 - **관계의 요약이 경계 세 곳을 지나며 사라졌다**
-  같은 시기에 계약의 빈칸으로 난 다른 사건이다.
+  같은 시기에 계약의 빈칸으로 난 다른 사건이다. 여기서 요약은 공개 계약의 `ResolvedRelation.summary`다.

 ## 문제

@@ -7,6 +7,9 @@ topicName: 값이 경계에서 사라진다
 project: TechLog
 status: 게시 전
 lastVerifiedOn: 2026-09-04
+assets:
+  - key: summary-drop-path
+    file: ../../../final/assets/diagrams/summary-drop-path/summary-drop-path.svg
 sourceRevision: tech-log@2026-09-02
 source:
  - final/document.md#§5.2
@@ -15,7 +18,7 @@ source:

 # 관계의 요약이 경계 세 곳을 지나며 사라졌다

-관계 목록의 라벨을 고쳤는데 요약은 여전히 비어 있었다. 한 경계를 고치고 확인했더니 다음 경계가 버리고 있었고, 그것을 고치니 그다음이 버렸다. 세 번째는 계약에 담을 칸 자체가 없었다.
+공개 relation 목록의 라벨을 고쳤는데 `ResolvedRelation.summary`는 여전히 비어 있었다. 한 경계를 고치고 확인했더니 다음 경계가 버리고 있었고, 그것을 고치니 그다음이 버렸다. 세 번째는 계약에 담을 칸 자체가 없었다.

 ## 관계

@@ -28,7 +31,7 @@ source:

 ## 문제

-관계 목록은 한 줄에 대상의 종류와 작성자가 쓴 이유와 대상의 요약을 보인다. 라벨은 고쳤는데 요약 칸이 계속 비어 있었다.
+공개 relation 목록은 한 줄에 대상의 종류와 작성자가 쓴 이유와 대상의 요약을 보인다. 라벨은 고쳤는데 요약 칸이 계속 비어 있었다.

 계약에는 요약이 있었다. DB 에도 값이 있었다. 화면까지 오지 못했다.

@@ -63,6 +66,10 @@ tech-log-backend : 92679f5 이후

 ## 세 번 버려졌다

+이 그림은 열한 경계 전체가 아니라 이번 사고에서 `summary`가 실제로 끊긴 세 지점만 좁혀 본다.
+
+![summary가 계약에서 flattenRelations, ResolvedRelation, 화면 목록을 지나며 세 번 끊긴 경로](../../../final/assets/diagrams/summary-drop-path/summary-drop-path.svg)
+
 관계 목록의 라벨을 고치고 화면을 봤을 때 요약은 여전히 비어 있었다. 값이 지나는 경계를 하나씩 따라가니 세 곳에서 버려지고 있었다.

 ```text