refactor: 문서 개선 중

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

 # Studio 에서는 보이는데 공개 쪽만 비면 그 사이에 계약이 있다

-Studio 편집기에서는 값이 다 보이는데 공개 화면만 비어 있으면, 두 화면이 같은 DB 를 보고 있으므로 그 사이의 계약에 칸이 없다. 이 저장소에서 같은 신호가 여덟 번 같은 원인을 가리켰다.
+Studio 편집기에서는 값이 다 보이는데 공개 화면만 비어 있다면, 작성과 공개 사이의 계약 경계를 먼저 확인할 만한 강한 신호다. 이 저장소에서는 같은 신호가 여덟 번 계약 누락을 가리켰지만, 저장 구조가 종류별로 다른 경우에는 조회 로직이 원인일 수 있다.

 ## 관계

@@ -36,7 +36,7 @@ Studio 편집기에서는 값이 다 보이는데 공개 화면만 비어 있으

 ### 1. Studio 에서는 보이고 공개 쪽만 비면 그 사이의 계약을 먼저 본다

-두 화면이 같은 데이터베이스를 보는데 한쪽만 비면, 다른 것은 그 사이에 놓인 계약이다. 작성 쪽은 작성 계약을 지나고 조회 쪽은 조회 계약을 지난다. 이 저장소에서 같은 신호가 여덟 번 같은 원인을 가리켰다.
+두 화면이 같은 데이터베이스를 보는데 한쪽만 비면, 먼저 두 화면 사이의 계약 차이를 확인한다. 작성 쪽은 작성 계약을 지나고 조회 쪽은 조회 계약을 지난다. 이 저장소에서는 같은 신호가 여덟 번 계약 누락을 가리켰다. 이름과 계약이 맞는데도 값이 비면 종류별 저장 구조와 조회 로직으로 범위를 옮긴다.

 ### 2. 화면이 그리는 칸을 먼저 적고 응답에 있는지 하나씩 맞춘다

@@ -21,7 +21,7 @@ source:
 ## 관계

 - **관계의 요약이 경계 세 곳을 지나며 사라졌다**
-  한 경계를 고치고 판단해 두 번 틀린 사건이다.
+  한 경계를 고치고 판단해 두 번 틀린 사건이다. 여기서 요약은 공개 계약의 `ResolvedRelation.summary`다.
 - **공개 화면 한 줄이 그려지기까지 값이 지나는 경계 열한 개**
  왜 중간 확인이 부족한지가 그 개념에 있다.
 - **TypeScript 가 검사를 놓아 주는 네 곳**