← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
VIII · El servicio
Capítulo
23
Estado
Borrador
Patrones
Monolito (Monolith) · Monolito modular (Modular Monolith) · Servicios con base propia (Services, Database per Service) · Llamada entre servicios (Remote Procedure Invocation)

Edificio, galería y pasarela

Cuándo un sistema se parte en piezas que corren por separado, y por qué solo donde hay razones.

1Primero, la galería junto al edificio

Con los departamentos ya habitados, el propietario quiere sumar una galería de locales de comida y puede comprar el terreno vecino. Pregunta cómo hacerlo y, de paso, si no convendrían los pabellones que vio en una revista.

La arquitecta y el calculista dibujan tres maneras.

Ampliar dentro del edificio Departamentos Locales ampliados una cimentación, un tablero, un tanque Un bloque entre juntas junta Edificio Galería tablero, tanque y entrada comunes Un pabellón aparte Edificio Galería pasarela cimentación y tablero propios cimentación y tablero propios
Tres maneras de sumar la galería al edificio, de la más atada a la más separada. Se comparte todo, se comparten tablero, tanque y entrada, o solo hay una pasarela.

—Antes de elegir, ¿la galería cambia a otro ritmo que el edificio? —pregunta la arquitecta.

—Con cada inquilino, cada pocos años. El edificio casi nunca —responde el calculista—. Y cada inquilino trae su cuadrilla, mientras al edificio lo cuida una sola.

—¿Y el riesgo?

—Una cocina con fuego y grasa no es un dormitorio.

Se dan los tres motivos, ritmo, equipo y riesgo, y la galería sale como pabellón. En el edificio no se da ninguno, y partirlo sería pagar juntas, pasarelas y tableros de más.

Los bloques del edificio dejan abierta la opción de darles después tablero, tanque y entrada propios, sin tocar su estructura.

Funciona porque se separa donde las razones pesan más que la pasarela, y solo ahí.

2El mismo problema, en la app del banco

Al nacer, la app de banca móvil es un solo programa, con Cuentas y Transferencias, Tarjetas, Préstamos y Cumplimiento adentro y una sola base de datos. Funciona. Un área pide algo a otra con una llamada común, y un cambio se prueba y se entrega una sola vez.

Con los años, Tarjetas y Transferencias tienen cada una su equipo. Tarjetas cambia cada semana, con promociones. Transferencias, una vez al mes y tras revisiones largas, porque mueve plata entre bancos. Un jueves, Tarjetas termina una corrección urgente.

—¿Por qué no sale hoy la corrección de Tarjetas? —pregunta la gerente.

—Porque el programa se entrega entero y Transferencias tiene cambios a medio probar —responde el programador.

Dos semanas después, un error de Tarjetas deja sin memoria al programa, y las transferencias de Rosa se caen con él. Es el edificio ampliado por dentro, con todo atado.

Con el tiempo, un área lee directo las tablas de otra, y separarlas ya es picar la estructura.

3Las cuatro piezas

Los números del dibujo son las piezas.

Un programa, módulos adentro 1 2 Cuentas y Transferencias Tarjetas llamada común una base de datos, un solo todo o nada Dos programas, cada uno con su base 3 Cuentas y Transferencias base propia Tarjetas base propia pedido por la red 4 puede tardar o fallar El todo o nada no cruza la frontera
Arriba, un programa con dos módulos y una base. Abajo, dos programas, cada uno con su base, unidos por un pedido por la red que puede tardar o fallar.

1El monolitoMonolith

Es el edificio único. Un monolito es un programa que se construye, se prueba y se pone en marcha como una sola unidad, y suele tener una sola base de datos. No quiere decir desordenado ni viejo. Mientras es chico es lo más barato, porque un error se busca en un solo lugar.

Por lo tanto

mientras el programa es chico y lo lleva un solo equipo, se construye como una sola unidad.

2El monolito modularModular Monolith

Son los bloques entre juntas. Sigue siendo un solo programa, pero por dentro se divide en módulos, uno por cada contexto del capítulo 12. Cada módulo esconde su interior, ofrece su puerta y guarda sus propias tablas, que ningún otro lee directo. Si Tarjetas necesita algo de Cuentas, lo pide a su puerta. La revisión de cada cambio (capítulo 20) cuida que nadie use lo interno de otro módulo. Se separan el código y los datos, no la ejecución. Si un error deja sin memoria al programa, se caen todos los módulos, como un cortocircuito en el tablero común apaga todos los bloques.

Por lo tanto

se divide por áreas dentro de un programa, con puerta y tablas propias, y queda abierta la opción de pasar a pabellones.

3Los servicios con base propiaServices · Microservices · Database per Service

Es el pabellón. Un servicio es un programa propio, que corre por separado, con su equipo, su entrega y su base de datos. No es el servicio de dominio del capítulo 6, y el glosario del capítulo 28 separa los sentidos. Se parte donde hay ritmos, equipos o riesgos distintos, y el corte conviene que siga un contexto del capítulo 12. Tarjetas y Transferencias tienen las tres.

Las tres áreas del capítulo 16 que se enteran por una cola, Notificaciones, Extracto y Antifraude, pueden correr por separado. Son las que más fácil se sacan, porque nadie espera su respuesta.

Por lo tanto

se separa un servicio donde ritmos, equipos o riesgos lo piden, con su base propia, y no por moda.

4La llamada entre serviciosRemote Procedure Invocation

Es la pasarela. Entre servicios, pedir algo a otra área es un pedido por la red (capítulo 17), que tarda más y puede fallar. Cuando Tarjetas pide retener 300 Bs de una cuenta, ya no llama por dentro, pide y espera. Tampoco hay un solo todo o nada (capítulo 8), así que lo que cruza se coordina con mensajes y, si algo falla, con otro que lo contrarresta, la saga del capítulo 16. La falla de esa llamada se ve en el capítulo 24.

Por lo tanto

cada llamada entre servicios se diseña como lo que es, un pedido por la red que puede tardar o fallar.

4Qué se gana y qué cuesta

Lo que se gana

  • Cada servicio se entrega y se repara por su cuenta, sin que un equipo espere al otro.
  • Un error en Tarjetas no tumba a Transferencias, mientras ninguna espere a la otra sin límite (capítulo 24).

Lo que cuesta

  • La pasarela. Cada llamada entre áreas pasa por la red y puede fallar.
  • Las redes duplicadas. Cada servicio lleva su entrega, su base y su vigilancia (capítulo 25).
  • Datos repartidos. Lo que antes se unía en una consulta (capítulo 14) pasa a ser dos pedidos.
  • Más coordinación. Un cambio que toca a dos servicios pide acuerdo entre dos equipos.

Pabellones sobre la misma losa de cimentación. Dos servicios que comparten una base de datos, o que solo se entregan juntos, son un edificio con un corte dibujado. Pagan la pasarela y no tienen la independencia (Distributed Monolith).

Cuándo no conviene. Un equipo chico, con un solo ritmo, no necesita pabellones. Se empieza por un monolito, mejor si es modular, porque cada junta cuesta (capítulo 11).

Con qué se combina. Con los contextos, que dicen dónde cortar (capítulo 12), los puertos (capítulo 13), los eventos (capítulo 16) y la resiliencia (capítulo 24).

5Para llevarse

En el edificioEn la app del bancoPatrón
Un solo edificio, con todo comúnUn solo programa con una base de datos comúnMonolith
Bloques entre juntas, que se sostienen solosMódulos por área, con su puerta y sus tablasModular Monolith
Pabellón con cimentación, tablero y equipo propiosServicio con su programa, su entrega y su baseServices · Database per Service
Pasarela entre pabellonesPedido por la red entre serviciosRemote Procedure Invocation

¿No es lo mismo que poner más servidores?

No. Más servidores es copiar el mismo programa para atender a más gente, como un segundo ascensor (capítulo 22). Los pabellones son piezas distintas.

Dónde cojea la analogía

La pasarela se cruza o no se cruza. Una llamada de red puede tardar, perderse o no recibir respuesta, y entonces no se sabe si lo pedido se hizo. Es la equivalencia más floja.

El bloque del capítulo 5 era un agregado. Un módulo es más grande y junta varios de un mismo contexto.

Tampoco se decide igual. En la obra, partir una estructura ya construida es una intervención mayor, y juntar dos cuesta obra nueva. Un programa se parte y también se vuelve a juntar, con trabajo, y por eso se empieza junto y se parte cuando aparece la razón.

En la práctica, a noviembre de 2026. Spring Modulith (Java) comprueba que un módulo no use el interior de otro, y en .NET se consigue con un proyecto por módulo y lo interno marcado internal. Entre servicios, los pedidos van por HTTP o por gRPC, que tiene clientes en Java, Go, C# y Python. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 24 · ResilienciaEl tablero con un interruptor por circuito y la bomba que no responde.