docs(clean-architecture-backend-template): fold analysis into final and re-select one topic

- analysis/·source-index·state.json 을 final/document.md 제2부·제3부로 접었다. SSOT 는 하나다 - 파일럿 — commit-ambiguity-as-a-result 를 새 기준으로 재선별. 후보 14 → 글감 5 (PROMOTE 5 · MERGE_INTO 3 · KEEP_IN_SSOT 4 · 보류 2). 기록 5건을 다시 썼고 그림 1개를 techviz 로 만들었다 - 재선별이 잡은 것: 제1부 §6.2·§11.1 이 자기 §13.2 와 어긋나 있었다(레인을 안 돌렸다 vs 돌렸다) — 정정. 이미 답이 나와 있던 Question 을 HEAD 재실행 질문으로 다시 세웠다. Concept 이 인용한 코드가 SSOT 에 없어 뺐다 - candidateScope·sourceRepository 기록. 나머지 43개 주제는 재선별 대기(PENDING 905) Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-07 12:39:20 +09:00
parent 9d2a3725c5
commit b25357c48a
1080 changed files with 135560 additions and 120406 deletions
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a03-f001.txt
 source:
-  - 원본 분석 절은 analysis/03-application-core.md §16 P1 이다.
+  - 원본 분석 절은 final/document.md#a03 §16 P1 이다.
 ---

 # 네 답을 주는 claim 이 있는데 서비스는 있음·없음 두 갈래로 판단한다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a04-f002.txt
 source:
-  - 원본 분석 절은 analysis/04-adapter-outbound-support.md §5 이다.
+  - 원본 분석 절은 final/document.md#a04 §5 이다.
 ---

 # 메시징만 성공 로그를 try 밖으로 옮기고 알림은 같은 try 에 남겨 두었다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a04-f004.txt
 source:
-  - 원본 분석 절은 analysis/04-adapter-outbound-support.md §5 이다.
+  - 원본 분석 절은 final/document.md#a04 §5 이다.
 ---

 # 실패 로거가 던지면 그 예외가 제공자 예외를 밀어내고 호출자로 나간다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a04-f005.txt
 source:
-  - 원본 분석 절은 analysis/04-adapter-outbound-support.md §6 이다.
+  - 원본 분석 절은 final/document.md#a04 §6 이다.
 ---

 # README 의 세 문장 중 둘은 쓰일 때부터 틀렸고 하나만 나중에 어긋났다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f001.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §6.2 이다.
+  - 원본 분석 절은 final/document.md#a05 §6.2 이다.
 ---

 # 추정식의 여유분이 상수라서 인코드가 내준 세 크기를 디코드가 거절한다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f010.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §10 이다.
+  - 원본 분석 절은 final/document.md#a05 §10 이다.
 ---

 # 정본이라던 코디네이터는 그 포트를 구현하지 않고 다른 클래스가 구현한다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f023.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §23 이다.
+  - 원본 분석 절은 final/document.md#a05 §23 이다.
 ---

 # 쿼터 원장은 사용량을 적기만 하고 승인은 그것을 읽지 않는다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f024.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §24 이다.
+  - 원본 분석 절은 final/document.md#a05 §24 이다.
 ---

 # 회수가 페이지 하나를 다 쓰면 남은 바이트를 들고 그대로 끝난다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f028.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §89 이다.
+  - 원본 분석 절은 final/document.md#a05 §89 이다.
 ---

 # 제공자 제출 뒤의 다섯 쓰기 가운데 결과 기록만 조건이 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f030.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §91 이다.
+  - 원본 분석 절은 final/document.md#a05 §91 이다.
 ---

 # claim 이 넣은 CLAIMED 행을 완료로 바꾸는 코드가 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f031.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §116 이다.
+  - 원본 분석 절은 final/document.md#a05 §116 이다.
 ---

 # 오타 난 벤더는 기동을 멈추지만 그 프로퍼티를 지목하지 못한다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f032.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §125 이다.
+  - 원본 분석 절은 final/document.md#a05 §125 이다.
 ---

 # 포화된 풀의 대기 수를 단언하는 시험이 풀 계약 레인에 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a05-f034.txt
 source:
-  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md §133 이다.
+  - 원본 분석 절은 final/document.md#a05 §133 이다.
 ---

 # 세 카드의 태그를 채우는 시험이 프로덕션 타입을 한 줄도 부르지 않는다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f002.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §5 이다.
+  - 원본 분석 절은 final/document.md#a06 §5 이다.
 ---

 # 가드가 막겠다는 문장이 실제로 있는 두 파일이 탐색 범위 밖이다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f004.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §16 이다.
+  - 원본 분석 절은 final/document.md#a06 §16 이다.
 ---

 # 전용 category 를 붙이는 유일한 분기가 도달할 수 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f005.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §17 이다.
+  - 원본 분석 절은 final/document.md#a06 §17 이다.
 ---

 # cause 를 받지 않는다는 루트 규칙이 스물둘 중 하나에 대해 거짓이다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f007.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §25 이다.
+  - 원본 분석 절은 final/document.md#a06 §25 이다.
 ---

 # 게이트웨이가 적은 순서의 timeout 단계가 정책에 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f008.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §32 이다.
+  - 원본 분석 절은 final/document.md#a06 §32 이다.
 ---

 # 데드라인을 서버로 보내는 접근자를 부르는 프로덕션 코드가 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f009.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §33 이다.
+  - 원본 분석 절은 final/document.md#a06 §33 이다.
 ---

 # 예산 초과 분기가 한 관측에 success 와 failure 를 차례로 부른다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f010.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §42 이다.
+  - 원본 분석 절은 final/document.md#a06 §42 이다.
 ---

 # 집계 실행기가 컬렉션 이름을 문자열로 따로 받는다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f014.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §57 이다.
+  - 원본 분석 절은 final/document.md#a06 §57 이다.
 ---

 # 인덱스 diff 는 열네 요소 중 keySignature 와 unique 만 비교한다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f015.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §58 이다.
+  - 원본 분석 절은 final/document.md#a06 §58 이다.
 ---

 # MongoTtlPolicyValidator 를 부르는 프로덕션 코드가 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f019.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §69 이다.
+  - 원본 분석 절은 final/document.md#a06 §69 이다.
 ---

 # MongoChangeHistoryLostException 을 만드는 코드가 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f021.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §76 이다.
+  - 원본 분석 절은 final/document.md#a06 §76 이다.
 ---

 # 드라이런만 감사 싱크를 직접 불러 번역을 거치지 않는다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f022.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §77 이다.
+  - 원본 분석 절은 final/document.md#a06 §77 이다.
 ---

 # 허용 목록 검사를 부르는 프로덕션 코드가 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f023.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md §85 이다.
+  - 원본 분석 절은 final/document.md#a06 §85 이다.
 ---

 # 고위험 관리 작업 넷이 승인을 널로 넘기는 오버로드를 부른다
@@ -14,7 +14,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f024.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md#L1305 이다.
+  - 원본 분석 절은 final/document.md#a06#L1305 이다.
 ---

 # promotion 증거 어휘가 둘이고, gate는 하나만 검사한다
@@ -14,7 +14,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f025.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md#L1324 이다.
+  - 원본 분석 절은 final/document.md#a06#L1324 이다.
 ---

 # 구현 없는 4개의 계약 중 셋은 그 사실을 적고, 하나는 적지 않는다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f026.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md#L1383 이다.
+  - 원본 분석 절은 final/document.md#a06#L1383 이다.
 ---

 # 커버리지 gate 둘이 나란히 있고, 하나는 발화할 수 없다
@@ -83,7 +83,7 @@ OpenJDK : 21.0.12

 ## suite javadoc 이 적은 존재 이유

-:::evidence key="analysis-finding-a06-f026" alt="분석 문서 analysis/06-adapter-outbound-persistence-mongo.md 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="analysis/06-adapter-outbound-persistence-mongo.md 발췌 — 15줄" zoom="true"
+:::evidence key="analysis-finding-a06-f026" alt="분석 문서 final/document.md#a06 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a06 발췌 — 15줄" zoom="true"
 :::

 ## 구현은 그 구분을 만들 수 없다
@@ -15,7 +15,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f027.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md#L1410 이다.
+  - 원본 분석 절은 final/document.md#a06#L1410 이다.
 ---

 # release gate가 실제로 차단하는 것은 hermetic test 3개이고, mongo용 CI workflow는 없다
@@ -81,7 +81,7 @@ release gate가 실제로 차단하는 것은 hermetic test 3개이고, mongo용

 ## release gate 가 실제로 거는 것

-:::evidence key="analysis-finding-a06-f027" alt="분석 문서 analysis/06-adapter-outbound-persistence-mongo.md 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="analysis/06-adapter-outbound-persistence-mongo.md 발췌 — 15줄" zoom="true"
+:::evidence key="analysis-finding-a06-f027" alt="분석 문서 final/document.md#a06 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a06 발췌 — 15줄" zoom="true"
 :::

 ## 개별 코드 결함이 아니라 검증 지형이다
@@ -14,7 +14,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/analysis-finding-a06-f028.txt
 source:
-  - 원본 분석 절은 analysis/06-adapter-outbound-persistence-mongo.md#L1433 이다.
+  - 원본 분석 절은 final/document.md#a06#L1433 이다.
 ---

 # 소비자가 없는 fixture 셋
@@ -82,7 +82,7 @@ OpenJDK : 21.0.12

 ## test 와 testkit 양쪽에서 0 인 타입

-:::evidence key="analysis-finding-a06-f028" alt="분석 문서 analysis/06-adapter-outbound-persistence-mongo.md 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="analysis/06-adapter-outbound-persistence-mongo.md 발췌 — 15줄" zoom="true"
+:::evidence key="analysis-finding-a06-f028" alt="분석 문서 final/document.md#a06 에서 이 기록의 근거 절을 그대로 잘라낸 15줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a06 발췌 — 15줄" zoom="true"
 :::

 ## 셋째가 가장 무겁다
@@ -14,7 +14,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/search-path-survived-the-return-to-the-pool.txt
 source:
-  - 원본 분석 절은 analysis/05 §13.2 이다.
+  - 원본 분석 절은 final/document.md#a05 §13.2 이다.
 ---

 # search_path가 풀로 돌아간 커넥션에 남아 다음 tenant가 상속한다
@@ -71,7 +71,7 @@ source:

 ## search_path 가 세션 설정이라는 것

-:::evidence key="search-path-survived-the-return-to-the-pool" alt="분석 문서 analysis/05-adapter-outbound-persistence-jpa.md 에서 이 기록의 근거 절을 그대로 잘라낸 16줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="analysis/05-adapter-outbound-persistence-jpa.md 발췌 — 16줄" zoom="true"
+:::evidence key="search-path-survived-the-return-to-the-pool" alt="분석 문서 final/document.md#a05 에서 이 기록의 근거 절을 그대로 잘라낸 16줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a05 발췌 — 16줄" zoom="true"
 :::

 ## 다음 borrower 가 아무 오류 없이 거기서 읽고 쓴다
@@ -14,7 +14,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/tenant-pools-summed-past-the-server-ceiling.txt
 source:
-  - 원본 분석 절은 analysis/05 §13.2 이다.
+  - 원본 분석 절은 final/document.md#a05 §13.2 이다.
 ---

 # tenant별 풀이 개별적으로 합리적이고 그 합이 서버 상한을 넘긴다
@@ -78,7 +78,7 @@ pool count만으로는 풀 크기 차이를 무시하고, connection total만으

 ## 예산이 새 pool 크기를 계산하지 않는다

-`analysis/05` §98이 기록하듯 그래서 ceiling을 넘길 수 있다.
+`final/document.md#a05` §98이 기록하듯 그래서 ceiling을 넘길 수 있다.

 ## 확인하지 못한 것

@@ -14,7 +14,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/three-ways-rls-does-nothing.txt
 source:
-  - 원본 분석 절은 final/document.md#4-1 · analysis/05 §13.1, §17 P8 이다.
+  - 원본 분석 절은 final/document.md#4-1 · final/document.md#a05 §13.1, §17 P8 이다.
 ---

 # RLS가 아무것도 하지 않는 세 가지 방법
@@ -86,7 +86,7 @@ tenant 격리가 컬럼에 의존하면 그 테이블의 **모든 uniqueness 요

 ## verifier 자신에게도 결함이 있다

-`analysis/05` §97이 기록하듯 "반드시 보호돼야 하는 table"의 부재를 성공으로 인정한다.
+`final/document.md#a05` §97이 기록하듯 "반드시 보호돼야 하는 table"의 부재를 성공으로 인정한다.

 ## 확인하지 못한 것

@@ -16,7 +16,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/four-multitenancy-strategies.txt
 source:
-  - 원본 분석 절은 analysis/05 §13.2 이다.
+  - 원본 분석 절은 final/document.md#a05 §13.2 이다.
 ---

 # 네 가지 멀티테넌시 전략과 각각의 격리 경계
@@ -49,7 +49,7 @@ column은 predicate 누락이 곧 유출, RLS는 세 전제(§concept\:rls-three

 ## 네 전략이 각각 놓인 플래그

-:::evidence key="four-multitenancy-strategies" alt="분석 문서 analysis/05-adapter-outbound-persistence-jpa.md 에서 이 기록의 근거 절을 그대로 잘라낸 16줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="analysis/05-adapter-outbound-persistence-jpa.md 발췌 — 16줄" zoom="true"
+:::evidence key="four-multitenancy-strategies" alt="분석 문서 final/document.md#a05 에서 이 기록의 근거 절을 그대로 잘라낸 16줄. 코드베이스를 측정한 것이 아니라 원본 판정이 무엇을 적었는지를 보여 준다." caption="final/document.md#a05 발췌 — 16줄" zoom="true"
 :::

 ## TenantId 정규식이 네 전략 전부의 기반인 이유
@@ -16,7 +16,7 @@ assets:
 evidence:
  - ../../../final/evidence/raw/rls-three-preconditions.txt
 source:
-  - 원본 분석 절은 final/document.md#4-1 · analysis/05 §13.1 이다.
+  - 원본 분석 절은 final/document.md#4-1 · final/document.md#a05 §13.1 이다.
 ---

 # RLS가 성립하기 위한 세 전제
@@ -12,7 +12,7 @@ decidedOn: 2026-08-30
 source:
  - src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/experimental/ExperimentalFeatureGate.java
  - src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/experimental/multitenancy/RlsTenantSessionBinder.java
-  - analysis/05-adapter-outbound-persistence-jpa.md
+  - final/document.md#a05
 ---

 # 클래스패스에 있는 것은 실행 동의가 아니다