Generatore di diagrammi di architettura
Disegna il design del sistema come testo. Raggruppa i servizi in livelli con subgraph Mermaid — client, API, archivi dati, code — e visualizza un diagramma di architettura pulito per il tuo documento di design. Nulla lascia il browser.
One step per line. Indent two spaces to branch beneath the line above.
Design del sistema che vive nel repo
I diagrammi di architettura vanno alla deriva nel momento in cui diventano un file binario in uno strumento di design. Scriverli come Mermaid li mantiene accanto al codice: raggruppa ogni livello in un subgraph, usa cilindri per gli archivi dati e esagoni per i bus, e il diagramma si aggiorna con una modifica a una riga durante la revisione.
È anche l'artefatto giusto per una RFC o un documento di onboarding — i revisori vedono i componenti e il flusso di dati senza aprire un'app separata.
Da un flusso di lavoro al suo diagramma
Se stai documentando un'automazione — diciamo una pipeline n8n o Zapier che sposta dati tra i servizi — un diagramma di architettura rende leggibili le parti in movimento. Disegna il trigger, i servizi che tocca, e dove i dati si fermano, quindi mantieni il codice sorgente nei tuoi documenti in modo che evolva con il flusso.
Domande frequenti
Come creo un diagramma di architettura software dal testo?
Usa un diagramma di flusso Mermaid, raggruppa i servizi correlati con "subgraph Tier … end", e connettili con frecce. Usa cilindri "[(DB)]" per gli archivi dati. Si visualizza in tempo reale ed esporta in SVG o PNG.
Come raggruppo i servizi in livelli?
Avvolgi i nodi in "subgraph Name … end". Ogni subgraph diventa una casella etichettata, il modo più chiaro per mostrare una divisione presentazione/applicazione/dati o un insieme di microservizi.
Posso mostrare link asincroni o in coda?
Sì — usa un link punteggiato con un'etichetta, come "A -. async .-> B", per distinguere gli eventi e le code dalle chiamate sincrone.
Il mio diagramma di architettura è privato?
Sì. Si visualizza interamente nel tuo browser, quindi i nomi dei servizi interni e la topologia non lasciano mai il dispositivo.
Quali forme dovrei usare per i database e le code?
Usa "[(name)]" per un cilindro di database, "[[name]]" per una queue/subroutine, e "{{name}}" per un esagono come un event bus. Il foglio di aiuto li elenca.