DEV Community

Francisco Zanfranceschi
Francisco Zanfranceschi

Posted on

[Conceito] - Meus 3 Tipos Preferidos de Diagramas

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. 🧵

Image


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.

Image


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.

Image


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.

Image


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.

Top comments (2)

Collapse
 
furtleo profile image
Leonardo Furtado

O diagrama de sequência da postagem foi feito usando draw.io? Parece muito excalidraw

Collapse
 
zanfranceschi profile image
Francisco Zanfranceschi

Foi sim. Às vezes eu coloco o drawio em modo sketch pra ficar com essa cara de rascunho.