[Woo POS][Local Catalog] Catalog full sync required

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/woopos/home/WooPosHomeScreen.kt

@@ -116,6 +116,7 @@ private fun WooPosHomeScreen(
         cartWidthDp = cartWidthDp,
         totalsWidthDp = totalsWidthAnimatedDp,
         onHomeUIEvent = onHomeUIEvent,
+        onRetryCatalogSyncClicked = { onHomeUIEvent(WooPosHomeUIEvent.RetryCatalogSyncClicked) },
     )
 }
 
@@ -127,6 +128,7 @@ private fun WooPosHomeScreen(
     cartWidthDp: Dp,
     totalsWidthDp: Dp,
     onHomeUIEvent: (WooPosHomeUIEvent) -> Unit,
+    onRetryCatalogSyncClicked: () -> Unit = {},
 ) {
     Box(
         modifier = Modifier
@@ -149,7 +151,9 @@ private fun WooPosHomeScreen(
         ) {
             WooPosHomeScreenProducts(
                 modifier = Modifier
-                    .width(productsWidthDp)
+                    .width(productsWidthDp),
+                catalogSyncState = state.catalogSyncState,
+                onRetryCatalogSyncClicked = onRetryCatalogSyncClicked
             )
             WooPosHomeScreenCart(
                 modifier = Modifier
@@ -195,11 +199,19 @@ private fun Dialogs(
 }
 
 @Composable
-private fun WooPosHomeScreenProducts(modifier: Modifier) {
+private fun WooPosHomeScreenProducts(
+    modifier: Modifier,
+    catalogSyncState: WooPosHomeState.CatalogSyncState = WooPosHomeState.CatalogSyncState.Idle,
+    onRetryCatalogSyncClicked: () -> Unit = {}
+) {
     if (isPreviewMode()) {
         WooPosItemsScreenPreview(modifier)
     } else {
-        WooPosItemsScreen(modifier = modifier)
+        WooPosItemsScreen(
+            modifier = modifier,
+            catalogSyncState = catalogSyncState,
+            onRetryCatalogSyncClicked = onRetryCatalogSyncClicked
+        )
     }
 }
 

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/woopos/home/WooPosHomeState.kt

@@ -9,6 +9,7 @@ import kotlinx.parcelize.Parcelize
 data class WooPosHomeState(
     val screenPositionState: ScreenPositionState,
     val dialogState: DialogState = DialogState.Hidden,
+    val catalogSyncState: CatalogSyncState = CatalogSyncState.Idle,
 ) : Parcelable {
     @Parcelize
     sealed class ScreenPositionState : Parcelable {
@@ -45,4 +46,19 @@ data class WooPosHomeState(
             val confirmButton: Int = R.string.woopos_exit_dialog_confirmation_confirm_button
         }
     }
+
+    @Parcelize
+    sealed class CatalogSyncState : Parcelable {
+        @Parcelize
+        data object Idle : CatalogSyncState()
+
+        @Parcelize
+        data object Syncing : CatalogSyncState()
+
+        @Parcelize
+        data object Success : CatalogSyncState()
+
+        @Parcelize
+        data class Failed(val error: String) : CatalogSyncState()
+    }
 }

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/woopos/home/WooPosHomeUIEvent.kt

@@ -8,6 +8,7 @@ sealed class WooPosHomeUIEvent {
     data object DismissScanningSetupDialog : WooPosHomeUIEvent()
     data object OnPaymentCompletedViaCash : WooPosHomeUIEvent()
     data object ExitPosClicked : WooPosHomeUIEvent()
+    data object RetryCatalogSyncClicked : WooPosHomeUIEvent()
     data class OnBarcodeEvent(
         val result: BarcodeInputDetector.BarcodeResult
     ) : WooPosHomeUIEvent()

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/woopos/home/WooPosHomeViewModel.kt

@@ -14,6 +14,12 @@ import com.woocommerce.android.ui.woopos.home.ParentToChildrenEvent.SearchEvent.
 import com.woocommerce.android.ui.woopos.home.ParentToChildrenEvent.SearchEvent.RecentSearchSelected
 import com.woocommerce.android.ui.woopos.home.WooPosHomeState.DialogState
 import com.woocommerce.android.ui.woopos.home.WooPosHomeState.ScreenPositionState
+import com.woocommerce.android.ui.woopos.localcatalog.WooPosFullSyncRequirement
+import com.woocommerce.android.ui.woopos.localcatalog.WooPosFullSyncState
+import com.woocommerce.android.ui.woopos.localcatalog.WooPosFullSyncStatusChecker
+import com.woocommerce.android.ui.woopos.localcatalog.WooPosIncrementalSyncReason
+import com.woocommerce.android.ui.woopos.localcatalog.WooPosPerformInstantCatalogFullSync
+import com.woocommerce.android.ui.woopos.localcatalog.WooPosPerformLocalCatalogIncrementalSync
 import com.woocommerce.android.ui.woopos.util.analytics.WooPosAnalyticsEvent
 import com.woocommerce.android.ui.woopos.util.analytics.WooPosAnalyticsEvent.Event.BackToCartTapped
 import com.woocommerce.android.ui.woopos.util.analytics.WooPosAnalyticsTracker
@@ -31,6 +37,9 @@ class WooPosHomeViewModel @Inject constructor(
     private val parentToChildrenEventSender: WooPosParentToChildrenEventSender,
     private val analyticsTracker: WooPosAnalyticsTracker,
     private val soundHelper: WooPosSoundHelper,
+    private val syncStatusChecker: WooPosFullSyncStatusChecker,
+    private val performInitialFullSync: WooPosPerformInstantCatalogFullSync,
+    private val incrementalSync: WooPosPerformLocalCatalogIncrementalSync,
     savedStateHandle: SavedStateHandle,
 ) : ViewModel() {
     private val _state = savedStateHandle.getStateFlow(
@@ -54,6 +63,49 @@ class WooPosHomeViewModel @Inject constructor(
         viewModelScope.launch {
             soundHelper.preloadChaChing()
         }
+        startCatalogSyncIfNeeded()
+    }
+
+    private fun startCatalogSyncIfNeeded() {
+        viewModelScope.launch {
+            val requirement = syncStatusChecker.checkSyncRequirement()
+
+            when (requirement) {
+                is WooPosFullSyncRequirement.NotRequired,
+                is WooPosFullSyncRequirement.Overdue -> {
+                    _state.value = _state.value.copy(
+                        catalogSyncState = WooPosHomeState.CatalogSyncState.Idle
+                    )
+                    incrementalSync.execute(WooPosIncrementalSyncReason.ON_POS_HOME)
+                }
+                is WooPosFullSyncRequirement.BlockingRequired -> {
+                    performInitialFullSync().collect { syncStatus ->
+                        when (syncStatus) {
+                            is WooPosFullSyncState.InProgress -> {
+                                _state.value = _state.value.copy(
+                                    catalogSyncState = WooPosHomeState.CatalogSyncState.Syncing
+                                )
+                            }
+                            is WooPosFullSyncState.Success -> {
+                                _state.value = _state.value.copy(
+                                    catalogSyncState = WooPosHomeState.CatalogSyncState.Success
+                                )
+                            }
+                            is WooPosFullSyncState.Failed -> {
+                                _state.value = _state.value.copy(
+                                    catalogSyncState = WooPosHomeState.CatalogSyncState.Failed(syncStatus.error)
+                                )
+                            }
+                        }
+                    }
+                }
+                is WooPosFullSyncRequirement.Error -> {
+                    _state.value = _state.value.copy(
+                        catalogSyncState = WooPosHomeState.CatalogSyncState.Failed(requirement.message)
+                    )
+                }
+            }
+        }
     }
 
     override fun onCleared() {
@@ -88,6 +140,10 @@ class WooPosHomeViewModel @Inject constructor(
                 }
             }
 
+            WooPosHomeUIEvent.RetryCatalogSyncClicked -> {
+                startCatalogSyncIfNeeded()
+            }
+
             is WooPosHomeUIEvent.OnBarcodeEvent -> {
                 sendEventToChildren(ParentToChildrenEvent.BarcodeEvent(event.result))
             }

WooCommerce/src/main/kotlin/com/woocommerce/android/ui/woopos/home/items/WooPosItemsScreen.kt

@@ -3,26 +3,42 @@ package com.woocommerce.android.ui.woopos.home.items
 import androidx.compose.animation.Crossfade
 import androidx.compose.animation.core.LinearEasing
 import androidx.compose.animation.core.tween
+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.Spacer
 import androidx.compose.foundation.layout.fillMaxHeight
 import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.layout.size
 import androidx.compose.foundation.layout.statusBarsPadding
 import androidx.compose.foundation.lazy.LazyListState
 import androidx.compose.foundation.lazy.rememberLazyListState
 import androidx.compose.material.ExperimentalMaterialApi
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.State
 import androidx.compose.runtime.collectAsState
+import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.text.style.TextAlign
+import androidx.compose.ui.unit.dp
 import androidx.hilt.lifecycle.viewmodel.compose.hiltViewModel
+import com.woocommerce.android.R
 import com.woocommerce.android.ui.woopos.common.composeui.WooPosPreview
+import com.woocommerce.android.ui.woopos.common.composeui.component.Button
+import com.woocommerce.android.ui.woopos.common.composeui.component.WooPosCircularLoadingIndicator
+import com.woocommerce.android.ui.woopos.common.composeui.component.WooPosErrorScreen
 import com.woocommerce.android.ui.woopos.common.composeui.component.WooPosSearchInputState
 import com.woocommerce.android.ui.woopos.common.composeui.component.WooPosSearchUIEvent
 import com.woocommerce.android.ui.woopos.common.composeui.designsystem.WooPosSpacing
 import com.woocommerce.android.ui.woopos.common.composeui.designsystem.WooPosTheme
 import com.woocommerce.android.ui.woopos.common.composeui.designsystem.toAdaptivePadding
+import com.woocommerce.android.ui.woopos.home.WooPosHomeState.CatalogSyncState
 import com.woocommerce.android.ui.woopos.home.items.WooPosItemsToolbarViewState.Tab.Coupons
 import com.woocommerce.android.ui.woopos.home.items.WooPosItemsToolbarViewState.Tab.HighlightLevel
 import com.woocommerce.android.ui.woopos.home.items.WooPosItemsToolbarViewState.Tab.Products
@@ -38,7 +54,11 @@ import kotlinx.coroutines.flow.StateFlow
 
 @OptIn(ExperimentalMaterialApi::class)
 @Composable
-fun WooPosItemsScreen(modifier: Modifier = Modifier) {
+fun WooPosItemsScreen(
+    modifier: Modifier = Modifier,
+    catalogSyncState: CatalogSyncState = CatalogSyncState.Idle,
+    onRetryCatalogSyncClicked: () -> Unit = {}
+) {
     val productsViewState = rememberLazyListState()
     val couponsListState = rememberLazyListState()
     val productsViewModel: WooPosItemsViewModel = hiltViewModel()
@@ -47,6 +67,8 @@ fun WooPosItemsScreen(modifier: Modifier = Modifier) {
         itemsStateFlow = productsViewModel.viewState,
         productsViewState = productsViewState,
         couponsListState = couponsListState,
+        catalogSyncState = catalogSyncState,
+        onRetryCatalogSync = onRetryCatalogSyncClicked,
         onUIEvent = { productsViewModel.onUIEvent(it) },
     )
 }
@@ -58,6 +80,8 @@ private fun WooPosItemsScreen(
     itemsStateFlow: StateFlow<WooPosItemsToolbarViewState>,
     productsViewState: LazyListState,
     couponsListState: LazyListState,
+    catalogSyncState: CatalogSyncState,
+    onRetryCatalogSync: () -> Unit,
     onUIEvent: (WooPosItemsUIEvent) -> Unit,
 ) {
     val state = itemsStateFlow.collectAsState()
@@ -67,6 +91,8 @@ private fun WooPosItemsScreen(
         state = state,
         productsViewState = productsViewState,
         couponsListState = couponsListState,
+        catalogSyncState = catalogSyncState,
+        onRetryCatalogSync = onRetryCatalogSync,
         onSearchEvent = {
             when (it) {
                 WooPosSearchUIEvent.Clear -> onUIEvent(WooPosItemsUIEvent.ClearSearchClicked)
@@ -96,10 +122,12 @@ private fun MainItemsList(
     state: State<WooPosItemsToolbarViewState>,
     productsViewState: LazyListState,
     couponsListState: LazyListState,
+    catalogSyncState: CatalogSyncState,
     onSearchEvent: (WooPosSearchUIEvent) -> Unit,
     onTabClicked: (WooPosItemsToolbarViewState.Tab) -> Unit,
     onAddCouponEvent: () -> Unit,
     onBackClicked: () -> Unit,
+    onRetryCatalogSync: () -> Unit = {},
 ) {
     Box(
         modifier = modifier
@@ -159,6 +187,15 @@ private fun MainItemsList(
                 }
             }
         }
+
+        if (catalogSyncState is CatalogSyncState.Syncing ||
+            catalogSyncState is CatalogSyncState.Failed
+        ) {
+            CatalogSyncOverlay(
+                catalogSyncState = catalogSyncState,
+                onRetryClicked = onRetryCatalogSync
+            )
+        }
     }
 }
 
@@ -201,6 +238,61 @@ private fun getScreenState(state: WooPosItemsToolbarViewState): ScreenState {
     }
 }
 
+@Composable
+private fun CatalogSyncOverlay(
+    catalogSyncState: CatalogSyncState,
+    onRetryClicked: () -> Unit = {}
+) {
+    Box(
+        modifier = Modifier
+            .fillMaxSize()
+            .background(MaterialTheme.colorScheme.surface.copy(alpha = 0.95f)),
+        contentAlignment = Alignment.Center
+    ) {
+        when (catalogSyncState) {
+            is CatalogSyncState.Syncing -> {
+                SyncingCatalogContent()
+            }
+            is CatalogSyncState.Failed -> {
+                SyncFailedContent(onRetryClicked = onRetryClicked)
+            }
+            else -> {
+                // Should not happen, but handle gracefully
+            }
+        }
+    }
+}
+
+@Suppress("WooPosDesignSystemSpacingUsageRule", "WooPosDesignSystemTextUsageRule")
+@Composable
+private fun SyncingCatalogContent() {
+    Column(
+        horizontalAlignment = Alignment.CenterHorizontally,
+        verticalArrangement = Arrangement.Center
+    ) {
+        WooPosCircularLoadingIndicator(modifier = Modifier.size(160.dp))
+        Spacer(modifier = Modifier.height(32.dp))
+        Text(
+            text = stringResource(R.string.woopos_home_syncing_catalog_title),
+            style = MaterialTheme.typography.headlineSmall,
+            textAlign = TextAlign.Center
+        )
+        Spacer(modifier = Modifier.height(16.dp))
+    }
+}
+
+@Composable
+private fun SyncFailedContent(onRetryClicked: () -> Unit) {
+    WooPosErrorScreen(
+        message = stringResource(R.string.woopos_home_sync_failed_title),
+        reason = stringResource(R.string.woopos_home_sync_failed_message),
+        primaryButton = Button(
+            text = stringResource(R.string.woopos_home_sync_failed_retry_button),
+            click = onRetryClicked
+        )
+    )
+}
+
 @OptIn(ExperimentalMaterialApi::class)
 @Composable
 @WooPosPreview
@@ -222,6 +314,8 @@ fun WooPosItemsScreenSearchVisiblePreview(modifier: Modifier = Modifier) {
             itemsStateFlow = productState,
             productsViewState = rememberLazyListState(),
             couponsListState = rememberLazyListState(),
+            catalogSyncState = CatalogSyncState.Idle,
+            onRetryCatalogSync = {},
             onUIEvent = {},
         )
     }
@@ -248,6 +342,8 @@ fun WooPosItemsScreenSearchHiddenPreview(modifier: Modifier = Modifier) {
             itemsStateFlow = productState,
             productsViewState = rememberLazyListState(),
             couponsListState = rememberLazyListState(),
+            catalogSyncState = CatalogSyncState.Idle,
+            onRetryCatalogSync = {},
             onUIEvent = {},
         )
     }