refactor: 인증 도메인 리팩토링

apis/src/main/kotlin/org/yapp/apis/auth/controller/AuthController.kt

@@ -22,14 +22,13 @@ class AuthController(
 
     @PostMapping("/signin")
     override fun signIn(@RequestBody @Valid request: SocialLoginRequest): ResponseEntity<AuthResponse> {
-        val credentials = SocialLoginRequest.toCredentials(request)
-        val tokenPair = authUseCase.signIn(credentials)
+        val tokenPair = authUseCase.signIn(request)
         return ResponseEntity.ok(AuthResponse.fromTokenPair(tokenPair))
     }
 
     @PostMapping("/refresh")
     override fun refreshToken(@RequestBody @Valid request: TokenRefreshRequest): ResponseEntity<AuthResponse> {
-        val tokenPair = authUseCase.reissueTokenPair(request.validRefreshToken())
+        val tokenPair = authUseCase.reissueTokenPair(request)
         return ResponseEntity.ok(AuthResponse.fromTokenPair(tokenPair))
     }
 

apis/src/main/kotlin/org/yapp/apis/auth/controller/AuthControllerApi.kt

@@ -12,16 +12,14 @@ import org.springframework.security.core.annotation.AuthenticationPrincipal
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
-import org.springframework.web.bind.annotation.RequestMapping
 import org.yapp.apis.auth.dto.request.SocialLoginRequest
 import org.yapp.apis.auth.dto.request.TokenRefreshRequest
 import org.yapp.apis.auth.dto.response.AuthResponse
 import org.yapp.apis.auth.dto.response.UserProfileResponse
 import org.yapp.globalutils.exception.ErrorResponse
-import java.util.UUID
+import java.util.*
 
 @Tag(name = "Authentication", description = "Authentication API")
-@RequestMapping("/api/v1/auth")
 interface AuthControllerApi {
 
     @Operation(

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/DeleteTokenRequest.kt

@@ -0,0 +1,23 @@
+package org.yapp.apis.auth.dto.request
+
+import io.swagger.v3.oas.annotations.media.Schema
+import jakarta.validation.constraints.NotBlank
+import org.yapp.apis.auth.dto.response.RefreshTokenResponse
+
+@Schema(
+    name = "DeleteTokenRequest",
+    description = "Request DTO for deleting a refresh token"
+)
+data class DeleteTokenRequest(
+    @field:NotBlank(message = "Refresh token must not be blank.")
+    @Schema(description = "Refresh token to be deleted", example = "eyJhbGciOiJIUz...")
+    val refreshToken: String? = null
+) {
+    fun validRefreshToken() = refreshToken!!
+
+    companion object {
+        fun from(refreshTokenResponse: RefreshTokenResponse): DeleteTokenRequest {
+            return DeleteTokenRequest(refreshToken = refreshTokenResponse.refreshToken)
+        }
+    }
+}

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/FindOrCreateUserRequest.kt

@@ -0,0 +1,71 @@
+package org.yapp.apis.auth.dto.request
+
+import io.swagger.v3.oas.annotations.media.Schema
+import jakarta.validation.constraints.NotBlank
+import org.yapp.apis.auth.dto.response.UserCreateInfoResponse
+import org.yapp.apis.util.NicknameGenerator
+import org.yapp.domain.user.ProviderType
+
+@Schema(
+    name = "FindOrCreateUserRequest",
+    description = "Request DTO for finding an existing user or creating a new one during social login"
+)
+data class FindOrCreateUserRequest private constructor(
+    @Schema(
+        description = "사용자 이메일",
+        example = "[email protected]", nullable = true)
+    val email: String? = null,
+
+    @Schema(
+        description = "사용자 닉네임",
+        example = "코딩하는곰",
+        nullable = true
+    )
+    val nickname: String? = null,
+
+    @Schema(
+        description = "사용자 프로필 이미지 URL",
+        example = "https://example.com/image.jpg",
+        nullable = true
+    )
+    val profileImageUrl: String? = null,
+
+    @Schema(
+        description = "소셜 로그인 제공자",
+        example = "KAKAO"
+    )
+    @field:NotBlank(message = "providerType은 필수입니다.")
+    val providerType: ProviderType? = null,
+
+    @Schema(
+        description = "소셜 제공자에서 발급한 식별자",
+        example = "12345678901234567890"
+    )
+    @field:NotBlank(message = "providerId는 필수입니다.")
+    val providerId: String? = null
+) {
+    fun getOrDefaultEmail(): String {
+        return email?.takeIf { it.isNotBlank() } ?: "${validProviderId()}@${validProviderType().name.lowercase()}.local"
+    }
+
+    fun getOrDefaultNickname(): String {
+        return nickname?.takeIf { it.isNotBlank() } ?: NicknameGenerator.generate()
+    }
+
+    fun validProviderType(): ProviderType = providerType!!
+    fun validProviderId(): String = providerId!!
+
+    companion object {
+        fun from(
+            userCreateInfoResponse: UserCreateInfoResponse
+        ): FindOrCreateUserRequest {
+            return FindOrCreateUserRequest(
+                email = userCreateInfoResponse.email,
+                nickname = userCreateInfoResponse.nickname,
+                profileImageUrl = userCreateInfoResponse.profileImageUrl,
+                providerType = userCreateInfoResponse.providerType,
+                providerId = userCreateInfoResponse.providerId
+            )
+        }
+    }
+}

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/FindUserIdentityRequest.kt

@@ -0,0 +1,27 @@
+package org.yapp.apis.auth.dto.request
+
+import io.swagger.v3.oas.annotations.media.Schema
+import jakarta.validation.constraints.NotNull
+import org.yapp.apis.auth.dto.response.UserIdResponse
+import java.util.*
+
+@Schema(
+    name = "FindUserIdentityRequest",
+    description = "Request DTO to retrieve user identity information using userId"
+)
+data class FindUserIdentityRequest(
+    @Schema(
+        description = "User ID (UUID format)",
+        example = "a1b2c3d4-e5f6-7890-1234-56789abcdef0"
+    )
+    @field:NotNull(message = "userId must not be null")
+    val userId: UUID? = null
+) {
+    fun validUserId(): UUID = userId!!
+
+    companion object {
+        fun from(userIdResponse: UserIdResponse): FindUserIdentityRequest {
+            return FindUserIdentityRequest(userIdResponse.userId)
+        }
+    }
+}

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/GenerateTokenPairRequest.kt

@@ -0,0 +1,48 @@
+package org.yapp.apis.auth.dto.request
+
+import io.swagger.v3.oas.annotations.media.Schema
+import jakarta.validation.constraints.NotBlank
+import org.yapp.apis.auth.dto.response.CreateUserResponse
+import org.yapp.apis.auth.dto.response.UserAuthInfoResponse
+import org.yapp.globalutils.auth.Role
+import java.util.UUID
+
+@Schema(
+    name = "GenerateTokenPairRequest",
+    description = "Request DTO to generate a new pair of access and refresh tokens"
+)
+data class GenerateTokenPairRequest private constructor(
+    @Schema(
+        description = "User ID",
+        example = "a1b2c3d4-e5f6-7890-1234-56789abcdef0"
+    )
+    @field:NotBlank(message = "userId must not be null")
+    val userId: UUID? = null,
+
+    @Schema(
+        description = "User role",
+        example = "USER"
+    )
+    @field:NotBlank(message = "role must not be null")
+    val role: Role? = null
+) {
+
+    fun validUserId(): UUID = userId!!
+    fun validRole(): Role = role!!
+
+    companion object {
+        fun from(response: CreateUserResponse): GenerateTokenPairRequest {
+            return GenerateTokenPairRequest(
+                userId = response.id,
+                role = response.role
+            )
+        }
+
+        fun from(response: UserAuthInfoResponse): GenerateTokenPairRequest {
+            return GenerateTokenPairRequest(
+                userId = response.id,
+                role = response.role
+            )
+        }
+    }
+}

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/SocialLoginRequest.kt

@@ -2,9 +2,9 @@ package org.yapp.apis.auth.dto.request
 
 import io.swagger.v3.oas.annotations.media.Schema
 import jakarta.validation.constraints.NotBlank
-import org.yapp.apis.auth.dto.AppleAuthCredentials
-import org.yapp.apis.auth.dto.AuthCredentials
-import org.yapp.apis.auth.dto.KakaoAuthCredentials
+import org.yapp.apis.auth.strategy.AppleAuthCredentials
+import org.yapp.apis.auth.strategy.AuthCredentials
+import org.yapp.apis.auth.strategy.KakaoAuthCredentials
 import org.yapp.apis.auth.exception.AuthErrorCode
 import org.yapp.apis.auth.exception.AuthException
 import org.yapp.domain.user.ProviderType
@@ -14,11 +14,19 @@ import org.yapp.domain.user.ProviderType
     description = "DTO for social login requests"
 )
 data class SocialLoginRequest private constructor(
-    @Schema(description = "Type of social login provider", example = "KAKAO", required = true)
+    @Schema(
+        description = "Type of social login provider",
+        example = "KAKAO",
+        required = true
+    )
     @field:NotBlank(message = "Provider type is required")
     val providerType: String? = null,
 
-    @Schema(description = "OAuth token issued by the social provider", example = "eyJ...", required = true)
+    @Schema(
+        description = "OAuth token issued by the social provider",
+        example = "eyJ...",
+        required = true
+    )
     @field:NotBlank(message = "OAuth token is required")
     val oauthToken: String? = null
 ) {

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/TokenGenerateRequest.kt

@@ -0,0 +1,41 @@
+package org.yapp.apis.auth.dto.request
+
+import io.swagger.v3.oas.annotations.media.Schema
+import jakarta.validation.constraints.NotBlank
+import jakarta.validation.constraints.NotNull
+import java.util.*
+
+@Schema(
+    name = "TokenGenerateRequest",
+    description = "DTO containing information required to save the generated refresh token"
+)
+data class TokenGenerateRequest(
+    @field:NotNull(message = "userId must not be null")
+    @Schema(description = "User ID", example = "f6b7d490-1b1a-4b9f-8e8e-27f8e3a5dafa")
+    val userId: UUID? = null,
+
+    @field:NotBlank(message = "refreshToken must not be blank")
+    @Schema(description = "Generated refresh token", example = "eyJhbGciOiJIUzI1NiIsInR...")
+    val refreshToken: String? = null,
+
+    @field:NotNull(message = "expiration must not be null")
+    @Schema(description = "Refresh token expiration time (in seconds)", example = "2592000")
+    val expiration: Long? = null
+) {
+    fun validUserId() = userId!!
+    fun validRefreshToken() = refreshToken!!
+    fun validExpiration() = expiration!!
+
+    companion object {
+        fun of(userId: UUID, refreshToken: String, expiration: Long): TokenGenerateRequest {
+            require(refreshToken.isNotBlank()) { "Refresh token must not be blank." }
+            require(expiration > 0) { "Expiration must be greater than 0." }
+
+            return TokenGenerateRequest(
+                userId = userId,
+                refreshToken = refreshToken,
+                expiration = expiration
+            )
+        }
+    }
+}

apis/src/main/kotlin/org/yapp/apis/auth/dto/request/TokenRefreshRequest.kt

@@ -8,13 +8,12 @@ import jakarta.validation.constraints.NotBlank
     description = "DTO for requesting an access token using a refresh token"
 )
 data class TokenRefreshRequest private constructor(
-
-    @field:NotBlank(message = "Refresh token is required")
     @Schema(
         description = "Valid refresh token issued during previous authentication",
         example = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
         required = true
     )
+    @field:NotBlank(message = "Refresh token is required")
     val refreshToken: String? = null
 ) {
     fun validRefreshToken(): String = refreshToken!!

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

@@ -21,8 +21,7 @@ data class AuthResponse private constructor(
     val refreshToken: String
 ) {
     companion object {
-        fun fromTokenPair(
-            tokenPairResponse: TokenPairResponse)
+        fun fromTokenPair(tokenPairResponse: TokenPairResponse)
         : AuthResponse {
             return AuthResponse(
                 accessToken = tokenPairResponse.accessToken,

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

@@ -0,0 +1,33 @@
+package org.yapp.apis.auth.dto.response
+
+import io.swagger.v3.oas.annotations.media.Schema
+import org.yapp.domain.user.vo.UserIdentityVO
+import org.yapp.globalutils.auth.Role
+import java.util.UUID
+
+@Schema(
+    name = "CreateUserResponse",
+    description = "Response DTO returned after successful user registration"
+)
+data class CreateUserResponse private constructor(
+    @Schema(
+        description = "사용자 ID",
+        example = "a1b2c3d4-e5f6-7890-1234-56789abcdef0"
+    )
+    val id: UUID,
+
+    @Schema(
+        description = "사용자 역할",
+        example = "USER"
+    )
+    val role: Role
+) {
+    companion object {
+        fun from(identity: UserIdentityVO): CreateUserResponse {
+            return CreateUserResponse(
+                id = identity.id.value,
+                role = identity.role
+            )
+        }
+    }
+}

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

@@ -0,0 +1,19 @@
+package org.yapp.apis.auth.dto.response
+
+import io.swagger.v3.oas.annotations.media.Schema
+import org.yapp.domain.token.RefreshToken.Token
+
+@Schema(
+    name = "RefreshTokenResponse",
+    description = "Response DTO containing the issued refresh token"
+)
+data class RefreshTokenResponse(
+    @Schema(description = "The refresh token string", example = "eyJhbGciOiJIUz...")
+    val refreshToken: String
+) {
+    companion object {
+        fun from(token: Token): RefreshTokenResponse {
+            return RefreshTokenResponse(refreshToken = token.value)
+        }
+    }
+}