¿Qué herramientas usáis para hacer diagramas de arquitectura?

Snowboard

Tengo que documentar la arquitectura de un nuevo proyecto y quiero crear diagramas claros que expliquen cómo se conectan los diferentes servicios (frontend, backend, BBDD, servicios externos...).

He usado herramientas online como Lucidchart o Draw.io (ahora diagrams.net) y están bien, pero a veces se sienten un poco engorrosas. Me preguntaba si usáis alguna alternativa, especialmente alguna que sea "Diagrams as Code", donde pueda definir el diagrama en texto y se genere la imagen.

Guitar

Para "Diagrams as Code", la respuesta es Mermaid. La sintaxis es súper simple, parecida a Markdown, y está integrada en un montón de sitios, incluyendo GitHub, GitLab y Obsidian. Es perfecto para diagramas rápidos que puedes versionar junto a tu código.

Soul

Si necesitas algo más potente para diagramas de arquitectura cloud, échale un ojo a Diagrams de Python. Te permite definir tu arquitectura usando código Python y te genera los diagramas usando los iconos oficiales de AWS, GCP, Azure, etc. Es una pasada para documentar infraestructuras cloud.

StreetArt

Yo sigo siendo un gran fan de Excalidraw. No es "as code", pero tiene un estilo "hecho a mano" que hace los diagramas muy amigables y fáciles de entender. Es colaborativo y súper rápido de usar. Para una sesión de brainstorming o un diseño rápido, es imbatible.

Snowboard

¡Qué buenas recomendaciones! No conocía Diagrams de Python, parece perfecto para la parte de infraestructura. Y Mermaid para los diagramas de flujo de datos dentro de la documentación de GitHub es justo lo que necesitaba. Excalidraw también lo uso para bocetos rápidos, es genial.

Fashion

Para los que usáis VS Code, hay una extensión para Mermaid que te permite previsualizar el diagrama en tiempo real al lado de tu código. Es súper productivo.

Typography

Una alternativa a Mermaid es PlantUML. Es más antiguo pero increíblemente potente, te permite crear casi cualquier tipo de diagrama UML (secuencia, casos de uso, etc.). La sintaxis es un poco más verbosa, pero el nivel de control es mayor.

Snowboard

He estado probando Mermaid en GitHub y es una pasada. Es increíblemente fácil. Creo que para el 90% de mis necesidades, es la herramienta perfecta.

Guitar

¡Me alegro de que te sirva! Una vez que te acostumbras a tener tus diagramas versionados junto al código, es difícil volver atrás.

Soul

Totalmente. Y para los diagramas de Python, la gran ventaja es que puedes generar partes del diagrama dinámicamente. Si añades un nuevo servicio a una lista en tu código, el diagrama se actualiza solo. Es brutal.