[YS-256] feat: 회원가입 연락 받을 이메일 중복 비허용 로직 추가

src/main/kotlin/com/dobby/backend/application/service/MemberService.kt

@@ -12,6 +12,7 @@ class MemberService(
     private val memberGateway: MemberGateway,
     private val createParticipantUseCase: CreateParticipantUseCase,
     private val createResearcherUseCase: CreateResearcherUseCase,
+    private val verifyContactEmailUseCase: VerifyContactEmailUseCase,
     private val verifyResearcherEmailUseCase: VerifyResearcherEmailUseCase,
     private val getResearcherInfoUseCase: GetResearcherInfoUseCase,
     private val getParticipantInfoUseCase: GetParticipantInfoUseCase,
@@ -32,6 +33,11 @@ class MemberService(
         return createResearcherUseCase.execute(input)
     }
 
+    @Transactional
+    fun validateDuplicatedContactEmail(input: VerifyContactEmailUseCase.Input) : VerifyContactEmailUseCase.Output{
+        return verifyContactEmailUseCase.execute(input)
+    }
+
     @Transactional
     fun getResearcherInfo(input: GetResearcherInfoUseCase.Input): GetResearcherInfoUseCase.Output {
         return getResearcherInfoUseCase.execute(input)

src/main/kotlin/com/dobby/backend/application/usecase/member/VerifyContactEmailUseCase.kt

@@ -0,0 +1,24 @@
+package com.dobby.backend.application.usecase.member
+
+import com.dobby.backend.application.usecase.UseCase
+import com.dobby.backend.domain.exception.ContactEmailDuplicateException
+import com.dobby.backend.domain.gateway.member.MemberGateway
+
+class VerifyContactEmailUseCase(
+    private val memberGateway: MemberGateway
+): UseCase<VerifyContactEmailUseCase.Input, VerifyContactEmailUseCase.Output> {
+    data class Input(
+        val contactEmail: String
+    )
+
+    data class Output(
+        val success: Boolean
+    )
+
+    override fun execute(input: Input): Output {
+        if(!memberGateway.existsByContactEmail(input.contactEmail))
+            return Output(success = true)
+        else
+            throw ContactEmailDuplicateException
+    }
+}

src/main/kotlin/com/dobby/backend/domain/exception/DobbyException.kt

@@ -51,7 +51,7 @@ data object ResearcherNotFoundException : ClientException("ME0003", "Researcher
 data object ParticipantNotFoundException : ClientException("ME0004", "Participant Not Found.", HttpStatus.NOT_FOUND)
 data object EmailNotValidateException : ClientException("ME0005", "You should validate your school email first", HttpStatus.BAD_REQUEST)
 data object SignupOauthEmailDuplicateException : ClientException("ME0006", "You've already joined with requested oauth email", HttpStatus.CONFLICT)
-
+data object ContactEmailDuplicateException: ClientException("ME0007", "This contact email is already in use", HttpStatus.CONFLICT)
 /**
  * Experiment error codes
  */

src/main/kotlin/com/dobby/backend/domain/gateway/member/MemberGateway.kt

@@ -6,6 +6,7 @@ import com.dobby.backend.infrastructure.database.entity.enums.MemberStatus
 interface MemberGateway {
     fun getById(memberId: String): Member
     fun findById(memberId: String): Member?
+    fun existsByContactEmail(contactEmail: String): Boolean
     fun findByOauthEmailAndStatus(email: String, status: MemberStatus): Member?
     fun findByOauthEmail(email: String): Member?
     fun save(savedMember: Member) : Member

src/main/kotlin/com/dobby/backend/infrastructure/database/entity/member/MemberEntity.kt

@@ -30,7 +30,7 @@ class MemberEntity(
     @Enumerated(EnumType.STRING)
     val role: RoleType?,
 
-    @Column(name = "contact_email", length = 100, nullable = true)
+    @Column(name = "contact_email", length = 100, nullable = true, unique = true)
     val contactEmail: String?,
 
     @Column(name = "name", length = 10, nullable = true)

src/main/kotlin/com/dobby/backend/infrastructure/database/repository/MemberRepository.kt

@@ -6,5 +6,6 @@ import org.springframework.data.jpa.repository.JpaRepository
 
 interface MemberRepository : JpaRepository<MemberEntity, String> {
     fun findByOauthEmail(oauthEmail: String): MemberEntity?
+    fun existsByContactEmail(contactEmail: String): Boolean
     fun findByOauthEmailAndStatus(oauthEmail: String, status: MemberStatus): MemberEntity?
 }

src/main/kotlin/com/dobby/backend/infrastructure/gateway/member/MemberGatewayImpl.kt

@@ -24,6 +24,10 @@ class MemberGatewayImpl(
             .orElse(null)
     }
 
+    override fun existsByContactEmail(contactEmail: String): Boolean {
+        return memberRepository.existsByContactEmail(contactEmail)
+    }
+
     override fun findByOauthEmailAndStatus(email: String, status: MemberStatus): Member? {
         return memberRepository
             .findByOauthEmailAndStatus(email, status)

src/main/kotlin/com/dobby/backend/presentation/api/controller/MemberController.kt

@@ -1,10 +1,8 @@
 package com.dobby.backend.presentation.api.controller
 
 import com.dobby.backend.application.service.MemberService
-import com.dobby.backend.presentation.api.dto.request.member.ParticipantSignupRequest
-import com.dobby.backend.presentation.api.dto.request.member.ResearcherSignupRequest
-import com.dobby.backend.presentation.api.dto.request.member.UpdateParticipantInfoRequest
-import com.dobby.backend.presentation.api.dto.request.member.UpdateResearcherInfoRequest
+import com.dobby.backend.presentation.api.dto.request.member.*
+import com.dobby.backend.presentation.api.dto.response.member.DefaultResponse
 import com.dobby.backend.presentation.api.dto.response.member.ParticipantInfoResponse
 import com.dobby.backend.presentation.api.dto.response.member.ResearcherInfoResponse
 import com.dobby.backend.presentation.api.dto.response.member.SignupResponse
@@ -50,6 +48,19 @@ class MemberController(
         return MemberMapper.toResearcherSignupResponse(output)
     }
 
+    @GetMapping("/signup/validate/contact-email")
+    @Operation(
+        summary = "연락 받을 이메일 주소 검증 API - 회원가입 시 필수 API",
+        description = "연락 받을 이메일이 사용 가능한지 검증해주는 API입니다. 사용가능하면 true, 아니면 예외를 던집니다."
+    )
+    fun emailAvailableCheck(
+        @RequestParam contactEmail: String
+    ) : DefaultResponse {
+        val input = MemberMapper.toContactEmailVerificationInput(contactEmail)
+        val output = memberService.validateDuplicatedContactEmail(input)
+        return MemberMapper.toContactEmailVerificationResponse(output)
+    }
+
     @PreAuthorize("hasRole('RESEARCHER')")
     @GetMapping("/researchers/me")
     @Operation(

src/main/kotlin/com/dobby/backend/presentation/api/dto/request/member/ContactEmailVerificationRequest.kt

@@ -0,0 +1,12 @@
+package com.dobby.backend.presentation.api.dto.request.member
+
+import io.swagger.v3.oas.annotations.media.Schema
+import jakarta.validation.constraints.Email
+import jakarta.validation.constraints.NotBlank
+
+data class ContactEmailVerificationRequest (
+    @Email(message= "연락 받을 이메일이 유효하지 않습니다.")
+    @NotBlank(message = "연락 받을 이메일은 공백일 수 없습니다.")
+    @Schema(description = "연락 받을 이메일")
+    val contactEmail: String,
+)

src/main/kotlin/com/dobby/backend/presentation/api/mapper/MemberMapper.kt

@@ -4,10 +4,7 @@ import com.dobby.backend.application.usecase.member.*
 import com.dobby.backend.domain.model.member.Participant
 import com.dobby.backend.infrastructure.database.entity.enums.areaInfo.Area
 import com.dobby.backend.infrastructure.database.entity.enums.areaInfo.Region
-import com.dobby.backend.presentation.api.dto.request.member.ParticipantSignupRequest
-import com.dobby.backend.presentation.api.dto.request.member.ResearcherSignupRequest
-import com.dobby.backend.presentation.api.dto.request.member.UpdateParticipantInfoRequest
-import com.dobby.backend.presentation.api.dto.request.member.UpdateResearcherInfoRequest
+import com.dobby.backend.presentation.api.dto.request.member.*
 import com.dobby.backend.presentation.api.dto.response.member.*
 import com.dobby.backend.util.getCurrentMemberId
 
@@ -61,6 +58,18 @@ object MemberMapper {
         )
     }
 
+    fun toContactEmailVerificationInput(contactEmail: String): VerifyContactEmailUseCase.Input{
+        return VerifyContactEmailUseCase.Input(
+            contactEmail = contactEmail
+        )
+    }
+
+    fun toContactEmailVerificationResponse(output: VerifyContactEmailUseCase.Output): DefaultResponse{
+        return DefaultResponse(
+            success = output.success
+        )
+    }
+
     private fun toMemberResDto(input: Any): MemberResponse {
         return when (input) {
             is CreateResearcherUseCase.MemberResponse -> {

src/test/kotlin/com/dobby/backend/application/usecase/member/VerifyContactEmailUseCaseTest.kt

@@ -0,0 +1,41 @@
+package com.dobby.backend.application.usecase.member
+
+import com.dobby.backend.domain.exception.ContactEmailDuplicateException
+import com.dobby.backend.domain.gateway.member.MemberGateway
+import io.kotest.core.spec.style.BehaviorSpec
+import io.kotest.matchers.shouldBe
+import io.kotest.assertions.throwables.shouldThrow
+import io.mockk.every
+import io.mockk.mockk
+
+class VerifyContactEmailUseCaseTest : BehaviorSpec({
+
+    val memberGateway = mockk<MemberGateway>()
+    val verifyContactEmailUseCase = VerifyContactEmailUseCase(memberGateway)
+
+    given("회원 가입 시 이메일 중복 확인") {
+
+        `when`("이메일이 데이터베이스에 존재하지 않는 경우") {
+            val input = VerifyContactEmailUseCase.Input(contactEmail = "[email protected]")
+
+            every { memberGateway.existsByContactEmail(input.contactEmail) } returns false
+
+            then("이메일 사용 가능 응답을 반환해야 한다") {
+                val result = verifyContactEmailUseCase.execute(input)
+                result.success shouldBe true
+            }
+        }
+
+        `when`("이메일이 이미 존재하는 경우") {
+            val input = VerifyContactEmailUseCase.Input(contactEmail = "[email protected]")
+
+            every { memberGateway.existsByContactEmail(input.contactEmail) } returns true
+
+            then("ContactEmailDuplication 예외가 발생해야 한다") {
+                shouldThrow<ContactEmailDuplicateException> {
+                    verifyContactEmailUseCase.execute(input)
+                }
+            }
+        }
+    }
+})