Back to flin
flin

Almacenamiento de archivos con 4 backends

Cómo FLIN implementa almacenamiento de archivos con cuatro backends intercambiables -- local, S3, Cloudflare R2 y Google Cloud Storage -- todos detrás de una única API unificada.

Juste A. Gnimavo (Thales) & Claude | March 26, 2026 2 min flin
EN/ FR/ ES
flinrust

Toda aplicación web eventualmente necesita almacenar archivos. FLIN elimina la decisión de dónde almacenarlos. Se configura un backend de almacenamiento en una línea, y todo el sistema de archivos -- subidas, descargas, deduplicación, URLs firmadas, previsualizaciones, compresión -- funciona idénticamente sin importar dónde vivan físicamente los bytes. Cuatro backends, una API, cero dolor de migración.

Almacenamiento direccionable por contenido

FLIN usa almacenamiento direccionable por contenido (CAS): los archivos se identifican por su hash SHA-256, no por su nombre o ruta. Esto proporciona deduplicación automática gratuita.

Los cuatro backends

Backend local Almacena archivos en el sistema de archivos del servidor. Es el predeterminado, no requiere servicios externos y es la opción más rápida para desarrollo.

Backend S3 Almacena archivos en Amazon S3 o cualquier servicio compatible con S3 (MinIO, DigitalOcean Spaces, Backblaze B2).

Backend Cloudflare R2 Compatible con S3 pero cobra cero por egreso. Para aplicaciones que sirven muchos archivos, R2 puede reducir los costos de almacenamiento en un orden de magnitud.

Backend Google Cloud Storage La opción empresarial con IAM de Google, control de acceso granular y replicación multi-región.

La experiencia del desarrollador

flinentity Invoice {
    client: text
    pdf: file
    amount: money
}

// Subir
route POST "/invoices" {
    validate {
        client: text @required
        pdf: file @required @document @max_size("10MB")
    }

    invoice = Invoice.create({
        client: body.client,
        pdf: body.pdf,
        amount: body.amount
    })
    save invoice

    respond { id: invoice.id, url: invoice.pdf.url }
}

Este código funciona idénticamente en almacenamiento local, S3, R2 y GCS. Se migra de local a R2 cambiando una línea en flin.config.


Esta es la Parte 126 de la serie "Cómo construimos FLIN", que documenta cómo un CEO en Abidjan y un CTO de IA diseñaron y construyeron un lenguaje de programación desde cero.

Navegación de la serie: - [125] Analíticas de búsqueda y caché de resultados - [126] Almacenamiento de archivos con 4 backends (estás aquí) - [127] El patrón del trait StorageBackend

Share this article:

Responses

Write a response
0/2000
Loading responses...

Related Articles

Thales & Claude deblo

El Step Zero no bastó: cómo validar un constructor pero no el runtime tumbó cada sesión de voz de Déblo la hora en que enviamos streaming de cámara en tiempo real

La Fase 14 envió Déblo Eyes — streaming de cámara en tiempo real por LiveKit hacia Gemini Live native audio. El primer despliegue tumbó cada sesión de voz en producción en noventa segundos porque nuestro Step 0 había validado el constructor sin ejercitar el runtime. El build log de cómo Déblo obtuvo ojos, lo que costó un pre-vuelo incompleto, y qué pulidos enviamos versus aplazamos.

33 min May 20, 2026
debloclaude-opus-4.7claude-codegemini-live +25
Thales & Claude deblo

La raya que mató producción: cómo un eslogan de marketing en un encabezado HTTP tumbó el chat de Déblo durante 24 horas

Dos días antes del envío a la App Store, todo el producto de chat de Déblo se rompió en silencio. Sin spinner, sin toast, sin error en la UI — solo aire muerto. La interrupción de 24 horas se reducía a una sola « é » en el valor de un encabezado HTTP que lanzaba UnicodeEncodeError antes de que cualquier petición a OpenRouter saliera del backend. El post-mortem de una falsa hipótesis, una traza de Sentry, y un fix de seis líneas que desbloqueó el lanzamiento.

29 min May 19, 2026
debloclaude-opus-4.7claude-codeincident +19
Thales & Claude deblo

Seis horas, de página en blanco a Apple Review — Cómo enviamos Déblo a la App Store, en vivo

Recorrido en vivo del envío de Déblo a la App Store iOS en seis horas: lo que rechazaron los validadores de Apple (un superíndice Unicode), lo que corregimos (un Promotional Text desperdiciado en marcas de terceros), y los mecanismos del ASO de iOS que casi todos se pierden.

30 min May 13, 2026
debloclaude-opus-4.7claude-codeapp-store +16