← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
VII · La calidad
Capítulo
20
Estado
Borrador
Patrones
Pruebas unitarias y de integración (Unit and Integration Tests) · Revisión de código (Code Review) · Control de versiones (Version Control) · Deuda técnica (Technical Debt)

Probetas, planos y fisuras

Cómo comprobar que algo aguanta, quién lo revisa, cómo queda su historia y qué cuesta el atajo.

1Primero, la losa de la terraza

Antes del primer vaciado, el supervisor pide que otro ingeniero revise el cálculo. El revisor repite una viga y halla lo que el calculista ya no veía, pues usó para el entrepiso del local la sobrecarga de vivienda y no la de comercio. Se corrige en la oficina técnica, donde cuesta una hoja y no una demolición.

La corrección sale como revisión B del plano. Su cuadro de revisiones anota letra, fecha, qué cambió y quién lo dibujó, revisó y aprobó. La A queda superada en la planoteca (capítulos 3 y 8), y así se sabe con qué juego de planos se vació cada nivel.

Marta, la residente, toma probetas de cada vaciado, cilindros de hormigón numerados que se rompen en el laboratorio a los 28 días. Si un ensayo no llega a la resistencia especificada, el número dice de qué mixer salió (capítulo 4). Son baratas, pero miden el hormigón solo. No dicen si el fierro quedó en su lugar ni cómo trabaja la losa con sus vigas.

Por eso, antes de entregar, las especificaciones técnicas piden una prueba de carga en la losa de la terraza, que sostendrá el tanque. Se la carga con agua hasta un peso fijado de antemano, unos relojes comparadores miden cuánto baja y se descarga para medir cuánto vuelve.

Antes de entregar aparece una fisura en el revoque de un tabique del nivel 5. Quedó pegado a una viga, que se deforma con el tiempo. Tratar la causa lleva tres días que no hay, y el propietario decide resanar y tratarla en el primer mantenimiento. El supervisor lo anota en el libro de órdenes con la causa y la fecha, porque sin esa nota la fisura volvería sin explicación.

Funciona porque cada control lo juzga alguien distinto de quien hizo el trabajo (el laboratorio, el revisor, el supervisor), y lo que se posterga queda escrito.

2El mismo problema, en la app del banco

La comisión sube de 0,6 % a 0,7 % el mes siguiente. El programador edita la fila de la tarifa vigente en lugar de agregar otra con su fecha de vigencia (capítulo 3). Prueba una transferencia de 800 Bs, ve 5,60 Bs y sube el cambio al servidor. A fin de mes, el informe de comisiones recalcula con la tabla de tarifas y da 5,60 Bs para la transferencia de Rosa del mes pasado, que pagó 4,80 Bs.

—¿Por qué el informe no cuadra con lo cobrado? —pregunta la gerente.

—La probé con un solo caso y nadie más miró el cambio —responde el programador—. Tampoco hay historial para ver qué había antes.

Es la obra sin probetas, sin revisor y sin cuadro de revisiones.

3Las cuatro piezas

1Las pruebasUnit Tests · Integration Tests

Es la probeta y la prueba de carga. Una prueba es un programa corto que prepara datos, ejecuta una pieza y compara con lo esperado.

Probeta el material solo Prueba de carga las piezas juntas 800 Bs tarifa del mes pasado 0,6 % entra Comisión función pura sale sale 4,80 Bs esperado 4,80 Bs pasa Rosa 1.000 Bs negocio 0 Bs tarifa de prueba 0,5 % transfiere 800 Transferir reglas y base de prueba queda Rosa 196 Bs negocio 800 Bs pasa muchas, baratas señalan la pieza pocas, caras dicen si el conjunto anda
La comisión sola hace de probeta, y las piezas juntas, con cuentas de prueba, hacen de prueba de carga.

La prueba unitaria es la probeta, una pieza probada sola, sin base de datos ni red. La comisión es el caso fácil, porque es una función pura (capítulo 3), y el límite diario también, si se le da lo ya transferido en el día (capítulo 9). Escrita como ejemplo con las palabras del glosario, la gerente la lee y dice si es la regla, y la computadora la comprueba. Así trabaja el desarrollo guiado por el comportamiento (Behavior-Driven Development, capítulo 1).

La prueba de integración es la prueba de carga de la estructura, con varias piezas, una base de datos de prueba y un adaptador de prueba que da un tipo de cambio fijo (capítulo 13). Una simula un corte entre el débito y el crédito (capítulo 8) y comprueba que ninguna cuenta cambió. Una carrera se prueba provocándola (capítulo 15). Una prueba también puede vigilar la estructura, como que el núcleo no use la base de datos (capítulo 2). La «prueba de carga» de software, que mide cuántos usuarios aguanta la app, es otra cosa y se ve en el capítulo 22. El glosario del capítulo 28 las separa.

Por lo tanto

cada pieza se comprueba sola con ejemplos, y el conjunto, con menos pruebas, sobre datos de prueba.

2La revisión de códigoCode Review

Es el revisor del cálculo y la autorización de vaciado del supervisor. Antes de que un cambio entre al programa, otra persona lo lee y lo aprueba o lo devuelve. Quien lo escribió ya no ve sus suposiciones, y el revisor mira lo que ninguna prueba pregunta, como por qué se anota en los movimientos sin pasar por la cuenta. La puerta única del capítulo 5 es una regla de orden, y la revisión la hace cumplir en cada cambio.

Por lo tanto

ningún cambio entra sin que otra persona lo haya leído.

3El control de versionesVersion Control · Branch · Merge

Es la planoteca con su cuadro de revisiones. Cada cambio se guarda como una foto de todo el programa (commit), y las anteriores no se borran. Una rama (branch) es el borrador, una copia de trabajo que no toca lo vigente y también guarda sus fotos. Lo aceptado se fusiona (merge) con lo vigente. Si dos borradores cambiaron lo mismo, el sistema avisa del choque y una persona decide. El revisor mira justo antes de fusionar.

Borrador copia de la B Revisor otra persona propone parte de B emite C emite B B sigue vigente A B C inicial superada carga de comercio vigente hasta la C cambio aprobado vigente Cada emisión guarda quién, cuándo y por qué Se ve qué cambió y se puede volver a la A
Un borrador de la B pasa por un revisor antes de emitirse como C. Mientras tanto sigue vigente la B.

Aquí, una versión es cada estado guardado del código, y no el número que se compara al guardar un dato (capítulo 15) ni el formato de pedidos que el servidor atiende (capítulo 17). La que se entrega se ve en el capítulo 25. El glosario del capítulo 28 las separa.

Por lo tanto

cada cambio queda guardado con autor y motivo, y lo vigente no se toca hasta aprobar el borrador.

4La deuda técnicaTechnical Debt · Refactoring

Es el resane sin tratar la causa. La deuda técnica es, en su forma deliberada, un atajo que hoy funciona y se toma para entregar antes. Para lanzar el QR a tiempo, el programador copia el cálculo de la comisión en un segundo lugar. Funciona como un préstamo. Lo ahorrado es el capital y el interés es lo que cuesta cada cambio que se apoya en el atajo, como cambiar cada tarifa nueva en dos sitios. Se paga arreglando la causa, es decir refactorizar (refactoring), cambiar la forma interna sin cambiar lo que hace, y eso solo se hace con confianza si hay pruebas. Se anota con su plazo, como en el libro de órdenes. Sin nota es un desorden.

Por lo tanto

el atajo se anota con su plazo y se paga arreglando la causa, no resanando de nuevo.

4Qué se gana y qué cuesta

Lo que se gana

  • Un defecto aparece donde nació, antes de llegar a Rosa.
  • Lo arreglado no se rompe sin aviso.
  • Cada cambio tiene autor, motivo y vuelta atrás.

Lo que cuesta

  • Las pruebas se escriben y se mantienen, y una mal hecha da falsa seguridad.
  • La revisión espera a una persona, y un cambio enorme se revisa mal.
  • Pagar una deuda no entrega nada nuevo.

Cuándo no conviene. Un prototipo que se va a botar no necesita todas las pruebas ni revisar cada línea, pero sí historial. Se prueba lo que sale caro si falla, como el cobro, no todo.

Con qué se combina. Con las funciones puras (capítulo 3), los repositorios en memoria (capítulo 8), la costura (capítulo 11) y los dobles de prueba (capítulo 13), que facilitan probar la pieza sola, y con la entrega (se ve en el capítulo 25), donde las pruebas serán la puerta, como las probetas.

5Para llevarse

En el edificioEn la app del bancoPatrón
Probeta, el hormigón soloPrueba de la comisión y del límiteUnit Test
Prueba de carga de la estructuraPrueba de la transferencia enteraIntegration Test
Otro ingeniero revisa el cálculoOtra persona lee el cambio antes de que entreCode Review
Cuadro de revisiones en la planotecaHistorial de cambios, con ramas y fusiónVersion Control
Fisura resanada, anotada con su plazoAtajo anotado, para pagar despuésTechnical Debt
Dónde cojea la analogía

La fisura es una patología, un daño que nadie decidió, y la deuda técnica es una decisión con plazo. Lo que se parece a la deuda no es la fisura sino el resane postergado, y por eso la equivalencia es media.

La probeta se rompe y no se repite, y la prueba de carga se hace una vez, sobre la losa real. Una prueba automática corre en cada cambio a costo casi nulo, pero la de integración usa una copia con datos de prueba, y pasarla no garantiza que producción ande igual.

En la práctica, a noviembre de 2026. JUnit en Java, pytest en Python, xUnit.net en .NET y Jest en JavaScript sirven para escribir y correr pruebas. Git guarda el historial y las ramas, y GitHub y GitLab agregan la revisión de cambios (pull request y merge request). Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 21 · Servidores, contenedores y entornosLos locales de planta baja, que se alquilan en obra gruesa, con instalaciones o amoblados.