관리자 로그인 관련 더미 API 추가 (#245)

* feat: 관리자 로그인 관련 더미 API 추가
* refactor: 랜덤 코드 생성 유틸 공통화
* refactor: CodeGeneratorUtil.java private 생성자 추가
* refactor: request Email 유효성 검사 추가

Author: fivedragon5

src/main/java/org/ject/support/common/util/CodeGeneratorUtil.java

@@ -0,0 +1,20 @@
+package org.ject.support.common.util;
+
+import java.security.SecureRandom;
+import java.util.stream.Collectors;
+
+public class CodeGeneratorUtil {
+
+    private CodeGeneratorUtil() {
+        throw new UnsupportedOperationException("인스턴스화 방지");
+    }
+
+    private static final SecureRandom SECURE_RANDOM = new SecureRandom();
+    private static final int DIGIT_BOUND = 10;
+
+    public static String generateAuthCode(int length) {
+        return SECURE_RANDOM.ints(length, 0, DIGIT_BOUND)
+                .mapToObj(String::valueOf)
+                .collect(Collectors.joining());
+    }
+}

src/main/java/org/ject/support/domain/admin/controller/AdminAuthApiSpec.java

@@ -0,0 +1,33 @@
+package org.ject.support.domain.admin.controller;
+
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.validation.Valid;
+import org.ject.support.domain.admin.dto.AdminVerifyEmailRequest;
+import org.ject.support.domain.admin.dto.AdminAuthSendEmailRequest;
+import org.ject.support.domain.admin.dto.AdminAuthSendEmailResponse;
+import org.ject.support.domain.admin.dto.AdminVerifyEmailResponse;
+import org.ject.support.domain.admin.dto.AdminVerifySlackRequest;
+import org.springframework.web.bind.annotation.RequestBody;
+
+@Tag(name = "Admin", description = "관리자 API")
+public interface AdminAuthApiSpec {
+
+    @Operation(
+            summary = "관리자 인증 이메일 코드 전송",
+            description = "관리자 인증 코드를 이메일로 전송합니다."
+    )
+    AdminAuthSendEmailResponse sendAdminAuthEmailCode(@RequestBody @Valid AdminAuthSendEmailRequest request);
+
+    @Operation(
+            summary = "관리자 인증 이메일 코드 검증",
+            description = "관리자 인증 이메일 코드를 검증합니다."
+    )
+    AdminVerifyEmailResponse verifyAdminAuthEmailCode(@RequestBody @Valid AdminVerifyEmailRequest request);
+
+    @Operation(
+            summary = "관리자 인증 Slack 코드 검증",
+            description = "관리자 인증 Slack 코드를 검증합니다."
+    )
+    boolean verifyAdminAuthSlackCode(@RequestBody @Valid AdminVerifySlackRequest request);
+}

src/main/java/org/ject/support/domain/admin/controller/AdminAuthController.java

@@ -0,0 +1,41 @@
+package org.ject.support.domain.admin.controller;
+
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.ject.support.domain.admin.dto.AdminVerifyEmailRequest;
+import org.ject.support.domain.admin.dto.AdminAuthSendEmailRequest;
+import org.ject.support.domain.admin.dto.AdminAuthSendEmailResponse;
+import org.ject.support.domain.admin.dto.AdminVerifyEmailResponse;
+import org.ject.support.domain.admin.dto.AdminVerifySlackRequest;
+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
+@RequiredArgsConstructor
+@RequestMapping("/admin")
+public class AdminAuthController implements AdminAuthApiSpec {
+
+    @PostMapping("/auth/email-codes")
+    public AdminAuthSendEmailResponse sendAdminAuthEmailCode(@RequestBody @Valid AdminAuthSendEmailRequest request) {
+        // TODO : 관리자 인증 코드 전송 로직 구현
+        return AdminAuthSendEmailResponse.builder()
+                .email("test@tset.com")
+                .build();
+    }
+
+    @PostMapping("/auth/email-codes/verify")
+    public AdminVerifyEmailResponse verifyAdminAuthEmailCode(@RequestBody @Valid AdminVerifyEmailRequest request) {
+        // TODO : 관리자 인증 이메일 코드 검증 로직 구현, Slack 인증 코드 전송
+        return AdminVerifyEmailResponse.builder()
+                .email("test@tset.com")
+                .build();
+    }
+
+    @PostMapping("/auth/slack-codes/verify")
+    public boolean verifyAdminAuthSlackCode(@RequestBody @Valid AdminVerifySlackRequest request) {
+        // TODO : 관리자 인증 Slack 코드 검증 로직 구현, accessToken 발급
+        return false;
+    }
+}

src/main/java/org/ject/support/domain/admin/dto/AdminAuthSendEmailRequest.java

@@ -0,0 +1,11 @@
+package org.ject.support.domain.admin.dto;
+
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+
+public record AdminAuthSendEmailRequest(
+        @NotBlank(message = "Email은 필수 입력 값입니다.")
+        @Email(message = "유효하지 않은 이메일 형식입니다.")
+        String email
+) {
+}

src/main/java/org/ject/support/domain/admin/dto/AdminAuthSendEmailResponse.java

@@ -0,0 +1,7 @@
+package org.ject.support.domain.admin.dto;
+
+import lombok.Builder;
+
+@Builder
+public record AdminAuthSendEmailResponse(String email) {
+}

src/main/java/org/ject/support/domain/admin/dto/AdminVerifyEmailRequest.java

@@ -0,0 +1,16 @@
+package org.ject.support.domain.admin.dto;
+
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record AdminVerifyEmailRequest(
+        @NotBlank(message = "Email은 필수 입력 값입니다.")
+        @Email(message = "유효하지 않은 이메일 형식입니다.")
+        String email,
+
+        @NotBlank(message = "Code는 필수 입력 값입니다.")
+        @Size(min = 6, max = 6, message = "Code는 6자리여야 합니다.")
+        String code
+) {
+}

src/main/java/org/ject/support/domain/admin/dto/AdminVerifyEmailResponse.java

@@ -0,0 +1,7 @@
+package org.ject.support.domain.admin.dto;
+
+import lombok.Builder;
+
+@Builder
+public record AdminVerifyEmailResponse(String email) {
+}

src/main/java/org/ject/support/domain/admin/dto/AdminVerifySlackRequest.java

@@ -0,0 +1,16 @@
+package org.ject.support.domain.admin.dto;
+
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+
+public record AdminVerifySlackRequest(
+        @NotBlank(message = "Email은 필수 입력 값입니다.")
+        @Email(message = "유효하지 않은 이메일 형식입니다.")
+        String email,
+
+        @NotBlank(message = "Code는 필수 입력 값입니다.")
+        @Size(min = 6, max = 6, message = "Code는 4자리여야 합니다.")
+        String code
+) {
+}

src/main/java/org/ject/support/external/email/service/EmailAuthService.java

@@ -2,10 +2,10 @@
 
 import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
+import org.ject.support.common.util.CodeGeneratorUtil;
 import org.springframework.data.redis.core.RedisTemplate;
 import org.springframework.stereotype.Service;
 
-import java.security.SecureRandom;
 import java.time.Duration;
 import java.util.Map;
 
@@ -21,20 +21,11 @@ public class EmailAuthService {
     private final RedisTemplate<String, String> redisTemplate;
 
     public void sendAuthCode(String sendGroupCode, String toAddress) {
-        String authCode = generateAuthCode();
+        String authCode = CodeGeneratorUtil.generateAuthCode(AUTH_CODE_LENGTH);
         sendAuthCodeEmail(sendGroupCode, toAddress, authCode);
         storeAuthCode(toAddress, authCode);
     }
 
-    private String generateAuthCode() {
-        SecureRandom random = new SecureRandom();
-        StringBuilder builder = new StringBuilder();
-        for (int i = 0; i < AUTH_CODE_LENGTH; i++) {
-            builder.append(random.nextInt(10));
-        }
-        return builder.toString();
-    }
-
     private void sendAuthCodeEmail(String sendGroupCode, String toAddress, String authCode) {
         emailSendService.sendTemplatedEmail(sendGroupCode, toAddress, Map.of("auth-code", authCode));
         log.info("인증 번호 전송 - email: {}, code: {}", toAddress, authCode);

src/test/java/org/ject/support/common/util/CodeGeneratorUtilTest.java

@@ -0,0 +1,24 @@
+package org.ject.support.common.util;
+
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+
+class CodeGeneratorUtilTest {
+
+    @Test
+    @DisplayName("랜덤 인증 코드 생성 테스트")
+    void generateAuthCode_length_check() {
+        // given
+        int length = 6;
+
+        // when
+        String code = CodeGeneratorUtil.generateAuthCode(length);
+
+        // then
+        assertNotNull(code);
+        assertEquals(length, code.length());
+    }
+}