Il grafo, nodo per nodo

Ogni processo è un grafo, costruito in codice con il DSL graph(). Qui sotto c'è un grafo d'esempio che usa tutti i tipi di nodo: consolida fatture e clienti, arricchisce le fatture con il listino, protegge la scrittura con un try-catch. Seleziona un nodo per leggerne la scheda, oppure fai passare un record e guarda che strada prende.

Fai passare un record:

Scegli una scena qui sopra, oppure seleziona un nodo per leggerne la scheda.

transform

raw-invoice

Tipo di nodo

trasformazione pura; accetta deadLetter

.transform(from, id, t, opts)

In questo esempio

Contratto Zod in ingresso: tipi larghi e coercizione, perché i dati esterni entrano come unknown.

.transform("invoices", "raw-invoice", validate("raw-invoice", rawInvoiceSchema), {
  deadLetter: invoicesDeadLetter,
})

Se un record fallisce qui

Ha un dead-letter: il record non conforme esce come DeadLetter su quel sink e lo stream prosegue. La run finisce partial.

Approfondisci nella guida allo sviluppo o nella scheda del report di run.

Le regole che il grafo fa rispettare

• Un nodo per passaggio. Un controllo e una trasformazione sono due nodi, non uno: il grafo mostrato nell'app è quello eseguito, e deve dire dove un record si è fermato.
• Due flussi si uniscono solo con un join. Tutti gli altri nodi hanno un solo ingresso. Dividere un flusso invece è libero: più nodi possono partire dallo stesso nodo.
• I sistemi esterni si toccano solo nei nodi che lo dichiarano: source, sink, lookup. Una transform resta pura, e si prova senza rete.
• Il grafo si verifica mentre si costruisce. Un ciclo, un nodo che non esiste o un ingresso di troppo fanno fallire la costruzione, prima ancora che la run parta.

Il dettaglio è nella guida allo sviluppo, e le ragioni di queste scelte negli ADR, a partire dal grafo come unico modo di costruire un processo.