sodalive-backend-spring-boot/docs/20261109_감지번역공급자공통화/reviews/phase-1-review.md

감지·번역 공급자 공통화 최종 리뷰

항목	내용
일자	2026-11-09
범위	P1-T1/P1-T2와 전체 작업 트리 변경, 신규 미추적 파일 포함
기준	PRD LP-001~010, 구현 계획
리뷰어	독립 읽기 전용 gate reviewer
판정	APPROVE

발견 사항

확정 발견 사항 없음. 추가 회귀 수정 Task로 전환할 항목 없음.

수용 기준

기준	확인 내용
LP-001/002/008	감지·번역별 인터페이스와 순서 설정, 빈/중복/미등록 이름 시작 실패, enum/분기 없이 bean 확장
LP-003/004/007	한 번씩 순차 호출, 첫 성공 중단, 전체 요청 폴백, 입력 guard, 안전한 전체 실패
LP-005/006	실제 provider/version 저장, 모든 활성 provider의 cache-first, worker/materializer의 공통 lookup
LP-009	기존 캐시 데이터·canonical winner·트랜잭션·revision·afterCommit·워커 재시도·Papago 분할 보존
LP-010	실제 코드와 일치하는 확장 가이드, 기본 papago, production AWS 미구현 명시

품질·보안

• catch는 adapter 호출에만 적용하며 DB 오류는 전파한다.
• 원문·인증정보·공급자 응답·원시 vendor 오류를 신규 로그에 기록하지 않는다.
• 기존 latch·경합·stale revision assertion을 삭제/완화하지 않았다.
• 번역 worker의 오류 기대값 변경은 고정 안전 메시지 계약에 따른 것이다.
• 기존 Papago 분할/HTTP 테스트 17건을 수정하지 않았다.

검증 근거

• reviewer가 XML 15개를 직접 확인: 85건, failures/errors/skipped 0.
• reviewer git diff --check: exit 0.
• 부모 실행 증거: fresh filtered test --rerun 성공, ktlintCheck/bootJar 확인.
• 부모 독립 Spring runtime: 감지/번역 순서 각각 교체, fallback 귀속, 캐시 무호출, 전체 실패 및 잘못된 설정 거부.
• 부모 loopback HTTP: 실제 Papago 감지 adapter의 form/header/원문 보존과 성공/blank/500 응답 처리.
• 리뷰는 읽기 전용이며 추가 에이전트, 실제 API, 테스트/빌드 재실행, 파일 변경을 하지 않았다.

남은 검증 한계

실제 유료 API·운영 MySQL·전체 테스트·LSP는 미검증이다. H2의 MySQL SKIP LOCKED claim SQL 한 곳은 테스트 대역이므로 운영 claim 동시성을 검증했다고 주장하지 않는다. 이 한계는 이번 범위의 승인과 구분한다.