Invitation

Pattern canonico per capire, accettare e recuperare un invito Qoovex senza esporre il modello tecnico sottostante.

Prima capire, poi accettare

Un invito è una decisione contestuale, non un semplice link. Prima dell’azione l’utente deve riconoscere l’Azienda, il lavoro quando esiste e la conseguenza reale. Dopo il successo deve arrivare al contesto più preciso già noto, senza doverlo cercare nel Workspace.

Contratto della composizione

Il testo visibile deriva dai dati autorizzati della preview e dalla destinazione restituita dall’accettazione.

Chi invita
Mostra il nome dell’Azienda. Aggiungi la persona invitante soltanto quando il dato è realmente disponibile.
Per quale contesto
Nomina il lavoro e, quando presente, il suo indirizzo. Per un invito Collaboratore mostra invece Azienda e ruolo, senza inventare un cantiere.
Cosa comporta
Spiega l’accesso che verrà creato e il passo immediatamente successivo, senza promettere permessi ulteriori.
Azione primaria
Usa una sola CTA che unisca decisione e destinazione: “Accetta e apri il lavoro” quando il lavoro è noto.
Destinazione
Dopo l’accettazione apri direttamente il lavoro restituito dal flusso. Usa il Workspace generale soltanto quando non esiste un contesto più preciso.

Specimen canonici

Gli esempi riprendono i dati, le CTA, le recovery e la destinazione del flusso Cliente reale. Sono dimostrativi: non inviano richieste e non creano accessi.

Invito a un lavoro

Invito disponibile
Il contesto precede l’unica azione primaria.
Azienda invitante
Edilizia Aurora
Lavoro
Ristrutturazione via Roma
Indirizzo del lavoro
Via Roma 12, Milano

Accettando, aprirai questo lavoro in Qoovex come cliente principale. Prima che diventi operativo, l’Azienda pubblicherà il riepilogo iniziale da consultare e confermare.

Accettazione in corso

Contesto e decisione restano visibili mentre l’invio è protetto da doppie attivazioni.
Stiamo registrando l’accettazione
Attendi prima di chiudere la pagina. Il lavoro si aprirà soltanto dopo il successo.

Stati limite e recovery

Ogni stato dice cosa è successo e cosa può fare ora l’utente. Se non esiste una recovery diretta, non viene simulata una CTA.

Invito già accettato

Stato dell’invito
L’account attuale ha già accesso al lavoro.
Azione disponibile
Apri il lavoro
Cosa spiegare
Disponibile soltanto quando l’accesso è ancora valido.

Invito scaduto

Stato dell’invito
Questo invito non è più utilizzabile.
Azione disponibile
Nessuna CTA diretta
Cosa spiegare
Chiedi all’Azienda di inviare un nuovo invito.

Invito revocato

Stato dell’invito
L’Azienda ha annullato questo invito.
Azione disponibile
Nessuna CTA diretta
Cosa spiegare
Se serve ancora l’accesso, contatta l’Azienda.

Accedi con l’email invitata

Stato dell’invito
L’account corrente usa un indirizzo diverso da quello che ha ricevuto l’invito.
Azione disponibile
Cambia account
Cosa spiegare
La recovery reale chiude la sessione e conserva il ritorno all’invito.

Situazione del lavoro aggiornata

Stato dell’invito
Il lavoro è cambiato mentre l’invito veniva accettato.
Azione disponibile
Aggiorna e riprova
Cosa spiegare
Ricarica lo stato prima di tentare una nuova accettazione.

Destinazione dopo il successo

L’accettazione Cliente restituisce il lavoro associato: la navigazione sostituisce la pagina dell’invito con quel dettaglio, senza passare dalla home. Se lo stesso account riapre un invito già accettato e ha ancora accesso, vede “Apri il lavoro”.

Altri stati reali

Questi casi esistono nel flusso Cliente ma non richiedono tutti uno specimen separato. La recovery compare soltanto quando il prodotto può offrirla.

Accesso richiesto
Conserva il ritorno all’invito durante accesso o registrazione e ricorda di usare l’email invitata.
Email da verificare
Chiedi di completare la verifica e di riaprire lo stesso link; non mostrare una CTA che salti il controllo.
Tipo di account non adatto
Spiega che serve l’account previsto dall’invito e offri il cambio account quando disponibile.
Account già presente nel lavoro
Non tentare una seconda associazione: proponi il cambio account oppure il contatto con l’Azienda.
Invito accettato, accesso non disponibile
Dichiara che il lavoro non può essere aperto con questo account e indica di contattare l’Azienda.
Invito non disponibile
Usa un fallback neutro per link non valido o stato non distinguibile, senza rivelare il motivo tecnico.

Cliente e Collaboratore non sono lo stesso invito

L’invito Cliente appartiene a un lavoro preciso: mostra Azienda, lavoro, indirizzo facoltativo e apre direttamente quel lavoro dopo l’accettazione. Il Cliente entra come cliente principale e dovrà poi consultare il riepilogo iniziale pubblicato dall’Azienda.

L’invito Collaboratore appartiene all’Azienda: mostra Azienda, ruolo e scadenza. Può essere rifiutato e, dopo l’accettazione, richiede un nuovo accesso al Workspace. Non promettere un cantiere specifico quando la preview non lo espone.

Responsive e accessibilità

Contesto, decisione e recovery devono restare leggibili e raggiungibili con ogni modalità di input.

  • Usa un solo h1 e heading ordinati per contesto, azione e stati limite.
  • Il Dialog di conferma riceve titolo e descrizione reali, trattiene il focus e lo restituisce al trigger quando viene chiuso.
  • Durante l’accettazione imposta aria-busy, disabilita le azioni e annuncia una sola volta lo stato pending.
  • Gli esiti dinamici usano status per informazioni e successo; usa alert soltanto quando serve attenzione immediata.
  • Le icone che ripetono il testo sono decorative e restano nascoste agli screen reader.
  • Su mobile il riepilogo precede sempre la CTA, i testi vanno a capo e i controlli mantengono il target touch canonico.

Errori da evitare

Un invito è comprensibile soltanto quando anticipa contesto, conseguenza e prossimo passo.

  • Mostrare “Accetta invito” senza dire chi invita, per quale lavoro e cosa succede dopo.
  • Esporre token, identificativi, stati tecnici, codici errore o messaggi backend grezzi.
  • Affiancare più CTA primarie equivalenti che non chiariscono il passo consigliato.
  • Lasciare uno stato scaduto, revocato o non disponibile senza spiegazione o recovery reale.
  • Portare alla dashboard quando la risposta di accettazione identifica già il lavoro corretto.
  • Promettere accessi, permessi o un nuovo invito automatico che il dominio non garantisce.