Flussi Utente - Archyl Docs

Documenta i flussi utente e dati attraverso la tua architettura per visualizzare sequenze di interazioni

Flussi Utente

I Flussi Utente in Archyl ti permettono di documentare sequenze di interazioni attraverso la tua architettura. Visualizza come utenti, dati o richieste si muovono nel tuo sistema.

Cosa Sono i Flussi?

Un Flusso rappresenta una sequenza di passi attraverso la tua architettura:

  • Percorsi utente: Login, checkout, registrazione
  • Flussi dati: Elaborazione ordini, sincronizzazione dati
  • Interazioni di sistema: Chiamate API, catene di eventi
  • Gestione errori: Scenari di fallimento, retry

Ogni passo in un flusso fa riferimento a relazioni nella tua architettura, creando una vista connessa di come funzionano le cose.

Creare un Flusso

Dalla Scheda Flussi

  1. Vai alla scheda Flussi nel tuo progetto
  2. Clicca su Crea Flusso
  3. Inserisci nome e descrizione
  4. Aggiungi passi selezionando relazioni
  5. Clicca su Salva

Struttura del Flusso

Ogni flusso contiene:

Campo Descrizione
Nome Nome breve e descrittivo (es. "Flusso Login Utente")
Descrizione Cosa rappresenta questo flusso
Passi Lista ordinata di riferimenti a relazioni

Aggiungere Passi

Per ogni passo:

  1. Seleziona una relazione dalla tua architettura
  2. Il passo mostra sorgente, destinazione ed etichetta della relazione
  3. Trascina per riordinare i passi
  4. Aggiungi note per contesto aggiuntivo

Visualizzare i Flussi

Navigazione Passo per Passo

Quando visualizzi un flusso:

  • I passi sono mostrati in ordine
  • Il passo corrente è evidenziato sul diagramma
  • Naviga con i pulsanti Avanti/Indietro
  • Vedi il contesto completo ad ogni passo

Riproduzione Animata

Clicca su Riproduci per animare il flusso:

  • Progressione automatica dei passi
  • Percorso evidenziato sul diagramma
  • Velocità di riproduzione regolabile

Condivisione dei Flussi

Link Pubblici dei Flussi

I Flussi Utente hanno la condivisione pubblica integrata:

  1. Apri un Flusso
  2. Clicca sull'icona Condividi
  3. Copia l'URL pubblico
  4. Condividi con chiunque

La vista pubblica include:

  • Navigazione passo per passo
  • Visualizzazione dell'architettura
  • Descrizione del flusso
  • Nessuna autenticazione richiesta

Incorporamento dei Flussi

Incorpora i flussi in strumenti esterni:

  • Confluence
  • Notion
  • Siti di documentazione
  • Wiki

Best Practice

Nomina i Flussi Chiaramente

Usa nomi orientati all'azione:

  • "Registrazione Utente"
  • "Processo di Checkout Ordine"
  • "Flusso Rimborso Pagamento"
  • "Pipeline Sincronizzazione Dati"

Mantieni i Flussi Focalizzati

  • Un flusso per percorso utente
  • 5-15 passi è l'ideale
  • Dividi flussi complessi in sotto-flussi
  • Fai riferimento ad altri flussi quando necessario

Aggiungi Contesto

Usa le descrizioni per spiegare:

  • Perché questo flusso esiste
  • Chi lo usa
  • Quando viene attivato
  • Qual è il risultato atteso

Collega alla Documentazione

Fai riferimento ai documenti correlati:

  • Specifiche API
  • Documenti di requisiti
  • ADR che spiegano le scelte di design

Esempi di Flussi

Checkout E-commerce

  1. Utente → Cart Service: "Visualizza carrello"
  2. Cart Service → Inventory: "Verifica disponibilità"
  3. Utente → Checkout Service: "Inizia checkout"
  4. Checkout Service → Payment: "Elabora pagamento"
  5. Payment → Order Service: "Crea ordine"
  6. Order Service → Notification: "Invia conferma"

Autenticazione API

  1. Client → API Gateway: "Richiesta con credenziali"
  2. API Gateway → Auth Service: "Valida token"
  3. Auth Service → User DB: "Cerca utente"
  4. Auth Service → API Gateway: "Restituisce claims"
  5. API Gateway → Backend: "Inoltra con contesto utente"

Prossimi Passi