> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Almacenamiento de archivos Subidas con scope de workspace a través del contrato de almacenamiento de objetos. ## Guía paso a paso para principiantes Requisitos previos: lea las dos guías para principiantes a continuación, finalice la configuración local web y abra este monorepo en la raíz de su editor. La configuración web pertenece a `apps/web/.env.local`; Next.js no lee la raíz `.env`. `/dashboard` en el modo falso predeterminado es una demostración sin base de datos; `/auth` necesita una base de datos migrada. Términos breves: un espacio de trabajo son los usuarios, datos y configuraciones separados de un equipo. El servidor es el backend confiable; Mantenga las claves del proveedor fuera del código del navegador y del teléfono. Una migración es un cambio de base de datos versionada que crea o actualiza tablas. Un modelo de IA es el motor que responde; el catálogo de modelos es la lista del servidor de ID de modelos disponibles y precios. Un proveedor es un servicio externo, como inteligencia artificial, correo electrónico o servicio de facturación. Un derecho es una concesión que permite que un espacio de trabajo utilice una función. Un webhook es un mensaje que un servicio envía al URL de otro servicio. 1. Para una prueba sin credenciales, conserve `STORAGE_PROVIDER=memory`. Si esta caja no tiene control de carga visible, solicite a su agente de codificación que inspeccione `apps/web/app/api/storage/avatar/route.ts`, `apps/web/app/api/storage/logo/route.ts`, `apps/web/app/api/storage/organization-logo/route.ts` y la página de configuración correspondiente antes de cablear una pequeña imagen de muestra. 2. Para verificar la persistencia, configure `STORAGE_PROVIDER=s3`, `STORAGE_REGION` y `STORAGE_BUCKET` en `apps/web/.env.local`, agregue localmente las credenciales de prueba solo del servidor y reinicie. 3. La imagen debería recargarse desde el almacenamiento. Los archivos de memoria desaparecen cuando se reinicia el proceso; para errores de S3, verifique el depósito, el punto final y la política de acceso. Para obtener código personalizado, comience con el `prompts/README.md` proporcionado y copie el mensaje más cercano: `prompts/new-app-screen.md` para una pantalla de aplicación o `prompts/new-landing-page.md` para una página pública. Para trabajos de servidor, base de datos o proveedor, asigne a su agente de codificación la tarea de esta guía y pídale que lea `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` y los espejos `.ai/` correspondientes; inspeccionar los archivos fuente exactos nombrados aquí; enumerar archivos y verificaciones antes de editarlos; preservar la propiedad del espacio de trabajo y los secretos exclusivos del servidor; y mostrarte la diferencia. Dígale el comportamiento que desea, los campos de entrada y salida, los roles permitidos, los éxitos y errores esperados y la cuenta, proveedor o dispositivo de prueba. Utilice valores de muestra; Nunca pegues un verdadero secreto. [Antes de comenzar](https://supastack.dev/es/docs/web/before-you-start.md) [Conceptos básicos de terminales](https://supastack.dev/es/docs/web/terminal-basics.md) [Configuración local web](https://supastack.dev/es/docs/web/ship-in-5-minutes.md) [Mensajes del agente y memoria del proyecto](https://supastack.dev/es/docs/web/agents.md) ## Selecciona el backend de almacenamiento `STORAGE_PROVIDER=memory` es el valor predeterminado sin credenciales. `local` escribe objetos en disco bajo `STORAGE_LOCAL_DIR` (por defecto `./.data/storage`, obligatorio explícitamente en producción) y los transmite mediante URL con firma HMAC y caducidad en `/api/storage/local/[...key]` (`STORAGE_LOCAL_SIGNING_SECRET`, con respaldo en `AUTH_SECRET`) para despliegues de un solo servidor. `s3` utiliza `apps/web/src/storage-runtime.ts` para componer el cliente del SDK de AWS sobre el contrato reducido `@supastack/storage`, admitiendo Supabase Storage y MinIO con URL de estilo de ruta habilitadas por defecto. ``` STORAGE_PROVIDER=s3 STORAGE_REGION=us-east-1 STORAGE_BUCKET=your-product-bucket # Set STORAGE_ACCESS_KEY_ID and STORAGE_SECRET_ACCESS_KEY on the server. # Optional: STORAGE_ENDPOINT, STORAGE_FORCE_PATH_STYLE, STORAGE_PUBLIC_BASE_URL # Self-hosted single-server disk storage: # STORAGE_PROVIDER=local # STORAGE_LOCAL_DIR=./.data/storage # STORAGE_LOCAL_SIGNING_SECRET= # Local MinIO Compose overrides: MINIO_ROOT_USER / MINIO_ROOT_PASSWORD ``` ## Reutiliza los límites de carga Las rutas incluidas cubren objetos, avatares, logotipos de perfil y logotipos de organización bajo `/api/storage/`. Resuelven la identidad y los permisos del espacio de trabajo y validan la forma de la carga antes del almacenamiento. Inspecciona la política de tamaño/tipo de la ruta elegida en lugar de aceptar claves de objeto arbitrarias del cliente. Las URL públicas son para presentación, no para autorización. Mantén el contenido protegido detrás del límite de lectura verificada de la aplicación y configura la política del bucket/CDN para los datos de tu producto. ## Prueba el comportamiento del almacenamiento real Prueba las cargas permitidas/denegadas, el rechazo de MIME y tamaño, rutas de otro espacio de trabajo, objetos ausentes y fallos del proveedor. El modo memoria no persiste entre procesos; verifica el almacenamiento y la recuperación con el backend seleccionado antes del lanzamiento. [Configuración de almacenamiento Supabase](https://supastack.dev/es/docs/web/project-structure.md) [Subir inventario de rutas](https://supastack.dev/es/docs/web/project-structure.md) ## Configuración y ajustes STORAGE_PROVIDER selecciona el adaptador: memory para tests y desarrollo local, s3 para cualquier bucket compatible con S3 (STORAGE_BUCKET, STORAGE_ENDPOINT, STORAGE_ACCESS_KEY_ID, STORAGE_SECRET_ACCESS_KEY, STORAGE_PUBLIC_BASE_URL). Las credenciales permanecen solo en el servidor. packages/storage posee el contrato ObjectStorage — putObject/getObject/deleteObject contra locators de objetos — más assertWorkspaceObjectKey y buildWorkspaceObjectKey para que cada objeto almacenado esté namespaced por workspace y propósito (avatar, archivo, logo). ``` Uploads and reads go through authenticated routes: /api/storage/objects /api/storage/avatar /api/storage/logo /api/storage/organization-logo ``` ## Flujo de implementación Mantén las subidas detrás de la capa de rutas autenticadas: resuelve el workspace, valida tipo y tamaño de contenido, construye la clave con scope de workspace y luego almacena a través del adaptador. Sirve las lecturas del mismo modo salvo que un objeto sea deliberadamente público. Los avatares y logos de organización tienen rutas dedicadas con su propia validación; los archivos de producto arbitrarios pasan por /objects con un propósito declarado. ## Verificación y solución de problemas Verifica que las subidas anónimas se rechazan, que un workspace no puede leer las claves de objetos de otro, que los tipos de contenido demasiado grandes o no permitidos fallan, y que un objeto eliminado deja de resolverse. Usa el adaptador memory en tests; verifica el bucket real a través de la ruta smoke opcional. ## Siguiente [Funciones de IA](https://supastack.dev/es/docs/web/ai.md)