feat(be): Tour service 구현 및 Dto구조 변경 (#24)

Author: YangHJ2415

src/main/kotlin/com/back/koreaTravelGuide/domain/ai/tour/dto/InternalData.kt

@@ -8,13 +8,18 @@ package com.back.koreaTravelGuide.domain.ai.tour.dto
 
 data class InternalData(
     // 한 페이지 데이터 수, 10으로 지정
-    val numOfRows: Int = 10,
+    val numOfRows: Int = DEFAULT_ROWS,
     // 페이지 번호, 1로 지정
-    val pageNo: Int = 1,
+    val pageNo: Int = DEFAULT_PAGE,
     // 관광타입 ID, 미 입력시 전체 조회 (12:관광지, 38 : 쇼핑...),
     val contentTypeId: String? = "",
     // 지역코드, 미 입력시 지역 전체 조회 (1:서울, 2:인천...)
     val areaCode: String? = "",
     // 시군구코드, 미 입력시 전체 조회
     val sigunguCode: String? = "",
-)
+) {
+    companion object {
+        const val DEFAULT_ROWS = 10
+        const val DEFAULT_PAGE = 1
+    }
+}

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

@@ -1,4 +1,50 @@
 package com.back.koreaTravelGuide.domain.ai.tour.service
 
-// TODO: 관광 정보 캐싱 서비스 - 캐시 관리 및 데이터 제공
-class TourService
+import com.back.koreaTravelGuide.domain.ai.tour.client.TourApiClient
+import com.back.koreaTravelGuide.domain.ai.tour.dto.InternalData
+import com.back.koreaTravelGuide.domain.ai.tour.dto.TourResponse
+import org.slf4j.LoggerFactory
+import org.springframework.stereotype.Service
+
+// 09.26 양현준
+@Service
+class TourService(
+    private val tourApiClient: TourApiClient,
+) {
+    private val logger = LoggerFactory.getLogger(this::class.java)
+
+    // 관광 정보 조회
+    fun fetchTours(
+        numOfRows: Int? = null,
+        pageNo: Int? = null,
+        contentTypeId: String? = null,
+        areaCode: String? = null,
+        sigunguCode: String? = null,
+    ): List<TourResponse> {
+        // InternalData 객체 생성, null 또는 비정상 값은 기본값으로 대체
+        val request =
+            InternalData(
+                numOfRows = numOfRows?.takeIf { it > 0 } ?: InternalData.DEFAULT_ROWS,
+                pageNo = pageNo?.takeIf { it > 0 } ?: InternalData.DEFAULT_PAGE,
+                contentTypeId = contentTypeId?.ifBlank { null } ?: "",
+                areaCode = areaCode?.ifBlank { null } ?: "",
+                sigunguCode = sigunguCode?.ifBlank { null } ?: "",
+            )
+
+        // request를 바탕으로 관광 정보 API 호출
+        val tours = tourApiClient.fetchTourInfo(request)
+
+        // 관광 정보 결과 로깅
+        if (tours.isEmpty()) {
+            logger.info(
+                "관광 정보 없음: params={} / {} {}",
+                request.areaCode,
+                request.sigunguCode,
+                request.contentTypeId,
+            )
+        } else {
+            logger.info("관광 정보 {}건 조회 성공", tours.size)
+        }
+        return tours
+    }
+}