Diagrammi di progettazione dell'architettura
Gli architetti spesso comunicano attraverso diagrammi. I diagrammi sono potenti strumenti di comunicazione che aiutano gli implementatori e gli stakeholder a vedere l'ampia visione o approfondire le aree altamente sensibili o sfumature di un sistema. Per comunicare con l'intenzione, un architetto deve selezionare quale diagramma è utile in ogni situazione.
L'elenco dei diagrammi in questo articolo non è esaustivo. I diagrammi sono spesso composti da più tipi.
In definitiva, la scelta del diagramma dell'architettura dipende da ciò che si sta tentando di trasmettere e dal profilo del pubblico. Un architetto usa più tipi di diagrammi in tutte le attività per progettare, perfezionare i requisiti e la comunicazione.
Procedure di creazione di diagrammi
I diagrammi presentano informazioni sostanziali senza la necessità di una spiegazione testuale. Evitare ambiguità nei diagrammi. Di seguito sono elencati alcuni suggerimenti:
Usare le notazioni standard. Usare simboli, icone e convenzioni di presentazione ampiamente riconosciuti per una buona leggibilità e interpretazione di un diagramma.
Evitare righe ambigue. I diagrammi spesso mostrano relazioni tra entità rappresentate come linee. Essere coerenti nel modo in cui si usano le linee.
Evitare linee senza frecce. È difficile sapere qual è la relazione senza direzione, quindi usare le frecce. Etichettare tutte le linee senza frecce per indicare le relazioni.
Evitare linee con frecce doppie. Le frecce doppie implicano una dipendenza bidirezionale. Preferire l'uso di una freccia a terminata singola per rappresentare il flusso dal client dipendente alla dipendenza (server).
Etichetta tutto. Fornire etichette chiare, accurate e significative per ogni icona. Etichettare le righe quando le relazioni non sono chiare.
Mantenere la coerenza. Usare colori standardizzati, maiuscole e minuscole, icone, dimensioni delle icone, tipi di linea, teste frecce e altre rappresentazioni per elementi simili in un diagramma. Rimanere coerenti in tutti i diagrammi creati per la progettazione e la documentazione del carico di lavoro. Derivare da dati o tassonomie esistenti.
Essere accurati. I diagrammi sono astrazioni, ma non sacrificano l'accuratezza nel processo. Ad esempio, non rappresentare un servizio in una rete virtuale se non è presente in tale rete virtuale. Un diagramma è uno strumento di comunicazione, quindi è necessario evitare errori di comunicazione da imprecisioni.
Includere i metadati. Assicurarsi che un diagramma contenga metadati che forniscano informazioni essenziali sullo scopo del diagramma. I metadati offrono anche il contesto per aiutare i visualizzatori a comprendere l'ambito e il significato del diagramma. Includere elementi come titolo, descrizione, data dell'ultimo aggiornamento, autore e riferimenti esterni.
Usare le icone ufficiali e i nomi dei servizi. Quando rappresenti una tecnologia specifica, usa le icone ufficiali più recenti del tuo provider di tecnologie. Se l'identificazione della tecnologia è importante, usare il nome ufficiale per il servizio.
Ecco ad esempio le icone per servizi Microsoft:
- icone dell'architettura di Azure
- Icone di Microsoft 365
- Icone di Microsoft Dynamics 365
- Icone dell'architettura di Microsoft Entra ID
- Icone di Microsoft Power Platform
Tipi di diagrammi di progettazione
L'architettura del carico di lavoro è complessa e multidimensionale. Ogni tipo di dimensione è incentrato su un aspetto specifico del sistema fornendo un livello di dettaglio specifico per tale dimensione. Ad esempio, i diagrammi di flusso illustrano il flusso di processo. I diagrammi di relazione tra entità illustrano le relazioni tra i componenti di sistema.
La presenza di diversi tipi di diagrammi consente una comprensione completa delle dimensioni. Aiuta a incoraggiare una comunicazione efficace, la risoluzione dei problemi e il processo decisionale tra gli stakeholder.
Diagramma di sistema generale
Un diagramma di sistema di alto livello funge da panoramica generale di un intero carico di lavoro o di una sottosezione all'interno di un carico di lavoro. Include i componenti principali, le relazioni tra loro e l'ordine approssimativo in cui i dati passano attraverso il sistema. Le frecce mostrano la direzione dell'interazione.
Questi diagrammi sono validi per raggiungere una comprensione comune in modo da poter avviare discussioni più approfondite o per la comunicazione degli stakeholder.
Diagramma a blocchi
Un diagramma a blocchi suddivide un carico di lavoro nei blocchi funzionali principali. I blocchi sono in genere indipendenti dalla tecnologia. Fanno riferimento alle funzionalità eseguite anziché a un componente specifico.
Ad esempio, un diagramma a blocchi potrebbe fare riferimento a un "bus di messaggistica" anziché a una tecnologia specifica per il bus di messaggi. Questo tipo di diagramma può aiutare a spiegare la struttura, il flusso di dati e il flusso di elaborazione di un sistema senza distrarre il pubblico con dettagli fine.
Diagramma dei componenti
Un diagramma dei componenti funziona come un diagramma a blocchi, ma sostituisce blocchi di funzionalità generiche con tecnologie specifiche. Presenta una visualizzazione dettagliata con l'obiettivo di comunicare i singoli componenti tecnologici del sistema e le relative relazioni, ad esempio client/server. Questi diagrammi sono una sorta di materiale visivo per l'ambito del diagramma.
Diagramma della distribuzione
Un diagramma di distribuzione è incentrato sulla distribuzione di software infrastructure, commercial off-the-shelf (HANDLE) e codice personalizzato nel carico di lavoro. Mostra come il software e il codice vengono distribuiti nell'infrastruttura di hosting.
Diagramma del flusso di dati
Un diagramma di flusso dei dati (DFD) illustra il modo in cui i dati vengono spostati in un sistema, utile quando si modellano sistemi incentrati sui dati. In un diagramma di questo tipo, è consigliabile notare se i dati vengono spostati in batch o in tempo reale per rimuovere l'ambiguità.
Diagramma sequenza
Un diagramma di sequenza illustra gli scambi di comunicazione tra i componenti del carico di lavoro nel tempo. Illustra le relazioni client/server e la loro natura sincrona o asincrona. Evidenzia anche le dipendenze in questi scambi e valuta gli scenari di errore all'interno di essi.
Diagramma di flusso utente
Un diagramma di flusso utente è incentrato su un'interazione con ambito tra carichi di lavoro, utenti o attori e il carico di lavoro. È utile chiarire e visualizzare i requisiti funzionali in vari modi in cui un utente e i dati dell'utente interagiscono con il sistema.
Diagramma delle relazioni tra entità
Un diagramma di relazione tra entità (ERD) è un diagramma di modellazione che rappresenta la struttura di un database o di un altro sistema di archiviazione. Mostra la relazione tra entità ,ad esempio tabelle, tramite attributi standard del settore e simbologia di associazione.
Diagramma di rete
Un diagramma di rete illustra la soluzione dal punto di vista della rete in cui viene eseguita o interagisce. Questi diagrammi sono utili per visualizzare la segmentazione di rete del carico di lavoro, i punti di rete di errore e le transizioni di rete chiave, ad esempio i punti di uscita e in ingresso di Internet.
I diagrammi di rete hanno in genere un'implementazione precedente. I diagrammi di rete vengono spesso usati nei controlli e nella risposta agli eventi imprevisti.
Diagramma di stato
Un diagramma di stato è una visualizzazione specializzata. Mostra lo stato in cui si trova un flusso (o un singolo componente). Viene inoltre illustrato come il flusso passa tra gli stati in risposta a condizioni o eventi.
Diagramma di flusso
Anche se non si tratta di un diagramma dell'architettura in particolare, un diagramma di flusso è un altro modo per portare chiarezza a una progettazione. I diagrammi di flusso sono spesso utili quando rappresentano flussi di lavoro o logica complessi. È possibile usarli per perfezionare i requisiti e favorire le scelte di implementazione.
I diagrammi di flusso sono utili per includere nei piani di risposta agli eventi imprevisti del carico di lavoro per evidenziare i punti decisionali chiave e le azioni o i canali di notifica associati.