← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
IV · La estrategia
Capítulo
12
Estado
Borrador
Patrones
Contexto delimitado (Bounded Context) · Mapa de contextos (Context Map) · Núcleo compartido (Shared Kernel) · Cliente y proveedor (Customer-Supplier)

Piso terminado y cara de losa

Cómo dejar que cada área hable con sus palabras y poner por escrito lo que pasa de una a otra.

1Primero, el nivel de la losa

En los planos del nivel 1, la arquitecta escribe +3,20 y el calculista también. Los dos miden desde el mismo ±0,00 y usan los mismos ejes (capítulo 4), pero no hablan de la misma superficie.

Para la arquitecta, el nivel es el piso terminado, donde se para la gente. Para el calculista, es la cara de la losa, donde termina el hormigón. Entre una y otra están la carpeta de nivelación, con las tuberías embutidas, y la cerámica con su mortero, unos 8 cm en este edificio.

Antes de licitar la obra, en la compatibilización de planos, la arquitecta y el calculista superponen sus hojas. El supervisor, que el propietario ya contrató para revisar el proyecto, pregunta lo que nadie había preguntado.

—¿Ese +3,20 de la losa es el mismo +3,20 del piso? —pregunta el supervisor.

—No —responde el calculista—. El mío es la cara de la losa, y con los acabados el piso queda en +3,28.

—Entonces la losa va a +3,12 —dice la arquitecta.

Con la losa vaciada no habría arreglo limpio. Adelgazar la carpeta absorbe solo una parte, picar la losa le quita resistencia y dejarla así descuadra puertas y escaleras. Antes, bastó una revisión del plano.

La obra se ordenó con cuatro cosas.

Sin regla Con la regla +3,20 en los dos planos piso real +3,28 acabados losa vaciada a +3,20 el piso queda 8 cm más alto que el plano una regla las une piso terminado +3,20 acabados, 8 cm cara de losa +3,12 el piso queda donde lo dibujó la arquitecta
Un mismo +3,20 en dos planos. Sin regla, la losa se vacía a +3,20 y el piso queda en +3,28. Con la regla, la losa va a +3,12 y el piso queda en +3,20, con 8 cm de acabados entre los dos.

Funciona porque cada plano es exacto en su hoja y el paso de una a otra tiene regla escrita.

2El mismo problema, en la app del banco

La app de banca móvil le muestra a Rosa su caja de ahorro, su tarjeta de débito y un préstamo chico. En la primera versión hay una sola «cuenta» y un solo «cliente» para todo el banco. Préstamos guarda la deuda, 5.000 Bs, como el saldo contable de una «cuenta» más.

Un día, la pantalla de transferir ofrece como origen todas las «cuentas» de Rosa, el préstamo incluido. Ella manda 800 Bs desde ahí. El programa los entrega y además baja la deuda a 4.200 Bs, sin que haya pagado nada.

—¿Desde cuándo un préstamo sirve para transferir? —pregunta la gerente.

—Para el programa es una cuenta más, con 5.000 Bs de saldo contable y nada retenido —responde el programador—. Y la regla solo pregunta si alcanza el disponible.

Es el +3,20 en los dos planos, una palabra con dos sentidos y sin regla.

3Las cuatro piezas

Los números del dibujo son las piezas.

2 Mapa de contextos 1 Cuentas proveedor de los demás 3 Monto y moneda núcleo compartido Tarjetas cliente pide retener 4 Préstamos cliente pide cobrar la cuota Cumplimiento cliente pide bloquear
Mapa de contextos de la app. Tarjetas pide a Cuentas retener un monto, Préstamos pide cobrar la cuota y Cumplimiento pide bloquear. Cuentas y Tarjetas comparten un núcleo pequeño, el monto con su moneda.

1El contexto delimitadoBounded Context

Es el juego de planos de una especialidad, con su cajetín y sus palabras. Un contexto delimitado es la parte del programa donde cada término significa una sola cosa, con un borde claro. Dentro rige el glosario del capítulo 1.

Área«Cuenta» es«Cliente» es
Cuentasla cuenta de depósito (caja de ahorro, de empresa, juvenil), con sus movimientosel titular
Tarjetasla cuenta vinculada, de donde se debitan las comprasel portador, que puede no ser el titular
Préstamosla deuda, con sus cuotasel deudor, con su codeudor
Cumplimientocualquier producto cuyos movimientos se vigilanla persona verificada, con su origen de fondos
Por lo tanto

cada área tiene su propio glosario, y dentro de su borde cada palabra significa una sola cosa.

2El mapa de contextosContext Map

Es la compatibilización, con la regla del espesor de acabados. Un mapa de contextos dibuja los contextos, quién depende de quién y cómo pasa una palabra al cruzar, traducida o compartida. Aquí, el «cliente» de Cumplimiento y el titular de Cuentas son la misma persona cuando tienen el mismo documento. La capa anticorrupción, que traduce y controla lo que llega de otro sistema, como el proveedor del tipo de cambio, se ve en el capítulo 13. Entre dos contextos sirve igual.

Por lo tanto

los contextos y sus relaciones se dibujan tal como son, y cada cruce dice cómo pasa una palabra.

3El núcleo compartidoShared Kernel

Son los ejes, el ±0,00 y las unidades que todos los planos usan igual. Un núcleo compartido es una parte pequeña del modelo que dos contextos usan igual y cambian juntos. Cuentas y Tarjetas comparten el monto con su moneda (capítulo 4), y si cambia cómo se redondea, los dos lo comprueban. No es el «núcleo» de la app, la capa de reglas del capítulo 2.

Por lo tanto

lo que dos contextos deben entender igual se comparte, se mantiene pequeño y se cambia de común acuerdo.

4Cliente y proveedorCustomer-Supplier

Es el pedido de pasante, que la especialidad sanitaria le hace al calculista. En la app, Tarjetas es cliente de Cuentas, que es su proveedor. Aquí cliente es el área que depende de otra, y nada tiene que ver con Rosa. Al autorizar una compra con la tarjeta de débito, Tarjetas pide retener el monto, y al liquidarla, cambiar la retención por el débito. Cuentas anota esos pedidos en su plan, y ambas acuerdan una comprobación que corre en cada cambio.

Por lo tanto

quien depende de otro pide por un canal conocido, y quien provee lo anota y comprueba que lo cumple.

4Qué se gana y qué cuesta

Lo que se gana

  • Cada glosario queda corto y exacto dentro de su borde.
  • Un cambio en un área no sorprende a las demás, y los choques se ven en el mapa, no cuando ya fallan.

Lo que cuesta

  • Las reglas de traducción se escriben y se mantienen, y una traducción puede perder información.
  • La misma persona figura en varios contextos, y hay que cuidar que coincidan en lo que comparten.
  • El núcleo compartido ata a dos equipos. Si crece, cada cambio pide una reunión.

Cuándo no conviene. Una caseta de obra con un solo juego de planos no necesita compatibilización, y un programa chico, de un equipo y un solo glosario, tampoco necesita fronteras. No se parte para parecer ordenado, porque cada frontera cuesta (capítulo 11).

Con qué se combina. Con el lenguaje ubicuo (capítulo 1), los agregados (capítulo 5), la capa anticorrupción (capítulo 13) y los eventos (capítulo 16). Cortar el programa en piezas que corren por separado es otra decisión, la del capítulo 23.

5Para llevarse

En el edificioEn la app del bancoPatrón
Juego de planos de una especialidadÁrea con su propio glosarioBounded Context
Compatibilización y regla del espesorMapa que dice cómo pasa cada palabra al cruzarContext Map
Ejes, ±0,00 y unidades comunesMonto con su moneda, común a Cuentas y TarjetasShared Kernel
Pedido de pasante al calculistaTarjetas pide a Cuentas retener un montoCustomer-Supplier
Dónde cojea la analogía

Las especialidades vienen dadas por el oficio. Los contextos se eligen, y el borde puede quedar mal trazado. Si «cuenta» significa lo mismo en dos áreas, quizá eran un solo contexto, y si en una sola cambia de sentido, eran dos. El borde se corrige al aprender el negocio, y la división en especialidades de una obra no se rehace así.

Los ejes y el ±0,00 sirven a todas las especialidades, se marcan una vez en un punto fijo y no se mueven. El núcleo compartido suele unir a dos contextos (si lo usan todos, ya no es pequeño) y es código que sigue cambiando.

En la práctica, a noviembre de 2026. Varios lenguajes permiten esconder lo interno de un contexto. En Java, un módulo exporta solo los paquetes que declara. En C#, lo marcado internal no se ve fuera de su ensamblado, lo que compila cada proyecto. En Go, un directorio internal solo lo importa el código que está dentro de la carpeta que lo contiene. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 13 · Puertos, adaptadores y capa anticorrupciónUn vano que no nombra fábrica y un sistema que no depende de quién le trae los datos.