Merge pull request #64 from Leets-Official/refactor/filter-search

[refactor] 도서 필터 검색 로직 수정

Author: eun-seoo

src/main/kotlin/com/stepbookstep/server/domain/book/application/BookQueryService.kt

@@ -75,21 +75,36 @@ class BookQueryService(
         level: Int?,
         pageRanges: List<String>?,
         origin: String?,
-        genre: String?
+        genre: String?,
+        keyword: String?,
+        cursor: Long?
     ): BookFilterResponse {
+        // 필터 없이 검색어만 입력한 경우 예외 처리
+        val hasFilter = level != null || !pageRanges.isNullOrEmpty() || origin != null || genre != null
+        if (!hasFilter && !keyword.isNullOrBlank()) {
+            throw CustomException(ErrorCode.FILTER_REQUIRED, null)
+        }
+
         // 유효성 검증
         validateFilterParams(level, pageRanges, origin, genre)
 
         val spec = Specification.where(BookSpecification.withLevel(level))
             .and(BookSpecification.withPageRange(pageRanges))
             .and(BookSpecification.withOrigin(origin))
             .and(BookSpecification.withGenre(genre))
+            .and(BookSpecification.withKeyword(keyword))
+            .and(BookSpecification.withCursor(cursor))
+
+        // PAGE_SIZE + 1개 조회하여 다음 페이지 존재 여부 확인
+        val pageable = PageRequest.of(0, PAGE_SIZE + 1, Sort.by(Sort.Direction.ASC, "id"))
+        val result = bookRepository.findAll(spec, pageable).content
 
-        val pageable = PageRequest.of(0, PAGE_SIZE, Sort.by(Sort.Direction.DESC, "createdAt"))
-        val result = bookRepository.findAll(spec, pageable)
+        val hasNext = result.size > PAGE_SIZE
+        val books = if (hasNext) result.dropLast(1) else result
 
         return BookFilterResponse.of(
-            books = result.content
+            books = books,
+            hasNext = hasNext
         )
     }
 

src/main/kotlin/com/stepbookstep/server/domain/book/domain/BookSpecification.kt

@@ -79,4 +79,44 @@ object BookSpecification {
             }
         }
     }
+
+    /**
+     * 키워드 검색 필터 (제목, 저자, 출판사)
+     * 공백으로 구분된 각 키워드가 title/author/publisher 중 하나에 포함되면 검색됨
+     */
+    fun withKeyword(keyword: String?): Specification<Book> {
+        return Specification { root, _, cb ->
+            if (keyword.isNullOrBlank()) {
+                null
+            } else {
+                val keywords = keyword.trim().split("\\s+".toRegex()).filter { it.isNotBlank() }
+                if (keywords.isEmpty()) {
+                    null
+                } else {
+                    val keywordPredicates = keywords.map { word ->
+                        val pattern = "%$word%"
+                        cb.or(
+                            cb.like(root.get("title"), pattern),
+                            cb.like(root.get("author"), pattern),
+                            cb.like(root.get("publisher"), pattern)
+                        )
+                    }
+                    cb.and(*keywordPredicates.toTypedArray())
+                }
+            }
+        }
+    }
+
+    /**
+     * 커서 기반 페이지네이션 (id > cursor)
+     */
+    fun withCursor(cursor: Long?): Specification<Book> {
+        return Specification { root, _, cb ->
+            if (cursor == null) {
+                null
+            } else {
+                cb.greaterThan(root.get("id"), cursor)
+            }
+        }
+    }
 }

src/main/kotlin/com/stepbookstep/server/domain/book/presentation/BookController.kt

@@ -63,16 +63,24 @@ class BookController(
     @Operation(
         summary = "도서 필터 검색",
         description = """
-            선택한 필터 조건에 맞는 도서 목록을 조회합니다. (최대 20권씩 페이징)
+            선택한 필터 조건에 맞는 도서 목록을 조회합니다.
 
             ## 필터 옵션
             - **level**: 난이도 (1, 2, 3)
             - **pageRange**: 분량 (~200, 201~250, 251~350, 351~500, 501~650, 651~) - 중복 선택 가능
             - **origin**: 국가별 (한국소설, 영미소설, 중국소설, 일본소설, 프랑스소설, 독일소설)
             - **genre**: 장르별 (로맨스, 희곡, 무협소설, 판타지/환상문학, 역사소설, 라이트노벨, 추리/미스터리, 과학소설(SF), 액션/스릴러, 호러/공포소설)
+            - **keyword**: 검색어 (제목, 저자, 출판사에서 검색) - 필터 선택 후 사용 가능
+
+            ## 페이지네이션 
+            - **cursor**: 마지막으로 조회한 bookId (첫 요청 시 생략)
+            - **size**: 조회할 개수 (고정값 20)
+            - **hasNext**: 다음 페이지 존재 여부
+            - 정렬: id 오름차순
 
             모든 필터는 선택 사항이며, 복수 필터 적용 시 AND 조건으로 검색됩니다.
             pageRange는 중복 선택 시 OR 조건으로 검색됩니다.
+            keyword 입력 시 필터링된 결과 내에서 추가로 검색됩니다.
             유효하지 않은 필터 값을 입력하면 400 Bad Request 에러가 반환됩니다.
         """
     )
@@ -81,9 +89,11 @@ class BookController(
         @Parameter(description = "난이도") @RequestParam(required = false) level: Int?,
         @Parameter(description = "분량 (중복 선택 가능)") @RequestParam(required = false) pageRange: List<String>?,
         @Parameter(description = "국가별 분류") @RequestParam(required = false) origin: String?,
-        @Parameter(description = "장르별 분류") @RequestParam(required = false) genre: String?
+        @Parameter(description = "장르별 분류") @RequestParam(required = false) genre: String?,
+        @Parameter(description = "검색어 (제목, 저자, 출판사)") @RequestParam(required = false) keyword: String?,
+        @Parameter(description = "마지막으로 조회한 bookId (첫 요청 시 생략)") @RequestParam(required = false) cursor: Long?
     ): ResponseEntity<ApiResponse<BookFilterResponse>> {
-        val response = bookQueryService.filter(level, pageRange, origin, genre)
+        val response = bookQueryService.filter(level, pageRange, origin, genre, keyword, cursor)
         return ResponseEntity.ok(ApiResponse.ok(response))
     }
 }

src/main/kotlin/com/stepbookstep/server/domain/book/presentation/dto/BookFilterResponse.kt

@@ -3,12 +3,14 @@ package com.stepbookstep.server.domain.book.presentation.dto
 import com.stepbookstep.server.domain.book.domain.Book
 
 data class BookFilterResponse(
-    val books: List<BookFilterItem>
+    val books: List<BookFilterItem>,
+    val hasNext: Boolean
 ) {
     companion object {
-        fun of(books: List<Book>): BookFilterResponse {
+        fun of(books: List<Book>, hasNext: Boolean): BookFilterResponse {
             return BookFilterResponse(
-                books = books.map { BookFilterItem.from(it) }
+                books = books.map { BookFilterItem.from(it) },
+                hasNext = hasNext
             )
         }
     }

src/main/kotlin/com/stepbookstep/server/global/response/ErrorCode.kt

@@ -112,6 +112,8 @@ enum class ErrorCode(
     INVALID_ORIGIN(2005, HttpStatus.BAD_REQUEST, "유효하지 않은 국가입니다."),
     INVALID_GENRE(2006, HttpStatus.BAD_REQUEST, "유효하지 않은 장르입니다."),
     USER_BOOK_NOT_FOUND(2007, HttpStatus.NOT_FOUND,"서재에 해당 도서가 존재하지 않습니다."),
+    FILTER_REQUIRED(2008, HttpStatus.BAD_REQUEST, "필터를 하나 이상 선택해주세요."),
+    NO_MORE_BOOKS(2009, HttpStatus.BAD_REQUEST, "마지막 페이지입니다."),
 
     // ========================
     // 3000~3999 : 루틴 관련 에러