Docs: Swagger 문서 작성

Author: joyewon0705

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

@@ -49,7 +49,7 @@ public ResponseEntity<RsData<UserResponse>> verifyEmail(
     // 인증 메일 재발송
     @PostMapping("/email/verify")
     public ResponseEntity<RsData<Void>> resendVerificationEmail(
-            @Valid @RequestBody sendEmailRequest request
+            @Valid @RequestBody SendEmailRequest request
     ) {
         authService.resendVerificationEmail(request.email());
         return ResponseEntity
@@ -103,7 +103,7 @@ public ResponseEntity<RsData<Map<String, String>>> refreshToken(
     // 아이디 찾기
     @PostMapping("/username/recover")
     public ResponseEntity<RsData<Void>> recoverUsername(
-            @Valid @RequestBody sendEmailRequest request
+            @Valid @RequestBody SendEmailRequest request
     ) {
         authService.recoverUsername(request.email());
         return ResponseEntity
@@ -116,7 +116,7 @@ public ResponseEntity<RsData<Void>> recoverUsername(
     // 비밀번호 재설정 요청
     @PostMapping("/password/recover")
     public ResponseEntity<RsData<Void>> recoverPassword(
-            @Valid @RequestBody sendEmailRequest request
+            @Valid @RequestBody SendEmailRequest request
     ) {
         authService.recoverPassword(request.email());
         return ResponseEntity

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

@@ -306,7 +306,7 @@ ResponseEntity<RsData<UserResponse>> verifyEmail(
             )
     })
     ResponseEntity<RsData<Void>> resendVerificationEmail(
-            @Valid @RequestBody sendEmailRequest request
+            @Valid @RequestBody SendEmailRequest request
     );
 
     @Operation(
@@ -760,6 +760,77 @@ ResponseEntity<RsData<Map<String, String>>> refreshToken(
     })
     @PostMapping("/username/recover")
     ResponseEntity<RsData<Void>> recoverUsername(
-            @Valid @RequestBody sendEmailRequest request
+            @Valid @RequestBody SendEmailRequest request
+    );
+
+    @Operation(
+            summary = "비밀번호 재설정 요청",
+            description = "사용자가 가입한 이메일을 입력하면, 해당 이메일로 비밀번호 재설정 링크가 발송됩니다."
+    )
+    @ApiResponses({
+            @ApiResponse(
+                    responseCode = "200",
+                    description = "비밀번호 재설정 메일 발송 성공",
+                    content = @Content(
+                            mediaType = "application/json",
+                            examples = @ExampleObject(value = """
+                                    {
+                                      "success": true,
+                                      "code": "SUCCESS_200",
+                                      "message": "비밀번호 재설정 메일을 전송했습니다.",
+                                      "data": null
+                                    }
+                                    """)
+                    )
+            ),
+            @ApiResponse(
+                    responseCode = "404",
+                    description = "존재하지 않는 사용자",
+                    content = @Content(
+                            mediaType = "application/json",
+                            examples = @ExampleObject(value = """
+                                    {
+                                      "success": false,
+                                      "code": "USER_001",
+                                      "message": "존재하지 않는 사용자입니다.",
+                                      "data": null
+                                    }
+                                    """)
+                    )
+            ),
+            @ApiResponse(
+                    responseCode = "400",
+                    description = "잘못된 요청 (이메일 누락 등)",
+                    content = @Content(
+                            mediaType = "application/json",
+                            examples = @ExampleObject(value = """
+                                    {
+                                      "success": false,
+                                      "code": "COMMON_400",
+                                      "message": "잘못된 요청입니다.",
+                                      "data": null
+                                    }
+                                    """)
+                    )
+            ),
+            @ApiResponse(
+                    responseCode = "500",
+                    description = "서버 내부 오류",
+                    content = @Content(
+                            mediaType = "application/json",
+                            examples = @ExampleObject(value = """
+                                    {
+                                      "success": false,
+                                      "code": "COMMON_500",
+                                      "message": "서버 오류가 발생했습니다.",
+                                      "data": null
+                                    }
+                                    """)
+                    )
+            )
+    })
+    @PostMapping("/password/recover")
+    ResponseEntity<RsData<Void>> recoverPassword(
+            @Valid @RequestBody SendEmailRequest request
     );
 }

src/main/java/com/back/domain/user/dto/sendEmailRequest.java renamed to src/main/java/com/back/domain/user/dto/SendEmailRequest.java

@@ -3,7 +3,7 @@
 import jakarta.validation.constraints.Email;
 import jakarta.validation.constraints.NotBlank;
 
-public record sendEmailRequest(
+public record SendEmailRequest(
         @NotBlank @Email String email
 ) {
 }