refactor(be) : language.yml을 추가해 언어 문자열을 BuildConfig로 생성, TourTool에서 사용할 수 있도록 Client와 Service 수정

Author: YangHJ2415

build.gradle.kts

@@ -34,6 +34,7 @@ dependencies {
     implementation("org.springframework.boot:spring-boot-starter-web")
     implementation("org.springframework.boot:spring-boot-starter-webflux")
     implementation("com.fasterxml.jackson.module:jackson-module-kotlin")
+    implementation("com.fasterxml.jackson.dataformat:jackson-dataformat-yaml")
     implementation("org.jetbrains.kotlin:kotlin-reflect")
 
     // jwt
@@ -140,6 +141,17 @@ buildConfig {
                 "${parts[0].trim()}: ${parts[1].trim().replace("\"", "")}"
             }
 
+    val languageCodesDescription =
+        file("src/main/resources/language.yml")
+            .readText()
+            .substringAfter("codes:")
+            .lines()
+            .filter { it.contains(":") }
+            .joinToString(", ") { line ->
+                val parts = line.split(":")
+                "${parts[0].trim()}: ${parts[1].trim().replace("\"", "")}"
+            }
+
     val regionCodes =
         file("src/main/resources/region-codes.yml")
             .readText()
@@ -165,6 +177,7 @@ buildConfig {
 
     buildConfigField("String", "AREA_CODES_DESCRIPTION", "\"\"\"$areaCodes\"\"\"")
     buildConfigField("String", "CONTENT_TYPE_CODES_DESCRIPTION", "\"\"\"$contentTypeCodes\"\"\"")
+    buildConfigField("String", "LANGUAGE_CODES_DESCRIPTION", "\"\"\"$languageCodesDescription\"\"\"")
     buildConfigField("String", "REGION_CODES_DESCRIPTION", "\"\"\"$regionCodes\"\"\"")
     buildConfigField("String", "KOREA_TRAVEL_GUIDE_SYSTEM", "\"\"\"$systemPrompt\"\"\"")
     buildConfigField("String", "AI_ERROR_FALLBACK", "\"\"\"$errorPrompt\"\"\"")

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/client/TourApiClient.kt

@@ -27,18 +27,18 @@ class TourApiClient(
     // 지역 기반 관광 정보 조회 (areaBasedList2)
     fun fetchTourInfo(
         params: TourParams,
-        language: TourLanguage = TourLanguage.KOREAN,
+        serviceSegment: String,
     ): TourResponse {
         val url =
-            buildTourUri(language, "areaBasedList2") {
+            buildTourUri(serviceSegment, "areaBasedList2") {
                 queryParam("contentTypeId", params.contentTypeId)
                 queryParam("areaCode", params.areaCode)
                 queryParam("sigunguCode", params.sigunguCode)
             }
 
         val body =
             runCatching { restTemplate.getForObject(url, String::class.java) }
-                .onFailure { log.error("관광 정보 조회 실패", it) }
+                .onFailure { log.error("관광 정보 조회 실패 - serviceSegment={}", serviceSegment, it) }
                 .getOrNull()
 
         return body
@@ -51,10 +51,10 @@ class TourApiClient(
     fun fetchLocationBasedTours(
         tourParams: TourParams,
         locationParams: TourLocationBasedParams,
-        language: TourLanguage = TourLanguage.KOREAN,
+        serviceSegment: String,
     ): TourResponse {
         val url =
-            buildTourUri(language, "locationBasedList2") {
+            buildTourUri(serviceSegment, "locationBasedList2") {
                 queryParam("mapX", locationParams.mapX)
                 queryParam("mapY", locationParams.mapY)
                 queryParam("radius", locationParams.radius)
@@ -65,7 +65,7 @@ class TourApiClient(
 
         val body =
             runCatching { restTemplate.getForObject(url, String::class.java) }
-                .onFailure { log.error("위치기반 관광 정보 조회 실패", it) }
+                .onFailure { log.error("위치기반 관광 정보 조회 실패 - serviceSegment={}", serviceSegment, it) }
                 .getOrNull()
 
         return body
@@ -77,16 +77,16 @@ class TourApiClient(
     // 공통정보 조회 (detailCommon2)
     fun fetchTourDetail(
         params: TourDetailParams,
-        language: TourLanguage = TourLanguage.KOREAN,
+        serviceSegment: String,
     ): TourDetailResponse {
         val url =
-            buildTourUri(language, "detailCommon2") {
+            buildTourUri(serviceSegment, "detailCommon2") {
                 queryParam("contentId", params.contentId)
             }
 
         val body =
             runCatching { restTemplate.getForObject(url, String::class.java) }
-                .onFailure { log.error("공통정보 조회 실패", it) }
+                .onFailure { log.error("공통정보 조회 실패 - serviceSegment={}", serviceSegment, it) }
                 .getOrNull()
 
         return body
@@ -95,10 +95,6 @@ class TourApiClient(
             ?: TourDetailResponse(items = emptyList())
     }
 
-    /*
-     * areaBasedList2/locationBasedList2 JSON 응답에서 `response.body.items.item` 배열만 추출
-     * Kotlin 도메인 모델(TourItem) 목록으로 변환한다. item 노드가 비어 있으면 빈 목록을 반환한다.
-     */
     private fun parseItems(json: String): TourResponse {
         val itemNodes = extractItemNodes(json, "관광 정보")
         if (itemNodes.isEmpty()) return TourResponse(items = emptyList())
@@ -128,10 +124,6 @@ class TourApiClient(
         return TourResponse(items = items)
     }
 
-    /*
-     * detailCommon2 JSON 응답을 파싱해 `TourDetailItem` 목록으로 변환한다.
-     * 항목이 없으면 빈 응답을 돌려준다. 필드 구성이 다르기 때문에 detailCommon2 은 별도 파서로 분리한다.
-     */
     private fun parseDetailItems(json: String): TourDetailResponse {
         val itemNodes = extractItemNodes(json, "공통정보")
         if (itemNodes.isEmpty()) return TourDetailResponse(items = emptyList())
@@ -154,10 +146,6 @@ class TourApiClient(
         return TourDetailResponse(items = items)
     }
 
-    /*
-     * 공통 응답 구조에서 resultCode가 성공(0000)인지 검사한 뒤 `item` 배열 노드를 리스트로 반환한다.
-     * 실패 코드거나 배열이 비어 있으면 빈 리스트를 돌려준다.
-     */
     private fun extractItemNodes(
         json: String,
         apiName: String,
@@ -187,18 +175,13 @@ class TourApiClient(
         return itemsNode.map { it }
     }
 
-    /**
-     * 공통 URL 빌더
-     * - 설정된 기본 URL을 바탕으로 언어 세그먼트(e.g. KorService2, EngService2)와 공통 쿼리 파라미터
-     * - (`serviceKey`, `MobileOS`, `MobileApp`, `_type`)를 자동으로 붙여 관광 API 호출용 URI를 만든다.
-     */
     private fun buildTourUri(
-        language: TourLanguage,
+        serviceSegment: String,
         vararg pathSegments: String,
         customize: UriComponentsBuilder.() -> Unit = {},
     ): URI =
         UriComponentsBuilder.fromUri(URI.create(apiUrl))
-            .pathSegment(language.serviceSegment, *pathSegments)
+            .pathSegment(serviceSegment, *pathSegments)
             .apply {
                 queryParam("serviceKey", serviceKey)
                 queryParam("MobileOS", "WEB")

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/client/TourLanguage.kt

@@ -1,6 +1,5 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service
 
-import com.back.koreaTravelGuide.domain.ai.tour.client.TourLanguage
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourDetailParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourDetailResponse
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourLocationBasedParams
@@ -28,38 +27,42 @@ class TourService(
 
     /**
      * 지역 기반 관광 정보를 조회한다.
-     * 언어 문자열을 enum으로 정규화해 다국어 엔드포인트에 맞춰 전달한다.
+     * 언어 문자열을 설정으로 정규화해 다국어 엔드포인트에 맞춰 전달한다.
      */
     fun fetchTours(
         tourParams: TourParams,
         languageCode: String? = null,
     ): TourResponse {
-        val language = TourLanguage.from(languageCode)
-        return tourAreaBasedUseCase.fetchAreaBasedTours(tourParams, language)
+        val serviceSegment = languageCode?.takeIf { it.isNotBlank() } ?: DEFAULT_LANGUAGE_SEGMENT
+        return tourAreaBasedUseCase.fetchAreaBasedTours(tourParams, serviceSegment)
     }
 
     /**
      * 위치 기반 관광 정보를 조회한다.
-     * 전달받은 언어 코드를 enum으로 치환해 API 클라이언트에 전달한다.
+     * 전달받은 언어 값을 설정 기반 서비스 세그먼트로 치환해 API 클라이언트를 호출한다.
      */
     fun fetchLocationBasedTours(
         tourParams: TourParams,
         locationParams: TourLocationBasedParams,
         languageCode: String? = null,
     ): TourResponse {
-        val language = TourLanguage.from(languageCode)
-        return tourLocationBasedUseCase.fetchLocationBasedTours(tourParams, locationParams, language)
+        val serviceSegment = languageCode?.takeIf { it.isNotBlank() } ?: DEFAULT_LANGUAGE_SEGMENT
+        return tourLocationBasedUseCase.fetchLocationBasedTours(tourParams, locationParams, serviceSegment)
     }
 
     /**
      * 관광지 상세 정보를 조회한다.
-     * 언어 코드를 정규화해 상세 API 호출 시 사용한다.
+     * 언어 값을 정규화해 상세 API 호출 시 사용한다.
      */
     fun fetchTourDetail(
         detailParams: TourDetailParams,
         languageCode: String? = null,
     ): TourDetailResponse {
-        val language = TourLanguage.from(languageCode)
-        return tourDetailUseCase.fetchTourDetail(detailParams, language)
+        val serviceSegment = languageCode?.takeIf { it.isNotBlank() } ?: DEFAULT_LANGUAGE_SEGMENT
+        return tourDetailUseCase.fetchTourDetail(detailParams, serviceSegment)
+    }
+
+    companion object {
+        private const val DEFAULT_LANGUAGE_SEGMENT = "KorService2"
     }
 }

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/service/TourService.kt

@@ -1,7 +1,6 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service.core
 
 import com.back.koreaTravelGuide.domain.ai.tour.client.TourApiClient
-import com.back.koreaTravelGuide.domain.ai.tour.client.TourLanguage
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourItem
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourResponse
@@ -16,12 +15,12 @@ class TourAreaBasedServiceCore(
     @Cacheable(
         "tourAreaBased",
         key =
-            "#tourParams.contentTypeId + '_' + #tourParams.areaCode + '_' + #tourParams.sigunguCode + '_' + #language.serviceSegment",
+            "#tourParams.contentTypeId + '_' + #tourParams.areaCode + '_' + #tourParams.sigunguCode + '_' + #serviceSegment",
         unless = "#result == null",
     )
     override fun fetchAreaBasedTours(
         tourParams: TourParams,
-        language: TourLanguage,
+        serviceSegment: String,
     ): TourResponse {
         if (
             tourParams.contentTypeId == "12" &&
@@ -31,7 +30,7 @@ class TourAreaBasedServiceCore(
             return PRESET_AREA_TOUR_RESPONSE
         }
 
-        return tourApiClient.fetchTourInfo(tourParams, language)
+        return tourApiClient.fetchTourInfo(tourParams, serviceSegment)
     }
 
     private companion object {

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/service/core/TourAreaBasedServiceCore.kt

@@ -1,7 +1,6 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service.core
 
 import com.back.koreaTravelGuide.domain.ai.tour.client.TourApiClient
-import com.back.koreaTravelGuide.domain.ai.tour.client.TourLanguage
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourDetailItem
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourDetailParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourDetailResponse
@@ -15,18 +14,18 @@ class TourDetailServiceCore(
 ) : TourDetailUseCase {
     @Cacheable(
         "tourDetail",
-        key = "#detailParams.contentId + '_' + #language.serviceSegment",
+        key = "#detailParams.contentId + '_' + #serviceSegment",
         unless = "#result == null",
     )
     override fun fetchTourDetail(
         detailParams: TourDetailParams,
-        language: TourLanguage,
+        serviceSegment: String,
     ): TourDetailResponse {
         if (detailParams.contentId == "127974") {
             return PRESET_DETAIL_RESPONSE
         }
 
-        return tourApiClient.fetchTourDetail(detailParams, language)
+        return tourApiClient.fetchTourDetail(detailParams, serviceSegment)
     }
 
     private companion object {

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/service/core/TourDetailServiceCore.kt

@@ -1,7 +1,6 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service.core
 
 import com.back.koreaTravelGuide.domain.ai.tour.client.TourApiClient
-import com.back.koreaTravelGuide.domain.ai.tour.client.TourLanguage
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourItem
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourLocationBasedParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourParams
@@ -19,13 +18,13 @@ class TourLocationBasedServiceCore(
         key =
             "#tourParams.contentTypeId + '_' + #tourParams.areaCode + '_' + #tourParams.sigunguCode + '_' + " +
                 "#locationParams.mapX + '_' + #locationParams.mapY + '_' + #locationParams.radius + '_' + " +
-                "#language.serviceSegment",
+                "#serviceSegment",
         unless = "#result == null",
     )
     override fun fetchLocationBasedTours(
         tourParams: TourParams,
         locationParams: TourLocationBasedParams,
-        language: TourLanguage,
+        serviceSegment: String,
     ): TourResponse {
         if (
             tourParams.contentTypeId == "39" &&
@@ -38,7 +37,7 @@ class TourLocationBasedServiceCore(
             return PRESET_LOCATION_BASED_RESPONSE
         }
 
-        return tourApiClient.fetchLocationBasedTours(tourParams, locationParams, language)
+        return tourApiClient.fetchLocationBasedTours(tourParams, locationParams, serviceSegment)
     }
 
     private companion object {

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/service/core/TourLocationBasedServiceCore.kt

@@ -1,12 +1,11 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service.usecase
 
-import com.back.koreaTravelGuide.domain.ai.tour.client.TourLanguage
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourResponse
 
 interface TourAreaBasedUseCase {
     fun fetchAreaBasedTours(
         tourParams: TourParams,
-        language: TourLanguage,
+        serviceSegment: String,
     ): TourResponse
 }

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/service/usecase/TourAreaBasedUseCase.kt

@@ -1,12 +1,11 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service.usecase
 
-import com.back.koreaTravelGuide.domain.ai.tour.client.TourLanguage
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourDetailParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourDetailResponse
 
 interface TourDetailUseCase {
     fun fetchTourDetail(
         detailParams: TourDetailParams,
-        language: TourLanguage,
+        serviceSegment: String,
     ): TourDetailResponse
 }

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/service/usecase/TourDetailUseCase.kt

@@ -1,6 +1,5 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service.usecase
 
-import com.back.koreaTravelGuide.domain.ai.tour.client.TourLanguage
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourLocationBasedParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourParams
 import com.back.koreaTravelGuide.domain.ai.tour.dto.TourResponse
@@ -9,6 +8,6 @@ interface TourLocationBasedUseCase {
     fun fetchLocationBasedTours(
         tourParams: TourParams,
         locationParams: TourLocationBasedParams,
-        language: TourLanguage,
+        serviceSegment: String,
     ): TourResponse
 }