[FEAT/#77] 홈 뷰 / 맞춤 공고 서버 통신 구현

data/src/main/java/com/terning/data/datasource/HomeDataSource.kt

@@ -1,8 +1,15 @@
 package com.terning.data.datasource
 
 import com.terning.data.dto.BaseResponse
+import com.terning.data.dto.response.HomeRecommendInternResponseDto
 import com.terning.data.dto.response.HomeTodayInternResponseDto
 
 interface HomeDataSource {
     suspend fun getTodayIntern(): BaseResponse<List<HomeTodayInternResponseDto>>
+
+    suspend fun getRecommendIntern(
+        sortBy: String,
+        startYear: Int,
+        startMonth: Int
+    ): BaseResponse<List<HomeRecommendInternResponseDto>>
 }

data/src/main/java/com/terning/data/datasourceimpl/HomeDataSourceImpl.kt

@@ -2,6 +2,7 @@ package com.terning.data.datasourceimpl
 
 import com.terning.data.datasource.HomeDataSource
 import com.terning.data.dto.BaseResponse
+import com.terning.data.dto.response.HomeRecommendInternResponseDto
 import com.terning.data.dto.response.HomeTodayInternResponseDto
 import com.terning.data.service.HomeService
 import javax.inject.Inject
@@ -11,4 +12,15 @@ class HomeDataSourceImpl @Inject constructor(
 ) : HomeDataSource {
     override suspend fun getTodayIntern(): BaseResponse<List<HomeTodayInternResponseDto>> =
         homeService.getHomeTodayIntern()
+
+    override suspend fun getRecommendIntern(
+        sortBy: String,
+        startYear: Int,
+        startMonth: Int
+    ): BaseResponse<List<HomeRecommendInternResponseDto>> =
+        homeService.getRecommendIntern(
+            sortBy = sortBy,
+            startYear = startYear,
+            startMonth = startMonth
+        )
 }

data/src/main/java/com/terning/data/dto/response/HomeRecommendInternResponseDto.kt

@@ -0,0 +1,31 @@
+package com.terning.data.dto.response
+
+import com.terning.domain.entity.response.HomeRecommendInternModel
+import kotlinx.serialization.SerialName
+import kotlinx.serialization.Serializable
+
+@Serializable
+data class HomeRecommendInternResponseDto(
+    @SerialName("intershipAnnouncementId")
+    val internshipAnnouncementId: Long,
+    @SerialName("title")
+    val title: String,
+    @SerialName("dDay")
+    val dDay: String,
+    @SerialName("workingPeriod")
+    val workingPeriod: String,
+    @SerialName("companyImage")
+    val companyImage: String,
+    @SerialName("isScrapped")
+    val isScrapped: Boolean,
+) {
+    fun toRecommendInternEntity(): HomeRecommendInternModel =
+        HomeRecommendInternModel(
+            internshipAnnouncementId = this.internshipAnnouncementId,
+            title = this.title,
+            dDay = this.dDay,
+            workingPeriod = this.workingPeriod,
+            companyImage = this.companyImage,
+            isScrapped = this.isScrapped,
+        )
+}

data/src/main/java/com/terning/data/repositoryimpl/HomeRepositoryImpl.kt

@@ -1,6 +1,7 @@
 package com.terning.data.repositoryimpl
 
 import com.terning.data.datasource.HomeDataSource
+import com.terning.domain.entity.response.HomeRecommendInternModel
 import com.terning.domain.entity.response.HomeTodayInternModel
 import com.terning.domain.repository.HomeRepository
 import javax.inject.Inject
@@ -14,4 +15,19 @@ class HomeRepositoryImpl @Inject constructor(
                 it.toHomeTodayInternList()
             }
         }
+
+    override suspend fun getRecommendIntern(
+        sortBy: String,
+        startYear: Int,
+        startMonth: Int
+    ): Result<List<HomeRecommendInternModel>> =
+        runCatching {
+            homeDataSource.getRecommendIntern(
+                sortBy = sortBy,
+                startYear = startYear,
+                startMonth = startMonth
+            ).result.map {
+                it.toRecommendInternEntity()
+            }
+        }
 }

data/src/main/java/com/terning/data/service/HomeService.kt

@@ -1,10 +1,19 @@
 package com.terning.data.service
 
 import com.terning.data.dto.BaseResponse
+import com.terning.data.dto.response.HomeRecommendInternResponseDto
 import com.terning.data.dto.response.HomeTodayInternResponseDto
 import retrofit2.http.GET
+import retrofit2.http.Query
 
 interface HomeService {
     @GET("api/v1/home/today")
     suspend fun getHomeTodayIntern(): BaseResponse<List<HomeTodayInternResponseDto>>
-}
+
+    @GET("api/v1/home")
+    suspend fun getRecommendIntern(
+        @Query("sortBy") sortBy: String,
+        @Query("startYear") startYear: Int,
+        @Query("startMonth") startMonth: Int,
+    ): BaseResponse<List<HomeRecommendInternResponseDto>>
+}

domain/src/main/java/com/terning/domain/entity/response/HomeRecommendInternModel.kt

@@ -0,0 +1,10 @@
+package com.terning.domain.entity.response
+
+data class HomeRecommendInternModel(
+    val internshipAnnouncementId: Long,
+    val title: String,
+    val dDay: String,
+    val workingPeriod: String,
+    val companyImage: String,
+    val isScrapped: Boolean,
+)

domain/src/main/java/com/terning/domain/repository/HomeRepository.kt

@@ -1,7 +1,14 @@
 package com.terning.domain.repository
 
+import com.terning.domain.entity.response.HomeRecommendInternModel
 import com.terning.domain.entity.response.HomeTodayInternModel
 
 interface HomeRepository {
     suspend fun getHomeTodayInternList(): Result<List<HomeTodayInternModel>>
+
+    suspend fun getRecommendIntern(
+        sortBy: String,
+        startYear: Int,
+        startMonth: Int
+    ): Result<List<HomeRecommendInternModel>>
 }

feature/src/main/java/com/terning/feature/home/changefilter/ChangeFilterRoute.kt

@@ -43,11 +43,11 @@ fun ChangeFilterScreen(
     viewModel: HomeViewModel = hiltViewModel(),
 ) {
     val isGradeButtonValid = remember {
-        mutableStateOf(viewModel.userName.internFilter?.grade != null)
+        mutableStateOf(viewModel.userName.value.internFilter?.grade != null)
     }
 
     val isWorkingPeriodButtonValid = remember {
-        mutableStateOf(viewModel.userName.internFilter?.workingPeriod != null)
+        mutableStateOf(viewModel.userName.value.internFilter?.workingPeriod != null)
     }
 
     Scaffold(
@@ -77,9 +77,8 @@ fun ChangeFilterScreen(
             )
             ChangeFilteringRadioGroup(
                 filterType = 0,
-                internFilterData = viewModel.userName.internFilter,
+                internFilterData = viewModel.userName.value.internFilter,
                 onButtonClick = {
-                    viewModel.setGrade(it)
                     isGradeButtonValid.value = true
                 }
             )
@@ -105,9 +104,8 @@ fun ChangeFilterScreen(
             )
             ChangeFilteringRadioGroup(
                 filterType = 1,
-                internFilterData = viewModel.userName.internFilter,
+                internFilterData = viewModel.userName.value.internFilter,
                 onButtonClick = {
-                    viewModel.setWorkingPeriod(it)
                     isWorkingPeriodButtonValid.value = true
                 }
             )

feature/src/main/java/com/terning/feature/home/home/HomeRoute.kt

@@ -3,6 +3,7 @@ package com.terning.feature.home.home
 import androidx.compose.foundation.ExperimentalFoundationApi
 import androidx.compose.foundation.background
 import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.Column
 import androidx.compose.foundation.layout.PaddingValues
 import androidx.compose.foundation.layout.Row
@@ -11,6 +12,7 @@ import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.padding
 import androidx.compose.foundation.lazy.LazyColumn
+import androidx.compose.foundation.shape.RoundedCornerShape
 import androidx.compose.material3.HorizontalDivider
 import androidx.compose.material3.Scaffold
 import androidx.compose.material3.Text
@@ -33,18 +35,23 @@ import androidx.lifecycle.flowWithLifecycle
 import androidx.navigation.NavHostController
 import com.terning.core.designsystem.component.bottomsheet.SortingBottomSheet
 import com.terning.core.designsystem.component.button.SortingButton
+import com.terning.core.designsystem.component.item.InternItem
 import com.terning.core.designsystem.component.topappbar.LogoTopAppBar
 import com.terning.core.designsystem.theme.Black
 import com.terning.core.designsystem.theme.Grey150
+import com.terning.core.designsystem.theme.Grey200
 import com.terning.core.designsystem.theme.TerningTheme
 import com.terning.core.designsystem.theme.White
+import com.terning.core.extension.customShadow
 import com.terning.core.extension.toast
 import com.terning.core.state.UiState
+import com.terning.domain.entity.response.HomeRecommendInternModel
 import com.terning.domain.entity.response.HomeTodayInternModel
 import com.terning.feature.R
 import com.terning.feature.home.changefilter.navigation.navigateChangeFilter
 import com.terning.feature.home.home.component.HomeFilteringEmptyIntern
 import com.terning.feature.home.home.component.HomeFilteringScreen
+import com.terning.feature.home.home.component.HomeRecommendEmptyIntern
 import com.terning.feature.home.home.component.HomeTodayEmptyIntern
 import com.terning.feature.home.home.component.HomeTodayIntern
 import com.terning.feature.home.home.model.UserNameState
@@ -55,7 +62,7 @@ const val NAME_END_LENGTH = 12
 @Composable
 fun HomeRoute(
     navController: NavHostController,
-    viewModel: HomeViewModel = hiltViewModel()
+    viewModel: HomeViewModel = hiltViewModel(),
 ) {
     val currentSortBy: MutableState<Int> = remember {
         mutableIntStateOf(0)
@@ -65,6 +72,7 @@ fun HomeRoute(
     val context = LocalContext.current
 
     val homeTodayState by viewModel.homeTodayState.collectAsStateWithLifecycle()
+    val homeRecommendInternState by viewModel.homeRecommendInternState.collectAsStateWithLifecycle()
 
     LaunchedEffect(viewModel.homeSideEffect, lifecycleOwner) {
         viewModel.homeSideEffect.flowWithLifecycle(lifecycle = lifecycleOwner.lifecycle)
@@ -84,10 +92,31 @@ fun HomeRoute(
         else -> emptyList()
     }
 
+    val homeRecommendInternList = when (homeRecommendInternState) {
+        is UiState.Success -> {
+            (homeRecommendInternState as UiState.Success<List<HomeRecommendInternModel>>).data
+        }
+
+        else -> emptyList()
+    }
+
+    val userNameState = viewModel.userName
+
+    LaunchedEffect(currentSortBy) {
+        with(userNameState.value.internFilter) {
+            viewModel.getRecommendInternsData(
+                sortBy = currentSortBy.value,
+                startYear = this?.startYear ?: viewModel.currentYear,
+                startMonth = this?.startMonth ?: viewModel.currentMonth,
+            )
+        }
+    }
+
     HomeScreen(
         currentSortBy,
-        homeTodayInternList,
-        onChangeFilterClick = { navController.navigateChangeFilter() }
+        homeTodayInternList = homeTodayInternList,
+        recommendInternList = homeRecommendInternList,
+        onChangeFilterClick = { navController.navigateChangeFilter() },
     )
 }
 
@@ -96,6 +125,7 @@ fun HomeRoute(
 fun HomeScreen(
     currentSortBy: MutableState<Int>,
     homeTodayInternList: List<HomeTodayInternModel>,
+    recommendInternList: List<HomeRecommendInternModel>,
     onChangeFilterClick: () -> Unit,
     viewModel: HomeViewModel = hiltViewModel(),
 ) {
@@ -135,7 +165,7 @@ fun HomeScreen(
                         modifier = Modifier
                             .padding(bottom = 16.dp)
                     ) {
-                        ShowMainTitleWithName(userNameState)
+                        ShowMainTitleWithName(userNameState.value)
                         ShowTodayIntern(homeTodayInternList = homeTodayInternList)
                     }
                 }
@@ -145,7 +175,7 @@ fun HomeScreen(
                             .background(White)
                     ) {
                         ShowRecommendTitle()
-                        ShowInternFilter(userNameState = userNameState, onChangeFilterClick)
+                        ShowInternFilter(userNameState = userNameState.value, onChangeFilterClick)
 
                         HorizontalDivider(
                             thickness = 4.dp,
@@ -169,14 +199,22 @@ fun HomeScreen(
                         }
                     }
                 }
+
+                if (recommendInternList.isNotEmpty()) {
+                    items(recommendInternList.size) { index ->
+                        ShowRecommendIntern(homeRecommendInternModel = recommendInternList[index])
+                    }
+                }
             }
 
-            if (userNameState.internFilter == null) {
+            if (userNameState.value.internFilter == null) {
                 HomeFilteringEmptyIntern(
                     modifier = Modifier
                         .padding(horizontal = 24.dp)
                         .fillMaxSize()
                 )
+            } else if (recommendInternList.isEmpty()) {
+                HomeRecommendEmptyIntern()
             }
         }
     }
@@ -255,4 +293,29 @@ private fun ShowInternFilter(userNameState: UserNameState, onChangeFilterClick:
             )
         }
     }
+}
+
+@Composable
+private fun ShowRecommendIntern(homeRecommendInternModel: HomeRecommendInternModel) {
+    Box(
+        modifier = Modifier
+            .padding(horizontal = 24.dp)
+            .customShadow(
+                color = Grey200,
+                shadowRadius = 5.dp,
+                shadowWidth = 1.dp
+            )
+            .background(
+                color = White,
+                shape = RoundedCornerShape(10.dp)
+            )
+    ) {
+        InternItem(
+            imageUrl = homeRecommendInternModel.companyImage,
+            title = homeRecommendInternModel.title,
+            dateDeadline = homeRecommendInternModel.dDay,
+            workingPeriod = homeRecommendInternModel.workingPeriod,
+            isScraped = homeRecommendInternModel.isScrapped,
+        )
+    }
 }