contact@neural.com.do Lunes a viernes, 8:00 a. m. a 5:00 p. m. (GMT-4)
Santo Domingo, República Dominicana +1 (809) 545-5185
Volver a casos de éxito
Proyecto de referencia · Modernización de sistemas heredados

Gestor de incidencias MantisBT → React + Nest.js + PostgreSQL

Una aplicación heredada de seguimiento de incidencias en PHP, con 57 de sus 70 módulos centrales en un solo ciclo de dependencias y 461 interruptores de configuración globales, reconstruida como una aplicación modular en TypeScript sobre React, Nest.js y PostgreSQL con 79 rutas de API tipadas. Primera versión en producción el día 10, entrega completa en 13 días.

Esta aplicación heredada de código abierto fue migrada por el equipo de Neural como proyecto de referencia, con las mismas prácticas de ingeniería, herramientas y criterios de aceptación que se aplican a los proyectos de clientes.

Migración de referencia de MantisBT en PHP a React, Nest.js y PostgreSQL
Clasificación
Modernización de sistemas heredados
Tecnologías
PHP (origen), React, Nest.js, TypeScript, PostgreSQL
Tipo de proyecto
Proyecto de referencia, modernización de sistemas heredados
Año de entrega
2026
Modelo de colaboración
Proyecto de referencia (modernización de sistemas heredados)
Plataforma
Aplicación web
Soluciones relacionadas
El reto

Un ciclo de dependencias que ataba 57 de 70 módulos

MantisBT es una aplicación heredada de seguimiento de incidencias en PHP en la que 57 de los 70 módulos centrales están dentro de un único ciclo de dependencias, el comportamiento se rige por 461 interruptores de configuración globales y las pruebas automatizadas de interfaz son muy limitadas. Cambiar una parte con seguridad exigía entender casi todo.

El objetivo era una arquitectura modular y tipada que conservara la funcionalidad del gestor y volviera el código comprensible, probable y seguro de cambiar.

El proceso

Una arquitectura modular en TypeScript con 79 rutas de API tipadas

Primero se mapeó el grafo de dependencias, lo que hizo visible y medible el ciclo y la superficie de configuración. La arquitectura objetivo separó los módulos en límites tipados, y el plan secuenció la reconstrucción para que cada módulo pudiera verificarse contra el comportamiento heredado.

Las tres migraciones de referencia se ejecutaron en paralelo entre el 21 de septiembre y el 3 de octubre de 2026, con aproximadamente 70 horas de ingeniería registradas en conjunto, siguiendo un mismo proceso.

Lo que entregó el equipo

  • Front end en React para los flujos de seguimiento de incidencias
  • Backend en Nest.js con TypeScript y arquitectura modular en lugar del ciclo de dependencias
  • 79 rutas de API tipadas
  • Capa de datos en PostgreSQL migrada desde el esquema heredado
  • Interruptores de configuración globales reemplazados por configuración explícita y tipada
  • Pruebas automatizadas donde la aplicación heredada casi no tenía
  • Runbook, disparadores de reversión, monitoreo y documentación de operación
Detalles del proyecto

Cómo se ejecutó la migración

Proceso de modernización compartido

Las tres migraciones de referencia se ejecutaron en paralelo entre el 21 de septiembre y el 3 de octubre de 2026, con aproximadamente 70 horas de ingeniería registradas en conjunto, siguiendo un mismo proceso.

01 · Escanear y mapear

Grafo de dependencias, modelo de datos, postura de seguridad y registro de riesgos construidos a partir del código heredado antes de tomar cualquier decisión.

02 · Diseñar y planificar

Arquitectura objetivo, decisiones de diseño por escrito y un plan de implementación a nivel de tareas, revisados por los ingenieros responsables de la entrega.

03 · Construir con evidencia

Código, pruebas, infraestructura, documentación, evidencia de migración o ETL y conciliación producidos juntos, para que cada incremento pueda verificarse.

04 · Migrar y entregar

Runbook, disparadores de reversión, monitoreo, documentación de operación y paquete de credenciales entregados con la versión.

El resultado

De un ciclo de dependencias a límites tipados y modulares

La primera versión en producción salió el día 10 y la entrega completa se cumplió en 13 días, con 79 rutas de API tipadas en lugar de la maraña de módulos heredada.

Día 10

Primera versión en producción.

13 días

Entrega completa.

79

Rutas de API tipadas.

Capacidades

  • Modernización de sistemas heredados
  • Migración de PHP a TypeScript
  • Diseño de arquitectura modular
  • Diseño de API
  • Automatización de QA
  • DevOps y documentación

Proceso

Escanear y mapear, diseñar y planificar, construir con evidencia, migrar y entregar, con el grafo de dependencias como punto de partida de la arquitectura.

Rol de la IA

Entrega habilitada por IA y liderada por personas: ingenieros experimentados lideraron la migración, agentes de codificación con IA apoyaron la lectura del código heredado, la redacción, la generación y la documentación, y los ingenieros conservaron la responsabilidad sobre la arquitectura, la seguridad, la validación y cada decisión importante de entrega.

¿Listo para hablar de su próximo proyecto?

Hablemos