docs(i18n): 공급자 enum과 DB code 호환 계약을 기록한다

2026-11-09 19:15:27 +09:00
parent ec890047a5
commit 2bd2328548
4 changed files with 311 additions and 28 deletions
@@ -0,0 +1,32 @@
+# 공급자 enum 전환 Phase 3 리뷰
+
+| 항목 | 내용 |
+|---|---|
+| 일자 | 2026-11-09 |
+| 범위 | LP-013~015 및 Phase 1·2 보존 계약, 전체 미커밋 변경과 신규 파일 |
+| 기준 | [PRD](../prd.md) Phase 3, [계획](../plan-task.md) P3, 현재 확장 가이드 |
+| 리뷰어 | 독립 읽기 전용 gate reviewer |
+| 판정 | **APPROVE** |
+
+## 확인 결과
+
+- 공급자 인터페이스·구현체·성공 결과·순서·매칭은 enum이며 providerName alias/호환 shim이 없다.
+- enum은 PAPAGO/AWS 두 항목이고 기본 순서는 PAPAGO 하나다. 실제 AWS adapter/SDK는 추가하지 않았다.
+- `.code`는 DB 조회·저장 경계 6곳에 적용된다. entity/repository String, 고유 키와 schema는 그대로다.
+- `.name`/`.ordinal`/`valueOf` 저장/변환이나 불필요한 fromCode가 없다.
+- 기존 papago 문자열 기대값을 유지하고 AWS 저장값은 독립 문자열 aws로 확인한다.
+- 빈 목록·중복 순서·중복 구현체·해당 capability의 AWS 구현체 부재를 거부한다.
+- fallback·개수/blank·첫 성공 중단·DB 오류 전파·cache-first·동시성·revision·afterCommit·분할 검증을 유지한다.
+
+**확정 발견 사항 없음. 추가 수정 Task 전환 항목 없음.**
+
+## 실행 증거와 한계
+
+리뷰어가 현재 XML 16개를 직접 대조하여 91/91, failures/errors/skipped 0을 확인했다.
+컴파일 가능한 runtime getter assertion의 RED, 구현자의 실제 lint/bootJar 성공,
+부모 fresh filtered test --rerun 성공(52초)과 별도 Java/Spring 실행 증거를 구분해 검토했다.
+부모 driver는 typed getter/adapter ID/기존 문자열 cache 재사용/실패 전환/DB code 인자/미구현 AWS 거부를 확인했다.
+driver repository 대역은 실제 H2 저장·재조회·표시 증거와 구분했다. 리뷰어 git diff --check는 exit 0이다.
+
+리뷰는 파일 변경·테스트/빌드 재실행·서버/API 호출·추가 에이전트 위임 없이 수행했다.
+전체 테스트·LSP·운영 MySQL·실제 유료 API는 미검증이며 H2의 SKIP LOCKED claim은 기존 test spy 한계가 있다.