Almacenamiento de archivos y gestión de contenido
Tu aplicación tiene un sistema de archivos de contenido dedicado para almacenar archivos subidos por usuarios, como imágenes, documentos, PDFs y videos. Esto está separado del código de tu aplicación y está diseñado para contenido dinámico que los usuarios crean o suben mientras usan tu app.
Límites y notas importantes
- Los archivos individuales pueden tener hasta 500MB de tamaño
- La eliminación de archivos es permanente: no hay papelera ni contenedor de reciclaje
- El uso de almacenamiento cuenta para la cuota de tu cuenta
Qué permite el sistema de archivos de contenido
El sistema de archivos de contenido ofrece capacidades potentes de administración de archivos para tu aplicación:
- Almacenar avatares de usuarios, fotos de perfil y galerías de imágenes
- Aceptar cargas de documentos como currículums, contratos o PDFs
- Crear funciones para compartir archivos entre usuarios de tu app
- Crear aplicaciones con muchas imágenes con optimización automática
- Permitir que los usuarios descarguen archivos que subieron o que les pertenecen
- Crear herramientas administrativas donde administras archivos en nombre de usuarios
Cómo funciona
Cuando describes a la IA una función que necesita almacenamiento de archivos, maneja automáticamente toda la implementación:
Configura la interfaz de carga: crea formularios o zonas de arrastrar y soltar donde los usuarios pueden seleccionar archivos desde su dispositivo
Configura control de acceso: determina quién puede ver, subir o eliminar archivos según lo que estás creando
Implementa optimización de imágenes: redimensiona y sirve imágenes automáticamente de forma eficiente para que tu app cargue rápido
Crea la estructura de almacenamiento: organiza archivos en carpetas lógicas como /content/uploads/ o /content/avatars/
Maneja el backend: administra el almacenamiento, recuperación y entrega real de archivos sin que tengas que pensarlo
Los archivos se almacenan en rutas como /content/uploads/photo.jpg y pueden referenciarse directamente en tu app. El sistema rastrea quién subió cada archivo, cuándo se creó y aplica tus reglas de acceso.
Control de acceso para archivos
Igual que las tablas de base de datos y las funciones edge, los archivos tienen políticas de seguridad que controlan quién puede acceder a ellos. Los archivos son privados de forma predeterminada: nadie puede acceder a ellos hasta que configures permisos. La IA los configura según lo que estás creando:
Archivos públicos
Cualquiera puede verlos, incluso sin iniciar sesión. Los usuarios con sesión iniciada pueden subir archivos, y solo la persona que subió un archivo puede eliminarlo. Perfecto para galerías de fotos, imágenes públicas compartidas o sitios con contenido generado por usuarios.
Archivos privados
Solo el usuario que subió un archivo puede verlo o eliminarlo. Se usa para documentos sensibles, fotos privadas, registros médicos o cualquier cosa que los usuarios no quisieran que otros vieran.
Archivos compartidos por organización
Los usuarios de la misma organización pueden ver archivos subidos por cualquier persona de su organización. Las personas solo pueden eliminar archivos que ellas mismas subieron. Ideal para compartir documentos de equipo, recursos de empresa o espacios de trabajo colaborativos.
Acceso solo para propietario
Solo tú (el creador de la app) puedes acceder a estos archivos, no tus usuarios finales. Útil para almacenar archivos de sistema, plantillas o recursos administrativos que impulsan tu app pero no deberían estar orientados al usuario.
Control de acceso avanzado
La IA puede crear reglas de acceso sofisticadas basadas en metadatos de archivos. Por ejemplo:
- Los artículos publicados son públicos, pero los borradores solo son visibles para el autor
- Los archivos etiquetados con un departamento solo son visibles para usuarios de ese departamento
- El contenido premium requiere una bandera de suscripción en la cuenta del usuario
- Los archivos compartidos son visibles para colaboradores listados en los metadatos del archivo
Optimización de imágenes
Las imágenes subidas al sistema de archivos de contenido se optimizan automáticamente para cargar rápido. Cuando muestras una imagen, puedes solicitar un ancho específico y el sistema maneja el resto:
<!-- Thumbnail (200px wide) -->
<img src="/content/gallery/photo.jpg?w=200" />
<!-- Standard display (800px wide) -->
<img src="/content/gallery/photo.jpg?w=800" />
<!-- Hero image (1920px wide) -->
<img src="/content/gallery/photo.jpg?w=1920" />
<!-- Original, full-size image -->
<img src="/content/gallery/photo.jpg" />
Cómo funciona la optimización
Carga progresiva: la primera vez que alguien solicita un tamaño optimizado, el sistema sirve la versión disponible más cercana y genera el tamaño exacto en segundo plano. Cada solicitud posterior obtiene la imagen optimizada y con el tamaño perfecto. El archivo original siempre se preserva.
Entrega en formatos modernos: el sistema sirve automáticamente formatos de imagen modernos (AVIF o WebP) a navegadores que los admiten, con fallback automático a JPEG o PNG para navegadores antiguos. Esto ocurre de forma transparente: solo especificas el ancho, y los usuarios reciben la versión de carga más rápida que su navegador puede manejar.
Optimización de rendimiento: usa anchos más pequeños para mejorar el rendimiento. Una miniatura de 200px carga mucho más rápido que la imagen original de 4000px y usa menos ancho de banda. Elige el ancho que coincida con cómo muestras la imagen.
Usar archivos en tu aplicación
La IA integra automáticamente el sistema de archivos de contenido en tu aplicación React. Cuando pides funciones que involucran archivos, crea los componentes de UI, conecta la lógica de carga/descarga y maneja errores.
Patrones comunes que implementa la IA
Carga de avatar: una interfaz de carga de foto de perfil que valida tipos de imagen, muestra progreso de carga, previsualiza la imagen y guarda la ruta en el perfil del usuario.
Galería de documentos: un explorador de archivos que lista documentos subidos, muestra miniaturas para imágenes, ofrece enlaces de descarga y permite filtrar o buscar.
Carga con arrastrar y soltar: una zona de carga intuitiva donde los usuarios pueden arrastrar archivos desde su escritorio, ver el progreso de carga, cancelar cargas en curso y recibir mensajes de error para archivos inválidos.
Selector de archivos: un modal o barra lateral que muestra archivos que el usuario subió antes, le permite seleccionar uno para reutilizarlo y muestra miniaturas y nombres de archivo.
Integración con funciones edge
Las funciones edge (tu código del lado del servidor) pueden acceder al sistema de archivos de contenido para procesar archivos, generar archivos de forma programática o implementar lógica personalizada de manejo de archivos.
Qué pueden hacer las funciones edge con archivos
- Generar reportes PDF y guardarlos para que los usuarios los descarguen
- Procesar imágenes subidas (aplicar marcas de agua, crear miniaturas, extraer metadatos)
- Escanear documentos subidos en busca de datos sensibles antes de aceptarlos
- Implementar lógica personalizada de respaldo o archivado
- Analizar contenido de archivos y extraer datos estructurados
- Activar flujos de trabajo cuando se suben archivos específicos
Warning: Nota importante de seguridad
Las funciones edge omiten el control de acceso normal. Cuando tu función accede a archivos, no está limitada por las reglas "public" u "owner" que aplican a usuarios. Esto significa que debes implementar tus propias verificaciones de autorización en el código de la función para asegurar que los usuarios solo puedan acceder a archivos que deben ver.
Por ejemplo, si un usuario llama a tu función solicitando un archivo, debes verificar que sea dueño de ese archivo o tenga permiso para acceder a él antes de devolver el contenido. La IA maneja esto cuando crea tus funciones, pero es importante entender que el código de función se ejecuta con privilegios elevados.
Organización del almacenamiento
La IA organiza archivos en carpetas lógicas según lo que estás creando. No necesitas crear estructuras de carpetas manualmente: solo describe lo que necesitas, y la IA configura rutas adecuadas.
Patrones comunes de organización
/content/uploads/: cargas generales de usuarios/content/avatars/: fotos de perfil de usuarios/content/documents/: PDFs y documentos/content/gallery/: imágenes de galerías de fotos/content/private/: archivos privados de usuarios/content/public/: archivos de acceso público/content/temp/: archivos temporales que se pueden eliminar
La IA puede crear carpetas anidadas como /content/uploads/2024/ o /content/users/[username]/ cuando sea adecuado para tu caso de uso. Los archivos se rastrean por su ruta completa, así que mover o renombrar archivos actualiza automáticamente todas las referencias.
Monitoreo y depuración
Todas las operaciones de archivos se registran: cargas, descargas, denegaciones de acceso y errores. Puedes ver estos registros en la interfaz de administración para entender cómo se usa tu almacenamiento de archivos:
- Ver qué archivos se suben con más frecuencia
- Identificar cargas fallidas y qué salió mal
- Seguir patrones de descarga y archivos populares
- Monitorear uso de almacenamiento y crecimiento con el tiempo
- Depurar problemas de control de acceso cuando los usuarios no pueden acceder a archivos que esperan ver
El sistema también rastrea métricas de almacenamiento: archivos totales almacenados, tamaño total, tasa de crecimiento y archivos más grandes. Esto te ayuda a entender la huella de almacenamiento de tu app y planificar escalamiento.
Límites y restricciones
De forma predeterminada, los archivos individuales pueden tener hasta 500MB. Esto es configurable: la IA puede ajustar el límite según lo que estás creando. Para la mayoría de las aplicaciones (cargas de imágenes, documentos compartidos, PDFs), el límite predeterminado es más que suficiente.
Los archivos se almacenan de forma redundante para mayor confiabilidad. Si eliminas un archivo, se quita permanentemente del sistema: no hay papelera ni contenedor de reciclaje, así que la eliminación es inmediata y final.
Trabajar con la IA
Cuando describas funciones que necesitan almacenamiento de archivos, sé específico sobre:
- Quién puede acceder a los archivos: públicos, privados, compartidos por organización o reglas personalizadas
- Qué tipos de archivos: solo imágenes, PDFs, cualquier tipo de archivo, límites de tamaño
- Cómo se organizan los archivos: carpetas, convenciones de nombres, si los usuarios pueden crear subcarpetas
- Qué ocurre después de la carga: mostrar en una galería, adjuntar a un registro, procesar con una función
La IA usa esta información para configurar correctamente el almacenamiento, definir políticas de acceso y crear una interfaz que coincida con tus necesidades.
Documentación relacionada: