[YS-68] feat: 연구자 회원가입 API 구현

src/main/kotlin/com/dobby/backend/DobbyBackendApplication.kt

@@ -18,6 +18,7 @@ import org.springframework.data.jpa.repository.config.EnableJpaAuditing
 @SpringBootApplication
 @ConfigurationPropertiesScan
 @EnableFeignClients
+@EnableJpaAuditing
 class DobbyBackendApplication
 
 fun main(args: Array<String>) {

src/main/kotlin/com/dobby/backend/application/mapper/VerificationMapper.kt

@@ -19,14 +19,14 @@ object VerificationMapper {
 
     fun toSendResDto() : EmailSendResponse{
         return EmailSendResponse(
-            isSucceess = true,
+            isSuccess = true,
             message = "해당 학교 이메일로 성공적으로 코드를 전송했습니다. 10분 이내로 인증을 완료해주세요."
         )
     }
 
     fun toVerifyResDto() : EmailVerificationResponse {
         return EmailVerificationResponse(
-            isSucceess = true,
+            isSuccess = true,
             message = "학교 메일 인증이 완료되었습니다."
         )
     }

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

@@ -24,7 +24,6 @@ class SignupService(
     @Transactional
     fun researcherSignup(input: ResearcherSignupRequest) : SignupResponse{
         if(!input.emailVerified) {
-            println("Email verification failed: ${input.univEmail}")
             throw EmailNotValidateException()
         }
         verifyResearcherEmailUseCase.execute(input.univEmail)

src/main/kotlin/com/dobby/backend/application/usecase/SignupUseCase/email/EmailCodeSendUseCase.kt

@@ -8,27 +8,35 @@ import com.dobby.backend.infrastructure.database.entity.enum.VerificationStatus
 import com.dobby.backend.infrastructure.database.repository.VerificationRepository
 import com.dobby.backend.presentation.api.dto.request.signup.EmailSendRequest
 import com.dobby.backend.presentation.api.dto.response.signup.EmailSendResponse
+import com.dobby.backend.util.EmailUtils
 import java.time.LocalDateTime
-import java.util.Hashtable
-import javax.naming.directory.InitialDirContext
-import javax.naming.directory.Attributes
 
 class EmailCodeSendUseCase(
     private val verificationRepository: VerificationRepository,
     private val emailGateway: EmailGateway
 ) : UseCase<EmailSendRequest, EmailSendResponse> {
     override fun execute(input: EmailSendRequest): EmailSendResponse {
-        if(!isDomainExists(input.univEmail)) throw EmailDomainNotFoundException()
-        if(!isUnivMail(input.univEmail)) throw EmailNotUnivException()
+        validateEmail(input.univEmail)
 
+        val code = EmailUtils.generateCode()
+        reflectVerification(input, code)
+
+        sendVerificationEmail(input, code)
+        return VerificationMapper.toSendResDto()
+    }
+
+    private fun validateEmail(email : String){
+        if(!EmailUtils.isDomainExists(email)) throw EmailDomainNotFoundException()
+        if(!EmailUtils.isUnivMail(email)) throw EmailNotUnivException()
+    }
+
+    private fun reflectVerification(input: EmailSendRequest, code: String) {
         val existingInfo = verificationRepository.findByUnivMail(input.univEmail)
-        val code = generateCode()
 
-        if(existingInfo != null) {
+        if (existingInfo != null) {
             when (existingInfo.status) {
                 VerificationStatus.HOLD -> {
                     existingInfo.verificationCode = code
-                    existingInfo.status = VerificationStatus.HOLD
                     existingInfo.expiresAt = LocalDateTime.now().plusMinutes(10)
                     verificationRepository.save(existingInfo)
                 }
@@ -37,61 +45,27 @@ class EmailCodeSendUseCase(
                     throw EmailAlreadyVerifiedException()
                 }
             }
-        }
-        else {
+        } else {
             val newVerificationInfo = VerificationMapper.toEntity(input, code)
             verificationRepository.save(newVerificationInfo)
         }
+    }
 
+    private fun sendVerificationEmail(input: EmailSendRequest, code: String) {
+        val content = EMAIL_CONTENT_TEMPLATE.format(code)
+        emailGateway.sendEmail(input.univEmail, EMAIL_SUBJECT, content)
+    }
 
-        val subject= "그라밋 - 이메일 인증 코드 입니다."
-        val content = """
+    companion object {
+        private const val EMAIL_SUBJECT = "그라밋 - 이메일 인증 코드 입니다."
+        private const val EMAIL_CONTENT_TEMPLATE = """
             안녕하세요, 그라밋입니다.
 
             아래의 코드는 이메일 인증을 위한 코드입니다:
 
-            $code
+            %s
 
             10분 이내에 인증을 완료해주세요.
-        """.trimIndent()
-        emailGateway.sendEmail(input.univEmail, subject, content)
-        return VerificationMapper.toSendResDto()
+        """
     }
-
-    private fun extractDomain(email:String): String {
-        if(!email.contains("@")) throw EmailFormatInvalidException()
-        return email.substringAfter("@")
-    }
-    private fun isDomainExists(email: String): Boolean {
-        val domain = extractDomain(email)
-        return try {
-            val env = Hashtable<String, String>()
-            env["java.naming.factory.initial"] = "com.sun.jndi.dns.DnsContextFactory"
-            val ctx = InitialDirContext(env)
-            val attributes: Attributes = ctx.getAttributes(domain, arrayOf("MX"))
-            val mxRecords = attributes.get("MX")
-            println("MX Records for $domain: $mxRecords")
-            mxRecords != null
-        } catch (ex: EmailDomainNotFoundException) {
-            println("DNS lookup failed for $domain: ${ex.message}")
-            false
-        }
-    }
-
-
-    private fun isUnivMail(email: String): Boolean {
-        val eduDomains = setOf(
-            "postech.edu",
-            "kaist.edu",
-            "handong.edu",
-            "ewhain.net"
-        )
-        return email.endsWith("@ac.kr") || eduDomains.any {email.endsWith(it)}
-    }
-
-    private fun generateCode() : String {
-        val randomNum = (0..999999).random()
-        return String.format("%06d", randomNum)
-    }
-
 }

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

@@ -14,9 +14,9 @@ import org.springframework.web.bind.annotation.RequestBody
 import org.springframework.web.bind.annotation.RequestMapping
 import org.springframework.web.bind.annotation.RestController
 
-@Tag(name = "이메일 인증 API - /v1/email")
+@Tag(name = "이메일 인증 API - /v1/emails")
 @RestController
-@RequestMapping("/v1/email")
+@RequestMapping("/v1/emails")
 class EmailController(
     private val emailService: EmailService
 ) {

src/main/kotlin/com/dobby/backend/presentation/api/dto/response/signup/EmailSendResponse.kt

@@ -4,7 +4,7 @@ import io.swagger.v3.oas.annotations.media.Schema
 
 data class EmailSendResponse(
     @Schema(description = "학교 이메일 인증을 성공하여, 코드를 성공적으로 전송했는지 여부입니다.")
-    val isSucceess: Boolean,
+    val isSuccess: Boolean,
 
     @Schema(description = "반환 성공 메시지 입니다.")
     val message : String

src/main/kotlin/com/dobby/backend/presentation/api/dto/response/signup/EmailVerificationResponse.kt

@@ -4,7 +4,7 @@ import io.swagger.v3.oas.annotations.media.Schema
 
 data class EmailVerificationResponse(
     @Schema(description = "학교 이메일 인증이 성공했는지 여부입니다.")
-    val isSucceess: Boolean,
+    val isSuccess: Boolean,
 
     @Schema(description = "인증 코드 인증 성공 메시지 입니다.")
     val message : String

src/main/kotlin/com/dobby/backend/util/EmailUtils.kt

@@ -0,0 +1,40 @@
+package com.dobby.backend.util
+
+import com.dobby.backend.domain.exception.EmailFormatInvalidException
+import java.util.*
+import javax.naming.directory.Attributes
+import javax.naming.directory.InitialDirContext
+
+object EmailUtils{
+    private fun extractDomain(email:String): String {
+        if(!email.contains("@")) throw EmailFormatInvalidException()
+        return email.substringAfter("@")
+    }
+    fun isDomainExists(email: String): Boolean {
+        val domain = extractDomain(email)
+        return try {
+            val env = Hashtable<String, String>()
+            env["java.naming.factory.initial"] = "com.sun.jndi.dns.DnsContextFactory"
+            val ctx = InitialDirContext(env)
+            val attributes: Attributes = ctx.getAttributes(domain, arrayOf("MX"))
+            val mxRecords = attributes["MX"]
+            mxRecords != null
+        } catch (ex: Exception) {
+            false
+        }
+    }
+
+    fun isUnivMail(email: String): Boolean {
+        val eduDomains = setOf(
+            "postech.edu",
+            "kaist.edu",
+            "handong.edu",
+            "ewhain.net"
+        )
+        return email.endsWith("@ac.kr") || eduDomains.any { email.endsWith(it) }
+    }
+    fun generateCode(): String {
+        val randomNum = (0..999999).random()
+        return String.format("%06d", randomNum)
+    }
+}

src/test/kotlin/com/dobby/backend/application/mapper/VerificationMapperTest.kt

@@ -31,7 +31,7 @@ class VerificationMapperTest : BehaviorSpec({
 
             then("EmailSendResponse 객체를 반환해야 한다") {
                 result shouldBe EmailSendResponse(
-                    isSucceess = true,
+                    isSuccess = true,
                     message = "해당 학교 이메일로 성공적으로 코드를 전송했습니다. 10분 이내로 인증을 완료해주세요."
                 )
             }
@@ -44,7 +44,7 @@ class VerificationMapperTest : BehaviorSpec({
 
             then("EmailVerificationResponse 객체를 반환해야 한다") {
                 result shouldBe EmailVerificationResponse(
-                    isSucceess = true,
+                    isSuccess = true,
                     message = "학교 메일 인증이 완료되었습니다."
                 )
             }

src/test/kotlin/com/dobby/backend/application/usecase/SignupUseCase/email/EmailCodeSendUseCaseTest.kt

@@ -41,7 +41,7 @@ class EmailCodeSendUseCaseTest : BehaviorSpec({
             val result = emailCodeSendUseCase.execute(request)
 
             then("정상적으로 EmailSendResponse를 반환해야 한다") {
-                result.isSucceess shouldBe true
+                result.isSuccess shouldBe true
             }
 
             then("save 메서드가 호출되어야 한다") {
@@ -61,12 +61,10 @@ class EmailCodeSendUseCaseTest : BehaviorSpec({
         val request = EmailSendRequest(univEmail = "[email protected]")
 
         `when`("코드 전송 요청을 하면") {
-            val exception = shouldThrow<EmailNotUnivException> {
-                emailCodeSendUseCase.execute(request)
-            }
-
             then("EmailNotUnivException 예외가 발생해야 한다") {
-                exception.message shouldBe "Email domain not found as university email"
+                val exception = shouldThrow<EmailNotUnivException> {
+                    emailCodeSendUseCase.execute(request)
+                }
             }
         }
     }

src/test/kotlin/com/dobby/backend/application/usecase/SignupUseCase/email/EmailVerificationUseCaseTest.kt

@@ -37,7 +37,7 @@ class EmailVerificationUseCaseTest : BehaviorSpec({
             val result = emailVerificationUseCase.execute(request)
 
             then("정상적으로 EmailVerificationResponse를 반환해야 한다") {
-                result.isSucceess shouldBe true
+                result.isSuccess shouldBe true
             }
 
             then("인증 상태가 VERIFIED로 업데이트되어야 한다") {
@@ -56,12 +56,10 @@ class EmailVerificationUseCaseTest : BehaviorSpec({
         coEvery { mockVerificationRepository.findByUnivMailAndStatus(request.univEmail, VerificationStatus.HOLD) } returns null
 
         `when`("EmailVerificationUseCase가 실행되면") {
-            val exception = shouldThrow<VerifyInfoNotFoundException> {
-                emailVerificationUseCase.execute(request)
-            }
-
             then("VerifyInfoNotFoundException 예외가 발생해야 한다") {
-                exception.message shouldBe "Verification information is not found"
+                val exception = shouldThrow<VerifyInfoNotFoundException> {
+                    emailVerificationUseCase.execute(request)
+                }
             }
         }
     }
@@ -79,12 +77,10 @@ class EmailVerificationUseCaseTest : BehaviorSpec({
         coEvery { mockVerificationRepository.findByUnivMailAndStatus(request.univEmail, VerificationStatus.HOLD) } returns mockEntity
 
         `when`("EmailVerificationUseCase가 실행되면") {
-            val exception = shouldThrow<CodeNotCorrectException> {
-                emailVerificationUseCase.execute(request)
-            }
-
             then("CodeNotCorrectException 예외가 발생해야 한다") {
-                exception.message shouldBe "Verification code is not correct"
+                val exception = shouldThrow<CodeNotCorrectException> {
+                    emailVerificationUseCase.execute(request)
+                }
             }
         }
     }
@@ -102,12 +98,10 @@ class EmailVerificationUseCaseTest : BehaviorSpec({
         coEvery { mockVerificationRepository.findByUnivMailAndStatus(request.univEmail, VerificationStatus.HOLD) } returns mockEntity
 
         `when`("EmailVerificationUseCase가 실행되면") {
-            val exception = shouldThrow<CodeExpiredException> {
-                emailVerificationUseCase.execute(request)
-            }
-
             then("CodeExpiredException 예외가 발생해야 한다") {
-                exception.message shouldBe "Verification code is expired"
+                val exception = shouldThrow<CodeExpiredException> {
+                    emailVerificationUseCase.execute(request)
+                }
             }
         }
     }