이메일 인증 기능 구현

src/main/java/com/ampersand/groom/domain/auth/application/port/EmailVerificationPort.java

@@ -0,0 +1,21 @@
+package com.ampersand.groom.domain.auth.application.port;
+
+import com.ampersand.groom.domain.auth.persistence.EmailVerification;
+
+import java.time.LocalDateTime;
+import java.util.Optional;
+
+public interface EmailVerificationPort {
+
+    // 인증 정보 저장
+    EmailVerification save(EmailVerification emailVerification);
+
+    // 인증 코드로 이메일 조회
+    Optional<EmailVerification> findByCode(String code);
+
+    // 이메일로 인증 정보 조회
+    Optional<EmailVerification> findByEmail(String email);
+
+    // 만료된 인증 정보 삭제
+    void deleteAllExpired(LocalDateTime now);
+}

src/main/java/com/ampersand/groom/domain/auth/application/service/EmailSchedulingService.java

@@ -0,0 +1,23 @@
+package com.ampersand.groom.domain.auth.application.service;
+
+import com.ampersand.groom.domain.auth.application.port.EmailVerificationPort;
+import jakarta.transaction.Transactional;
+import lombok.RequiredArgsConstructor;
+import org.springframework.scheduling.annotation.Scheduled;
+import org.springframework.stereotype.Service;
+
+import java.time.LocalDateTime;
+
+@Service
+@RequiredArgsConstructor
+public class EmailSchedulingService {
+
+    private final EmailVerificationPort emailVerificationPort;
+
+    // 만료된 인증 정보 삭제(1시간)
+    @Scheduled(fixedRate = 3600000)
+    @Transactional
+    public void deleteExpiredVerifications() {
+        emailVerificationPort.deleteAllExpired(LocalDateTime.now());
+    }
+}

src/main/java/com/ampersand/groom/domain/auth/application/service/EmailVerificationService.java

@@ -0,0 +1,85 @@
+package com.ampersand.groom.domain.auth.application.service;
+
+import com.ampersand.groom.domain.auth.application.port.EmailVerificationPort;
+import com.ampersand.groom.domain.auth.expection.EmailFormatInvalidException;
+import com.ampersand.groom.domain.auth.expection.VerificationCodeFormatInvalidException;
+import com.ampersand.groom.domain.auth.expection.VerificationCodeExpiredOrInvalidException;
+import com.ampersand.groom.domain.auth.persistence.EmailVerification;
+import lombok.RequiredArgsConstructor;
+import org.springframework.mail.SimpleMailMessage;
+import org.springframework.mail.javamail.JavaMailSender;
+import org.springframework.stereotype.Service;
+
+import java.util.Random;
+
+@Service
+@RequiredArgsConstructor
+public class EmailVerificationService {
+
+    private final EmailVerificationPort emailVerificationPort;
+    private final JavaMailSender javaMailSender;
+
+    private static final int MAX_EMAIL_LENGTH = 16;
+    private static final int CODE_LENGTH = 8;
+
+
+    //8자리 숫자 인증 코드 생성
+    private String generateVerificationCode() {
+        Random random = new Random();
+        int code = 10000000 + random.nextInt(90000000);
+        return String.valueOf(code);
+    }
+
+    // 이메일 전송 메서드
+    private void sendEmail(String to, String subject, String text) {
+        SimpleMailMessage message = new SimpleMailMessage();
+        message.setTo(to);
+        message.setSubject(subject);
+        message.setText(text);
+        javaMailSender.send(message);
+    }
+
+    // 회원가입 인증 이메일 전송
+    public void sendSignupVerificationEmail(String email) {
+        verifyEmail(email);
+        String code = generateVerificationCode();
+        sendEmail(email, "회원가입 인증", "귀하의 인증 코드는: " + code);
+
+        EmailVerification emailVerification = new EmailVerification(email, code);
+
+        emailVerificationPort.save(emailVerification);
+    }
+
+    // 비밀번호 변경을 위한 인증 이메일 전송
+    public void sendPasswordResetEmail(String email) {
+        verifyEmail(email);
+        String code = generateVerificationCode();
+        sendEmail(email, "비밀번호 변경 인증", "귀하의 인증 코드는: " + code);
+
+        EmailVerification emailVerification = new EmailVerification(email, code);
+
+        emailVerificationPort.save(emailVerification);
+    }
+
+    // 인증 코드 검증
+    public void verifyCode(String code) {
+        if(code == null || code.length() != CODE_LENGTH) {
+            throw new VerificationCodeFormatInvalidException();
+        }
+
+        EmailVerification emailVerification = emailVerificationPort.findByCode(code)
+                .orElseThrow(VerificationCodeExpiredOrInvalidException::new);
+
+
+        emailVerification.setIsVerified(true);
+        emailVerificationPort.save(emailVerification);
+    }
+
+    // 이메일 검증
+    public void verifyEmail(String email) {
+        if(email == null || email.length() != MAX_EMAIL_LENGTH) {
+            throw new EmailFormatInvalidException();
+        }
+
+    }
+}

src/main/java/com/ampersand/groom/domain/auth/application/usecase/EmailVerificationUseCase.java

@@ -0,0 +1,29 @@
+package com.ampersand.groom.domain.auth.application.usecase;
+
+import com.ampersand.groom.domain.auth.application.service.EmailVerificationService;
+import com.ampersand.groom.global.annotation.usecase.UseCaseWithTransaction;
+import lombok.RequiredArgsConstructor;
+
+@UseCaseWithTransaction
+@RequiredArgsConstructor
+public class EmailVerificationUseCase {
+
+    private final EmailVerificationService emailVerificationService;
+
+
+    // 회원가입 인증 이메일 전송
+    public void executeSendSignupVerificationEmail(String email) {
+        emailVerificationService.sendSignupVerificationEmail(email);
+    }
+
+    // 비밀번호 변경 인증 이메일 전송
+    public void executeSendPasswordResetEmail(String email) {
+        emailVerificationService.sendPasswordResetEmail(email);
+    }
+
+    // 인증 코드 검증
+    public void executeVerifyCode(String code) {
+        emailVerificationService.verifyCode(code);
+    }
+
+}

src/main/java/com/ampersand/groom/domain/auth/expection/EmailFormatInvalidException.java

@@ -0,0 +1,10 @@
+package com.ampersand.groom.domain.auth.expection;
+
+import com.ampersand.groom.global.error.ErrorCode;
+import com.ampersand.groom.global.error.exception.GroomException;
+
+public class EmailFormatInvalidException extends GroomException {
+    public EmailFormatInvalidException() {
+        super(ErrorCode.EMAIL_FORMAT_INVALID);
+    }
+}

src/main/java/com/ampersand/groom/domain/auth/expection/VerificationCodeExpiredOrInvalidException.java

@@ -0,0 +1,10 @@
+package com.ampersand.groom.domain.auth.expection;
+
+import com.ampersand.groom.global.error.ErrorCode;
+import com.ampersand.groom.global.error.exception.GroomException;
+
+public class VerificationCodeExpiredOrInvalidException extends GroomException {
+    public VerificationCodeExpiredOrInvalidException() {
+        super(ErrorCode.VERIFICATION_CODE_EXPIRED_OR_INVALID);
+    }
+}

src/main/java/com/ampersand/groom/domain/auth/expection/VerificationCodeFormatInvalidException.java

@@ -0,0 +1,10 @@
+package com.ampersand.groom.domain.auth.expection;
+
+import com.ampersand.groom.global.error.ErrorCode;
+import com.ampersand.groom.global.error.exception.GroomException;
+
+public class VerificationCodeFormatInvalidException extends GroomException {
+    public VerificationCodeFormatInvalidException() {
+        super(ErrorCode.VERIFICATION_CODE_FORMAT_INVALID);
+    }
+}

src/main/java/com/ampersand/groom/domain/auth/persistence/EmailVerification.java

@@ -0,0 +1,48 @@
+package com.ampersand.groom.domain.auth.persistence;
+
+import jakarta.persistence.*;
+import lombok.*;
+
+import java.time.LocalDateTime;
+
+@Entity
+@Getter
+@NoArgsConstructor
+@Table(name = "email")
+@ToString
+public class EmailVerification {
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    private Long id;
+    @Column(nullable = false)
+    private String email;
+    @Column(nullable = false)
+    private String code;
+    @Column(nullable = false)
+    private boolean isVerified;
+    @Column(nullable = false)
+    private LocalDateTime verificationDate;
+
+    public EmailVerification(String email, String code) {
+        this.email = email;
+        this.code = code;
+        this.isVerified = false;
+        this.verificationDate = LocalDateTime.now().plusMinutes(5);
+    }
+
+
+    @Builder
+    public EmailVerification(Long id, String email, String code, boolean isVerified, LocalDateTime verificationDate) {
+        this.id = id;
+        this.email = email;
+        this.code = code;
+        this.isVerified = isVerified;
+        this.verificationDate = verificationDate;
+    }
+
+
+    public void setIsVerified(boolean isVerified) {
+        this.isVerified = isVerified;
+    }
+}

src/main/java/com/ampersand/groom/domain/auth/persistence/adapter/email/EmailVerificationAdapter.java

@@ -0,0 +1,38 @@
+package com.ampersand.groom.domain.auth.persistence.adapter.email;
+
+import com.ampersand.groom.domain.auth.application.port.EmailVerificationPort;
+
+import com.ampersand.groom.domain.auth.persistence.EmailVerification;
+import com.ampersand.groom.domain.auth.persistence.repository.JpaEmailVerificationRepository;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Component;
+
+import java.time.LocalDateTime;
+import java.util.Optional;
+
+@Component
+@RequiredArgsConstructor
+public class EmailVerificationAdapter implements EmailVerificationPort {
+
+    private final JpaEmailVerificationRepository jpaEmailVerificationRepository;
+
+    @Override
+    public EmailVerification save(EmailVerification emailVerification) {
+        return jpaEmailVerificationRepository.save(emailVerification);
+    }
+
+    @Override
+    public Optional<EmailVerification> findByCode(String code) {
+        return jpaEmailVerificationRepository.findByCode(code);
+    }
+
+    @Override
+    public Optional<EmailVerification> findByEmail(String email) {
+        return jpaEmailVerificationRepository.findByEmail(email);
+    }
+
+    @Override
+    public void deleteAllExpired(LocalDateTime now) {
+        jpaEmailVerificationRepository.deleteAllExpired(now);
+    }
+}

src/main/java/com/ampersand/groom/domain/auth/persistence/repository/JpaEmailVerificationRepository.java

@@ -0,0 +1,33 @@
+package com.ampersand.groom.domain.auth.persistence.repository;
+
+import com.ampersand.groom.domain.auth.persistence.EmailVerification;
+import lombok.RequiredArgsConstructor;
+import org.springframework.stereotype.Repository;
+
+import java.time.LocalDateTime;
+import java.util.Optional;
+
+@Repository
+@RequiredArgsConstructor
+public class JpaEmailVerificationRepository {
+
+    private final SpringDataEmailVerificationRepository repository;
+
+
+    public EmailVerification save(EmailVerification emailVerification) {
+        return repository.save(emailVerification);
+    }
+
+    public Optional<EmailVerification> findByCode(String code) {
+        return repository.findByCode(code);
+    }
+
+    public Optional<EmailVerification> findByEmail(String email) {
+        return repository.findByEmail(email);
+    }
+
+    public void deleteAllExpired(LocalDateTime now) {
+        repository.deleteAllExpired(now);
+    }
+
+}

src/main/java/com/ampersand/groom/domain/auth/persistence/repository/SpringDataEmailVerificationRepository.java

@@ -0,0 +1,23 @@
+package com.ampersand.groom.domain.auth.persistence.repository;
+
+import com.ampersand.groom.domain.auth.persistence.EmailVerification;
+import io.lettuce.core.dynamic.annotation.Param;
+import org.springframework.data.jpa.repository.JpaRepository;
+import org.springframework.data.jpa.repository.Modifying;
+import org.springframework.data.jpa.repository.Query;
+import org.springframework.stereotype.Repository;
+
+import java.time.LocalDateTime;
+import java.util.Optional;
+
+@Repository
+public interface SpringDataEmailVerificationRepository extends JpaRepository<EmailVerification, Long> {
+
+    Optional<EmailVerification> findByCode(String code);
+
+    Optional<EmailVerification> findByEmail(String email);
+
+    @Modifying
+    @Query("DELETE FROM EmailVerification e WHERE e.verificationDate < :now")
+    void deleteAllExpired(@Param("now") LocalDateTime now);
+}

src/main/java/com/ampersand/groom/domain/auth/presentation/controller/AuthController.java

@@ -0,0 +1,40 @@
+package com.ampersand.groom.domain.auth.presentation.controller;
+
+import com.ampersand.groom.domain.auth.application.usecase.EmailVerificationUseCase;
+import com.ampersand.groom.domain.auth.presentation.dto.EmailRequest;
+import com.ampersand.groom.domain.auth.presentation.dto.VerificationCodeRequest;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+
+@RestController
+@RequestMapping("/auth")
+@RequiredArgsConstructor
+public class AuthController {
+
+    private final EmailVerificationUseCase emailVerificationUseCase;
+
+    @PostMapping("/verify-email")
+    public ResponseEntity<?> verifyEmail(@RequestBody @Valid VerificationCodeRequest request) {
+        emailVerificationUseCase.executeVerifyCode(request.getCode());
+        return ResponseEntity.status(HttpStatus.RESET_CONTENT).body("Verification successful.");
+    }
+
+    @PostMapping("/signup/email")
+    public ResponseEntity<?> signup(@RequestBody @Valid EmailRequest request) {
+        emailVerificationUseCase.executeSendSignupVerificationEmail(request.getEmail());
+        return ResponseEntity.status(HttpStatus.RESET_CONTENT).body("Verification email sent");
+    }
+
+    @PostMapping("/password-change/email")
+    public ResponseEntity<?> refresh(@RequestBody @Valid EmailRequest request) {
+        emailVerificationUseCase.executeSendPasswordResetEmail(request.getEmail());
+        return ResponseEntity.status(HttpStatus.RESET_CONTENT).body("Verification email sent");
+    }
+}