← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
VI · Hacia afuera
Capítulo
17
Estado
Borrador
Patrones
Pedido y respuesta (Request-Response) · Sin estado (Stateless) · Idempotencia (Idempotency) · Protocolos en capas (Layered Protocols)

El trámite y la carretera

Cómo se piden y se contestan las cosas entre dos sistemas, y por qué repetir un pedido no debe repetir su efecto.

1Primero, el trámite con la supervisión

Terminada la estructura, Marta, la residente, presenta a la supervisión la planilla 5, la del hito de estructura. En la supervisión trabajan varios ingenieros, y quien revisó la 4 no siempre revisa la 5.

Por eso la planilla llega completa, con su número, el número de contrato y sus ítems con su cómputo métrico. Quien la reciba la resuelve sin suponer lo que se habló la semana pasada.

En esta supervisión, la respuesta se da por escrito y con uno de tres resultados. Aprobada, y el pago sigue. Observada, cuando la falla está en lo presentado, como un ítem que no coincide con el cómputo métrico. Marta corrige. No atendida, cuando la falla es de la oficina, que ese día no pudo procesar. Marta la presenta igual más tarde.

Un día Marta deja la planilla 5 y no le devuelven la copia sellada. No sabe si se perdió o si se aprobó. Si la presenta otra vez y la toman por nueva, el propietario paga dos veces la estructura. Por eso la oficina anota cada número que resuelve y, si llega de nuevo la 5, contesta con lo ya resuelto. La planilla 6, que es otro cobro, lleva otro número.

Debajo del trámite hay una carretera. Vehículos de cualquier marca la usan porque todos aceptan las mismas señales y reglas. Y el fierro que llega en cuatro camiones trae una nota de remisión que dice «camión 2 de 4», para reclamar el que falte.

Funciona porque cada trámite se entiende solo y repetirlo no cuesta dos pagos.

2El mismo problema, en la app del banco

Rosa escanea el QR de un negocio y toca «Transferir» para mandar 800 Bs. La app llama al servidor, y la lista de pedidos que este acepta, con sus respuestas, es su API.

Al principio, el servidor recuerda cada paso. Al escanear el QR anota «Rosa va a pagar al negocio 9032», y el pedido siguiente solo dice «confirmar». Pero el banco tiene varios servidores, y a veces atiende otro, que no sabe de qué se trata.

Además, Rosa está en un túnel con mala señal. Toca «Transferir» y la pantalla se queda esperando. El pedido se hizo, pero la respuesta se perdió, y Rosa toca otra vez.

—¿Por qué el negocio recibió 1.600 Bs? —pregunta la gerente.

—Para el servidor eran dos pedidos distintos —responde el programador—. Y la app no supo si el primero había llegado.

3Las cuatro piezas

1El pedido y la respuestaRequest-Response

Es la planilla y su resultado. El pedido dice qué se quiere hacer, sobre qué y con qué datos. Quien pide espera la respuesta antes de seguir, a diferencia de la circular del capítulo 16. La respuesta trae uno de tres resultados, aprobado, observado o no atendido. A veces no llega ninguna, como en el túnel de Rosa. Ni esa falta ni el no atendido dicen si algo se hizo, que es la duda de Marta y la resuelve la tercera pieza.

pedido       transferir 800 Bs de la cuenta 4471 a la 9032
             número de pedido 7c1e, con el pase de Rosa
respuestas   aprobado: se hizo, comprobante 18873
             observado: el saldo disponible no alcanza (repetir igual, en general, no sirve)
             no atendido: falló el servidor, no se sabe si se hizo (repetir con el mismo número)
             sin respuesta: no se sabe si se hizo (repetir con el mismo número)
Por lo tanto

cada respuesta dice si salió bien, si hay que corregir el pedido o si se puede reintentar.

2Sin estadoStateless

Es la planilla que se presenta completa. Cada pedido lleva el pase de Rosa, que dice quién es (capítulo 18), lo que quiere hacer y los datos necesarios. El servidor no guarda lo que pasó en pedidos anteriores, que es lo que se llama estado. Por eso cualquier servidor atiende cualquier pedido.

Sin estado no significa sin memoria. Las cuentas siguen en la base de datos. Lo que no se guarda es la conversación.

Por lo tanto

todo lo necesario viaja en el pedido, y lo que debe durar se guarda en un lugar compartido.

3La idempotenciaIdempotency

Es el número de la planilla. Una operación es idempotente cuando hacerla una vez o diez deja el mismo efecto (capítulo 3). Bloquear una tarjeta lo es. «Transferir 800 Bs» no, y se vuelve idempotente con un número de pedido.

La app genera un código largo y único (aquí, 7c1e) por cada intención de Rosa y lo repite si reenvía el pedido. El servidor anota cada número con su respuesta en la base de datos compartida. Si llega uno ya anotado, devuelve esa respuesta sin transferir, y si trae otro monto, lo rechaza. Otros 800 Bs al mismo negocio son otra intención, con otro número.

App de Rosa Servidor pedido 7c1e, transferir 800 Bs transfiere y anota el 7c1e aprobado se pierde en el túnel Rosa no sabe si se hizo el mismo pedido, 7c1e el 7c1e ya está, no lo repite aprobado, lo anotado Un solo débito de 800 Bs
El pedido 7c1e se hace, pero la respuesta se pierde. La app lo repite y el servidor devuelve lo anotado. Queda un solo débito.

Es lo que pedía el capítulo 15 para lo que se rehace tras un choque de versión, y lo que necesitan los mensajes que llegan dos veces (capítulo 16).

Por lo tanto

cada intención lleva su número, y repetir un pedido devuelve lo ya resuelto.

4Los protocolos en capasLayered Protocols

Son la carretera con sus señales y reglas. Un protocolo es el conjunto de reglas con que dos computadoras se entienden. En la red se apilan en capas, cada una con un solo trabajo.

En la app En la carretera Pedido y respuesta qué se pide y se contesta el trámite con la supervisión se apoya en Entrega en orden trozos numerados nota de remisión «camión 2 de 4» se apoya en Direcciones y rutas a dónde va cada trozo señales de ruta y dirección del destino se apoya en El medio wifi, datos móviles, fibra la calzada, asfalto o ripio
Cuatro capas, cada una apoyada en la de abajo, con su equivalente en la carretera.

La app conoce solo la capa de arriba. Rosa pasa del wifi a los datos móviles y el pedido es el mismo, y puede viajar además cifrado (capítulo 19).

Por lo tanto

cada capa resuelve un solo problema apoyándose en la de abajo, y se cambia una sin tocar las demás.

4Qué se gana y qué cuesta

Lo que se gana

  • Un doble toque, un reintento o una respuesta perdida no duplican nada.
  • Cualquier servidor atiende cualquier pedido, sin que Rosa lo note.
  • Celulares y redes de cualquier tipo hablan con el mismo servidor.

Lo que cuesta

  • Cada pedido pesa más, porque lleva pase, número y datos.
  • Hay que anotar los números con sus respuestas, por un tiempo.
  • Cambiar el formato de los pedidos rompe las apps viejas, y por eso se atienden varias versiones. No es el control de versión del capítulo 15, y el glosario del capítulo 28 separa los sentidos.

El número y la transferencia van juntos. Si el servidor comprueba el número, transfiere y después lo anota, dos pedidos iguales que llegan a la vez pasan los dos la comprobación, una condición de carrera (capítulo 15). Por eso se anota en el mismo todo o nada que la transferencia (capítulo 8), y la base rechaza un segundo registro igual.

Cuándo no conviene. Un programa chico, con un solo servidor y sin plata de por medio, puede guardar el paso de cada usuario en memoria. Una consulta tampoco necesita número.

Con qué se combina. Con los casos de uso (capítulo 6), la unidad de trabajo (capítulo 8), la concurrencia (capítulo 15), los eventos (capítulo 16), la seguridad (capítulo 18) y la criptografía (capítulo 19).

5Para llevarse

En el edificioEn la app del bancoPatrón
Planilla con tres resultados posiblesPedido con tres respuestas posiblesRequest-Response
Planilla completa, que se entiende solaPedido completo, sin memoria del servidorStateless
Planilla con número, presentada dos veces, se paga unaPedido con número, tocado dos veces, se transfiere unaIdempotency
Señales y reglas de la carreteraProtocolos en capasLayered Protocols

¿No sería más simple una ventanilla única, con un funcionario que conozca el caso de Marta?

Sí, mientras ese funcionario esté. Si falta, el trámite se frena, y un servidor que recuerda a Rosa tampoco se reemplaza sin que ella pierda el paso.

Dónde cojea la analogía

La carretera mezcla el medio con las reglas, porque asfalto y señal van en el mismo camino. En la red cada capa se cambia sola, y las capas reales a veces se juntan.

En la oficina, repetir cuesta papel y espera. En la red los reintentos son automáticos y pueden llegar miles a la vez (capítulo 24), así que la idempotencia la garantiza el servidor, con el número que la app repite, y no la buena voluntad de quien llama.

Los tres resultados son una convención, no una garantía. En una obra real la planilla se aprueba o se observa, y el tercer resultado es una licencia de este ejemplo. Un servidor mal hecho puede contestar «aprobado» con un error adentro.

En la práctica, a noviembre de 2026. La web usa HTTP, y tres de sus familias de códigos, 2xx, 4xx y 5xx, corresponden al aprobado, el observado y el no atendido. El estándar define GET, PUT y DELETE como idempotentes y no da esa garantía para POST, y las API de pagos suelen aceptar una clave de idempotencia, a menudo en el encabezado Idempotency-Key. Spring Boot (Java), ASP.NET Core (.NET) y FastAPI (Python) declaran cada ruta con su verbo y devuelven el código de cada respuesta. Debajo suelen ir TLS, TCP e IP, o QUIC sobre UDP en HTTP/3. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 18 · SeguridadEl cerco, la portería y la llave por área.