[GMSS-212] 보관함 상세 화면 및 카드 물리 낙하 애니메이션 추가

app/src/main/kotlin/com/gamss/android/app/main/MainScreen.kt

@@ -36,7 +36,9 @@ import com.gamss.android.app.navigation.topLevelDestinations
 import com.gamss.android.core.designsystem.component.GamssBottomBar
 import com.gamss.android.core.designsystem.component.GamssPaperBackground
 import com.gamss.android.core.designsystem.theme.GamssTheme
+import com.gamss.android.feature.archive.ArchiveDetailScreen
 import com.gamss.android.feature.archive.ArchiveScreen
+import com.gamss.android.feature.archive.navigation.ArchiveDetailKey
 import com.gamss.android.feature.archive.navigation.ArchiveKey
 import com.gamss.android.feature.carddelete.CardDeleteScreen
 import com.gamss.android.feature.carddelete.navigation.CardDeleteKey
@@ -125,6 +127,16 @@ private fun mainEntryProvider(navigator: Navigator) = entryProvider {
     entry<ArchiveKey> {
         ArchiveScreen(
             onNavigateToSetting = { navigator.navigate(SettingKey) },
+            onArchiveClick = { navigator.navigate(ArchiveDetailKey(it)) },
+        )
+    }
+    // 보관함 상세도 탭 안쪽의 상세 화면이라 다른 상세들과 같은 슬라이드를 쓴다.
+    entry<ArchiveDetailKey>(metadata = detailSlideTransition) { key ->
+        ArchiveDetailScreen(
+            emotion = key.emotion,
+            onBackClick = navigator::goBack,
+            onOpenConversation = { conversationId -> navigator.navigate(ChatRoomKey(conversationId)) },
+            onNavigateToCardDelete = { navigator.navigate(CardDeleteKey) },
         )
     }
     entry<SettingKey>(metadata = detailSlideTransition) {

feature/archive/src/main/java/com/gamss/android/feature/archive/ArchiveDetailScreen.kt

@@ -0,0 +1,302 @@
+package com.gamss.android.feature.archive
+
+import android.content.Context
+import android.content.Intent
+import android.widget.Toast
+import androidx.annotation.StringRes
+import androidx.compose.foundation.clickable
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.PaddingValues
+import androidx.compose.foundation.layout.Row
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.shape.RoundedCornerShape
+import androidx.compose.material3.CircularProgressIndicator
+import androidx.compose.material3.Scaffold
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.runtime.getValue
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.draw.clip
+import androidx.compose.ui.platform.LocalContext
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.semantics.Role
+import androidx.compose.ui.tooling.preview.Preview
+import androidx.compose.ui.unit.dp
+import androidx.hilt.navigation.compose.hiltViewModel
+import com.gamss.android.core.designsystem.button.GamssButtonVariant
+import com.gamss.android.core.designsystem.component.GamssIconButton
+import com.gamss.android.core.designsystem.component.GamssTopBar
+import com.gamss.android.core.designsystem.dialog.GamssDialog
+import com.gamss.android.core.designsystem.dialog.GamssDialogAction
+import com.gamss.android.core.designsystem.theme.GamssTheme
+import com.gamss.android.domain.card.Card
+import com.gamss.android.domain.card.CardEntry
+import com.gamss.android.domain.emotion.EmotionCharacter
+import com.gamss.android.feature.archive.component.CardDetailDialog
+import com.gamss.android.feature.archive.component.MonthSelector
+import com.gamss.android.feature.archive.component.PaperPile
+import com.gamss.android.feature.archive.component.YearMonthPickerSheet
+import org.orbitmvi.orbit.compose.collectAsState
+import org.orbitmvi.orbit.compose.collectSideEffect
+import java.time.LocalDate
+import java.time.YearMonth
+import com.gamss.android.core.designsystem.R as DesignSystemR
+
+/**
+ * 시스템 뒤로가기는 여기서 BackHandler 로 받지 않는다. 먼저 가로채면 NavDisplay 의 onBack 에 닿지
+ * 않아, predictive back 미리보기와 pop 트랜지션이 이 화면에서만 빠진다.
+ */
+@Composable
+fun ArchiveDetailScreen(
+    emotion: EmotionCharacter,
+    onBackClick: () -> Unit,
+    onOpenConversation: (Long) -> Unit,
+    onNavigateToCardDelete: () -> Unit,
+    viewModel: ArchiveDetailViewModel = hiltViewModel(),
+) {
+    val state by viewModel.collectAsState()
+    val context = LocalContext.current
+    val shareChooserTitle = stringResource(R.string.archive_card_share_chooser_title)
+    val cardLoadFailedMessage = stringResource(R.string.archive_card_load_error)
+    val discardFailedMessage = stringResource(R.string.archive_card_discard_failure)
+
+    LaunchedEffect(emotion) { viewModel.load(emotion) }
+
+    viewModel.collectSideEffect { sideEffect ->
+        when (sideEffect) {
+            is ArchiveDetailSideEffect.OpenChatRoom -> onOpenConversation(sideEffect.conversationId)
+            ArchiveDetailSideEffect.OpenCardDelete -> onNavigateToCardDelete()
+
+            ArchiveDetailSideEffect.CardLoadFailed ->
+                Toast.makeText(context, cardLoadFailedMessage, Toast.LENGTH_SHORT).show()
+
+            ArchiveDetailSideEffect.CardDiscardFailed ->
+                Toast.makeText(context, discardFailedMessage, Toast.LENGTH_SHORT).show()
+        }
+    }
+
+    ArchiveDetailFrame(
+        emotion = emotion,
+        state = state,
+        onBackClick = onBackClick,
+        onPaperClick = viewModel::selectCard,
+        onMonthClick = viewModel::showMonthPicker,
+        onClearClick = viewModel::showClearDialog,
+    )
+
+    ArchiveDetailOverlays(
+        state = state,
+        onMonthSelect = viewModel::selectMonth,
+        onMonthPickerDismiss = viewModel::dismissMonthPicker,
+        onClearConfirm = viewModel::confirmClear,
+        onClearDismiss = viewModel::dismissClearDialog,
+        onCardDismiss = viewModel::dismissCard,
+        onCardDiscard = viewModel::discardSelectedCard,
+        onCardConversationClick = viewModel::viewSelectedConversation,
+        onCardShare = { card -> shareCard(context, card, shareChooserTitle) },
+    )
+}
+
+/** 항상 보이는 부분. 위에 겹쳐 뜨는 시트·다이얼로그는 [ArchiveDetailOverlays] 가 맡는다. */
+@Composable
+private fun ArchiveDetailFrame(
+    emotion: EmotionCharacter,
+    state: ArchiveDetailState,
+    onBackClick: () -> Unit,
+    onPaperClick: (CardEntry) -> Unit,
+    onMonthClick: () -> Unit,
+    onClearClick: () -> Unit,
+) {
+    Scaffold(
+        containerColor = GamssTheme.colors.white,
+        topBar = {
+            ArchiveDetailTopBar(
+                emotion = emotion,
+                onBackClick = onBackClick,
+                onClearClick = onClearClick,
+            )
+        },
+    ) { innerPadding ->
+        Box(modifier = Modifier.padding(innerPadding).fillMaxSize()) {
+            ArchiveDetailCards(cards = state.cards, onPaperClick = onPaperClick)
+            // 종이가 쌓일 자리보다 나중에 둔다. 카드가 많아 더미가 위로 넘치면 종이가 셀렉터를
+            // 가리고 탭까지 먹어 달을 못 바꾸게 된다.
+            MonthSelector(
+                yearMonth = state.yearMonth,
+                onClick = onMonthClick,
+                modifier = Modifier.align(Alignment.TopCenter),
+            )
+        }
+    }
+}
+
+/** 셋 다 아무것도 안 뜬 상태가 기본이라, 프레임과 떼어 여기서만 켜고 끈다. */
+@Composable
+private fun ArchiveDetailOverlays(
+    state: ArchiveDetailState,
+    onMonthSelect: (YearMonth) -> Unit,
+    onMonthPickerDismiss: () -> Unit,
+    onClearConfirm: () -> Unit,
+    onClearDismiss: () -> Unit,
+    onCardDismiss: () -> Unit,
+    onCardDiscard: () -> Unit,
+    onCardConversationClick: () -> Unit,
+    onCardShare: (Card) -> Unit,
+) {
+    if (state.isMonthPickerVisible) {
+        YearMonthPickerSheet(
+            selected = state.yearMonth,
+            onSelect = onMonthSelect,
+            onDismiss = onMonthPickerDismiss,
+        )
+    }
+
+    if (state.isClearDialogVisible) {
+        ClearConfirmDialog(onConfirm = onClearConfirm, onDismiss = onClearDismiss)
+    }
+
+    state.selectedCard?.let { card ->
+        CardDetailDialog(
+            card = card,
+            onDismiss = onCardDismiss,
+            onDiscardClick = onCardDiscard,
+            onViewConversationClick = onCardConversationClick,
+            onShareClick = { onCardShare(card) },
+        )
+    }
+}
+
+private fun shareCard(context: Context, card: Card, chooserTitle: String) {
+    val sendIntent = Intent(Intent.ACTION_SEND).apply {
+        type = "text/plain"
+        putExtra(Intent.EXTRA_TEXT, "${card.summary}\n\n${card.message}")
+    }
+    context.startActivity(Intent.createChooser(sendIntent, chooserTitle))
+}
+
+/** 되돌릴 수 없는 삭제라 파쇄 화면으로 넘기기 전에 확인을 한 번 받는다. */
+@Composable
+private fun ClearConfirmDialog(
+    onConfirm: () -> Unit,
+    onDismiss: () -> Unit,
+) {
+    GamssDialog(
+        title = stringResource(R.string.archive_clear_dialog_title),
+        subtitle = stringResource(R.string.archive_clear_dialog_description),
+        primaryAction = GamssDialogAction(
+            label = stringResource(R.string.archive_clear),
+            onClick = onConfirm,
+            variant = GamssButtonVariant.Destructive,
+        ),
+        secondaryAction = GamssDialogAction(
+            label = stringResource(R.string.archive_clear_dialog_cancel),
+            onClick = onDismiss,
+            variant = GamssButtonVariant.Secondary,
+        ),
+        onDismissRequest = onDismiss,
+    )
+}
+
+@Composable
+private fun ArchiveDetailTopBar(
+    emotion: EmotionCharacter,
+    onBackClick: () -> Unit,
+    onClearClick: () -> Unit,
+) {
+    GamssTopBar(
+        // 비우기는 터치 영역만큼 안쪽 여백을 물고 있어, 오른쪽은 그만큼 뺀다.
+        contentPadding = PaddingValues(
+            start = TopBarHorizontalPadding,
+            end = TopBarHorizontalPadding - ClearHitPadding,
+        ),
+        leading = {
+            Row(verticalAlignment = Alignment.CenterVertically) {
+                GamssIconButton(
+                    iconRes = DesignSystemR.drawable.ic_left_chevron,
+                    contentDescription = stringResource(R.string.archive_back_description),
+                    onClick = onBackClick,
+                    hitPadding = BackHitPadding,
+                )
+                Text(
+                    text = emotion.displayName,
+                    style = GamssTheme.typography.title4,
+                    color = GamssTheme.colors.gray900,
+                    modifier = Modifier.padding(start = TitleStartPadding),
+                )
+            }
+        },
+        trailing = {
+            Text(
+                text = stringResource(R.string.archive_clear),
+                style = GamssTheme.typography.body4Medium,
+                color = GamssTheme.colors.gray900,
+                modifier = Modifier
+                    .clip(RoundedCornerShape(ClearRippleRadius))
+                    .clickable(role = Role.Button, onClick = onClearClick)
+                    .padding(ClearHitPadding),
+            )
+        },
+    )
+}
+
+@Composable
+private fun ArchiveDetailCards(
+    cards: ArchiveCards,
+    onPaperClick: (CardEntry) -> Unit,
+) {
+    Box(modifier = Modifier.fillMaxSize(), contentAlignment = Alignment.Center) {
+        when (cards) {
+            ArchiveCards.Loading -> CircularProgressIndicator(color = GamssTheme.colors.gray700)
+            ArchiveCards.LoadFailed -> EmptyMessage(textRes = R.string.archive_cards_load_failed)
+            is ArchiveCards.Loaded -> if (cards.entries.isEmpty()) {
+                EmptyMessage(textRes = R.string.archive_cards_empty)
+            } else {
+                PaperPile(cards = cards.entries, onPaperClick = onPaperClick)
+            }
+        }
+    }
+}
+
+@Composable
+private fun EmptyMessage(@StringRes textRes: Int) {
+    Text(
+        text = stringResource(textRes),
+        style = GamssTheme.typography.body4Medium,
+        color = GamssTheme.colors.gray500,
+    )
+}
+
+private val TopBarHorizontalPadding = 18.dp
+private val BackHitPadding = 0.dp
+private val TitleStartPadding = 12.dp
+private val ClearHitPadding = 8.dp
+private val ClearRippleRadius = 8.dp
+
+@Preview(showBackground = true, widthDp = 402, heightDp = 874)
+@Composable
+@Suppress("UnusedPrivateMember")
+private fun ArchiveDetailPaperPilePreview() {
+    GamssTheme(darkTheme = false) {
+        ArchiveDetailFrame(
+            emotion = EmotionCharacter.QUIRKY,
+            state = ArchiveDetailState(
+                emotion = EmotionCharacter.QUIRKY,
+                yearMonth = YearMonth.of(2026, 7),
+                cards = ArchiveCards.Loaded(List(24) { index -> PreviewCard.copy(indexInDate = index) }),
+            ),
+            onBackClick = {},
+            onPaperClick = {},
+            onMonthClick = {},
+            onClearClick = {},
+        )
+    }
+}
+
+private val PreviewCard = CardEntry(
+    date = LocalDate.of(2026, 7, 23),
+    indexInDate = 0,
+    character = EmotionCharacter.QUIRKY,
+)

feature/archive/src/main/java/com/gamss/android/feature/archive/ArchiveDetailSideEffect.kt

@@ -0,0 +1,10 @@
+package com.gamss.android.feature.archive
+
+sealed interface ArchiveDetailSideEffect {
+    data class OpenChatRoom(val conversationId: Long) : ArchiveDetailSideEffect
+    data object CardLoadFailed : ArchiveDetailSideEffect
+    data object CardDiscardFailed : ArchiveDetailSideEffect
+
+    /** 실제 삭제는 파쇄 화면이 맡는다. 여기서는 그 화면으로 넘기기만 한다. */
+    data object OpenCardDelete : ArchiveDetailSideEffect
+}

feature/archive/src/main/java/com/gamss/android/feature/archive/ArchiveDetailState.kt

@@ -0,0 +1,23 @@
+package com.gamss.android.feature.archive
+
+import com.gamss.android.domain.card.Card
+import com.gamss.android.domain.card.CardEntry
+import com.gamss.android.domain.emotion.EmotionCharacter
+import java.time.YearMonth
+
+data class ArchiveDetailState(
+    val emotion: EmotionCharacter? = null,
+    val yearMonth: YearMonth,
+    val cards: ArchiveCards = ArchiveCards.Loading,
+    val isMonthPickerVisible: Boolean = false,
+    val isClearDialogVisible: Boolean = false,
+    val selectedCard: Card? = null,
+    val isCardLoading: Boolean = false,
+)
+
+/** 종이 더미 자리가 가질 수 있는 상태. 셋이 겹칠 수 없어 플래그 조합 대신 하나로 든다. */
+sealed interface ArchiveCards {
+    data object Loading : ArchiveCards
+    data object LoadFailed : ArchiveCards
+    data class Loaded(val entries: List<CardEntry>) : ArchiveCards
+}