From 227064cd41862ef46f008cba72bebb364025aedb Mon Sep 17 00:00:00 2001
From: Nanajun22 <skaudwns3@gmail.com>
Date: Sat, 2 May 2026 12:18:02 +0900
Subject: [PATCH 1/2] =?UTF-8?q?Swagger=20=EB=AC=B8=EC=84=9C=ED=99=94?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .idea/workspace.xml                           | 32 ++++++++--
 .../comment/strategy/CommentStrategy.java     |  2 +-
 .../domain/post/Service/PostService.java      |  4 +-
 .../post/controller/PostController.java       | 21 ++++---
 .../post/controller/PostControllerDocs.java   | 58 +++++++------------
 .../domain/post/dto/PostRequestDto.java       |  7 +--
 .../{exception => error}/PostException.java   |  2 +-
 .../post/strategy/PostReportStrategy.java     |  2 +-
 .../controller/ReportAdminController.java     |  4 +-
 .../controller/ReportAdminControllerDocs.java | 44 ++++++++++++++
 .../report/controller/ReportController.java   |  7 ++-
 .../controller/ReportControllerDocs.java      | 45 ++++++++++++++
 .../global/annotation/ApiErrorResponse.java   |  2 +
 .../leets7th/global/code/ErrorCode.java       | 14 ++++-
 .../global/config/SwaggerErrorCustomizer.java | 12 +++-
 .../global/error/GlobalExceptionHandler.java  | 18 +++++-
 src/main/resources/application.properties     |  7 +++
 src/main/resources/data.sql                   |  9 +++
 18 files changed, 219 insertions(+), 71 deletions(-)
 rename src/main/java/com/example/leets7th/domain/post/{exception => error}/PostException.java (85%)
 create mode 100644 src/main/java/com/example/leets7th/domain/report/controller/ReportAdminControllerDocs.java
 create mode 100644 src/main/java/com/example/leets7th/domain/report/controller/ReportControllerDocs.java
 create mode 100644 src/main/resources/data.sql

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index 1c320137..c9d5fc2d 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -5,7 +5,24 @@
   </component>
   <component name="ChangeListManager">
     <list default="true" id="1fe1570b-38b0-4a5d-8519-5916e0d6f809" name="변경" comment="">
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/dto/ReportRequestDto.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/dto/ReportRequestDto.java" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminControllerDocs.java" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportControllerDocs.java" afterDir="false" />
+      <change afterPath="$PROJECT_DIR$/src/main/resources/data.sql" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/Service/PostService.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/Service/PostService.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostController.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostController.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/exception/PostException.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/error/PostException.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/code/ErrorCode.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/code/ErrorCode.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/src/main/resources/application.properties" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/resources/application.properties" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -42,9 +59,10 @@
   <component name="FileTemplateManagerImpl">
     <option name="RECENT_TEMPLATES">
       <list>
-        <option value="Interface" />
-        <option value="Enum" />
         <option value="Exception" />
+        <option value="Enum" />
+        <option value="HTML File" />
+        <option value="Interface" />
         <option value="Class" />
       </list>
     </option>
@@ -53,7 +71,7 @@
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
   </component>
   <component name="ProblemsViewState">
-    <option name="selectedTabId" value="ProjectErrors" />
+    <option name="selectedTabId" value="CurrentFile" />
   </component>
   <component name="ProjectColorInfo">{
   &quot;associatedIndex&quot;: 0
@@ -65,6 +83,7 @@
   </component>
   <component name="PropertiesComponent"><![CDATA[{
   "keyToString": {
+    "DefaultHtmlFileTemplate": "HTML File",
     "Gradle.7th-BE-Blog 빌드.executor": "Run",
     "Gradle.C:/Users/skaud/7th-BE-Blog/settings.gradle.executor": "Run",
     "Gradle.namyeongjun 빌드.executor": "Run",
@@ -79,7 +98,7 @@
     "RunOnceActivity.typescript.service.memoryLimit.init": "true",
     "Spring Boot.DemoApplication (1).executor": "Run",
     "Spring Boot.DemoApplication.executor": "Run",
-    "git-widget-placeholder": "나명준/4주차",
+    "git-widget-placeholder": "나명준/5주차",
     "ignore.virus.scanning.warn.message": "true",
     "kotlin-language-version-configured": "true",
     "last_opened_file_path": "C:/Users/skaud/7th-BE-Blog/namyeongjun",
@@ -141,7 +160,8 @@
       <option name="presentableId" value="Default" />
       <updated>1773935593667</updated>
       <workItem from="1773935594836" duration="24032000" />
-      <workItem from="1777027069393" duration="59748000" />
+      <workItem from="1777027069393" duration="60578000" />
+      <workItem from="1777559366574" duration="16855000" />
     </task>
     <servers />
   </component>
diff --git a/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java b/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java
index fd9b8a7c..587ff1f9 100644
--- a/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java
+++ b/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java
@@ -3,7 +3,7 @@
 import com.example.leets7th.domain.comment.domain.Comment;
 import com.example.leets7th.domain.comment.domain.CommentRepository;
 import com.example.leets7th.domain.comment.exception.CommentException;
-import com.example.leets7th.domain.post.exception.PostException;
+import com.example.leets7th.domain.post.error.PostException;
 import com.example.leets7th.domain.report.domain.ReportContentType;
 import com.example.leets7th.domain.report.strategy.ReportStrategy;
 import com.example.leets7th.global.code.ErrorCode;
diff --git a/src/main/java/com/example/leets7th/domain/post/Service/PostService.java b/src/main/java/com/example/leets7th/domain/post/Service/PostService.java
index fc42aefe..f95c33e7 100644
--- a/src/main/java/com/example/leets7th/domain/post/Service/PostService.java
+++ b/src/main/java/com/example/leets7th/domain/post/Service/PostService.java
@@ -40,7 +40,7 @@ public List<PostResponseDto.ReadPostList> getPostList() {
     }
 
     @Transactional
-    public PostResponseDto.CreatePost createPost(PostRequestDto.Create request,Long userId) {
+    public PostResponseDto.CreatePost createPost(PostRequestDto.PostCreateReq request, Long userId) {
         Post post = Post.create(request.title(),request.content(),userService.getUser(userId));
         postRepository.save(post);
 
@@ -48,7 +48,7 @@ public PostResponseDto.CreatePost createPost(PostRequestDto.Create request,Long
     }
 
     @Transactional
-    public PostResponseDto.UpdatePost updatePost(PostRequestDto.Update request,Long postId,Long userId) {
+    public PostResponseDto.UpdatePost updatePost(PostRequestDto.PostUpdateReq request,Long postId,Long userId) {
         Post post = postRepository.findByIdWithUser(postId).orElseThrow(()-> new GlobalException(ErrorCode.POST_NOT_FOUND));
 
         if(!userId.equals(post.getUser().getId())) {
diff --git a/src/main/java/com/example/leets7th/domain/post/controller/PostController.java b/src/main/java/com/example/leets7th/domain/post/controller/PostController.java
index a7ceb466..91d985da 100644
--- a/src/main/java/com/example/leets7th/domain/post/controller/PostController.java
+++ b/src/main/java/com/example/leets7th/domain/post/controller/PostController.java
@@ -5,7 +5,9 @@
 import com.example.leets7th.domain.post.dto.PostResponseDto;
 import com.example.leets7th.global.code.SuccessCode;
 import com.example.leets7th.global.response.ApiResponse;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
+import org.springframework.http.HttpStatus;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
@@ -20,8 +22,8 @@ public class PostController implements PostControllerDocs {
     @Override
     @GetMapping("/{postId}")
     public ApiResponse<PostResponseDto.ReadPost> getPost(
-            Long postId,
-            Long userId
+            @PathVariable Long postId,
+            @RequestParam Long userId
     ) {
         return ApiResponse.success(SuccessCode.POST_READ_OK,postService.getPost(postId));
     }
@@ -35,10 +37,11 @@ public ApiResponse<List<PostResponseDto.ReadPostList>> getPostList() {
 
 
     @Override
+    @ResponseStatus(HttpStatus.CREATED)
     @PostMapping
     public ApiResponse<PostResponseDto.CreatePost> createPost(
-            PostRequestDto.Create request,
-            Long userId
+            @Valid @RequestBody PostRequestDto.PostCreateReq request,
+            @RequestParam Long userId
     ) {
         return ApiResponse.success(SuccessCode.POST_CREATED,postService.createPost(request,userId));
     }
@@ -46,9 +49,9 @@ public ApiResponse<PostResponseDto.CreatePost> createPost(
     @Override
     @PatchMapping("/{postId}")
     public ApiResponse<PostResponseDto.UpdatePost> updatePost(
-            PostRequestDto.Update request,
-            Long postId,
-            Long userId
+            @Valid @RequestBody PostRequestDto.PostUpdateReq request,
+            @PathVariable Long postId,
+            @RequestParam Long userId
     ) {
         return ApiResponse.success(SuccessCode.POST_UPDATE_OK,postService.updatePost(request,postId,userId));
     }
@@ -57,8 +60,8 @@ public ApiResponse<PostResponseDto.UpdatePost> updatePost(
     @Override
     @DeleteMapping("/{postId}")
     public ApiResponse<Void> deletePost(
-            Long postId,
-            Long userId
+            @PathVariable Long postId,
+            @RequestParam Long userId
     ) {
         postService.deletePost(postId,userId);
         return ApiResponse.success(SuccessCode.POST_DELETE_OK);
diff --git a/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java b/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java
index a795cd1e..fbb3433a 100644
--- a/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java
+++ b/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java
@@ -16,73 +16,57 @@
 import java.util.List;
 
 @Tag(name = "Post",description = "게시글 API")
-@RequestMapping("/api/posts")
 public interface PostControllerDocs {
 
 
     @Operation(summary = "게시글 상세 조회", description = "특정 게시글의 상세정보를 조회합니다.")
-    @ApiResponses({
-            @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200",description = "게시글 상세 조회에 성공하였습니다."),
-    })
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200",description = "게시글 상세 조회에 성공하였습니다.")
     @ApiErrorResponse({ErrorCode.POST_NOT_FOUND})
-    @GetMapping("/{postId}")
     ApiResponse<PostResponseDto.ReadPost> getPost(
-            @PathVariable Long postId,
-            @RequestParam Long userId
+            Long postId,
+            Long userId
     );
 
     @Operation(summary = "게시글 목록 조회",description = "게시글 전체 목록을 조회합니다.")
-    @ApiResponses({
-            @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200",description = "게시글 목록 조회에 성공하였습니다.")
-    })
-    @GetMapping
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200",description = "게시글 목록 조회에 성공하였습니다.")
     ApiResponse<List<PostResponseDto.ReadPostList>> getPostList();
 
 
     @Operation(summary = "게시글 생성",description = "새로운 게시글을 생성합니다.")
-    @ApiResponses({
-            @io.swagger.v3.oas.annotations.responses.ApiResponse(
-                    responseCode = "201",
-                    description = "게시글 작성에 성공하였습니다.")
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "201", description = "게시글 작성에 성공하였습니다.")
+    @ApiErrorResponse({
+            ErrorCode.USER_NOT_FOUND,
+            ErrorCode.POST_INPUT_NO_VALIDATION
     })
-    @ResponseStatus(HttpStatus.CREATED)
-    @PostMapping
     ApiResponse<PostResponseDto.CreatePost> createPost(
-            @Valid @RequestBody PostRequestDto.Create request,
-            @RequestParam Long userId
+            PostRequestDto.PostCreateReq request,
+            Long userId
     );
 
     @Operation(summary = "게시글 수정", description = "게시글 제목과 내용을 수정합니다.")
-    @ApiResponses({
-            @io.swagger.v3.oas.annotations.responses.ApiResponse(
-                    responseCode = "200",
-                    description = "게시글 수정에 성공하였습니다.")
-    })
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "게시글 수정에 성공하였습니다.")
     @ApiErrorResponse({
             ErrorCode.POST_UPDATE_NO_PERMISSION,
-            ErrorCode.POST_NOT_FOUND
+            ErrorCode.POST_NOT_FOUND,
+            ErrorCode.POST_INPUT_NO_VALIDATION
     })
-    @PatchMapping("/{postId}")
     ApiResponse<PostResponseDto.UpdatePost> updatePost(
-            @Valid @RequestBody PostRequestDto.Update request,
-            @PathVariable Long postId,
-            @RequestParam Long userId
+            PostRequestDto.PostUpdateReq request,
+            Long postId,
+            Long userId
     );
 
+
+
     @Operation(summary = "게시글 삭제", description = "게시글을 삭제합니다.")
-    @ApiResponses({
-            @io.swagger.v3.oas.annotations.responses.ApiResponse(
-                    responseCode = "200",
-                    description = "게시글 삭제에 성공하였습니다.")
-    })
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "게시글 삭제에 성공하였습니다.")
     @ApiErrorResponse({
             ErrorCode.POST_DELETE_NO_PERMISSION,
             ErrorCode.POST_NOT_FOUND
     })
-    @DeleteMapping("/{postId}")
     ApiResponse<Void> deletePost(
-            @PathVariable Long postId,
-            @RequestParam Long userId
+            Long postId,
+            Long userId
     );
 
 
diff --git a/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java b/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java
index f2c2d967..74a90236 100644
--- a/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java
+++ b/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java
@@ -1,8 +1,5 @@
 package com.example.leets7th.domain.post.dto;
 
-import com.example.leets7th.domain.post.domain.Post;
-import com.example.leets7th.domain.user.domain.User;
-import io.swagger.v3.oas.annotations.media.Schema;
 import jakarta.validation.constraints.NotBlank;
 import jakarta.validation.constraints.Size;
 
@@ -13,7 +10,7 @@ public class PostRequestDto {
 
 
 
-    public record Create(
+    public record PostCreateReq(
             @NotBlank(message = "제목을 입력해주세요.")
             @Size(max = 255,message = "제목은 최대 255자까지 가능합니다.")
             String title,
@@ -24,7 +21,7 @@ public record Create(
     }
 
 
-    public record Update(
+    public record PostUpdateReq(
 
             @NotBlank(message = "제목을 입력해주세요.")
             @Size(max = 255, message = "제목은 최대 255자까지 가능합니다.")
diff --git a/src/main/java/com/example/leets7th/domain/post/exception/PostException.java b/src/main/java/com/example/leets7th/domain/post/error/PostException.java
similarity index 85%
rename from src/main/java/com/example/leets7th/domain/post/exception/PostException.java
rename to src/main/java/com/example/leets7th/domain/post/error/PostException.java
index d54ae5f2..e32a1782 100644
--- a/src/main/java/com/example/leets7th/domain/post/exception/PostException.java
+++ b/src/main/java/com/example/leets7th/domain/post/error/PostException.java
@@ -1,4 +1,4 @@
-package com.example.leets7th.domain.post.exception;
+package com.example.leets7th.domain.post.error;
 
 import com.example.leets7th.global.common.BaseCode;
 import lombok.Getter;
diff --git a/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java b/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java
index 7e4a22a6..b26ba99a 100644
--- a/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java
+++ b/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java
@@ -2,7 +2,7 @@
 
 import com.example.leets7th.domain.post.domain.Post;
 import com.example.leets7th.domain.post.domain.PostRepository;
-import com.example.leets7th.domain.post.exception.PostException;
+import com.example.leets7th.domain.post.error.PostException;
 import com.example.leets7th.domain.report.domain.ReportContentType;
 import com.example.leets7th.domain.report.strategy.ReportStrategy;
 import com.example.leets7th.global.code.ErrorCode;
diff --git a/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java b/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java
index f8e7c2ff..e04f23bf 100644
--- a/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java
+++ b/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java
@@ -14,10 +14,11 @@
 @RequestMapping("/api/admin/reports")
 @RestController
 @RequiredArgsConstructor
-public class ReportAdminController {
+public class ReportAdminController implements ReportAdminControllerDocs{
     private final ReportAdminService reportAdminService;
 
     //신고 목록 조회 API
+    @Override
     @GetMapping
     public ApiResponse<List<ReportResponseDto.ReportListRes>> getReportList(
             @RequestParam ReportStatus status
@@ -27,6 +28,7 @@ public ApiResponse<List<ReportResponseDto.ReportListRes>> getReportList(
     }
 
     //신고 승인 API
+    @Override
     @PostMapping("/{reportId}/approve")
     public ApiResponse<Void> approveReport(@PathVariable Long reportId) {
         reportAdminService.approveReport(reportId);
diff --git a/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminControllerDocs.java b/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminControllerDocs.java
new file mode 100644
index 00000000..e6c37c08
--- /dev/null
+++ b/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminControllerDocs.java
@@ -0,0 +1,44 @@
+package com.example.leets7th.domain.report.controller;
+
+
+import com.example.leets7th.domain.report.domain.ReportStatus;
+import com.example.leets7th.domain.report.dto.ReportResponseDto;
+import com.example.leets7th.global.annotation.ApiErrorResponse;
+import com.example.leets7th.global.code.ErrorCode;
+import com.example.leets7th.global.response.ApiResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+
+
+import java.util.List;
+
+@Tag(name = "ReportAdmin" ,description = "신고 관리자 API")
+public interface ReportAdminControllerDocs {
+
+
+    @Operation(summary = "신고 목록 조회",description = "상태별 신고 목록을 확인합니다.")
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200", description = "신고 목록 조회를 성공하였습니다.")
+    ApiResponse<List<ReportResponseDto.ReportListRes>> getReportList(ReportStatus status);
+
+
+
+    @Operation(summary = "신고 승인",description = "접수된 신고를 승인합니다.")
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200",description = "신고가 승인되었습니다.")
+    @ApiErrorResponse({
+            ErrorCode.REPORT_NOT_FOUND,
+            ErrorCode.UNSUPPORTED_CONTENT_TYPE
+    })
+    ApiResponse<Void> approveReport(Long reportId);
+
+
+
+    @Operation(summary = "신고 반려",description = "접수된 신고를 반려합니다.")
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200",description = "신고가 반려되었습니다.")
+    @ApiErrorResponse({
+            ErrorCode.REPORT_NOT_FOUND
+    })
+    ApiResponse<Void> rejectReport(Long reportId);
+
+
+
+}
diff --git a/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java b/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java
index cef7749b..85459e87 100644
--- a/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java
+++ b/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java
@@ -7,6 +7,7 @@
 import com.example.leets7th.domain.report.service.ReportService;
 import com.example.leets7th.global.code.SuccessCode;
 import com.example.leets7th.global.response.ApiResponse;
+import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.http.HttpStatus;
 import org.springframework.web.bind.annotation.*;
@@ -14,15 +15,16 @@
 @RestController
 @RequiredArgsConstructor
 @RequestMapping("/api/reports")
-public class ReportController {
+public class ReportController implements ReportControllerDocs {
 
     private final ReportService reportService;
 
     //신고 접수 API
+    @Override
     @ResponseStatus(HttpStatus.CREATED)
     @PostMapping
     public ApiResponse<ReportResponseDto.ReportCreateRes> createReport(
-            @RequestBody ReportRequestDto.ReportCreateReq request,
+            @Valid @RequestBody ReportRequestDto.ReportCreateReq request,
             @RequestParam Long userId
     ) {
         ReportResponseDto.ReportCreateRes response = reportService.createReport(request,userId);
@@ -31,6 +33,7 @@ public ApiResponse<ReportResponseDto.ReportCreateRes> createReport(
 
 
     //신고 취소 API
+    @Override
     @DeleteMapping("/{reportId}")
     public ApiResponse<Void> deleteReport(
             @PathVariable Long reportId,
diff --git a/src/main/java/com/example/leets7th/domain/report/controller/ReportControllerDocs.java b/src/main/java/com/example/leets7th/domain/report/controller/ReportControllerDocs.java
new file mode 100644
index 00000000..83cc6f81
--- /dev/null
+++ b/src/main/java/com/example/leets7th/domain/report/controller/ReportControllerDocs.java
@@ -0,0 +1,45 @@
+package com.example.leets7th.domain.report.controller;
+
+
+import com.example.leets7th.domain.report.dto.ReportRequestDto;
+import com.example.leets7th.domain.report.dto.ReportResponseDto;
+import com.example.leets7th.global.annotation.ApiErrorResponse;
+import com.example.leets7th.global.code.ErrorCode;
+import com.example.leets7th.global.response.ApiResponse;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+@Tag(name = "Report",description = "신고 API")
+public interface ReportControllerDocs {
+
+
+
+    @Operation(summary = "신고 생성",description = "새로운 신고를 접수합니다.")
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "201",description = "신고가 접수되었습니다.")
+    @ApiErrorResponse({
+            ErrorCode.SELF_REPORT,
+            ErrorCode.REPORT_ALREADY_EXIST,
+            ErrorCode.UNSUPPORTED_CONTENT_TYPE
+    })
+    ApiResponse<ReportResponseDto.ReportCreateRes> createReport(
+            ReportRequestDto.ReportCreateReq request,
+            Long userId
+    );
+
+
+
+
+    @Operation(summary = "신고 삭제",description = "신고를 취소합니다.")
+    @io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "200",description = "신고가 취소되었습니다.")
+    @ApiErrorResponse({
+            ErrorCode.REPORT_NOT_FOUND,
+            ErrorCode.REPORT_DELETE_NO_PERMISSION,
+            ErrorCode.REPORT_ALREADY_HANDLED
+    })
+    ApiResponse<Void> deleteReport(
+            Long reportId,
+            Long userId
+    );
+
+}
diff --git a/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java b/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java
index bc5a3612..eb25f945 100644
--- a/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java
+++ b/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java
@@ -1,7 +1,9 @@
 package com.example.leets7th.global.annotation;
 
 
+
 import com.example.leets7th.global.code.ErrorCode;
+import com.example.leets7th.global.common.BaseCode;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
diff --git a/src/main/java/com/example/leets7th/global/code/ErrorCode.java b/src/main/java/com/example/leets7th/global/code/ErrorCode.java
index 583c0aba..9ba0226e 100644
--- a/src/main/java/com/example/leets7th/global/code/ErrorCode.java
+++ b/src/main/java/com/example/leets7th/global/code/ErrorCode.java
@@ -9,28 +9,40 @@
 @RequiredArgsConstructor(access = AccessLevel.PRIVATE)
 @Getter
 public enum ErrorCode implements BaseCode {
+
+    //Common
     INTERNAL_SERVER_ERROR(HttpStatus.INTERNAL_SERVER_ERROR,"COMMON500_1","예기치 않은 서버 에러가 발생했습니다."),
     BAD_REQUEST(HttpStatus.BAD_REQUEST,"COMMON400_1","잘못된 요청입니다."),
+    UNSUPPORTED_TYPE(HttpStatus.BAD_REQUEST,"COMMON400_2","지원하지 않는 타입입니다."),
     VALIDATION_ERROR(HttpStatus.BAD_REQUEST,"COMMON400_3","입력값이 유효하지 않습니다."),
     UNAUTHORIZED(HttpStatus.UNAUTHORIZED,"AUTH401_1","인증이 필요합니다."),
     ACCESS_DENIED(HttpStatus.FORBIDDEN,"AUTH403_1","요청이 거부되었습니다."),
 
 
 
+    //User
     USER_NOT_FOUND(HttpStatus.NOT_FOUND,"USER404_1","존재하지 않는 유저입니다."),
 
 
+
+    //Post
     POST_INPUT_NO_VALIDATION(HttpStatus.BAD_REQUEST,"POST400_3","입력값이 유효하지 않습니다."),
     POST_UPDATE_NO_PERMISSION(HttpStatus.FORBIDDEN,"POST403_1","수정 권한이 없습니다."),
     POST_DELETE_NO_PERMISSION(HttpStatus.FORBIDDEN,"POST403_2","삭제 권한이 없습니다."),
     POST_NOT_FOUND(HttpStatus.NOT_FOUND,"POST404_1","해당 게시글이 존재하지 않습니다."),
 
+
+
+    //Comment
     COMMENT_NOT_FOUND(HttpStatus.NOT_FOUND,"COMMENT_404_1","해당 댓글이 존재하지 않습니다."),
 
 
 
 
-    REPORT_ALREADY_EXIST(HttpStatus.BAD_REQUEST,"REPORT400_1","이미 신고한 대상입니다."),
+
+
+    //Report
+    REPORT_ALREADY_EXIST(HttpStatus.BAD_REQUEST,"REPORT400_1","이미 접수된 신고입니다."),
     SELF_REPORT(HttpStatus.BAD_REQUEST,"REPORT400_2","신고할 수 없는 대상입니다."),
     REPORT_ALREADY_HANDLED(HttpStatus.BAD_REQUEST,"REPORT400_3","이미 처리된 신고입니다."),
     REPORT_DELETE_NO_PERMISSION(HttpStatus.FORBIDDEN,"REPORT403_1","취소 권한이 없습니다."),
diff --git a/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java b/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java
index b50333d6..396ae99a 100644
--- a/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java
+++ b/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java
@@ -2,6 +2,7 @@
 
 import com.example.leets7th.global.annotation.ApiErrorResponse;
 import com.example.leets7th.global.code.ErrorCode;
+import com.example.leets7th.global.common.BaseCode;
 import io.swagger.v3.oas.models.Operation;
 import io.swagger.v3.oas.models.examples.Example;
 import io.swagger.v3.oas.models.media.Content;
@@ -15,22 +16,25 @@
 @Component
 public class SwaggerErrorCustomizer implements OperationCustomizer {
 
+    //에러코드 주입
     @Override
     public Operation customize(Operation operation,HandlerMethod handlerMethod) {
 
+        //메서드에서 어노테이션 추출
         ApiErrorResponse apiErrorResponse = handlerMethod.getMethodAnnotation(ApiErrorResponse.class);
 
         if(apiErrorResponse == null) {
             return operation;
         }
 
-        ApiResponses apiResponses = operation.getResponses();
 
         for(ErrorCode errorCode : apiErrorResponse.value()) {
+            //에러 코드 변수 추출
             String status = String.valueOf(errorCode.getStatus().value());
             String code = errorCode.getCode();
             String message = errorCode.getMessage();
 
+            //
             Example example = new Example();
             java.util.Map<String, Object> exampleValue = new java.util.LinkedHashMap<>();
             exampleValue.put("success", false);
@@ -42,9 +46,13 @@ public Operation customize(Operation operation,HandlerMethod handlerMethod) {
             example.setDescription(message);
 
 
+            //
+
+            ApiResponses apiResponses = operation.getResponses();
+
             ApiResponse apiResponse = apiResponses.containsKey(status)
                     ? apiResponses.get(status)
-                    : new ApiResponse().description("에러 응답");
+                    : new ApiResponse().description("");
 
 
 
diff --git a/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java b/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java
index 6fd4d7fe..376f4421 100644
--- a/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java
+++ b/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java
@@ -2,14 +2,15 @@
 
 
 
-import com.example.leets7th.domain.post.exception.PostException;
 import com.example.leets7th.global.code.ErrorCode;
 import com.example.leets7th.global.response.ApiResponse;
+import org.springframework.http.HttpStatus;
 import org.springframework.http.ResponseEntity;
 import org.springframework.validation.FieldError;
 import org.springframework.web.bind.MethodArgumentNotValidException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
+import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -27,12 +28,23 @@ public ResponseEntity<ApiResponse<List<ErrorResponseDto.ValidationErrorDto>>> ha
         }
 
 
-        return ResponseEntity.badRequest().body(ApiResponse.failure(ErrorCode.VALIDATION_ERROR,validationErrors));
+        return ResponseEntity
+                .status(ErrorCode.VALIDATION_ERROR.getStatus())
+                .body(ApiResponse.failure(ErrorCode.VALIDATION_ERROR,validationErrors));
+    }
+
+    @ExceptionHandler(MethodArgumentTypeMismatchException.class)
+    public ResponseEntity<ApiResponse<?>> handleTypeMismatchException(MethodArgumentTypeMismatchException ex) {
+        return ResponseEntity
+                .status(ErrorCode.UNSUPPORTED_TYPE.getStatus())
+                .body(ApiResponse.failure(ErrorCode.UNSUPPORTED_TYPE));
     }
 
     @ExceptionHandler(GlobalException.class)
     public ResponseEntity<ApiResponse<Void>> handleGlobalException(GlobalException ex) {
-        return ResponseEntity.status(ex.getBaseCode().getStatus()).body(ApiResponse.failure(ex.getBaseCode()));
+        return ResponseEntity
+                .status(ex.getBaseCode().getStatus())
+                .body(ApiResponse.failure(ex.getBaseCode()));
     }
 
 
diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties
index 2109a440..9683ea18 100644
--- a/src/main/resources/application.properties
+++ b/src/main/resources/application.properties
@@ -1 +1,8 @@
 spring.application.name=demo
+
+
+
+
+
+//sqldata ????
+spring.jpa.defer-datasource-initialization=true
\ No newline at end of file
diff --git a/src/main/resources/data.sql b/src/main/resources/data.sql
new file mode 100644
index 00000000..4e345864
--- /dev/null
+++ b/src/main/resources/data.sql
@@ -0,0 +1,9 @@
+INSERT INTO users (login_id,name,password,email,created_at,updated_at)
+VALUES
+    ('login1','홍길동1','1111','111@gmail.com',NOW(),NOW()),
+    ('login2','홍길동2','2222','222@naver.com',NOW(),NOW());
+
+
+INSERT INTO posts (title,content,user_id,created_at,updated_at)
+VALUES
+    ('제목','내용',1,NOW(),NOW());
\ No newline at end of file

From 333766888ad8f691354982b8e14b6478ef3caf46 Mon Sep 17 00:00:00 2001
From: Nanajun22 <skaudwns3@gmail.com>
Date: Sat, 2 May 2026 18:40:23 +0900
Subject: [PATCH 2/2] =?UTF-8?q?=EC=A3=BC=EC=84=9D=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .idea/workspace.xml                             | 17 +----------------
 .../global/annotation/ApiErrorResponse.java     |  2 +-
 .../global/config/SwaggerErrorCustomizer.java   | 15 ++++++++++-----
 3 files changed, 12 insertions(+), 22 deletions(-)

diff --git a/.idea/workspace.xml b/.idea/workspace.xml
index c9d5fc2d..1438f96a 100644
--- a/.idea/workspace.xml
+++ b/.idea/workspace.xml
@@ -5,24 +5,9 @@
   </component>
   <component name="ChangeListManager">
     <list default="true" id="1fe1570b-38b0-4a5d-8519-5916e0d6f809" name="변경" comment="">
-      <change afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminControllerDocs.java" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportControllerDocs.java" afterDir="false" />
-      <change afterPath="$PROJECT_DIR$/src/main/resources/data.sql" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/.idea/workspace.xml" beforeDir="false" afterPath="$PROJECT_DIR$/.idea/workspace.xml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/comment/strategy/CommentStrategy.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/Service/PostService.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/Service/PostService.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostController.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostController.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/controller/PostControllerDocs.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/dto/PostRequestDto.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/exception/PostException.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/error/PostException.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/post/strategy/PostReportStrategy.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportAdminController.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/domain/report/controller/ReportController.java" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/code/ErrorCode.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/code/ErrorCode.java" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/java/com/example/leets7th/global/error/GlobalExceptionHandler.java" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/main/resources/application.properties" beforeDir="false" afterPath="$PROJECT_DIR$/src/main/resources/application.properties" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
@@ -161,7 +146,7 @@
       <updated>1773935593667</updated>
       <workItem from="1773935594836" duration="24032000" />
       <workItem from="1777027069393" duration="60578000" />
-      <workItem from="1777559366574" duration="16855000" />
+      <workItem from="1777559366574" duration="22655000" />
     </task>
     <servers />
   </component>
diff --git a/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java b/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java
index eb25f945..4cbd33ec 100644
--- a/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java
+++ b/src/main/java/com/example/leets7th/global/annotation/ApiErrorResponse.java
@@ -3,13 +3,13 @@
 
 
 import com.example.leets7th.global.code.ErrorCode;
-import com.example.leets7th.global.common.BaseCode;
 
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+
 @Target(ElementType.METHOD)
 @Retention(RetentionPolicy.RUNTIME)
 public @interface ApiErrorResponse {
diff --git a/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java b/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java
index 396ae99a..a7c67a6b 100644
--- a/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java
+++ b/src/main/java/com/example/leets7th/global/config/SwaggerErrorCustomizer.java
@@ -13,10 +13,11 @@
 import org.springframework.stereotype.Component;
 import org.springframework.web.method.HandlerMethod;
 
+
 @Component
 public class SwaggerErrorCustomizer implements OperationCustomizer {
 
-    //에러코드 주입
+    //Operation 커스터마이징 메서드
     @Override
     public Operation customize(Operation operation,HandlerMethod handlerMethod) {
 
@@ -34,7 +35,7 @@ public Operation customize(Operation operation,HandlerMethod handlerMethod) {
             String code = errorCode.getCode();
             String message = errorCode.getMessage();
 
-            //
+            //예시 응답 객체 세팅
             Example example = new Example();
             java.util.Map<String, Object> exampleValue = new java.util.LinkedHashMap<>();
             exampleValue.put("success", false);
@@ -43,18 +44,22 @@ public Operation customize(Operation operation,HandlerMethod handlerMethod) {
 
             example.setValue(exampleValue);
 
-            example.setDescription(message);
 
 
-            //
+            //현재 API 에서 응답 객체 가져오기
+            /*
+            ApiResponses = ApiResponse 들의 컬렉션
+            ApiResponse = 상태 코드 하나의 응답 정보를 담는 객체
+             */
 
             ApiResponses apiResponses = operation.getResponses();
 
             ApiResponse apiResponse = apiResponses.containsKey(status)
                     ? apiResponses.get(status)
-                    : new ApiResponse().description("");
+                    : new ApiResponse().description(message);
 
 
+            //ApiResponse 객체 조립
 
             Content content =  apiResponse.getContent() != null ? apiResponse.getContent() : new Content();
             MediaType mediaType = content.containsKey("application/json") ? content.get("application/json") : new MediaType();