Modernización de sistemas
Capa anticorrupción antes del primer corte: qué traducir, qué enrutar y qué evidencia exigir
La capa anticorrupción traduce solo la semántica heredada que el sistema nuevo necesita; la fachada solo enruta el tráfico. Antes del primer corte, exija inventario clasificado, pruebas de contrato y medición de latencia con reversión definida.

La decisión antes del primer corte
La capa anticorrupción debe traducir solo la semántica heredada que el sistema nuevo necesita para funcionar: modelos de datos, protocolos y significados de campos. El enrutamiento del tráfico no es su trabajo; eso pertenece a la fachada. Para aprobar el primer corte, exija un inventario clasificado de campos y operaciones, pruebas de contrato que validen el modelo nuevo y una medición de latencia y fallos con reversión definida.
Microsoft, en el Centro de arquitectura de Azure, describe el patrón Anti-Corruption Layer como una fachada o adaptador entre subsistemas que no comparten la misma semántica. Su función es traducir las solicitudes que un subsistema hace al otro, para que las dependencias de subsistemas externos no limiten el diseño de la aplicación. Eric Evans describió primero este patrón en Domain-Driven Design: Tackling Complexity in the Heart of Software. El contexto que Microsoft señala es el suyo propio: al migrar una aplicación heredada a un sistema moderno, la aplicación nueva sigue usando recursos heredados durante migraciones graduales.
Microsoft advierte que esos sistemas heredados suelen tener problemas de calidad, como esquemas de datos enmarañados o API obsoletas. Sin aislamiento, la aplicación nueva tendría que admitir infraestructura, protocolos, modelos de datos o API obsoletas que no caben en un diseño moderno. Ese es el riesgo concreto que usted aprueba o evita con esta decisión.
Qué traduce la capa y qué deja a la fachada
Según Microsoft, la capa anticorrupción contiene toda la lógica necesaria para traducir entre los dos sistemas. La comunicación entre el subsistema nuevo y la capa usa siempre el modelo de datos del subsistema nuevo; las llamadas de la capa hacia el sistema heredado se ajustan al modelo o métodos de ese sistema. La capa puede implementarse como componente dentro de la aplicación o como servicio independiente.
El enrutamiento es otra pieza. En el patrón Strangler Fig, también del Centro de arquitectura de Azure, una fachada o proxy intercepta las solicitudes dirigidas al sistema heredado y las reparte entre el sistema heredado y el nuevo. Al inicio la fachada dirige la mayoría de las solicitudes al sistema heredado y luego las redirige de forma gradual al nuevo. Microsoft afirma que este patrón reduce los riesgos de la migración al permitir que los equipos avancen a un ritmo acorde con la complejidad del proyecto, mientras la aplicación existente sigue funcionando.
De las dos descripciones se sigue una conclusión razonada, no un diagnóstico de sus sistemas: si el sistema nuevo llama al heredado sin una frontera de traducción, tendrá que acomodar API o semántica heredadas, y eso contradice el objetivo de que esas dependencias no limiten su diseño. Traducir y enrutar son responsabilidades distintas, y conviene que queden en piezas distintas.
El inventario antes de escribir código
Le propongo un paso de diligencia previo al diseño: inventariar cada campo y operación heredados que el sistema nuevo tocará, y clasificarlos en tres cubos. Primero, lo que traduce la capa anticorrupción. Segundo, lo que la fachada solo enruta, sin traducción, porque no hay brecha de semántica. Tercero, lo que el sistema nuevo rechaza o difiere, porque copiarlo extendería el modelo viejo. Cada elemento del inventario debe quedar con evidencia y con un dueño dentro de su equipo.
Esta clasificación es una propuesta de método, no un hallazgo sobre sus sistemas. Nadie puede hacerla desde afuera: depende de cómo están escritos su sistema heredado y su sistema nuevo. Si nadie en su organización puede completar el inventario, ese vacío ya es información para la decisión.
El contrato en la frontera
Microsoft describe principios de diseño de API web RESTful que sirven como referencia para el contrato de la capa: independencia de plataforma, para que los clientes llamen a la API sin conocer la implementación interna, y acoplamiento flexible, para que cliente y servicio evolucionen de forma independiente. Para lograrlo, la fuente indica usar HTTP como protocolo estándar, documentación clara y un formato conocido de intercambio como JSON o XML.
Con esa base, le propongo definir pruebas de contrato en la frontera de la capa anticorrupción que verifiquen el modelo del sistema nuevo, no los nombres de campos heredados. Las pruebas deben incluir latencia y comportamiento ante fallos antes de ampliar el tráfico. Si las pruebas solo comparan contra el formato viejo, la capa se convierte en una copia documentada del problema que quería evitar.
Los costos que cambian el enfoque
Microsoft advierte dos costos del patrón: la capa anticorrupción agrega latencia a las llamadas entre los dos sistemas, y agrega un servicio adicional que debe administrarse y mantenerse. La fuente también pide considerar cómo escalar la capa. No cuantifica ninguno de estos costos, así que ningún número puede decirle cuánto pesarán en su caso.
De esas advertencias se sigue, como inferencia razonada, que la decisión de usar la capa debería incluir un dueño operativo y un plan de escalamiento, no solo reglas de traducción de datos. Microsoft indica que la capa puede ser componente interno o servicio independiente, pero no dice cuándo conviene cada opción; eso depende de su carga y de su equipo, y es algo que debe verificar antes de comprometer una arquitectura.
La evidencia para aprobar el primer corte
Martin Fowler, en su artículo Strangler Fig publicado el 22 de agosto de 2024 como revisión del texto de 2004, escribe que los planes de reemplazo total de un sistema serio suelen fracasar, y prefiere una modernización gradual: pequeñas adiciones construidas sobre el código heredado pero separadas de él, moviendo partes de comportamiento al nuevo. Fowler recoge cuatro actividades para ese enfoque: entender los resultados deseados, decidir cómo dividir el problema, entregar las partes y cambiar la organización para sostenerlo. El orden no implica secuencia.
Con esas actividades como marco, le propongo un primer corte estrecho: una sola función de negocio con una costura identificable, enrutada a través de la capa, comparando comportamiento y latencia contra el sistema heredado, con la reversión definida antes de aumentar el tráfico. La evidencia que usted aprueba no es la capa funcionando, es la comparación medida entre ambos caminos para esa función.
Cuándo traer a un ingeniero
Traiga a un ingeniero antes del primer corte, no después, si ocurre alguna de estas condiciones: nadie puede describir el modelo de datos heredado que la capa tendría que traducir; no existen pruebas de contrato en la frontera; no hay presupuesto de latencia definido para la ruta de pago o de transacción que se va a mover; o la fachada de enrutamiento y la capa de traducción se están diseñando como una sola pieza. Cada una de esas condiciones cambia el alcance del corte y, con él, la decisión que usted firma.