Glosario de arquitectura de software

Definiciones concisas del modelo C4, las métricas DORA, los ADR, la deriva de arquitectura, la arquitectura limpia y otros términos que todo equipo de software debería conocer. Seleccionado por Archyl.

  • Modelo C4 — Un enfoque ligero de visualización de arquitectura que describe los sistemas de software en cuatro niveles: Contexto del Sistema, Contenedor, Componente y Código.
  • Diagrama de contexto del sistema — Diagrama de nivel 1 de C4 que muestra un sistema de software y sus interacciones con los usuarios y otros sistemas externos.
  • Diagrama de contenedores — Diagrama de nivel 2 de C4 que muestra las unidades desplegables/ejecutables (aplicaciones, servicios, bases de datos) que componen un sistema de software.
  • Diagrama de componentes — Diagrama de nivel 3 de C4 que descompone un contenedor en grupos de funcionalidad relacionada (componentes) y sus colaboraciones.
  • Diagrama de código — Diagrama de nivel 4 de C4 que muestra los detalles de implementación (clases, interfaces, funciones) de un componente.
  • Registro de decisión de arquitectura (ADR) — Un documento breve que captura una única decisión arquitectónicamente significativa, su contexto y sus consecuencias.
  • Deriva de arquitectura — La brecha creciente entre la arquitectura documentada y el sistema que realmente se ejecuta en producción.
  • Regla de conformidad — Una restricción verificable por máquina que valida el código frente a la intención arquitectónica.
  • Arquitectura como código — Describir la arquitectura del sistema en un formato versionado y basado en texto para poder revisarla, comparar sus diferencias y validarla como el código fuente.
  • Radar tecnológico — Un catálogo seleccionado de tecnologías agrupadas en anillos (adoptar / probar / evaluar / esperar) que guía las decisiones de ingeniería.
  • Métricas DORA — Cuatro métricas de rendimiento de ingeniería ampliamente utilizadas: frecuencia de despliegue, tiempo de entrega de los cambios, tasa de fallos por cambio y tiempo medio de recuperación.
  • Frecuencia de despliegue — Con qué frecuencia un equipo lleva código a producción con éxito. Una de las cuatro métricas DORA.
  • Tiempo de entrega de los cambios — El tiempo que transcurre entre que se confirma un cambio de código y que ese cambio se ejecuta en producción.
  • Tasa de fallos por cambio — El porcentaje de despliegues que provocan una degradación en producción y requieren remediación.
  • Tiempo medio de recuperación (MTTR) — El tiempo promedio que se tarda en restablecer el servicio tras un incidente en producción.
  • Diseño guiado por el dominio (DDD) — Un enfoque de diseño de software que pone en el centro el modelo y el lenguaje del dominio de negocio.
  • Arquitectura hexagonal — Un estilo de arquitectura por capas que aísla la lógica de dominio de la infraestructura mediante puertos y adaptadores.
  • Arquitectura limpia — Una arquitectura por capas en la que las dependencias apuntan hacia el interior, hacia el dominio, popularizada por Robert C. Martin.
  • Event Storming — Un taller de modelado colaborativo que utiliza notas adhesivas que representan eventos de dominio para mapear un proceso de negocio.
  • Microservicios — Un estilo de arquitectura que estructura una aplicación como un conjunto de servicios pequeños, desplegables de forma independiente y organizados en torno a capacidades de negocio.
  • Service mesh — Una capa de infraestructura dedicada a gestionar la comunicación entre servicios, normalmente mediante proxies sidecar.
  • Contrato de API — Una especificación formal de una API (OpenAPI, proto de gRPC, esquema de GraphQL) que productores y consumidores se comprometen a respetar.
  • Canal de eventos — Un flujo de eventos nombrado y tipado (a menudo un topic de Kafka o equivalente) a través del cual los servicios publican y se suscriben de forma asíncrona.
  • Mapa de propiedad — Una correspondencia entre los elementos del sistema (servicios, módulos, pipelines) y el equipo o la persona responsable de ellos.
  • Documentación viva — Documentación que se genera o se valida a partir del sistema en ejecución, de modo que se mantiene precisa a medida que el sistema evoluciona.
  • Servidor MCP — Un servidor que implementa el Model Context Protocol para que los asistentes de programación con IA puedan consultar el contexto del proyecto a través de una interfaz de herramientas estandarizada.