Back to flin
flin

La corrección de persistencia de base de datos que tomó 3 sesiones

Tres sesiones, tres causas raíz, un objetivo: hacer que la aplicación de tareas de FLIN realmente guarde datos en disco. La saga de la persistencia navegador-a-base de datos.

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

La aplicación de tareas pendientes es la prueba canónica de cualquier framework web. Ejercita formularios, gestión de estado, persistencia de datos y renderizado de interfaz en un paquete compacto y bien entendido. Cuando construimos la aplicación de tareas de FLIN, la interfaz se renderizaba hermosamente. Los botones hacían clic. Los formularios se enviaban. Y cada dato desaparecía en el momento en que la página se actualizaba.

Tomó tres sesiones -- 201, 202, 203 -- distribuidas a lo largo del 16 de enero de 2026, para rastrear y corregir la cadena de errores que impedían que los datos llegaran al disco. Cada sesión descubrió una causa raíz diferente, y cada corrección reveló el siguiente problema.

Sesión 201: Conectando navegador y servidor

La primera sesión comenzó con una brecha fundamental: los demos integrados de FLIN no funcionaban en el navegador en absoluto. Se resolvieron cuatro problemas distintos: enlace de datos bidireccional, envío de formularios, manejadores de eventos con argumentos y el endpoint /_action.

Sesión 202: La arquitectura de persistencia

La Sesión 202 abordó el problema central de persistencia: cada solicitud HTTP creaba un VM::new() con una base de datos vacía en memoria. Los datos guardados durante una solicitud se perdían antes de que comenzara la siguiente.

La corrección fue usar VM::with_storage(), que conecta la VM a una base de datos respaldada en disco. Después de este cambio, el archivo WAL fue creado. Progreso. Pero el archivo estaba vacío.

Sesión 203: Tres causas raíz para un archivo vacío

Causa raíz 1: El bytecode sobrescribe el estado inyectado. El manejador de acciones inyectaba el estado del navegador en la VM, pero el código de inicialización de la página lo sobrescribía. La corrección introdujo un mecanismo de protected_globals.

Causa raíz 2: Value::Text no manejado por Trim. El opcode Trim de la VM solo manejaba Value::Object (cadenas asignadas en el heap). Para Value::Text (cadenas en línea), devolvía una cadena vacía.

Causa raíz 3: Validadores causando fallos silenciosos. Los validadores de entidad rechazaban el guardado, pero el error era absorbido por el manejo de errores del manejador de acciones.

El momento de la verdad

Después de las tres correcciones, los datos llegaron al disco por primera vez. La Sesión 204 verificó el flujo completo: agregar tareas, matar el servidor, reiniciar, verificar que todas las tareas seguían presentes.

Cada capa independientemente impedía que los datos llegaran a la base de datos. Corregir solo una o dos no habría sido suficiente -- las tres tenían que resolverse para que los datos fluyeran por la tubería completa.

La corrección de persistencia no fue una solución elegante única. Fueron tres correcciones separadas para tres errores separados, descubiertos a lo largo de tres sesiones que abarcaron un día entero. Fue desordenado, iterativo y poco glamoroso. También fue absolutamente esencial. Una aplicación de tareas que no guarda tareas no es una aplicación de tareas. Es un ejercicio de mecanografía.


Esta es la Parte 162 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: - [161] El error de seguimiento de versiones temporales - [162] La corrección de persistencia de base de datos que tomó 3 sesiones (estás aquí) - [163] El error de envolvimiento de hijos en layouts

Share this article:

Responses

Write a response
0/2000
Loading responses...

Related Articles

Thales & Claude deblo

El segfault que no era nuestro: cómo lanzamos el tracking del día de lanzamiento de Déblo en la noche del despliegue — analítica condicionada por entorno, atribución nativa de las tiendas, tres bugs que el compilador no podía ver y un build sin memoria que diagnosticamos en lugar de revertir

El 1 de julio de 2026 — el día del lanzamiento — el riesgo nunca fue el texto. Era que las campañas de pago salieran a ciegas. Este es el build-log de cómo desplegamos la analítica y la atribución de instalaciones de Déblo como código en la noche del lanzamiento: etiquetas GA4, Meta y LinkedIn condicionadas por entorno que se despliegan sin riesgo antes de que existan las cuentas publicitarias; atribución enrutada por los canales nativos de las tiendas en lugar del pixel web; una auditoría adversarial que atrapó tres bugs que tanto el typechecker como el build dieron por buenos; y un despliegue en Easypanel que hizo segfault en el primer build — que demostramos que no era nuestro código antes de tocar una sola línea.

18 min Jul 1, 2026
deblolaunch-dayclaude-opus-4.8claude-code +26
Thales & Claude thales

Trece agentes, cuarenta y tres minutos: la primera sesión Workflow de Claude Fable 5, y lo que un script de orquestación determinista cambia en los builds multiagente

Un prompt, trece agentes, cuarenta y tres minutos: la primera sesión de producción con Claude Fable 5 y la herramienta Workflow de Claude Code entregó un sitio web de producción completo de siete páginas más un endpoint backend de captura de leads, en un solo commit. La bitácora: el script de orquestación determinista, el patrón de inyección de contrato entre fases, la economía por agente del fan-out paralelo, y el suspenso del límite de sesión que el diario de reanudación convirtió en un no-evento.

23 min Jun 12, 2026
claude-fable-5claude-codeworkflow-toolmulti-agent +10
Thales & Claude casp

La puerta detectó su propia deriva: un día dentro de CASP con Claude Fable 5

Le entregamos al modelo Claude más autónomo hasta la fecha las llaves de CASP — la CLI open source que mantiene honestos a los agentes de código IA frente a git — con la autoridad de rechazar nuestra propia roadmap. Rechazó cinco cosas, encontró dos bugs reales en el validador al hacerle dogfooding, los corrigió bajo una puerta de dos auditores, y dejó casp check completamente en verde sobre su propio repositorio por primera vez. CASP 0.3.0 es el resultado.

15 min Jun 10, 2026
caspzerosuiteworkflowai-cto +9