[feat] #77 포즈 API 연동 및 랜덤 포즈 추천 구현

core/data-api/src/main/java/com/neki/android/core/dataapi/repository/PoseRepository.kt

@@ -13,6 +13,10 @@ interface PoseRepository {
         sortOrder: SortOrder = SortOrder.DESC,
     ): Flow<PagingData<Pose>>
 
+    fun getScrappedPosesFlow(
+        sortOrder: SortOrder = SortOrder.DESC,
+    ): Flow<PagingData<Pose>>
+
     suspend fun getPose(poseId: Long): Result<Pose>
 
     suspend fun getRandomPose(headCount: PeopleCount): Result<Pose>

core/data/src/main/java/com/neki/android/core/data/paging/ScrapPosePagingSource.kt

@@ -0,0 +1,40 @@
+package com.neki.android.core.data.paging
+
+import androidx.paging.PagingSource
+import androidx.paging.PagingState
+import com.neki.android.core.data.remote.api.PoseService
+import com.neki.android.core.model.Pose
+import com.neki.android.core.model.SortOrder
+
+class ScrapPosePagingSource(
+    private val poseService: PoseService,
+    private val sortOrder: SortOrder,
+) : PagingSource<Int, Pose>() {
+
+    override suspend fun load(params: LoadParams<Int>): LoadResult<Int, Pose> {
+        return try {
+            val page = params.key ?: 0
+            val response = poseService.getScrappedPoses(
+                page = page,
+                size = params.loadSize,
+                sortOrder = sortOrder.name,
+            )
+            val poses = response.data.toModels()
+
+            LoadResult.Page(
+                data = poses,
+                prevKey = if (page == 0) null else page - 1,
+                nextKey = if (poses.isEmpty()) null else page + 1,
+            )
+        } catch (e: Exception) {
+            LoadResult.Error(e)
+        }
+    }
+
+    override fun getRefreshKey(state: PagingState<Int, Pose>): Int? {
+        return state.anchorPosition?.let { anchorPosition ->
+            state.closestPageToPosition(anchorPosition)?.prevKey?.plus(1)
+                ?: state.closestPageToPosition(anchorPosition)?.nextKey?.minus(1)
+        }
+    }
+}

core/data/src/main/java/com/neki/android/core/data/remote/api/PoseService.kt

@@ -5,6 +5,7 @@ import com.neki.android.core.data.remote.model.response.BasicNullableResponse
 import com.neki.android.core.data.remote.model.response.BasicResponse
 import com.neki.android.core.data.remote.model.response.PoseDetailResponse
 import com.neki.android.core.data.remote.model.response.PoseResponse
+import com.neki.android.core.data.remote.model.response.ScrappedPoseResponse
 import io.ktor.client.HttpClient
 import io.ktor.client.call.body
 import io.ktor.client.request.get
@@ -43,6 +44,19 @@ class PoseService @Inject constructor(
         }.body()
     }
 
+    // 스크랩된 포즈 목록 조회
+    suspend fun getScrappedPoses(
+        page: Int = 0,
+        size: Int = 20,
+        sortOrder: String = "DESC",
+    ): BasicResponse<ScrappedPoseResponse> {
+        return client.get("/api/poses/scrap") {
+            parameter("page", page)
+            parameter("size", size)
+            parameter("sortOrder", sortOrder)
+        }.body()
+    }
+
     // 스크랩 업데이트
     suspend fun updateScrap(poseId: Long, scrap: Boolean): BasicNullableResponse<Unit> {
         return client.patch("/api/poses/$poseId/scrap") {

core/data/src/main/java/com/neki/android/core/data/remote/model/response/PoseResponse.kt

@@ -22,6 +22,31 @@ data class PoseResponse(
             id = poseId,
             poseImageUrl = imageUrl,
             peopleCount = PeopleCount.entries.find { it.name == headCount }?.value ?: 1,
+            isScrapped = false,
+        )
+    }
+
+    fun toModels() = items.map { it.toModel() }
+}
+
+@Serializable
+data class ScrappedPoseResponse(
+    @SerialName("hasNext") val hasNext: Boolean,
+    @SerialName("items") val items: List<Item>,
+) {
+    @Serializable
+    data class Item(
+        @SerialName("poseId") val poseId: Long,
+        @SerialName("headCount") val headCount: String,
+        @SerialName("imageUrl") val imageUrl: String,
+        @SerialName("contentType") val contentType: String,
+        @SerialName("createdAt") val createdAt: String,
+    ) {
+        internal fun toModel() = Pose(
+            id = poseId,
+            poseImageUrl = imageUrl,
+            peopleCount = PeopleCount.entries.find { it.name == headCount }?.value ?: 1,
+            isScrapped = true,
         )
     }
 

core/data/src/main/java/com/neki/android/core/data/repository/impl/PoseRepositoryImpl.kt

@@ -4,6 +4,7 @@ import androidx.paging.Pager
 import androidx.paging.PagingConfig
 import androidx.paging.PagingData
 import com.neki.android.core.data.paging.PosePagingSource
+import com.neki.android.core.data.paging.ScrapPosePagingSource
 import com.neki.android.core.data.remote.api.PoseService
 import com.neki.android.core.data.util.runSuspendCatching
 import com.neki.android.core.dataapi.repository.PoseRepository
@@ -41,6 +42,25 @@ class PoseRepositoryImpl @Inject constructor(
         ).flow
     }
 
+    override fun getScrappedPosesFlow(
+        sortOrder: SortOrder,
+    ): Flow<PagingData<Pose>> {
+        return Pager(
+            config = PagingConfig(
+                pageSize = PAGE_SIZE,
+                initialLoadSize = PAGE_SIZE,
+                prefetchDistance = PREFETCH_DISTANCE,
+                enablePlaceholders = false,
+            ),
+            pagingSourceFactory = {
+                ScrapPosePagingSource(
+                    poseService = poseService,
+                    sortOrder = sortOrder,
+                )
+            },
+        ).flow
+    }
+
     override suspend fun getPose(poseId: Long): Result<Pose> = runSuspendCatching {
         poseService.getPose(poseId).data.toModel()
     }

core/designsystem/src/main/java/com/neki/android/core/designsystem/modifier/Background.kt

@@ -4,6 +4,7 @@ import androidx.compose.foundation.background
 import androidx.compose.foundation.shape.RoundedCornerShape
 import androidx.compose.runtime.Composable
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.alpha
 import androidx.compose.ui.geometry.Offset
 import androidx.compose.ui.graphics.Brush
 import androidx.compose.ui.graphics.Color
@@ -35,6 +36,22 @@ fun Modifier.photoBackground(
     shape = shape,
 )
 
+/**
+ * 포즈 컴포넌트에 적용되는 그라데이션 배경
+ * 상단에서 134/242 지점까지 어두워지는 효과
+ */
+fun Modifier.poseBackground(
+    shape: Shape = RoundedCornerShape(12.dp),
+): Modifier = this.background(
+    brush = Brush.verticalGradient(
+        colorStops = arrayOf(
+            0f to Color.Black.copy(alpha = 0.2f),
+            134f / 242f to Color.Black.copy(alpha = 0f),
+        ),
+    ),
+    shape = shape,
+)
+
 /**
  * 블러 효과가 적용된 배경을 설정하는 Modifier 확장 함수
  *

core/model/src/main/java/com/neki/android/core/model/PeopleCount.kt

@@ -8,7 +8,6 @@ enum class PeopleCount(val displayText: String, val value: Int) {
     TWO("2인", 2),
     THREE("3인", 3),
     FOUR("4인", 4),
-    FIVE_OR_MORE("5인 이상", 5),
     ;
 
     override fun toString(): String = displayText

feature/archive/impl/src/main/kotlin/com/neki/android/feature/archive/impl/photo/AllPhotoScreen.kt

@@ -121,7 +121,11 @@ internal fun AllPhotoScreen(
         }
     }
 
-    val isRefreshing by remember { derivedStateOf { pagingItems.loadState.refresh is LoadState.Loading } }
+    val isRefreshing by remember {
+        derivedStateOf {
+            pagingItems.loadState.refresh is LoadState.Loading && pagingItems.itemCount == 0
+        }
+    }
 
     BackHandler(enabled = true) {
         onIntent(AllPhotoIntent.OnBackPressed)

feature/pose/api/src/main/java/com/neki/android/feature/pose/api/PoseResult.kt

@@ -0,0 +1,5 @@
+package com.neki.android.feature.pose.api
+
+sealed interface PoseResult {
+    data class ScrapChanged(val poseId: Long, val isScrapped: Boolean) : PoseResult
+}

feature/pose/impl/src/main/java/com/neki/android/feature/pose/impl/const/PoseConst.kt

@@ -1,6 +1,10 @@
 package com.neki.android.feature.pose.impl.const
 
 internal object PoseConst {
+    internal const val INITIAL_POSE_LOAD_COUNT = 4
+    internal const val POSE_PREFETCH_THRESHOLD = 3
+    internal const val MAXIMUM_RANDOM_POSE_FALLBACK_COUNT = 7
+
     internal const val POSE_LAYOUT_DEFAULT_TOP_PADDING = 12
     internal const val POSE_LAYOUT_BOTTOM_PADDING = 28
     internal const val POSE_LAYOUT_VERTICAL_SPACING = 12

feature/pose/impl/src/main/java/com/neki/android/feature/pose/impl/detail/PoseDetailContract.kt

@@ -19,4 +19,5 @@ sealed interface PoseDetailIntent {
 sealed interface PoseDetailSideEffect {
     data object NavigateBack : PoseDetailSideEffect
     data class ShowToast(val message: String) : PoseDetailSideEffect
+    data class NotifyScrapChanged(val poseId: Long, val isScrapped: Boolean) : PoseDetailSideEffect
 }

feature/pose/impl/src/main/java/com/neki/android/feature/pose/impl/detail/PoseDetailScreen.kt

@@ -23,8 +23,10 @@ import com.neki.android.core.designsystem.button.NekiIconButton
 import com.neki.android.core.designsystem.topbar.BackTitleTopBar
 import com.neki.android.core.designsystem.ui.theme.NekiTheme
 import com.neki.android.core.model.Pose
+import com.neki.android.core.navigation.result.LocalResultEventBus
 import com.neki.android.core.ui.compose.collectWithLifecycle
 import com.neki.android.core.ui.toast.NekiToast
+import com.neki.android.feature.pose.api.PoseResult
 import com.neki.android.feature.pose.impl.R
 
 @Composable
@@ -35,13 +37,20 @@ internal fun PoseDetailRoute(
     val uiState by viewModel.store.uiState.collectAsStateWithLifecycle()
     val context = LocalContext.current
     val nekiToast = remember { NekiToast(context) }
+    val resultEventBus = LocalResultEventBus.current
 
     viewModel.store.sideEffects.collectWithLifecycle { sideEffect ->
         when (sideEffect) {
             PoseDetailSideEffect.NavigateBack -> navigateBack()
             is PoseDetailSideEffect.ShowToast -> {
                 nekiToast.showToast(sideEffect.message)
             }
+            is PoseDetailSideEffect.NotifyScrapChanged -> {
+                resultEventBus.sendResult(
+                    result = PoseResult.ScrapChanged(sideEffect.poseId, sideEffect.isScrapped),
+                    allowDuplicate = false,
+                )
+            }
         }
     }
 
@@ -85,7 +94,7 @@ internal fun PoseDetailScreen(
         ) {
             Icon(
                 imageVector = ImageVector.vectorResource(
-                    if (uiState.pose.isScrapped) R.drawable.ic_scrap_selected
+                    if (uiState.pose.isScrapped) R.drawable.icon_scrap
                     else R.drawable.icon_scrap_unselected,
                 ),
                 contentDescription = null,

feature/pose/impl/src/main/java/com/neki/android/feature/pose/impl/detail/PoseDetailViewModel.kt

@@ -36,6 +36,7 @@ class PoseDetailViewModel @AssistedInject constructor(
         mviIntentStore(
             initialState = PoseDetailState(),
             onIntent = ::onIntent,
+            initialFetchData = { store.onIntent(PoseDetailIntent.EnterPoseDetailScreen) },
         )
 
     init {
@@ -69,7 +70,10 @@ class PoseDetailViewModel @AssistedInject constructor(
             PoseDetailIntent.EnterPoseDetailScreen -> fetchPoseData(reduce)
             PoseDetailIntent.ClickBackIcon -> postSideEffect(PoseDetailSideEffect.NavigateBack)
             PoseDetailIntent.ClickScrapIcon -> handleScrapToggle(state, reduce)
-            is PoseDetailIntent.ScrapCommitted -> reduce { copy(committedScrap = intent.newScrap) }
+            is PoseDetailIntent.ScrapCommitted -> {
+                reduce { copy(committedScrap = intent.newScrap) }
+                postSideEffect(PoseDetailSideEffect.NotifyScrapChanged(id, intent.newScrap))
+            }
             is PoseDetailIntent.RevertScrap -> reduce { copy(pose = pose.copy(isScrapped = intent.originalScrap)) }
         }
     }

feature/pose/impl/src/main/java/com/neki/android/feature/pose/impl/main/PoseContract.kt

@@ -27,6 +27,7 @@ sealed interface PoseIntent {
     data object ClickRandomPoseRecommendation : PoseIntent
     data class ClickRandomPosePeopleCountSheetItem(val peopleCount: PeopleCount) : PoseIntent
     data object ClickRandomPoseBottomSheetSelectButton : PoseIntent
+    data class ScrapChanged(val poseId: Long, val isScrapped: Boolean) : PoseIntent
 }
 
 sealed interface PoseEffect {

feature/pose/impl/src/main/java/com/neki/android/feature/pose/impl/main/PoseScreen.kt

@@ -21,6 +21,7 @@ import androidx.compose.ui.platform.LocalDensity
 import androidx.compose.ui.unit.dp
 import androidx.hilt.lifecycle.viewmodel.compose.hiltViewModel
 import androidx.lifecycle.compose.collectAsStateWithLifecycle
+import androidx.paging.LoadState
 import androidx.paging.compose.LazyPagingItems
 import androidx.paging.compose.collectAsLazyPagingItems
 import com.neki.android.core.model.PeopleCount
@@ -29,6 +30,7 @@ import com.neki.android.core.ui.compose.collectWithLifecycle
 import com.neki.android.feature.pose.impl.const.PoseConst.POSE_LAYOUT_DEFAULT_TOP_PADDING
 import com.neki.android.feature.pose.impl.main.component.FilterBar
 import com.neki.android.feature.pose.impl.main.component.PeopleCountBottomSheet
+import com.neki.android.core.ui.component.LoadingDialog
 import com.neki.android.feature.pose.impl.main.component.PoseListContent
 import com.neki.android.feature.pose.impl.main.component.PoseTopBar
 import com.neki.android.feature.pose.impl.main.component.RandomPosePeopleCountBottomSheet
@@ -67,6 +69,12 @@ fun PoseScreen(
     posePagingItems: LazyPagingItems<Pose>,
     onIntent: (PoseIntent) -> Unit = {},
 ) {
+    val isRefreshing by remember {
+        derivedStateOf {
+            posePagingItems.loadState.refresh is LoadState.Loading && posePagingItems.itemCount == 0
+        }
+    }
+
     Box(
         modifier = Modifier.fillMaxSize(),
     ) {
@@ -88,6 +96,10 @@ fun PoseScreen(
         )
     }
 
+    if (isRefreshing) {
+        LoadingDialog()
+    }
+
     if (uiState.isShowPeopleCountBottomSheet) {
         PeopleCountBottomSheet(
             selectedItem = uiState.selectedPeopleCount,
@@ -160,5 +172,3 @@ fun PoseContent(
         }
     }
 }
-
-// Preview is not available for PagingItems component