Simpl-Resultat/docs/qa-refonte-seed-categories-ipc.md

QA — Refonte seed catégories IPC

Checklist manuelle pour valider le flow complet de migration v2→v1 (spec spec-refonte-seed-categories-ipc). À dérouler avant chaque release touchant au module catégories.

Prérequis

• Profil de test v2 avec au moins : 10+ catégories seedées, 2-3 catégories custom, 50+ transactions réparties, quelques suppliers et keywords, un budget actif.
• Profil de test v1 (nouveau profil créé après #115) pour les tests de régression.
• Variante profil v2 avec PIN activé (profil chiffré).

---

1. Pré-migration (découverte)

• Ouvrir l'app sur un profil v2 → bannière dashboard "Découvrez la nouvelle structure" (#118) visible en haut.
• Cliquer CTA bannière → redirige vers /settings/categories/standard (#117).
• Dismiss la bannière → disparaît immédiatement, reste dismiss après redémarrage de l'app.
• Créer un nouveau profil v1 (ou charger le profil v1 de test) → bannière pas affichée.

2. Page Guide des catégories standard (#117)

• Arbre affiche les 3 niveaux avec les noms traduits (FR et EN).
• Switcher EN → les noms basculent, l'arbre conserve son état d'expansion.
• Tooltip au hover d'un nœud affiche i18n_key, type, id.
• Compteur "N catégories" en haut correspond au nombre total de leaves.
• Recherche full-text filtre les noms correctement (accent-insensitive).
• Bouton Print → impression/PDF avec arbre entièrement déplié et toolbar masquée.
• Lien "Voir les catégories standard" dans Settings > Catégories → même page.

3. Page de migration — Étape 1 (Discover)

• Depuis Settings > Catégories sur un profil v2, cliquer "Migrer vers la nouvelle structure" → /settings/categories/migrate.
• Étape 1 affiche l'arbre v1 (read-only, comme la page Guide).
• Bouton Next passe à l'étape 2.

4. Page de migration — Étape 2 (Simulate)

• Table 3 colonnes : v2 source | confidence badge | cible v1 + action.
• Badges corrects : 🟢 haute (keyword), 🔵 moyenne (supplier), 🟠 basse (default), 🔴 aucune (review).
• Stats summary en haut : total / high / medium / low / none.
• Section "Catégories personnalisées préservées" liste les custom du profil (si présentes).
• Cliquer une ligne 🟠 ou 🔴 → panneau latéral "Transactions impactées" affiche jusqu'à 50 transactions liées.
• Pour une ligne unresolved, ouvrir le picker de cible → sélectionner un leaf v1 → badge passe à ✅ résolu.
• Bouton Next disabled tant qu'il reste des lignes unresolved.
• Résoudre toutes les unresolved → Next devient actif.

5. Page de migration — Étape 3 (Consent)

• Checklist obligatoire : "J'ai compris…", "Je consens…", "Je sauvegarde avant…".
• Bouton Apply disabled tant que la checklist n'est pas complète.
• Sur profil avec PIN, champ PIN demandé.
• Apply déclenche : loader 4 sous-étapes (1. Sauvegarde, 2. Insertion v1, 3. Remap transactions/budgets, 4. Cleanup v2).

6. Migration — cas nominal

• Après Apply, écran de succès affiche :
  • Chemin du backup SREF (ex: ~/Documents/Simpl-Resultat/backups/MonProfil_avant-migration-2026-04-21T12-34-56.sref).
  • Récap : nb v1 insérées, nb transactions updatées, nb budgets updatées, nb keywords updatés, nb v2 désactivées, nb custom préservées.
  • Liens vers Dashboard / Voir les catégories.
• Retour au Dashboard → bannière dashboard #118 disparue.
• Settings > Catégories → bannière "Sauvegarde disponible" (#122) visible (90 jours).
• Page Catégories → affiche la structure v1.

7. Migration — échec backup

Simuler : rendre le dossier ~/Documents/Simpl-Resultat/backups/ non-writable (Linux : chmod -w, Windows : permissions lecture seule) avant de lancer Apply.

• Apply échoue à l'étape 1 (Sauvegarde).
• Message d'erreur clair : "Impossible de créer la sauvegarde. Aucune modification n'a été effectuée."
• Aucune écriture BDD : via outil SQLite, vérifier que categories, transactions, budgets, keywords sont strictement identiques avant/après.
• Flag categories_schema_version reste à v2.
• Bouton retry dispo ; rétablir les droits d'écriture, relancer → succès.

8. Migration — échec SQL (rollback)

Plus difficile à reproduire ; le chemin testé unitairement est le ROLLBACK déclenché si un UPDATE casse une contrainte FK/UNIQUE. Tester en injectant artificiellement une contrainte (ex: DB corrompue) si un outil le permet, sinon revue de code suffit. La checklist minimale :

• Si un échec est simulé, écran d'erreur affiche "La migration a échoué. Vos données n'ont pas été modifiées. Votre sauvegarde est disponible à ."
• BDD intacte (même check qu'au point 7).
• Backup SREF créé (toujours disponible sur le disque).

9. Bannière post-migration (#122) — 90 jours

• Migration récente → bannière Settings > Catégories visible.
• Date d'expiration affichée = timestamp migration + 90 jours.
• Cliquer "Fermer" → bannière disparaît, flag categories_migration_banner_dismissed=1, ne réapparaît plus après redémarrage.
• Après 90 jours (avancer l'horloge système ou manipuler last_categories_migration.timestamp dans la DB) → bannière plus affichée, mais entrée permanente "Rétablir une sauvegarde" reste dispo dans Settings.

10. Rétablir la sauvegarde (#122)

• Cliquer "Rétablir la sauvegarde" depuis bannière ou depuis l'entrée permanente.
• Modale s'ouvre : chemin backup affiché, texte de warning, boutons Annuler / Rétablir (rouge).
• Sur profil chiffré (PIN), champ PIN demandé.
• Simuler fichier manquant : renommer/déplacer le .sref avant de cliquer Rétablir → erreur claire + file picker de secours.
• Choisir le fichier via le picker → la restauration procède.
• Après succès :
  • Toast / message succès.
  • L'app recharge, catégories v2 à nouveau actives.
  • categories_schema_version revient à v2.
  • last_categories_migration.reverted_at renseigné (ISO string).
  • Transactions, budgets, keywords correspondent à l'état pré-migration.
• Annuler la modale → aucune modification.

11. Profil avec catégories custom

• Migration préserve les 3 custom sous un parent "Catégories personnalisées (migration)" (id 2000).
• Les transactions liées aux custom conservent leur category_id.
• Les keywords liés aux custom conservent leur category_id.

12. Profil sans catégories custom

• Migration ne crée pas de parent "Catégories personnalisées (migration)" (section preserved vide → skip).

13. Régression — fonctionnalités auxiliaires

Tester sur profil v2 ET profil v1 pour vérifier qu'aucune fonctionnalité n'a cassé :

• Auto-catégorisation CSV : importer un CSV de test → catégorisation par keyword/supplier fonctionne identiquement.
• Budget vs Actuel : agrégation parent/enfant cohérente, montants corrects.
• Splits : transactions multi-catégories préservent leurs ratios.
• Export/Import SREF : export d'un profil v1 → re-import dans un nouveau profil → structure identique.
• UI CategoryTree et CategoryCombobox : rendent correctement l'arbre v1 et v2, pas d'affichage cassé ou mélangé.
• Rapports : aucune régression sur les graphiques catégorie (tendances, répartition).

14. i18n

• Toutes les nouvelles pages (Guide, Migration, bannières, modale) supportent FR et EN.
• Aucune chaîne en dur visible à l'écran.
• Bascule live FR↔EN ne casse pas l'état local des pages.

---

Tests automatisés équivalents

Pour référence, les chemins de tests automatisés qui couvrent partiellement cette checklist :

• Unitaires : src/services/categoryMappingService.test.ts (100 tests), src/services/categoryBackupService.test.ts (23), src/services/categoryMigrationService.test.ts (16), src/services/categoryTaxonomyService.test.ts (15), src/services/categoryRestoreService.test.ts (12), src/hooks/useCategoryMigration.test.ts (13).
• Intégration : src/__integration__/category-migration.test.ts (flow + échecs + rollback).
• Régression : src/__integration__/regression-v2-v1.test.ts (auto-catégorisation, budget agrégation, splits paramétrés v2/v1).

Cette QA manuelle couvre les dimensions UX, erreurs système (permissions, fichiers manquants), profil chiffré et régression visuelle qui ne sont pas automatisables actuellement.