GETP-145 test: 회원 가입 시 이메일 인증 코드 전송 컨트롤러 단위 테스트 및 API 문서 작성 (#70)

src/docs/asciidoc/auth/send-email-verification-code-for-sign-up.adoc

@@ -0,0 +1 @@
+operation::send-email-verification-code-for-sign-up/send-email-verification-code-for-sign-up[snippets="http-request,http-response"]

src/docs/asciidoc/index.adoc

@@ -18,6 +18,7 @@ include::{docdir}/auth/signup.adoc[]
 include::{docdir}/auth/login.adoc[]
 
 === 회원 가입 시 이메일 인증 코드 전송
+include::{docdir}/auth/send-email-verification-code-for-sign-up.adoc[]
 
 === Access Token 및 Refresh Token 재발급
 include::{docdir}/auth/reissue-access-token.adoc[]

src/test/java/es/princip/getp/domain/auth/controller/SignUpControllerTest.java

@@ -1,5 +1,6 @@
 package es.princip.getp.domain.auth.controller;
 
+import es.princip.getp.domain.auth.dto.request.EmailVerificationCodeRequest;
 import es.princip.getp.domain.auth.dto.request.SignUpRequest;
 import es.princip.getp.domain.auth.exception.SignUpErrorCode;
 import es.princip.getp.domain.auth.service.SignUpService;
@@ -33,6 +34,27 @@ public class SignUpControllerTest extends AbstractControllerTest {
     @MockBean
     private SignUpService signUpService;
 
+    @Nested
+    @DisplayName("사용자는")
+    class SendEmailVerificationCodeForSignUp {
+
+        @DisplayName("회원 가입 시 이메일 인증을 해야 한다.")
+        @Test
+        void sendEmailVerificationCodeForSignUp() throws Exception {
+            mockMvc.perform(post("/auth/signup/email/send")
+            .content(objectMapper.writeValueAsString(SignUpFixture.createEmailVerificationCodeRequest())))
+            .andExpect(status().isOk())
+            .andDo(
+                restDocs.document(
+                    requestFields(
+                        getDescriptor("email", "이메일", EmailVerificationCodeRequest.class)
+                    )
+                )
+            )
+            .andDo(print());
+        }
+    }
+
     @Nested
     @DisplayName("사용자는")
     class SignUp {

src/test/java/es/princip/getp/domain/auth/support/SignUpFixture.java

@@ -1,5 +1,6 @@
 package es.princip.getp.domain.auth.support;
 
+import es.princip.getp.domain.auth.dto.request.EmailVerificationCodeRequest;
 import es.princip.getp.domain.auth.dto.request.SignUpRequest;
 import es.princip.getp.domain.auth.dto.response.SignUpResponse;
 import es.princip.getp.domain.member.domain.enums.MemberType;
@@ -44,4 +45,8 @@ public static SignUpResponse toSignUpResponse(final SignUpRequest request) {
             request.memberType()
         );
     }
+
+    public static EmailVerificationCodeRequest createEmailVerificationCodeRequest() {
+        return new EmailVerificationCodeRequest(EMAIL);
+    }
 }