El plan de modernización está listo, el presupuesto aprobado de forma preliminar. El proveedor hace la primera pregunta: «¿Dónde está la documentación del sistema?». Resulta que hay una wiki actualizada por última vez hace cinco años, unos cuantos esquemas «en algún lugar del disco de red» y un código que hace las veces de su propia documentación. El presupuesto sube un tercio. Porque el proveedor no cotiza el trabajo, sino la incertidumbre.
Este texto describe una práctica que quita esa incertidumbre de la mesa: antes de que nadie toque el código de una aplicación antigua, se reconstruye el conocimiento sobre ella. Hasta hace poco, una etapa así suponía semanas de trabajo de un analista y pocos se decidían a hacerla. Hoy la IA ejecuta la mayor parte de ese análisis en días laborables. Y eso cambia el orden de todo el proyecto.
Primero el mapa, después el código
Modernizar un sistema sin documentación actualizada se parece a reformar un edificio sin los planos de las instalaciones. Se puede, pero cada pared que se pica es una lotería: quizá detrás no haya nada, o quizá haya una tubería de la que depende media planta. En las aplicaciones, esa tubería suele ser la integración con el almacén de datos que solo recordaba el autor del código, o la exportación nocturna que contabilidad usa sin que nadie lo sepa.
Por eso el orden sensato es el contrario al intuitivo. No se empieza escribiendo código nuevo, ni siquiera presupuestando. Se empieza por el mapa.
Qué extrae la IA del código, la base de datos y los logs
Las herramientas modernas de análisis saben leer tres fuentes de verdad sobre el sistema: el código fuente, la estructura de la base de datos y los logs de la operación en producción. De su cruce nace un mapa del sistema que abarca cuatro capas.
La primera son los módulos: de qué se compone el sistema y de qué responde cada fragmento, descrito en un lenguaje comprensible también para quienes no son de TI. La segunda, los flujos de datos: por dónde entran los datos, qué les ocurre por el camino, dónde acaban. La tercera, las integraciones, es decir, todos los puntos en los que la aplicación habla con otros sistemas: contabilidad, almacén, tienda, socios. Son las que más a menudo se rompen con los cambios.
La cuarta capa es la menos evidente: el código muerto. El análisis de los logs muestra qué funciones no se han invocado en años y en qué tablas nadie escribe desde 2019. En los sistemas más antiguos, ese lastre suele ser una parte considerable del total. Cada línea que no hay que migrar es un ahorro real en el proyecto.
Qué cambia el mapa en la decisión «reescribir o modernizar»
Sobre la decisión en sí escribimos aparte, en el texto sobre los cuatro criterios: un marco de decisión. El mapa del sistema da a esos criterios datos sólidos. Sin él, la deuda tecnológica se evalúa a ojo y el riesgo, a base de anécdotas. Con él se ve negro sobre blanco: qué módulos aportan valor de negocio, cuáles están muertos, dónde se esconden las integraciones que elevan el riesgo de cada cambio.
Los resultados sorprenden en ambos sentidos. A veces el sistema que «hay que reescribir desde cero» resulta estar sano en sus tres cuartas partes y basta con sustituir dos módulos. A veces es al revés: la aplicación parece inocente y el mapa revela una docena larga de conexiones sin documentar que hacen la modernización parcial más cara que la reescritura. En ambos casos la decisión se toma sobre datos, no sobre emociones. Y el proveedor que recibe un mapa en lugar de un enigma cotiza trabajo en lugar de riesgo.
En nuestra opinión, la reconstrucción del mapa debería ser una etapa aparte y primera del contrato de modernización, con su propia entrega. Aunque después de esa etapa decidas que la modernización la hace otro, o que no la haces en absoluto, la documentación se queda en la empresa y sigue trabajando.
Cómo verificar lo que ha generado la IA
La documentación generada automáticamente no es un oráculo. Hay que comprobarla. El método más eficaz es simple: una revisión con la persona que mejor conoce el sistema, a menudo la única en la empresa. La diferencia respecto al enfoque clásico está en el papel de esa persona. No le pides que ponga por escrito su conocimiento, algo que nadie soporta y que se alarga meses. Le pides que revise una descripción ya hecha, y señalar «esto cuadra, esto no» va muchas veces más rápido que escribir desde cero.
Una buena práctica es recorrer de principio a fin unos cuantos procesos clave: pedido, factura, reclamación. Si el mapa describe correctamente los flujos críticos y los detalles comprobados al azar, se puede confiar en él en el resto de áreas. Y eso se hace en un día.
Lo que la IA no puede reconstruir
Aquí, una advertencia honesta: el código dice qué hace el sistema, pero no dice para qué. Una excepción extraña en el cálculo de un descuento puede ser un error o puede ser un acuerdo comercial de 2016 que sigue vigente para un gran cliente. Eso no lo resuelve ningún análisis de código. Las intenciones de negocio de hace una década se reconstruyen con entrevistas: conversaciones cortas con la gente de ventas, contabilidad y operaciones, ya con el mapa en la mano. El mapa sugiere qué preguntar, pero las respuestas las tiene una persona.
Un tema aparte es el entorno de la aplicación: servidores, red, copias de seguridad. Sobre cómo documentar esa capa escribimos en el texto sobre la auditoría de la documentación de infraestructura.
En ESKOM AI llevamos a cabo la etapa de mapeo con un equipo de agentes de IA especializados bajo la supervisión de ingenieros experimentados: el análisis de un sistema corporativo típico lleva días laborables, y el resultado es una documentación legible tanto para la dirección como para el equipo técnico. Si después se toma la decisión de modernizar, los trabajos posteriores discurren en un proceso automatizado de desarrollo de software con una batería completa de pruebas: unitarias, de integración, E2E, de UI, de seguridad y de rendimiento.
Por dónde empezar en tu empresa
Elige un sistema: aquel cuya modernización llevas más tiempo aplazando o el que más miedo te da tocar. Encarga la reconstrucción de su mapa como una etapa independiente y pequeña, antes de pedir a nadie un presupuesto de la reconstrucción completa. En una consulta gratuita te orientamos sobre cómo planificar esa etapa y qué esperar de ella.
Reserva una consulta gratuita a través del formulario de contacto →