initial commit

docs/front-end-spec/user-flows.md

@@ -0,0 +1,123 @@
+# User Flows
+
+## Flow 1: Trouver les personnages qui n'ont pas fait X
+
+**User Goal:** Identifier rapidement quels personnages n'ont pas complété une progression spécifique
+
+**Entry Points:** Dashboard → Widget Progressions, Sidebar → Personnages, Fiche Team
+
+**Success Criteria:** Liste filtrée affichée en < 3 clics, < 5 secondes
+
+```mermaid
+graph TD
+    A[Dashboard] --> B[Clic Personnages]
+    B --> C[Liste avec Filtres]
+    C --> D[Ouvrir filtre Progression]
+    D --> E[Sélectionner type]
+    E --> F[Sélectionner N'a pas fait]
+    F --> G[✅ Liste filtrée affichée]
+
+    G --> H{Action suivante?}
+    H --> I[Voir fiche perso]
+    H --> J[Sélectionner plusieurs]
+    J --> K[Bulk Update]
+```
+
+**Edge Cases:**
+- Aucun résultat → Message "Tous les personnages ont complété X" avec bouton reset
+- Filtres combinés complexes → Indicateur des filtres actifs + "Clear all"
+
+## Flow 2: Composer une team valide
+
+**User Goal:** Créer ou modifier une team en respectant la contrainte compte
+
+**Success Criteria:** Team créée avec membres valides, erreur claire si conflit
+
+```mermaid
+graph TD
+    A[Liste Teams] --> B[Nouvelle Team]
+    B --> C[Modal création]
+    C --> D[Saisir nom + type]
+    D --> E[Enregistrer]
+    E --> F[Fiche Team vide]
+
+    F --> G[Ajouter membre]
+    G --> H[Sélecteur personnages]
+    H --> I[Sélectionner perso]
+
+    I --> K{Même compte dans team?}
+    K -->|Non| L[✅ Membre ajouté]
+    K -->|Oui| M[❌ Erreur conflit]
+    M --> H
+
+    L --> O{Continuer?}
+    O -->|Oui| G
+    O -->|Non| P[✅ Team complète]
+```
+
+## Flow 3: Bulk update progressions pour une team
+
+**User Goal:** Marquer une progression faite pour tous les membres d'une team
+
+**Success Criteria:** Mise à jour de N personnages en < 30 secondes
+
+```mermaid
+graph TD
+    A[Fiche Team] --> B[Section Statut Progressions]
+    B --> C[Sélectionner progression]
+    C --> D[Voir statut par membre]
+    D --> E{Tous faits?}
+    E -->|Non| G[Bouton Marquer fait pour tous]
+
+    G --> H[Modal confirmation]
+    H --> I[Récap: X persos à mettre à jour]
+    I --> J{Confirmer?}
+    J -->|Oui| K[Processing...]
+    K --> L[✅ Toast: X persos mis à jour]
+    L --> M[Refresh → 100%]
+```
+
+## Flow 4: Ajouter un nouveau personnage
+
+**User Goal:** Créer un personnage avec toutes ses informations
+
+**Success Criteria:** Personnage créé et visible en < 1 minute
+
+```mermaid
+graph TD
+    A[Liste Personnages] --> B[Clic Ajouter]
+    B --> C[Modal création]
+    C --> D[Saisir pseudo]
+    D --> E[Sélectionner classe]
+    E --> F[Saisir niveau]
+    F --> G[Sélectionner serveur]
+    G --> H[Sélectionner compte]
+    H --> I{Validation}
+    I -->|OK| J[Enregistrer]
+    J --> K[✅ Toast confirmation]
+    K --> L[Liste rafraîchie]
+```
+
+## Flow 5: Consulter le Dashboard
+
+**User Goal:** Vue d'ensemble instantanée de tous les comptes et personnages
+
+**Success Criteria:** Toutes les informations clés visibles sans scroll sur desktop
+
+```mermaid
+graph TD
+    A[Accès Dashboard] --> B[Chargement widgets]
+    B --> C[Affichage simultané]
+
+    C --> D[Widget Comptes]
+    C --> E[Widget Personnages]
+    C --> F[Widget Teams]
+    C --> G[Widget Monnaies]
+    C --> H[Widget Progressions]
+
+    D --> I[Clic → Liste comptes]
+    E --> J[Clic → Liste personnages]
+    F --> K[Clic → Liste teams]
+```
+
+---