Docs: Swagger 문서 작성

Author: joyewon0705

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

@@ -1,9 +1,6 @@
 package com.back.domain.user.controller;
 
-import com.back.domain.user.dto.LoginRequest;
-import com.back.domain.user.dto.LoginResponse;
-import com.back.domain.user.dto.UserRegisterRequest;
-import com.back.domain.user.dto.UserResponse;
+import com.back.domain.user.dto.*;
 import com.back.global.common.dto.RsData;
 import io.swagger.v3.oas.annotations.Operation;
 import io.swagger.v3.oas.annotations.media.Content;
@@ -225,6 +222,92 @@ ResponseEntity<RsData<UserResponse>> verifyEmail(
             @RequestParam("token") String token
     );
 
+    @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 = "409",
+                    description = "이미 인증된 계정",
+                    content = @Content(
+                            mediaType = "application/json",
+                            examples = @ExampleObject(value = """
+                                    {
+                                      "success": false,
+                                      "code": "TOKEN_002",
+                                      "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
+                                    }
+                                    """)
+                    )
+            )
+    })
+    ResponseEntity<RsData<Void>> resendVerificationEmail(
+            @Valid @RequestBody ResendVerificationRequest request
+    );
+
     @Operation(
             summary = "로그인",
             description = "username + password로 로그인합니다. " +