Feat: 비밀번호 재설정 요청 API 구현

Author: joyewon0705

src/main/java/com/back/domain/user/controller/AuthController.java

@@ -100,6 +100,7 @@ public ResponseEntity<RsData<Map<String, String>>> refreshToken(
         ));
     }
 
+    // 아이디 찾기
     @PostMapping("/username/recover")
     public ResponseEntity<RsData<Void>> recoverUsername(
             @Valid @RequestBody sendEmailRequest request
@@ -111,4 +112,17 @@ public ResponseEntity<RsData<Void>> recoverUsername(
                         null
                 ));
     }
+
+    // 비밀번호 재설정 요청
+    @PostMapping("/password/recover")
+    public ResponseEntity<RsData<Void>> recoverPassword(
+            @Valid @RequestBody sendEmailRequest request
+    ) {
+        authService.recoverPassword(request.email());
+        return ResponseEntity
+                .ok(RsData.success(
+                        "비밀번호 재설정 링크를 이메일로 전송했습니다.",
+                        null
+                ));
+    }
 }

src/main/java/com/back/domain/user/service/AuthService.java

@@ -285,6 +285,24 @@ public void recoverUsername(String email) {
         emailService.sendUsernameEmail(user.getEmail(), maskedUsername);
     }
 
+    /**
+     * 비밀번호 재설정 요청 서비스
+     * 1. 이메일로 사용자 조회
+     * 2. 비밀번호 재설정 토큰 생성
+     * 3. 이메일 발송
+     */
+    public void recoverPassword(String email) {
+        // 사용자 조회
+        User user = userRepository.findByEmail(email)
+                .orElseThrow(() -> new CustomException(ErrorCode.USER_NOT_FOUND));
+
+        // 비밀번호 재설정 토큰 생성
+        String resetToken = tokenService.createPasswordResetToken(user.getId());
+
+        // 이메일 발송
+        emailService.sendPasswordResetEmail(user.getEmail(), resetToken);
+    }
+
     /**
      * 회원가입 시 중복 검증
      * - username, email, nickname

src/main/java/com/back/domain/user/service/EmailService.java

@@ -57,6 +57,27 @@ public void sendUsernameEmail(String toEmail, String maskedUsername) {
         sendHtmlEmail(toEmail, subject, htmlContent);
     }
 
+    // 비밀번호 재설정 메일 전송
+    public void sendPasswordResetEmail(String toEmail, String token) {
+        String subject = "[Catfe] 비밀번호 재설정 안내";
+        String resetUrl = FRONTEND_BASE_URL + "/reset-password?token=" + token;
+
+        String htmlContent = """
+            <p>안녕하세요, Catfe입니다.</p>
+            <p>아래 버튼을 클릭하여 비밀번호를 재설정해 주세요.</p>
+            <br>
+            <p>
+                <a href="%s" style="display:inline-block;padding:10px 20px;
+                background-color:#4CAF50;color:#fff;text-decoration:none;
+                border-radius:5px;">비밀번호 재설정하기</a>
+            </p>
+            <br>
+            <p>이 링크는 1시간 동안만 유효합니다.</p>
+            """.formatted(resetUrl);
+
+        sendHtmlEmail(toEmail, subject, htmlContent);
+    }
+
     // HTML 이메일 전송 공통 메서드
     private void sendHtmlEmail(String toEmail, String subject, String htmlContent) {
         try {

src/main/java/com/back/domain/user/service/TokenService.java

@@ -29,6 +29,22 @@ public void deleteEmailVerificationToken(String token) {
         deleteToken(EMAIL_VERIFICATION_PREFIX, token);
     }
 
+    // -------------------- 비밀번호 재설정 토큰 --------------------
+    private static final String PASSWORD_RESET_PREFIX = "password:reset:";
+    private static final long PASSWORD_RESET_EXPIRATION_MINUTES = 60; // 1시간
+
+    public String createPasswordResetToken(Long userId) {
+        return createToken(PASSWORD_RESET_PREFIX, userId, PASSWORD_RESET_EXPIRATION_MINUTES);
+    }
+
+    public Long getUserIdByPasswordResetToken(String token) {
+        return getUserIdByToken(PASSWORD_RESET_PREFIX, token);
+    }
+
+    public void deletePasswordResetToken(String token) {
+        deleteToken(PASSWORD_RESET_PREFIX, token);
+    }
+
     // -------------------- 내부 공통 로직 --------------------
     private String createToken(String prefix, Long userId, long ttlMinutes) {
         String token = UUID.randomUUID().toString();