Feat/#10

build.gradle

@@ -53,6 +53,9 @@ dependencies {
 	//swagger
 	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.0'
 	implementation 'org.springdoc:springdoc-openapi-starter-webmvc-api:2.8.0'
+
+	//Email
+	implementation 'org.springframework.boot:spring-boot-starter-mail'
 }
 
 tasks.named('test') {

src/main/java/com/whereyouad/WhereYouAd/domains/user/application/dto/request/EmailRequest.java

@@ -0,0 +1,11 @@
+package com.whereyouad.WhereYouAd.domains.user.application.dto.request;
+
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+
+public record EmailRequest(
+        @NotBlank(message = "이메일은 필수입니다.")
+        @Email(message = "이메일 형식이 올바르지 않습니다.")
+        String email
+) {
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/application/dto/request/EmailVerifyRequest.java

@@ -0,0 +1,13 @@
+package com.whereyouad.WhereYouAd.domains.user.application.dto.request;
+
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+
+public record EmailVerifyRequest(
+        @NotBlank(message = "이메일은 필수입니다.")
+        @Email(message = "이메일 형식이 올바르지 않습니다.")
+        String email,
+        @NotBlank
+        String authCode
+) {
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/application/dto/response/EmailSentResponse.java

@@ -0,0 +1,8 @@
+package com.whereyouad.WhereYouAd.domains.user.application.dto.response;
+
+public record EmailSentResponse(
+        String message, //인증코드를 이메일로 전송했습니다.
+        String email, //전송한 이메일
+        long expireIn //만료시간 (500L -> 500초)
+) {
+}

src/main/java/com/whereyouad/WhereYouAd/domains/user/domain/service/EmailService.java

@@ -0,0 +1,107 @@
+package com.whereyouad.WhereYouAd.domains.user.domain.service;
+
+import com.whereyouad.WhereYouAd.domains.user.application.dto.response.EmailSentResponse;
+import com.whereyouad.WhereYouAd.domains.user.exception.UserSignUpException;
+import com.whereyouad.WhereYouAd.domains.user.exception.code.UserErrorCode;
+import com.whereyouad.WhereYouAd.domains.user.persistence.repository.UserRepository;
+import com.whereyouad.WhereYouAd.global.utils.RedisUtil;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.mail.MailException;
+import org.springframework.mail.SimpleMailMessage;
+import org.springframework.mail.javamail.JavaMailSender;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+
+@Transactional
+@Service
+@RequiredArgsConstructor
+@Slf4j
+public class EmailService {
+
+    private final JavaMailSender emailSender;
+    private final RedisUtil redisUtil;
+    private final UserRepository userRepository;
+
+    //application.yml 적용 필요
+    @Value("${spring.mail.username}")
+    private String senderEmail;
+
+    //인증코드 이메일 발송 로직
+    public EmailSentResponse sendEmail(String toEmail) {
+
+        if (userRepository.existsByEmail(toEmail)) { //이미 해당 이메일로 생성한 계정이 있으면
+            throw new UserSignUpException(UserErrorCode.USER_EMAIL_DUPLICATE); //이메일 중복 예외(회원가입 시 사용했던 예외)
+        }
+
+        //인증코드 재전송 로직 -> 이미 Redis 에 해당 이메일 인증코드가 있을시 삭제
+        String redisKey = "CODE:" + toEmail;
+        if (redisUtil.getData(redisKey) != null) {
+            redisUtil.deleteData(redisKey);
+        }
+
+        String authCode = createCode(); //인증코드 생성
+
+        if (isTestEmail(toEmail)) {
+            //테스트용 가짜 이메일은 서버 로그로만 인증코드를 보여주기
+            //실제 이메일 발송 X
+            //존재하지 않는 이메일 주소로 계속 이메일을 보내면 인증코드 전송용 이메일 계정이 스팸처리 될 가능성 존재하여 로그로 남기기
+            log.warn("{} 이메일 -> 테스트 or 개발용 가짜 이메일 입니다.", toEmail);
+            log.warn("[TEST 모드] 실제 발송을 건너뜁니다.");
+            log.warn("[TEST 모드] 수신자: {}", toEmail);
+            log.warn("[TEST 모드] 인증코드: {}", authCode);
+
+        } else { //실제 존재하는 이메일이라면
+
+            try {
+                //실제 인증 코드가 담긴 이메일 전송
+                SimpleMailMessage message = new SimpleMailMessage();
+                message.setTo(toEmail);
+                message.setSubject("whereyouad 회원가입 인증번호");
+                message.setText("인증번호: " + authCode);
+                message.setFrom(senderEmail);
+
+                emailSender.send(message); //만약 실제 존재하는 이메일인데 사용자가 오타를 냈다면
+            } catch (MailException e) { //예외 발생
+                throw new UserSignUpException(UserErrorCode.USER_EMAIL_NOT_VALID); //통합 응답 처리 예외로 반환
+            }
+
+        }
+
+        //Redis에 저장 (Key: "CODE:이메일", Value: "123456", 유효시간: 300초(5분))
+        //테스트 계정도 인증은 해야하니 Redis 에 코드가 저장 되어야 함.
+        //테스트 계정의 인증은 서버 로그를 통해 인증코드를 얻어 입력.
+        redisUtil.setDataExpire("CODE:" + toEmail, authCode, 60 * 5L);
+
+        return new EmailSentResponse("인증코드를 이메일로 전송했습니다.", toEmail, 300L);
+    }
+
+    //인증코드 검증 메서드
+    public void verifyEmailCode(String email, String inputCode) {
+        //해당 이메일 값으로 Redis 에서 조회
+        String key = "CODE:" + email;
+        String savedCode = redisUtil.getData(key);
+
+        //만약 인증코드가 없거나 잘못 입력했다면,
+        if (savedCode == null || !savedCode.equals(inputCode)) {
+            throw new UserSignUpException(UserErrorCode.USER_EMAIL_AUTH_INVALID); //예외 발생(BAD_REQUEST)
+        }
+
+        //정상적으로 인증코드를 입력했다면,
+        //기존 Redis 에 저장된 데이터를 지우고,
+        redisUtil.deleteData(key);
+        //"해당 이메일이 정상적으로 인증되었다" 는 값을 다시 Redis 에 저장 -> 이후 회원가입(signup) 내부 로직에서 활용
+        redisUtil.setDataExpire("VERIFIED:" + email, "TRUE", 60 * 60L); //1시간 뒤 Expire
+    }
+
+    //테스트용 이메일은, "test" 로 시작하거나, "example.com" 으로 끝나야 한다.
+    private boolean isTestEmail(String email) {
+        return email.startsWith("test") || email.endsWith("example.com");
+    }
+
+    //무작위 인증코드 값 생성
+    private String createCode() {
+        return String.valueOf((int)(Math.random() * (900000)) + 100000);
+    }
+}

src/main/java/com/whereyouad/WhereYouAd/global/utils/RedisUtil.java

@@ -0,0 +1,33 @@
+package com.whereyouad.WhereYouAd.global.utils;
+
+import lombok.RequiredArgsConstructor;
+import org.springframework.data.redis.core.StringRedisTemplate;
+import org.springframework.data.redis.core.ValueOperations;
+import org.springframework.stereotype.Service;
+
+import java.time.Duration;
+
+@Service
+@RequiredArgsConstructor
+public class RedisUtil {
+
+    private final StringRedisTemplate template;
+
+    //Redis 에 데이터 저장(유효시간 설정)
+    public void setDataExpire(String key, String value, long duration) {
+        ValueOperations<String, String> valueOperations = template.opsForValue();
+        Duration expireDuration = Duration.ofSeconds(duration);
+        valueOperations.set(key, value, expireDuration);
+    }
+
+    //Redis 에서 데이터 꺼내기(Value 꺼내기)
+    public String getData(String key) {
+        ValueOperations<String, String> valueOperations = template.opsForValue();
+        return valueOperations.get(key);
+    }
+
+    //Redis 에서 데이터 지우기(key 값 기반)
+    public void deleteData(String key) {
+        template.delete(key);
+    }
+}