feat(filters): Routes of filters

Routes dedicated to filter
the information about
tasks from projects.

Author: matheusAFONSECA

src/routes/filter_routes.py

@@ -9,7 +9,7 @@
 from src.models.task_model import Task
 from src.schemas.projects.projects_schema import ProjectResponse
 from src.schemas.tasks.tasks_schema import TaskResponse
-from src.utils.security import get_current_user 
+from src.utils.security import get_current_user
 
 router = APIRouter(
     prefix="/filters",
@@ -26,26 +26,33 @@ def filter_tasks(
     current_user: User = Depends(get_current_user)
 ):
     """
-    Retorna as tarefas pertencentes aos projetos do usuário logado.
-    É possível aplicar filtros por status, lembrete e data de vencimento.
+    Return tasks filtered by completion status, reminder flag, and due date,
+    only for tasks belonging to projects owned by the authenticated user.
+
+    Args:
+        completed (Optional[bool]): Filter by completion status.
+        reminder (Optional[bool]): Filter by reminder flag.
+        due_before (Optional[date]): Filter tasks due before this date.
+        db (Session): Database session.
+        current_user (User): Authenticated user.
+
+    Returns:
+        List[Task]: List of filtered tasks.
+
+    Raises:
+        HTTPException: If no tasks are found.
     """
 
-    # Busca apenas as tarefas de projetos pertencentes ao usuário autenticado
     query = (
         db.query(Task)
         .join(Project, Project.id == Task.project_id)
-        .filter(Project.owner_id == current_user.id)
+        .filter(Project.user_id == current_user.id)
     )
 
-    # Filtro por status de conclusão
     if completed is not None:
         query = query.filter(Task.completed == completed)
-
-    # Filtro por lembrete
     if reminder is not None:
         query = query.filter(Task.reminder == reminder)
-
-    # Filtro por data de entrega
     if due_before:
         query = query.filter(Task.due_date <= due_before)
 
@@ -58,10 +65,22 @@ def get_projects_by_user(
     current_user: User = Depends(get_current_user)
 ):
     """
-    Retorna todos os projetos pertencentes ao usuário autenticado.
+    Return all projects belonging to the authenticated user.
+
+    Args:
+        db (Session): Database session.
+        current_user (User): Authenticated user.
+
+    Returns:
+        List[Project]: List of projects owned by the user.
+
+    Raises:
+        HTTPException: If no projects are found.
     """
 
-    projects = db.query(Project).filter(Project.owner_id == current_user.id).all()
+    projects = db.query(Project).filter(Project.user_id == current_user.id).all()
+    if not projects:
+        raise HTTPException(status_code=404, detail="No projects found.")
     return projects
 
 
@@ -72,11 +91,22 @@ def get_tasks_by_project(
     current_user: User = Depends(get_current_user)
 ):
     """
-    Retorna todas as tarefas de um projeto específico,
-    desde que o projeto pertença ao usuário autenticado.
+    Return all tasks for a specific project,
+    only if the project belongs to the authenticated user.
+
+    Args:
+        project_id (int): ID of the project.
+        db (Session): Database session.
+        current_user (User): Authenticated user.
+
+    Returns:
+        List[Task]: List of tasks for the specified project.
+
+    Raises:
+        HTTPException: If the project is not found or not owned by the user.
     """
 
-    project = db.query(Project).filter(Project.id == project_id, Project.owner_id == current_user.id).first()
+    project = db.query(Project).filter(Project.id == project_id, Project.user_id == current_user.id).first()
     if not project:
         raise HTTPException(status_code=404, detail="Project not found or not owned by user")
 
@@ -93,14 +123,28 @@ def advanced_filter_tasks(
     current_user: User = Depends(get_current_user)
 ):
     """
-    Filtro avançado de tarefas relacionadas ao usuário autenticado.
-    Permite combinar múltiplos parâmetros de busca.
+    Advanced filtering for tasks related to the authenticated user.
+    Allows combining multiple search parameters.
+
+    Args:
+        completed (Optional[bool]): Filter by completion status.
+        reminder (Optional[bool]): Filter by reminder flag.
+        project_id (Optional[int]): Filter by project ID.
+        due_before (Optional[date]): Filter tasks due before this date.
+        db (Session): Database session.
+        current_user (User): Authenticated user.
+
+    Returns:    
+        List[Task]: List of filtered tasks.
+
+    Raises:
+        HTTPException: If no tasks are found.
     """
 
     query = (
         db.query(Task)
         .join(Project, Project.id == Task.project_id)
-        .filter(Project.owner_id == current_user.id)
+        .filter(Project.user_id == current_user.id)
     )
 
     if completed is not None: