chore: translate all Spanish comments and log messages to English

src/domain/repositories/folder_repository.rs

@@ -1,12 +1,12 @@
-//! Puerto de persistencia del dominio para la entidad Folder.
+//! Domain persistence port for the Folder entity.
 //!
-//! Define el contrato que cualquier implementación de almacenamiento de carpetas
-//! debe cumplir. Este trait vive en el dominio porque Folder es una entidad core
-//! del sistema y sus contratos de persistencia pertenecen a la capa de dominio,
-//! siguiendo los principios de Clean/Hexagonal Architecture.
+//! Defines the contract that any folder storage implementation
+//! must fulfill. This trait lives in the domain because Folder is a core entity
+//! of the system and its persistence contracts belong to the domain layer,
+//! following the principles of Clean/Hexagonal Architecture.
 //!
-//! Las implementaciones concretas (filesystem, PostgreSQL, S3, etc.) viven en
-//! la capa de infraestructura.
+//! Concrete implementations (filesystem, PostgreSQL, S3, etc.) live in
+//! the infrastructure layer.
 
 use async_trait::async_trait;
 
@@ -14,25 +14,25 @@ use crate::domain::entities::folder::Folder;
 use crate::domain::services::path_service::StoragePath;
 use crate::common::errors::DomainError;
 
-/// Puerto del dominio para persistencia de carpetas.
+/// Domain port for folder persistence.
 ///
-/// Define las operaciones CRUD y de gestión necesarias para
-/// la entidad Folder en el sistema de almacenamiento.
+/// Defines the CRUD and management operations required for
+/// the Folder entity in the storage system.
 #[async_trait]
 pub trait FolderRepository: Send + Sync + 'static {
-    /// Crea una nueva carpeta
+    /// Creates a new folder
     async fn create_folder(&self, name: String, parent_id: Option<String>) -> Result<Folder, DomainError>;
     
-    /// Obtiene una carpeta por su ID
+    /// Gets a folder by its ID
     async fn get_folder(&self, id: &str) -> Result<Folder, DomainError>;
     
-    /// Obtiene una carpeta por su ruta de almacenamiento
+    /// Gets a folder by its storage path
     async fn get_folder_by_path(&self, storage_path: &StoragePath) -> Result<Folder, 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<Folder>, DomainError>;
     
-    /// Lista carpetas con paginación
+    /// Lists folders with pagination
     async fn list_folders_paginated(
         &self, 
         parent_id: Option<&str>,
@@ -41,29 +41,29 @@ pub trait FolderRepository: Send + Sync + 'static {
         include_total: bool
     ) -> Result<(Vec<Folder>, Option<usize>), DomainError>;
     
-    /// Renombra una carpeta
+    /// Renames a folder
     async fn rename_folder(&self, id: &str, new_name: String) -> Result<Folder, DomainError>;
     
-    /// Mueve una carpeta a otro padre
+    /// Moves a folder to another parent
     async fn move_folder(&self, id: &str, new_parent_id: Option<&str>) -> Result<Folder, DomainError>;
     
-    /// Elimina una carpeta
+    /// Deletes a folder
     async fn delete_folder(&self, id: &str) -> Result<(), DomainError>;
     
-    /// Verifica si existe una carpeta en la ruta dada
+    /// Checks if a folder exists at the given path
     async fn folder_exists(&self, storage_path: &StoragePath) -> Result<bool, DomainError>;
     
-    /// Obtiene la ruta de una carpeta
+    /// Gets the path of a folder
     async fn get_folder_path(&self, id: &str) -> Result<StoragePath, DomainError>;
 
     // ── Trash operations ──
 
-    /// Mueve una carpeta a la papelera
+    /// Moves a folder to the trash
     async fn move_to_trash(&self, folder_id: &str) -> Result<(), DomainError>;
 
-    /// Restaura una carpeta desde la papelera a su ubicación original
+    /// Restores a folder from the trash to its original location
     async fn restore_from_trash(&self, folder_id: &str, original_path: &str) -> Result<(), DomainError>;
 
-    /// Elimina una carpeta permanentemente (usado por la papelera)
+    /// Permanently deletes a folder (used by the trash)
     async fn delete_folder_permanently(&self, folder_id: &str) -> Result<(), DomainError>;
 }