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

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

@@ -1,10 +1,14 @@
 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
 import org.sopt.official.data.appjamtamp.dto.AppjamtampMissionsResponseDto
 
 interface AppjamtampDataSource {
     suspend fun getAppjamtampMissions(
         teamNumber: String? = null,
         isCompleted: Boolean? = null
     ): AppjamtampMissionsResponseDto
+    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

@@ -1,6 +1,8 @@
 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.dto.AppjamtampMissionsResponseDto
 import org.sopt.official.data.appjamtamp.service.AppjamtampService
 import javax.inject.Inject
@@ -13,4 +15,10 @@ internal class AppjamtampDataSourceImpl @Inject constructor(
         isCompleted: Boolean?
     ): AppjamtampMissionsResponseDto =
         appjamtampService.getAppjamtampMissions(teamNumber, isCompleted)
-}
+
+    override suspend fun getAppjamtampMissionTop3(size: Int): AppjamtampTop3RecentMissionResponse =
+        appjamtampService.getAppjamtampMissionTop3(size = size)
+
+    override suspend fun getAppjamtampMissionRanking(size: Int): AppjamtampTop10MissionScoreResponse =
+        appjamtampService.getAppjamtampMissionRanking(size = size)
+}

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

@@ -16,5 +16,4 @@ internal abstract class RepositoryModule {
     abstract fun bindAppjamtampRepository(
         appjamtampRepositoryImpl: AppjamtampRepositoryImpl
     ): AppjamtampRepository
-
-}
+}

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

@@ -3,6 +3,7 @@ package org.sopt.official.data.appjamtamp.dto
 import kotlinx.serialization.SerialName
 import kotlinx.serialization.Serializable
 import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionEntity
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionListEntity
 
 @Serializable
 data class AppjamtampMissionsResponseDto(
@@ -12,7 +13,15 @@ data class AppjamtampMissionsResponseDto(
     val teamName: String,
     @SerialName("missions")
     val missions: List<AppjamtampMissionItemDto>
-)
+) {
+    fun toEntity(): AppjamtampMissionListEntity {
+        return AppjamtampMissionListEntity(
+            teamNumber = teamNumber,
+            teamName = teamName,
+            missions = missions.map { it.toEntity() }
+        )
+    }
+}
 
 @Serializable
 data class AppjamtampMissionItemDto(
@@ -21,11 +30,11 @@ data class AppjamtampMissionItemDto(
     @SerialName("title")
     val title: String,
     @SerialName("ownerName")
-    val ownerName: String,
+    val ownerName: String? = null,
     @SerialName("level")
     val level: Int,
     @SerialName("profileImage")
-    val profileImage: List<String>,
+    val profileImage: List<String>? = emptyList(),
     @SerialName("isCompleted")
     val isCompleted: Boolean
 ) {

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

@@ -2,7 +2,10 @@ 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.domain.appjamtamp.entity.AppjamtampMissionEntity
+import org.sopt.official.data.appjamtamp.mapper.toDomain
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionListEntity
+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
 
@@ -12,7 +15,19 @@ internal class AppjamtampRepositoryImpl @Inject constructor(
     override suspend fun getAppjamtampMissions(
         teamNumber: String?,
         isCompleted: Boolean?
-    ): Result<List<AppjamtampMissionEntity>> = suspendRunCatching {
-        appjamtampDataSource.getAppjamtampMissions(teamNumber, isCompleted).missions.map { it.toEntity() }
+    ): Result<AppjamtampMissionListEntity> = suspendRunCatching {
+        appjamtampDataSource.getAppjamtampMissions(teamNumber, isCompleted).toEntity()
     }
-}
+
+    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

@@ -1,6 +1,8 @@
 package org.sopt.official.data.appjamtamp.service
 
 import org.sopt.official.data.appjamtamp.dto.AppjamtampMissionsResponseDto
+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
 
@@ -10,4 +12,20 @@ interface AppjamtampService {
         @Query("teamNumber") teamNumber: String? = null,
         @Query("isCompleted") isCompleted : Boolean? = null
     ) : AppjamtampMissionsResponseDto
-}
+
+    /**
+     * 앱잼에 참여하는 전체 팀의 득점 랭킹 조회
+     * - 서버 명세에서 API명: 앱잼팀 득점 랭킹 TOP10 조회
+     * - 실제로는 모든 팀의 순위를 조회 해야함. 전체 팀 수(예: 12팀)를 [size]에 전달해야 함
+     * * @param size 조회할 팀의 수 (기본값 10)
+     */
+    @GET("appjamrank/today")
+    suspend fun getAppjamtampMissionRanking(
+        @Query("size") size: Int? = 10
+    ): AppjamtampTop10MissionScoreResponse
+
+    @GET("appjamrank/recent")
+    suspend fun getAppjamtampMissionTop3(
+        @Query("size") size: Int? = 3
+    ): AppjamtampTop3RecentMissionResponse
+}

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

@@ -3,8 +3,8 @@ package org.sopt.official.domain.appjamtamp.entity
 data class AppjamtampMissionEntity(
     val id: Int,
     val title: String,
-    val ownerName: String,
+    val ownerName: String?,
     val level: Int,
-    val profileImage: List<String>,
+    val profileImage: List<String>?,
     val isCompleted: Boolean,
 )

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

@@ -0,0 +1,7 @@
+package org.sopt.official.domain.appjamtamp.entity
+
+data class AppjamtampMissionListEntity(
+    val teamNumber: String,
+    val teamName: String,
+    val missions: List<AppjamtampMissionEntity>
+)

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

@@ -1,10 +1,18 @@
 package org.sopt.official.domain.appjamtamp.repository
 
-import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionEntity
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionListEntity
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampMissionScore
+import org.sopt.official.domain.appjamtamp.entity.AppjamtampRecentMission
 
 interface AppjamtampRepository {
     suspend fun getAppjamtampMissions(
         teamNumber: String? = null,
         isCompleted: Boolean? = null
-    ): Result<List<AppjamtampMissionEntity>>
-}
+    ): Result<AppjamtampMissionListEntity>
+    suspend fun getAppjamtampMissionRanking(
+        size: Int
+    ): Result<List<AppjamtampMissionScore>>
+    suspend fun getAppjamtampMissionTop3(
+        size: Int
+    ): Result<List<AppjamtampRecentMission>>
+}