docs(i18n): 코드 기반 공급자 순서 설정과 검증을 기록한다

docs/20261109_감지번역공급자공통화/provider-guide.md

@@ -27,7 +27,7 @@ AWS 감지·번역 adapter, 해당 SDK 및 전용 인증 설정은 추가하지
    `providerName`은 capability 내 유일하고 재배포 후에도 안정적인 값이어야 한다.
 2. 공급자의 HTTP/SDK 및 인증은 adapter 안에 둔다. 외부 응답 형식과 빈 결과를 검증하고,
    원문·인증정보·응답 본문·예외 cause를 로그로 출력하지 않는다. 번역은 입력별 결과를 같은 순서로 반환한다.
-3. 구현한 capability의 설정 순서에만 이름을 넣고 재시작/재배포한다. `@Primary`, selector 분기, enum 등록은 필요 없다.
+3. `LanguageProviderOrder.kt`에서 구현한 capability의 목록에만 이름을 넣고 빌드·배포한다. `@Primary`, selector 분기, enum 등록은 필요 없다.
 4. 아래 테스트 경계로 순서·실패 전환·실제 provider 저장·무호출 캐시 재사용·materializer 표시를 검증한다.
 
 콘텐츠·댓글·커뮤니티 호출자, worker, materializer, scheduler에 공급자 분기를 추가하지 않는다.
@@ -35,33 +35,37 @@ AWS 감지·번역 adapter, 해당 SDK 및 전용 인증 설정은 추가하지
 Papago의 5,000 UTF-16 단위 분할과 서로게이트 쌍 보존은 `PapagoTranslationService`에 남아 있다.
 ko/en/ja 서비스 정책은 `TranslationLanguages`에 있으며 공급자를 추가해도 자동 확장하지 않는다.
 
-## 기능별 독립 설정
+## 기능별 독립 코드 목록
 
-`LanguageProviderProperties`는 component scan으로 등록되며 생성자 `@Value`로 문자열을 주입받는다.
-별도 `@EnableConfigurationProperties` 등록은 필요 없다. 쉼표로 나누고 각 이름의 앞뒤 공백을 제거한다.
-기본값은 두 기능 모두 `papago`다.
+production 순서의 유일한 편집 지점은
+`src/main/kotlin/kr/co/vividnext/sodalive/i18n/translation/LanguageProviderOrder.kt`다.
+목록의 왼쪽부터 사용하며 기본값은 두 기능 모두 `listOf("papago")`다.
 
-```yaml
-sodalive:
-    language-providers:
-        detection-order: ${LANGUAGE_PROVIDERS_DETECTION_ORDER:papago}
-        translation-order: ${LANGUAGE_PROVIDERS_TRANSLATION_ORDER:papago}
+```kotlin
+object LanguageProviderOrder {
+    val detectionOrder = listOf("papago")
+    val translationOrder = listOf("papago")
+}
 ```
 
+Kotlin 목록은 `const val`이 아닌 `val`이다. `LanguageProviderProperties`는 기존 주입 wrapper로 유지하며,
+Spring은 `@Autowired` 기본 생성자로 위 목록을 읽는다. 문자열 파싱은 하지 않는다.
+테스트에서는 전역 목록을 변경하지 않고 `LanguageProviderProperties(List<String>, List<String>)`로 만든 테스트 bean을 주입한다.
+
 다음은 **secondary 구현체를 두 capability에 등록한 뒤에만** 적용할 수 있는 예시다.
 현재 `secondary` 구현체는 테스트에만 있다.
 
-```bash
-export LANGUAGE_PROVIDERS_DETECTION_ORDER=secondary,papago
-export LANGUAGE_PROVIDERS_TRANSLATION_ORDER=papago,secondary
+```kotlin
+val detectionOrder = listOf("secondary", "papago")
+val translationOrder = listOf("papago", "secondary")
 ```
 
 감지만 순서를 바꾸어도 번역 순서는 바뀌지 않는다. 반대로 번역만 바꿀 수도 있다.
-Spring property를 직접 지정할 때는 `sodalive.language-providers.detection-order`와
-`sodalive.language-providers.translation-order`를 각각 설정한다.
+변경 후 빌드·배포해야 반영된다. 과거 우선순위 Spring property·환경변수·YAML 값이 남아 있어도 순서는 바뀌지 않는다.
+공급자 인증정보는 계속 환경변수로 주입하며 이 코드 목록에 넣지 않는다.
 빈 값·빈 항목·중복 이름·미등록 이름·capability 안의 중복 bean 이름표(`providerName`)는 초기화에서 거부한다.
 공급자가 번역에만 등록됐다면 그 이름을 감지 순서에 넣을 수 없다.
-실행 중 설정 변경은 지원하지 않는다. AWS 구현체 등록 전 `papago,aws`는 사용할 수 없다.
+실행 중 설정 변경은 지원하지 않는다. AWS 구현체 등록 전 `listOf("papago", "aws")`는 사용할 수 없다.
 
 ## 캐시와 오류 계약
 
@@ -89,7 +93,7 @@ adapter 예외·null 감지·빈 감지·번역 결과 개수 불일치·blank
 
 | 테스트 | 검증 내용 |
 |---|---|
-| `LanguageProviderSpringConfigurationTest` | 실제 `@Value` binding, 두 test bean, 기능별 독립 순서, 기본값과 잘못된 설정의 시작 실패 |
+| `LanguageProviderSpringConfigurationTest` | 실제 production 기본 생성자, 과거 property/env 무시, typed-list 테스트 bean의 독립 순서와 잘못된 목록의 시작 실패 |
 | `LanguageProviderPropertiesTest` | 순서 검증 및 선택되지 않은 bean을 포함한 capability 내 중복 이름 거부 |
 | `LanguageDetectionProviderTest` / `TranslationCoordinatorTest` | 전체 요청 폴백, 첫 성공 중단, cache-first, 안전한 전체 실패, DB 오류 전파 |
 | `PapagoLanguageDetectionProviderTest` / `PapagoTranslationServiceTest` | 제어된 HTTP form/header/response와 기존 17개 chunk 회귀 |