Saltar al contenido
← Volver a artículos

Nuestras pruebas pasaron. El cliente redibujó todo a mano.

Un motor de trazado de ductos salió a producción con todas las pruebas en verde, y aun así el contratista redibujó su resultado a mano. Lo que eso nos enseñó sobre la distancia entre software correcto y software aceptado, y cómo lo probamos ahora.

IngenieríaPruebasCriterio de producto
Un contratista redibuja con lápiz rojo un trazado de ductos sobre un plano de planta impreso, con una cinta métrica y guantes de trabajo sobre el banco.

Lanzamos una función de trazado automático de ductos con toda la suite de pruebas en verde. Cada trazado que producía era válido: los tramos estaban alineados a los ejes, los ductos tenían el tamaño correcto y el caudal de aire cuadraba a lo largo de la troncal. Según todas las verificaciones que habíamos escrito, funcionaba.

El contratista imprimió el resultado y redibujó cada ducto a mano.

No había nada roto de una forma que nuestras pruebas pudieran ver. “Las pruebas pasan” y “la persona que se gana la vida con esto acepta el resultado” resultaron ser dos afirmaciones distintas, y al cliente solo le importaba la segunda.

La causa fue una sola coordenada

El motor anclaba la troncal principal en la posición de la manejadora de aire. Suena razonable, porque de la manejadora sale el aire. Pero la manejadora está en el borde del plano de planta. Anclar ahí la troncal significaba que cada ramal tenía que recorrer desde ese borde todo el plano para llegar a su rejilla.

El resultado era un sistema de ductos válido que ningún contratista construiría: una columna pegada a una pared, con ramales largos que cruzaban toda la planta.

El problema se podía medir. La longitud total de los ramales sumaba unos 2140 px en el dibujo. Una rejilla pequeña de un clóset que necesitaba solo 7 CFM tenía un ramal de 450 px.

Una persona no lo dibuja así. Una persona lleva la troncal por el medio de las rejillas a las que sirve, de modo que los ramales quedan cortos y equilibrados a ambos lados.

La corrección fue una sola palabra. En lugar de anclar la troncal en la coordenada de la manejadora de aire, la anclamos en la mediana de las coordenadas de las rejillas. La longitud total de los ramales bajó a 840 px, y el ramal del clóset se convirtió en un tramo corto. Nada más cambió.

Pasar y ser aceptado son afirmaciones distintas

Las pruebas no estaban mal. Verificaban exactamente lo que les habíamos pedido verificar: la geometría es ortogonal, el caudal nunca aumenta a lo largo de la troncal, los ramales salen por ambos lados y los codos caen en las esquinas. Todo eso era cierto antes de la corrección y después de ella.

Lo que la suite no verificaba era justo lo que definía la función: el dibujo tiene que parecerse a uno que dibujaría un contratista. No habíamos escrito esa prueba porque todavía no sabíamos que ese era el requisito. Entendíamos la física. No habíamos encontrado el objetivo.

El redibujo no fue una queja. Fue la especificación, entregada tarde y en la forma más clara posible: un experto haciendo el trabajo como debe hacerse.

Encontrar el objetivo real

Buena parte de lo que cuenta como habilidad de ingeniería ante un problema nuevo es descubrir qué estás optimizando en realidad. Es fácil optimizar el objetivo que te dieron. Es más difícil darse cuenta de que el objetivo declarado (“producir un trazado de ductos válido”) ocupa el lugar de uno no declarado (“producir el trazado que habría dibujado un experto”), y encontrar el real antes de que el cliente tenga que dibujártelo.

Se encuentra observando cómo se usa el trabajo, no releyendo el brief. El brief decía “dimensionar y trazar los ductos”. No decía “mantener los ramales cortos y centrar la troncal en sus rejillas”, porque el contratista no lo pensaba como un requisito. Simplemente así se dibujan los ductos. Para ellos era invisible y para nosotros desconocido, y los requisitos de ese tipo solo salen a la luz cuando un usuario real tiene el resultado en las manos.

Lo que cambiamos

Una vez que se conoce el objetivo, deja de ser cuestión de gusto. Se convierte en una prueba como cualquier otra. El redibujo se transformó en una sola aserción: la longitud total de los ramales se mantiene por debajo de 1100 px, verificada en cada ejecución.

La lección va más allá de este error puntual y hoy define cómo construimos:

  • Probar la propiedad que un experto reconocería, no las coordenadas. “Devuelve exactamente estos puntos” puede pasar mientras la función está mal. “Los ramales son cortos y están equilibrados a ambos lados” es lo que le importa a un contratista, y sigue teniendo sentido cuando cambia la implementación interna.
  • Tratar el primer redibujo de un experto como la especificación. Cuando alguien que conoce el dominio rehace tu resultado a mano, ese retrabajo es el requisito. Hay que capturarlo como una verificación antes de cambiar el código, para que no pueda haber una regresión.
  • Poner el resultado frente a un usuario real desde temprano. El objetivo que asumiste y el que importa rara vez son el mismo, y en la distancia entre ambos está el trabajo de verdad.

Una decisión de diseño hizo que esto fuera fácil de corregir. El motor de trazado es una función pura: entran números, sale geometría, sin interfaz de usuario de por medio. El problema se podía reproducir, medir y probar sin abrir el lienzo, y por eso un cambio de una sola palabra se pudo verificar en lugar de dejarlo a la esperanza. El proyecto completo está descrito en el caso de estudio de la plataforma HVAC.

Las pruebas en verde nos dijeron que el código hacía lo que habíamos pedido. El redibujo nos dijo lo que debimos haber pedido.

¿Trabajando en algo de este tipo?

Si algo de esto se parece al problema que tienes delante, cuéntanos dónde estás y adónde quieres llegar. Volvemos con un plan en dos días hábiles.