[FEAT/#10] 번호 인증 검사 기능 구현

src/main/java/sopt/makers/authentication/application/auth/api/AuthApiController.java

@@ -1,9 +1,11 @@
 package sopt.makers.authentication.application.auth.api;
 
 import sopt.makers.authentication.application.auth.dto.request.AuthRequest;
+import sopt.makers.authentication.application.auth.dto.response.AuthResponse;
 import sopt.makers.authentication.support.code.domain.success.AuthSuccess;
 import sopt.makers.authentication.support.common.api.BaseResponse;
 import sopt.makers.authentication.usecase.auth.port.in.CreatePhoneVerificationUsecase;
+import sopt.makers.authentication.usecase.auth.port.in.VerifyPhoneVerificationUsecase;
 
 import org.springframework.http.ResponseEntity;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -18,6 +20,7 @@
 public class AuthApiController implements AuthApi {
 
   private final CreatePhoneVerificationUsecase createVerificationUsecase;
+  private final VerifyPhoneVerificationUsecase verifyVerificationUsecase;
 
   @Override
   @PostMapping("/phone")
@@ -32,6 +35,10 @@ public ResponseEntity<BaseResponse<?>> createPhoneVerification(
   @PostMapping("/verify/phone")
   public ResponseEntity<BaseResponse<?>> verifyPhoneVerification(
       AuthRequest.VerifyPhoneVerification phoneVerification) {
-    return null;
+    boolean result = verifyVerificationUsecase.verify(phoneVerification.toCommand());
+    return ResponseEntity.status(AuthSuccess.CREATE_PHONE_VERIFICATION.getStatus().value())
+        .body(
+            BaseResponse.ofSuccess(
+                AuthSuccess.CREATE_PHONE_VERIFICATION, new AuthResponse.VerifyResult(result)));
   }
 }

src/main/java/sopt/makers/authentication/application/auth/dto/request/AuthRequest.java

@@ -4,6 +4,7 @@
 
 import sopt.makers.authentication.domain.auth.PhoneVerificationType;
 import sopt.makers.authentication.usecase.auth.port.in.CreatePhoneVerificationUsecase.CreateVerificationCommand;
+import sopt.makers.authentication.usecase.auth.port.in.VerifyPhoneVerificationUsecase.VerifyVerificationCommand;
 
 import lombok.RequiredArgsConstructor;
 
@@ -17,5 +18,14 @@ public CreateVerificationCommand toCommand() {
     }
   }
 
-  public record VerifyPhoneVerification(String name, String number, String code) {}
+  public record VerifyPhoneVerification(
+      String name, String number, String code, String verificationTypeName) {
+    public VerifyVerificationCommand toCommand() {
+      return new VerifyVerificationCommand(
+          this.name,
+          this.number,
+          this.code,
+          PhoneVerificationType.valueOf(this.verificationTypeName));
+    }
+  }
 }

src/main/java/sopt/makers/authentication/application/auth/dto/response/AuthResponse.java

@@ -2,7 +2,12 @@
 
 import static lombok.AccessLevel.PRIVATE;
 
+import com.fasterxml.jackson.annotation.JsonProperty;
+
 import lombok.RequiredArgsConstructor;
 
 @RequiredArgsConstructor(access = PRIVATE)
-public final class AuthResponse {}
+public final class AuthResponse {
+
+  public record VerifyResult(@JsonProperty("isVerified") boolean isVerified) {}
+}

src/main/java/sopt/makers/authentication/database/PhoneVerificationRepositoryImpl.java

@@ -0,0 +1,38 @@
+package sopt.makers.authentication.database;
+
+import sopt.makers.authentication.database.rdb.entity.auth.PhoneVerificationEntity;
+import sopt.makers.authentication.database.rdb.repository.auth.PhoneVerificationRegister;
+import sopt.makers.authentication.database.rdb.repository.auth.PhoneVerificationRemover;
+import sopt.makers.authentication.database.rdb.repository.auth.PhoneVerificationRetriever;
+import sopt.makers.authentication.domain.auth.PhoneVerification;
+import sopt.makers.authentication.usecase.auth.port.out.PhoneVerificationRepository;
+
+import org.springframework.stereotype.Repository;
+
+import lombok.RequiredArgsConstructor;
+
+@Repository
+@RequiredArgsConstructor
+public class PhoneVerificationRepositoryImpl implements PhoneVerificationRepository {
+
+  private final PhoneVerificationRegister register;
+  private final PhoneVerificationRetriever retriever;
+  private final PhoneVerificationRemover remover;
+
+  @Override
+  public PhoneVerification create(PhoneVerification phoneVerification) {
+    PhoneVerificationEntity createdEntity = register.register(phoneVerification);
+    return createdEntity.toDomain();
+  }
+
+  @Override
+  public PhoneVerification findByPhoneVerification(PhoneVerification phoneVerification) {
+    PhoneVerificationEntity phoneVerificationEntity = retriever.find(phoneVerification);
+    return phoneVerificationEntity.toDomain();
+  }
+
+  @Override
+  public void deletedByPhoneVerification(PhoneVerification phoneVerification) {
+    remover.remove(phoneVerification);
+  }
+}

src/main/java/sopt/makers/authentication/database/rdb/entity/PhoneVerificationEntity.java → src/main/java/sopt/makers/authentication/database/rdb/entity/auth/PhoneVerificationEntity.java

@@ -1,4 +1,4 @@
-package sopt.makers.authentication.database.rdb.entity;
+package sopt.makers.authentication.database.rdb.entity.auth;
 
 import static lombok.AccessLevel.PRIVATE;
 import static lombok.AccessLevel.PROTECTED;

src/main/java/sopt/makers/authentication/database/rdb/repository/auth/PhoneVerificationJpaRepository.java

@@ -0,0 +1,39 @@
+package sopt.makers.authentication.database.rdb.repository.auth;
+
+import sopt.makers.authentication.database.rdb.entity.auth.PhoneVerificationEntity;
+import sopt.makers.authentication.domain.auth.PhoneVerification;
+import sopt.makers.authentication.domain.auth.PhoneVerificationType;
+import sopt.makers.authentication.support.code.domain.failure.AuthFailure;
+import sopt.makers.authentication.support.exception.domain.AuthException;
+
+import java.util.Optional;
+
+import org.springframework.data.jpa.repository.JpaRepository;
+
+interface PhoneVerificationJpaRepository extends JpaRepository<PhoneVerificationEntity, Long> {
+
+  Optional<PhoneVerificationEntity> findByNameAndPhoneAndCodeAndType(
+      String name, String phone, String code, PhoneVerificationType type);
+
+  void deleteByNameAndPhoneAndCodeAndType(
+      String name, String phone, String code, PhoneVerificationType type);
+
+  default PhoneVerificationEntity findByPhoneVerification(PhoneVerification verification) {
+    PhoneVerificationEntity targetPhoneVerificationEntity =
+        findByNameAndPhoneAndCodeAndType(
+                verification.getName(),
+                verification.getPhone(),
+                verification.getVerificationCode().getCode(),
+                verification.getVerificationType())
+            .orElseThrow(() -> new AuthException(AuthFailure.NOT_FOUND_PHONE_VERIFICATION));
+    return targetPhoneVerificationEntity;
+  }
+
+  default void deleteByVerification(PhoneVerification verification) {
+    deleteByNameAndPhoneAndCodeAndType(
+        verification.getName(),
+        verification.getPhone(),
+        verification.getVerificationCode().getCode(),
+        verification.getVerificationType());
+  }
+}

src/main/java/sopt/makers/authentication/database/rdb/repository/auth/PhoneVerificationRegister.java

@@ -0,0 +1,28 @@
+package sopt.makers.authentication.database.rdb.repository.auth;
+
+import sopt.makers.authentication.database.rdb.entity.auth.PhoneVerificationEntity;
+import sopt.makers.authentication.domain.auth.PhoneVerification;
+
+import jakarta.transaction.Transactional;
+
+import org.springframework.stereotype.Component;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@Transactional
+@RequiredArgsConstructor
+public class PhoneVerificationRegister {
+
+  private final PhoneVerificationJpaRepository jpaRepository;
+
+  public PhoneVerificationEntity register(PhoneVerification phoneVerification) {
+    PhoneVerificationEntity entity = PhoneVerificationEntity.fromDomain(phoneVerification);
+    return jpaRepository.save(entity);
+  }
+
+  public PhoneVerificationEntity register(final long id, PhoneVerification phoneVerification) {
+    PhoneVerificationEntity entity = PhoneVerificationEntity.fromDomain(id, phoneVerification);
+    return jpaRepository.save(entity);
+  }
+}

src/main/java/sopt/makers/authentication/database/rdb/repository/auth/PhoneVerificationRemover.java

@@ -0,0 +1,21 @@
+package sopt.makers.authentication.database.rdb.repository.auth;
+
+import sopt.makers.authentication.domain.auth.PhoneVerification;
+
+import jakarta.transaction.Transactional;
+
+import org.springframework.stereotype.Component;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@Transactional
+@RequiredArgsConstructor
+public class PhoneVerificationRemover {
+
+  private final PhoneVerificationJpaRepository jpaRepository;
+
+  public void remove(PhoneVerification phoneVerification) {
+    jpaRepository.deleteByVerification(phoneVerification);
+  }
+}

src/main/java/sopt/makers/authentication/database/rdb/repository/auth/PhoneVerificationRetriever.java

@@ -0,0 +1,21 @@
+package sopt.makers.authentication.database.rdb.repository.auth;
+
+import sopt.makers.authentication.database.rdb.entity.auth.PhoneVerificationEntity;
+import sopt.makers.authentication.domain.auth.PhoneVerification;
+
+import org.springframework.stereotype.Component;
+import org.springframework.transaction.annotation.Transactional;
+
+import lombok.RequiredArgsConstructor;
+
+@Component
+@Transactional(readOnly = true)
+@RequiredArgsConstructor
+public class PhoneVerificationRetriever {
+
+  private final PhoneVerificationJpaRepository jpaRepository;
+
+  public PhoneVerificationEntity find(PhoneVerification phoneVerification) {
+    return jpaRepository.findByPhoneVerification(phoneVerification);
+  }
+}

src/main/java/sopt/makers/authentication/domain/auth/PhoneVerification.java

@@ -5,12 +5,14 @@
 import java.util.Random;
 
 import lombok.Builder;
+import lombok.EqualsAndHashCode;
 import lombok.Getter;
 import lombok.RequiredArgsConstructor;
 
 @Getter
 @Builder(access = PRIVATE)
 @RequiredArgsConstructor(access = PRIVATE)
+@EqualsAndHashCode
 public class PhoneVerification {
 
   private final String name;
@@ -40,6 +42,7 @@ public static PhoneVerification create(String name, String phone, PhoneVerificat
   }
 
   @Getter
+  @EqualsAndHashCode
   public static class VerificationCode {
     private static final int CODE_SIZE = 6;
     private final String code;

src/main/java/sopt/makers/authentication/support/code/domain/failure/AuthFailure.java

@@ -12,7 +12,11 @@
 @Getter
 @RequiredArgsConstructor(access = PRIVATE)
 public enum AuthFailure implements FailureCode {
+  // 400
   INVALID_SOCIAL_PLATFORM(HttpStatus.BAD_REQUEST, "지원하지 않는 소셜 플랫폼입니다"),
+
+  // 404
+  NOT_FOUND_PHONE_VERIFICATION(HttpStatus.NOT_FOUND, "존재하지 않는 번호 인증 이력입니다."),
   ;
   private final HttpStatus status;
   private final String message;

src/main/java/sopt/makers/authentication/support/code/domain/success/AuthSuccess.java

@@ -12,6 +12,8 @@
 @Getter
 @RequiredArgsConstructor(access = PRIVATE)
 public enum AuthSuccess implements SuccessCode {
+  VERIFY_PHONE_VERIFICATION(HttpStatus.OK, "번호 인증에 성공했습니다."),
+
   CREATE_PHONE_VERIFICATION(HttpStatus.CREATED, "번호 인증 생성에 성공했습니다."),
   ;
 

src/main/java/sopt/makers/authentication/usecase/auth/port/in/VerifyPhoneVerificationUsecase.java

@@ -0,0 +1,11 @@
+package sopt.makers.authentication.usecase.auth.port.in;
+
+import sopt.makers.authentication.domain.auth.PhoneVerificationType;
+
+public interface VerifyPhoneVerificationUsecase {
+
+  boolean verify(VerifyVerificationCommand command);
+
+  record VerifyVerificationCommand(
+      String name, String phone, String code, PhoneVerificationType verificationType) {}
+}

src/main/java/sopt/makers/authentication/usecase/auth/port/out/PhoneVerificationRepository.java

@@ -4,5 +4,9 @@
 
 public interface PhoneVerificationRepository {
 
-  PhoneVerification save(PhoneVerification phoneVerification);
+  PhoneVerification create(PhoneVerification phoneVerification);
+
+  PhoneVerification findByPhoneVerification(PhoneVerification phoneVerification);
+
+  void deletedByPhoneVerification(PhoneVerification phoneVerification);
 }

src/main/java/sopt/makers/authentication/usecase/auth/service/CreateVerificationService.java

@@ -29,7 +29,7 @@ public PhoneVerification create(CreateVerificationCommand command) {
             convertCodeToMessage(phoneVerification.getVerificationCode().getCode()));
 
     messageSendPort.sendMessage(verificationMessage);
-    return verificationRepository.save(phoneVerification);
+    return verificationRepository.create(phoneVerification);
   }
 
   private String convertCodeToMessage(String code) {

src/main/java/sopt/makers/authentication/usecase/auth/service/VerifyVerificationService.java

@@ -0,0 +1,30 @@
+package sopt.makers.authentication.usecase.auth.service;
+
+import sopt.makers.authentication.domain.auth.PhoneVerification;
+import sopt.makers.authentication.usecase.auth.port.in.VerifyPhoneVerificationUsecase;
+import sopt.makers.authentication.usecase.auth.port.out.PhoneVerificationRepository;
+
+import org.springframework.stereotype.Service;
+
+import lombok.RequiredArgsConstructor;
+
+@Service
+@RequiredArgsConstructor
+public class VerifyVerificationService implements VerifyPhoneVerificationUsecase {
+  private final PhoneVerificationRepository phoneVerificationRepository;
+
+  @Override
+  public boolean verify(VerifyVerificationCommand command) {
+    PhoneVerification targetVerification =
+        PhoneVerification.of(
+            command.name(), command.phone(), command.verificationType(), command.code());
+    PhoneVerification findVerification =
+        phoneVerificationRepository.findByPhoneVerification(targetVerification);
+    boolean isVerified = targetVerification.equals(findVerification);
+
+    if (isVerified) {
+      phoneVerificationRepository.deletedByPhoneVerification(findVerification);
+    }
+    return isVerified;
+  }
+}