Ingeniería de Sistemas · Semestre IV · 2026-2 · Clase 3 de 16

De los drivers
a la decisión

Hoy cerramos el puente: qué exige el negocio, cómo se traduce en requisitos que mandan, y cómo se decide qué va junto y qué va separado. — Elkin Rodríguez E.

Ruta de hoy · 3 horas

Cómo va a fluir la clase

01
Drivers a fondo Lo retomamos en serio: qué es, de dónde sale y cómo se escribe bien.
02
Dinámica: Clasificador Rápida y en voz alta. ¿Esto es driver o no lo es?
03
Dónde estamos parados Patrón de diseño, estilo y táctica. Qué es cada cosa.
04
El ADN Cohesión, acoplamiento y la prueba del cambio.
05
Lo hacemos juntos Un caso completo, paso a paso, en el computador.
06
Taller: Consejo de Arquitectura Ahora solos: su caso, su decisión, su ADR.
Cómo usar estas diapositivas

Los botones de glosario

Cada vez que aparezca un término técnico que quizá no manejan, va a estar en un botón como este. Háganle clic y se abre la definición.

Prueben: API (Application Programming Interface)
Es el "menú" que una pieza de software le ofrece a otra: la lista de operaciones que puede pedirle y en qué formato. Si el módulo de pagos expone cobrar(monto, tarjeta), esa firma es parte de su API. La API es el contrato: mientras no cambie, cada pieza puede cambiar por dentro sin romper a la otra.
y también HTTPS
Es el protocolo con el que viajan los datos por internet (HTTP) pero cifrados. La "S" es de secure. Garantiza que nadie en el camino pueda leer ni alterar lo que se envía. Hoy es el estándar mínimo para cualquier sistema que maneje datos de personas.
.

Para qué sirveNo necesitan saberlo todo de memoria. Necesitan saber que existe y poder resolverlo por su cuenta. Esa es la habilidad real.
Capa 1 · lo retomamos en serio

Volvemos a los drivers

En la clase pasada los nombramos. Hoy los entendemos, porque todo lo demás depende de esto: sin drivers claros, cualquier decisión de arquitectura es una opinión.

La traducción literal de driver es "conductor", en el sentido de lo que conduce, lo que lleva el timón. No es cualquier requisito: es el que manda sobre la forma del sistema.
Capa 1 · definición precisa

Qué es un driver arquitectónico

Un driver arquitectónico es un requisito que tiene influencia significativa sobre la estructura del sistema. Si lo cambias, la arquitectura tiene que cambiar.

Sí es driver

"El saldo debe consultarse en menos de 2 segundos con 50.000 usuarios simultáneos."

Obliga a decidir caché, réplicas y separación.

No es driver

"El botón de consultar saldo debe ser azul."

Es un requisito real y válido, pero no cambia ninguna estructura.

La pruebaPregúntate: si me quitan este requisito, ¿rediseño el sistema? Si la respuesta es no, no es un driver.
Capa 1 · de dónde salen

La cadena que nadie debe romper

Objetivo de negocio

"Ser la app de pagos con menos quejas del país."

→

Driver

"Consultar saldo debe funcionar 99,9% del tiempo, incluso en quincena."

→

Decisión

"Separamos consulta de saldo del resto y la replicamos."

Todo driver nace de un objetivo de negocio y muere en una decisión de diseño. Si no puedes trazar esa línea completa, o el driver está mal escrito, o la decisión es un capricho técnico.
Capa 1 · los tres tipos

Un driver puede ser de tres clases

1 · Funcional

Qué debe hacer el sistema, pero solo los casos de uso primarios: los que sostienen el negocio. Ej.: "comprar boleto en línea". No todos los casos de uso son drivers.

2 · Atributo de calidad

Cómo debe comportarse. Rápido, disponible, seguro, modificable. Son los que más moldean la arquitectura. Ej.: "responder en menos de 2 s".

3 · Restricción

Lo que no se negocia. Decisiones ya tomadas que el arquitecto recibe impuestas: presupuesto, tecnología obligatoria, ley, plazo. Ej.: "los datos deben quedarse en Colombia".

La diferencia claveLos funcionales y los de calidad se priorizan (eliges un subconjunto). Las restricciones no: todas entran, porque no puedes negociarlas.
Capa 1 · tipo 2 · el más importante

El catálogo de atributos de calidad

No hay una lista única, pero el estándar ISO/IEC 25010
Estándar internacional que organiza la calidad del software en características y subcaracterísticas. Es la evolución del ISO/IEC 9126 que vieron en la Lectura B. Sirve como lista de chequeo: al levantar requisitos, se recorre el catálogo preguntando "¿esto le importa a este sistema?" para no olvidar dimensiones enteras.
da el mapa más usado:

AtributoLa pregunta que responde
Desempeño¿Qué tan rápido responde bajo carga?
Disponibilidad¿Cuánto tiempo está arriba? ¿Se recupera solo?
Seguridad¿Quién puede hacer qué? ¿Los datos están protegidos?
Modificabilidad¿Qué tan barato es cambiarlo mañana?
Usabilidad¿Qué tan fácil es de usar y de aprender?
Escalabilidad¿Aguanta 10× más usuarios sin rediseñarse?
Portabilidad¿Se puede mover a otro entorno?
Los dos resaltadosDesempeño y disponibilidad son los que más veces obligan a partir un sistema. Casi todos los casos de hoy giran alrededor de ellos.
El error que vi en las sustentaciones

"Que sea rápido" no es un driver

Mal escrito · no sirve

"El sistema debe ser rápido y estar siempre disponible."

¿Rápido cuánto? ¿Bajo qué carga? ¿Siempre es 99% o 99,99%? Con esto no se puede diseñar ni verificar nada.

Bien escrito · esto sí manda

"Ante 50.000 consultas simultáneas de saldo en día de quincena, el sistema responde en menos de 2 segundos en el 99% de los casos."

Ahora sí se puede diseñar y medir.

Regla profesional: un atributo de calidad sin número es un deseo, no un requisito.
Capa 1 · la herramienta formal

El escenario de calidad · seis partes

Así se escribe un atributo de calidad de forma profesional. Seis campos, ninguno opcional:

ParteQué esEjemplo
FuenteQuién genera el estímuloUn usuario de la app
EstímuloQué ocurreConsulta su saldo
EntornoEn qué condicionesDía de quincena, 50.000 usuarios
ArtefactoQué parte se ve afectadaEl servicio de saldo
RespuestaQué hace el sistemaDevuelve el saldo actualizado
MedidaEl número que lo hace verificableMenos de 2 s en el 99% de casos
Por qué seis y no dosSin entorno no sabes bajo qué carga; sin medida no puedes verificar. Son los dos que siempre se olvidan.
Capa 1 · tipo 3

Restricciones: lo que no se negocia

Son decisiones que ya vienen tomadas. El arquitecto no las discute: las recibe y diseña con ellas.

Técnicas

"Debe correr sobre la base de datos Oracle que ya compramos."

De negocio

"Presupuesto de nube: 5 millones al mes, no más."

Legales

"Los datos personales no pueden salir del país."

Por eso todas las restricciones son drivers, sin priorizar: una sola de ellas puede tumbar el diseño entero. Ignorarlas es diseñar algo que no se puede construir.
El criterio profesional

De 200 requisitos, ¿cuáles son drivers?

Un sistema real tiene cientos de requisitos. El arquitecto solo puede trabajar con un puñado. Se eligen con tres criterios:

  1. Importancia para el negocio — ¿el cliente pierde plata o reputación si esto falla?
  2. Dificultad técnica — ¿es difícil de lograr? Lo fácil no necesita decisión arquitectónica.
  3. Impacto estructural — ¿obliga a organizar el sistema de cierta forma?
Regla de dedoEntre 5 y 10 drivers bien elegidos gobiernan el diseño de casi cualquier sistema. Más que eso es no haber priorizado.
Capa 1 · métodos formales

Tres métodos para priorizar

"Priorizar con criterio" no es intuición: existen métodos. Estos tres son los más usados.

Eisenhower

Matriz de 2×2 clásica (urgente / importante). En arquitectura se adapta cambiando los ejes a impacto en el negocio × dificultad técnica. Lo importante-y-difícil se decide primero; lo fácil-y-poco-importante se delega o se pospone.

MoSCoW

Must · Should · Could · Won't. Clasifica cada requisito en cuatro cajas. Su virtud: obliga al negocio a declarar qué NO se va a hacer. Si todo es "Must", nadie priorizó.

Árbol de utilidad

El método propio de la arquitectura (Bass, Clements y Kazman). Cada escenario de calidad recibe dos notas: importancia para el negocio y dificultad técnica, en escala Alta/Media/Baja. Los que quedan (Alta, Alta) son los drivers.

Cuál usarEisenhower y MoSCoW sirven para cualquier lista de tareas. El árbol de utilidad está hecho para esto y es el que usa el método ATAM de evaluación de arquitecturas. Es el que vamos a aplicar.
El árbol de utilidad, aplicado

Dos notas y sale el driver

Caso: la app de pagos "Bolsillo". Cada escenario recibe (Negocio, Dificultad):

Escenario de calidadNegocioDificultad¿Driver?
Consultar saldo en menos de 2 s con 50.000 usuarios en quincenaAltaAltaSÍ — decide el diseño
Si un servidor cae, el servicio vuelve en menos de 30 sAltaAltaSÍ
Cambiar el color del tema de la app en un díaBajaBajaNo
Exportar el historial a ExcelMediaBajaNo — es fácil, se resuelve luego
Soportar 12 idiomasBajaAltaNo hoy — difícil pero al negocio no le urge
La lecturaSolo la esquina (Alta, Alta) obliga a decisiones de arquitectura. Lo demás se construye, pero no cambia la forma del sistema.
Cómo se clasifica · úsenlo en la dinámica

Tres preguntas, en este orden

  1. ¿Si me quitan esto, rediseño el sistema?
    NO → no es driver. Se acabó. SÍ → sigue a la 2.
  2. ¿Es algo que el sistema HACE, o es CÓMO lo hace?
    Lo que hace y sostiene el negocio → funcional. Cómo se comporta (rápido, disponible, seguro) → atributo de calidad.
  3. ¿Es una decisión que yo puedo tomar, o me la impusieron?
    Impuesta y no negociable (ley, presupuesto, tecnología obligatoria) → restricción.
El filtro extra para atributos de calidadSi dice que sea rápido, seguro o fácil pero no trae número ni condiciones, todavía no es driver: es un deseo. Hay que exigirle la medida antes de aceptarlo.
Dinámica rápida · 12 min · en voz alta

El Clasificador de drivers

Les leo un requisito. Ustedes responden dos cosas, gritando desde el puesto:

  1. ¿Es driver o no es driver?
  2. Si lo es: ¿funcional, atributo de calidad o restricción?
Y la pregunta trampa que voy a hacer siempre: "¿por qué?". La respuesta correcta sin razón no vale.
Clasificador · los ocho enunciados

¿Driver o no? ¿De qué tipo?

#Requisito
1"El usuario puede transferir dinero a otra cuenta."
2"El logo va en la esquina superior izquierda."
3"Debe soportar 50.000 usuarios simultáneos en quincena."
4"Los datos de clientes deben permanecer en territorio colombiano."
5"El sistema debe ser bonito e intuitivo."
6"Si se cae un servidor, el servicio sigue en menos de 30 segundos."
7"Debe integrarse con el core bancario que ya existe y no se puede cambiar."
8"El correo de confirmación debe decir 'Gracias por su compra'."
Antes de seguir · ubicación obligatoria

Tres niveles que no son lo mismo

Mucha gente los mezcla y por eso habla mal de arquitectura. Ubíquense:

Estilo arquitectónico

La forma global del sistema. Cómo se organiza y despliega todo. Ej.: monolítico, cliente-servidor, por capas, microservicios, orientado a eventos. Es lo que veremos hoy.

Patrón arquitectónico

Solución probada a un problema estructural recurrente, dentro de un estilo. Ej.: MVC, publicador-suscriptor, broker. Clase 4.

Patrón de diseño

Solución a un problema de clases y objetos, dentro de un módulo. Ej.: Singleton, Observer, Factory. Es el nivel del código. Clase 4.

Ojo con estoMonolito y microservicios NO son patrones de diseño. Son estilos: hablan de cómo se reparte y despliega el sistema completo, no de cómo se escriben las clases.
Por qué empezamos por los estilos y no por los patrones

Del mapa al detalle

Un patrón de diseño resuelve un problema dentro de una pieza. Pero primero hay que decidir cuáles son las piezas. Eso es lo que hacemos hoy.

Analogía: primero se decide si la ciudad tendrá barrios separados o un solo edificio gigante (estilo). Después se decide cómo se construye cada apartamento por dentro (patrón de diseño). Hacerlo al revés es amoblar antes de saber si hay paredes.
La misma idea, en cristiano

Pensémoslo como una ciudad

Estilo = la ciudad

¿Es una ciudad compacta donde todo queda a pie, o varios pueblos separados conectados por carretera? Esa decisión define cómo se mueve todo el mundo. Compacta = monolito. Pueblos conectados = microservicios.

Patrón arq. = el centro comercial

Dentro de la ciudad hay soluciones que se repiten porque funcionan: el centro comercial —un techo, muchos locales, pasillos comunes, parqueadero compartido—. Nadie lo reinventa en cada ciudad: lo copia y lo adapta.

Patrón de diseño = la caja registradora

Dentro de un local, ¿cómo se cobra? ¿Fila única o una fila por caja? Solución pequeña, interna y repetible. No cambia la ciudad ni el centro comercial, pero resuelve bien un problema puntual.

La prueba para no confundirsePregunta "¿a qué escala afecta?": si afecta a todo el sistema y su despliegue, es estilo. Si es una estructura repetible dentro del sistema, es patrón arquitectónico. Si vive dentro de un módulo, en el código, es patrón de diseño.
De dónde salen estos conceptos

Cada nivel tiene su libro fundador

Esto no lo inventó nadie en un blog. Son tres tradiciones con obras de referencia:

NivelObra que lo establecióEjemplos que trae
Estilo arquitectónicoShaw & Garlan (1996)
Software Architecture: Perspectives on an Emerging Discipline
Tubería y filtros, capas, repositorio, cliente-servidor
Patrón arquitectónicoBuschmann y otros (1996)
Pattern-Oriented Software Architecture (POSA)
Capas, broker, MVC, publicador-suscriptor
Patrón de diseñoGamma, Helm, Johnson y Vlissides (1994)
Design Patterns — el "GoF"
Singleton, Observer, Factory, Strategy
Un aviso honestoVerán que "capas" aparece en dos filas. Es cierto: los autores no se pusieron de acuerdo y algunos términos se solapan. Lo que importa no es ganar la discusión de etiquetas, sino saber a qué escala están decidiendo.
Capa 1 · el concepto, en serio

Qué es un estilo arquitectónico

Un estilo arquitectónico es un conjunto de decisiones estructurales ya probadas que define cómo se organizan las piezas de un sistema, cómo se comunican entre sí y cómo se despliegan.

Qué define

Los tipos de pieza que existen y las reglas de cómo pueden hablarse.

Qué NO define

El lenguaje, el framework ni el código. Un mismo estilo se implementa en Java, Python o Go.

De dónde sale

De problemas resueltos miles de veces. Nadie inventa un estilo: lo elige.

La analogía útilEn construcción existen tipologías —casa unifamiliar, edificio de apartamentos, conjunto cerrado—. Nadie inventa una desde cero: elige la que sirve al terreno y al presupuesto. En software es igual.
Capa 1 · utilidad profesional

¿Para qué sirven, en la práctica?

1
Dan un vocabulario común Decir "es un monolito modular" comunica en tres palabras lo que tomaría media hora de diagrama. Todo el equipo entiende lo mismo.
2
Traen consecuencias conocidas Cada estilo tiene ventajas y costos ya documentados. Elegirlo es heredar un conjunto de trade-offs que otros ya pagaron.
3
Aceleran la decisión No se diseña desde cero: se parte de una estructura probada y se adapta al contexto.
4
Se conectan con los drivers Cada estilo favorece ciertos atributos de calidad y castiga otros. Ahí es donde se cruza con lo que vimos hoy.
Por eso el orden importa: primero los drivers, después el estilo. Elegir el estilo antes de saber qué exige el negocio es escoger la respuesta antes de leer la pregunta.
Importante · no son solo tres

El catálogo es mucho más amplio

Hoy vamos a estudiar tres a fondo, pero para que no queden con una idea incompleta, estos son otros estilos igual de vigentes:

EstiloIdea centralDónde se ve
Por capasPresentación → lógica → datos, cada capa habla solo con la vecinaSistemas empresariales, ERP
Cliente-servidorUn servidor central atiende a muchos clientesCasi toda la web
Orientado a eventosLas piezas reaccionan a hechos, no a llamadasBanca transaccional, IoT
Tubería y filtrosEl dato pasa por etapas que lo transformanProcesamiento de datos, ETL
Microkernel / pluginsUn núcleo mínimo y extensionesVS Code, navegadores
ServerlessFunciones que se ejecutan por demanda, sin servidor propioCargas intermitentes
Monolito · modular · microserviciosCómo se reparte y despliega el sistema completoLos tres de hoy
Y se combinanEn la vida real casi nunca hay un estilo puro. Un sistema puede ser microservicios que por dentro están por capas y se comunican por eventos.
Estilo 1 de 3

Monolito

Todo el sistema —catálogo, pagos, usuarios, reportes— vive en un solo programa, que corre como un solo Proceso
Un programa en ejecución dentro del computador, con su propia memoria asignada. Si dos módulos viven en el mismo proceso, se comunican leyendo la misma memoria: es instantáneo. Si viven en procesos distintos, tienen que mandarse mensajes por la red, lo cual es miles de veces más lento.
y usa una sola base de datos.

A favor

Simple de arrancar · rápido, todo se habla por memoria · fácil de desplegar al principio.

En contra

Todo sube junto · un error puede tumbarlo todo · escalar una parte obliga a escalar el resto.

Caso real · Stack OverflowEl sitio que todos ustedes usan para programar atiende millones de usuarios diarios con un monolito corriendo en unos pocos servidores web. Nunca migró a microservicios. Monolito no significa mal hecho.
Estilo 2 de 3

Monolito modular

Sigue siendo un solo programa que se despliega junto, pero por dentro está partido en módulos con fronteras claras: catálogo no mete la mano en pagos.

A favor

Orden, y equipos que no se pisan · sigue siendo rápido, memoria y no red · barato de operar.

En contra

Sigue habiendo un solo punto de falla · sigue subiendo todo junto.

Caso real · ShopifyLa plataforma de e-commerce más grande después de Amazon corre sobre "Shopify Core": un monolito modular en Ruby on Rails de más de 2,8 millones de líneas. En Black Friday mueve 30 TB por minuto. Deliberadamente no lo partieron en microservicios.
Estilo 3 de 3

Microservicios

Cada capacidad del negocio es un programa aparte, con su propio Despliegue (deployment)
El acto de poner una versión del software a funcionar en los servidores donde lo usan las personas. "Desplegar" es publicar el cambio. Si todo el sistema es un solo despliegue, cualquier cambio obliga a subir todo junto y a arriesgarlo todo junto.
y su propia base de datos. Se comunican por la red.

A favor

Se despliega y se escala cada pieza sola · si una falla, las demás siguen · equipos autónomos.

En contra

Latencia
El tiempo que tarda un mensaje en ir de un punto a otro. Dentro de un mismo proceso, una llamada tarda nanosegundos. Entre dos servicios por la red, tarda milisegundos: hasta un millón de veces más. Por eso separar piezas que se hablan mucho sale caro.
de red · datos difíciles de mantener consistentes · mucha más operación y monitoreo.

Caso real · Rappi y NequiDos colombianas que funcionan gracias a este estilo. Rappi opera casi toda su tecnología sobre AWS con microservicios, y así pasó de app de domicilios a superapp sin reescribirse. Nequi nació en la nube con microservicios y serverless: llegó a casi 15 millones de usuarios desplegando cada quincena.
Los tres, lado a lado

Tabla comparativa

FactorMonolitoModularMicroservicios
Fronteras internasDifusasClarasClaras y físicas
DespliegueTodo juntoTodo juntoIndependiente
Si algo fallaCae todoAfecta al procesoSe aísla
Velocidad internaMemoria (rápida)Memoria (rápida)Red (lenta)
Base de datosCompartidaCompartidaUna por servicio
Escalar una parteImposibleImposibleSí
Costo de operarBajoBajoAlto
Equipo mínimo viable1–5 personas5–30 personasVarios equipos
Cuándo brillaProducto nuevo, validar rápidoProducto maduro, un equipo grandeMuchos equipos, cargas muy distintas
La fila que más decideEquipo mínimo viable. No es un tema técnico: es organizacional. Un equipo de 6 personas no puede operar 14 servicios, por muy elegante que sea el diseño.
Casos reales · quién usa qué y por qué

Esto no es teoría

EmpresaEstiloPor qué le funciona
Stack OverflowMonolitoCarga alta pero predecible y un solo dominio. Pocos servidores, equipo pequeño, costo mínimo.
ShopifyModularUn producto, muchos equipos. Necesita orden interno, no despliegues separados. 30 TB/min en Black Friday.
Rappi 🇨🇴MicroserviciosSuperapp: domicilios, pagos, viajes. Cada vertical evoluciona a su ritmo sin tocar el core de despachos.
Nequi 🇨🇴Microservicios + serverlessNació en la nube. Picos transaccionales enormes y despliegues quincenales sin frenar el negocio.
Bancolombia 🇨🇴HíbridoCore bancario en infraestructura propia + capa digital moderna. Lo viejo no siempre se bota: se rodea.
NetflixMicroserviciosTráfico global, cientos de equipos autónomos, tolerancia a fallos como requisito de vida o muerte.
El veredicto honesto

Ningún estilo es mejor que otro

Microservicios cuando…

Hay varios equipos que necesitan avanzar sin pedirse permiso · las partes tienen cargas muy distintas · una falla no puede tumbar el resto · hay capacidad real de operarlos.

Rappi, Nequi y Netflix no serían lo que son sin este estilo.

Monolito o modular cuando…

El equipo es pequeño · el producto todavía se está validando · las piezas se hablan muchísimo entre sí · el presupuesto de operación es limitado.

Shopify y Stack Overflow tampoco serían lo que son sin este estilo.

La pregunta profesional no es "¿cuál es el mejor?" sino "¿cuál le sirve a mis drivers, con el equipo y el presupuesto que tengo?"
Cómo se hablan las piezas

Cuatro formas de conectar

1
Base de datos compartida Dos piezas escriben en la misma tabla. La conexión más pegajosa y más invisible.
2
Llamada directa en memoria Una función llama a otra dentro del mismo programa. Instantánea.
3
API por red (REST sobre HTTP
La forma más común de que dos sistemas se hablen por internet. Una pieza envía una petición (por ejemplo GET /saldo/123) y espera la respuesta. Es simple y universal, pero crea acoplamiento temporal: si el que responde está caído, el que pregunta se queda esperando.
)
Una pieza le pide algo a otra y espera. Si la otra se cae, esta se queda esperando.
4
Eventos Una pieza anuncia "pasó esto" y sigue su vida. No sabe quién la escucha ni espera respuesta.
Ya sabemos qué exige el negocio y qué formas existen

¿Esto va junto
o va separado?

Es la pregunta que les van a hacer en su primer trabajo. Y ahora tienen con qué responderla: los drivers dicen qué importa; el acoplamiento dice qué cuesta.

Capa 1 · concepto base

Modularidad: partir para poder pensar

Un módulo es una pieza con una frontera clara y un contrato (su API). Modularizar no es tener muchos archivos: es poder cambiar una pieza sin entender las demás.

En la empresaSi para arreglar un bug tienes que leer cinco archivos, no tienes módulos: tienes carpetas.
El par que nunca se separa

Cohesión y acoplamiento

Cohesión · salud interna

¿Qué tan relacionado está lo que puse dentro de un módulo?

La quiero ALTA. Un módulo, una razón de existir.

Acoplamiento · salud externa

¿Qué tanto depende este módulo de otros?

Lo quiero BAJO. Cambiar aquí no debería obligar a cambiar allá.

Alta cohesión, bajo acoplamiento. Suena a eslogan. Ahora lo volvemos medible.
Capa 1 · cohesión

Cómo se ve la cohesión baja

SíntomaQué está pasando
Se llama utils o helpersNadie supo dónde poner las cosas.
Para describirlo necesitas la palabra "y""Maneja usuarios y facturas y correos" → son tres módulos.
Un cambio de negocio toca 6 archivosLa lógica de un concepto quedó regada.
Dos equipos editan siempre el mismo archivoLa frontera no coincide con el equipo.
Prueba rápidaDescribe el módulo en una frase sin la palabra "y". Si no puedes, la cohesión es baja.
Capa 1 · acoplamiento

El acoplamiento es una escala

Muy altoComparten tablas de la base de datos
AltoUno conoce el interior del otro
MedioLlamada por API y espera respuesta
BajoContrato estable y versionado
Muy bajoEventos: no saben quién escucha

Nadie busca acoplamiento cero: sería un sistema donde nada se comunica. Se busca el mínimo que el problema permita.

La herramienta del día

La prueba del cambio

Tres preguntas frente a cualquier decisión. Es todo lo que necesitan hoy.

  1. Si cambio esto, ¿qué más tengo que tocar? → acoplamiento
  2. Si esto se cae, ¿qué se cae con él? → radio de daño
  3. Si duplico la carga aquí, ¿tengo que escalar todo? → desperdicio
En la empresaEsta es literalmente la conversación de un Code review
Revisión del código por otra persona del equipo antes de integrarlo al sistema. Es el momento en que alguien pregunta "¿por qué pusiste esto aquí?" o "¿esto no debería ir en otro módulo?". Quien sabe argumentar en términos de cohesión y acoplamiento gana influencia técnica rápido.
. Quien sabe hacer estas tres preguntas se gana la silla.
Capa 2 · el eje del curso

Separar no es gratis

Lo que ganas

Despliegue independiente · aislamiento de fallos · escalar solo lo que lo necesita · equipos autónomos.

Lo que pagas

Latencia de red · complejidad de operación · Consistencia de datos
Que todos vean el mismo dato al mismo tiempo. En un monolito con una base de datos es casi gratis. Cuando separas, el dato vive en varios lados y aparece la consistencia eventual: durante unos segundos, dos usuarios pueden ver cifras distintas. Para un saldo bancario eso puede ser inaceptable; para un contador de "me gusta", da igual.
difícil · más costo de nube.

En este curso no hay mejores prácticas absolutas. "Microservicios" no es una respuesta: es una factura que alguien debe estar dispuesto a pagar.
El caso que matiza todo

Amazon Prime Video, 2023

Ojo: Amazon es el estandarte de los microservicios y los sigue usando en casi todo. Pero un servicio suyo —el que revisa cada segundo de video para detectar fallas— chocó con tres muros al escalar:

La decisiónVolvieron a juntarlo todo en un monolito modular. Resultado: 90% menos costo y más velocidad, porque los datos viajan por memoria y no por red.
Qué se aprende de verdad de ese caso

No es "microservicios malo"

Es que el estilo correcto depende del problema. La misma empresa que sostiene medio internet con microservicios decidió que para ese caso puntual no servían. Si dos piezas se hablan miles de veces por segundo con datos pesados, separarlas es pagar un peaje en cada llamada.

Regla 1

Separa donde el cambio y la carga son distintos.

Regla 2

Junta donde la conversación es intensa y constante.

Regla 3

El monolito modular es una arquitectura respetable.

Capa 2 · lo que no estaba hace un año

¿Qué tan acoplado queda el código
que escribe una IA?

Un LLM (Large Language Model)
Modelo de lenguaje entrenado con enormes cantidades de texto y código, capaz de generar código funcional a partir de instrucciones. Es lo que hay detrás de Claude, ChatGPT o Copilot. Sabe muchísimo de sintaxis y de patrones comunes, pero no conoce tu negocio ni ve todo tu repositorio.
optimiza para que el código funcione ahora. No conoce las fronteras de tu negocio ni qué va a cambiar el próximo trimestre.

Su trabajo en 2026La IA escribe rápido. Ustedes ponen las fronteras. Revisar acoplamiento exige conocer el negocio — por eso no se automatiza.
Break de 20 min

Ya tienen
las leyes.

Al volver: abran su computador. Vamos a resolver un caso completo juntos, paso a paso.

Lo hacemos juntos

Un caso,
de principio a fin

Yo lo hago en pantalla, ustedes me siguen en su computador. Al terminar van a saber exactamente qué se espera de ustedes en el taller.

Antes de empezar

Abran esto en su computador

  1. Un documento en blanco (Word, Docs o el editor que usen).
  2. Copien la plantilla de abajo y péguenla ahí.
  3. La llenamos juntos con el caso demo; después, solos con el suyo.
Plantilla ADR · cópienla ahora
# ADR-001 · [Titulo de la decision]
Fecha: 4 de agosto de 2026 · Equipo: [nombres]

## Contexto
## Drivers que mandan
## Decision
## Alternativas consideradas
## Consecuencias
## Como sabremos si acertamos
Qué es un ADR

El documento que separa a un arquitecto
de alguien con opiniones

Un ADR · Architecture Decision Record
Registro de decisión arquitectónica. Es un documento corto —una página— donde se deja constancia de qué se decidió, por qué, qué se descartó y qué cuesta. Se guarda junto al código. Su valor real aparece meses después: cuando alguien pregunta "¿por qué está hecho así?", la respuesta existe y no depende de que siga en la empresa quien la tomó.
no describe el sistema: describe por qué el sistema es así.

Sin ADR, en seis meses nadie recuerda por qué se separó algo, y el que llega nuevo lo "arregla" volviendo a juntarlo. Una decisión sin registro no existe.
Caso demo

"CineYa" · venta de boletas

Cadena de cines con venta en línea. Hoy es un monolito: cartelera, selección de sillas, pagos, notificaciones y reportes gerenciales, todo en un programa con una sola base de datos.

Los tres síntomas que reporta el equipo:
Método · antes del paso 1

¿Cómo un dolor se vuelve un driver?

Los usuarios y el negocio nunca dicen drivers: dicen quejas. Traducirlas es trabajo del arquitecto, y se hace con tres preguntas en orden:

  1. ¿A quién le duele y qué pierde?
    "Se cae la cartelera" → el cliente no ve qué hay en cartelera → no compra. Ahí está el objetivo de negocio.
  2. ¿Qué atributo de calidad está fallando?
    ¿No responde? Desempeño. ¿Se cae? Disponibilidad. ¿Cuesta cambiarlo? Modificabilidad.
  3. ¿Cuál es el número aceptable?
    Se lo preguntas al negocio: "¿cuánto tiempo abajo tolera?" → 99,9%. Ese número convierte la queja en driver.
La fórmulaQueja + atributo de calidad + número + condiciones = driver. Sin alguno de los cuatro, todavía no lo es.
Método aplicado

Los tres dolores de CineYa, traducidos

Lo que dice el equipo (queja)AtributoDriver resultante
"En estrenos se cae todo, hasta ver la cartelera"DisponibilidadLa cartelera responde el 99,9% del tiempo, incluso en estrenos.
"Los reportes vuelven lenta la venta"DesempeñoComprar una boleta se completa en menos de 3 s en hora pico.
"Cambiar una promo obliga a redesplegar pagos"ModificabilidadPublicar una promoción sin tocar el módulo de pagos.
"Somos 5 y no damos abasto"—Restricción: equipo de 5 personas, presupuesto limitado.
Fíjense en la última filaNo toda queja es atributo de calidad. Cuando es algo que no se negocia, es una restricción — y suele decidir más que todo lo demás.
Paso 1 · Los drivers

Primero: ¿qué manda aquí?

Antes de tocar la estructura, escribimos los drivers. Sin esto, cualquier decisión es capricho.

TipoDriver
DisponibilidadLa cartelera debe responder el 99,9% del tiempo, incluso en estrenos.
DesempeñoComprar una boleta debe completarse en menos de 3 s en hora pico.
FuncionalReservar silla y cobrar deben ocurrir como una sola operación.
RestricciónEquipo de 5 personas. No hay presupuesto para más infraestructura grande.
FíjenseLa restricción del equipo de 5 va a decidir más que cualquier consideración técnica.
Método · antes del paso 2

Qué es exactamente un diagnóstico

Diagnosticar no es decir "está mal hecho". Es señalar qué piezas están pegadas y por dónde. Se hace pieza por pieza, con la prueba del cambio.

1
Listen las piezas En CineYa: cartelera · sillas · pagos · notificaciones · reportes.
2
Pásenle las tres preguntas a cada una ¿Qué toco si la cambio? ¿Qué cae con ella? ¿Escalo todo si crece?
3
Marquen dónde el dolor cruza con un driver Si algo duele pero ningún driver lo exige, no es prioridad hoy.
Salida del diagnósticoUna frase por pieza problemática: "[pieza] está pegada a [pieza] por [despliegue / datos / equipo], y eso incumple el driver de [X]". Esa frase es lo que va en el ADR.
Paso 2 · Diagnóstico

Aplicamos la prueba del cambio

PreguntaRespuesta en CineYa
Si cambio algo, ¿qué toco?Cambiar una promo obliga a subir pagos. Están pegados por despliegue.
Si se cae, ¿qué cae con él?El pico de estreno tumba también la cartelera, que es solo lectura y no debería caer nunca.
Si duplico la carga, ¿escalo todo?Sí. Para aguantar un estreno hay que agrandar el servidor completo, reportes incluidos.
ConclusiónDuelen dos cosas: la cartelera (mucho tráfico, no puede caer) y los reportes (pesados, compiten con la venta).
Método · antes del paso 3

La regla para decidir qué se separa

No es intuición. Una pieza se separa si cumple al menos dos de estas cuatro señales:

Señales de SEPARAR

1. Cambia con un ritmo distinto al resto.
2. Tiene una carga muy distinta (mucho más tráfico, o mucho más pesada).
3. No puede caerse cuando lo demás sí puede.
4. La mantiene otro equipo.

Señales de DEJAR JUNTO

1. Se hablan muchísimo entre sí.
2. Exigen consistencia fuerte (o pasan las dos cosas, o ninguna).
3. Cambian siempre al tiempo.
4. No hay equipo para operarlas por separado.

Y una tercera categoría que casi nadie escribeLo que NO se toca. Si algo funciona y no hay pruebas que lo respalden, moverlo es ruleta. Decidir no tocar también es decidir — y va en el ADR.
Paso 3 · Decisión

Qué separo, qué dejo junto

Separo

Cartelera — señales 2 y 3: tráfico altísimo y no puede caerse. Cumple el driver de disponibilidad.

Reportes — señales 1 y 2: cambian a otro ritmo y son pesados. Van a una Réplica de lectura
Una copia de la base de datos que solo sirve para consultar, nunca para escribir. Se sincroniza automáticamente con la original. Sirve para que los reportes pesados no compitan por recursos con las operaciones urgentes, como una venta.
.

Dejo junto · y no toco

Sillas + pagos — señales 1 y 2 de "dejar junto": se hablan en cada compra y exigen consistencia fuerte. Si se cobra, la silla queda reservada.

Notificaciones — no duele hoy. No se toca.

Fíjense en lo que no hicimos: no partimos todo en microservicios. El driver de "equipo de 5" lo prohíbe. Separamos solo donde había dolor y un driver que lo exigiera.
Paso 4 · La factura

Qué nos cuesta esta decisión

Regla del tallerSi su ADR no dice qué pagan, está incompleto. Ninguna decisión de arquitectura es gratis.
Paso 5 · Escribimos el ADR · parte 1

Contexto, drivers y decisión

ADR demo · parte 1 de 2
# ADR-001 · Separar cartelera y reportes del monolito de CineYa
Fecha: 4 de agosto de 2026 · Equipo: demo en clase

## Contexto
Monolito con base de datos unica. En estrenos cae todo el sistema,
incluida la cartelera (solo lectura). Los reportes gerenciales
compiten con la venta en vivo. Cambiar una promocion obliga a
redesplegar pagos.

## Drivers que mandan
- Disponibilidad: cartelera arriba 99,9% incluso en estrenos.
- Desempeno: compra completa en menos de 3 s en hora pico.
- Modificabilidad: publicar promociones sin tocar pagos.
- Restriccion: equipo de 5 personas, presupuesto limitado.

## Decision
1. Extraer CARTELERA como servicio independiente con cache.
2. Mover REPORTES a una replica de lectura.
3. Mantener SILLAS y PAGOS juntos: exigen consistencia fuerte.
4. No tocar NOTIFICACIONES: hoy no duele.
Paso 5 · Escribimos el ADR · parte 2

Alternativas, factura y verificación

ADR demo · parte 2 de 2
## Alternativas consideradas
Partir todo en microservicios: descartada. Con 5 personas no se
pueden operar 6 despliegues, y sillas y pagos se hablan en cada
compra.

## Consecuencias
Ganamos: la cartelera sobrevive a los picos; los reportes dejan
de frenar la venta; las promociones se publican sin tocar pagos.
Pagamos: cache por sincronizar (datos con segundos de retraso),
dos despliegues mas que operar y el costo de la replica.

## Como sabremos si acertamos
En 3 meses: cero caidas de cartelera en estrenos y tiempo de
compra por debajo de 3 segundos en hora pico.
Una página, cinco camposEse es el nivel que espero en el taller. Ni más largo ni más vago.
Antes de soltarlos

Los cuatro errores que no quiero ver

1
Decidir sin drivers Si no dicen qué manda, la decisión es capricho técnico.
2
"Lo partimos en microservicios" Sin decir qué cuesta. Eso no es decisión: es moda.
3
Consecuencias solo buenas Si el campo "Pagamos" está vacío, el ADR está incompleto.
4
Métrica de humo "Mejorará el rendimiento" no sirve. Número y fecha.
Taller final

El Consejo
de Arquitectura

Mismo procedimiento que acabamos de hacer, pero ahora con su caso y sin mí.

Cómo funciona · exactamente lo que hicimos en el demo

Los cinco pasos

  1. Drivers — escriban los 3 o 4 que mandan en su caso. 7 min
  2. Diagnóstico — la prueba del cambio sobre los síntomas. 8 min
  3. Decisión — qué separan, qué dejan junto, qué NO tocan. 7 min
  4. ADR — llenan la plantilla, incluida la factura. 10 min
  5. Consejo — sustentan 3 min · otro grupo ataca 90 s. 15 min
Regla de oro: no se acepta "microservicios" sin factura.
Cómo se evalúa · cuenta en el 50% de dinámicas

Qué estoy calificando

CriterioPesoQué observo
Drivers25%Identifican los que mandan, con número y tipo. No confunden requisito con driver.
Diagnóstico25%Encuentran el acoplamiento que duele, con la prueba del cambio.
Decisión con factura25%Dicen qué ganan y qué pagan.
ADR y defensa25%Documento completo y sostienen la decisión bajo ataque.
Casos · grupos 1 y 2

Los sistemas que duelen

Caso A · Fintech "Bolsillo"

App de pagos, 2M de usuarios. Monolito, una sola base de datos.

Síntomas: cada despliegue apaga la app 40 min · los días 15 y 30 el pico tumba todo, incluida la consulta de saldo · fraude y transferencias los toca el mismo equipo y siempre chocan.

Caso B · Delivery "YaLlegó"

Domicilios en 8 ciudades. Catálogo, pedidos, pagos y GPS en un solo programa.

Síntomas: el GPS actualiza cada 3 s y consume el 70% de los recursos · al almuerzo ver el menú se vuelve lento · cambiar una promoción obliga a redesplegar pagos.

Casos · grupos 3 y 4

Los sistemas que duelen

Caso C · EPS "SaludYa"

Agendamiento de citas. Ya está partido en 14 microservicios.

Síntomas: agendar dispara 11 llamadas de red y tarda 9 s · si notificaciones se cae, no se puede agendar · 6 personas mantienen 14 despliegues · la factura de nube subió 300%.

Caso D · Retail "Tienda Norte"

E-commerce con 40 tiendas. Monolito de 12 años, funcionando.

Síntomas: el inventario de tienda y el de web se desincronizan y venden lo que no hay · el Black Friday exige triplicar todo aunque solo el catálogo se satura · nadie toca precios porque no hay pruebas.

Casos · grupos 5 y 6

Los sistemas que duelen

Caso E · Universidad "Campus+"

Matrícula, notas, biblioteca y pagos en un mismo sistema.

Síntomas: una semana al semestre el tráfico se multiplica por 60 y colapsa · el resto del año se paga capacidad ociosa · notas no se puede actualizar en matrículas.

Caso F · Logística "CargaSegura"

Rastreo de camiones. Tres servicios escriben en la misma tabla.

Síntomas: cambiar una columna exige coordinar tres equipos y dos semanas · los reportes bloquean la operación en vivo · nadie sabe quién es el dueño del dato.

Capa 2 · dentro del taller

Prueben la IA y audítenla

Antes de cerrar su ADR, pídanle a una IA que resuelva su caso. Después la califican ustedes.

Soy arquitecto de software. Mi sistema tiene estos sintomas: [pega los tres]. Como lo rediseñarias?
Que cuesta tu propuesta? Se especifico en latencia, consistencia de datos y costo de operacion.
Va en su sustentaciónUna línea: ¿la IA propuso separar sin calcular la factura? ¿Preguntó por el tamaño del equipo o lo asumió?
Antes de entregar

Chequeo rápido

EntregaUn archivo por grupo, con nombres completos, por el canal del curso al terminar la clase.
Cierre

Se llevan tres ideas

La próxima clase: hoy vimos los estilos (la forma global). Sigue el nivel de abajo: patrones arquitectónicos y patrones de diseño.
Para repasar

Glosario de la clase

Todos los términos con botón que vieron hoy. Si alguno no les quedó claro, este es el momento.

Del negocio

Driver · atributo de calidad · restricción · escenario de calidad · ISO 25010 · ADR

De la estructura

Módulo · cohesión · acoplamiento · estilo · patrón arquitectónico · patrón de diseño

De la operación

Proceso · despliegue · API · REST · HTTPS · latencia · caché · réplica de lectura · consistencia

Tarea silenciosaSi hay uno solo de estos que no podrían explicarle a un compañero, búsquenlo hoy mismo. Son el idioma de su profesión.
Tarea · martes 11 de agosto

Un acoplamiento de la vida real

Traigan un ejemplo real de acoplamiento que duela: de un trabajo, de otra materia, de una app que usen o de un caso público.

Formato60 segundos al inicio de la próxima clase. Cuenta para participación.
← Portal
← → o el apuntador para avanzar · F pantalla completa · clic en los términos azules
1 / 69