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.
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.
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
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.
De globales en PHP a módulos tipados
Una arquitectura modular en TypeScript reemplazó el código heredado en PHP.
Punto de partida
- Aplicación heredada de seguimiento de incidencias en PHP
- 57 de 70 módulos centrales en un solo ciclo de dependencias
- 461 interruptores de configuración globales
- Pruebas automatizadas de interfaz muy limitadas
Solución modernizada
- React
- Nest.js
- PostgreSQL
- Arquitectura modular en TypeScript
- 79 rutas de API tipadas
Entrega habilitada por IA y liderada por personas
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.
Ingenieros líderes
ResponsabilidadResponsables de la arquitectura, la seguridad, la validación y las decisiones de entrega durante toda la migración.
Agentes de codificación con IA
ApoyoApoyan la lectura del código heredado, la redacción, la generación y la documentación bajo revisión de los ingenieros.
QA y conciliación
EvidenciaPruebas automatizadas, evidencia de migración y verificaciones de conciliación antes de cada versión.
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
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.