회원탈퇴 API를 구현한다. (#109)

char-yb · web-flow · commit 535f7b84ac2e · 2025-08-16T19:57:58.000+09:00
* feat: withdrawal

* test: withdrawal

* fix: naming
diff --git a/api/src/main/kotlin/com/gotchai/api/presentation/v1/auth/AuthController.kt b/api/src/main/kotlin/com/gotchai/api/presentation/v1/auth/AuthController.kt
@@ -6,8 +6,10 @@ import com.gotchai.api.presentation.v1.auth.request.KakaoLoginRequest
 import com.gotchai.api.presentation.v1.auth.request.RefreshRequest
 import com.gotchai.api.presentation.v1.auth.response.RefreshResponse
 import com.gotchai.api.presentation.v1.auth.response.SocialLoginResponse
+import com.gotchai.api.presentation.v1.auth.response.WithdrawalResponse
 import com.gotchai.domain.auth.port.`in`.AuthCommandUseCase
 import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.web.bind.annotation.DeleteMapping
 import org.springframework.web.bind.annotation.PostMapping
 import org.springframework.web.bind.annotation.RequestBody
 import org.springframework.web.bind.annotation.RequestHeader
@@ -56,4 +58,13 @@ class AuthController(
         authCommandUseCase
             .refresh(deviceId, request.toCommand())
             .let { RefreshResponse.from(it) }
+
+    @DeleteMapping("/auth/withdrawal")
+    fun withdrawal(
+        @AuthenticationPrincipal
+        userId: Long
+    ): WithdrawalResponse =
+        authCommandUseCase
+            .withdrawal(userId)
+            .let { WithdrawalResponse("회원탈퇴가 완료되었습니다.") }
 }
diff --git a/api/src/main/kotlin/com/gotchai/api/presentation/v1/auth/response/WithdrawalResponse.kt b/api/src/main/kotlin/com/gotchai/api/presentation/v1/auth/response/WithdrawalResponse.kt
@@ -0,0 +1,5 @@
+package com.gotchai.api.presentation.v1.auth.response
+
+data class WithdrawalResponse(
+    val message: String
+)
diff --git a/api/src/main/kotlin/com/gotchai/api/presentation/v1/user/UserController.kt b/api/src/main/kotlin/com/gotchai/api/presentation/v1/user/UserController.kt
@@ -10,7 +10,7 @@ import org.springframework.web.bind.annotation.GetMapping
 class UserController(
     private val userQueryUseCase: UserQueryUseCase
 ) {
-    @GetMapping("/users/ranking")
+    @GetMapping("/users/me/ranking")
     fun getUserRanking(
         @AuthenticationPrincipal
         userId: Long
diff --git a/api/src/test/kotlin/com/gotchai/api/presentation/v1/auth/AuthControllerTest.kt b/api/src/test/kotlin/com/gotchai/api/presentation/v1/auth/AuthControllerTest.kt
@@ -8,6 +8,7 @@ import com.gotchai.api.fixture.createRefreshRequest
 import com.gotchai.api.global.dto.ApiResponse
 import com.gotchai.api.presentation.v1.auth.response.RefreshResponse
 import com.gotchai.api.presentation.v1.auth.response.SocialLoginResponse
+import com.gotchai.api.presentation.v1.auth.response.WithdrawalResponse
 import com.gotchai.api.util.document
 import com.gotchai.api.util.expectError
 import com.gotchai.domain.auth.exception.InvalidOAuthTokenException
@@ -233,5 +234,24 @@ class AuthControllerTest : ControllerTest() {
                 }
             }
         }
+
+        describe("withdrawal()은") {
+            context("로그인한 유저인 경우") {
+                every { authCommandUseCase.withdrawal(any()) } just runs
+
+                it("상태 코드 200과 WithdrawalResponse를 반환한다.") {
+                    webClient
+                        .delete()
+                        .uri("/api/v1/auth/withdrawal")
+                        .exchange()
+                        .expectStatus()
+                        .isOk
+                        .expectBody<ApiResponse<WithdrawalResponse>>()
+                        .document("회원탈퇴 성공(200)") {
+                            responseBody(withdrawalResponseFields)
+                        }
+                }
+            }
+        }
     }
 }
diff --git a/api/src/testFixtures/kotlin/com/gotchai/api/docs/AuthDocs.kt b/api/src/testFixtures/kotlin/com/gotchai/api/docs/AuthDocs.kt
@@ -5,6 +5,7 @@ import com.gotchai.api.presentation.v1.auth.request.KakaoLoginRequest
 import com.gotchai.api.presentation.v1.auth.request.RefreshRequest
 import com.gotchai.api.presentation.v1.auth.response.RefreshResponse
 import com.gotchai.api.presentation.v1.auth.response.SocialLoginResponse
+import com.gotchai.api.presentation.v1.auth.response.WithdrawalResponse
 import com.gotchai.api.util.desc
 import com.gotchai.api.util.fieldsOf
 
@@ -28,3 +29,6 @@ val socialLoginResponseFields =
         SocialLoginResponse::accessToken desc "액세스 토큰",
         SocialLoginResponse::refreshToken desc "리프레시 토큰"
     )
+
+val withdrawalResponseFields =
+    fieldsOf(WithdrawalResponse::message desc "회원탈퇴 메시지")
diff --git a/domain/src/main/kotlin/com/gotchai/domain/auth/adapter/in/AuthCommandService.kt b/domain/src/main/kotlin/com/gotchai/domain/auth/adapter/in/AuthCommandService.kt
@@ -123,13 +123,12 @@ class AuthCommandService(
                     )
                 )
 
-            val profile =
-                profileCommandPort.createProfile(
-                    Profile.Creation(
-                        userId = user.id,
-                        nickname = nickname
-                    )
+            profileCommandPort.createProfile(
+                Profile.Creation(
+                    userId = user.id,
+                    nickname = nickname
                 )
+            )
 
             return user
         }
@@ -163,6 +162,14 @@ class AuthCommandService(
         refreshTokenCommandPort.deleteRefreshTokenByUserId(userId)
     }
 
+    @Transactional
+    override fun withdrawal(userId: Long) {
+        userCommandPort.deleteByUserId(userId)
+        userSocialCommandPort.deleteByUserId(userId)
+        profileCommandPort.deleteByUserId(userId)
+        refreshTokenCommandPort.deleteRefreshTokenByUserId(userId)
+    }
+
     private fun createAccessAndRefreshToken(
         deviceId: String?,
         authentication: GotchaiAuthentication
diff --git a/domain/src/main/kotlin/com/gotchai/domain/auth/port/in/AuthCommandUseCase.kt b/domain/src/main/kotlin/com/gotchai/domain/auth/port/in/AuthCommandUseCase.kt
@@ -28,4 +28,6 @@ interface AuthCommandUseCase {
     ): RefreshResult
 
     fun logout(userId: Long)
+
+    fun withdrawal(userId: Long)
 }
diff --git a/domain/src/main/kotlin/com/gotchai/domain/user/port/out/ProfileCommandPort.kt b/domain/src/main/kotlin/com/gotchai/domain/user/port/out/ProfileCommandPort.kt
@@ -4,4 +4,6 @@ import com.gotchai.domain.user.entity.Profile
 
 interface ProfileCommandPort {
     fun createProfile(creation: Profile.Creation): Profile
+
+    fun deleteByUserId(userId: Long)
 }
diff --git a/domain/src/main/kotlin/com/gotchai/domain/user/port/out/UserCommandPort.kt b/domain/src/main/kotlin/com/gotchai/domain/user/port/out/UserCommandPort.kt
@@ -4,4 +4,6 @@ import com.gotchai.domain.user.entity.User
 
 interface UserCommandPort {
     fun createUser(creation: User.Creation): User
+
+    fun deleteByUserId(userId: Long)
 }
diff --git a/domain/src/main/kotlin/com/gotchai/domain/user/port/out/UserSocialCommandPort.kt b/domain/src/main/kotlin/com/gotchai/domain/user/port/out/UserSocialCommandPort.kt
@@ -4,4 +4,6 @@ import com.gotchai.domain.user.entity.UserSocial
 
 interface UserSocialCommandPort {
     fun createUserSocial(creation: UserSocial.Creation): UserSocial
+
+    fun deleteByUserId(userId: Long)
 }
diff --git a/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/ProfileCommandAdapter.kt b/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/ProfileCommandAdapter.kt
@@ -3,15 +3,22 @@ package com.gotchai.storage.rdb.user.adapter.out
 import com.gotchai.domain.user.entity.Profile
 import com.gotchai.domain.user.port.out.ProfileCommandPort
 import com.gotchai.storage.rdb.global.annotation.Adapter
+import com.gotchai.storage.rdb.global.util.findByIdOrElseThrow
 import com.gotchai.storage.rdb.user.entity.ProfileEntity
 import com.gotchai.storage.rdb.user.repository.ProfileJpaRepository
 
 @Adapter
 class ProfileCommandAdapter(
-    private val profileRepository: ProfileJpaRepository
+    private val profileJpaRepository: ProfileJpaRepository
 ) : ProfileCommandPort {
     override fun createProfile(creation: Profile.Creation): Profile =
-        profileRepository
+        profileJpaRepository
             .save(ProfileEntity.from(creation))
             .toProfile()
+
+    override fun deleteByUserId(userId: Long) {
+        profileJpaRepository
+            .findByIdOrElseThrow(userId)
+            .softDelete()
+    }
 }
diff --git a/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/UserCommandAdapter.kt b/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/UserCommandAdapter.kt
@@ -3,15 +3,22 @@ package com.gotchai.storage.rdb.user.adapter.out
 import com.gotchai.domain.user.entity.User
 import com.gotchai.domain.user.port.out.UserCommandPort
 import com.gotchai.storage.rdb.global.annotation.Adapter
+import com.gotchai.storage.rdb.global.util.findByIdOrElseThrow
 import com.gotchai.storage.rdb.user.entity.UserEntity
 import com.gotchai.storage.rdb.user.repository.UserJpaRepository
 
 @Adapter
 class UserCommandAdapter(
-    private val userRepository: UserJpaRepository
+    private val userJpaRepository: UserJpaRepository
 ) : UserCommandPort {
     override fun createUser(creation: User.Creation): User =
-        userRepository
+        userJpaRepository
             .save(UserEntity.from(creation))
             .toUser()
+
+    override fun deleteByUserId(userId: Long) {
+        userJpaRepository
+            .findByIdOrElseThrow(userId)
+            .softDelete()
+    }
 }
diff --git a/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/UserSocialCommandAdapter.kt b/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/UserSocialCommandAdapter.kt
@@ -3,15 +3,22 @@ package com.gotchai.storage.rdb.user.adapter.out
 import com.gotchai.domain.user.entity.UserSocial
 import com.gotchai.domain.user.port.out.UserSocialCommandPort
 import com.gotchai.storage.rdb.global.annotation.Adapter
+import com.gotchai.storage.rdb.global.util.findByIdOrElseThrow
 import com.gotchai.storage.rdb.user.entity.UserSocialEntity
 import com.gotchai.storage.rdb.user.repository.UserSocialJpaRepository
 
 @Adapter
 class UserSocialCommandAdapter(
-    private val userSocialRepository: UserSocialJpaRepository
+    private val userSocialJpaRepository: UserSocialJpaRepository
 ) : UserSocialCommandPort {
     override fun createUserSocial(creation: UserSocial.Creation): UserSocial =
-        userSocialRepository
+        userSocialJpaRepository
             .save(UserSocialEntity.from(creation))
             .toUserSocial()
+
+    override fun deleteByUserId(userId: Long) {
+        userSocialJpaRepository
+            .findByIdOrElseThrow(userId)
+            .softDelete()
+    }
 }
diff --git a/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/UserSocialQueryAdapter.kt b/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/adapter/out/UserSocialQueryAdapter.kt
@@ -8,11 +8,11 @@ import com.gotchai.storage.rdb.user.repository.UserSocialJpaRepository
 
 @Adapter
 class UserSocialQueryAdapter(
-    private val userSocialRepository: UserSocialJpaRepository
+    private val userSocialJpaRepository: UserSocialJpaRepository
 ) : UserSocialQueryPort {
     @ReadOnlyTransactional
     override fun getUserSocialBySocialId(socialId: String): UserSocial? =
-        userSocialRepository
-            .findBySocialId(socialId)
+        userSocialJpaRepository
+            .findBySocialIdAndDeletedAtIsNull(socialId)
             ?.toUserSocial()
 }
diff --git a/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/repository/UserSocialJpaRepository.kt b/storage/rdb/src/main/kotlin/com/gotchai/storage/rdb/user/repository/UserSocialJpaRepository.kt
@@ -4,5 +4,5 @@ import com.gotchai.storage.rdb.user.entity.UserSocialEntity
 import org.springframework.data.jpa.repository.JpaRepository
 
 interface UserSocialJpaRepository : JpaRepository<UserSocialEntity, Long> {
-    fun findBySocialId(socialId: String): UserSocialEntity?
+    fun findBySocialIdAndDeletedAtIsNull(socialId: String): UserSocialEntity?
 }

Original file line number	Diff line number	Diff line change
`@@ -28,4 +28,6 @@ interface AuthCommandUseCase {`
`28`	`28`	`): RefreshResult`
`29`	`29`
`30`	`30`	`fun logout(userId: Long)`
	`31`	`+`
	`32`	`+ fun withdrawal(userId: Long)`
`31`	`33`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,6 @@ import com.gotchai.domain.user.entity.Profile`
`4`	`4`
`5`	`5`	`interface ProfileCommandPort {`
`6`	`6`	`fun createProfile(creation: Profile.Creation): Profile`
	`7`	`+`
	`8`	`+ fun deleteByUserId(userId: Long)`
`7`	`9`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,6 @@ import com.gotchai.domain.user.entity.User`
`4`	`4`
`5`	`5`	`interface UserCommandPort {`
`6`	`6`	`fun createUser(creation: User.Creation): User`
	`7`	`+`
	`8`	`+ fun deleteByUserId(userId: Long)`
`7`	`9`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,4 +4,6 @@ import com.gotchai.domain.user.entity.UserSocial`
`4`	`4`
`5`	`5`	`interface UserSocialCommandPort {`
`6`	`6`	`fun createUserSocial(creation: UserSocial.Creation): UserSocial`
	`7`	`+`
	`8`	`+ fun deleteByUserId(userId: Long)`
`7`	`9`	`}`