Conteúdo original em https://x.com/zanfranceschi/status/1809646770361614528

Ei dev,

Vou compartilhar com você os tipos de diagramas que mais gosto e uso para desenhar soluções novas ou mapear soluções existentes.

Segue o fio. 🧵

Antes de mais nada, acho importante saber diferenciar desenhos ESTRUTURAIS e COMPORTAMENTAIS. Então se você não sabe, vale a pena dar uma lida sobre isso antes de prosseguir – já escrevi sobre isso nessa thread. 👇

Depois volta aqui.

https://x.com/zanfranceschi/status/1515015604977401857

DIAGRAMAS DE SEQUÊNCIA

De longe, esse é o diagrama que mais uso. Pra mim, ele é muito útil pra desenhar integrações entre serviços/aplicações.

Também é possível desenhar interações entre componentes dentro da mesma aplicação (no mesmo processo), mas raramente faço isso.

DIAGRAMAS DE COMPONENTES

Acho um bom diagrama pra mostrar dependências entre serviços. É uma visão estática que oferece um bom contexto duma solução. Diria que é uma alternativa mais técnica e menos descritiva aos primeiros níveis do modelo C4 do @simonbrown.

DIAGRAMA DE MÁQUINA DE ESTADOS

Uso com menos frequência, mas acho ele muito útil pra quando preciso modela ou entender os possíveis estados de algo mais complexo. Desenhá-los me ajuda a fixar e/ou fomentar o entendimento dessas coisas mais complexas.

Pra mim, essa é a frequência de uso dos diagramas:

• SEQUÊNCIA: muito frequente

• COMPONENTES: frequente (geralmente após desenhar diagramas de sequência)

• ESTADOS: pouco frequente (apenas quando preciso desenhar algo complexo o suficiente pra ser difícil de lembrar/decorar)

FERRAMENTAS

Eu praticamente só uso o drawio justamente por ter um bom suporte aos diagramas de sequência.

Dá pra fazer bons diagramas com mermaid ou plantuml – eles são bons porque você não perde tempo com alinhamentos. Mas são menos flexíveis e ficam ruins com modelos grandes.

Muita gente usa excalidraw, miro, etc. Mas por causa da falta de suporte ou suporte ruim aos diagramas de sequência, raramente uso essas ferramentas.

Cada pessoa se dá melhor com diferentes diagramas e o essencial no final é sempre se comunicar bem ­– com qualquer notação!

Fim.