adding several features

2025-03-19 00:44:27 +01:00
parent 7157762540
commit d9bbd575d2
66 changed files with 12137 additions and 1055 deletions
@@ -0,0 +1,77 @@
+use std::sync::Arc;
+use async_trait::async_trait;
+use bytes::Bytes;
+use futures::Stream;
+
+use crate::application::dtos::file_dto::FileDto;
+use crate::application::dtos::folder_dto::{CreateFolderDto, FolderDto, MoveFolderDto, RenameFolderDto};
+use crate::common::errors::DomainError;
+
+/// Puerto primario para operaciones de archivos
+#[async_trait]
+pub trait FileUseCase: Send + Sync + 'static {
+    /// Sube un nuevo archivo desde bytes
+    async fn upload_file(
+        &self,
+        name: String,
+        folder_id: Option<String>,
+        content_type: String,
+        content: Vec<u8>,
+    ) -> Result<FileDto, DomainError>;
+    
+    /// Obtiene un archivo por su ID
+    async fn get_file(&self, id: &str) -> Result<FileDto, DomainError>;
+    
+    /// Lista archivos en una carpeta
+    async fn list_files(&self, folder_id: Option<&str>) -> Result<Vec<FileDto>, DomainError>;
+    
+    /// Elimina un archivo
+    async fn delete_file(&self, id: &str) -> Result<(), DomainError>;
+    
+    /// Obtiene contenido de archivo como bytes (para archivos pequeños)
+    async fn get_file_content(&self, id: &str) -> Result<Vec<u8>, DomainError>;
+    
+    /// Obtiene contenido de archivo como stream (para archivos grandes)
+    async fn get_file_stream(&self, id: &str) -> Result<Box<dyn Stream<Item = Result<Bytes, std::io::Error>> + Send>, DomainError>;
+    
+    /// Mueve un archivo a otra carpeta
+    async fn move_file(&self, file_id: &str, folder_id: Option<String>) -> Result<FileDto, DomainError>;
+}
+
+/// Puerto primario para operaciones de carpetas
+#[async_trait]
+pub trait FolderUseCase: Send + Sync + 'static {
+    /// Crea una nueva carpeta
+    async fn create_folder(&self, dto: CreateFolderDto) -> Result<FolderDto, DomainError>;
+    
+    /// Obtiene una carpeta por su ID
+    async fn get_folder(&self, id: &str) -> Result<FolderDto, DomainError>;
+    
+    /// Obtiene una carpeta por su ruta
+    async fn get_folder_by_path(&self, path: &str) -> Result<FolderDto, DomainError>;
+    
+    /// Lista carpetas dentro de una carpeta padre
+    async fn list_folders(&self, parent_id: Option<&str>) -> Result<Vec<FolderDto>, DomainError>;
+    
+    /// Lista carpetas con paginación
+    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
+    async fn rename_folder(&self, id: &str, dto: RenameFolderDto) -> Result<FolderDto, DomainError>;
+    
+    /// Mueve una carpeta a otro padre
+    async fn move_folder(&self, id: &str, dto: MoveFolderDto) -> Result<FolderDto, DomainError>;
+    
+    /// Elimina una carpeta
+    async fn delete_folder(&self, id: &str) -> Result<(), DomainError>;
+}
+
+/// Factory para crear implementaciones de casos de uso
+pub trait UseCaseFactory {
+    fn create_file_use_case(&self) -> Arc<dyn FileUseCase>;
+    fn create_folder_use_case(&self) -> Arc<dyn FolderUseCase>;
+}
@@ -0,0 +1,2 @@
+pub mod inbound;
+pub mod outbound;
@@ -0,0 +1,118 @@
+use std::path::PathBuf;
+use async_trait::async_trait;
+use bytes::Bytes;
+use futures::Stream;
+
+use crate::domain::entities::file::File;
+use crate::domain::entities::folder::Folder;
+use crate::domain::services::path_service::StoragePath;
+use crate::common::errors::DomainError;
+
+/// Puerto secundario para operaciones de almacenamiento
+#[async_trait]
+pub trait StoragePort: Send + Sync + 'static {
+    /// Resuelve una ruta de dominio a una ruta física
+    fn resolve_path(&self, storage_path: &StoragePath) -> PathBuf;
+    
+    /// Crea directorios si no existen
+    async fn ensure_directory(&self, storage_path: &StoragePath) -> Result<(), DomainError>;
+    
+    /// Verifica si existe un archivo en la ruta dada
+    async fn file_exists(&self, storage_path: &StoragePath) -> Result<bool, DomainError>;
+    
+    /// Verifica si existe un directorio en la ruta dada
+    async fn directory_exists(&self, storage_path: &StoragePath) -> Result<bool, DomainError>;
+}
+
+/// Puerto secundario para persistencia de archivos
+#[async_trait]
+pub trait FileStoragePort: Send + Sync + 'static {
+    /// Guarda un nuevo archivo desde bytes
+    async fn save_file(
+        &self,
+        name: String,
+        folder_id: Option<String>,
+        content_type: String,
+        content: Vec<u8>,
+    ) -> Result<File, DomainError>;
+    
+    /// Obtiene un archivo por su ID
+    async fn get_file(&self, id: &str) -> Result<File, DomainError>;
+    
+    /// Lista archivos en una carpeta
+    async fn list_files(&self, folder_id: Option<&str>) -> Result<Vec<File>, DomainError>;
+    
+    /// Elimina un archivo
+    async fn delete_file(&self, id: &str) -> Result<(), DomainError>;
+    
+    /// Obtiene contenido de archivo como bytes
+    async fn get_file_content(&self, id: &str) -> Result<Vec<u8>, DomainError>;
+    
+    /// Obtiene contenido de archivo como stream
+    async fn get_file_stream(&self, id: &str) -> Result<Box<dyn Stream<Item = Result<Bytes, std::io::Error>> + Send>, DomainError>;
+    
+    /// Mueve un archivo a otra carpeta
+    async fn move_file(&self, file_id: &str, target_folder_id: Option<String>) -> Result<File, DomainError>;
+    
+    /// Obtiene la ruta de almacenamiento de un archivo
+    async fn get_file_path(&self, id: &str) -> Result<StoragePath, DomainError>;
+}
+
+/// Puerto secundario para persistencia de carpetas
+#[async_trait]
+pub trait FolderStoragePort: Send + Sync + 'static {
+    /// Crea una nueva carpeta
+    async fn create_folder(&self, name: String, parent_id: Option<String>) -> Result<Folder, DomainError>;
+    
+    /// Obtiene una carpeta por su ID
+    async fn get_folder(&self, id: &str) -> Result<Folder, DomainError>;
+    
+    /// Obtiene una carpeta por su ruta
+    async fn get_folder_by_path(&self, storage_path: &StoragePath) -> Result<Folder, DomainError>;
+    
+    /// Lista carpetas dentro de una carpeta padre
+    async fn list_folders(&self, parent_id: Option<&str>) -> Result<Vec<Folder>, DomainError>;
+    
+    /// Lista carpetas con paginación
+    async fn list_folders_paginated(
+        &self, 
+        parent_id: Option<&str>,
+        offset: usize,
+        limit: usize,
+        include_total: bool
+    ) -> Result<(Vec<Folder>, Option<usize>), DomainError>;
+    
+    /// Renombra una carpeta
+    async fn rename_folder(&self, id: &str, new_name: String) -> Result<Folder, DomainError>;
+    
+    /// Mueve una carpeta a otro padre
+    async fn move_folder(&self, id: &str, new_parent_id: Option<&str>) -> Result<Folder, DomainError>;
+    
+    /// Elimina una carpeta
+    async fn delete_folder(&self, id: &str) -> Result<(), DomainError>;
+    
+    /// Verifica si existe una carpeta en la ruta dada
+    async fn folder_exists(&self, storage_path: &StoragePath) -> Result<bool, DomainError>;
+    
+    /// Obtiene la ruta de una carpeta
+    async fn get_folder_path(&self, id: &str) -> Result<StoragePath, DomainError>;
+}
+
+/// Puerto secundario para mapeo de IDs
+#[async_trait]
+pub trait IdMappingPort: Send + Sync + 'static {
+    /// Obtiene o crea un ID para una ruta
+    async fn get_or_create_id(&self, path: &StoragePath) -> Result<String, DomainError>;
+    
+    /// Obtiene una ruta por su ID
+    async fn get_path_by_id(&self, id: &str) -> Result<StoragePath, DomainError>;
+    
+    /// Actualiza la ruta para un ID existente
+    async fn update_path(&self, id: &str, new_path: &StoragePath) -> Result<(), DomainError>;
+    
+    /// Elimina un ID del mapeo
+    async fn remove_id(&self, id: &str) -> Result<(), DomainError>;
+    
+    /// Guarda cambios pendientes
+    async fn save_changes(&self) -> Result<(), DomainError>;
+}