[Feature] Add search by title for the my tasks endpoint (#553)

* feat: add support for optional search in getAllTasks method

* feat: implement optional search in getAllTasks method

* feat: update the db query to support optional search

* feat: update the getMyTasks endpoint to support optional search

* test: update tests for getMyTasks endpoint to include search parameter

* fix: swagger description for getMyTasks endpoint

Author: solenuk

src/main/java/com/itasocialacademy/oitassist/task/controller/TaskController.java

@@ -90,8 +90,8 @@ public ResponseEntity<PageResponse<TaskResponseDTO>> getAllTasks(
 
     @Operation(
         summary = "Get current user's tasks",
-        description = "Retrieves all tasks owned by the currently authenticated user with pagination support."
-            + "Requires ADMIN or ORG role.")
+        description = "Retrieves all tasks owned by the currently authenticated user "
+            + "with pagination support and optional search by title. Requires ADMIN or ORG role.")
     @ApiResponses(value = {
         @ApiResponse(responseCode = "200", description = "User's tasks retrieved successfully",
             content = @Content(mediaType = "application/json",
@@ -104,8 +104,11 @@ public ResponseEntity<PageResponse<TaskResponseDTO>> getAllTasks(
     @GetMapping("/my")
     @PreAuthorize("hasAnyRole('ADMIN', 'ORG')")
     public ResponseEntity<PageResponse<TaskResponseDTO>> getMyTasks(
-        @ParameterObject @PageableDefault(size = 15, sort = "createdAt") Pageable pageable) {
-        return ResponseEntity.ok(PageResponse.from(taskService.getAllMyTasks(pageable)));
+        @ParameterObject @PageableDefault(size = 15, sort = "createdAt") Pageable pageable,
+        @Parameter(
+            description = "Optional search query for filtering tasks by title",
+            example = "PowerPoint") @RequestParam(required = false) String search) {
+        return ResponseEntity.ok(PageResponse.from(taskService.getAllMyTasks(pageable, search)));
     }
 
     @Operation(

src/main/java/com/itasocialacademy/oitassist/task/dao/repository/TaskBodyRepository.java

@@ -17,9 +17,9 @@ public interface TaskBodyRepository extends JpaRepository<TaskBody, Long> {
         SELECT t
         FROM TaskBody t
         JOIN t.owners o
-        WHERE o.id.ownerId = :ownerId
+        WHERE o.id.ownerId = :ownerId AND LOWER(t.title) LIKE LOWER(CONCAT('%', :search, '%')) ESCAPE '\\'
         """)
-    Page<TaskBody> findAllByOwnerId(@Param("ownerId") Long ownerId, Pageable pageable);
+    Page<TaskBody> findAllByOwnerId(@Param("ownerId") Long ownerId, @Param("search") String search, Pageable pageable);
 
     @Query(value = "SELECT t.id AS id, t.title AS title FROM TaskBody t WHERE t.id IN :ids")
     List<TaskTitleView> findTitlesByIds(@Param("ids") Collection<Long> taskIds);

src/main/java/com/itasocialacademy/oitassist/task/service/TaskServiceImpl.java

@@ -95,13 +95,7 @@ public Page<TaskResponseDTO> getAllTasks(Pageable pageable, String search) {
         log.debug("getAllTasks: page={}, size={}, sort={} search={}",
             pageable.getPageNumber(), pageable.getPageSize(), pageable.getSort(), search);
 
-        String normalizedSearch = search == null || search.isBlank()
-            ? ""
-            : search.trim()
-                .replaceAll("\\s+", " ")
-                .replace("\\", "\\\\")
-                .replace("%", "\\%")
-                .replace("_", "\\_");
+        String normalizedSearch = getNormalizedSearch(search);
 
         Page<TaskBody> tasksPage = taskBodyRepository.findAllByTitleLike(normalizedSearch, pageable);
 
@@ -110,14 +104,16 @@ public Page<TaskResponseDTO> getAllTasks(Pageable pageable, String search) {
 
     @Override
     @Transactional(readOnly = true)
-    public Page<TaskResponseDTO> getAllMyTasks(Pageable pageable) {
+    public Page<TaskResponseDTO> getAllMyTasks(Pageable pageable, String search) {
         Long currentUserId = securityFacade.getCurrentUserId()
             .orElseThrow(() -> new AuthorizationException("User must be logged in to view created tasks",
                 ErrorCode.ACCESS_DENIED));
-        log.debug("getAllMyTasks: userId={}, page={}, size={}, sort={}",
-            currentUserId, pageable.getPageNumber(), pageable.getPageSize(), pageable.getSort());
+        log.debug("getAllMyTasks: userId={}, page={}, size={}, sort={}, search={}",
+            currentUserId, pageable.getPageNumber(), pageable.getPageSize(), pageable.getSort(), search);
 
-        Page<TaskBody> myTasksPage = taskBodyRepository.findAllByOwnerId(currentUserId, pageable);
+        String normalizedSearch = getNormalizedSearch(search);
+
+        Page<TaskBody> myTasksPage = taskBodyRepository.findAllByOwnerId(currentUserId, normalizedSearch, pageable);
 
         return getResponseBulk(myTasksPage);
     }
@@ -322,4 +318,14 @@ private Map<Long, String> getUserEmailsByIdsInBulk(List<Long> userIds) {
         return userFacade.findByIds(userIds).stream()
             .collect(Collectors.toMap(UserAuthDetails::id, UserAuthDetails::email));
     }
+
+    private String getNormalizedSearch(String search) {
+        return search == null || search.isBlank()
+            ? ""
+            : search.trim()
+                .replaceAll("\\s+", " ")
+                .replace("\\", "\\\\")
+                .replace("%", "\\%")
+                .replace("_", "\\_");
+    }
 }

src/main/java/com/itasocialacademy/oitassist/task/service/interfaces/TaskService.java

@@ -47,14 +47,15 @@ public interface TaskService {
 
     /**
      * Retrieves all tasks belonging to the currently authenticated user with
-     * pagination support.
+     * optional search by title and pagination support.
      *
      * @param pageable pagination and sorting criteria
+     * @param search   optional search query
      * @return a page of tasks for the current user according to the specified
      *         pagination parameters
      * @throws AuthorizationException if the user is not authenticated or logged in
      */
-    Page<TaskResponseDTO> getAllMyTasks(Pageable pageable);
+    Page<TaskResponseDTO> getAllMyTasks(Pageable pageable, String search);
 
     /**
      * Updates a task's title, description and manages file attachments. Only the

src/test/java/com/itasocialacademy/oitassist/task/controller/TaskControllerTest.java

@@ -176,7 +176,7 @@ void getAllTasks_nonAdmin_shouldReturn403() throws Exception {
     @Test
     void getMyTasks_shouldReturnPageResponseAnd200() throws Exception {
         Page<TaskResponseDTO> page = new PageImpl<>(List.of(mockTaskResponse));
-        when(taskService.getAllMyTasks(any(Pageable.class))).thenReturn(page);
+        when(taskService.getAllMyTasks(any(Pageable.class), eq(null))).thenReturn(page);
 
         mockMvc.perform(get("/api/v1/tasks/my")
             .param("page", "0")
@@ -188,7 +188,26 @@ void getMyTasks_shouldReturnPageResponseAnd200() throws Exception {
             .andExpect(jsonPath("$.pageNumber").value(0))
             .andExpect(jsonPath("$.totalElements").value(1));
 
-        verify(taskService).getAllMyTasks(any(Pageable.class));
+        verify(taskService).getAllMyTasks(any(Pageable.class), eq(null));
+    }
+
+    @Test
+    void getMyTasks_withSearch_shouldReturnFilteredPageResponseAnd200() throws Exception {
+        Page<TaskResponseDTO> page = new PageImpl<>(List.of(mockTaskResponse));
+        when(taskService.getAllMyTasks(any(Pageable.class), eq("PowerPoint"))).thenReturn(page);
+
+        mockMvc.perform(get("/api/v1/tasks/my")
+            .param("page", "0")
+            .param("size", "15")
+            .param("search", "PowerPoint"))
+            .andExpect(status().isOk())
+            .andExpect(jsonPath("$.content").isArray())
+            .andExpect(jsonPath("$.content[0].id").value(1L))
+            .andExpect(jsonPath("$.content[0].title").value("PowerPoint Різдвяна зірка"))
+            .andExpect(jsonPath("$.pageNumber").value(0))
+            .andExpect(jsonPath("$.totalElements").value(1));
+
+        verify(taskService).getAllMyTasks(any(Pageable.class), eq("PowerPoint"));
     }
 
     // ---- updateTask ----

src/test/java/com/itasocialacademy/oitassist/task/service/TaskServiceTest.java

@@ -308,18 +308,20 @@ void getAllTasks_whenEmpty_shouldReturnEmptyPage() {
     void getAllMyTasks_shouldReturnCurrentUserTasks() {
         Pageable pageable = PageRequest.of(0, 15);
         Page<TaskBody> expectedRepositoryPage = new PageImpl<>(List.of(taskBody), pageable, 1);
+        String search = " scratch   ";
+        String normalizedSearch = "scratch";
 
         when(securityFacade.getCurrentUserId()).thenReturn(Optional.of(100L));
-        when(taskBodyRepository.findAllByOwnerId(100L, pageable)).thenReturn(expectedRepositoryPage);
+        when(taskBodyRepository.findAllByOwnerId(100L, normalizedSearch, pageable)).thenReturn(expectedRepositoryPage);
         when(fileManagerFacade.getFilesByEntities(any(), eq(List.of(1L)), any())).thenReturn(Map.of(1L, testFiles));
         when(taskBodyMapper.toResponse(taskBody, testFiles, "creator@mail.com")).thenReturn(taskResponse);
 
-        Page<TaskResponseDTO> result = taskService.getAllMyTasks(pageable);
+        Page<TaskResponseDTO> result = taskService.getAllMyTasks(pageable, search);
 
         assertNotNull(result);
         assertEquals(1, result.getTotalElements());
         verify(securityFacade).getCurrentUserId();
-        verify(taskBodyRepository).findAllByOwnerId(100L, pageable);
+        verify(taskBodyRepository).findAllByOwnerId(100L, normalizedSearch, pageable);
         verify(taskBodyMapper).toResponse(taskBody, testFiles, "creator@mail.com");
     }
 
@@ -329,9 +331,9 @@ void getAllMyTasks_notLoggedIn_shouldThrowAuthorizationException() {
 
         when(securityFacade.getCurrentUserId()).thenReturn(Optional.empty());
 
-        assertThrows(AuthorizationException.class, () -> taskService.getAllMyTasks(pageable));
+        assertThrows(AuthorizationException.class, () -> taskService.getAllMyTasks(pageable, null));
 
-        verify(taskBodyRepository, never()).findAllByOwnerId(any(), any());
+        verify(taskBodyRepository, never()).findAllByOwnerId(any(), any(), any());
     }
 
     // ---- updateTask ----