[Feature/#50] 추천 루틴 API 연동

app/src/main/java/com/threegap/bitnagil/di/data/DataSourceModule.kt

@@ -8,6 +8,8 @@ import com.threegap.bitnagil.data.emotion.datasource.EmotionDataSource
 import com.threegap.bitnagil.data.emotion.datasourceImpl.EmotionDataSourceImpl
 import com.threegap.bitnagil.data.onboarding.datasource.OnBoardingDataSource
 import com.threegap.bitnagil.data.onboarding.datasourceImpl.OnBoardingDataSourceImpl
+import com.threegap.bitnagil.data.recommendroutine.datasource.RecommendRoutineDataSource
+import com.threegap.bitnagil.data.recommendroutine.datasourceImpl.RecommendRoutineDataSourceImpl
 import com.threegap.bitnagil.data.routine.datasource.RoutineRemoteDataSource
 import com.threegap.bitnagil.data.routine.datasourceImpl.RoutineRemoteDataSourceImpl
 import com.threegap.bitnagil.data.writeroutine.datasource.WriteRoutineDataSource
@@ -45,4 +47,8 @@ abstract class DataSourceModule {
     @Binds
     @Singleton
     abstract fun bindWriteRoutineDataSource(writeRoutineDataSourceImpl: WriteRoutineDataSourceImpl): WriteRoutineDataSource
+
+    @Binds
+    @Singleton
+    abstract fun bindRecommendRoutineDataSource(recommendRoutineDataSourceImpl: RecommendRoutineDataSourceImpl): RecommendRoutineDataSource
 }

app/src/main/java/com/threegap/bitnagil/di/data/RepositoryModule.kt

@@ -3,11 +3,13 @@ package com.threegap.bitnagil.di.data
 import com.threegap.bitnagil.data.auth.repositoryimpl.AuthRepositoryImpl
 import com.threegap.bitnagil.data.emotion.repositoryImpl.EmotionRepositoryImpl
 import com.threegap.bitnagil.data.onboarding.repositoryImpl.OnBoardingRepositoryImpl
+import com.threegap.bitnagil.data.recommendroutine.repositoryImpl.RecommendRoutineRepositoryImpl
 import com.threegap.bitnagil.data.routine.repositoryImpl.RoutineRepositoryImpl
 import com.threegap.bitnagil.data.writeroutine.repositoryImpl.WriteRoutineRepositoryImpl
 import com.threegap.bitnagil.domain.auth.repository.AuthRepository
 import com.threegap.bitnagil.domain.emotion.repository.EmotionRepository
 import com.threegap.bitnagil.domain.onboarding.repository.OnBoardingRepository
+import com.threegap.bitnagil.domain.recommendroutine.repository.RecommendRoutineRepository
 import com.threegap.bitnagil.domain.routine.repository.RoutineRepository
 import com.threegap.bitnagil.domain.writeroutine.repository.WriteRoutineRepository
 import dagger.Binds
@@ -39,4 +41,8 @@ abstract class RepositoryModule {
     @Binds
     @Singleton
     abstract fun bindWriteRoutineRepository(writeRoutineRepositoryImpl: WriteRoutineRepositoryImpl): WriteRoutineRepository
+
+    @Binds
+    @Singleton
+    abstract fun bindRecommendRoutineRepository(recommendRoutineRepositoryImpl: RecommendRoutineRepositoryImpl): RecommendRoutineRepository
 }

app/src/main/java/com/threegap/bitnagil/di/data/ServiceModule.kt

@@ -3,6 +3,7 @@ package com.threegap.bitnagil.di.data
 import com.threegap.bitnagil.data.auth.service.AuthService
 import com.threegap.bitnagil.data.emotion.service.EmotionService
 import com.threegap.bitnagil.data.onboarding.service.OnBoardingService
+import com.threegap.bitnagil.data.recommendroutine.service.RecommendRoutineService
 import com.threegap.bitnagil.data.routine.service.RoutineService
 import com.threegap.bitnagil.data.writeroutine.service.WriteRoutineService
 import com.threegap.bitnagil.di.core.Auth
@@ -48,4 +49,9 @@ object ServiceModule {
     @Singleton
     fun provideReissueService(@NoneAuth retrofit: Retrofit): ReissueService =
         retrofit.create(ReissueService::class.java)
+
+    @Provides
+    @Singleton
+    fun provideRecommendRoutineService(@Auth retrofit: Retrofit): RecommendRoutineService =
+        retrofit.create(RecommendRoutineService::class.java)
 }

data/src/main/java/com/threegap/bitnagil/data/recommendroutine/datasource/RecommendRoutineDataSource.kt

@@ -0,0 +1,7 @@
+package com.threegap.bitnagil.data.recommendroutine.datasource
+
+import com.threegap.bitnagil.data.recommendroutine.model.response.RecommendRoutinesDto
+
+interface RecommendRoutineDataSource {
+    suspend fun fetchRecommendRoutines(): Result<RecommendRoutinesDto>
+}

data/src/main/java/com/threegap/bitnagil/data/recommendroutine/datasourceImpl/RecommendRoutineDataSourceImpl.kt

@@ -0,0 +1,17 @@
+package com.threegap.bitnagil.data.recommendroutine.datasourceImpl
+
+import com.threegap.bitnagil.data.common.safeApiCall
+import com.threegap.bitnagil.data.recommendroutine.datasource.RecommendRoutineDataSource
+import com.threegap.bitnagil.data.recommendroutine.model.response.RecommendRoutinesDto
+import com.threegap.bitnagil.data.recommendroutine.service.RecommendRoutineService
+import javax.inject.Inject
+
+class RecommendRoutineDataSourceImpl @Inject constructor(
+    private val recommendRoutineService: RecommendRoutineService,
+) : RecommendRoutineDataSource {
+
+    override suspend fun fetchRecommendRoutines(): Result<RecommendRoutinesDto> =
+        safeApiCall {
+            recommendRoutineService.fetchRecommendRoutines()
+        }
+}

data/src/main/java/com/threegap/bitnagil/data/recommendroutine/model/response/RecommendRoutinesDto.kt

@@ -0,0 +1,23 @@
+package com.threegap.bitnagil.data.recommendroutine.model.response
+
+import com.threegap.bitnagil.domain.recommendroutine.model.EmotionMarbleType
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendCategory
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendRoutines
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class RecommendRoutinesDto(
+    @SerialName("recommendedRoutines")
+    val recommendedRoutinesByCategory: Map<String, List<RecommendedRoutineDto>>,
+    @SerialName("emotionMarbleType")
+    val emotionMarbleType: String?,
+)
+
+fun RecommendRoutinesDto.toDomain(): RecommendRoutines =
+    RecommendRoutines(
+        recommendRoutinesByCategory = this.recommendedRoutinesByCategory.map { (categoryString, routines) ->
+            RecommendCategory.fromString(categoryString) to routines.map { it.toDomain() }
+        }.toMap(),
+        emotionMarbleType = this.emotionMarbleType?.let { EmotionMarbleType.valueOf(it) },
+    )

data/src/main/java/com/threegap/bitnagil/data/recommendroutine/model/response/RecommendedRoutineDto.kt

@@ -0,0 +1,32 @@
+package com.threegap.bitnagil.data.recommendroutine.model.response
+
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendLevel
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendRoutine
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class RecommendedRoutineDto(
+    @SerialName("recommendedRoutineId")
+    val recommendedRoutineId: Int,
+    @SerialName("recommendedRoutineName")
+    val recommendedRoutineName: String,
+    @SerialName("recommendedRoutineDescription")
+    val recommendedRoutineDescription: String,
+    @SerialName("recommendedRoutineLevel")
+    val recommendedRoutineLevel: String,
+    @SerialName("executionTime")
+    val executionTime: String,
+    @SerialName("recommendedSubRoutineSearchResult")
+    val recommendedSubRoutineSearchResult: List<RecommendedSubRoutineDto>,
+)
+
+fun RecommendedRoutineDto.toDomain(): RecommendRoutine =
+    RecommendRoutine(
+        id = recommendedRoutineId,
+        name = recommendedRoutineName,
+        description = recommendedRoutineDescription,
+        level = RecommendLevel.fromString(recommendedRoutineLevel),
+        executionTime = executionTime,
+        recommendSubRoutines = recommendedSubRoutineSearchResult.map { it.toDomain() },
+    )

data/src/main/java/com/threegap/bitnagil/data/recommendroutine/model/response/RecommendedSubRoutineDto.kt

@@ -0,0 +1,19 @@
+package com.threegap.bitnagil.data.recommendroutine.model.response
+
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendSubRoutine
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class RecommendedSubRoutineDto(
+    @SerialName("recommendedSubRoutineId")
+    val recommendedSubRoutineId: Int,
+    @SerialName("recommendedSubRoutineName")
+    val recommendedSubRoutineName: String,
+)
+
+fun RecommendedSubRoutineDto.toDomain(): RecommendSubRoutine =
+    RecommendSubRoutine(
+        id = recommendedSubRoutineId,
+        name = recommendedSubRoutineName,
+    )

data/src/main/java/com/threegap/bitnagil/data/recommendroutine/repositoryImpl/RecommendRoutineRepositoryImpl.kt

@@ -0,0 +1,15 @@
+package com.threegap.bitnagil.data.recommendroutine.repositoryImpl
+
+import com.threegap.bitnagil.data.recommendroutine.datasource.RecommendRoutineDataSource
+import com.threegap.bitnagil.data.recommendroutine.model.response.toDomain
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendRoutines
+import com.threegap.bitnagil.domain.recommendroutine.repository.RecommendRoutineRepository
+import javax.inject.Inject
+
+class RecommendRoutineRepositoryImpl @Inject constructor(
+    private val recommendRoutineDataSource: RecommendRoutineDataSource,
+) : RecommendRoutineRepository {
+    override suspend fun fetchRecommendRoutines(): Result<RecommendRoutines> =
+        recommendRoutineDataSource.fetchRecommendRoutines()
+            .map { it.toDomain() }
+}

data/src/main/java/com/threegap/bitnagil/data/recommendroutine/service/RecommendRoutineService.kt

@@ -0,0 +1,10 @@
+package com.threegap.bitnagil.data.recommendroutine.service
+
+import com.threegap.bitnagil.data.recommendroutine.model.response.RecommendRoutinesDto
+import com.threegap.bitnagil.network.model.BaseResponse
+import retrofit2.http.GET
+
+interface RecommendRoutineService {
+    @GET("/api/v1/recommend-routines")
+    suspend fun fetchRecommendRoutines(): BaseResponse<RecommendRoutinesDto>
+}

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/model/EmotionMarbleType.kt

@@ -0,0 +1,10 @@
+package com.threegap.bitnagil.domain.recommendroutine.model
+
+enum class EmotionMarbleType {
+    CALM,
+    VITALITY,
+    LETHARGY,
+    ANXIETY,
+    SATISFACTION,
+    FATIGUE,
+}

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/model/RecommendCategory.kt

@@ -0,0 +1,22 @@
+package com.threegap.bitnagil.domain.recommendroutine.model
+
+enum class RecommendCategory(
+    val categoryName: String,
+    val displayName: String,
+    val isVisible: Boolean = true,
+) {
+    PERSONALIZED("PERSONALIZED", "맞춤 추천"),
+    OUTING("OUTING", "나가봐요"),
+    WAKE_UP("WAKE_UP", "일어나요"),
+    CONNECT("CONNECT", "연결해요"),
+    REST("REST", "쉬어가요"),
+    GROW("GROW", "성장해요"),
+    OUTING_REPORT("OUTING_REPORT", "신고", isVisible = false),
+    UNKNOWN("UNKNOWN", "알 수 없음", isVisible = false),
+    ;
+
+    companion object {
+        fun fromString(categoryName: String): RecommendCategory =
+            entries.find { it.categoryName == categoryName } ?: UNKNOWN
+    }
+}

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/model/RecommendLevel.kt

@@ -0,0 +1,16 @@
+package com.threegap.bitnagil.domain.recommendroutine.model
+
+enum class RecommendLevel(
+    val level: String,
+    val displayName: String,
+) {
+    LEVEL1("LEVEL1", "가볍게 할 수 있어요"),
+    LEVEL2("LEVEL2", "조금 신경써서 할 수 있어요"),
+    LEVEL3("LEVEL3", "의지를 다 잡고 할 수 있어요"),
+    ;
+
+    companion object {
+        fun fromString(levelName: String): RecommendLevel =
+            entries.find { it.level == levelName } ?: LEVEL1
+    }
+}

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/model/RecommendRoutine.kt

@@ -0,0 +1,10 @@
+package com.threegap.bitnagil.domain.recommendroutine.model
+
+data class RecommendRoutine(
+    val id: Int,
+    val name: String,
+    val description: String,
+    val level: RecommendLevel,
+    val executionTime: String,
+    val recommendSubRoutines: List<RecommendSubRoutine>,
+)

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/model/RecommendRoutines.kt

@@ -0,0 +1,6 @@
+package com.threegap.bitnagil.domain.recommendroutine.model
+
+data class RecommendRoutines(
+    val recommendRoutinesByCategory: Map<RecommendCategory, List<RecommendRoutine>>,
+    val emotionMarbleType: EmotionMarbleType?,
+)

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/model/RecommendSubRoutine.kt

@@ -0,0 +1,6 @@
+package com.threegap.bitnagil.domain.recommendroutine.model
+
+data class RecommendSubRoutine(
+    val id: Int,
+    val name: String,
+)

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/repository/RecommendRoutineRepository.kt

@@ -0,0 +1,7 @@
+package com.threegap.bitnagil.domain.recommendroutine.repository
+
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendRoutines
+
+interface RecommendRoutineRepository {
+    suspend fun fetchRecommendRoutines(): Result<RecommendRoutines>
+}

domain/src/main/java/com/threegap/bitnagil/domain/recommendroutine/usecase/FetchRecommendRoutinesUseCase.kt

@@ -0,0 +1,12 @@
+package com.threegap.bitnagil.domain.recommendroutine.usecase
+
+import com.threegap.bitnagil.domain.recommendroutine.model.RecommendRoutines
+import com.threegap.bitnagil.domain.recommendroutine.repository.RecommendRoutineRepository
+import javax.inject.Inject
+
+class FetchRecommendRoutinesUseCase @Inject constructor(
+    private val recommendRoutineRepository: RecommendRoutineRepository,
+) {
+    suspend operator fun invoke(): Result<RecommendRoutines> =
+        recommendRoutineRepository.fetchRecommendRoutines()
+}