refactor: apis - 기본정렬과 동적정렬 UPDATE시간으로도 가능하도록 수정 (#125)

Author: minwoo1999

apis/src/main/kotlin/org/yapp/apis/book/controller/BookControllerApi.kt

@@ -158,7 +158,11 @@ interface BookControllerApi {
         @RequestParam(required = false) @Parameter(description = "책 상태 필터") status: BookStatus?,
         @RequestParam(required = false) @Parameter(description = "정렬 방식") sort: UserBookSortType?,
         @RequestParam(required = false) @Parameter(description = "책 제목 검색") title: String?,
-        @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
+        @Parameter(
+            description = "페이징 정보 (기본값: 10개, 최신 수정일 순)",
+            example = "?page=0&size=10&sort=updatedAt,desc"
+        )
+        @PageableDefault(size = 10, sort = ["updatedAt"], direction = Sort.Direction.DESC)
         pageable: Pageable
     ): ResponseEntity<UserBookPageResponse>
 

apis/src/main/kotlin/org/yapp/apis/readingrecord/controller/ReadingRecordControllerApi.kt

@@ -105,8 +105,8 @@ interface ReadingRecordControllerApi {
         @AuthenticationPrincipal @Parameter(description = "인증된 사용자 ID") userId: UUID,
         @PathVariable @Parameter(description = "독서 기록을 조회할 사용자 책 ID") userBookId: UUID,
         @RequestParam(required = false) @Parameter(description = "정렬 방식 (PAGE_NUMBER_ASC, PAGE_NUMBER_DESC, CREATED_DATE_ASC, CREATED_DATE_DESC)") sort: ReadingRecordSortType?,
-        @PageableDefault(size = 10, sort = ["createdAt"], direction = Sort.Direction.DESC)
-        @Parameter(description = "페이지네이션 정보 (페이지 번호, 페이지 크기, 정렬 방식)") pageable: Pageable
+        @PageableDefault(size = 10, sort = ["updatedAt"], direction = Sort.Direction.DESC)
+        @Parameter(description = "페이지네이션 정보 (기본값: 10개, 최신 수정일 순)") pageable: Pageable
     ): ResponseEntity<ReadingRecordPageResponse>
 
     @Operation(

domain/src/main/kotlin/org/yapp/domain/userbook/UserBookSortType.kt

@@ -5,5 +5,7 @@ enum class UserBookSortType {
     TITLE_ASC,
     TITLE_DESC,
     CREATED_DATE_ASC,
-    CREATED_DATE_DESC;
+    CREATED_DATE_DESC,
+    UPDATED_DATE_ASC,
+    UPDATED_DATE_DESC;
 }

infra/src/main/kotlin/org/yapp/infra/userbook/repository/impl/JpaUserBookQuerydslRepositoryImpl.kt

@@ -164,7 +164,9 @@ class JpaUserBookQuerydslRepositoryImpl(
             UserBookSortType.TITLE_DESC -> userBook.title.desc()
             UserBookSortType.CREATED_DATE_ASC -> userBook.createdAt.asc()
             UserBookSortType.CREATED_DATE_DESC -> userBook.createdAt.desc()
-            null -> userBook.createdAt.desc()
+            UserBookSortType.UPDATED_DATE_ASC -> userBook.updatedAt.asc()
+            UserBookSortType.UPDATED_DATE_DESC -> userBook.updatedAt.desc()
+            null -> userBook.updatedAt.desc()
         }
     }
 }