8 min de leitura · Última atualização: 30 de junho de 2025
Por que diagramas de sequência importam
Diagramas de sequência mostram como componentes trocam mensagens ao longo do tempo. São ideais para fluxos de API, hand-offs de autenticação e depuração de sistemas distribuídos porque ordem e responsabilidade ficam visíveis de relance. Diferente de diagramas de arquitetura com caixas e linhas, sequências respondem: o que vem a seguir e quem chama quem?
Sintaxe básica
Comece com a palavra-chave sequenceDiagram e declare participantes implicitamente pelas mensagens. Um request-reply simples: Client->>Server: GET /health seguido de Server-->>Client: 200 OK. Setas sólidas são chamadas; tracejadas são respostas. Nomeie participantes à esquerda quando precisar de rótulos legíveis, por exemplo participant API as Public API.
Ramificações, loops e passos opcionais
Use alt e else para caminhos de sucesso e falha, loop para polling repetido e opt para passos que podem não rodar. Todo fragmento deve fechar com end. Esses blocos espelham como engenheiros descrevem comportamento em design reviews, facilitando manter diagramas junto com mudanças de código.
Exportar e compartilhar
Quando o diagrama estiver pronto, exporte SVG para docs nítidos, PNG para slides ou PDF para fluxos PDF-first. Mantenha o source Mermaid no repositório para updates diff-friendly. O editor drawflow.io guarda rascunhos localmente no navegador até exportar ou copiar notação.