docs(n+1liner): adopt the decomposition contract and strip evaluative prose

- 계약 채택 — schema 2 → 4. 독자 질문, 후보 36건(PROMOTE 24 · MERGE_INTO 8 · KEEP_IN_SSOT 4), 종류별 칸, kind:slug 관계. 저장소 github-project/ca-tmpl @ 761384d (문서가 인용한 IT 7종이 그 커밋에 있다) - 재선별 결과 기존 24건이 전부 살아남았다. 측정이 Reference 안에 들어 있었지만 독립성 검사를 통과하지 못해 Case 로 빼지 않았다 - 평문 칸의 백틱 제거, 「기준선」을 실제 이름으로, frontmatter 에 source·sourceRevision - 리뷰 39건 반영 — 설명 뒤에 붙은 평가·예고·되풀이·독자 오해 가정을 지웠다. 사실을 담은 절반이 있는 문장은 평가만 뺐다 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-07 12:39:20 +09:00
parent b25357c48a
commit 62520a4dce
28 changed files with 1818 additions and 838 deletions
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <svg xmlns="http://www.w3.org/2000/svg" width="660" height="230" viewBox="0 0 660 230" role="img" aria-labelledby="diagram-title diagram-description">
-<title id="diagram-title">프로젝션은 엔티티 적재를 없애지만 자식 행수는 그대로 남는다</title>
+<title id="diagram-title">프로젝션은 엔티티 적재를 없애지만 자식 행수는 줄지 않는다</title>
 <desc id="diagram-description">왼쪽 배치 방식은 페이지를 조회하면서 엔티티를 대량으로 하이드레이트한다. 가운데 프로젝션은 필요한 스칼라 값만 캐리어로 받아 엔티티를 만들지 않고 발행 쿼리도 상수로 고정한다. 다만 오른쪽처럼 자식 조회는 페이지 부모의 자식을 전부 가져오므로 행수는 줄지 않는다. 화면이 필요로 하는 것은 부모당 상위 몇 개뿐이다.</desc>
 <defs>
  <marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
@@ -0,0 +1,5 @@
+EXPLAIN (ANALYZE, BUFFERS) 원문 25건. 실제 PostgreSQL 16(Testcontainers)에서 조회 전략마다 뜬 실행계획을
+그대로 받아 적었다. 파일 이름의 접두사가 SSOT 의 측정 랩과 짝이다 — l3 은 9절 카테시안 조인, l4 는 10절
+인메모리 페이징, l5 는 11절 배치, l6 은 12절 프로젝션, l14 는 13절 Top-N, l15 는 14절 keyset,
+l16 은 15절 가시성, crown 은 16절 통합이다. highlights-child-plan-A 와 toone-*-plan 은 6·7절의 반복 쿼리다.
+계획은 warm 캐시에서 잰 값이라 cold 실행시간으로 읽지 않는다.
@@ -0,0 +1,6 @@
+측정 수치 csv 18건. 각 파일이 SSOT 본문 표 하나의 원본이다. l1 은 6절 조회 증가와 시드 편중 분포,
+l2 는 7절 ToOne 분해, l3 은 9절 전송 행수, l4 는 10절 인메모리 페이징과 비용 곡선, l5 는 11절 배치,
+l6 은 12절 프로젝션, l14 는 13절 Top-N 과 인덱스 토글과 K 곡선, l15 는 14절 깊이 곡선,
+l16 은 15절 가시성 3안, crown 은 16절 통합이다.
+행수·쿼리 수처럼 결정적인 값과 buffers·지연처럼 환경에 좌우되는 값이 한 파일에 섞여 있다.
+뒤의 것은 같은 실행 안에서의 상대 대조로만 읽는다.