← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
II · Las piezas
Capítulo
8
Estado
Borrador
Patrones
Repositorio (Repository) · Unidad de trabajo (Unit of Work) · Separación de lectura y escritura (Command Query Responsibility Segregation, CQRS)

La planoteca y el paquete

Cómo pedir una pieza sin saber dónde se guarda, y cómo cambiar varias a la vez, todas o ninguna.

1Primero, la planoteca

Marta, la residente, necesita el plano de la C-12 para controlar el armado del fierro del nivel 3. No sabe en qué gaveta está. Pide a la planoteca de la oficina técnica «el plano vigente de la C-12», y el dibujante que la lleva le manda la revisión vigente, la que ya incluye el refuerzo. Las anteriores siguen guardadas, marcadas como superadas, porque lo emitido no se corrige (capítulo 3).

Marta pide por el código y por lo que necesita, nunca por la ubicación. Si la planoteca se escanea o se reordena por especialidad, ella pide igual. Funciona porque quien pide habla el idioma de la obra, y cómo se guardan los planos es asunto de la planoteca.

El segundo problema son los cambios que no caben en un solo plano. La revisión B, la del refuerzo, nació de una orden de cambio. Por el tanque de la terraza, el calculista reforzó la C-12, de 30 × 30 a 35 × 35 cm. El bajante sanitario pegado a la columna se corrió, y el poliducto eléctrico que baja a su lado cambió de lugar. Son tres planos, cada uno de su especialista.

Si el estructural hubiera salido solo, los armadores habrían armado la sección nueva y los plomeros habrían fijado el bajante donde ahora está la columna, y se habría descubierto con todo hecho. La arquitecta, que compatibiliza las especialidades, fijó una regla. Los tres planos se revisan juntos y salen en una misma emisión, todos en B o ninguno.

La oficina técnica manda además la lista de planos vigentes, con cada código y su revisión. La residente y el maestro la consultan antes de cada frente, sin abrir ningún plano. Se arma con lo que se emite y no se corrige a mano.

Paquete de la revisión B Estructural C-12 reforzada Sanitario bajante corrido Eléctrico poliducto corrido los tres a la vez Revisión conjunta la arquitecta con cada especialista pasan alguno no pasa Los tres en B salen juntos Los tres siguen en A no sale ninguno Nunca dos en B y uno en A
Tres planos se revisan juntos. Si pasan, salen los tres en la revisión B. Si alguno no pasa, no sale ninguno y los tres siguen en la A. Nunca quedan dos en B y uno en A.

Funciona porque nadie construye con un juego de planos a medias.

2El mismo problema, en la app del banco

Rosa escanea el QR de un negocio con cuenta en el mismo banco y transfiere 800 Bs. Hay que buscar su cuenta y la del negocio, debitar una y acreditar la otra. En la primera versión, cada parte del programa que necesita una cuenta escribe su propia consulta a la base de datos y guarda cada cambio apenas lo hace.

Un viernes, entre el débito y el crédito, se corta la conexión con la base de datos. El débito quedó guardado y el crédito no.

—¿Dónde están los 800 Bs de Rosa? —pregunta la gerente.

—Salieron de su saldo disponible y no entraron a ninguna cuenta —responde el programador—. Cada paso se guardó al terminar, y el segundo falló.

Es la obra sin planoteca ni paquete, y trae otros tres males.

3Las tres piezas

Cada cosa de la planoteca tiene su equivalente en la app, con un nombre estándar para buscarla. Los números del dibujo son las piezas.

Escribir Leer 2 unidad de trabajo Transferir coordinación pide cuentas 1 Repositorio de cuentas la unidad guarda todo al confirmar, o nada si se deshace 3 Consulta movimientos del mes lectura directa, sin reglas Almacenamiento cuentas y movimientos
Escribir pasa por la coordinación, el repositorio y la unidad de trabajo, que guarda todo al confirmar o nada si se deshace. Leer va directo al almacenamiento, con una consulta simple y sin reglas.

1El repositorioRepository

Es la planoteca con su dibujante. Se comporta como una colección de cuentas en memoria. Se le pide «la cuenta 4471» o «las cuentas de Rosa» y entrega cuentas completas, sin decir de dónde salen. Las rearma tal como se guardaron, con su número de siempre, sin pasar por la fábrica (capítulo 7). Tiene tres partes.

Por lo tanto

las reglas piden la cuenta por su número o por lo que necesitan, y quien guarda decide dónde y cómo.

2La unidad de trabajoUnit of Work · Commit · Rollback

Es el paquete de la revisión B. Reúne todo lo que cambia una operación y lo guarda de una vez, completo o nada. La abre quien coordina la operación (los casos de uso, capítulo 6). Los repositorios trabajan dentro de ella y anotan los cambios sin guardarlos. Al final se confirma y se guarda todo, o se deshace y no se guarda nada.

abrir la unidad de trabajo
traer la cuenta de Rosa y la del negocio
debitar 800 Bs de la cuenta de Rosa
acreditar 800 Bs a la cuenta del negocio
si todo salió bien, confirmar (se guardan los dos cambios, juntos)
si algo falló, deshacer (no se guarda ninguno)

El todo o nada lo hace cumplir la base de datos con lo que llama transacción (capítulo 14), una palabra que en el banco significa otra cosa y que el glosario del capítulo 28 separa.

Por lo tanto

los cambios de una operación se confirman todos juntos, o no se confirma ninguno.

3La separación de lectura y escrituraCommand Query Responsibility Segregation (CQRS)

Es la lista de planos vigentes. Lo que cambia algo pasa por las reglas. Lo que solo mira, como los movimientos del mes de Rosa, va directo a los datos desde el servidor, con una consulta hecha a la medida de la pantalla, que devuelve solo fechas, montos y destinos. No arma cuentas ni aplica reglas, porque no cambia nada.

En su forma ligera solo se separan los caminos y la base es la misma. En la completa, la lectura tiene su propia copia, armada con lo que se escribe y a veces con un pequeño atraso (capítulo 16).

Por lo tanto

quien cambia pasa por las reglas, y quien solo mira lee una vista hecha para eso.

4Qué se gana y qué cuesta

Lo que se gana

  • Las reglas se prueban con cuentas en memoria, sin base de datos.
  • Una transferencia nunca queda a medias.
  • Las pantallas que solo miran no cargan reglas que no usan.

Lo que cuesta

  • Una pieza y un contrato más por cada conjunto, y un salto más al leer.
  • Una unidad larga puede dejar bloqueado lo que tocó, o chocar con otras al confirmar (capítulo 15).
  • Dos caminos que mantener coherentes y, en la forma completa, una copia que puede ir atrasada.

Un cajón que crece. Un repositorio con un método por pantalla termina siendo las consultas de antes, juntas en un archivo. Una lista nueva para una pantalla es lectura, no un método más.

Cuándo no conviene. Un programa con tres listas y casi sin reglas no necesita repositorios. Leer y guardar directo es más corto, como una caseta de obra sin planoteca. La lectura con copia propia solo se justifica con cargas muy distintas. Si la cuenta del negocio está en otro banco no hay una sola base, y el todo o nada se arma de otra forma (capítulos 16 y 24).

Con qué se combina. Con los agregados (capítulo 5), los casos de uso (capítulo 6), los puertos (capítulo 13), las bases de datos (capítulo 14), la concurrencia (capítulo 15) y los eventos (capítulo 16).

5Para llevarse

En el edificioEn la app del bancoPatrón
Planoteca: se pide «el plano vigente de la C-12»Repositorio de cuentas: se pide «la cuenta 4471»Repository
Paquete de la revisión B, los tres planos o ningunoDébito y crédito, los dos o ningunoUnit of Work
Lista de planos vigentesConsulta directa de los movimientos del mesCQRS

¿Por qué no emitir cada plano apenas está listo?

Porque entre un plano ya en B y otro todavía en A, alguien puede construir con el juego mezclado. En la app sería un débito sin su crédito.

Dónde cojea la analogía

Un vaciado no se deshace, y una revisión sí se puede no emitir. La unidad de trabajo se parece al paquete, que es papel, y no a la obra. Y el programa también tiene vaciados. Un aviso ya enviado al celular de Rosa no se deshace, y por eso se manda después de confirmar (capítulo 16).

El paquete es una equivalencia buena, no exacta. En la obra lo hace cumplir la disciplina, y nada impide emitir un plano suelto. En el programa lo impone la base, pero solo si se decide usar la unidad de trabajo.

La lista de planos es la equivalencia más floja. Solo resume lo emitido, y la lectura del programa además se arma con la forma de cada pantalla.

En la práctica, a noviembre de 2026. En Java, Spring Data JPA da los repositorios y Hibernate lleva los cambios de la sesión hasta confirmarlos. En .NET, el DbContext de Entity Framework Core hace de repositorio y de unidad de trabajo. En Python, la sesión de SQLAlchemy confirma o deshace los cambios que anotó. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 9 · Políticas y especificacionesUna memoria de cálculo por material y la lista de liberación del vaciado.