DongHyeonkaandClaude Fable 5.1
b25357c48a
- 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>
95 lines
5.2 KiB
Markdown
95 lines
5.2 KiB
Markdown
---
|
|
kind: CASE
|
|
slug: analysis-finding-a06-f024
|
|
title: promotion 증거 어휘가 둘이고, gate는 하나만 검사한다
|
|
topic: multitenancy-isolation
|
|
project: clean-architecture-backend-template
|
|
status: 게시 전
|
|
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
|
|
rootTreeNode: case:analysis-finding-a06-f024
|
|
evidenceCapturedOn: 2026-09-01
|
|
assets:
|
|
- key: analysis-finding-a06-f024
|
|
file: ../../../final/evidence/rendered/analysis-finding-a06-f024.svg
|
|
evidence:
|
|
- ../../../final/evidence/raw/analysis-finding-a06-f024.txt
|
|
source:
|
|
- 원본 분석 절은 final/document.md#a06#L1305 이다.
|
|
---
|
|
|
|
# promotion 증거 어휘가 둘이고, gate는 하나만 검사한다
|
|
|
|
승격 증거의 필수 범주가 여섯이고 게이트가 그 여섯을 검사한다. 벡터 검색 벤치마크 게이트는 완전히 다른 다섯 범주를 요구하는데 그 집합을 읽는 프로덕션 코드가 없다.
|
|
|
|
## 관계
|
|
|
|
- **빠뜨림이 통과가 되는 게이트는 게이트가 아니다**
|
|
이 사례가 그 규칙의 형태다.
|
|
- **같은 개념의 두 어휘가 공존하면 하나를 죽은 것으로 표시한다**
|
|
증거 어휘가 둘인 구조다.
|
|
- **능력 등급은 코드가 아니라 실행된 증거에서 파생한다**
|
|
승격이 요구하는 증거의 성질이다.
|
|
|
|
## 문제
|
|
|
|
승격 증거의 필수 범주는 여섯이다. 안정 플랫폼과 실제 토폴로지와 보안과 마이그레이션과 실패와 런북이다.
|
|
|
|
승격 게이트가 그 여섯을 전부 검사한다.
|
|
|
|
그리고 그 파일에는 고쳐진 결함이 주석으로 남아 있다. 한 범주가 필수 목록에는 있고 게이트에는 없어서, 게이트가 선언한 여섯 중 다섯만 요구했다는 것이다. 주석은 그것을 실행한 것보다 많이 인증하는 게이트의 모양이라고 부른다.
|
|
|
|
## 결론
|
|
|
|
같은 모양이 모듈 경계를 건너 다시 나타난다.
|
|
|
|
벡터 검색 벤치마크 게이트는 완전히 다른 다섯 범주를 요구한다. 인덱스 준비도와 재현율과 지연과 메모리와 실제 토폴로지다.
|
|
|
|
겹치는 것은 실제 토폴로지 하나뿐이고, 이 집합을 읽는 프로덕션 코드가 없다. 승격 게이트는 이 집합을 모른다.
|
|
|
|
그래서 벡터 검색을 승격하는 경로는 승격 게이트를 통과할 수 있고, 그 통과는 재현율과 지연과 인덱스 메모리에 대해 아무것도 말하지 않는다.
|
|
|
|
벤치마크 게이트의 javadoc 이 정확히 그 위험을 적는데도 그렇다. 기능적 성공은 벡터 검색의 증거가 아니며, 근사 인덱스는 어떤 질의에 대해서도 결과를 돌려주고 그것이 옳은 결과인지는 재현율에 달렸다는 것이다.
|
|
|
|
방금 한 범주 누락으로 고쳤던 것과 같은 모양이 반복된다. 선언한 것보다 적게 검사하는 게이트다.
|
|
|
|
## 검증 환경
|
|
|
|
OpenJDK : 21.0.12
|
|
확인 방식 : 두 게이트의 요구 범주 대조와 참조 계수
|
|
소스 수정 : x
|
|
|
|
## 재현 조건
|
|
|
|
원문은 final/evidence/raw/137 계열에 있다.
|
|
|
|
1. 승격 증거의 필수 범주 목록을 확인한다.
|
|
2. 승격 게이트가 검사하는 범주를 확인한다.
|
|
3. 그 파일의 고쳐진 결함 주석을 읽는다.
|
|
4. 벤치마크 게이트가 요구하는 범주를 확인한다.
|
|
5. 그 집합을 읽는 프로덕션 코드를 센다.
|
|
|
|
## 본문
|
|
|
|
<!-- body:start -->
|
|
|
|
`MongoAdvancedPromotionEvidence.REQUIRED`는 여섯 범주다 — `stable-platform`, `actual-topology`, `security`, `migration`, `failure`, `runbook`. `MongoAdvancedPromotionGate.verify(...)`가 그 여섯을 전부 검사한다. 그 파일에는 고쳐진 결함이 주석으로 남아 있다 — "`migration` was in `MongoAdvancedPromotionEvidence.REQUIRED` and not here, so the gate demanded five of the six categories it declares… which is the shape MNG-008 names: a gate that certifies more than it ran."
|
|
|
|
## MongoAdvancedPromotionEvidence 참조 위치
|
|
|
|
:::evidence key="analysis-finding-a06-f024" alt="코드베이스에서 MongoAdvancedPromotionEvidence 를 검색한 출력 3줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="MongoAdvancedPromotionEvidence 코드베이스 검색 — 3줄 · exit 0" zoom="true"
|
|
:::
|
|
|
|
## 다른 gate가 완전히 다른 다섯 범주를 반환한다
|
|
|
|
`MongoVectorSearchBenchmarkGate.requiredEvidence()`는 `index-readiness`, `recall`, `latency`, `memory`, `actual-topology`를 반환한다. 겹치는 것은 `actual-topology` 하나뿐이고, 이 집합을 읽는 production 코드는 없다(`137-...` §8.3). `MongoAdvancedPromotionGate`는 이 집합을 모른다.
|
|
|
|
## 통과가 아무것도 말하지 않는 구간
|
|
|
|
vector search를 promotion하는 경로는 `MongoAdvancedPromotionGate.verify`를 통과할 수 있고, 그 통과는 recall·latency·index memory에 대해 아무것도 말하지 않는다 — `MongoVectorSearchBenchmarkGate`의 javadoc이 정확히 그 위험을 적는데도: "Functional success is not evidence for vector search. An approximate index returns results for any query; whether they are the right results depends on recall." 방금 `migration` 누락으로 고쳤던 것과 같은 모양이 모듈 경계를 건너 다시 나타난다. P3.
|
|
|
|
## 확인하지 못한 것
|
|
|
|
벡터 검색 승격을 실제로 시도해 통과하는 것을 재현하지 않았다.
|
|
|
|
<!-- body:end -->
|