[FEAT] 연락처 불러오기 & 주기 설정 기능

Near/app/build.gradle.kts

@@ -107,6 +107,9 @@ dependencies {
 
     // Splash Screen API
     implementation(libs.androidx.core.splashscreen)
+
+    // libphonenumber-android for phone number formatting
+    implementation("io.michaelrocks:libphonenumber-android:9.0.15")
 }
 
 fun getProperty(propertyKey: String): String = gradleLocalProperties(rootDir, providers).getProperty(propertyKey)

Near/app/src/main/java/com/alarmy/near/NearApplication.kt

@@ -1,6 +1,7 @@
 package com.alarmy.near
 
 import android.app.Application
+import com.alarmy.near.utils.PhoneNumberFormatter
 import com.kakao.sdk.common.KakaoSdk
 import dagger.hilt.android.HiltAndroidApp
 
@@ -12,5 +13,8 @@ class NearApplication : Application() {
 
         // 카카오 SDK 초기화
         KakaoSdk.init(this, BuildConfig.KAKAO_NATIVE_APP_KEY)
+
+        // PhoneNumberFormatter 초기화
+        PhoneNumberFormatter.initialize(this)
     }
 }

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

@@ -0,0 +1,104 @@
+package com.alarmy.near.data.mapper
+
+import com.alarmy.near.model.Anniversary
+import com.alarmy.near.model.ContactFrequency
+import com.alarmy.near.model.DayOfWeek
+import com.alarmy.near.model.Friend
+import com.alarmy.near.model.Relation
+import com.alarmy.near.model.ReminderInterval
+import com.alarmy.near.network.request.ContactFrequencyInitRequest
+import com.alarmy.near.network.request.FriendInitItemRequest
+import com.alarmy.near.network.response.AnniversaryInitEntity
+import com.alarmy.near.network.response.ContactFrequencyInitEntity
+import com.alarmy.near.network.response.FriendInitItemEntity
+import com.alarmy.near.presentation.feature.friendcontactcycle.model.FriendContactUIModel
+import com.alarmy.near.utils.PhoneNumberFormatter
+import com.alarmy.near.utils.extensions.DateExtension
+import com.alarmy.near.utils.logger.NearLog
+
+/**
+ * PhoneNumberFormatter를 사용하여 전화번호를 포맷팅하는 함수
+ * - 다양한 전화번호 형식 지원 (휴대폰, 지역번호 등)
+ * - 한국 전화번호 형식으로 통일 (010-0000-0000, 02-0000-0000 등)
+ * - 잘못된 형식의 경우 원본 반환
+ */
+private fun String.formatPhoneNumber(): String = PhoneNumberFormatter.formatPhoneNumber(this)
+
+/**
+ * UI 모델을 서버 요청 모델로 변환
+ */
+fun FriendContactUIModel.toFriendInitItemRequest(providerType: String): FriendInitItemRequest =
+    FriendInitItemRequest(
+        name = name,
+        phone = phones.firstOrNull()?.formatPhoneNumber() ?: "",
+        memo = memo,
+        birthDay = birthDay,
+        source = providerType,
+        contactFrequency = createContactFrequencyRequest(reminderInterval!!),
+        imageUploadRequest = null,
+        anniversary = null,
+        relation = "FRIEND", // 기본값으로 FRIEND 설정
+    )
+
+/**
+ * ContactFrequencyInitEntity를 모델로 변환
+ */
+fun ContactFrequencyInitEntity.toModel(): ContactFrequency =
+    ContactFrequency(
+        reminderInterval = contactWeek.toReminderInterval(),
+        dayOfWeek = dayOfWeek.toDayOfWeek(),
+    )
+
+/**
+ * AnniversaryInitEntity를 모델로 변환
+ */
+fun AnniversaryInitEntity.toModel(): Anniversary =
+    Anniversary(
+        id = id,
+        title = title,
+        date = date,
+    )
+
+/**
+ * 서버 응답을 모델로 변환
+ */
+fun FriendInitItemEntity.toModel(): Friend =
+    Friend(
+        friendId = friendId,
+        name = name,
+        phone = phone,
+        memo = memo,
+        birthday = null,
+        imageUrl = preSignedImageUrl,
+        relation = source.toRelation(),
+        contactFrequency = contactFrequency.toModel(),
+        anniversaryList = anniversary?.let { listOf(it.toModel()) } ?: emptyList(),
+        lastContactAt = nextContactAt,
+    )
+
+/**
+ * ReminderInterval을 ContactFrequencyInitRequest로 변환
+ */
+private fun createContactFrequencyRequest(reminderInterval: ReminderInterval): ContactFrequencyInitRequest =
+    ContactFrequencyInitRequest(
+        contactWeek = DateExtension.toContactWeekString(reminderInterval),
+        dayOfWeek = DateExtension.getTodayDayOfWeekInEnglish(),
+    )
+
+private fun String.toReminderInterval(): ReminderInterval =
+    runCatching { ReminderInterval.valueOf(this) }
+        .onFailure { exception ->
+            NearLog.w("잘못된 연락 주기 값: '$this', 기본값(EVERY_WEEK) 사용")
+        }.getOrDefault(ReminderInterval.EVERY_WEEK)
+
+private fun String.toDayOfWeek(): DayOfWeek =
+    runCatching { DayOfWeek.valueOf(this) }
+        .onFailure { exception ->
+            NearLog.w("잘못된 요일 값: '$this', 기본값(MONDAY) 사용")
+        }.getOrDefault(DayOfWeek.MONDAY)
+
+private fun String.toRelation(): Relation =
+    runCatching { Relation.valueOf(this) }
+        .onFailure { exception ->
+            NearLog.w("잘못된 관계 값: '$this', 기본값(FRIEND) 사용")
+        }.getOrDefault(Relation.FRIEND)

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

@@ -12,12 +12,13 @@ import com.alarmy.near.network.request.FriendRequest
 import com.alarmy.near.network.response.AnniversaryEntity
 import com.alarmy.near.network.response.ContactFrequencyEntity
 import com.alarmy.near.network.response.FriendEntity
+import com.alarmy.near.utils.logger.NearLog
 
 fun FriendEntity.toModel(): Friend =
     Friend(
         friendId = friendId,
         imageUrl = imageUrl,
-        relation = Relation.valueOf(relation),
+        relation = relation.toRelation(),
         name = name,
         contactFrequency = contactFrequency.toModel(),
         birthday = birthday,
@@ -29,8 +30,8 @@ fun FriendEntity.toModel(): Friend =
 
 fun ContactFrequencyEntity.toModel(): ContactFrequency =
     ContactFrequency(
-        reminderInterval = ReminderInterval.valueOf(contactWeek),
-        dayOfWeek = DayOfWeek.valueOf(dayOfWeek),
+        reminderInterval = contactWeek.toReminderInterval(),
+        dayOfWeek = dayOfWeek.toDayOfWeek(),
     )
 
 fun AnniversaryEntity.toModel(): Anniversary =
@@ -63,3 +64,30 @@ fun Anniversary.toRequest(): AnniversaryRequest =
         title = title,
         date = date,
     )
+
+/**
+ * 안전한 ReminderInterval 변환 (로깅 포함)
+ */
+private fun String.toReminderInterval(): ReminderInterval =
+    runCatching { ReminderInterval.valueOf(this) }
+        .onFailure { exception ->
+            NearLog.w("잘못된 연락 주기 값: '$this', 기본값(EVERY_WEEK) 사용")
+        }.getOrDefault(ReminderInterval.EVERY_WEEK)
+
+/**
+ * 안전한 DayOfWeek 변환 (로깅 포함)
+ */
+private fun String.toDayOfWeek(): DayOfWeek =
+    runCatching { DayOfWeek.valueOf(this) }
+        .onFailure { exception ->
+            NearLog.w("잘못된 요일 값: '$this', 기본값(MONDAY) 사용")
+        }.getOrDefault(DayOfWeek.MONDAY)
+
+/**
+ * 안전한 Relation 변환 (로깅 포함)
+ */
+private fun String.toRelation(): Relation =
+    runCatching { Relation.valueOf(this) }
+        .onFailure { exception ->
+            NearLog.w("잘못된 관계 값: '$this', 기본값(FRIEND) 사용")
+        }.getOrDefault(Relation.FRIEND)

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

@@ -1,12 +1,17 @@
 package com.alarmy.near.data.repository
 
+import com.alarmy.near.data.mapper.toFriendInitItemRequest
 import com.alarmy.near.data.mapper.toModel
 import com.alarmy.near.data.mapper.toRequest
 import com.alarmy.near.model.Friend
 import com.alarmy.near.model.FriendRecord
 import com.alarmy.near.model.friendsummary.FriendSummary
 import com.alarmy.near.model.monthly.MonthlyFriend
+import com.alarmy.near.network.request.FriendInitRequest
+import com.alarmy.near.network.response.FriendInitItemEntity
 import com.alarmy.near.network.service.FriendService
+import com.alarmy.near.presentation.feature.friendcontactcycle.model.FriendContactUIModel
+import com.alarmy.near.utils.extensions.apiCallFlow
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.flow
 import javax.inject.Inject
@@ -63,4 +68,22 @@ class DefaultFriendRepository
                 val response = friendService.recordContact(friendId)
                 emit(response.message) // CommonMessageEntity.message 라고 가정
             }
+
+        override fun initFriends(
+            contacts: List<FriendContactUIModel>,
+            providerType: String,
+        ): Flow<List<FriendInitItemEntity>> =
+            apiCallFlow {
+                // UI 모델을 Data 모델로 변환
+                val friendInitRequest =
+                    FriendInitRequest(
+                        friendList =
+                            contacts
+                                .filter { it.reminderInterval != null }
+                                .map { it.toFriendInitItemRequest(providerType) },
+                    )
+
+                // 서버 요청 및 응답 반환
+                friendService.initFriends(friendInitRequest).friendList
+            }
     }

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

@@ -2,8 +2,10 @@ package com.alarmy.near.data.repository
 
 import com.alarmy.near.model.Friend
 import com.alarmy.near.model.FriendRecord
+import com.alarmy.near.network.response.FriendInitItemEntity
 import com.alarmy.near.model.friendsummary.FriendSummary
 import com.alarmy.near.model.monthly.MonthlyFriend
+import com.alarmy.near.presentation.feature.friendcontactcycle.model.FriendContactUIModel
 import kotlinx.coroutines.flow.Flow
 
 interface FriendRepository {
@@ -23,4 +25,6 @@ interface FriendRepository {
     fun fetchFriendRecord(friendId: String): Flow<List<FriendRecord>>
 
     fun recordContact(friendId: String): Flow<String>
+
+    fun initFriends(contacts: List<FriendContactUIModel>, providerType: String): Flow<List<FriendInitItemEntity>>
 }

Near/app/src/main/java/com/alarmy/near/network/request/FriendInitRequest.kt

@@ -0,0 +1,56 @@
+package com.alarmy.near.network.request
+
+import kotlinx.serialization.Serializable
+
+/**
+ * 친구 초기 설정 API 요청 데이터 모델
+ */
+@Serializable
+data class FriendInitRequest(
+    val friendList: List<FriendInitItemRequest>,
+)
+
+/**
+ * 친구 초기 설정 개별 아이템 요청 데이터 모델
+ */
+@Serializable
+data class FriendInitItemRequest(
+    val name: String,
+    val phone: String,
+    val memo: String? = null,
+    val birthDay: String? = null,
+    val source: String,
+    val contactFrequency: ContactFrequencyInitRequest,
+    val imageUploadRequest: ImageUploadRequest? = null,
+    val anniversary: AnniversaryInitRequest? = null,
+    val relation: String? = null,
+)
+
+/**
+ * 연락처 주기 설정 요청 데이터 모델
+ */
+@Serializable
+data class ContactFrequencyInitRequest(
+    val contactWeek: String, // EVERY_WEEK, EVERY_TWO_WEEKS, EVERY_MONTH
+    val dayOfWeek: String, // MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
+)
+
+/**
+ * 이미지 업로드 요청 데이터 모델
+ */
+@Serializable
+data class ImageUploadRequest(
+    val fileName: String? = null,
+    val contentType: String? = null,
+    val fileSize: Int? = null,
+    val category: String? = null,
+)
+
+/**
+ * 기념일 요청 데이터 모델
+ */
+@Serializable
+data class AnniversaryInitRequest(
+    val title: String,
+    val date: String? = null,
+)

Near/app/src/main/java/com/alarmy/near/network/response/FriendInitEntity.kt

@@ -0,0 +1,38 @@
+package com.alarmy.near.network.response
+
+import kotlinx.serialization.Serializable
+
+/**
+ * 친구 초기 설정 API 응답 데이터
+ */
+@Serializable
+data class FriendInitEntity(
+    val friendList: List<FriendInitItemEntity>,
+)
+
+@Serializable
+data class FriendInitItemEntity(
+    val friendId: String,
+    val name: String,
+    val source: String,
+    val contactFrequency: ContactFrequencyInitEntity,
+    val nextContactAt: String,
+    val phone: String,
+    val preSignedImageUrl: String? = null,
+    val fileName: String? = null,
+    val memo: String? = null,
+    val anniversary: AnniversaryInitEntity? = null,
+)
+
+@Serializable
+data class ContactFrequencyInitEntity(
+    val contactWeek: String,
+    val dayOfWeek: String,
+)
+
+@Serializable
+data class AnniversaryInitEntity(
+    val id: Int,
+    val title: String,
+    val date: String,
+)

Near/app/src/main/java/com/alarmy/near/network/service/FriendService.kt

@@ -1,8 +1,10 @@
 package com.alarmy.near.network.service
 
+import com.alarmy.near.network.request.FriendInitRequest
 import com.alarmy.near.network.request.FriendRequest
 import com.alarmy.near.network.response.CommonMessageEntity
 import com.alarmy.near.network.response.FriendEntity
+import com.alarmy.near.network.response.FriendInitEntity
 import com.alarmy.near.network.response.FriendRecordEntity
 import com.alarmy.near.network.response.FriendSummaryEntity
 import com.alarmy.near.network.response.MonthlyFriendEntity
@@ -45,4 +47,9 @@ interface FriendService {
     suspend fun recordContact(
         @Path("friendId") friendId: String,
     ): CommonMessageEntity
+
+    @POST("/friend/init")
+    suspend fun initFriends(
+        @Body friendInitRequest: FriendInitRequest,
+    ): FriendInitEntity
 }

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

@@ -73,7 +73,12 @@ fun ContactRoute(
 
     when (uiState) {
         is ContactUiState.Loading -> {
-            Box(modifier = Modifier.fillMaxSize()) {
+            Box(
+                modifier =
+                    Modifier
+                        .fillMaxSize()
+                        .background(NearTheme.colors.WHITE_FFFFFF),
+            ) {
                 CircularProgressIndicator(
                     color = NearTheme.colors.BLUE01_5AA2E9,
                     modifier = Modifier.align(Alignment.Center),
@@ -83,7 +88,10 @@ fun ContactRoute(
 
         is ContactUiState.Error -> {
             Box(modifier = Modifier.fillMaxSize()) {
-                Text(modifier = Modifier.align(Alignment.Center), text = stringResource(R.string.contact_load_error))
+                Text(
+                    modifier = Modifier.align(Alignment.Center),
+                    text = stringResource(R.string.contact_load_error),
+                )
             }
         }