Cómo migrar un sistema legacy a código abierto sin detener la operación
Migrar un sistema legacy tiene mala fama, y con razón. Este es el método que seguimos para que el sistema nuevo haga todo lo que hacía el antiguo, sin apagar la operación en el camino.

Muchos proyectos de migración terminan con un sistema nuevo que hace menos que el antiguo, datos que no cuadran y un equipo que vuelve a sus planillas. Casi siempre el problema es el mismo: se trató la migración como un problema de tecnología, cuando es un problema de conocimiento. El sistema antiguo sabe cosas que nadie escribió.
Este es el método que seguimos en Veltrum. Se ajusta a cada caso, pero el orden no cambia.
1. Inventario: qué hace realmente el sistema
Partimos por levantar el sistema tal como se usa, no como se diseñó. Conversamos con quienes lo operan, revisamos la base de datos y recorremos cada pantalla y cada reporte. El resultado es un mapa de módulos con tres datos por cada uno: qué proceso soporta, quién lo usa y qué tan crítico es.
En este paso aparecen las sorpresas: módulos que nadie usa hace años, reportes que se sacan del sistema para rehacerse en Excel, procesos que dependen de un campo que alguien reutilizó para otra cosa. Todo eso define qué se migra, qué se rediseña y qué se deja atrás.
2. Rescatar las reglas del negocio
Las reglas importantes —cómo se calcula un descuento, cuándo un pedido pasa a estar atrasado, qué validaciones tiene una factura— suelen estar escritas en el código del sistema antiguo y en ningún otro lugar. Las extraemos leyendo ese código, con apoyo de IA para recorrer bases de código grandes o escritas en lenguajes que hoy casi nadie programa, y las validamos con las personas que operan el proceso.
Cada regla queda documentada en lenguaje de negocio y, cuando se puede, convertida en una prueba automática: dado este pedido, el sistema antiguo calcula este resultado. Esas pruebas son las que después demuestran que el sistema nuevo hace lo mismo.
3. Ajustar código abierto o construir desde cero
Con el mapa y las reglas sobre la mesa, se decide la arquitectura módulo por módulo. Hay dos caminos, y la mayoría de los proyectos combina ambos.
Ajustar una base de código abierto. Para procesos donde tu empresa opera como la mayoría —contabilidad, compras, inventario estándar— normalmente existe un producto open source maduro, mantenido por una comunidad grande. Lo instalamos en tu infraestructura y le agregamos lo que es propio de tu operación. No pagas licencias por usuario y el código queda en tu repositorio.
Construir desde cero con Next.js y FastAPI. Cuando el proceso es lo que te diferencia, construimos el sistema a la medida. Usamos Next.js para la interfaz —aplicaciones web rápidas, que funcionan en cualquier navegador y en el celular— y FastAPI para la API y la lógica de negocio, en Python. Elegimos este stack por tres razones: son tecnologías de código abierto con comunidades enormes, cualquier equipo de desarrollo competente puede mantenerlas, y Python es el lenguaje natural para conectar después datos, modelos predictivos y agentes de IA.
4. Migrar por etapas, con los dos sistemas en paralelo
No hacemos "el gran corte" de un fin de semana. Migramos módulo por módulo: el sistema nuevo asume un proceso mientras el antiguo sigue operando el resto. La técnica tiene nombre en ingeniería de software —el patrón strangler fig, por la higuera que crece alrededor de un árbol hasta reemplazarlo— y su ventaja es que el riesgo se reparte en entregas pequeñas.
Durante cada etapa, ambos sistemas procesan los mismos datos y comparamos los resultados. Mientras los números no calcen, el antiguo sigue siendo la fuente de verdad. Cuando calzan de forma sostenida, se hace el corte de ese módulo.
5. Los datos: migrar, limpiar y reconciliar
Los datos de un sistema legacy rara vez están limpios: hay duplicados, campos usados para fines distintos, registros incompletos. La migración es la oportunidad de ordenarlos, pero cada transformación queda registrada y cada tabla migrada se reconcilia contra el origen: cantidades, totales y saldos tienen que coincidir antes de dar el paso por cerrado.
No siempre el origen es una base de datos. En un proyecto reciente con una empresa del rubro inmobiliario, los clientes, contratos y documentos vivían en planillas y carpetas compartidas. Los llevamos con scripts a su plataforma nueva, revisando con su equipo cada registro dudoso en vez de adivinar.
6. Traspaso: lo que te queda al final
- El código fuente, en un repositorio Git privado de tu propiedad.
- La infraestructura desplegada en tu nube, bajo tus cuentas.
- Las reglas del negocio documentadas en un lenguaje que entiende quien opera el proceso, no sólo quien lo programa.
- Pruebas automáticas que protegen esas reglas en cada cambio futuro.
- Tu equipo capacitado para operarlo, y la libertad de que lo mantengamos nosotros, otro proveedor o tu propio equipo.
Código abierto no significa código público
Una duda frecuente: si el sistema se construye sobre código abierto, ¿cualquiera puede ver el de mi empresa? No. Código abierto describe la licencia de los componentes sobre los que se construye —Next.js, FastAPI, PostgreSQL o un ERP en su edición community—, que se pueden usar sin pagar y sin pedir permiso. Lo que construimos encima es tuyo y vive en un repositorio privado.
La ventaja de partir de código abierto es justamente esa: no quedas atado a la hoja de ruta ni a los precios de un proveedor, y el día que quieras cambiar de equipo, el sistema se va contigo.
Especialidad de Veltrum
Migración desde sistemas legacy
Del sistema que nadie se atreve a tocar a un repositorio propio, con Next.js y FastAPI, sin detener la operación.
Ver la especialidad

