Procédure — onboarding navigable (stepper 5 blocs)

Procédure — onboarding navigable (stepper 5 blocs)

Cf. mémoire interne project_onboarding_navigable.md. Implémentation déjà partiellement livrée (PiloteIA.tsx).

Principe

L'onboarding n'est pas une suite linéaire de questions, mais un stepper visuel cliquable dans le header pilote, composé de 5 blocs. L'user peut naviguer librement, modifier, revenir en arrière.

Les 5 blocs

Comportement UX

• Stepper toujours visible en haut du pilote.
• Chaque bloc affiche son statut : ✓ complet, partiel, ○ vide.
• Clic sur un bloc → ouvre popover de détail avec champs éditables.
• Modifications appliquées en POST /api/v2/profil/<bloc>.
• Retour arrière propre via POST /api/v2/profil/clear-key avec cascade (efface les blocs aval qui dépendaient de la valeur effacée).

Articulation avec déduction de profil

(cf. deduction-profil-depuis-bilan)

• Si docs déposés contiennent des infos → blocs pré-remplis automatiquement.
• L'user valide ou corrige.
• Les blocs sans info déduite restent à remplir manuellement.

Articulation avec extract-facts

(cf. chat-extract-facts)

• Une déclaration en chat user ("je suis à Genève") peut remplir le bloc Identité sans passer par le formulaire.
• Le stepper se met à jour en temps réel via SSE.

Endpoint clé

POST /api/v2/profil/clear-key

{ "key": "tva.methode" }

Cascade : si on efface tva.methode, on efface aussi tva.taux, tva.n_decompte, etc.

Métrique de succès

Liens

• deduction-profil-depuis-bilan
• chat-extract-facts
• anomalies-post-categorisation