[BOOK-155] feat: 개인정보처리방침, 이용약관을 보여주기 위한 웹뷰 이동 구현

easyhooon · easyhooon · commit cb10efe308ba · 2025-07-20T21:02:52.000+09:00
diff --git a/app/build.gradle.kts b/app/build.gradle.kts
@@ -53,6 +53,7 @@ dependencies {
         projects.feature.login,
         projects.feature.search,
         projects.feature.settings,
+        projects.feature.webview,
 
         libs.androidx.activity.compose,
         libs.androidx.startup,
diff --git a/core/common/src/main/kotlin/com/ninecraft/booket/core/common/constants/WebViewConstants.kt b/core/common/src/main/kotlin/com/ninecraft/booket/core/common/constants/WebViewConstants.kt
@@ -0,0 +1,6 @@
+package com.ninecraft.booket.core.common.constants
+
+enum class WebViewConstants(val url: String, val title: String) {
+    PRIVACY_POLICY("https://www.google.com", "개인정보처리방침"),
+    TERMS_OF_SERVICE("https://m.naver.com", "이용약관"),
+}
diff --git a/feature/login/src/main/kotlin/com/ninecraft/booket/feature/termsagreement/TermsAgreementPresenter.kt b/feature/login/src/main/kotlin/com/ninecraft/booket/feature/termsagreement/TermsAgreementPresenter.kt
@@ -6,8 +6,10 @@ import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
 import androidx.compose.runtime.setValue
+import com.ninecraft.booket.core.common.constants.WebViewConstants
 import com.ninecraft.booket.feature.screens.BottomNavigationScreen
 import com.ninecraft.booket.feature.screens.TermsAgreementScreen
+import com.ninecraft.booket.feature.screens.WebViewScreen
 import com.slack.circuit.codegen.annotations.CircuitInject
 import com.slack.circuit.retained.rememberRetained
 import com.slack.circuit.runtime.Navigator
@@ -50,8 +52,14 @@ class TermsAgreementPresenter @AssistedInject constructor(
                     navigator.pop()
                 }
 
-                is TermsAgreementUiEvent.OnTermDetailClick -> {
-                    // TODO: 웹뷰 화면으로 이동
+                is TermsAgreementUiEvent.OnPolicyClick -> {
+                    val policy = WebViewConstants.PRIVACY_POLICY
+                    navigator.goTo(WebViewScreen(url = policy.url, title = policy.title))
+                }
+
+                is TermsAgreementUiEvent.OnTermClick -> {
+                    val terms = WebViewConstants.TERMS_OF_SERVICE
+                    navigator.goTo(WebViewScreen(url = terms.url, title = terms.title))
                 }
 
                 is TermsAgreementUiEvent.OnStartButtonClick -> {
diff --git a/feature/login/src/main/kotlin/com/ninecraft/booket/feature/termsagreement/TermsAgreementScreen.kt b/feature/login/src/main/kotlin/com/ninecraft/booket/feature/termsagreement/TermsAgreementScreen.kt
@@ -45,6 +45,8 @@ internal fun TermsAgreement(
     state: TermsAgreementUiState,
     modifier: Modifier = Modifier,
 ) {
+    val termsTitles = stringArrayResource(id = R.array.terms_agreement_items)
+
     Column(
         modifier = modifier
             .fillMaxSize()
@@ -96,21 +98,34 @@ internal fun TermsAgreement(
                 )
             }
             Spacer(modifier = Modifier.height(ReedTheme.spacing.spacing4))
-
-            val termsTitles = stringArrayResource(id = R.array.terms_agreement_items)
-
-            termsTitles.forEachIndexed { index, title ->
-                TermItem(
-                    title = title,
-                    checked = state.agreedTerms[index],
-                    onCheckClick = {
-                        state.eventSink(TermsAgreementUiEvent.OnTermItemClick(index))
-                    },
-                    onDetailClick = {
-                        state.eventSink(TermsAgreementUiEvent.OnTermDetailClick(""))
-                    },
-                )
-            }
+            TermItem(
+                title = termsTitles[0],
+                checked = state.agreedTerms[0],
+                onCheckClick = {
+                    state.eventSink(TermsAgreementUiEvent.OnTermItemClick(0))
+                },
+                onDetailClick = {
+                    state.eventSink(TermsAgreementUiEvent.OnPolicyClick)
+                },
+            )
+            TermItem(
+                title = termsTitles[1],
+                checked = state.agreedTerms[1],
+                onCheckClick = {
+                    state.eventSink(TermsAgreementUiEvent.OnTermItemClick(1))
+                },
+                onDetailClick = {
+                    state.eventSink(TermsAgreementUiEvent.OnTermClick)
+                },
+            )
+            TermItem(
+                title = termsTitles[2],
+                checked = state.agreedTerms[2],
+                hasDetailAction = false,
+                onCheckClick = {
+                    state.eventSink(TermsAgreementUiEvent.OnTermItemClick(1))
+                },
+            )
         }
         ReedButton(
             onClick = {
@@ -134,17 +149,16 @@ internal fun TermsAgreement(
 @Composable
 private fun TermItem(
     title: String,
+    onCheckClick: () -> Unit,
     modifier: Modifier = Modifier,
     checked: Boolean = false,
-    onCheckClick: () -> Unit = {},
+    hasDetailAction: Boolean = true,
     onDetailClick: () -> Unit = {},
 ) {
     Row(
         modifier = modifier
             .fillMaxWidth()
-            .clickableSingle {
-                onDetailClick()
-            }
+            .clickableSingle { onDetailClick() }
             .padding(
                 start = ReedTheme.spacing.spacing5,
                 end = ReedTheme.spacing.spacing3,
@@ -164,11 +178,14 @@ private fun TermItem(
             color = ReedTheme.colors.contentPrimary,
             style = ReedTheme.typography.body1Medium,
         )
-        Icon(
-            imageVector = ImageVector.vectorResource(id = com.ninecraft.booket.core.designsystem.R.drawable.ic_chevron_right),
-            contentDescription = "Navigation Icon",
-            tint = Color.Unspecified,
-        )
+        
+        if (hasDetailAction) {
+            Icon(
+                imageVector = ImageVector.vectorResource(id = com.ninecraft.booket.core.designsystem.R.drawable.ic_chevron_right),
+                contentDescription = "Navigation Icon",
+                tint = Color.Unspecified,
+            )
+        }
     }
 }
 
diff --git a/feature/login/src/main/kotlin/com/ninecraft/booket/feature/termsagreement/TermsAgreementUiState.kt b/feature/login/src/main/kotlin/com/ninecraft/booket/feature/termsagreement/TermsAgreementUiState.kt
@@ -14,6 +14,7 @@ sealed interface TermsAgreementUiEvent : CircuitUiEvent {
     data object OnAllTermsAgreedClick : TermsAgreementUiEvent
     data class OnTermItemClick(val index: Int) : TermsAgreementUiEvent
     data object OnBackClick : TermsAgreementUiEvent
-    data class OnTermDetailClick(val url: String) : TermsAgreementUiEvent
+    data object OnPolicyClick : TermsAgreementUiEvent
+    data object OnTermClick : TermsAgreementUiEvent
     data object OnStartButtonClick : TermsAgreementUiEvent
 }
diff --git a/feature/screens/src/main/kotlin/com/ninecraft/booket/feature/screens/Screens.kt b/feature/screens/src/main/kotlin/com/ninecraft/booket/feature/screens/Screens.kt
@@ -30,3 +30,9 @@ data object SettingsScreen : ReedScreen(name = "Settings()")
 
 @Parcelize
 data object OssLicensesScreen : ReedScreen(name = "OssLicenses()")
+
+@Parcelize
+data class WebViewScreen(
+    val url: String,
+    val title: String,
+) : ReedScreen(name = "WebView()")
diff --git a/feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsPresenter.kt b/feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsPresenter.kt
@@ -5,11 +5,13 @@ import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.runtime.setValue
+import com.ninecraft.booket.core.common.constants.WebViewConstants
 import com.ninecraft.booket.core.common.utils.handleException
 import com.ninecraft.booket.core.data.api.repository.AuthRepository
 import com.ninecraft.booket.feature.screens.LoginScreen
 import com.ninecraft.booket.feature.screens.OssLicensesScreen
 import com.ninecraft.booket.feature.screens.SettingsScreen
+import com.ninecraft.booket.feature.screens.WebViewScreen
 import com.orhanobut.logger.Logger
 import com.slack.circuit.codegen.annotations.CircuitInject
 import com.slack.circuit.retained.rememberRetained
@@ -45,8 +47,14 @@ class SettingsPresenter @AssistedInject constructor(
                     navigator.pop()
                 }
 
-                is SettingsUiEvent.OnTermDetailClick -> {
-                    // TODO: 웹뷰 화면으로 이동
+                is SettingsUiEvent.OnPolicyClick -> {
+                    val policy = WebViewConstants.PRIVACY_POLICY
+                    navigator.goTo(WebViewScreen(url = policy.url, title = policy.title))
+                }
+
+                is SettingsUiEvent.OnTermClick -> {
+                    val terms = WebViewConstants.TERMS_OF_SERVICE
+                    navigator.goTo(WebViewScreen(url = terms.url, title = terms.title))
                 }
 
                 is SettingsUiEvent.OnOssLicensesClick -> {
diff --git a/feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsScreen.kt b/feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsScreen.kt
@@ -9,8 +9,8 @@ import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.foundation.layout.fillMaxWidth
 import androidx.compose.foundation.layout.height
 import androidx.compose.foundation.layout.padding
-import androidx.compose.material3.CircularProgressIndicator
 import androidx.compose.foundation.layout.systemBarsPadding
+import androidx.compose.material3.CircularProgressIndicator
 import androidx.compose.material3.ExperimentalMaterial3Api
 import androidx.compose.material3.Icon
 import androidx.compose.material3.Text
@@ -32,8 +32,8 @@ import com.ninecraft.booket.core.designsystem.component.appbar.ReedBackTopAppBar
 import com.ninecraft.booket.core.designsystem.component.divider.ReedDivider
 import com.ninecraft.booket.core.designsystem.theme.ReedTheme
 import com.ninecraft.booket.core.designsystem.theme.White
-import com.ninecraft.booket.feature.settings.component.WithdrawConfirmationBottomSheet
 import com.ninecraft.booket.feature.screens.SettingsScreen
+import com.ninecraft.booket.feature.settings.component.WithdrawConfirmationBottomSheet
 import com.slack.circuit.codegen.annotations.CircuitInject
 import dagger.hilt.android.components.ActivityRetainedComponent
 import kotlinx.coroutines.launch
@@ -77,7 +77,7 @@ internal fun Settings(
         SettingItem(
             title = stringResource(R.string.settings_privacy_policy),
             onItemClick = {
-                state.eventSink(SettingsUiEvent.OnTermDetailClick(""))
+                state.eventSink(SettingsUiEvent.OnPolicyClick)
             },
             action = {
                 Icon(
@@ -90,7 +90,7 @@ internal fun Settings(
         SettingItem(
             title = stringResource(R.string.settings_terms_of_service),
             onItemClick = {
-                state.eventSink(SettingsUiEvent.OnTermDetailClick(""))
+                state.eventSink(SettingsUiEvent.OnTermClick)
             },
             action = {
                 Icon(
diff --git a/feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsUiState.kt b/feature/settings/src/main/kotlin/com/ninecraft/booket/feature/settings/SettingsUiState.kt
@@ -19,7 +19,8 @@ sealed interface SettingsSideEffect {
 sealed interface SettingsUiEvent : CircuitUiEvent {
     data object InitSideEffect : SettingsUiEvent
     data object OnBackClick : SettingsUiEvent
-    data class OnTermDetailClick(val title: String) : SettingsUiEvent
+    data object OnPolicyClick : SettingsUiEvent
+    data object OnTermClick : SettingsUiEvent
     data object OnOssLicensesClick : SettingsUiEvent
     data object OnLogoutClick : SettingsUiEvent
     data object OnWithdrawClick : SettingsUiEvent
diff --git a/feature/webview/.gitignore b/feature/webview/.gitignore
@@ -0,0 +1 @@
+/build
diff --git a/feature/webview/build.gradle.kts b/feature/webview/build.gradle.kts
@@ -0,0 +1,21 @@
+@file:Suppress("INLINE_FROM_HIGHER_PLATFORM")
+
+plugins {
+    alias(libs.plugins.booket.android.feature)
+    alias(libs.plugins.booket.kotlin.library.serialization)
+    alias(libs.plugins.kotlin.parcelize)
+}
+
+android {
+    namespace = "com.ninecraft.booket.feature.webview"
+}
+
+ksp {
+    arg("circuit.codegen.mode", "hilt")
+}
+
+dependencies {
+    implementations(
+        libs.logger,
+    )
+}
diff --git a/feature/webview/src/main/kotlin/com/ninecraft/booket/feature/webview/WebViewPresenter.kt b/feature/webview/src/main/kotlin/com/ninecraft/booket/feature/webview/WebViewPresenter.kt
@@ -0,0 +1,43 @@
+package com.ninecraft.booket.feature.webview
+
+import androidx.compose.runtime.Composable
+import com.ninecraft.booket.feature.screens.WebViewScreen
+import com.slack.circuit.codegen.annotations.CircuitInject
+import com.slack.circuit.runtime.Navigator
+import com.slack.circuit.runtime.presenter.Presenter
+import dagger.assisted.Assisted
+import dagger.assisted.AssistedFactory
+import dagger.assisted.AssistedInject
+import dagger.hilt.android.components.ActivityRetainedComponent
+
+class WebViewPresenter @AssistedInject constructor(
+    @Assisted private val screen: WebViewScreen,
+    @Assisted private val navigator: Navigator,
+) : Presenter<WebViewUiState> {
+
+    @Composable
+    override fun present(): WebViewUiState {
+        fun handleEvent(event: WebViewUiEvent) {
+            when (event) {
+                is WebViewUiEvent.OnBackButtonClick -> {
+                    navigator.pop()
+                }
+            }
+        }
+
+        return WebViewUiState(
+            url = screen.url,
+            title = screen.title,
+            eventSink = ::handleEvent,
+        )
+    }
+
+    @CircuitInject(WebViewScreen::class, ActivityRetainedComponent::class)
+    @AssistedFactory
+    fun interface Factory {
+        fun create(
+            screen: WebViewScreen,
+            navigator: Navigator,
+        ): WebViewPresenter
+    }
+}
diff --git a/feature/webview/src/main/kotlin/com/ninecraft/booket/feature/webview/WebViewUi.kt b/feature/webview/src/main/kotlin/com/ninecraft/booket/feature/webview/WebViewUi.kt
@@ -0,0 +1,89 @@
+package com.ninecraft.booket.feature.webview
+
+import android.annotation.SuppressLint
+import android.view.ViewGroup
+import android.webkit.WebChromeClient
+import android.webkit.WebView
+import android.webkit.WebViewClient
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.runtime.Composable
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.viewinterop.AndroidView
+import com.ninecraft.booket.core.designsystem.DevicePreview
+import com.ninecraft.booket.core.designsystem.component.appbar.ReedBackTopAppBar
+import com.ninecraft.booket.core.designsystem.theme.ReedTheme
+import com.ninecraft.booket.core.ui.component.ReedFullScreen
+import com.ninecraft.booket.feature.screens.WebViewScreen
+import com.slack.circuit.codegen.annotations.CircuitInject
+import dagger.hilt.android.components.ActivityRetainedComponent
+
+@CircuitInject(WebViewScreen::class, ActivityRetainedComponent::class)
+@Composable
+internal fun WebViewUi(
+    state: WebViewUiState,
+    modifier: Modifier = Modifier,
+) {
+    ReedFullScreen(modifier = modifier) {
+        ReedBackTopAppBar(
+            title = state.title,
+            onBackClick = {
+                state.eventSink(WebViewUiEvent.OnBackButtonClick)
+            },
+        )
+        WebViewContent(
+            state = state,
+            modifier = modifier,
+        )
+    }
+}
+
+@SuppressLint("SetJavaScriptEnabled")
+@Composable
+internal fun WebViewContent(
+    state: WebViewUiState,
+    modifier: Modifier = Modifier,
+) {
+    Box(modifier = modifier.fillMaxSize()) {
+        AndroidView(
+            factory = { context ->
+                WebView(context).apply {
+                    layoutParams = ViewGroup.LayoutParams(
+                        ViewGroup.LayoutParams.MATCH_PARENT,
+                        ViewGroup.LayoutParams.MATCH_PARENT,
+                    )
+                    // 기본 웹뷰 클라이언트
+                    webViewClient = WebViewClient()
+                    // 브라우저 기능 지원
+                    webChromeClient = WebChromeClient()
+                    settings.apply {
+                        // JavaScript 실행 허용 - 노션 SPA 동작에 필수
+                        javaScriptEnabled = true
+                        // DOM 스토리지 허용 - 사용자 설정/세션 정보 저장
+                        domStorageEnabled = true
+                        // 뷰포트 메타태그 지원 - 반응형 레이아웃 조정
+                        useWideViewPort = true
+                        // 화면에 맞게 조정 - 모바일 최적화
+                        loadWithOverviewMode = true
+                    }
+                    loadUrl(state.url)
+                }
+            },
+            modifier = Modifier.fillMaxSize(),
+        )
+    }
+}
+
+@DevicePreview
+@Composable
+private fun WebViewUiPreview() {
+    ReedTheme {
+        WebViewUi(
+            state = WebViewUiState(
+                url = "https://m.naver.com",
+                title = "개인정보처리방침",
+                eventSink = {},
+            ),
+        )
+    }
+}
diff --git a/feature/webview/src/main/kotlin/com/ninecraft/booket/feature/webview/WebViewUiState.kt b/feature/webview/src/main/kotlin/com/ninecraft/booket/feature/webview/WebViewUiState.kt
diff --git a/settings.gradle.kts b/settings.gradle.kts

Original file line number	Diff line number	Diff line change
`@@ -14,6 +14,7 @@ sealed interface TermsAgreementUiEvent : CircuitUiEvent {`
`14`	`14`	`data object OnAllTermsAgreedClick : TermsAgreementUiEvent`
`15`	`15`	`data class OnTermItemClick(val index: Int) : TermsAgreementUiEvent`
`16`	`16`	`data object OnBackClick : TermsAgreementUiEvent`
`17`		`- data class OnTermDetailClick(val url: String) : TermsAgreementUiEvent`
	`17`	`+ data object OnPolicyClick : TermsAgreementUiEvent`
	`18`	`+ data object OnTermClick : TermsAgreementUiEvent`
`18`	`19`	`data object OnStartButtonClick : TermsAgreementUiEvent`
`19`	`20`	`}`