[Feature] 앱 초기 튜토리얼 화면

Near/app/src/main/java/com/alarmy/near/data/di/DataStoreModule.kt

@@ -9,17 +9,35 @@ import dagger.Provides
 import dagger.hilt.InstallIn
 import dagger.hilt.android.qualifiers.ApplicationContext
 import dagger.hilt.components.SingletonComponent
+import javax.inject.Qualifier
 import javax.inject.Singleton
 
+@Qualifier
+@Retention(AnnotationRetention.BINARY)
+annotation class AuthDataStore
+
+@Qualifier
+@Retention(AnnotationRetention.BINARY)
+annotation class OnboardingDataStore
+
 // DataStore 확장 프로퍼티
-private val Context.dataStore: DataStore<Preferences> by preferencesDataStore(name = "auth_preferences")
+private val Context.authDataStore: DataStore<Preferences> by preferencesDataStore(name = "auth_preferences")
+private val Context.onboardingDataStore: DataStore<Preferences> by preferencesDataStore(name = "onboarding_preferences")
 
 @Module
 @InstallIn(SingletonComponent::class)
 object DataStoreModule {
     @Provides
     @Singleton
-    fun provideDataStore(
+    @AuthDataStore
+    fun provideAuthDataStore(
+        @ApplicationContext context: Context,
+    ): DataStore<Preferences> = context.authDataStore
+
+    @Provides
+    @Singleton
+    @OnboardingDataStore
+    fun provideOnboardingDataStore(
         @ApplicationContext context: Context,
-    ): DataStore<Preferences> = context.dataStore
+    ): DataStore<Preferences> = context.onboardingDataStore
 }

Near/app/src/main/java/com/alarmy/near/data/di/RepositoryModule.kt

@@ -6,6 +6,8 @@ import com.alarmy.near.data.repository.DefaultFriendRepository
 import com.alarmy.near.data.repository.ExampleRepository
 import com.alarmy.near.data.repository.ExampleRepositoryImpl
 import com.alarmy.near.data.repository.FriendRepository
+import com.alarmy.near.data.repository.OnBoardingRepository
+import com.alarmy.near.data.repository.OnBoardingRepositoryImpl
 import dagger.Binds
 import dagger.Module
 import dagger.hilt.InstallIn
@@ -26,4 +28,8 @@ interface RepositoryModule {
     @Binds
     @Singleton
     abstract fun bindAuthRepository(authRepositoryImpl: AuthRepositoryImpl): AuthRepository
+
+    @Binds
+    @Singleton
+    abstract fun bindOnBoardingRepository(onBoardingRepositoryImpl: OnBoardingRepositoryImpl): OnBoardingRepository
 }

Near/app/src/main/java/com/alarmy/near/data/local/datastore/OnboardingPreferences.kt

@@ -0,0 +1,46 @@
+package com.alarmy.near.data.local.datastore
+
+import androidx.datastore.core.DataStore
+import androidx.datastore.preferences.core.Preferences
+import androidx.datastore.preferences.core.booleanPreferencesKey
+import androidx.datastore.preferences.core.edit
+import com.alarmy.near.data.di.OnboardingDataStore
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.map
+import javax.inject.Inject
+import javax.inject.Singleton
+
+/**
+ * 온보딩 완료 상태를 관리하는 DataStore
+ * 최초 접속 여부를 확인하여 온보딩 화면 표시 여부를 결정
+ */
+@Singleton
+class OnboardingPreferences @Inject constructor(
+    @OnboardingDataStore private val dataStore: DataStore<Preferences>,
+) {
+    private val onboardingCompletedKey = booleanPreferencesKey("onboarding_completed")
+
+    /**
+     * 온보딩 완료 여부를 확인하는 Flow
+     * true: 온보딩 완료됨, false: 온보딩 미완료
+     */
+    val isOnboardingCompleted: Flow<Boolean> = dataStore.data.map { preferences ->
+        preferences[onboardingCompletedKey] ?: false
+    }
+
+    /**
+     * 온보딩 완료 상태를 저장
+     */
+    suspend fun setOnboardingCompleted(completed: Boolean) {
+        dataStore.edit { preferences ->
+            preferences[onboardingCompletedKey] = completed
+        }
+    }
+
+    /**
+     * 온보딩 완료 상태를 true로 설정
+     */
+    suspend fun markOnboardingAsCompleted() {
+        setOnboardingCompleted(true)
+    }
+}

Near/app/src/main/java/com/alarmy/near/data/local/datastore/TokenPreferences.kt

@@ -5,9 +5,9 @@ import androidx.datastore.preferences.core.Preferences
 import androidx.datastore.preferences.core.edit
 import androidx.datastore.preferences.core.longPreferencesKey
 import androidx.datastore.preferences.core.stringPreferencesKey
+import com.alarmy.near.data.di.AuthDataStore
 import kotlinx.coroutines.flow.first
 import kotlinx.coroutines.flow.map
-
 import javax.inject.Inject
 import javax.inject.Singleton
 
@@ -16,11 +16,9 @@ import javax.inject.Singleton
  * 액세스 토큰과 리프레시 토큰의 저장, 조회, 삭제를 담당
  */
 @Singleton
-class TokenPreferences
-    @Inject
-    constructor(
-        private val dataStore: DataStore<Preferences>,
-    ) {
+class TokenPreferences @Inject constructor(
+    @AuthDataStore private val dataStore: DataStore<Preferences>,
+) {
         private val accessTokenKey = stringPreferencesKey("access_token")
         private val refreshTokenKey = stringPreferencesKey("refresh_token")
         private val expiresAtKey = longPreferencesKey("expires_at")

Near/app/src/main/java/com/alarmy/near/data/repository/OnBoardingRepository.kt

@@ -0,0 +1,37 @@
+package com.alarmy.near.data.repository
+
+import kotlinx.coroutines.flow.Flow
+
+/**
+ * 온보딩 관련 데이터를 관리하는 Repository 인터페이스
+ * 온보딩 완료 상태의 저장, 조회, 확인 기능을 제공
+ */
+interface OnBoardingRepository {
+
+    /**
+     * 온보딩 완료 여부를 확인하는 Flow
+     * true: 온보딩 완료됨, false: 온보딩 미완료
+     */
+    fun observeOnboardingStatus(): Flow<Boolean>
+
+    /**
+     * 온보딩 완료 상태를 저장
+     * completed: 온보딩 완료 여부
+     */
+    suspend fun setOnboardingCompleted(completed: Boolean)
+
+    /**
+     * 온보딩을 완료로 표시
+     */
+    suspend fun markOnboardingAsCompleted()
+
+    /**
+     * 온보딩 완료 상태를 확인
+     */
+    suspend fun isOnboardingCompleted(): Boolean
+
+    /**
+     * 온보딩 상태를 초기화 (테스트용 또는 재온보딩용)
+     */
+    suspend fun resetOnboardingStatus()
+}

Near/app/src/main/java/com/alarmy/near/data/repository/OnBoardingRepositoryImpl.kt

@@ -0,0 +1,37 @@
+package com.alarmy.near.data.repository
+
+import com.alarmy.near.data.local.datastore.OnboardingPreferences
+import kotlinx.coroutines.flow.Flow
+import kotlinx.coroutines.flow.first
+import javax.inject.Inject
+import javax.inject.Singleton
+
+/**
+ * OnBoardingRepository의 구현체
+ * OnboardingPreferences를 사용하여 온보딩 상태를 관리
+ */
+@Singleton
+class OnBoardingRepositoryImpl @Inject constructor(
+    private val onboardingPreferences: OnboardingPreferences,
+) : OnBoardingRepository {
+
+    override fun observeOnboardingStatus(): Flow<Boolean> {
+        return onboardingPreferences.isOnboardingCompleted
+    }
+
+    override suspend fun setOnboardingCompleted(completed: Boolean) {
+        onboardingPreferences.setOnboardingCompleted(completed)
+    }
+
+    override suspend fun markOnboardingAsCompleted() {
+        onboardingPreferences.markOnboardingAsCompleted()
+    }
+
+    override suspend fun isOnboardingCompleted(): Boolean {
+        return onboardingPreferences.isOnboardingCompleted.first()
+    }
+
+    override suspend fun resetOnboardingStatus() {
+        onboardingPreferences.setOnboardingCompleted(false)
+    }
+}

Near/app/src/main/java/com/alarmy/near/presentation/feature/main/NearNavHost.kt

@@ -4,14 +4,17 @@ import androidx.compose.runtime.Composable
 import androidx.compose.ui.Modifier
 import androidx.navigation.NavHostController
 import androidx.navigation.compose.NavHost
+import androidx.navigation.navOptions
 import com.alarmy.near.presentation.feature.friendprofile.navigation.friendProfileNavGraph
 import com.alarmy.near.presentation.feature.friendprofile.navigation.navigateToFriendProfile
 import com.alarmy.near.presentation.feature.friendprofileedittor.navigation.friendProfileEditorNavGraph
-import com.alarmy.near.presentation.feature.home.navigation.RouteHome
 import com.alarmy.near.presentation.feature.home.navigation.homeNavGraph
 import com.alarmy.near.presentation.feature.home.navigation.navigateToHome
 import com.alarmy.near.presentation.feature.login.navigation.RouteLogin
 import com.alarmy.near.presentation.feature.login.navigation.loginNavGraph
+import com.alarmy.near.presentation.feature.login.navigation.navigateToLogin
+import com.alarmy.near.presentation.feature.onboarding.navigation.RouteOnboarding
+import com.alarmy.near.presentation.feature.onboarding.navigation.onboardingNavGraph
 
 @Composable
 internal fun NearNavHost(
@@ -27,18 +30,31 @@ internal fun NearNavHost(
         navController = navController,
         startDestination = RouteLogin,
     ) {
+        // 온보딩 화면 NavGraph
+        onboardingNavGraph(
+            onNavigateToLogin = {
+                navController.navigateToLogin(
+                    navOptions =
+                        navOptions {
+                            popUpTo(RouteOnboarding) { inclusive = true }
+                        },
+                )
+            },
+        )
+
         // 로그인 화면 NavGraph
         loginNavGraph(
             onShowErrorSnackBar = onShowSnackbar,
             onNavigateToHome = {
                 navController.navigateToHome(
-                    navOptions = androidx.navigation.navOptions {
-                        popUpTo(RouteLogin) { inclusive = true }
-                    }
+                    navOptions =
+                        androidx.navigation.navOptions {
+                            popUpTo(RouteLogin) { inclusive = true }
+                        },
                 )
-            }
+            },
         )
-        
+
         // 홈 화면 NavGraph
         homeNavGraph(
             onShowErrorSnackBar = onShowSnackbar,
@@ -49,21 +65,21 @@ internal fun NearNavHost(
             onAlarmClick = {},
             onAddContactClick = {},
         )
-        
+
         // 친구 프로필 화면 NavGraph
         friendProfileNavGraph(
             onShowErrorSnackBar = onShowSnackbar,
             onClickBackButton = {
                 navController.popBackStack()
-            }
+            },
         )
-        
+
         // 친구 프로필 편집 화면 NavGraph
         friendProfileEditorNavGraph(
             onShowErrorSnackBar = onShowSnackbar,
             onClickBackButton = {
                 navController.popBackStack()
-            }
+            },
         )
     }
 }