feat: 사용자별 다중 디바이스 알림 전송 기능 추가 및 리팩토링 (#128)

* [BOOK-408] feat: apis - deviceId값을 통한 다중기기 알림기능 개발(#127)

* [BOOK-408] feat: apis - deviceId값을 통한 다중기기 알림기능 개발(#127)

* [BOOK-408] feat: batch - deviceId값을 통한 다중기기 알림기능 개발(#127)

* [BOOK-408] feat: domain - deviceId값을 통한 다중기기 알림기능 개발(#127)

* [BOOK-408] feat: infra - deviceId값을 통한 다중기기 알림기능 개발(#127)

* [BOOK-408] chore: batch - 사용하지 않는 import문 제거

* [BOOK-408] refactor: apis, infra, domain - 중복된 VO 제거

* [BOOK-408] refactor: domain - Device 클래스 구조를 재정비하고, 데이터 처리를 개선하기 위해 DeviceVO를 도입

* [BOOK-408] refactor: domain, infra - User 객체 대신 userId를 사용하도록 Notification 모델 수정 및 알림 관리를 위한 NotificationDomainService 도입

* [BOOK-408] chore: domain - ReadingRecordDomainService에 관한 TODO 주석처리

* [BOOK-408] refactor: batch, domain - FcmNotificationJobConfig를 NotificationService로 리팩토링하고, 알림 전송 로직을 분리하여 코드 가독성 및 유지보수성 향상

* [BOOK-408] fix: domain - 누락된 중괄호 추가

* [BOOK-408] chore: batch - InfraConfig에 AOP, SENTRY 추가

* [BOOK-408] chore: infra - dev 환경에서만 flyway를 비활성화 하도록 변경

* [BOOK-408] refactor: infra - resolve build error (#128)

---------

Co-authored-by: DongHoon Lee <[email protected]>

Author: minwoo1999

apis/src/main/kotlin/org/yapp/apis/auth/dto/response/UserIdResponse.kt

@@ -1,7 +1,7 @@
 package org.yapp.apis.auth.dto.response
 
 import io.swagger.v3.oas.annotations.media.Schema
-import org.yapp.domain.token.RefreshToken.UserId
+import org.yapp.domain.user.User
 import java.util.*
 
 @Schema(
@@ -13,7 +13,7 @@ data class UserIdResponse(
     val userId: UUID
 ) {
     companion object {
-        fun from(userId: UserId): UserIdResponse {
+        fun from(userId: User.Id): UserIdResponse {
             return UserIdResponse(userId.value)
         }
     }

apis/src/main/kotlin/org/yapp/apis/user/controller/UserController.kt

@@ -4,7 +4,7 @@ import jakarta.validation.Valid
 import org.springframework.http.ResponseEntity
 import org.springframework.security.core.annotation.AuthenticationPrincipal
 import org.springframework.web.bind.annotation.*
-import org.yapp.apis.user.dto.request.FcmTokenRequest
+import org.yapp.apis.user.dto.request.DeviceRequest
 import org.yapp.apis.user.dto.request.NotificationSettingsRequest
 import org.yapp.apis.user.dto.request.TermsAgreementRequest
 import org.yapp.apis.user.dto.response.UserProfileResponse
@@ -42,12 +42,12 @@ class UserController(
         return ResponseEntity.ok(userProfile)
     }
 
-    @PutMapping("/me/fcm-token")
-    override fun updateFcmToken(
+    @PutMapping("/me/devices")
+    override fun registerDevice(
         @AuthenticationPrincipal userId: UUID,
-        @Valid @RequestBody request: FcmTokenRequest
+        @Valid @RequestBody request: DeviceRequest
     ): ResponseEntity<UserProfileResponse> {
-        val userProfile = userUseCase.updateFcmToken(userId, request)
+        val userProfile = userUseCase.registerDevice(userId, request)
         return ResponseEntity.ok(userProfile)
     }
 }

apis/src/main/kotlin/org/yapp/apis/user/controller/UserControllerApi.kt

@@ -14,7 +14,7 @@ import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PutMapping
 import org.springframework.web.bind.annotation.RequestBody
 import org.springframework.web.bind.annotation.RequestMapping
-import org.yapp.apis.user.dto.request.FcmTokenRequest
+import org.yapp.apis.user.dto.request.DeviceRequest
 import org.yapp.apis.user.dto.request.NotificationSettingsRequest
 import org.yapp.apis.user.dto.request.TermsAgreementRequest
 import org.yapp.apis.user.dto.response.UserProfileResponse
@@ -122,14 +122,14 @@ interface UserControllerApi {
     ): ResponseEntity<UserProfileResponse>
 
     @Operation(
-        summary = "FCM 토큰 등록",
-        description = "사용자의 FCM 토큰을 등록합니다."
+        summary = "디바이스 등록",
+        description = "사용자의 디바이스를 등록합니다. 이미 등록된 디바이스인 경우 FCM 토큰을 업데이트합니다."
     )
     @ApiResponses(
         value = [
             ApiResponse(
                 responseCode = "200",
-                description = "FCM 토큰 등록 성공",
+                description = "디바이스 등록 또는 업데이트 성공",
                 content = [Content(schema = Schema(implementation = UserProfileResponse::class))]
             ),
             ApiResponse(
@@ -149,9 +149,9 @@ interface UserControllerApi {
             )
         ]
     )
-    @PutMapping("/me/fcm-token")
-    fun updateFcmToken(
+    @PutMapping("/me/devices")
+    fun registerDevice(
         @Parameter(hidden = true) @AuthenticationPrincipal userId: UUID,
-        @Valid @RequestBody @Parameter(description = "FCM 토큰 요청 객체") request: FcmTokenRequest
+        @Valid @RequestBody @Parameter(description = "디바이스 정보 요청 객체") request: DeviceRequest
     ): ResponseEntity<UserProfileResponse>
 }

…apis/user/dto/request/FcmTokenRequest.kt …p/apis/user/dto/request/DeviceRequest.ktapis/src/main/kotlin/org/yapp/apis/user/dto/request/FcmTokenRequest.kt renamed to apis/src/main/kotlin/org/yapp/apis/user/dto/request/DeviceRequest.kt apis/src/main/kotlin/org/yapp/apis/user/dto/request/FcmTokenRequest.kt renamed to apis/src/main/kotlin/org/yapp/apis/user/dto/request/DeviceRequest.kt

@@ -4,10 +4,18 @@ import io.swagger.v3.oas.annotations.media.Schema
 import jakarta.validation.constraints.NotBlank
 
 @Schema(
-    name = "FcmTokenRequest",
-    description = "DTO for FCM token update requests"
+    name = "DeviceRequest",
+    description = "DTO for device update requests"
 )
-data class FcmTokenRequest private constructor(
+data class DeviceRequest private constructor(
+    @field:Schema(
+        description = "디바이스 아이디",
+        example = "c8a9d7d0-4f6a-4b1a-8f0a-9d8e7f6a4b1a",
+        required = true
+    )
+    @field:NotBlank(message = "디바이스 아이디는 필수입니다.")
+    val deviceId: String? = null,
+
     @field:Schema(
         description = "FCM 토큰",
         example = "epGzIKlHScicTBrbt26pFG:APA91bG-ZPD-KMJyS-JOiflEPUIVvrp8l9DFBN2dlNG8IHw8mFlkAPok7dVPFJR4phc9061KPztkAIjBJaryZLnv6vIJXNGQsykzDcok3wFC9LrsC-F_aKY",
@@ -16,5 +24,6 @@ data class FcmTokenRequest private constructor(
     @field:NotBlank(message = "FCM 토큰은 필수입니다.")
     val fcmToken: String? = null
 ) {
+    fun validDeviceId(): String = deviceId!!.trim()
     fun validFcmToken(): String = fcmToken!!.trim()
 }

apis/src/main/kotlin/org/yapp/apis/user/service/UserService.kt

@@ -3,19 +3,21 @@ package org.yapp.apis.user.service
 import jakarta.validation.Valid
 import org.yapp.apis.auth.exception.AuthErrorCode
 import org.yapp.apis.auth.exception.AuthException
-import org.yapp.apis.user.dto.request.FcmTokenRequest
+import org.yapp.apis.user.dto.request.DeviceRequest
 import org.yapp.apis.user.dto.request.FindUserIdentityRequest
 import org.yapp.apis.user.dto.request.NotificationSettingsRequest
 import org.yapp.apis.user.dto.request.TermsAgreementRequest
 import org.yapp.apis.user.dto.response.UserAuthInfoResponse
 import org.yapp.apis.user.dto.response.UserProfileResponse
+import org.yapp.domain.device.DeviceDomainService
 import org.yapp.domain.user.UserDomainService
 import org.yapp.globalutils.annotation.ApplicationService
 import java.util.*
 
 @ApplicationService
 class UserService(
-    private val userDomainService: UserDomainService
+    private val userDomainService: UserDomainService,
+    private val deviceDomainService: DeviceDomainService
 ) {
     fun findUserProfileByUserId(userId: UUID): UserProfileResponse {
         val userProfile = userDomainService.findUserProfileById(userId)
@@ -45,9 +47,10 @@ class UserService(
         return UserProfileResponse.from(updatedUserProfile)
     }
 
-    fun updateFcmToken(userId: UUID, @Valid request: FcmTokenRequest): UserProfileResponse {
+    fun registerDevice(userId: UUID, @Valid request: DeviceRequest): UserProfileResponse {
         validateUserExists(userId)
-        val updatedUserProfile = userDomainService.updateFcmToken(userId, request.validFcmToken())
-        return UserProfileResponse.from(updatedUserProfile)
+        deviceDomainService.findOrCreateDevice(userId, request.validDeviceId(), request.validFcmToken())
+        val userProfile = userDomainService.findUserProfileById(userId)
+        return UserProfileResponse.from(userProfile)
     }
 }

apis/src/main/kotlin/org/yapp/apis/user/usecase/UserUseCase.kt

@@ -1,7 +1,7 @@
 package org.yapp.apis.user.usecase
 
 import org.springframework.transaction.annotation.Transactional
-import org.yapp.apis.user.dto.request.FcmTokenRequest
+import org.yapp.apis.user.dto.request.DeviceRequest
 import org.yapp.apis.user.dto.request.NotificationSettingsRequest
 import org.yapp.apis.user.dto.request.TermsAgreementRequest
 import org.yapp.apis.user.dto.response.UserProfileResponse
@@ -29,7 +29,7 @@ class UserUseCase(
     }
 
     @Transactional
-    fun updateFcmToken(userId: UUID, request: FcmTokenRequest): UserProfileResponse {
-        return userService.updateFcmToken(userId, request)
+    fun registerDevice(userId: UUID, request: DeviceRequest): UserProfileResponse {
+        return userService.registerDevice(userId, request)
     }
 }

batch/src/main/kotlin/org/yapp/batch/config/InfraConfig.kt

@@ -7,8 +7,9 @@ import org.yapp.infra.InfraBaseConfigGroup
 @Configuration(proxyBeanMethods = false)
 @EnableInfraBaseConfig(
     [
-        InfraBaseConfigGroup.JPA
+        InfraBaseConfigGroup.JPA,
+        InfraBaseConfigGroup.AOP,
+        InfraBaseConfigGroup.SENTRY
     ]
 )
-class InfraConfig {
-}
+class InfraConfig