Guida Rapida

Questa guida ti aiuterà a creare il tuo primo diagramma di architettura in Archyl in pochi minuti.

Passo 1: Creare un Account

1. Vai su app.archyl.com
2. Registrati usando la tua email o connettiti con GitHub, GitLab o Bitbucket
3. Verifica la tua email se ti sei registrato con email

Dopo l'accesso arrivi alla dashboard, il tuo centro di comando per ogni progetto:

Passo 2: Creare il Tuo Primo Progetto

1. Clicca "Nuovo Progetto" nella dashboard
2. Inserisci un nome per il tuo progetto (es. "La Mia Piattaforma E-commerce")
3. Facoltativamente aggiungi una descrizione e dei tag
4. Clicca "Crea Progetto"

Passo 3: Aggiungere il Primo Sistema

1. Nel tuo nuovo progetto, partirai dal livello Contesto del Sistema
2. Clicca il pulsante "+" o fai clic destro sul canvas
3. Seleziona "Aggiungi Sistema"
4. Inserisci un nome (es. "Piattaforma E-commerce")
5. Aggiungi una descrizione di ciò che il sistema fa

Passo 4: Aggiungere Sistemi Esterni

I sistemi reali non esistono in isolamento. Aggiungi i sistemi esterni con cui il tuo software interagisce:

1. Clicca "+" e seleziona "Aggiungi Sistema Esterno"
2. Aggiungi sistemi come "Gateway di Pagamento", "Servizio Email", "CDN"
3. Questi appariranno con uno stile diverso per indicare che sono esterni

Passo 5: Creare Relazioni

Mostra come i sistemi comunicano:

1. Clicca sul sistema sorgente
2. Trascina dal punto di connessione al sistema di destinazione
3. Aggiungi un'etichetta che descrive la relazione (es. "Elabora pagamenti tramite API")

Ecco una vista Contesto del Sistema completa: persone, sistemi e fornitori esterni collegati da relazioni etichettate:

Clicca su un elemento qualsiasi per aprirne i dettagli: descrizione, responsabili, decisioni collegate, documentazione e contratti API:

Passo 6: Entrare nei Contenitori

Fai doppio clic sul tuo sistema principale per scendere al livello Contenitore:

1. Aggiungi contenitori come "Applicazione Web", "Server API", "Database"
2. Mostra come comunicano tra loro
3. Collegali ai sistemi esterni

Prossimi Passi

Congratulazioni! Hai creato il tuo primo diagramma di architettura. Ecco cosa esplorare ora:

• Collegare un Repository - Lascia che l'IA scopra automaticamente la tua architettura
• Scoperta IA - Scopri come l'IA analizza la tua codebase
• Collaborazione di Team - Invita i tuoi colleghi
• Esportazione e Condivisione - Condividi i tuoi diagrammi con gli stakeholder

Consigli per il Successo

• Inizia dall'alto: Comincia con il Contesto del Sistema prima di entrare nei dettagli
• Usa nomi chiari: Dai ai sistemi e ai contenitori nomi descrittivi
• Aggiungi descrizioni: Il te stesso del futuro (e il tuo team) ti ringrazieranno
• Itera: La documentazione dell'architettura è qualcosa di vivo - aggiornala man mano che il sistema evolve