Glosario
Los términos del curso con una definición breve, ordenados por parte del curso. Siguen la regla de la guía de estilo:
- Un término técnico se deja en inglés cuando su traducción suena forzada, como lo dicen los equipos de desarrollo en el Perú y como aparece en los libros del curso, en la documentación y en las ofertas de trabajo (trade-off, sharding, circuit breaker, broker). Esas entradas están en inglés y se explican en español.
- Los que de verdad se usan en español (atributo de calidad, disponibilidad, replicación, cola) van en español, con el término en inglés entre paréntesis.
Las definiciones son las de las guías y los apuntes de cada semana, que citan sus fuentes. Cada término está en la parte donde el curso lo trata por primera vez; si una semana posterior lo desarrolla, la definición lo dice.
Herramientas
| Término | Definición |
|---|---|
| Tinkuy | La plataforma de venta de entradas para conciertos y partidos que escribimos para el curso (tinkuy quiere decir encuentro en quechua). Empieza como un monolito pequeño en TypeScript con PostgreSQL; es el ejemplo de los laboratorios y el sistema que el proyecto rediseña seis veces. |
| Node.js | El entorno que ejecuta el código del curso (versión 26): corre archivos .ts directamente porque quita los tipos al cargar, sin revisarlos. El servidor es node:http y las pruebas usan node:test, sin frameworks. |
| TypeScript | El lenguaje del curso. Los tipos los revisa tsc --noEmit con strict: true; como Node.js solo los quita, no se usan las construcciones que generan código (enum, namespace). |
| PostgreSQL | La base de datos relacional del curso (versión 18), en el puerto 5432. Tinkuy usa las bases de datos tinkuy y tinkuy_test, y cada semana usa la suya (arq_wNN). |
| Redis | El almacén clave-valor en memoria que usamos como cache compartida, en el puerto 6379. En el contenedor corre sin persistencia: si se reinicia, queda vacío. |
| NATS JetStream | El broker del curso, en el puerto 4222. Un stream guarda los mensajes de un conjunto de subjects y un consumer lleva la posición y las confirmaciones de quien lee; según la configuración se comporta como log o como cola. |
| k6 | La herramienta de pruebas de carga: un script simula usuarios y el resumen reporta la latencia por percentiles (http_req_duration), la cantidad de peticiones (http_reqs) y los errores (http_req_failed). |
| Toxiproxy | Un proxy que se pone entre dos procesos para inyectar fallas de red a pedido: latencia, cortes, conexiones que se caen. Se inicia con svc start toxiproxy y se maneja con toxiproxy-cli; en el curso va entre Tinkuy y la pasarela de pagos. |
| dependency-cruiser | La herramienta que lee los imports y comprueba las reglas de dependencia escritas en .dependency-cruiser.cjs. Su comando es depcruise (make deps en Tinkuy), y termina con error si hay una violación. |
svc |
El comando del contenedor que maneja los servicios: svc status dice qué está corriendo, svc start y svc stop inician y detienen, y svc kill redis mata un servicio sin aviso, como en una caída real. |
pg-replica |
El comando que crea y maneja una réplica de PostgreSQL dentro del mismo contenedor, en el puerto 5433: create (copia el principal con pg_basebackup), stop, start, promote, lag y destroy. |
| Contenedor del curso | La imagen de Docker donde se hace todo el trabajo práctico (se abre con env/run.sh): Node.js 26, PostgreSQL 18, Redis, NATS con JetStream, k6, Toxiproxy, tsc y dependency-cruiser. PostgreSQL, Redis y NATS arrancan con el contenedor, y no se descarga nada con npm. |
Parte 1 — Fundamentos y atributos de calidad
| Término | Definición |
|---|---|
| Arquitectura (architecture) | El conjunto de estructuras necesarias para razonar sobre un sistema; cada estructura tiene elementos, relaciones y propiedades (Bass, Clements y Kazman). También: las decisiones que uno quisiera acertar temprano porque cuesta cambiarlas (Fowler). |
| Estructura de módulos (module structure) | Uno de los tres tipos de estructuras de una arquitectura. Cómo se divide el código: qué depende de qué y quién es owner de qué. Responde “¿qué toca un cambio?”. |
| Estructura de componentes y conectores (component-and-connector structure) | Lo que existe mientras el sistema corre (procesos, bases de datos) y cómo se comunican. Responde “¿qué pasa con la latencia y con las fallas?”. Tinkuy tiene cinco módulos y un solo componente. |
| Estructura de asignación (allocation structure) | En qué máquinas, repositorios y equipos cae cada cosa. Responde “¿quién lo construye y dónde corre?”. |
| Requisito significativo para la arquitectura (architecturally significant requirement, ASR) | Un requisito que, si cambiara, cambiaría la arquitectura. Casi nunca dice qué hace el sistema: dice cuánto, qué tan rápido, con qué frecuencia cambia o qué pasa si falla. |
| stakeholder | Toda persona con interés en el sistema, no solo quien lo usa: en Tinkuy, compradores, organizadores, soporte, quien lo opera, el equipo que lo mantiene, la pasarela de pagos. Cada uno pide atributos distintos. |
| Restricción (constraint) | Una decisión que ya viene tomada: el lenguaje que conoce el equipo, el presupuesto, una ley, la pasarela con la que el negocio ya firmó. No se negocia; se diseña dentro de ella. |
| C4 | El modelo de Simon Brown para dibujar una arquitectura con cuatro niveles de zoom: contexto, contenedores, componentes y código. Toda caja dice qué es y con qué tecnología; toda flecha, qué lleva y por qué protocolo. |
| Diagrama de contexto (context diagram) | El primer nivel de C4: el sistema como una caja, las personas que lo usan y los sistemas externos (en Tinkuy, la pasarela de pagos y el servidor de correo). |
| Diagrama de contenedores (container diagram) | El segundo nivel de C4: lo que tiene que estar corriendo o existir para que el sistema funcione (el proceso de Node.js, la base de datos). Un contenedor de C4 es cualquier cosa que se ejecuta o guarda datos por separado; no es lo mismo que un contenedor de Docker. |
| Atributo de calidad (quality attribute) | Una propiedad medible del sistema que indica qué tan bien satisface a sus stakeholders, más allá de lo que hace: disponibilidad, rendimiento, modificabilidad, seguridad. Son los que determinan la arquitectura. |
| Escenario (scenario) | Un atributo de calidad escrito de forma que se pueda comprobar, con seis partes: fuente del estímulo, estímulo, artefacto, entorno, respuesta y medida de la respuesta. Sin medida no es un escenario. |
| Disponibilidad (availability) | La fracción del tiempo en que el sistema responde bien. 99,9 % permite unas 8,8 horas caído al año. En serie se multiplica: tres servicios de 99,9 % dan 99,7 %. |
| Latencia (latency) | Cuánto tarda una petición en recibir su respuesta. Es una distribución, no un número: la misma petición tarda distinto cada vez, y por eso se reporta con percentiles. |
| throughput | Cuántas peticiones atiende el sistema por unidad de tiempo. |
| Percentil (percentile) | El valor por debajo del cual cae un porcentaje de las mediciones: p50 es la mediana, y p95 es el tiempo que el 95 % de las peticiones no supera. No se promedian entre máquinas. |
| Umbral (threshold) | La medida de un escenario escrita en el script de k6, por ejemplo http_req_duration: ['p(95)<300']. Si no se cumple, k6 termina con código distinto de cero: el escenario queda convertido en una prueba. |
| utility tree | El árbol que prioriza los escenarios: la raíz es “utilidad”, debajo van los atributos y sus refinamientos, y en las hojas los escenarios, cada uno con dos notas (A, M o B): valor para el negocio y dificultad técnica. Los (A, A) definen la arquitectura. |
| trade-off | Lo que se sacrifica al decidir: mejorar un atributo suele costar otro. Una cache mejora la latencia y complica la consistencia. |
| Módulo (module) | Una unidad de código con una responsabilidad y una interfaz. En Tinkuy, las carpetas de src/: catalog, orders, payments, notifications y reports. |
| Interfaz (interface) | Todo lo que los demás pueden suponer sobre un módulo. Lo que no está en la interfaz se puede cambiar sin avisar. En el curso, la interfaz pública de un módulo es lo que exporta su index.ts. |
| Modificabilidad (modifiability) | Qué tan barato es cambiar el sistema. Se mide con un cambio probable: cuántos módulos hay que tocar y cuánto toma (“agregar un medio de pago toca un solo módulo y toma menos de dos días”). |
| Criterio de Parnas | Dividir un sistema por lo que puede cambiar, no por el orden en que se ejecuta: cada módulo esconde una decisión de diseño (Parnas, 1972). |
| Ocultamiento de información (information hiding) | Que un módulo esconda sus decisiones internas detrás de su interfaz. Un módulo que expone sus tablas, sus tipos internos o su orden de llamadas no esconde nada. |
| Cohesión (cohesion) | Qué tan relacionadas están las cosas dentro de un módulo. Un módulo cohesivo tiene una sola razón para cambiar; nombres como utils o common son señal de lo contrario. |
| Acoplamiento (coupling) | Cuánto debe saber un módulo de otro. Depender de una función pública estable es barato; depender del esquema de las tablas de otro módulo o del orden en que hace las cosas es caro. |
| connascence | Un vocabulario para las formas de acoplamiento: de nombre, de tipo, de significado, de posición, de algoritmo, de tiempo. Cuanto más fuerte y más lejos, peor. |
| Grafo de dependencias (dependency graph) | Un nodo por módulo y una flecha de A a B si A depende de B. Es la estructura de módulos hecha visible, y se calcula a partir del código. |
| Ciclo (dependency cycle) | A depende de B y B depende de A: ninguno se puede entender, probar ni desplegar sin el otro. En Tinkuy, catalog y orders se importan mutuamente. |
| Inversión de dependencias (dependency inversion) | El módulo de más alto nivel declara la interfaz que necesita y el de más bajo nivel la implementa. La dependencia en el código apunta hacia el núcleo aunque la llamada, al ejecutarse, vaya hacia afuera. |
| Arquitectura hexagonal (hexagonal architecture) | La organización de Cockburn, también llamada ports y adapters: el núcleo de la aplicación no importa nada de afuera, así que se puede probar sin base de datos. |
| port | Una interfaz que el núcleo define: lo que ofrece o lo que necesita de afuera (PaymentGateway, Clock, SeatRepository). |
| adapter | El código que conecta un port con una tecnología concreta: HTTP, PostgreSQL o la pasarela real. Cambiar de pasarela es escribir otro adapter. |
| dependency injection | Crear el adapter fuera del núcleo y pasárselo como parámetro. No hace falta un framework. |
| Regla de dependencia (dependency rule) | Una regla sobre qué puede importar a qué, escrita para que una herramienta la compruebe en cada build: en Tinkuy, no-circular, http-does-not-touch-db y modules-only-through-index. |
Parte 2 — Estilos, tácticas y decisiones
| Término | Definición |
|---|---|
| Estilo de arquitectura (architectural style) | Un conjunto de tipos de elementos, de formas de conectarlos y de restricciones, con propiedades conocidas. Describe la forma global del sistema; no hay uno mejor, cada uno favorece unos atributos y perjudica otros. |
| Patrón (pattern) | Una solución a un problema local dentro del sistema. Empaqueta varias tácticas. |
| Monolito (monolith) | Un sistema con una sola unidad de despliegue. Es una decisión de despliegue, no de orden interno: da llamadas locales y transacciones simples, y a cambio todo se despliega y se escala junto. |
| Arquitectura en capas (layered architecture) | El estilo que parte el sistema por rol técnico (presentación, dominio, datos), donde cada capa usa solo la de abajo. Es simple y conocida; un cambio de negocio atraviesa todas las capas. |
| modular monolith | Un solo despliegue con módulos por dominio, cada uno con interfaz pública y con sus propios datos: sus tablas no las lee otro módulo con SQL propio. Es lo que P1 hace con Tinkuy. |
| pipeline | El estilo de pipes y filtros: filtros que transforman datos y pipes que los llevan de uno al otro. Cada filtro solo conoce el formato de entrada y de salida. |
| microkernel | El estilo de un núcleo mínimo y estable al que se le agregan variantes como plug-ins. Da modificabilidad en un eje concreto, que hay que adivinar bien. |
| plug-in | Un componente que agrega una variante sin tocar el núcleo ni las demás variantes. En Tinkuy, cada medio de pago (card, yape, plin) implementa PaymentMethod. |
| Contrato (contract) | La interfaz que el núcleo define para sus plug-ins, o un servicio para quienes lo llaman. Es difícil de cambiar una vez que otros dependen de él. |
| big ball of mud | Un sistema sin estructura reconocible. No se llega por una decisión, sino por muchas pequeñas sin nadie que cuide los límites. |
| Falacias de la computación distribuida (fallacies of distributed computing) | Ocho supuestos falsos sobre la red: es confiable, la latencia es cero, el ancho de banda es infinito, es segura, la topología no cambia, hay un solo administrador, el transporte no cuesta y es homogénea. |
| service-based | El estilo de pocos servicios grandes (de cuatro a doce, por dominio), desplegados por separado y normalmente con una base de datos compartida. Es el paso más barato desde un modular monolith. |
| Microservicio (microservice) | Un servicio pequeño, con un solo propósito y con sus propios datos, que se despliega y se escala por separado y es de un equipo. |
| bounded context | Un modelo del dominio con significado propio. Es el límite natural de un microservicio. |
| API gateway | Una entrada única delante de los servicios, que enruta, autentica y limita. |
| Monolito distribuido (distributed monolith) | Servicios que comparten tablas, que deben desplegarse juntos o que se llaman en cadena de forma síncrona: tienen los costos de un sistema distribuido y los de un monolito, y los beneficios de ninguno. |
| Evento (event) | Un mensaje que dice que algo ya pasó (OrderPaid). Quien lo publica no sabe quién lo escucha, y un evento no se rechaza. |
| Comando (command) | Un mensaje que pide que algo pase (ChargeCard). Va dirigido a alguien de quien se espera un resultado, y puede rechazarse. |
| event-driven | El estilo en que los componentes reaccionan a eventos en vez de llamarse. Se gana desacoplamiento en el tiempo y capacidad de absorber picos; se paga con consistencia eventual y flujos difíciles de seguir. |
| Topología broker | La variante de event-driven sin coordinador: cada componente escucha eventos y publica otros, en cadena. Muy desacoplada; nadie tiene el flujo completo. |
| mediator | La variante de event-driven con un coordinador que conoce el flujo y envía comandos a cada paso. Se gana control y manejo de errores; se paga con el acoplamiento al coordinador. |
| Táctica (tactic) | Una decisión de diseño que influye sobre la respuesta a un estímulo de un atributo de calidad. Es más pequeña que un patrón y afecta a un solo atributo; su efecto sobre los demás es el trade-off. |
| Pool de conexiones (connection pool) | Un conjunto de conexiones abiertas a la base de datos que se reutilizan. Evita el costo de abrir una por petición y, además, pone un tope a la concurrencia sobre la base de datos. |
| N+1 | Una consulta para la lista y una más por cada elemento. En Tinkuy, GET /events hace un COUNT por evento. |
| Escalar hacia arriba y hacia los lados | Hacia arriba: una máquina más grande. Hacia los lados: más copias del servicio detrás de un load balancer. |
| Falta (fault) | La causa de un problema: un disco dañado, un bug, una pasarela que no responde. |
| Falla (failure) | Lo que ve quien usa el sistema cuando este deja de cumplir su especificación. La disponibilidad se diseña para que las faltas no lleguen a ser fallas, o para que duren poco. |
| Redundancia (redundancy) | Tener más de una copia de un componente para recuperarse si una falla. Puede ser activa, pasiva o de repuesto. |
| Degradación (degradation) | Seguir ofreciendo lo esencial cuando una parte falla. En Tinkuy, si el correo no responde, la compra se completa y el correo sale después. |
| Seguridad (security) | El atributo que protege la confidencialidad, la integridad y la disponibilidad frente a un ataque. Su medida: cuánto daño, cuánto tarda en detectarse y cuánto en recuperarse. |
| Mínimo privilegio (least privilege) | Principio de Saltzer y Schroeder: cada componente tiene solo los permisos que necesita para su trabajo. |
| Límite de confianza (trust boundary) | La frontera entre lo que el sistema controla y lo que no; lo que la cruza se valida. Es estructura, y por eso no se agrega al final. |
| Vista (view) | La representación de una estructura, hecha para un lector. Lleva el diagrama principal, el catálogo de elementos, la leyenda y la justificación. |
| Diagrama de componentes (component diagram) | El tercer nivel de C4: las partes de un contenedor. |
| arc42 | Un template de doce secciones para el documento de arquitectura completo, desde los objetivos y las restricciones hasta los riesgos y el glosario. Se llena lo que alguien va a leer. |
| ADR (architecture decision record) | Un documento corto por decisión, numerado y guardado en el repositorio, con contexto, decisión, estado y consecuencias; el curso agrega las alternativas descartadas. No se reescribe: si la decisión cambia, otro ADR lo reemplaza. |
| ADD (attribute-driven design) | Diseño guiado por atributos: un método por iteraciones que parte de los escenarios más importantes, elige qué elemento refinar y con qué conceptos de diseño, y registra las decisiones. |
| ATAM (Architecture Tradeoff Analysis Method) | Un método de nueve pasos para evaluar una arquitectura frente a sus escenarios, con quienes la diseñaron y los stakeholders. No dice si es buena ni da números: dice dónde mirar. |
| Riesgo y no riesgo (risk, non-risk) | Un riesgo es una decisión que puede impedir un escenario; un no riesgo, una que se analizó y está bien. Un tema de riesgo es lo que varios riesgos tienen en común. |
| Punto de sensibilidad (sensitivity point) | Una decisión de la que depende mucho la respuesta de un atributo. En Tinkuy, llamar a la pasarela dentro de la transacción lo es para la latencia. |
| Punto de trade-off (trade-off point) | Una decisión que afecta a dos atributos en sentidos opuestos. En Tinkuy, el TTL de la cache del catálogo: rendimiento contra actualidad de los datos. |
Parte 3 — Datos y sistemas distribuidos
| Término | Definición |
|---|---|
| OLTP | El uso transaccional de una base de datos: muchas operaciones pequeñas, por clave, de usuarios que esperan. Importan la latencia y la exactitud. |
| OLAP | El uso analítico: pocas consultas grandes que recorren millones de filas. Importa el throughput. |
| Sistema de registro (system of record) | La única fuente de verdad de un dato. En Tinkuy, la tabla de órdenes. |
| Dato derivado (derived data) | Un dato que se puede reconstruir a partir del sistema de registro: una cache, un índice, una vista materializada, un reporte. Saber cuál es cuál decide qué se puede perder. |
| Escalabilidad (scalability) | No es una propiedad sino una pregunta: si la carga crece de esta manera, ¿qué opciones hay? Se empieza por describir la carga con sus parámetros. |
| Compatibilidad hacia atrás (backward compatibility) | El código nuevo puede leer datos escritos por el viejo. |
| Compatibilidad hacia adelante (forward compatibility) | El código viejo puede leer datos escritos por el nuevo: tiene que ignorar lo que no conoce sin destruirlo. Importa en todo despliegue gradual. |
| Ley de Hyrum (Hyrum’s law) | Con suficientes usuarios, alguien depende de cada comportamiento observable de un sistema, esté o no en el contrato. |
| Expandir, migrar y contraer (parallel change) | La secuencia para cambiar un esquema o un contrato sin detener nada: agregar lo nuevo junto a lo viejo, mover los datos y a quienes leen, y quitar lo viejo cuando nadie lo usa. |
| Replicación (replication) | Mantener los mismos datos en varias máquinas, para seguir funcionando si una falla, atender más lecturas o tener los datos cerca de quien los usa. |
| Líder y seguidor (leader, follower) | El líder es el nodo que acepta las escrituras y las envía en orden a los seguidores, que las aplican en el mismo orden y solo aceptan lecturas. En el curso, el seguidor es la réplica de PostgreSQL que crea pg-replica. |
| WAL | El log de escritura anticipada (write-ahead log): donde la base de datos anota cada cambio antes de aplicarlo. En PostgreSQL, es lo que el líder envía a los seguidores. |
| Replicación síncrona y asíncrona | Síncrona: el líder espera la confirmación del seguidor antes de responder; no se pierde lo confirmado, y cada escritura paga esa espera. Asíncrona: responde sin esperar; es rápida, y lo confirmado en los últimos instantes puede perderse. |
| Retraso de replicación (replication lag) | El tiempo entre que el líder confirma una escritura y el seguidor la aplica. Mientras dure, leer de un seguidor es leer el pasado. |
| Consistencia eventual (eventual consistency) | Si se deja de escribir, todas las copias terminan por coincidir, sin decir cuándo. |
| read-your-writes | La garantía de que un usuario ve lo que él mismo acaba de escribir: quien compra ve su compra. Se consigue leyendo del líder lo propio, o esperando a que el seguidor alcance la posición de la escritura. |
| failover | Promover a un seguidor cuando el líder falla: detectar la falla, elegir al nuevo líder y redirigir a los clientes. Con replicación asíncrona puede perder escrituras confirmadas. |
| split brain | Dos nodos que creen ser el líder y aceptan escrituras a la vez. |
| Replicación con varios líderes (multi-leader replication) | Más de un nodo acepta escrituras y las replica a los demás. Sirve para varios centros de datos o para trabajar sin conexión; el precio son los conflictos. |
| Replicación sin líder (leaderless replication) | El cliente envía cada escritura a varias réplicas y lee de varias. Una réplica que estuvo caída se pone al día al leer (read repair) o con un proceso de fondo (anti-entropía). |
| Quórum (quorum) | Con n réplicas, una escritura se confirma con w y una lectura consulta r. Si w + r > n, los dos conjuntos se solapan en al menos una réplica, así que alguna respuesta trae el valor más reciente. |
| tombstone | Una marca de borrado que se replica como cualquier otro valor, para que una réplica que estuvo caída no resucite el dato borrado. |
| sharding | Repartir datos distintos entre máquinas, cuando los datos o las escrituras ya no caben en una. Es la táctica de escalabilidad más cara: complica las consultas y las transacciones, y casi no tiene vuelta atrás. Cada parte es un shard, con sus propias réplicas. |
| Clave de sharding | El dato que decide en qué shard cae cada fila, y con eso qué consultas tocan un solo shard. En Tinkuy sería event_id. |
| Sharding por rango y por hash | Por rango: los datos quedan ordenados y las consultas por rango son eficientes, pero una clave que crece con el tiempo manda todo al último shard. Por hash: reparte parejo y pierde el orden. |
| hot spot | Una clave que concentra la carga. No se arregla con ninguna función de hash: el concierto que agota en un minuto manda todo el tráfico a un event_id. |
| cache | Una copia del resultado de algo caro, para no repetirlo. Es un dato derivado: da menos latencia y menos carga sobre el origen, y abre una segunda copia que puede estar desactualizada. |
| cache-aside | El patrón en que la aplicación busca en la cache; si no está (un miss), lee del origen, lo guarda y responde. Al escribir, actualiza el origen y borra la entrada. |
| TTL | El tiempo de vida de una entrada de la cache (time to live). Acota cuán viejo puede estar el dato, y se elige según cuánto retraso tolera el negocio. |
| Invalidación (cache invalidation) | Sacar de la cache lo que dejó de ser cierto: por tiempo (TTL), por evento (borrar al escribir) o, lo habitual, las dos. |
| Estampida (cache stampede) | Una entrada muy pedida expira y cientos de peticiones van al origen a la vez a recalcular lo mismo. Se evita con un lock para que solo una recalcule, con jitter en la expiración o recalculando antes de que venza. |
| Servicio sin estado (stateless service) | Un servicio que no guarda estado propio entre peticiones; el estado va a un almacén compartido. Cualquier instancia atiende cualquier petición, y por eso escala hacia los lados. |
| load balancer | El componente que reparte las peticiones entre las instancias de un servicio y deja de enviar a las que no pasan el health check. |
| health check | La consulta con la que se pregunta a una instancia si está bien. Puede responder solo que el proceso vive (liveness) o que además puede atender (readiness). |
| Transacción (transaction) | Un grupo de lecturas y escrituras que se aplican todas o ninguna. Simplifica el manejo de errores: ante una falla, se aborta y se reintenta. |
| ACID | Las garantías de una transacción: atomicidad (todo o nada), consistencia (los invariantes de la aplicación se mantienen), aislamiento (las transacciones concurrentes no se pisan) y durabilidad (lo confirmado no se pierde). |
| Aislamiento (isolation) | Qué tanto ve una transacción de las que corren a la vez. Las bases de datos ofrecen varios niveles, y el nivel por defecto casi nunca es el más fuerte. |
| Serializable | El nivel de aislamiento más fuerte: el resultado es el mismo que si las transacciones hubieran corrido una tras otra. En PostgreSQL, una transacción que entra en conflicto se aborta y hay que reintentarla. |
| read committed | El nivel por defecto de PostgreSQL: no se leen datos sin confirmar. No impide el patrón de comprobar y después actuar con el que se vende dos veces un asiento. |
| snapshot isolation | El nivel en que cada transacción ve una foto consistente de la base de datos (PostgreSQL lo llama repeatable read). Quien lee no bloquea a quien escribe. |
| Actualización perdida (lost update) | Dos transacciones leen un valor, lo modifican y lo escriben; una pisa a la otra. |
| write skew | Dos transacciones leen los mismos datos, deciden a partir de ellos y escriben en filas distintas, de modo que cada una invalida la premisa de la otra. |
| lock | El bloqueo que una transacción toma sobre un recurso para que otras esperen. SELECT … FOR UPDATE toma el de las filas leídas hasta el final de la transacción. |
| deadlock | Dos transacciones que esperan, cada una, un lock que tiene la otra. Se evita tomando los locks siempre en el mismo orden. |
| two-phase commit | El protocolo en que un coordinador pregunta a todos los participantes si pueden confirmar y, si todos dicen que sí, les ordena confirmar. Da atomicidad entre nodos; si el coordinador cae, los participantes quedan bloqueados. |
| saga | Una secuencia de transacciones locales, cada una en su servicio. Si un paso falla, se deshacen los anteriores con transacciones de compensación. No hay aislamiento: los estados intermedios se ven desde afuera. |
| Coreografía y orquestación (choreography, orchestration) | Dos formas de coordinar una saga. Coreografía: cada servicio reacciona a los eventos del anterior. Orquestación: un coordinador guarda el estado y envía comandos. |
| Idempotencia (idempotency) | Una operación es idempotente si aplicarla dos veces deja lo mismo que aplicarla una. Hace que reintentar sea seguro. |
| Clave de idempotencia (idempotency key) | Un identificador único por operación que quien llama envía en cada reintento. Quien recibe la guarda con el resultado, en la misma transacción que el efecto, y ante una clave repetida devuelve lo guardado. |
| Escritura doble (dual write) | Actualizar la base de datos y publicar un mensaje como dos operaciones separadas: si el proceso muere entre las dos, una ocurrió y la otra no. |
| outbox | El patrón que evita la escritura doble: el mensaje se inserta en una tabla outbox en la misma transacción que el cambio de estado, y un proceso aparte lo publica en el broker y lo marca como enviado. |
| broker | El intermediario que recibe los mensajes de los productores y los entrega a los consumidores. En el curso es NATS JetStream. |
| Cola (queue) | El modelo en que el broker asigna cada mensaje a un consumidor y lo borra cuando recibe la confirmación. Sirve para repartir tareas independientes; no garantiza el orden. |
| log | El modelo en que los mensajes se agregan al final de una secuencia que se conserva. Leer no borra: un consumidor nuevo puede empezar desde el principio. El orden se garantiza dentro de una partición. |
| offset | La posición de un consumidor en un log. |
| consumer group | Un grupo de consumidores que se reparten las particiones de un log: cada partición la lee uno solo del grupo. |
| backpressure | Frenar al productor cuando es más rápido que el consumidor, en vez de descartar o de encolar sin límite. |
| at-most-once | Entrega a lo más una vez: se envía y no se reintenta, así que el mensaje puede perderse. |
| at-least-once | Entrega al menos una vez: se reintenta hasta recibir la confirmación, así que el mensaje puede duplicarse. |
| exactly-once | Exactamente una vez, como efecto: entrega at-least-once más un consumidor idempotente. El broker no puede darla solo, porque no controla el efecto del consumidor. |
| dead letter queue | A donde van los mensajes que no se pudieron procesar tras varios intentos, para que alguien los revise y no bloqueen a los que vienen detrás. |
| event sourcing | Guardar la secuencia de eventos que produjeron el estado, sin modificarlos, en vez del estado actual. El estado se obtiene aplicando los eventos en orden. |
| CQRS | Separar el modelo con que se escribe del modelo con que se lee. Las vistas de lectura van atrasadas respecto de las escrituras: hay consistencia eventual entre escribir y leer. |
| Linealizabilidad (linearizability) | El sistema se comporta como si hubiera una sola copia: una vez que alguien leyó un valor nuevo, nadie lee después uno viejo. Hace falta para elegir un líder o para una restricción de unicidad. |
| Teorema CAP (CAP theorem) | Si la red se parte, una réplica aislada tiene que elegir entre responder con lo que tiene (y dejar de ser linealizable) o no responder (y dejar de estar disponible). No sirve para clasificar bases de datos. |
| Consenso (consensus) | Que varios nodos se pongan de acuerdo en un valor o en un orden de operaciones aunque algunos fallen. Los algoritmos (Raft, Paxos) necesitan una mayoría; no se implementa, se usa a través de un componente que ya lo resuelve. |
Parte 4 — Fallas, operación y evolución
| Término | Definición |
|---|---|
| Resiliencia (resilience) | Que el sistema siga dando lo esencial mientras ocurren las faltas y se recupere solo. Se diseña y se comprueba. |
| Falla en cascada (cascading failure) | Una falla que sube desde la dependencia más lenta hasta el usuario: las peticiones en espera agotan el pool de quien llama, que deja de responder, y así hacia arriba. |
| timeout | El tiempo máximo que se espera una llamada remota. Sin él, la capacidad del sistema la decide su dependencia más lenta. |
| retry | Volver a intentar una operación que falló. Recupera de una falta transitoria; solo es seguro sobre operaciones idempotentes y con un número máximo de intentos. |
| backoff | Esperar entre un retry y el siguiente. Con backoff exponencial, la espera se duplica en cada intento. |
| jitter | Una variación al azar en la espera, para que mil clientes que fallaron juntos no reintenten juntos. |
| Tormenta de reintentos (retry storm) | Los retries multiplican la carga sobre un servicio que ya está saturado: tres capas que reintentan tres veces la multiplican por veintisiete. |
| circuit breaker | El componente que envuelve las llamadas a una dependencia y cuenta sus fallas. Cerrado, las deja pasar; abierto, las hace fallar de inmediato; semiabierto, deja pasar una de prueba. |
| bulkhead | Separar los recursos por dependencia o por tipo de trabajo, para que agotar uno no hunda a los demás: un pool de conexiones para las compras y otro para el catálogo. |
| load shedding | Rechazar pronto una parte de las peticiones (un 503 rápido) cuando llega más de lo que se puede atender, para atender bien al resto. |
| rate limiting | Un tope a las peticiones que se le aceptan a cada cliente por unidad de tiempo. |
| Inyección de fallas (fault injection) | Provocar fallas a propósito (latencia, cortes, errores) y medir el escenario. En el curso, con Toxiproxy entre Tinkuy y la pasarela. |
| Observabilidad (observability) | Un sistema es observable si se puede entender qué le pasa, incluso algo que nadie previó, mirando lo que emite. Monitorear es vigilar solo las preguntas que ya se conocen. |
| logs | Registros de eventos discretos; responden qué pasó en este caso. Deben ser estructurados (JSON con campos, no frases) y llevar un identificador de la petición. |
| Métrica (metric) | Un número agregado en el tiempo: un contador, un medidor o un histograma. Responde cuánto y con qué tendencia. |
| Traza (trace) | El recorrido de una petición por todos los servicios, como un árbol de spans (tramos) con sus tiempos. Responde dónde se fue el tiempo. |
| Propagación del contexto (context propagation) | Hacer viajar el identificador de la traza en cada llamada y en cada mensaje (la cabecera traceparent). Si un servicio no lo propaga, la traza se corta ahí. |
| SLI | El indicador que se mide, como una proporción de eventos buenos sobre eventos válidos: compras que respondieron bien en menos de un segundo, sobre el total de compras. |
| SLO | El objetivo sobre un SLI en una ventana: 99,5 % en 28 días. Es un escenario de calidad vigilado en producción. |
| SLA | El contrato con quien usa el servicio, con consecuencias si no se cumple. |
| error budget | Lo que el SLO permite fallar: con 99,5 % y un millón de compras al mes, 5 000. Mientras quede, se despliega y se experimenta; cuando se acaba, la prioridad es la confiabilidad. |
| fitness function | Cualquier mecanismo que da una evaluación objetiva de una característica de la arquitectura: un escenario de calidad convertido en una comprobación que corre sola, en cada build o de forma continua en producción. En Tinkuy, las reglas de dependencia, los umbrales de k6 y las pruebas que inyectan fallas. |
| Deuda de arquitectura (architecture debt) | Decisiones de estructura que hoy hacen más caro cada cambio. Se ve en qué archivos cambian siempre juntos y en dependencias que no deberían existir; se paga cuando el interés supera al costo de arreglarla. |
| strangler fig | Reemplazar un sistema rodeándolo en vez de reescribirlo: una capa de enrutamiento envía cada funcionalidad al código viejo o al nuevo, y se migra una a la vez, con vuelta atrás. |
| Ley de Conway (Conway’s law) | Las organizaciones producen diseños que copian su estructura de comunicación. |
| LLM | Un modelo de lenguaje (large language model). Como componente es lento, caro por llamada y no determinista, y trata como texto tanto las instrucciones como los datos. |
| prompt | El texto que la aplicación le envía al modelo: instrucciones y contexto. |
| RAG | Generación aumentada con recuperación (retrieval-augmented generation): antes de llamar al modelo, se buscan los fragmentos relevantes en una fuente propia y se incluyen en el prompt. |
| embedding | Un vector de números que representa un texto, de modo que textos de significado parecido quedan cerca. Con ellos se busca por similitud en un RAG. |
| workflow | Un sistema en el que el código fija los pasos y el modelo participa en algunos. |
| Agente (agent) | Un sistema en el que el modelo decide, en un bucle, qué herramienta llamar y cuándo terminó. Es más flexible que un workflow y menos predecible en costo, en latencia y en resultado. |
| tool calling | El modelo pide ejecutar una función y la aplicación la ejecuta. Cada herramienta es una interfaz pública: validación de entradas, mínimo privilegio y operaciones idempotentes. |
| eval | Un conjunto de casos con criterios (reglas, comparación con una referencia, otro modelo como juez) que corre ante cada cambio de prompt o de modelo. Son las fitness functions de estos sistemas. |
| Inyección de prompts (prompt injection) | Un ataque en el que un texto que el modelo lee (un documento recuperado, una página web, un mensaje) contiene órdenes, y el modelo las sigue porque no distingue instrucciones de datos. |
| guardrail | Una comprobación a la entrada o a la salida del modelo. |