Migración de un motor personalizado heredado a una plataforma soportada

Muevo sitios en vivo de motores escritos a mano que ya nadie soporta. La situación suele ser la misma: el código se armó hace años para una tarea específica, la persona que lo escribió ya no está, cada pequeño cambio cuesta días de conjeturas, y la base de datos contiene años de contenido real que no se puede volver a escribir simplemente. Mi trabajo es llevar ese contenido y ese comportamiento a una plataforma mantenida — una con documentación, actualizaciones regulares y más de un especialista en el mundo que pueda leerlo.

Comienza con la lectura, no con la escritura. Reviso el código antiguo y la estructura de la tabla y armo un inventario: qué páginas, formularios, roles de usuario y trabajos en segundo plano están realmente en uso, qué tablas están activas y cuáles han estado muertas durante cinco años. Ese inventario se acuerda con usted antes de que se mueva un solo registro. Una reescritura hecha de memoria siempre pierde la mitad de las pequeñas cosas: un filtro que alguien usa una vez al mes, una carta que se envía al registrarse, un formulario imprimible del que depende el contador, así que el inventario viene primero y se convierte en la lista contra la que ambos verificamos el resultado. Después de eso, los datos se transfieren con recuentos de registros comparados tabla por tabla y relaciones verificadas, se reconstruyen direcciones y redirecciones para que el tráfico de búsqueda y los enlaces antiguos sigan funcionando, se portan plantillas y formularios, se reemplazan bibliotecas obsoletas por versiones soportadas, y la configuración se extrae del código a la configuración donde pertenece.

Cuento la migración como completa cuando los números coinciden y el contenido ha sido verificado por muestreo — no en el momento en que el nuevo sitio se abre en un navegador, porque una página vacía también se abre de manera hermosa. La versión antigua y una copia de la base de datos permanecen intactas hasta el final del período de garantía, por lo que siempre hay algo con qué comparar y un lugar al que retroceder. Su personal recibe una instrucción por escrito y un recorrido en vivo, y el movimiento en sí se planifica en etapas, de modo que el sitio actual siga sirviendo a los visitantes desde el primer día hasta el último.

Lo que incluye el trabajo:
— leer el código antiguo y la estructura de la base de datos, con un inventario escrito de lo que realmente se usa y lo que está muerto;
— transferencia de datos con recuentos de registros reconciliados tabla por tabla y relaciones entre registros verificadas;
— reconstrucción de direcciones y redirecciones para que las páginas indexadas y los enlaces externos no se rompan;
— portación de plantillas y formularios, incluyendo la validación y las cartas que desencadenan;
— reemplazo de bibliotecas obsoletas por equivalentes soportados;
— separación de configuraciones del código, para que los entornos dejen de diferir por accidente;
— una instrucción y capacitación para su personal, en un lenguaje claro en lugar de jerga de desarrollador;
— un plan de reubicación por etapas que mantiene el sitio funcionando durante todo el proceso.