← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
II · Las piezas
Capítulo
4
Estado
Borrador
Patrones
Entidad (Entity) · Objeto de valor (Value Object) · Dinero (Money) · Cantidad (Quantity)

Columna C-12 y cota

Cómo distinguir lo que sigue siendo lo mismo aunque cambie de lo que solo cuenta por lo que dice.

1Primero, la columna y la cota

En el segundo mes, antes del primer vaciado de la columna, el propietario decide poner un tanque de agua en la terraza. La columna C-12, en el cruce B-3 de los ejes, va a cargar más, y el calculista la refuerza, zapata incluida, con una orden de cambio.

En la revisión B cambian la sección, el fierro, el cómputo métrico y el precio. ¿Es la misma columna? Sí, y todos los papeles tienen que poder decirlo.

Por eso la arquitecta fija los ejes y el calculista le pone a cada columna su propia marca en el cuadro de columnas, una por cruce de ejes. La marca se asigna una vez, es única en el edificio y no se reutiliza. Todos los papeles la nombran por su marca. Uno que dijera «la de 30 × 30» no diría de cuál habla.

Revisión A 30 × 30 cm 8 fierros de 16 mm Revisión B 35 × 35 cm 8 fierros de 20 mm orden de cambio misma marca misma marca Marca C-12 en el cruce B-3 no cambia con la revisión la nombran por su marca Planilla de fierros Cómputo métrico Registro de probetas Libro de órdenes
La columna C-12 en dos revisiones. Cambian la sección y el fierro, no la marca, que usan todos los documentos.

Con los fierros pasa lo contrario. Del fierro de 16 mm hay un acopio, y a Marta, la residente, no le importa qué barra va a qué columna, solo que sea del diámetro y el largo pedidos.

Las medidas se parecen a los fierros, con una exigencia más. Una cota de +3,20 no significa nada hasta saber desde dónde se mide, como una resistencia de 250 sin su unidad. Por eso todos los planos usan los mismos ejes y miden desde el mismo ±0,00, marcado en un punto fijo de la obra.

Un cero por plano Un solo cero +3,20 de estructura +3,20 de sanitaria no coinciden ±0,00 de estructura ±0,00 de sanitaria +3,20 en todos los planos ±0,00 común a todos se mide 3,20 m misma cifra, dos alturas misma cifra, una altura
Con un cero por plano, dos cotas de +3,20 quedan a alturas distintas. Con un solo ±0,00, la misma cifra apunta al mismo punto.

Una cota emitida tampoco se borra del plano sellado. Si cambia el nivel de una losa, sale otra cota en una revisión nueva, como en el capítulo 3.

Funciona porque lo que hay que seguir tiene una marca que no cambia, y lo que solo se mide lleva siempre su referencia.

2El mismo problema, en la app del banco

En la app de banca móvil, la cuenta 4471 de Rosa cambia su saldo disponible con cada depósito y cada transferencia, y sigue siendo la 4471.

En la primera versión, para saber si dos cuentas son la misma, el programa compara el nombre del titular, el tipo y el saldo disponible, y no el número. Rosa recibe 200 Bs. La pantalla de movimientos ve su cuenta con 1.200 y no con 1.000, concluye que es otra, y los movimientos de ayer quedan colgados de una que ya no está. Con dos cajas de ahorro nuevas, de dos clientas que se llaman igual, pasa al revés, y el programa las toma por una sola.

Con el monto, el problema es otro. Viaja como un número, 800, y la moneda queda aparte, en la cuenta. El resumen del día suma 800 y 100, de una cuenta en bolivianos y otra en dólares, y muestra 900, que no son ni bolivianos ni dólares. Además el monto vive en un campo de la orden que cualquier parte del programa puede sobrescribir, y el cambio llega a todos los que lo leen después.

—Rosa mandó 800 Bs y el destinatario recibió 804. ¿Por qué? —pregunta la gerente.

—Al armar el total a debitar, el programa le sumó la comisión de 4,00 Bs al mismo monto que se acreditaba —responde el programador—. Era un solo campo, y lo sobrescribió el último que lo usó.

Es la columna llamada por su sección y la resistencia sin su unidad.

3Las cuatro piezas

Entidad ayer hoy Cuenta 4471 saldo disponible 1.000 Bs Cuenta 4471 saldo disponible 1.200 Bs se compara por el número es la misma cuenta Objeto de valor 800 Bs 800 USD se compara por cantidad y moneda son distintos
La cuenta de ayer y la de hoy son la misma aunque cambió el saldo disponible. 800 Bs y 800 USD son distintos.

1La entidad y su identidadEntity · Identity

Es la columna con su marca. Una entidad es algo que se sigue en el tiempo, y se reconoce por su identidad, un número o una marca que se asigna una vez y no cambia. Todo lo demás puede cambiar, el saldo disponible, el límite diario, el celular registrado, y la cuenta sigue siendo la misma. Dos cuentas con los mismos datos y distinto número son dos.

Por lo tanto

lo que se sigue en el tiempo se reconoce por una identidad que no cambia, y no por cómo está hoy.

2El objeto de valorValue Object

Es el fierro del acopio y la cota. Un objeto de valor no tiene identidad, solo lo que dice. Dos montos de 800 Bs son el mismo monto, sin importar cuál es cuál. Es inmutable, como en el capítulo 3. Para cobrar la comisión no se modifica el monto de 800 Bs, se calcula otro, el total a debitar.

Por lo tanto

lo que solo se mide se compara por lo que contiene y no se modifica, y para cambiarlo se crea otro.

3El valor completoMoney · Quantity

Es la resistencia con su unidad. 250 kg/cm² y unos 24,5 MPa son el mismo hormigón con otra cifra, y sin la unidad la cifra engaña. El monto junta la cantidad y la moneda, y rechaza ahí mismo lo que no tiene sentido, como sumar bolivianos con dólares.

Por lo tanto

el número nunca viaja solo, lleva su moneda, su unidad o su referencia, y se rechaza lo que no tiene sentido.

4Entidad o valorEntity · Value Object

Es la probeta frente al fierro. Una probeta es un cilindro de hormigón que se toma del mixer para romperlo después en el laboratorio. Es igual a cualquier otra y lleva número, porque hay que saber de qué mixer y vaciado salió. El fierro de 16 mm no lleva ninguno. En la app, la orden de transferencia lleva número de operación y un estado, pedida, ejecutada o rechazada, y es una entidad. Su monto es un valor.

Una entidad suele armarse con valores. La cuenta guarda su saldo contable en un monto, que se reemplaza cuando cambia.

Por lo tanto

se decide por lo que el negocio necesita seguir, no por cómo se ve la cosa.

4Qué se gana y qué cuesta

Lo que se gana

  • Una cuenta se sigue aunque todo lo demás cambie.
  • El error de moneda se ataja en el monto, y no en cada pantalla.
  • Un monto compartido no se puede cambiar por detrás.

Lo que cuesta

  • Hay que decidir qué es cada cosa, y la decisión puede cambiar.
  • Un monto da más trabajo que un número suelto.
  • Alguien tiene que garantizar que un número no se repita ni se reutilice, o dos cuentas se funden.

Cuándo no conviene. Una caseta de obra no necesita un cuadro de columnas con marcas, y un programa chico, con una sola moneda, gana poco con un tipo propio para el monto.

Con qué se combina. Con los objetos del capítulo 3, los agregados (capítulo 5), los repositorios (capítulo 8) y los contextos (capítulo 12).

5Para llevarse

En el edificioEn la app del bancoPatrón
Columna C-12, con marca fija en el cuadro y los ejesCuenta 4471, con número fijoEntity · Identity
Cota +3,20 sobre un ±0,00 común; revisión nueva en vez de borrarMonto de 800 Bs; monto nuevo en vez de modificar el viejoValue Object
Cifra con su unidad, 250 kg/cm²Monto con su monedaMoney · Quantity
Probeta numerada frente a fierro del acopioOrden de transferencia frente a montoEntity · Value Object

¿Por qué no usar el nombre del titular como identidad de la cuenta?

Porque se repite y cambia. Dos clientas pueden llamarse igual, y un nombre se corrige o cambia de apellido. Es llamar a la columna «la del fondo».

Dónde cojea la analogía

La columna es una sola cosa física, y no puede haber dos C-12. En el programa, la misma cuenta puede estar cargada dos veces en el servidor al mismo tiempo, por dos pedidos que llegan juntos, y cada copia cambia por su lado. Cuál manda se ve en el capítulo 15.

El ±0,00 dice desde dónde se mide, y la moneda en qué se mide, así que el monto se parece más a la unidad que al nivel de referencia. Pasar de kg/cm² a MPa es multiplicar por un factor fijo. Pasar de bolivianos a dólares depende de un tipo de cambio que fija alguien de afuera, puede cambiar y no es uno solo (de compra, de venta). De dónde sale se ve en el capítulo 13.

En la práctica, a noviembre de 2026. Los record de Java y los record class de C# comparan por contenido y sus campos no se reasignan una vez creados. Python lo logra con una dataclass con frozen=True. Para las entidades, JPA (Java) marca el identificador con @Id y EF Core (.NET) lo llama clave. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 5 · AgregadosEl bloque entre juntas, que se arma, se autoriza y se vacía como una unidad.