code-review-1-5-onboarding-guide-fr2.md 2.9 KB

Code Review — Story 1.5: Onboarding guidé (FR2)

Reviewer: Augustin (AI)
Date: 2026-02-27
Story: 1-5-onboarding-guide-fr2
Git vs Story Discrepancies: N/A (projet non initialisé en git ou changements non commités)
Issues Found: 2 High, 3 Medium, 2 Low


🔴 HIGH ISSUES

1. Accessibilité — listitems orphelins (WCAG 2.1)

Fichier: OnboardingChecklist.tsx lignes 191-278

Les éléments ont role="listitem" mais le conteneur parent n'a pas role="list". Les listitems doivent être enfants d'une liste pour une structure sémantique correcte (WCAG 2.1 AA, critère 1.3.1).

Correction: Ajouter role="list" au conteneur qui enveloppe le orderedSteps.map().

2. Task 4.2 — Vérification accessibilité incomplète

Story: Task 4.2 marquée [x] — "Vérifier accessibilité (WCAG 2.1 AA) — focus, labels, structure sémantique"

La structure liste/listitem n'est pas conforme. Les labels aria sont présents mais la hiérarchie sémantique est incorrecte.


🟡 MEDIUM ISSUES

3. Test manquant — Toggle ordre des étapes (AC #3)

Fichier: OnboardingChecklist.test.tsx

AC #3 exige que l'ordre des étapes soit adaptable ("inviter" peut précéder "soumettre"). Aucun test ne vérifie que le bouton "Inviter d'abord" / "Soumettre d'abord" modifie l'ordre affiché.

4. Test manquant — Persistance du skip dans localStorage

Fichier: OnboardingChecklist.test.tsx

Aucun test ne vérifie que le clic sur "Passer" appelle localStorage.setItem avec la clé et les valeurs attendues. La persistance est une fonctionnalité revendiquée (Subtask 3.1).

5. Test manquant — Persistance de l'ordre dans localStorage

Fichier: OnboardingChecklist.test.tsx

Aucun test ne vérifie que le toggle d'ordre persiste correctement dans localStorage (onboarding_preferred_order_{workspaceId}).


🟢 LOW ISSUES

6. Design tokens — Vérification Livinia Chaleureux

Story: Dev Notes mentionnent "Design tokens : Livinia Chaleureux (#fefdfb, #7c3aed, #e7e5e4)"

Le composant utilise des classes Tailwind génériques (border-green-200, bg-primary). Vérifier que globals.css ou la config Tailwind applique bien la palette Livinia Chaleureux.

7. Validation des données localStorage

Fichier: OnboardingChecklist.tsx lignes 102-114

getSkippedSteps parse le JSON sans valider que les IDs correspondent à des OnboardingStepId valides. Des données corrompues ou manipulées pourraient introduire des IDs invalides. Recommandation : filtrer les IDs parsés contre la liste des steps valides.


Résumé

Sévérité Nombre
HIGH 2
MEDIUM 3
LOW 2

AC Validation: AC #1, #2, #3, #4 — implémentés. AC #4.2 (accessibilité) partiellement non conforme.

Tasks: Toutes les tâches marquées [x] sont implémentées, sauf la vérification accessibilité complète (Task 4.2).