Describe tu sistema y obtén su diagrama de arquitectura

Un buen diagrama de arquitectura responde tres preguntas de un vistazo: cuáles son los componentes principales, cómo se mueven las peticiones y los datos entre ellos y dónde están los límites, como redes, clústeres o cuentas en la nube. Deja fuera el detalle de código, que corresponde a los diagramas de clases o de secuencia.

Es la primera imagen que se pide en la incorporación de personas, las revisiones de diseño, las propuestas y las entrevistas de diseño de sistemas. Un generador de diagramas de arquitectura te da esa imagen en minutos, para que la conversación pase a si el diseño es el adecuado.

Recorre una petición desde el usuario hacia dentro: "la app móvil llama al API gateway, que enruta al servicio de pedidos, que escribe en PostgreSQL y publica un evento en Kafka". Después añade lo que está al lado de ese camino, como cachés, colas, tareas programadas y APIs de terceros como un proveedor de pagos.

Nombra la tecnología cuando la conozcas, por ejemplo Redis, MySQL, S3 o Lambda, porque decide la forma o el icono. Menciona las agrupaciones que importan, como una VPC, una subred privada o un clúster de Kubernetes, y di qué llamadas son asíncronas para que se dibujen con líneas discontinuas.

Sigue con el dedo el camino principal de las peticiones. Cada flecha debe apuntar en la dirección de la llamada o de los datos, y nada debe conectarse a una base de datos salvo los servicios que la poseen. Comprueba que cada componente esté en el contenedor correcto y que los servicios externos queden fuera del límite de tu sistema.

Después revisa las etiquetas. Una conexión sin protocolo ni propósito es una pregunta segura en la revisión. Corrige lo que haga falta en el editor de Draw.io, o pide a la IA que mueva un componente, añada una etiqueta o divida una capa demasiado llena.

Un solo diagrama de arquitectura rara vez lo cubre todo. Para el orden de las llamadas dentro de una función, dibuja un diagrama de secuencia; para los datos que guarda cada servicio, un diagrama ER; y para cómo se mueve la información entre procesos y almacenes, el diagrama de flujo de datos es la opción clásica.

Este sitio tiene un generador para cada uno de ellos, y todos producen archivos de Draw.io que se abren en el mismo editor, así que puedes mantener todo un documento de diseño con un estilo coherente.