Componentes y conexiones de un sistema, agrupados por capa o frontera de confianza.
1 ejemplo de diagrama de arquitectura
Arquitectura de una plataforma de comercio
Clientes, servicios y almacenes de datos de una tienda online, agrupados por capa.
Los componentes se agrupan por capa, las flechas van de izquierda a derecha y el relleno de cada nodo dice qué es: entradas, servicios, almacenes, un warehouse externo. Solo la pasarela de API, el punto de integración, lleva el acento.
Un diagrama de arquitectura de software muestra los componentes de un sistema, como servicios, bases de datos, colas y servicios externos, y cómo se comunican. Modelos como C4 de Simon Brown lo estructuran en niveles: contexto, contenedores, componentes y código.
Las cajas son componentes y las flechas, conexiones etiquetadas con el protocolo o el dato que viaja. Los recuadros que agrupan cajas marcan capas o fronteras de confianza, y lo que cruza una frontera es lo que hay que proteger.
Cuándo usar un diagrama de arquitectura
Para explicar a un nuevo ingeniero cómo encajan el frontend, la API, los workers y la base de datos de una plataforma de comercio.
Para preparar una revisión de seguridad identificando qué datos cruzan cada frontera de confianza.
Si la pregunta es en qué máquinas, zonas o réplicas se ejecuta cada pieza, usa un diagrama de despliegue.
Cómo hacer un buen diagrama de arquitectura
Decide el nivel de detalle y mantenlo: no mezcles servicios completos con clases internas.
Etiqueta cada flecha con el protocolo o la acción (HTTPS, eventos, lee, escribe) e indica el sentido.
Agrupa por capa o frontera de confianza y pon una leyenda si usas colores o formas con significado.
Describe los componentes al copiloto de IA de MakeCharts y reordena después las agrupaciones.
