[FEAT] 연락처 작업

.github/workflows/android-pull-request-ci.yml

@@ -3,7 +3,7 @@ name: Android Pull Request CI
 on:
   pull_request:
     branches: [ "main", "develop", "dev" ]
-    
+
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -49,6 +49,16 @@ jobs:
         run: |
           echo "KAKAO_NATIVE_APP_KEY=\"$KAKAO_NATIVE_APP_KEY\"" >> local.properties
 
+      - name: Access Near PRIVACY URLS
+        env:
+          SERVICE_AGREED_TERMS_URL: ${{ secrets.SERVICE_AGREED_TERMS_URL }}
+          PERSONAL_INFO_TERMS_URL: ${{ secrets.PERSONAL_INFO_TERMS_URL }}
+          PRIVACY_POLICY_TERMS_URL: ${{ secrets.PRIVACY_POLICY_TERMS_URL }}
+        run: |
+          echo "SERVICE_AGREED_TERMS_URL=\"$SERVICE_AGREED_TERMS_URL\"" >> local.properties
+          echo "PERSONAL_INFO_TERMS_URL=\"$PERSONAL_INFO_TERMS_URL\"" >> local.properties
+          echo "PRIVACY_POLICY_TERMS_URL=\"$PRIVACY_POLICY_TERMS_URL\"" >> local.properties
+
       - name: Grant execute permission for gradlew
         run: chmod +x gradlew
 

Near/app/build.gradle.kts

@@ -34,12 +34,18 @@ android {
             buildConfigField("String", "NEAR_URL", getProperty("NEAR_PROD_URL"))
             buildConfigField("String", "TEMP_TOKEN", getProperty("TEMP_TOKEN")) // TODO 추후 삭제 필요
             buildConfigField("String", "KAKAO_NATIVE_APP_KEY", getProperty("KAKAO_NATIVE_APP_KEY"))
+            buildConfigField("String", "SERVICE_AGREED_TERMS_URL", getProperty("SERVICE_AGREED_TERMS_URL"))
+            buildConfigField("String", "PERSONAL_INFO_TERMS_URL", getProperty("PERSONAL_INFO_TERMS_URL"))
+            buildConfigField("String", "PRIVACY_POLICY_TERMS_URL", getProperty("PRIVACY_POLICY_TERMS_URL"))
             manifestPlaceholders["kakaoAppKey"] = getProperty("KAKAO_NATIVE_APP_KEY").replace("\"", "")
         }
         debug {
             buildConfigField("String", "NEAR_URL", getProperty("NEAR_DEV_URL"))
             buildConfigField("String", "TEMP_TOKEN", getProperty("TEMP_TOKEN")) // TODO 추후 삭제 필요
             buildConfigField("String", "KAKAO_NATIVE_APP_KEY", getProperty("KAKAO_NATIVE_APP_KEY"))
+            buildConfigField("String", "SERVICE_AGREED_TERMS_URL", getProperty("SERVICE_AGREED_TERMS_URL"))
+            buildConfigField("String", "PERSONAL_INFO_TERMS_URL", getProperty("PERSONAL_INFO_TERMS_URL"))
+            buildConfigField("String", "PRIVACY_POLICY_TERMS_URL", getProperty("PRIVACY_POLICY_TERMS_URL"))
             manifestPlaceholders["kakaoAppKey"] = getProperty("KAKAO_NATIVE_APP_KEY").replace("\"", "")
         }
     }
@@ -81,9 +87,8 @@ dependencies {
     implementation(libs.retrofit)
     implementation(libs.retrofit.kotlin.serialization.converter)
     implementation(libs.logging.interceptor)
-    // Glide
-    implementation(libs.glide)
-    kapt(libs.glide.compiler)
+    // Coil
+    implementation(libs.coil.compose)
     // Room
     implementation(libs.room.runtime)
     implementation(libs.room.ktx)
@@ -99,6 +104,9 @@ dependencies {
 
     // Kakao Module
     implementation(libs.v2.all)
+
+    // Splash Screen API
+    implementation(libs.androidx.core.splashscreen)
 }
 
 fun getProperty(propertyKey: String): String = gradleLocalProperties(rootDir, providers).getProperty(propertyKey)

Near/app/src/main/AndroidManifest.xml

@@ -3,13 +3,14 @@
     xmlns:tools="http://schemas.android.com/tools">
 
     <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.READ_CONTACTS" />
 
     <application
         android:name=".NearApplication"
         android:allowBackup="true"
         android:dataExtractionRules="@xml/data_extraction_rules"
         android:fullBackupContent="@xml/backup_rules"
-        android:icon="@mipmap/ic_launcher"
+        android:icon="@mipmap/ic_launcher_round"
         android:label="@string/app_name"
         android:roundIcon="@mipmap/ic_launcher_round"
         android:supportsRtl="true"
@@ -20,25 +21,28 @@
         <meta-data
             android:name="com.kakao.sdk.AppKey"
             android:value="${kakaoAppKey}" />
-            
+
         <!-- 카카오톡 로그인 콜백을 위한 Activity -->
         <activity
             android:name="com.kakao.sdk.auth.AuthCodeHandlerActivity"
             android:exported="true">
             <intent-filter>
                 <action android:name="android.intent.action.VIEW" />
+
                 <category android:name="android.intent.category.DEFAULT" />
                 <category android:name="android.intent.category.BROWSABLE" />
-                <data android:host="oauth"
-                      android:scheme="kakao${kakaoAppKey}" />
+
+                <data
+                    android:host="oauth"
+                    android:scheme="kakao${kakaoAppKey}" />
             </intent-filter>
         </activity>
-        
+
         <activity
             android:name=".presentation.feature.main.MainActivity"
             android:exported="true"
             android:label="@string/app_name"
-            android:theme="@style/Theme.Near">
+            android:theme="@style/Theme.Near.Splash">
             <intent-filter>
                 <action android:name="android.intent.action.MAIN" />
 

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

@@ -2,10 +2,16 @@ package com.alarmy.near.data.di
 
 import com.alarmy.near.data.repository.AuthRepository
 import com.alarmy.near.data.repository.AuthRepositoryImpl
+import com.alarmy.near.data.repository.ContactRepository
+import com.alarmy.near.data.repository.DefaultContactRepository
 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 com.alarmy.near.data.repository.MemberRepository
+import com.alarmy.near.data.repository.MemberRepositoryImpl
 import dagger.Binds
 import dagger.Module
 import dagger.hilt.InstallIn
@@ -26,4 +32,16 @@ interface RepositoryModule {
     @Binds
     @Singleton
     abstract fun bindAuthRepository(authRepositoryImpl: AuthRepositoryImpl): AuthRepository
+
+    @Binds
+    @Singleton
+    abstract fun bindOnBoardingRepository(onBoardingRepositoryImpl: OnBoardingRepositoryImpl): OnBoardingRepository
+
+    @Binds
+    @Singleton
+    abstract fun bindMemberRepository(memberRepositoryImpl: MemberRepositoryImpl): MemberRepository
+
+    @Binds
+    @Singleton
+    abstract fun bindContactRepository(contactRepository: DefaultContactRepository): ContactRepository
 }

Near/app/src/main/java/com/alarmy/near/data/entity/MemberInfoEntity.kt

@@ -0,0 +1,17 @@
+package com.alarmy.near.data.entity
+
+import kotlinx.serialization.Serializable
+
+/**
+ * 회원 정보 Data Layer 엔티티
+ * API 응답 데이터를 나타내는 모델
+ */
+@Serializable
+data class MemberInfoEntity(
+    val memberId: String,
+    val username: String,
+    val nickname: String,
+    val imageUrl: String?,
+    val notificationAgreedAt: String?,
+    val providerType: String,
+)

Near/app/src/main/java/com/alarmy/near/data/entity/WithdrawRequestEntity.kt

@@ -0,0 +1,13 @@
+package com.alarmy.near.data.entity
+
+import kotlinx.serialization.Serializable
+
+/**
+ * 회원 탈퇴 요청 Data Layer 엔티티
+ * Network Layer의 WithdrawRequest와 동일한 구조
+ */
+@Serializable
+data class WithdrawRequestEntity(
+    val reasonType: String,
+    val customReason: String? = null,
+)

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

@@ -0,0 +1,48 @@
+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>,
+) {
+    companion object {
+        private val ONBOARDING_COMPLETED_KEY = booleanPreferencesKey("onboarding_completed")
+    }
+
+    /**
+     * 온보딩 완료 여부를 확인하는 Flow
+     * true: 온보딩 완료됨, false: 온보딩 미완료
+     */
+    val isOnboardingCompleted: Flow<Boolean> = dataStore.data.map { preferences ->
+        preferences[ONBOARDING_COMPLETED_KEY] ?: false
+    }
+
+    /**
+     * 온보딩 완료 상태를 저장
+     */
+    suspend fun setOnboardingCompleted(completed: Boolean) {
+        dataStore.edit { preferences ->
+            preferences[ONBOARDING_COMPLETED_KEY] = 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/mapper/ContactMapper.kt

@@ -0,0 +1,14 @@
+package com.alarmy.near.data.mapper
+
+import com.alarmy.near.local.entity.ContactEntity
+import com.alarmy.near.model.contact.Contact
+
+fun ContactEntity.toModel(): Contact =
+    Contact(
+        id = id,
+        name = name,
+        phones = phones,
+        photoUri = photoUri,
+        birthDay = birthDay,
+        memo = memo,
+    )

Near/app/src/main/java/com/alarmy/near/data/mapper/MemberMapper.kt

@@ -0,0 +1,70 @@
+package com.alarmy.near.data.mapper
+
+import com.alarmy.near.data.entity.MemberInfoEntity
+import com.alarmy.near.data.entity.WithdrawRequestEntity
+import com.alarmy.near.model.member.MemberInfo
+import com.alarmy.near.network.request.WithdrawRequest
+import com.alarmy.near.presentation.feature.myprofile.model.LoginType
+import com.alarmy.near.presentation.feature.myprofile.model.MyProfileInfoUIModel
+import com.alarmy.near.presentation.feature.myprofile.model.WithdrawReason
+
+/**
+ * Data Layer Entity를 Model Layer로 변환
+ */
+fun MemberInfoEntity.toModel(): MemberInfo =
+    MemberInfo(
+        memberId = memberId,
+        username = username,
+        nickname = nickname,
+        imageUrl = imageUrl,
+        notificationAgreedAt = notificationAgreedAt,
+        providerType = providerType,
+    )
+
+/**
+ * Model Layer를 Data Layer Entity로 변환
+ */
+fun MemberInfo.toEntity(): MemberInfoEntity =
+    MemberInfoEntity(
+        memberId = memberId,
+        username = username,
+        nickname = nickname,
+        imageUrl = imageUrl,
+        notificationAgreedAt = notificationAgreedAt,
+        providerType = providerType,
+    )
+
+/**
+ * WithdrawReason을 Network Layer로 변환
+ */
+fun WithdrawReason.toRequest(customReason: String? = null): WithdrawRequest =
+    WithdrawRequest(
+        reasonType = this.name,
+        customReason = customReason,
+    )
+
+fun WithdrawRequest.toEntity(): WithdrawRequestEntity =
+    WithdrawRequestEntity(
+        reasonType = reasonType,
+        customReason = customReason,
+    )
+
+/**
+ * Model 계층 모델을 UI 계층 모델로 변환
+ */
+fun MemberInfo.toMyProfileInfoUIModel(): MyProfileInfoUIModel =
+    MyProfileInfoUIModel(
+        nickname = nickname,
+        imageUrl = imageUrl,
+        notificationAgreedAt = notificationAgreedAt,
+        providerType = mapProviderType(providerType),
+    )
+
+/**
+ * ProviderType 문자열을 LoginType enum으로 변환
+ */
+private fun mapProviderType(providerType: String): LoginType =
+    when (providerType.uppercase()) {
+        "KAKAO" -> LoginType.KAKAO
+        else -> LoginType.ETC
+    }

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

@@ -0,0 +1,8 @@
+package com.alarmy.near.data.repository
+
+import com.alarmy.near.model.contact.Contact
+import kotlinx.coroutines.flow.Flow
+
+interface ContactRepository {
+    fun fetchAllContacts(): Flow<List<Contact>>
+}