Diagrammi di sequenza
Documenta le interazioni tra diversi attori o sistemi nel tempo. Ideali per la documentazione API e la progettazione di sistemi.
Cos'è Diagrammi di sequenza?
I diagrammi di sequenza sono diagrammi di interazione UML che mostrano come oggetti o sistemi comunicano tra loro nel tempo. Visualizzano l'ordine cronologico degli scambi di messaggi tra diversi attori, rendendoli preziosi per documentare flussi API, interazioni di sistema e processi multi-step. Ogni partecipante è rappresentato da una linea di vita verticale, con frecce orizzontali che mostrano gli scambi di messaggi.
Modifica e anteprima
Costruisci un Diagrammi di sequenza con la sintassi Mermaid e visualizza le modifiche istantaneamente.
Example
Sequence diagram example
A Mermaid sequence diagram for documenting browser, editor, and renderer interactions.

Mermaid code
sequenceDiagram
participant User
participant WebApp as Mermaid Editor
participant Renderer
User->>WebApp: Paste diagram code
WebApp->>Renderer: Render Mermaid syntax
Renderer-->>WebApp: SVG preview
WebApp-->>User: Download PNGCasi d'uso comuni
Documentazione API
Documenta gli endpoint API e i loro flussi di interazione. Visualizza i cicli richiesta-risposta, i flussi di autenticazione, la gestione degli errori e gli scambi di dati tra client e server.
Architettura a microservizi
Mappa i pattern di comunicazione tra microservizi, code di messaggi e database. Essenziale per comprendere il comportamento dei sistemi distribuiti e il debug dei problemi di integrazione.
Autenticazione e autorizzazione
Modella processi di autenticazione multi-step come OAuth, SAML o flussi di token JWT. Mostra la sequenza di redirect, scambi di token e passaggi di validazione.
Integrazione di sistemi
Visualizza come diversi sistemi interagiscono in scenari di integrazione complessi. Documenta callback webhook, architetture event-driven e integrazioni con servizi di terze parti.
Funzionalità principali
Gestione dei partecipanti
Definisci più attori, sistemi o servizi con alias e caselle di attivazione per mostrare quando i componenti stanno elaborando attivamente.
Tipi di messaggio
Supporto per chiamate sincrone, messaggi asincroni, valori di ritorno e auto-chiamate con diversi stili di freccia per chiarezza.
Strutture di controllo
Modella cicli, rami condizionali (alt/else), blocchi opzionali e elaborazione parallela con sintassi intuitiva.
Note e annotazioni
Aggiungi note esplicative a qualsiasi punto della sequenza per fornire contesto, chiarire la logica aziendale o documentare casi limite.
Migliori pratiche
Concentrati su uno scenario
Ogni diagramma di sequenza dovrebbe rappresentare un singolo caso d'uso o flusso di interazione. Crea diagrammi separati per scenari diversi anziché combinare tutto.
Usa nomi significativi
Dai ai partecipanti nomi chiari e descrittivi. Usa nomi di servizi reali o titoli di ruolo anziché etichette generiche come 'Sistema A' o 'Componente 1'.
Mostra i percorsi di errore
Non documentare solo il percorso felice. Includi flussi alternativi per condizioni di errore, timeout e gestione delle eccezioni.
Mantieni il tempo dall'alto verso il basso
Segui la convenzione che il tempo scorre dall'alto verso il basso. Le interazioni precedenti dovrebbero apparire più in alto nel diagramma rispetto a quelle successive.
Esplora altri tipi di diagramma
Diagrammi di flusso
Visualizza processi, flussi di lavoro e algoritmi con nodi e frecce direzionali. Perfetti per processi aziendali e alberi decisionali.
Diagrammi delle classi
Modella sistemi orientati agli oggetti con classi, attributi e relazioni. Essenziali per la pianificazione dell'architettura software.
Diagrammi di stato
Rappresenta le transizioni di stato nei sistemi o nelle applicazioni. Ottimi per modellare stati del ciclo di vita e flussi di lavoro.
Diagrammi di Gantt
Pianifica e monitora le tempistiche dei progetti con attività e dipendenze. Perfetti per la gestione dei progetti e la pianificazione.
Diagrammi ER
Progetta schemi di database con entità e relazioni. Ideali per la modellazione e la documentazione dei database.
Percorso utente
Mappa le esperienze e le interazioni degli utenti attraverso i punti di contatto. Eccellente per il design UX e la mappatura del percorso cliente.
Grafi Git
Visualizza le strategie di branching Git e le cronologie dei commit. Utili per spiegare i flussi di lavoro del controllo versione.
Mappe mentali
Organizza idee, fai brainstorming di concetti e crea strutture visive gerarchiche. Perfette per la pianificazione e la mappatura delle conoscenze.
Grafici a torta
Visualizza distribuzioni proporzionali di dati con grafici circolari. Ideali per mostrare percentuali e quote di mercato.
Linee temporali
Visualizza eventi cronologici e traguardi lungo un asse temporale. Ottimi per cronologie di progetto e roadmap.
Board Kanban
Organizza le attività in colonne che rappresentano le fasi del flusso di lavoro. Perfetto per la gestione agile e il monitoraggio delle attività.
Grafici a quadranti
Posiziona elementi su una griglia a due assi per confrontare e prioritizzare. Ideale per la prioritizzazione delle funzionalità e l'analisi strategica.
Diagrammi di Sankey
Visualizza le quantità di flusso tra nodi con frecce proporzionali. Perfetti per flussi energetici, allocazione di budget e funnel di conversione.
Grafici XY
Crea grafici a barre e grafici a linee con assi personalizzabili. Ideali per la visualizzazione dei dati e l'analisi delle tendenze.
Diagrammi a blocchi
Costruisci layout strutturati con blocchi disposti in colonne e righe. Ottimi per architetture di sistema e panoramiche dei componenti.
Diagrammi di architettura
Progetta architetture cloud e di sistema con icone di servizio e connessioni. Perfetti per la documentazione dell'infrastruttura.
Diagrammi di pacchetto
Visualizza le strutture dei pacchetti dei protocolli di rete con layout dei campi a livello di bit. Essenziali per la documentazione dei protocolli di rete.