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.
SOCIAL SHARE CARD GENERATOR