← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
I · Las bases
Capítulo
3
Estado
Borrador
Patrones
Programación orientada a objetos (Object-Oriented Programming) · Encapsulación (Encapsulation) · Polimorfismo (Polymorphism) · Composición frente a herencia (Composition over Inheritance) · Programación funcional (Functional Programming) · Función pura (Pure Function) · Inmutabilidad (Immutability) · Efectos en el borde (Functional Core, Imperative Shell)

Ducto y memoria de cálculo

Cómo se ordenan las piezas que guardan su estado y los cálculos que solo dependen de lo que reciben.

1Primero, el ducto y la memoria

La arquitecta dibuja una sola vez la planta tipo de los departamentos y la obra la repite en cada piso. Cada uno tiene su propio estado, el tercero ya con revoque y el cuarto todavía en obra gruesa.

Todavía en planos, para el último piso escribe «igual a la planta tipo, con terraza». Al agregar un balcón en la fachada de la tipo, aparece también en el último piso y choca con su terraza. Desde entonces los planos se arman con piezas definidas, como el baño tipo, y dicen cuáles llevan.

El ducto sube por las seis plantas, cerrado con tabique, y en cada una tiene una caja de registro por donde se llega a la llave de paso. Los departamentos solo conocen esa caja. Si cambia el material de la tubería, los plomeros trabajan por el ducto, sin entrar a ningún departamento. Como la unión es normalizada, entra una llave esférica o una de compuerta, de cualquier fabricante. Las dos cierran el paso, cada una a su modo.

Afuera Adentro Departamento pide Caja de registro conecta Tubería no ve lo de adentro el material puede cambiar
El departamento solo ve la caja de registro. Detrás, la tubería puede cambiar.

Con la memoria de cálculo el problema es otro. En abril el calculista calculó la viga V-305, del nivel 3, y salieron cuatro fierros de 16 mm. En junio, antes del vaciado, el supervisor pidió repetir el cálculo y salieron cinco, con la misma hoja y el mismo plano.

La hoja tomaba tres datos sin mostrarlos. El peso de los acabados venía de otra hoja, la resistencia del hormigón de la última obra, y la edición de la norma dependía del día en que se hacía la cuenta.

El calculista lo resolvió con tres reglas.

Antes Cuadro de datos Otra hoja Última obra Fecha de hoy a la vista sin verse sin verse sin verse Memoria de cálculo Resultado cambia Después Cuadro de datos cargas resistencias norma y su año todo entra Memoria de cálculo Resultado el mismo
Antes, tres datos entraban sin pasar por el cuadro. Después, todo entra por él.

Funciona porque cada resultado se explica por sus datos y por nada más.

2El mismo problema, en la app del banco

La app cobra una comisión por las transferencias. Lo mínimo que se le pide al cálculo es que la pantalla y el cobro de una misma transferencia den la misma comisión.

Rosa prepara una transferencia de 800 Bs a las 23:58 del último día del mes. La pantalla le muestra una comisión de 4,00 Bs. Confirma a las 00:02 y le cobran 4,80, porque a medianoche entró una tarifa nueva.

—¿Por qué la pantalla dice una cosa y el cobro otra? —pregunta la gerente.

—El cálculo lee el reloj cada vez que lo llaman —responde el programador—. Pasaron cuatro minutos y cambió la tarifa, y nadie decidió qué fecha manda.

Además, cada cálculo anota una línea en el registro, y repetirlo para revisar una cifra lo llena de comisiones que nunca se cobraron. Es la memoria que corta fierro cada vez que alguien la repite.

Del lado de las piezas, tres partes del programa (transferencias, pagos con QR y retiros) cambian el saldo disponible de la cuenta directamente. La regla de no retirar más de lo permitido se copió en dos y se olvidó en la tercera. Es como si cada departamento abriera el tabique del ducto para llegar a la tubería, en vez de usar la caja de registro.

3Las siete piezas

1El objeto y su claseObject · Class

La clase hace de planta tipo, porque define qué datos guarda una pieza y qué se le puede pedir. Cada objeto es una pieza construida con ella, como la cuenta de Rosa o la de un proveedor, cada una con su saldo y las operaciones que lo tocan.

Por lo tanto

los datos y lo que se les puede hacer viven juntos.

2La encapsulación y la interfazEncapsulation · Interface

Es el ducto con su caja de registro. La interfaz es lo que se puede pedir por esa caja, en la cuenta «depositar», «retirar» y «consultar el saldo disponible». Cómo se guarda el saldo queda adentro y puede cambiar. La regla de no retirar más de lo permitido vive en un solo lugar.

Por lo tanto

se pide por la interfaz, y adentro se cambia lo que haga falta.

3El polimorfismoPolymorphism

Es la unión normalizada, con llaves distintas que se conectan igual. Una caja de ahorro y una cuenta corriente responden a «retirar» cada una a su manera, porque la corriente puede tener sobregiro autorizado. La pantalla pide «retirar 800» sin saber de qué tipo es la cuenta, y el programa elige la regla al funcionar.

Por lo tanto

quien pide no necesita saber qué tipo de pieza responde.

4La composición frente a la herenciaComposition over Inheritance

El último piso «igual a la tipo, con terraza» es herencia, porque toma todo del original, incluso lo que nadie quiso heredar, como el balcón. Armarlo con piezas elegidas es composición, y el balcón nuevo no le llega. Si la comisión QR se define como «la general, con un retoque», cualquier cambio en la general le llega sin revisión. Una que tiene tarifa y descuento por separado se cambia pieza por pieza.

Por lo tanto

se arma con partes que se tienen, antes que con parentescos que se heredan.

5La función puraPure Function

Es la memoria con todos sus datos en el cuadro. Una función pura recibe todo lo que usa y devuelve un resultado, y con los mismos datos da siempre el mismo. Deja de serlo si usa un dato que no recibe, como la hora del reloj, o si cambia algo afuera, como escribir en el registro o cambiar un saldo. A esto último se le llama efecto. Abajo, la comisión de las dos formas.

comisión, dados monto, fecha y tarifas
   tomar de «tarifas» la vigente en «fecha»
   devolver monto × porcentaje de esa tarifa

comisión, dado monto
   buscar la tarifa vigente hoy
   anotar en el registro «comisión calculada»
   devolver monto × porcentaje de esa tarifa
Por lo tanto

todo lo que necesita entra como dato, y lo único que sale es el resultado.

6La inmutabilidadImmutability

Es la revisión sellada. Un valor inmutable no se modifica una vez creado, y para cambiarlo se crea otro. La tabla de tarifas no se edita. Cada cambio agrega una fila con su fecha de vigencia, y se puede recalcular una comisión pasada tal como fue.

Por lo tanto

lo ya emitido no se pisa, y para cambiarlo se emite uno nuevo.

7Los efectos en el bordeFunctional Core, Imperative Shell

Es la oficina técnica y la obra. En la app, quien coordina la transferencia toma la fecha una sola vez, al mostrar la comisión, y la lleva hasta el cobro, donde vuelve a llamar al cálculo puro. El núcleo de cálculo decide y el borde actúa sobre lo de afuera. Qué fecha manda es una regla del banco, y la pureza solo obliga a decirla. Así Rosa ve la misma comisión al confirmar y al pagar.

Borde · lee Reloj (una sola vez) Tarifas (la lista) Monto (el de Rosa) datos Núcleo de cálculo · comisión pura no lee ni escribe nada resultado Cobrar la comisión Anotar en el registro Avisar a Rosa Borde · actúa
El borde lee y entrega, el núcleo de cálculo calcula, y con el resultado el borde actúa.
Por lo tanto

se decide con cálculos puros y se actúa en el borde, una sola vez.

4Qué se gana y qué cuesta

Lo que se gana

  • El interior de una pieza se cambia sin tocar a quienes la usan.
  • Un cálculo se repite, se revisa y se prueba con solo darle sus datos.

Lo que cuesta

  • Más piezas y más papeles, porque cada interfaz hay que pensarla.
  • Los datos pasan de mano en mano y las listas se alargan.
  • Crear un valor nuevo en vez de cambiar el viejo puede ocupar más espacio en la computadora y más tiempo, algo que se ve en el capítulo 22.

Cuándo no conviene. Pureza total no hay, porque un programa que no escribe nada no sirve. La regla es que los efectos sean pocos y estén a la vista. Tampoco todo merece su caja de registro, y dónde ponerlas se ve en el capítulo 11.

Con qué se combina. Con las entidades y los objetos de valor (capítulo 4), los casos de uso, que coordinan el borde (capítulo 6), los repositorios (capítulo 8), SOLID (capítulo 10) y las pruebas (capítulo 20).

5Para llevarse

En el edificioEn la app del bancoPatrón
Planta tipo y planta construidaClase y objetoClass · Object
Ducto y caja de registroInterfaz de la cuentaEncapsulation · Interface
Unión normalizadaCada cuenta responde a «retirar»Polymorphism
Piezas elegidasTarifa y descuento por separadoComposition over Inheritance
Memoria con sus datos en el cuadroComisión con todo como datoPure Function
Revisión B, con la A archivadaTarifas que se agreganImmutability
Oficina técnica y obraCalcular y después cobrarFunctional Core, Imperative Shell
Dónde cojea la analogía

El polimorfismo es la equivalencia más floja. La unión normalizada asegura que la pieza encaja, y se elige una vez, al armar. En el programa, la misma línea puede hablar con una pieza distinta cada vez que funciona, y encajar no basta, porque cada una tiene que responder lo esperado, algo que se ve en el capítulo 10.

El «igual a la tipo» sí se parece a la herencia. Lo que no calza es el vínculo. En obra se resuelve al dibujar y cada planta queda independiente. En el programa sigue vivo, y un cambio en la base les llega a las derivadas sin que nadie lo pida.

En la práctica, a noviembre de 2026. Java, C# y Python se organizan sobre todo en clases y objetos, aunque hoy admiten también funciones puras y datos inmutables. Haskell y Elixir parten de datos inmutables y funciones. El mapa de tecnologías está en el capítulo 28.

Capítulo 4 · Entidades y objetos de valorLa columna C-12 y la cota. Una sigue siendo la misma aunque la refuercen, la otra no dice nada sin su nivel de referencia.