From 28cf27c18ab2ec89ca0b4871adb51c6fab66920c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=84=8B=E1=85=B5=E1=84=80=E1=85=A1=E1=84=8B=E1=85=A7?= =?UTF-8?q?=E1=86=AB?= Date: Fri, 7 Aug 2026 01:24:12 +0900 Subject: [PATCH 1/2] =?UTF-8?q?refactor:=20=EC=A1=B0=ED=9A=8C=20API=20Swag?= =?UTF-8?q?ger=20=EC=BF=BC=EB=A6=AC=20=ED=8C=8C=EB=9D=BC=EB=AF=B8=ED=84=B0?= =?UTF-8?q?=20=ED=91=9C=EC=8B=9C=20=EB=B0=98=EC=98=81=20#268?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../backend/domain/course/controller/CourseController.java | 2 +- .../backend/domain/review/controller/ReviewController.java | 3 ++- .../domain/travel/controller/TravelRecordController.java | 3 ++- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/src/main/java/com/yeogido/backend/domain/course/controller/CourseController.java b/src/main/java/com/yeogido/backend/domain/course/controller/CourseController.java index 78b2c4bd..ff67a5d7 100644 --- a/src/main/java/com/yeogido/backend/domain/course/controller/CourseController.java +++ b/src/main/java/com/yeogido/backend/domain/course/controller/CourseController.java @@ -168,7 +168,7 @@ public ApiResponse getCourseSummary( public ApiResponse> getCourseReviews( @Parameter(description = "코스 ID", example = "1") @PathVariable Long courseId, - @Valid @ModelAttribute CourseReqDTO.CourseReviewListReq request + @Valid @ParameterObject @ModelAttribute CourseReqDTO.CourseReviewListReq request ) { CursorResponse response = courseService.getCourseReviews( courseId, diff --git a/src/main/java/com/yeogido/backend/domain/review/controller/ReviewController.java b/src/main/java/com/yeogido/backend/domain/review/controller/ReviewController.java index 8d95cd75..85ef01d0 100644 --- a/src/main/java/com/yeogido/backend/domain/review/controller/ReviewController.java +++ b/src/main/java/com/yeogido/backend/domain/review/controller/ReviewController.java @@ -20,6 +20,7 @@ import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RestController; +import org.springdoc.core.annotations.ParameterObject; @Tag(name = "Review", description = "리뷰 관련 API") @RestController @@ -46,7 +47,7 @@ public ApiResponse getRecentReviews() { @GetMapping public ApiResponse> getReviews( @AuthenticationPrincipal AuthUser authUser, - @Valid @ModelAttribute ReviewReqDTO.ListRequest request + @Valid @ParameterObject @ModelAttribute ReviewReqDTO.ListRequest request ) { Long userId = authUser == null ? null diff --git a/src/main/java/com/yeogido/backend/domain/travel/controller/TravelRecordController.java b/src/main/java/com/yeogido/backend/domain/travel/controller/TravelRecordController.java index b34dd81c..aac1a60a 100644 --- a/src/main/java/com/yeogido/backend/domain/travel/controller/TravelRecordController.java +++ b/src/main/java/com/yeogido/backend/domain/travel/controller/TravelRecordController.java @@ -21,6 +21,7 @@ import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; +import org.springdoc.core.annotations.ParameterObject; @Tag(name = "TravelRecord", description = "여행 기록 관련 API") @RestController @@ -37,7 +38,7 @@ public class TravelRecordController { @GetMapping public ApiResponse> getMyTravelRecords( @AuthenticationPrincipal AuthUser authUser, - @ModelAttribute TravelRecordReqDTO.ListRequest request + @ParameterObject @ModelAttribute TravelRecordReqDTO.ListRequest request ) { CursorResponse result = travelRecordService.getMyTravelRecords(authUser.userId(), request); From 04d7548ffa6d0c2f873245dab1b45534becd79ea Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E1=84=8B=E1=85=B5=E1=84=80=E1=85=A1=E1=84=8B=E1=85=A7?= =?UTF-8?q?=E1=86=AB?= Date: Fri, 7 Aug 2026 01:38:18 +0900 Subject: [PATCH 2/2] =?UTF-8?q?Swagger=20=EC=A4=91=EB=B3=B5=20=ED=91=9C?= =?UTF-8?q?=EC=8B=9C=20=EC=A0=9C=EA=B1=B0=20#268?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../yeogido/backend/domain/course/dto/request/CourseReqDTO.java | 2 +- .../yeogido/backend/domain/review/dto/request/ReviewReqDTO.java | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/main/java/com/yeogido/backend/domain/course/dto/request/CourseReqDTO.java b/src/main/java/com/yeogido/backend/domain/course/dto/request/CourseReqDTO.java index cb51b23a..dde3028f 100644 --- a/src/main/java/com/yeogido/backend/domain/course/dto/request/CourseReqDTO.java +++ b/src/main/java/com/yeogido/backend/domain/course/dto/request/CourseReqDTO.java @@ -232,7 +232,7 @@ public record CourseReviewListReq( @Schema(description = "조회할 리뷰 개수", example = "10", defaultValue = "10") Integer size, - @Schema(description = "정렬 기준", example = "LATEST", allowableValues = {"LATEST", "RATING"}, defaultValue = "LATEST") + @Schema(description = "정렬 기준", example = "LATEST", defaultValue = "LATEST") ReviewSortType sort ) { } diff --git a/src/main/java/com/yeogido/backend/domain/review/dto/request/ReviewReqDTO.java b/src/main/java/com/yeogido/backend/domain/review/dto/request/ReviewReqDTO.java index 0abd3375..7c786c89 100644 --- a/src/main/java/com/yeogido/backend/domain/review/dto/request/ReviewReqDTO.java +++ b/src/main/java/com/yeogido/backend/domain/review/dto/request/ReviewReqDTO.java @@ -22,7 +22,7 @@ public record ListRequest( @Min(value = 1, message = "size는 1 이상이어야 합니다.") Integer size, - @Schema(description = "정렬 기준", example = "LATEST", allowableValues = {"LATEST", "RATING"}, defaultValue = "LATEST") + @Schema(description = "정렬 기준", example = "LATEST", defaultValue = "LATEST") ReviewSortType sort ) { }