[Feat/#1449] 스프린트 3 API 연결

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/datasource/AppjamtampDataSource.kt

@@ -0,0 +1,9 @@
+package org.sopt.official.data.appjamtamp.datasource
+
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop10MissionScoreResponse
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop3RecentMissionResponse
+
+interface AppjamtampDataSource {
+    suspend fun getAppjamtampMissionTop3(size: Int): AppjamtampTop3RecentMissionResponse
+    suspend fun getAppjamtampMissionRanking(size: Int): AppjamtampTop10MissionScoreResponse
+}

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/datasourceimpl/AppjamtampDataSourceImpl.kt

@@ -0,0 +1,20 @@
+package org.sopt.official.data.appjamtamp.datasourceimpl
+
+import org.sopt.official.data.appjamtamp.datasource.AppjamtampDataSource
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop10MissionScoreResponse
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop3RecentMissionResponse
+import org.sopt.official.data.appjamtamp.service.AppjamtampService
+import javax.inject.Inject
+
+internal class AppjamtampDataSourceImpl @Inject constructor(
+    private val appjamtampService: AppjamtampService
+) : AppjamtampDataSource {
+
+    override suspend fun getAppjamtampMissionTop3(size: Int): AppjamtampTop3RecentMissionResponse {
+        return appjamtampService.getAppjamtampMissionTop3(size = size)
+    }
+
+    override suspend fun getAppjamtampMissionRanking(size: Int): AppjamtampTop10MissionScoreResponse {
+        return appjamtampService.getAppjamtampMissionRanking(size = size)
+    }
+}

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/di/DataSourceModule.kt

@@ -0,0 +1,17 @@
+package org.sopt.official.data.appjamtamp.di
+
+import dagger.Binds
+import dagger.Module
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import org.sopt.official.data.appjamtamp.datasource.AppjamtampDataSource
+import org.sopt.official.data.appjamtamp.datasourceimpl.AppjamtampDataSourceImpl
+import javax.inject.Singleton
+
+@Module
+@InstallIn(SingletonComponent::class)
+internal abstract class DataSourceModule {
+    @Binds
+    @Singleton
+    abstract fun bindAppjamtampDataSource(appjamtampDataSourceImpl: AppjamtampDataSourceImpl): AppjamtampDataSource
+}

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/di/RepositoryModule.kt

@@ -0,0 +1,22 @@
+package org.sopt.official.data.appjamtamp.di
+
+import dagger.Binds
+import dagger.Module
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import org.sopt.official.data.appjamtamp.repository.AppjamtampRepositoryImpl
+import org.sopt.official.domain.appjamtamp.repository.AppjamtampRepository
+import javax.inject.Singleton
+
+@Module
+@InstallIn(SingletonComponent::class)
+abstract class RepositoryModule {
+
+    @Binds
+    @Singleton
+    abstract fun bindAppjamtampRepository(
+        appjamtampRepositoryImpl: AppjamtampRepositoryImpl
+    ): AppjamtampRepository
+
+
+}

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/di/ServiceModule.kt

@@ -0,0 +1,19 @@
+package org.sopt.official.data.appjamtamp.di
+
+import dagger.Module
+import dagger.Provides
+import dagger.hilt.InstallIn
+import dagger.hilt.components.SingletonComponent
+import org.sopt.official.common.di.AppRetrofit
+import org.sopt.official.data.appjamtamp.service.AppjamtampService
+import retrofit2.Retrofit
+import javax.inject.Singleton
+
+@Module
+@InstallIn(SingletonComponent::class)
+internal object ServiceModule {
+    @Provides
+    @Singleton
+    fun provideAppjamtampService(@AppRetrofit(true) retrofit: Retrofit): AppjamtampService =
+        retrofit.create(AppjamtampService::class.java)
+}

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/dto/response/AppjamtampTop10MissionScoreResponse.kt

@@ -0,0 +1,25 @@
+package org.sopt.official.data.appjamtamp.dto.response
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class AppjamtampTop10MissionScoreResponse(
+    @SerialName("ranks")
+    val ranks: List<AppjamtampMissionScoreResponse>
+)
+
+@Serializable
+data class AppjamtampMissionScoreResponse(
+    @SerialName("rank")
+    val rank: Int,
+
+    @SerialName("teamName")
+    val teamName: String,
+
+    @SerialName("todayPoints")
+    val todayPoints: Int,
+
+    @SerialName("totalPoints")
+    val totalPoints: Int
+)

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/dto/response/AppjamtampTop3RecentMissionResponse.kt

@@ -0,0 +1,40 @@
+package org.sopt.official.data.appjamtamp.dto.response
+
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class AppjamtampTop3RecentMissionResponse(
+    @SerialName("ranks")
+    val ranks: List<AppjamtampRecentMissionResponse>
+)
+
+@Serializable
+data class AppjamtampRecentMissionResponse(
+    @SerialName("stampId")
+    val stampId: Long,
+
+    @SerialName("missionId")
+    val missionId: Long,
+
+    @SerialName("userId")
+    val userId: Long,
+
+    @SerialName("imageUrl")
+    val imageUrl: String,
+
+    @SerialName("createdAt")
+    val createdAt: String?,
+
+    @SerialName("userName")
+    val userName: String,
+
+    @SerialName("userProfileImage")
+    val userProfileImage: String?,
+
+    @SerialName("teamName")
+    val teamName: String,
+
+    @SerialName("teamNumber")
+    val teamNumber: String
+)

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/mapper/AppjamptampMapper.kt

@@ -0,0 +1,41 @@
+package org.sopt.official.data.appjamtamp.mapper
+
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampMissionScoreResponse
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampRecentMissionResponse
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop3RecentMissionResponse
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop10MissionScoreResponse
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionScore
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampRecentMission
+
+
+internal fun AppjamtampTop3RecentMissionResponse.toDomain(): List<AppjamtampRecentMission> {
+    return this.ranks.map { it.toDomain() }
+}
+
+internal fun AppjamtampRecentMissionResponse.toDomain(): AppjamtampRecentMission {
+    return AppjamtampRecentMission(
+        stampId = this.stampId,
+        missionId = this.missionId,
+        userId = this.userId,
+        imageUrl = this.imageUrl,
+        createdAt = this.createdAt,
+        userName = this.userName,
+        userProfileImage = this.userProfileImage,
+        teamName = this.teamName,
+        teamNumber = this.teamNumber
+    )
+}
+
+internal fun AppjamtampTop10MissionScoreResponse.toDomain(): List<AppjamtampMissionScore> {
+    return this.ranks.map { it.toDomain() }
+}
+
+internal fun AppjamtampMissionScoreResponse.toDomain(): AppjamtampMissionScore {
+    return AppjamtampMissionScore(
+        rank = this.rank,
+        teamName = this.teamName,
+        todayPoints = this.todayPoints,
+        totalPoints = this.todayPoints
+    )
+}
+

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/repository/AppjamtampRepositoryImpl.kt

@@ -0,0 +1,26 @@
+package org.sopt.official.data.appjamtamp.repository
+
+import org.sopt.official.common.coroutines.suspendRunCatching
+import org.sopt.official.data.appjamtamp.datasource.AppjamtampDataSource
+import org.sopt.official.data.appjamtamp.mapper.toDomain
+import org.sopt.official.data.appjamtamp.service.AppjamtampService
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionScore
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampRecentMission
+import org.sopt.official.domain.appjamtamp.repository.AppjamtampRepository
+import javax.inject.Inject
+
+class AppjamtampRepositoryImpl @Inject constructor(
+    private val appjamtampDataSource: AppjamtampDataSource
+): AppjamtampRepository {
+    override suspend fun getAppjamtampMissionRanking(
+        size: Int
+    ): Result<List<AppjamtampMissionScore>> = suspendRunCatching {
+        appjamtampDataSource.getAppjamtampMissionRanking(size = size).toDomain()
+    }
+
+    override suspend fun getAppjamtampMissionTop3(
+        size: Int
+    ): Result<List<AppjamtampRecentMission>> = suspendRunCatching {
+        appjamtampDataSource.getAppjamtampMissionTop3(size = size).toDomain()
+    }
+}

data/appjamtamp/src/main/java/org/sopt/official/data/appjamtamp/service/AppjamtampService.kt

@@ -0,0 +1,27 @@
+package org.sopt.official.data.appjamtamp.service
+
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop3RecentMissionResponse
+import org.sopt.official.data.appjamtamp.dto.response.AppjamtampTop10MissionScoreResponse
+import retrofit2.http.GET
+import retrofit2.http.Query
+
+interface AppjamtampService {
+
+    // 자신의 앱잼 정보 조회
+    // /user/appjam-info
+
+    // 앱잼팀 오늘의 득점 랭킹 TOP10 조회하기
+    @GET("appjamrank/today")
+    suspend fun getAppjamtampMissionRanking(
+        @Query("size") size: Int? = 10
+    ): AppjamtampTop10MissionScoreResponse
+
+    // 앱잼팀 랭킹 최근 인증한 미션 TOP3 조회하기
+    @GET("appjamrank/recent")
+    suspend fun getAppjamtampMissionTop3(
+        @Query("size") size: Int? = 3
+    ): AppjamtampTop3RecentMissionResponse
+
+    // 앱잼탬프 미션 목록 조회하기
+    // /appjamtamp/mission?teamNumber={teamNumber}&isCompleted=true
+}

domain/appjamtamp/src/main/java/org/sopt/official/domain/appjamtamp/entity/AppjamtampMissionScore.kt

@@ -0,0 +1,8 @@
+package org.sopt.official.domain.appjamtamp.entity
+
+data class AppjamtampMissionScore(
+    val rank: Int,
+    val teamName: String,
+    val todayPoints: Int,
+    val totalPoints: Int
+)

domain/appjamtamp/src/main/java/org/sopt/official/domain/appjamtamp/entity/AppjamtampRecentMission.kt

@@ -0,0 +1,13 @@
+package org.sopt.official.domain.appjamtamp.entity
+
+data class AppjamtampRecentMission(
+    val stampId: Long,
+    val missionId: Long,
+    val userId: Long,
+    val imageUrl: String,
+    val createdAt: String?,
+    val userName: String,
+    val userProfileImage: String?,
+    val teamName: String,
+    val teamNumber: String
+)

domain/appjamtamp/src/main/java/org/sopt/official/domain/appjamtamp/repository/AppjamtampRepository.kt

@@ -0,0 +1,13 @@
+package org.sopt.official.domain.appjamtamp.repository
+
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionScore
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampRecentMission
+
+interface AppjamtampRepository {
+    suspend fun getAppjamtampMissionRanking(
+        size: Int
+    ): Result<List<AppjamtampMissionScore>>
+    suspend fun getAppjamtampMissionTop3(
+        size: Int
+    ): Result<List<AppjamtampRecentMission>>
+}