chore: translate all Spanish comments and log messages to English

src/application/ports/inbound.rs

@@ -4,58 +4,58 @@ use crate::application::dtos::folder_dto::{CreateFolderDto, FolderDto, MoveFolde
 use crate::application::dtos::search_dto::{SearchCriteriaDto, SearchResultsDto};
 use crate::common::errors::DomainError;
 
-/// Puerto primario para operaciones de carpetas
+/// Primary port for folder operations
 #[async_trait]
 pub trait FolderUseCase: Send + Sync + 'static {
-    /// Crea una nueva carpeta
+    /// Creates a new folder
     async fn create_folder(&self, dto: CreateFolderDto) -> Result<FolderDto, DomainError>;
     
-    /// Obtiene una carpeta por su ID
+    /// Gets a folder by its ID
     async fn get_folder(&self, id: &str) -> Result<FolderDto, DomainError>;
     
-    /// Obtiene una carpeta por su ruta
+    /// Gets a folder by its path
     async fn get_folder_by_path(&self, path: &str) -> Result<FolderDto, DomainError>;
     
-    /// Lista carpetas dentro de una carpeta padre
+    /// Lists folders within a parent folder
     async fn list_folders(&self, parent_id: Option<&str>) -> Result<Vec<FolderDto>, DomainError>;
     
-    /// Lista carpetas con paginación
+    /// Lists folders with pagination
     async fn list_folders_paginated(
         &self, 
         parent_id: Option<&str>,
         pagination: &crate::application::dtos::pagination::PaginationRequestDto
     ) -> Result<crate::application::dtos::pagination::PaginatedResponseDto<FolderDto>, DomainError>;
     
-    /// Renombra una carpeta
+    /// Renames a folder
     async fn rename_folder(&self, id: &str, dto: RenameFolderDto) -> Result<FolderDto, DomainError>;
     
-    /// Mueve una carpeta a otro padre
+    /// Moves a folder to another parent
     async fn move_folder(&self, id: &str, dto: MoveFolderDto) -> Result<FolderDto, DomainError>;
     
-    /// Elimina una carpeta
+    /// Deletes a folder
     async fn delete_folder(&self, id: &str) -> Result<(), DomainError>;
 }
 
 /**
- * Puerto primario para búsqueda de archivos y carpetas
+ * Primary port for file and folder search
  * 
- * Define las operaciones relacionadas con la búsqueda avanzada de
- * archivos y carpetas basándose en diversos criterios.
+ * Defines the operations related to advanced search of
+ * files and folders based on various criteria.
  */
 #[async_trait]
 pub trait SearchUseCase: Send + Sync + 'static {
     /**
-     * Realiza una búsqueda basada en los criterios especificados
+     * Performs a search based on the specified criteria
      * 
-     * @param criteria Criterios de búsqueda que incluyen texto, fechas, tamaños, etc.
-     * @return Resultados de la búsqueda que contienen archivos y carpetas coincidentes
+     * @param criteria Search criteria including text, dates, sizes, etc.
+     * @return Search results containing matching files and folders
      */
     async fn search(&self, criteria: SearchCriteriaDto) -> Result<SearchResultsDto, DomainError>;
     
     /**
-     * Limpia la caché de resultados de búsqueda
+     * Clears the search results cache
      * 
-     * @return Resultado indicando éxito o error
+     * @return Result indicating success or error
      */
     async fn clear_search_cache(&self) -> Result<(), DomainError>;
 }