Gestión de almacenamiento

Cada foto que sube un miembro, cada archivo de audio de sermón, cada PDF de recibo, cada ícono PWA — todos viven en Supabase Storage, y cada organización tiene un límite por nivel de plan en el total. La pestaña Almacenamiento en Configuración → Almacenamiento permite a un administrador ver exactamente qué se almacena, dónde, y limpiar cualquier cosa que ya no se necesite.

Esto es solo para administradores, y es donde vas cuando la advertencia "Almacenamiento cerca del límite" empieza a aparecer en el panel.

Abre la pestaña de almacenamiento

Desde la barra lateral, haz clic en Configuración, luego desplaza las pestañas a Almacenamiento. La página tiene dos partes:

1. Una tarjeta de Descripción general del almacenamiento en la parte superior.
2. Un Navegador de archivos debajo, separado por bucket.

Descripción general del almacenamiento

La tarjeta de descripción general muestra:

• Total usado vs el límite de tu plan (ej. "2.4 GB de 10 GB usados").
• Total de archivos en todos los buckets.
• Una barra de progreso que se vuelve amarilla al 80% y roja al 90%.

Límites del plan al momento de escribir:

Plan	Límite de almacenamiento
Starter	1 GB
Growth	10 GB
Network	50 GB
Unlimited	250 GB

Si superas el límite, las nuevas subidas fallan con un error storage_limit_exceeded. Los archivos existentes siguen sirviéndose — no eliminamos nada automáticamente.

Buckets

GCM divide el almacenamiento en buckets con nombres de propósito para que puedas ver de un vistazo a dónde va el espacio. Cada bucket se muestra como una tarjeta clickeable con conteo y tamaño de archivos:

Bucket	Qué va aquí
member-photos	Fotos de perfil subidas por miembros o personal.
pwa-icons	Los íconos 192/512 que estableces en Configuración PWA.
branding	Logo, favicon y cualquier otra imagen establecida en Marca.
podcast-media	Audio de sermones + arte de portada para episodios de podcast.
website-media	Imágenes y archivos usados en el Constructor de Sitios Web.
giving-receipts	PDFs de estados de cuenta fiscales generados.
attendance-photos	Fotos de check-in (si el check-in con foto está activado).
workflow-attachments	Archivos adjuntos a ejecuciones de flujos de trabajo.
message-attachments	Archivos adjuntos a mensajes salientes.
forms-uploads	Archivos que los miembros envían vía Formularios.

Haz clic en cualquier bucket para profundizar.

Navegar un bucket

El navegador de archivos muestra carpetas y archivos en el bucket seleccionado. Los buckets con alcance por organización siempre comienzan con el ID de tu organización como carpeta de nivel superior, así que lo que ves tiene alcance automático — sin riesgo de ver archivos de otra organización.

Cada fila muestra:

• Nombre del archivo
• Tamaño (formateado: KB / MB / GB)
• Tipo (imagen, PDF, audio, video, documento)
• Subido (tiempo relativo — "hace 3 días", "hace 5 minutos")
• Un botón Descargar y un botón Eliminar.

Haz clic en un nombre de carpeta para profundizar; haz clic en la flecha atrás para subir. La ruta en la parte superior muestra dónde estás.

TIP

El navegador lista archivos en lotes de 100. Si un bucket tiene más que eso, en la parte inferior de la lista aparece Cargar más. Para buckets muy grandes (10,000+ archivos), el navegador puede tomar un momento para renderizar — sé paciente.

Descargar un archivo

Haz clic en el ícono de descarga junto a cualquier archivo. El navegador obtiene una URL de descarga firmada (válida por 60 segundos) y dispara una descarga. Para buckets públicos, la URL es solo el enlace CDN público.

Esto es útil para:

• Sacar audio de sermones para reeditarlo.
• Descargar un estado de cuenta fiscal generado para enviarlo manualmente por correo.
• Hacer copia de seguridad de fotos de miembros antes de una eliminación masiva.

Eliminar archivos

Haz clic en el ícono de papelera para eliminar un archivo. Un diálogo de confirmación te pide confirmar — la eliminación es permanente (no eliminamos suavemente los archivos de almacenamiento; realmente se van después de este clic).

Ten cuidado con los casos especiales:

• Fotos de miembros — eliminar del almacenamiento no quita la referencia photo de members. El registro del miembro aún reclama una foto pero la URL devuelve 404. Para hacer esto limpiamente, edita al miembro y borra su foto desde la pantalla de edición del miembro, que elimina ambos.
• Logo de marca / ícono PWA — el mismo problema. Actualiza el ajuste primero vía Configuración → Marca, luego elimina el archivo viejo aquí.
• PDFs de estados de cuenta fiscales — estos se generan bajo demanda por el módulo de donaciones. Elimínalos libremente; si un donante lo solicita de nuevo, GCM lo regenera.

Eliminación masiva

El explorador actual no soporta eliminación masiva con multi-selección. Para limpiezas grandes, contacta a soporte — el equipo de plataforma puede ejecutar una eliminación dirigida vía SQL basada en criterios (ej. "todas las fotos de miembros para miembros inactivos actualizadas hace más de 2 años"). Este es el camino más seguro al eliminar cientos de archivos a la vez.

Buckets públicos vs privados

Algunos buckets son públicos (sus archivos son accesibles por URL por cualquiera con el enlace). Otros son privados y requieren una URL firmada.

Bucket	Visibilidad
member-photos	público
branding, pwa-icons, website-media, podcast-media	público
giving-receipts	privado (solo URLs firmadas)
attendance-photos	privado
forms-uploads	privado
workflow-attachments	privado
message-attachments	privado

Los buckets públicos son intencionalmente públicos — están detrás del CDN de Supabase, lo que significa que las imágenes cargan rápido incluso en conexiones lentas. La compensación es que cualquiera con una URL puede obtener el archivo, así que no pongas PII o documentos financieros en buckets públicos. El navegador etiqueta cada tarjeta de bucket con su visibilidad para que sepas qué estás mirando.

¿Qué hay de cuotas por bucket?

Los límites del plan aplican al almacenamiento total en todos los buckets — no hay un límite por bucket. Así que si estás usando 9.5 GB de tu límite de 10 GB de Growth, no importa en qué buckets se distribuya eso; tienes 0.5 GB restantes en toda la organización independientemente.

El navegador aún muestra totales por bucket porque te ayudan a decidir dónde limpiar. Si 7 GB de tus 9.5 están en podcast-media, tu archivo de audio es el objetivo obvio.

Qué se guarda dónde

El almacenamiento en sí es Supabase Storage (compatible con S3), con clave por bucket + ruta. La UI del Explorador de almacenamiento llama a una RPC de Supabase (org_storage_stats) que agrega conteos de archivos y tamaños por bucket, con alcance al prefijo de ruta de tu organización. RLS en storage.objects asegura que solo veas archivos bajo rutas <org_id>/....

Errores comunes

"Eliminé la foto de un miembro aquí pero aún aparece en su perfil." Recarga forzada para limpiar la caché del navegador. Si la foto aún aparece, el registro del miembro aún tiene la ruta almacenada — edita al miembro, borra la foto allí también y guarda.

"Mi uso de almacenamiento parece más alto que los tamaños de archivo sumados." Las estadísticas incluyen variantes de miniaturas y copias versionadas. Supabase genera una miniatura para cada imagen automáticamente, lo que cuenta contra tu cuota. El navegador de archivos te muestra solo los originales; los totales incluyen todas las variantes.

"Eliminé todo en un bucket pero el uso de almacenamiento no bajó." Las estadísticas se refrescan en una caché de 5 minutos. Espera unos minutos o haz clic en el botón de refrescar en la tarjeta de descripción general.

"Aparecen archivos que no subí en workflow-attachments." Los flujos de trabajo adjuntan archivos automáticamente cuando los nodos se completan (ej. un PDF generado, una captura de pantalla capturada). Estos se acumulan; límpialos periódicamente.

Próximos pasos

• Configuración PWA — establece los íconos una vez, elimina los antiguos aquí.
• Marca — actualiza el logo, elimina las subidas antiguas aquí.
• Descripción general de Configuración — vuelve al índice.