Pensa a una matrice passi × stato per studente, non a una lista lineare “fatto / non fatto”. Ogni passo (Anagrafica, Kross, Conduit, Smart check-in, Stripe, verifica) ha il suo stato, e chi subentra riparte dal primo passo non ancora verificato. Il modello completo è nella sezione “Stati studente & handoff” di Panoramica onboarding.
⭐ Parti da qui: il prompt per riprendere
Prima ancora di leggere il resto: se devi solo capire a che punto è uno studente e da dove ripartire, incolla questo prompt in Claude Code. Ricostruisce la matrice passi×stato dalle fonti reali (/connessioni + pms_integrations + Vault), ricorda il GATE Conduit e ti dice il primo passo da fare. Le sezioni sotto spiegano il perché dietro ogni riga.
Dove vive lo stato, oggi
Non esiste ancora un tracker unico: lo stato si ricostruisce da tre fonti che vanno lette insieme.La matrice passi × stato con la logica del “non ora” e dell’handoff è descritta in Panoramica onboarding. Le tre fonti qui sopra sono i posti concreti dove quella matrice si legge oggi.
I cinque stati di un passo
Ogni passo dell’onboarding sta in uno di questi stati:Come leggere a che punto è
1
Apri /connessioni per quello studente
Su
app.mattone.co/connessioni guardi lo stato per-connettore: è la fotografia più rapida di cosa è collegato e cosa è in “non ora”.2
Conferma con pms_integrations + Vault
Incrocia la vista con la tabella
pms_integrations (stato macchina, con i timestamp) e con la presenza delle credenziali nel Vault. Se /connessioni dice “collegato” ma nel Vault manca la credenziale, lo stato reale è più indietro.3
Ricostruisci la matrice passo per passo
Per ognuno dei sei passi assegna uno dei cinque stati. Il primo passo non ancora verificato (escludendo i “non ora”) è il punto da cui ripartire.
4
Leggi sempre i log prima di fidarti
Per ogni passo “collegato” che credi funzioni, apri i log e verifica dal vivo. Il log è l’unica prova che l’operazione è andata a buon fine, l’interfaccia no.
Come riprendere (handoff)
1
Riparti dal primo passo non verificato
Rispetta l’ordine del ramo operativo (Anagrafica → Kross → Conduit → Smart check-in → Stripe → verifica): ogni passo costruisce le fondamenta del successivo, saltarne uno rompe ciò che viene dopo. I “non ora” si scavalcano, ma restano visibili.
2
Rispetta le dipendenze di fase
Attenzione ai passi che sembrano lo stesso ma non lo sono: Kross caricato in piattaforma (3 credenziali nel Vault) ≠ Kross collegato a Conduit (tool montati nell’agente). I custom tool possono essere preparati prima/indipendentemente; smart-lock e Stripe sono condizionali e possono restare “non ora” a lungo senza bloccare gli altri.
3
Verifica dal vivo prima di dichiarare chiuso un passo
Non segnare “verificato” senza un test reale con log. Se un passo era “collegato”, rifallo controllare dal vivo tu che subentri: non ereditare il verde di qualcun altro senza prova.
4
Lascia traccia per chi viene dopo
Aggiorna lo stato in piattaforma e annota cosa hai verificato (con quale log/output) e cosa resta “non ora” o aperto. L’handoff funziona solo se il prossimo vede lo stesso quadro che vedi tu.
Regola trasversale
Leggi sempre i log e ricorda che “collegato” non è “verificato”. L’handoff pulito nasce da qui: chi subentra non deve fidarsi del verde in UI, ma ricostruire lo stato dalle tre fonti e chiudere ogni passo con una prova reale. Se qualcosa non torna, applica il Metodo di troubleshooting prima di escalare.Panoramica onboarding
La matrice passi×stato e l’ordine dei sei passi
Verifica finale
La checklist con evidenza dai log
Monitorare gli studenti
Dopo il go-live: cosa guardare e dove
Metodo troubleshooting
Quando uno stato non torna
Fonti: /onboarding/panoramica (matrice passi×stato, dipendenze di fase), tabella
pms_integrations (Supabase, repo ~/Projects/mattone-platform), vista /connessioni su app.mattone.co, Vault credenziali.