Onboarding : guide, architecture et liste QA du parcours guidé #401

New issue

Closed

opened 2026-10-07 23:50:08 +00:00 by maximus · 0 comments

maximus commented

2026-10-07 23:50:08 +00:00

Owner

Milestone planned-2026-10-06-onboarding-parcours-guide, issue 6/6. Phase 2 de l'onboarding (#391) : bandeau de démarrage sur chaque page, et cartes d'étape avec mise en évidence. La spec (spec-decisions-onboarding-parcours-guide.md et spec-plan-onboarding-parcours-guide.md) est locale et ignorée par git : ce corps est auto-suffisant.

La documentation suit le parcours livré par les issues 1 à 5.

À faire

docs/guide-utilisateur.md (démarrage et liste de démarrage) et les clés docs.* FR et EN correspondantes (docs.gettingStarted, docs.profiles ou leur emplacement actuel) :
- le bandeau et sa liste ;
- les cartes d'étape et la mise en évidence ;
- « Passer » et « Reprendre » ;
- le message de fin ;
- les profils déjà actifs, masqués d'office ;
- le réaffichage depuis Paramètres → Utilisateurs.
docs/architecture.md, section « Onboarding » : fournisseur et useOnboarding(), canal dataEvents (ADR 0022), préférences (onboarding_checklist_hidden, onboarding_skipped_<clé>, onboarding_guided_initialized), verrou de carte et CARD_PAGES, modèles purs d'onboardingPath.ts, mise en évidence par props et CSS.
docs/qa-onboarding.html, liste de vérification manuelle :
- profil neuf de bout en bout, étapes 2 à 6 sans retour au tableau de bord ;
- profil déjà actif masqué d'office, puis réaffiché ;
- édition Gratuite (5 étapes, fin à 5/5) ;
- une étape qui se coche page ouverte ;
- un import qui n'ajoute rien ;
- « Passer » et « Reprendre » ;
- annonces NVDA (Windows) et Orca (Linux) ;
- prefers-reduced-motion ;
- contraste de l'anneau dans les deux thèmes ;
- clavier seul.
CHANGELOG : vérifier que les entrées des issues 1 à 5 décrivent le parcours complet, sans doublon, dans les deux langues.

Fichiers concernés

docs/guide-utilisateur.md
src/i18n/locales/fr.json, en.json (clés docs.*)
docs/architecture.md
docs/qa-onboarding.html
CHANGELOG.md, CHANGELOG.fr.md

Depends on

#400

Critères d'acceptation

Le guide (fichier et clés docs.*) décrit le parcours tel que livré, en FR et en EN, sans mention de la barre compacte retirée.
architecture.md décrit le fournisseur, le canal, les préférences, le verrou de carte et la mise en évidence, et renvoie à l'ADR 0022.
qa-onboarding.html porte chacun des cas listés.
CHANGELOG cohérent dans les deux langues ; npm run build et npx vitest run verts (les tests du guide intégré compris).

Review caveats

Les tests du guide intégré (DocsContent, DocsSubsections) lisent la structure des clés docs.* : garder la même forme.

Décisions prises en planification

D6 : la phase 2 d'origine (données de démo, guide en source unique, entrée « Aide ») reste hors de cette milestone.
D8 : un seul état masqué, la préférence onboarding_checklist_hidden par profil ; masquer le bandeau masque la liste, et le réaffichage depuis Paramètres → Utilisateurs rétablit tout.
Le fournisseur d'onboarding est le seul écrivain des préférences d'onboarding (hidden, étapes passées, initialisation).

Spec source

spec-plan-onboarding-parcours-guide.md (et spec-decisions-onboarding-parcours-guide.md)

Milestone `planned-2026-10-06-onboarding-parcours-guide`, issue 6/6. Phase 2 de l'onboarding (#391) : bandeau de démarrage sur chaque page, et cartes d'étape avec mise en évidence. La spec (`spec-decisions-onboarding-parcours-guide.md` et `spec-plan-onboarding-parcours-guide.md`) est locale et ignorée par git : ce corps est auto-suffisant. La documentation suit le parcours livré par les issues 1 à 5. ## À faire 1. **`docs/guide-utilisateur.md`** (démarrage et liste de démarrage) et les clés `docs.*` FR et EN correspondantes (`docs.gettingStarted`, `docs.profiles` ou leur emplacement actuel) : - le bandeau et sa liste ; - les cartes d'étape et la mise en évidence ; - « Passer » et « Reprendre » ; - le message de fin ; - les profils déjà actifs, masqués d'office ; - le réaffichage depuis Paramètres → Utilisateurs. 2. **`docs/architecture.md`**, section « Onboarding » : fournisseur et `useOnboarding()`, canal `dataEvents` (ADR 0022), préférences (`onboarding_checklist_hidden`, `onboarding_skipped_<clé>`, `onboarding_guided_initialized`), verrou de carte et `CARD_PAGES`, modèles purs d'`onboardingPath.ts`, mise en évidence par props et CSS. 3. **`docs/qa-onboarding.html`**, liste de vérification manuelle : - profil neuf de bout en bout, étapes 2 à 6 sans retour au tableau de bord ; - profil déjà actif masqué d'office, puis réaffiché ; - édition Gratuite (5 étapes, fin à 5/5) ; - une étape qui se coche page ouverte ; - un import qui n'ajoute rien ; - « Passer » et « Reprendre » ; - annonces NVDA (Windows) et Orca (Linux) ; - `prefers-reduced-motion` ; - contraste de l'anneau dans les deux thèmes ; - clavier seul. 4. **CHANGELOG** : vérifier que les entrées des issues 1 à 5 décrivent le parcours complet, sans doublon, dans les deux langues. ## Fichiers concernés - docs/guide-utilisateur.md - src/i18n/locales/fr.json, en.json (clés `docs.*`) - docs/architecture.md - docs/qa-onboarding.html - CHANGELOG.md, CHANGELOG.fr.md ## Depends on - #400 ## Critères d'acceptation - [ ] Le guide (fichier et clés `docs.*`) décrit le parcours tel que livré, en FR et en EN, sans mention de la barre compacte retirée. - [ ] `architecture.md` décrit le fournisseur, le canal, les préférences, le verrou de carte et la mise en évidence, et renvoie à l'ADR 0022. - [ ] `qa-onboarding.html` porte chacun des cas listés. - [ ] CHANGELOG cohérent dans les deux langues ; `npm run build` et `npx vitest run` verts (les tests du guide intégré compris). ## Review caveats - Les tests du guide intégré (`DocsContent`, `DocsSubsections`) lisent la structure des clés `docs.*` : garder la même forme. ## Décisions prises en planification - D6 : la phase 2 d'origine (données de démo, guide en source unique, entrée « Aide ») reste hors de cette milestone. - D8 : un seul état masqué, la préférence `onboarding_checklist_hidden` par profil ; masquer le bandeau masque la liste, et le réaffichage depuis Paramètres → Utilisateurs rétablit tout. - Le fournisseur d'onboarding est le seul écrivain des préférences d'onboarding (`hidden`, étapes passées, initialisation). ## Spec source spec-plan-onboarding-parcours-guide.md (et spec-decisions-onboarding-parcours-guide.md)

maximus added this to the planned-2026-10-06-onboarding-parcours-guide milestone 2026-10-07 23:50:08 +00:00

maximus added the

status:ready

type:feature

source:human

labels 2026-10-07 23:50:08 +00:00