[TB-16] 이메일 인증 기능 (#20)

Author: tiemo0708

build.gradle

@@ -40,6 +40,7 @@ dependencies {
     implementation 'software.amazon.awssdk:s3:2.25.14'                       // aws s3 (버전 체크 필요)
     implementation 'com.auth0:java-jwt:4.4.0'
     implementation 'com.google.guava:guava:32.1.2-jre'
+    implementation 'org.springframework.boot:spring-boot-starter-mail'
 }
 
 tasks.withType(Test).configureEach {

src/main/java/com/ClubAccount_BE/auth/adapter/in/web/signin/SignInController.java

@@ -28,7 +28,7 @@ public TokenResponse signIn(@Valid @RequestBody SignInRequest signInRequest, Htt
                 .httpOnly(true)
                 .path("/")
                 .maxAge(Duration.ofDays(7))
-                .sameSite("None")
+                .sameSite("Lax")
                 .secure(false)
                 .build();
         response.addHeader(HttpHeaders.SET_COOKIE, cookie.toString());

src/main/java/com/ClubAccount_BE/auth/adapter/in/web/token/TokenController.java

@@ -31,7 +31,7 @@ public AccessTokenResponse createNewToken(
                 .httpOnly(true)
                 .path("/")
                 .maxAge(Duration.ofDays(7))
-                .sameSite("None")
+                .sameSite("Lax")
                 .secure(false)
                 .build();
 

src/main/java/com/ClubAccount_BE/core/config/SecurityConfig.java

@@ -39,6 +39,8 @@ public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
                     API_V1_PREFIX + "/users/password",
                     API_V1_PREFIX + "/health",
                     API_V1_PREFIX + "/users/sign-up/check-duplicate-auth-id",
+                    API_V1_PREFIX + "/email/send",
+                    API_V1_PREFIX + "/email/verify",
                     "/api-docs",
                     "/swagger-custom-ui.html",
                     "/v3/api-docs",

src/main/java/com/ClubAccount_BE/user/adapter/in/email/EmailApiPresentation.java

@@ -0,0 +1,20 @@
+package com.ClubAccount_BE.user.adapter.in.email;
+
+import com.ClubAccount_BE.user.adapter.in.email.dto.request.EmailSendRequest;
+import com.ClubAccount_BE.user.adapter.in.email.dto.request.EmailVerifyRequest;
+import com.ClubAccount_BE.user.adapter.in.email.dto.response.EmailVerifyResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.RequestBody;
+
+    @Tag(name = "Email", description = "이메일 인증 관련 API")
+    public interface EmailApiPresentation {
+
+        @Operation(summary = "이메일 인증 코드 전송")
+        ResponseEntity<Void> sendVerificationEmail(@Valid @RequestBody EmailSendRequest request);
+
+        @Operation(summary = "이메일 인증 코드 검증")
+        ResponseEntity<EmailVerifyResponse> verifyCode(@Valid @RequestBody EmailVerifyRequest request);
+    }

src/main/java/com/ClubAccount_BE/user/adapter/in/email/EmailController.java

@@ -0,0 +1,32 @@
+package com.ClubAccount_BE.user.adapter.in.email;
+
+import com.ClubAccount_BE.user.adapter.in.email.dto.request.EmailSendRequest;
+import com.ClubAccount_BE.user.adapter.in.email.dto.request.EmailVerifyRequest;
+import com.ClubAccount_BE.user.adapter.in.email.dto.response.EmailVerifyResponse;
+import com.ClubAccount_BE.user.application.service.email.EmailService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+@RestController
+@RequestMapping("/api/v1/email")
+@RequiredArgsConstructor
+public class EmailController implements EmailApiPresentation {
+
+    private final EmailService emailService;
+
+    @PostMapping("/send")
+    @Override
+    public ResponseEntity<Void> sendVerificationEmail(@RequestBody @Valid EmailSendRequest request) {
+        emailService.sendVerificationEmail(request.getEmail());
+        return ResponseEntity.ok().build();
+    }
+
+    @PostMapping(value = "/verify", produces = "application/json")
+    @Override
+    public ResponseEntity<EmailVerifyResponse> verifyCode(@RequestBody @Valid EmailVerifyRequest request) {
+            boolean verified = emailService.verifyCode(request.getEmail(), request.getCode());
+            return ResponseEntity.ok(new EmailVerifyResponse(verified, verified ? "✅ 인증 성공" : "❌ 인증 실패"));
+    }
+}

src/main/java/com/ClubAccount_BE/user/adapter/in/email/dto/request/EmailSendRequest.java

@@ -0,0 +1,16 @@
+package com.ClubAccount_BE.user.adapter.in.email.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class EmailSendRequest {
+    @NotBlank
+    @Email(message = "유효한 이메일 형식이 아닙니다.")
+    @Schema(name = "email", example = "thinkboo@example.com")
+    private String email;
+}

src/main/java/com/ClubAccount_BE/user/adapter/in/email/dto/request/EmailVerifyRequest.java

@@ -0,0 +1,22 @@
+package com.ClubAccount_BE.user.adapter.in.email.dto.request;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+
+@Getter
+@NoArgsConstructor
+public class EmailVerifyRequest {
+    @NotBlank
+    @Email(message = "유효한 이메일 형식이 아닙니다.")
+    @Schema(name = "email", example = "thinkboo@example.com")
+    private String email;
+
+    @NotBlank
+    @Schema(name = "code", example = "0A0012")
+    private String code;
+}
+

src/main/java/com/ClubAccount_BE/user/adapter/in/email/dto/response/EmailVerifyResponse.java

@@ -0,0 +1,16 @@
+package com.ClubAccount_BE.user.adapter.in.email.dto.response;
+
+import lombok.Getter;
+import lombok.NoArgsConstructor;
+
+@Getter
+@NoArgsConstructor
+public class EmailVerifyResponse {
+    private boolean success;
+    private String message;
+
+    public EmailVerifyResponse(boolean success, String message) {
+        this.success = success;
+        this.message = message;
+    }
+}

src/main/java/com/ClubAccount_BE/user/adapter/out/persistence/InMemoryVerificationAdapter.java

@@ -0,0 +1,23 @@
+package com.ClubAccount_BE.user.adapter.out.persistence;
+
+import com.ClubAccount_BE.user.adapter.out.persistence.repository.VerificationRepository;
+import com.ClubAccount_BE.user.application.port.out.email.VerificationCodePort;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+@RequiredArgsConstructor
+@Repository
+public class InMemoryVerificationAdapter implements VerificationCodePort {
+
+    private final VerificationRepository verificationRepository;
+
+    @Override
+    public void saveCode(String email, String code) {
+        verificationRepository.saveCode(email, code);
+    }
+
+    @Override
+    public String getCode(String email) {
+        return verificationRepository.getCode(email);
+    }
+}