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.
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..
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.
Un driver arquitectónico es un requisito que tiene influencia significativa sobre la estructura del sistema. Si lo cambias, la arquitectura tiene que cambiar.
"El saldo debe consultarse en menos de 2 segundos con 50.000 usuarios simultáneos."
Obliga a decidir caché, réplicas y separación.
"El botón de consultar saldo debe ser azul."
Es un requisito real y válido, pero no cambia ninguna estructura.
"Ser la app de pagos con menos quejas del país."
"Consultar saldo debe funcionar 99,9% del tiempo, incluso en quincena."
"Separamos consulta de saldo del resto y la replicamos."
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.
Cómo debe comportarse. Rápido, disponible, seguro, modificable. Son los que más moldean la arquitectura. Ej.: "responder en menos de 2 s".
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".
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:
| Atributo | La 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? |
"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.
"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.
Así se escribe un atributo de calidad de forma profesional. Seis campos, ninguno opcional:
| Parte | Qué es | Ejemplo |
|---|---|---|
| Fuente | Quién genera el estímulo | Un usuario de la app |
| Estímulo | Qué ocurre | Consulta su saldo |
| Entorno | En qué condiciones | Día de quincena, 50.000 usuarios |
| Artefacto | Qué parte se ve afectada | El servicio de saldo |
| Respuesta | Qué hace el sistema | Devuelve el saldo actualizado |
| Medida | El número que lo hace verificable | Menos de 2 s en el 99% de casos |
Son decisiones que ya vienen tomadas. El arquitecto no las discute: las recibe y diseña con ellas.
"Debe correr sobre la base de datos Oracle que ya compramos."
"Presupuesto de nube: 5 millones al mes, no más."
"Los datos personales no pueden salir del país."
Un sistema real tiene cientos de requisitos. El arquitecto solo puede trabajar con un puñado. Se eligen con tres criterios:
"Priorizar con criterio" no es intuición: existen métodos. Estos tres son los más usados.
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.
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ó.
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.
Caso: la app de pagos "Bolsillo". Cada escenario recibe (Negocio, Dificultad):
| Escenario de calidad | Negocio | Dificultad | ¿Driver? |
|---|---|---|---|
| Consultar saldo en menos de 2 s con 50.000 usuarios en quincena | Alta | Alta | SÍ — decide el diseño |
| Si un servidor cae, el servicio vuelve en menos de 30 s | Alta | Alta | SÍ |
| Cambiar el color del tema de la app en un día | Baja | Baja | No |
| Exportar el historial a Excel | Media | Baja | No — es fácil, se resuelve luego |
| Soportar 12 idiomas | Baja | Alta | No hoy — difícil pero al negocio no le urge |
Les leo un requisito. Ustedes responden dos cosas, gritando desde el puesto:
| # | 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'." |
Mucha gente los mezcla y por eso habla mal de arquitectura. Ubíquense:
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.
Solución probada a un problema estructural recurrente, dentro de un estilo. Ej.: MVC, publicador-suscriptor, broker. Clase 4.
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.
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.
¿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.
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.
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.
Esto no lo inventó nadie en un blog. Son tres tradiciones con obras de referencia:
| Nivel | Obra que lo estableció | Ejemplos que trae |
|---|---|---|
| Estilo arquitectónico | Shaw & Garlan (1996) Software Architecture: Perspectives on an Emerging Discipline | Tubería y filtros, capas, repositorio, cliente-servidor |
| Patrón arquitectónico | Buschmann y otros (1996) Pattern-Oriented Software Architecture (POSA) | Capas, broker, MVC, publicador-suscriptor |
| Patrón de diseño | Gamma, Helm, Johnson y Vlissides (1994) Design Patterns — el "GoF" | Singleton, Observer, Factory, Strategy |
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.
Los tipos de pieza que existen y las reglas de cómo pueden hablarse.
El lenguaje, el framework ni el código. Un mismo estilo se implementa en Java, Python o Go.
De problemas resueltos miles de veces. Nadie inventa un estilo: lo elige.
Hoy vamos a estudiar tres a fondo, pero para que no queden con una idea incompleta, estos son otros estilos igual de vigentes:
| Estilo | Idea central | Dónde se ve |
|---|---|---|
| Por capas | Presentación → lógica → datos, cada capa habla solo con la vecina | Sistemas empresariales, ERP |
| Cliente-servidor | Un servidor central atiende a muchos clientes | Casi toda la web |
| Orientado a eventos | Las piezas reaccionan a hechos, no a llamadas | Banca transaccional, IoT |
| Tubería y filtros | El dato pasa por etapas que lo transforman | Procesamiento de datos, ETL |
| Microkernel / plugins | Un núcleo mínimo y extensiones | VS Code, navegadores |
| Serverless | Funciones que se ejecutan por demanda, sin servidor propio | Cargas intermitentes |
| Monolito · modular · microservicios | Cómo se reparte y despliega el sistema completo | Los tres de hoy |
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.
Simple de arrancar · rápido, todo se habla por memoria · fácil de desplegar al principio.
Todo sube junto · un error puede tumbarlo todo · escalar una parte obliga a escalar el resto.
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.
Orden, y equipos que no se pisan · sigue siendo rápido, memoria y no red · barato de operar.
Sigue habiendo un solo punto de falla · sigue subiendo todo junto.
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.
Se despliega y se escala cada pieza sola · si una falla, las demás siguen · equipos autónomos.
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.
| Factor | Monolito | Modular | Microservicios |
|---|---|---|---|
| Fronteras internas | Difusas | Claras | Claras y físicas |
| Despliegue | Todo junto | Todo junto | Independiente |
| Si algo falla | Cae todo | Afecta al proceso | Se aísla |
| Velocidad interna | Memoria (rápida) | Memoria (rápida) | Red (lenta) |
| Base de datos | Compartida | Compartida | Una por servicio |
| Escalar una parte | Imposible | Imposible | Sí |
| Costo de operar | Bajo | Bajo | Alto |
| Equipo mínimo viable | 1–5 personas | 5–30 personas | Varios equipos |
| Cuándo brilla | Producto nuevo, validar rápido | Producto maduro, un equipo grande | Muchos equipos, cargas muy distintas |
| Empresa | Estilo | Por qué le funciona |
|---|---|---|
| Stack Overflow | Monolito | Carga alta pero predecible y un solo dominio. Pocos servidores, equipo pequeño, costo mínimo. |
| Shopify | Modular | Un producto, muchos equipos. Necesita orden interno, no despliegues separados. 30 TB/min en Black Friday. |
| Rappi 🇨🇴 | Microservicios | Superapp: domicilios, pagos, viajes. Cada vertical evoluciona a su ritmo sin tocar el core de despachos. |
| Nequi 🇨🇴 | Microservicios + serverless | Nació en la nube. Picos transaccionales enormes y despliegues quincenales sin frenar el negocio. |
| Bancolombia 🇨🇴 | Híbrido | Core bancario en infraestructura propia + capa digital moderna. Lo viejo no siempre se bota: se rodea. |
| Netflix | Microservicios | Tráfico global, cientos de equipos autónomos, tolerancia a fallos como requisito de vida o muerte. |
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.
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.
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.
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.
¿Qué tan relacionado está lo que puse dentro de un módulo?
La quiero ALTA. Un módulo, una razón de existir.
¿Qué tanto depende este módulo de otros?
Lo quiero BAJO. Cambiar aquí no debería obligar a cambiar allá.
| Síntoma | Qué está pasando |
|---|---|
Se llama utils o helpers | Nadie 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 archivos | La lógica de un concepto quedó regada. |
| Dos equipos editan siempre el mismo archivo | La frontera no coincide con el equipo. |
Nadie busca acoplamiento cero: sería un sistema donde nada se comunica. Se busca el mínimo que el problema permita.
Tres preguntas frente a cualquier decisión. Es todo lo que necesitan hoy.
Despliegue independiente · aislamiento de fallos · escalar solo lo que lo necesita · equipos autónomos.
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.
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:
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.
Separa donde el cambio y la carga son distintos.
Junta donde la conversación es intensa y constante.
El monolito modular es una arquitectura respetable.
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.
Al volver: abran su computador. Vamos a resolver un caso completo juntos, paso a paso.
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.
# 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
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í.
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 usuarios y el negocio nunca dicen drivers: dicen quejas. Traducirlas es trabajo del arquitecto, y se hace con tres preguntas en orden:
| Lo que dice el equipo (queja) | Atributo | Driver resultante |
|---|---|---|
| "En estrenos se cae todo, hasta ver la cartelera" | Disponibilidad | La cartelera responde el 99,9% del tiempo, incluso en estrenos. |
| "Los reportes vuelven lenta la venta" | Desempeño | Comprar una boleta se completa en menos de 3 s en hora pico. |
| "Cambiar una promo obliga a redesplegar pagos" | Modificabilidad | Publicar una promoción sin tocar el módulo de pagos. |
| "Somos 5 y no damos abasto" | — | Restricción: equipo de 5 personas, presupuesto limitado. |
Antes de tocar la estructura, escribimos los drivers. Sin esto, cualquier decisión es capricho.
| Tipo | Driver |
|---|---|
| Disponibilidad | La cartelera debe responder el 99,9% del tiempo, incluso en estrenos. |
| Desempeño | Comprar una boleta debe completarse en menos de 3 s en hora pico. |
| Funcional | Reservar silla y cobrar deben ocurrir como una sola operación. |
| Restricción | Equipo de 5 personas. No hay presupuesto para más infraestructura grande. |
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.
| Pregunta | Respuesta 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. |
No es intuición. Una pieza se separa si cumple al menos dos de estas cuatro señales:
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.
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.
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..
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.
# 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.
## 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.
Mismo procedimiento que acabamos de hacer, pero ahora con su caso y sin mí.
| Criterio | Peso | Qué observo |
|---|---|---|
| Drivers | 25% | Identifican los que mandan, con número y tipo. No confunden requisito con driver. |
| Diagnóstico | 25% | Encuentran el acoplamiento que duele, con la prueba del cambio. |
| Decisión con factura | 25% | Dicen qué ganan y qué pagan. |
| ADR y defensa | 25% | Documento completo y sostienen la decisión bajo ataque. |
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.
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.
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%.
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.
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.
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.
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.Todos los términos con botón que vieron hoy. Si alguno no les quedó claro, este es el momento.
Driver · atributo de calidad · restricción · escenario de calidad · ISO 25010 · ADR
Módulo · cohesión · acoplamiento · estilo · patrón arquitectónico · patrón de diseño
Proceso · despliegue · API · REST · HTTPS · latencia · caché · réplica de lectura · consistencia
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.