← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
V · Datos y tiempo
Capítulo
16
Estado
Borrador
Patrones
Observador (Observer) · Publicar y suscribir (Publish-Subscribe) · Cola de mensajes (Message Queue) · Evento de dominio (Domain Event)

La mesa de partes

Cómo avisar a muchos sin conocerlos, y sin perder el aviso de quien no está.

1Primero, la circular

Terminada la estructura, el supervisor firma el acta de recepción. Con esa firma, instalaciones puede entrar con el cableado y los artefactos, el contratista puede cobrar el hito de estructura en la planilla 5 y el propietario tiene que prepararse para pagarla.

Al principio el supervisor llamaba a cada uno con su libreta de teléfonos, y un día se olvidó de instalaciones, que esperó tres días.

El timbre de la obra solo lo oye quien está, y el tablero de avisos obliga a pasar a mirar. El supervisor y el contratista armaron otra cosa, en tres piezas.

Supervisor firma el acta 14 Libro de órdenes la anota con su número anota circular 14 Mesa de partes inscritos por tipo de circular copia copia copia Instalaciones retira hoy Contratista retira mañana Propietario retira hoy Perito se inscribe después El supervisor solo conoce la mesa de partes
El supervisor anota el acta en el libro de órdenes y entrega la circular 14 a la mesa de partes, que la copia al casillero de cada inscrito.

Una circular falla de tres maneras.

Recibida la estructura, el supervisor, por el propietario, emitió la orden de proceder a la fábrica de carpintería elegida. La circular «Orden de proceder emitida» llegó a la administración de la obra, inscrita para pagar el anticipo, como fijaba el contrato con la fábrica. Funciona porque la circular dice qué pasó y cada uno decide qué hace.

2El mismo problema, en la app del banco

Marta pagó ese anticipo con una transferencia desde la app, una más, como la de Rosa, que envía 800 Bs a un negocio por QR. Al confirmarse, tres áreas del programa, que pueden correr por separado (se ve en el capítulo 23), tienen que enterarse. Notificaciones avisa a Rosa, Extracto agrega el movimiento y Antifraude alerta si algo parece raro.

En la primera versión, Transferir llama a las tres, una por una, antes de confirmar. Un viernes se corta la conexión con la base. La unidad de trabajo del capítulo 8 deshace el débito y el crédito, pero «Transferencia realizada» ya salió al celular de Rosa.

—¿Por qué le llegó el aviso si su plata sigue en la cuenta? —pregunta la gerente.

—Transferir avisó antes de confirmar —responde el programador—, y esperó a cada área.

Es la libreta del supervisor, con una llamada por área.

3Las cuatro piezas

Los números del dibujo son las piezas.

Transferir confirma y emite 2 1 «Transferencia realizada» 3 Mesa de partes publicar y suscribir copia copia copia 4 Cola guarda y espera Cola guarda y espera Cola guarda y espera retira no retira retira Notificaciones Extracto, caído Antifraude
Transferir emite «Transferencia realizada» y no nombra a nadie. La mesa de partes copia el mensaje a la cola de cada suscriptor. Extracto está caído, y su cola lo guarda hasta que vuelva.

1El evento de dominioDomain Event

Es el acta firmada con su circular. Un evento de dominio es el registro de algo que ya pasó en el negocio, en pasado y con las palabras del negocio, como «Transferencia realizada». Lleva número, monto, cuentas y fecha, y no manda nada. Como el acta, no se corrige. Si algo cambia, sale otro.

Lo anota el caso de uso (capítulo 6) junto con el cambio, en la misma unidad de trabajo, como el acta con el libro de órdenes. Se entrega solo después de confirmar. Un despachador reparte lo anotado que aún no salió (Transactional Outbox).

Por lo tanto

lo que pasó se anota en pasado, con sus datos, en el mismo acto que lo hizo pasar.

2El observadorObserver

Es la libreta de teléfonos, pero cada interesado anota solo su número para un tipo de evento, y el supervisor llama a todos los anotados con el mismo aviso, sin saber qué hará cada uno. En el programa, Transferir guarda esa lista y llama a los inscritos uno por uno, en el mismo momento. Si uno tarda, espera.

Por lo tanto

quien se interesa se inscribe, y quien avisa no sabe qué hará cada uno.

3Publicar y suscribirPublish-Subscribe

Es la mesa de partes. La lista pasa del emisor a un intermediario. El emisor publica una vez y los interesados se suscriben, sin conocerse.

al arrancar el servidor
   Notificaciones se suscribe a «Transferencia realizada»
   Extracto se suscribe a «Transferencia realizada»
   Antifraude se suscribe a «Transferencia realizada»
al confirmar una transferencia
   emitir «Transferencia realizada» con número, monto y cuentas
Por lo tanto

quien emite publica una sola vez, y quien se interesa se suscribe, sin conocerse.

4La cola de mensajesMessage Queue

Es el casillero. El mensaje espera en la cola hasta que el suscriptor lo retira y confirma que terminó.

Las colas, en su modo habitual, prefieren entregar de más que perder un mensaje, y si la confirmación no llega, lo entregan otra vez. De ahí que pueda llegar dos veces. Con reentregas o varios consumidores, ni dentro de una cola el orden está asegurado. Por eso cada mensaje lleva su número, como la circular, y el suscriptor descarta el atrasado. Una cola que crece sin que nadie retire es la circular que nadie leyó, y se vigila (capítulo 25).

Por lo tanto

cada destinatario retira a su ritmo, y lo que no se retira espera y se vigila.

4Qué se gana y qué cuesta

Lo que se gana

  • Transferir no conoce a nadie, y sumar un área es suscribirla.
  • Un área caída no frena la transferencia, porque su cola espera.
  • Ningún aviso sale de una transferencia que se deshizo.

Lo que cuesta

  • Se pierde el hilo. Ya no hay un lugar donde leer todo lo que pasa después de transferir.
  • Cada suscriptor tiene que tolerar que un mensaje llegue dos veces o tarde.
  • Un atraso. Lo que se arma con eventos, como la copia de lectura del capítulo 8, va detrás, más si un suscriptor está caído. Rosa puede ver el aviso antes que su extracto (Eventual Consistency).

Cuándo no conviene. Con un solo interesado, la llamada directa dice lo mismo con menos piezas, como el aviso del capítulo 11. Separar se justifica con varios interesados, o si uno puede caerse sin frenar a los demás. El timbre y el tablero sirven si perder un aviso o enterarse tarde no cuesta.

Entre dos bancos. Si la cuenta del negocio está en otro banco, hay una red de por medio y no una unidad de trabajo común. Un paso debita y emite su mensaje, el siguiente acredita, y si algo falla, otro mensaje contrarresta lo hecho, como una orden de cambio que anula otra sin borrarla (Saga). Mientras tanto se ve el débito sin el crédito. La red entre bancos que se cae se ve en el capítulo 24.

Con qué se combina. Con los agregados, que cuentan con eventos a otros bloques lo que pasó en uno (capítulo 5); los contextos, donde cada suscriptor traduce el evento a sus palabras (capítulos 12 y 13); y la concurrencia, porque dos suscriptores que cambian lo mismo se pisan (capítulo 15).

5Para llevarse

En el edificioEn la app del bancoPatrón
Acta firmada y su circular, en el libro de órdenes«Transferencia realizada», guardada con el cambioDomain Event
Libreta donde cada uno se anotaEmisor con su lista de inscritosObserver
Mesa de partes con sus inscritosCanal al que se publica y se suscribePublish-Subscribe
Casillero con firma de recibidoCola de cada suscriptor, con confirmaciónMessage Queue

¿Y si Transferir necesita una respuesta antes de seguir?

Entonces no es una circular, que no espera respuesta, sino una consulta. Para pedir permiso se pregunta y se espera (capítulo 17).

Dónde cojea la analogía

La precisión es alta casi en todo y media en «llega dos veces». En la obra, una circular repetida es un error de la mesa de partes y cualquiera lo ve. En el programa es parte del funcionamiento, porque la cola prefiere repetir antes que perder, y el suscriptor solo la reconoce si se lo construyó para eso.

En la práctica, a noviembre de 2026. Dentro de un programa, lo dan el ApplicationEventPublisher de Spring (Java), el IObservable de .NET y el EventEmitter de Node.js. Entre programas, lo hacen RabbitMQ o Apache Kafka. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 17 · Protocolos webEl trámite entre la obra y la supervisión, donde presentar dos veces la planilla 5 no paga dos veces.