Gestión de Archivos y Medios

Resumen

El sistema de gestión de archivos y medios de Corcava proporciona capacidades integrales de adjuntos para tareas, permitiendo a los equipos compartir documentos, imágenes y otros archivos directamente dentro de sus flujos de trabajo de proyectos. El sistema soporta varios tipos de archivo, proporciona vistas previas visuales para imágenes y mantiene almacenamiento organizado con controles de acceso seguros.

Entender cómo usar efectivamente el sistema de gestión de archivos mejorará la colaboración del equipo, mejorará la documentación del proyecto y proporcionará mejor comunicación con clientes a través del intercambio visual y de documentos.

Métodos de Carga de Archivos - Carga Directa y Arrastrar y Soltar

Método 1: Carga Directa de Archivos en Modal de Tarea

Proceso de Carga de Archivos Estándar:

1. Abrir Detalles de Tarea - Hacer clic en cualquier tarea para abrir el modal de tarea
2. Navegar a Adjuntos - Encontrar la sección de adjuntos en el modal
3. Hacer Clic en "Seleccionar Archivo" - Usar el botón de selección de archivo
4. Elegir Archivo - Seleccionar archivo de tu computadora
5. Carga Automática - El archivo se adjunta inmediatamente a la tarea

Características de la Interfaz de Carga:

• Entrada de Archivo Oculta - Interfaz limpia con botón de carga estilizado
• Selección de Archivo Individual - Cargar un archivo a la vez a través del modal
• Vista Previa Inmediata - Los archivos aparecen en el área de vista previa inmediatamente
• Gestión de Archivos - Ver, descargar y eliminar archivos cargados

Método 2: Carga de Archivos por Arrastrar y Soltar (Solo Archivos de Imagen)

Creación de Tareas por Arrastrar y Soltar: Una característica única que crea tareas automáticamente desde archivos de imagen:

1. Arrastrar Archivo de Imagen - Soltar archivo de imagen directamente sobre cualquier columna
2. Validación de Tipo de Archivo - El sistema verifica tipos de imagen soportados
3. Creación Automática de Tarea - Tarea creada con imagen como adjunto
4. Nombrado Automático - El nombre de la tarea coincide con el nombre del archivo cargado
5. Disponibilidad Inmediata - Tarea lista para edición y asignación

Tipos de Imagen Soportados para Arrastrar y Soltar:

• WebP - Formato de imagen web moderno
• JPEG - Formato de foto estándar
• PNG - Formato de imagen de alta calidad con transparencia
• GIF - Formato de gráficos animados y simples

Beneficios de Arrastrar y Soltar:

• Creación Rápida de Tareas - Crear instantáneamente tareas visuales desde imágenes
• Integración del Flujo de Trabajo - Imágenes disponibles inmediatamente en el flujo de trabajo
• Organización Visual - Miniaturas de imagen en tarjetas de tarea para fácil identificación
• Proceso Eficiente - Combinar carga de archivo con creación de tarea en una acción

Formatos Soportados - Tipos de Archivo y Validación

Soporte de Tipos de Archivo

Basado en análisis del código, el sistema soporta dos categorías de cargas de archivos:

Archivos de Imagen (Creación por Arrastrar y Soltar):

• WebP - image/webp - Formato de imagen web moderno y eficiente
• JPEG - image/jpeg - Formato estándar de fotografía e imagen
• PNG - image/png - Imágenes de alta calidad con soporte de transparencia
• GIF - image/gif - Gráficos simples e imágenes animadas

Todos los Tipos de Archivo (Carga en Modal de Tarea):

• Cualquier Tipo de Archivo - El sistema acepta cualquier tipo de archivo a través de la carga en modal de tarea
• Detección de Tipo MIME - Detección y almacenamiento automático del tipo de archivo
• Preservación de Nombre Original - Mantiene el nombre de archivo original
• Soporte Flexible - Sin restricciones en tipos de archivo a través de la carga en modal

Validación y Procesamiento de Archivos

Validación de Carga:

• Validación de Arrastrar y Soltar - Validación estricta solo para tipos de imagen
• Carga en Modal - Sin restricciones de tipo de archivo, acepta cualquier formato
• Manejo de Errores - Mensajes de error claros para archivos de arrastrar y soltar no soportados
• Límites de Tamaño - Se aplican restricciones de tamaño de archivo a nivel del sistema

Procesamiento de Archivos:

• Sanitización de Nombre de Archivo - Caracteres especiales reemplazados con guiones bajos por seguridad
• Almacenamiento de Nombre Original - Nombre de archivo original preservado en la base de datos
• Almacenamiento de Tipo MIME - Tipo de archivo almacenado para manejo y visualización apropiados
• Almacenamiento Seguro - Archivos almacenados en estructura de directorio organizada y segura

Organización de Archivos - Almacenamiento y Estructura

Arquitectura de Almacenamiento

Estructura de Almacenamiento de Archivos: Los archivos están organizados en una estructura de directorio lógica y segura:

/storage/task-attachments/
├── {task-id}/
│   ├── sanitized-filename1.ext
│   ├── sanitized-filename2.ext
│   └── original-name-preserved.ext

Características de Organización:

• Carpetas Específicas por Tarea - Cada tarea obtiene su propio directorio
• Sanitización de Nombre de Archivo - Caracteres especiales removidos por seguridad
• Preservación de Nombre Original - La base de datos almacena el nombre de archivo original
• Rutas de Almacenamiento Únicas - Previene conflictos de nombres de archivo

Base de Datos de Gestión de Archivos

Seguimiento de Información de Archivos:

• Asociación de Tareas - Archivos vinculados a tareas específicas
• Almacenamiento Seguro - Archivos almacenados de forma segura con rutas organizadas
• Nombres Originales - Nombres de archivo originales preservados para referencia del usuario
• Detección de Tipo de Archivo - Identificación automática del tipo de archivo para manejo apropiado

Seguimiento de Archivos:

• Listas de Adjuntos - Las tareas cargan automáticamente relaciones de adjuntos
• Historial de Archivos - Rastrear cuándo se cargaron los archivos y por quién
• Control de Acceso - El acceso a archivos sigue permisos de tareas y proyectos
• Manejo de Eliminación - Eliminar archivos cuando se eliminan tareas o adjuntos

Beneficios de Almacenamiento

✅ Estructura Organizada - Organización lógica de archivos por tarea
✅ Seguridad - Nombres de archivo sanitizados previenen problemas de seguridad
✅ Preservación Original - Nombres de archivo originales mantenidos para referencia del usuario
✅ Detección de Tipo - Manejo apropiado de tipo MIME para diferentes formatos de archivo
✅ Prevención de Conflictos - Rutas de almacenamiento únicas previenen conflictos de nombres de archivo

Vista Previa de Imágenes - Integración Visual de Archivos

Características de Visualización de Imágenes

Miniaturas de Tarjetas de Tarea: Las imágenes adjuntas a tareas aparecen como miniaturas visuales en las propias tarjetas de tarea:

• Imágenes de Fondo - Archivos de imagen mostrados como fondos de tarjetas
• Identificación Visual - Tareas con imágenes fácilmente reconocibles en tableros
• Calidad de Miniatura - Vistas previas de imagen de alta calidad para identificación clara
• Visualización de Respaldo - Archivos que no son imágenes muestran extensiones de tipo de archivo

Sistema de Vista Previa de Imágenes:

• Detección Automática - El sistema identifica automáticamente archivos de imagen
• Visualización de Fondo - Imágenes usadas como fondo para miniaturas de tarjetas de tarea
• Clic para Ampliar - Hacer clic en imágenes para abrir modal de vista previa de tamaño completo
• Vista Previa Modal - Modal de vista previa de imagen dedicado para visualización detallada

Manejo Visual de Archivos

Procesamiento de Archivos de Imagen:

• Detección de Tipo - Identificación automática de tipos MIME de imagen
• Generación de Miniatura - Vistas previas visuales creadas automáticamente
• Integración de Fondo - Imágenes integradas en el diseño de tarjetas de tarea
• Modal de Vista Previa - Visualización de imagen de tamaño completo en modal dedicado

Visualización de Archivos que No son Imágenes:

• Visualización de Extensión de Archivo - Mostrar extensiones de archivo para archivos que no son imágenes
• Iconos de Tipo de Archivo - Iconos especiales para tipos de archivo específicos (archivos ZIP)
• Enlaces de Descarga - Acceso directo de descarga para archivos que no son imágenes
• Información de Archivo - Mostrar información de nombre de archivo y tipo

Beneficios de Integración Visual

✅ Reconocimiento Rápido - Las miniaturas de imagen hacen que las tareas sean instantáneamente reconocibles
✅ Organización Visual - Las imágenes ayudan a organizar y categorizar el trabajo visualmente
✅ Presentación Profesional - Las tarjetas de tarea visuales mejoran la apariencia del portal del cliente
✅ Navegación Eficiente - Encontrar tareas rápidamente usando identificación visual

Descarga de Archivos - Accediendo y Compartiendo Adjuntos

Funcionalidad de Descarga

Métodos de Acceso a Archivos:

Descarga Directa:

• Enlaces de Descarga - Enlaces de descarga directa para todos los archivos adjuntos
• Nombre de Archivo Original - Los archivos descargados mantienen nombres originales
• Descarga del Navegador - Funcionalidad estándar de descarga del navegador
• Basado en Permisos - El acceso de descarga sigue permisos de tareas

Visualización en el Navegador:

• Apertura en Nueva Pestaña - Ver archivos en nuevas pestañas del navegador
• Vista Previa de Imagen - Las imágenes se abren en modal de vista previa para visualización
• Visualización de Documentos - Documentos soportados por el navegador se abren para visualización
• Soporte de Enlaces Externos - Los enlaces se abren con atributos de seguridad apropiados

Control de Acceso a Archivos

Sistema de Permisos: El acceso a archivos sigue la misma estructura de permisos que tareas y proyectos:

• Acceso de Miembros del Equipo - Todos los miembros del equipo del proyecto pueden acceder a adjuntos de tareas
• Acceso Basado en Roles - El acceso a archivos respeta roles y permisos de usuario
• Permisos de Tareas - Debe tener acceso a la tarea para descargar adjuntos
• Acceso del Portal del Cliente - Los clientes pueden acceder a archivos a través del portal (donde esté permitido)

Características de Seguridad:

• URLs Seguras - Acceso a archivos a través de URLs seguras y autenticadas
• Validación de Permisos - Solicitudes de descarga validadas contra permisos de usuario
• Seguridad de Almacenamiento - Archivos almacenados en estructura de directorio organizada y segura
• Registro de Acceso - El acceso a archivos puede ser rastreado a través del sistema de actividad

Operaciones de Gestión de Archivos

Operaciones de Archivo Disponibles:

Ver/Vista Previa:

• Modal de Imagen - Hacer clic en imágenes para abrir modal de vista previa de tamaño completo
• Visualización de Documentos - Abrir documentos en nuevas pestañas del navegador
• Información de Archivo - Ver nombre de archivo, tipo e información de carga

Descargar:

• Descarga Directa - Descargar archivos con nombres de archivo originales
• Acceso por Lotes - Acceder a múltiples archivos de la misma tarea
• Multi-plataforma - La descarga funciona en dispositivos de escritorio y móviles

Eliminar/Remover:

• Eliminación Individual - Eliminar archivos específicos de tareas
• Permiso Requerido - Debe tener permisos de edición de tarea para eliminar archivos
• Actualización Inmediata - Eliminación de archivo reflejada inmediatamente en la interfaz
• Limpieza de Almacenamiento - Archivos removidos del almacenamiento cuando se eliminan

Mejores Prácticas de Gestión de Archivos

Organización de Carga

✅ Nombres de Archivo Descriptivos - Usar nombres de archivo claros y descriptivos antes de cargar
✅ Tipos de Archivo Apropiados - Elegir formatos de archivo óptimos para el uso previsto
✅ Consideración de Tamaño de Archivo - Optimizar archivos grandes antes de cargar
✅ Organización Lógica - Cargar archivos a tareas y proyectos relevantes
✅ Control de Versiones - Usar nombres claros para versiones de archivo y actualizaciones

Coordinación del Equipo

✅ Comunicación de Archivos - Usar comentarios para explicar el propósito y contexto de archivos
✅ Conciencia de Acceso - Entender quién puede acceder a archivos cargados
✅ Consideración del Cliente - Tener en cuenta qué archivos verán los clientes
✅ Limpieza Regular - Eliminar archivos desactualizados o innecesarios periódicamente

Seguridad y Privacidad

✅ Información Sensible - Ser cauteloso con archivos confidenciales o sensibles
✅ Apropiado para Cliente - Asegurar que los archivos sean apropiados para acceso del portal del cliente
✅ Comprensión de Permisos - Saber quién tiene acceso a archivos cargados
✅ Conciencia de Respaldo - Entender que los archivos cargados son parte de los registros del proyecto

Integración con Tarjetas de Tarea y Tableros

Integración Visual de Tareas

Visualización de Tarjetas de Tarea:

• Fondos de Imagen - Los adjuntos de imagen aparecen como fondos de tarjetas de tarea
• Indicadores de Archivo - Conteo de adjuntos mostrado en tarjetas de tarea
• Reconocimiento Visual - Tareas con imágenes fácilmente identificadas en tableros
• Apariencia Profesional - Elementos visuales mejoran la presentación del tablero

Organización a Nivel de Tablero:

• Flujo de Trabajo Visual - Los adjuntos de imagen ayudan a visualizar la progresión del trabajo
• Identificación Rápida - Encontrar tareas rápidamente usando elementos visuales
• Presentación del Cliente - Apariencia profesional para acceso del portal del cliente
• Navegación del Equipo - Señales visuales ayudan al equipo a navegar tableros complejos

Beneficios de Integración de Archivos

✅ Visualización Mejorada - Las imágenes hacen que los tableros sean más visualmente atractivos y funcionales
✅ Reconocimiento Rápido - Los elementos visuales ayudan a identificar tareas instantáneamente
✅ Presentación Profesional - Integración visual de alta calidad para interacciones con clientes
✅ Mejora del Flujo de Trabajo - Los elementos visuales apoyan mejor comprensión del flujo de trabajo

Comenzando con la Gestión de Archivos

Guía de Inicio Rápido

Paso 1: Cargar tu Primer Archivo

1. Abrir cualquier tarea en tu tablero de proyecto
2. Navegar a la sección de adjuntos
3. Hacer clic en "Seleccionar archivo" para elegir un archivo
4. Seleccionar archivo de tu computadora
5. Verificar que el archivo aparece en la lista de adjuntos

Paso 2: Probar Carga de Imagen por Arrastrar y Soltar

1. Encontrar un archivo de imagen en tu computadora (JPEG, PNG, GIF, WebP)
2. Arrastrar el archivo de imagen a cualquier columna en tu tablero
3. Soltar el archivo y observar la creación automática de tarea
4. Notar la nueva tarea con miniatura de imagen
5. Hacer clic en la tarea para ver el adjunto de imagen completo

Paso 3: Gestionar Archivos Cargados

1. Abrir una tarea con adjuntos
2. Practicar descargar archivos usando enlaces de descarga
3. Intentar abrir imágenes en modal de vista previa
4. Probar eliminar archivos que ya no necesitas
5. Entender cómo funciona el acceso a archivos para tu equipo

Mejores Prácticas de Gestión de Archivos

✅ Comenzar con Imágenes - Empezar con archivos de imagen para ver integración visual
✅ Probar Descargas - Verificar funcionalidad de descarga y acceso de archivos
✅ Entender Permisos - Aprender quién puede acceder a tus archivos cargados
✅ Organizar Lógicamente - Cargar archivos a tareas apropiadas y relevantes
✅ Usar Características Visuales - Aprovechar miniaturas de imagen para mejor organización de tareas

Solución de Problemas de Archivos

Problemas de Carga

Arrastrar y Soltar No Funciona:

• Verificación de Tipo de Archivo - Asegurar que estás usando tipos de imagen soportados (WebP, JPEG, PNG, GIF)
• Compatibilidad del Navegador - Verificar que el navegador soporta operaciones de arrastrar y soltar
• Problemas de Permisos - Verificar que tienes permisos de creación de tareas
• Problemas de Red - Asegurar conexión a internet estable

Problemas de Carga en Modal:

• Límites de Tamaño de Archivo - Verificar si el archivo excede restricciones de tamaño máximo
• Problemas del Navegador - Intentar actualizar página o usar navegador diferente
• Problemas de Permisos - Verificar que tienes permisos de edición de tareas
• Problemas de Almacenamiento - Contactar soporte si ocurren problemas persistentes de carga

Problemas de Acceso a Archivos

No se Pueden Descargar Archivos:

• Verificación de Permisos - Verificar que tienes acceso a la tarea y proyecto
• Existencia de Archivo - Asegurar que el archivo no ha sido eliminado o movido
• Configuración del Navegador - Verificar configuración de descarga y permisos del navegador
• Conectividad de Red - Verificar conexión a internet estable

Imágenes No se Muestran:

• Problemas de Tipo de Archivo - Verificar que el archivo es realmente un formato de imagen
• Archivos Corruptos - Volver a cargar si la imagen aparece corrupta
• Caché del Navegador - Limpiar caché del navegador y actualizar página
• Problemas de Almacenamiento - Contactar soporte si las imágenes fallan consistentemente en mostrarse

Próximos Pasos

Ahora que entiendes la gestión de archivos y medios, estás listo para explorar:

• Colaboración del Equipo - Herramientas de asignación de usuarios y colaboración
• Automatización e Integración - Flujos de trabajo automatizados e integraciones externas
• Filtrado y Búsqueda - Encontrar y organizar tareas eficientemente
• Gestión de Archivos e Historial - Gestionar trabajo completado y datos históricos

Recuerda: La gestión de archivos en Corcava está diseñada para ser simple pero poderosa. La característica de carga de imagen por arrastrar y soltar es particularmente útil para crear tareas visuales rápidamente, mientras que el sistema integral de adjuntos soporta todas tus necesidades de documentación y colaboración.