Cas d'utilisation — Administration¶

Cas d'utilisation (Use Cases) de l'espace d'administration Primatch. Chaque UC décrit un scénario fonctionnel complet avec ses préconditions, son flux principal et ses alternatives.

UC-ADMIN-001 · Consulter le tableau de bord¶

Acteur : Administrateur

Précondition : L'utilisateur est authentifié avec le rôle admin.

Flux principal :

1. L'administrateur accède à l'espace admin.
2. Le système affiche le tableau de bord avec les KPIs en temps réel.
3. Les courbes d'évolution des inscriptions et des parties sont affichées.
4. La liste des clubs en attente de validation est visible.
5. La distribution des joueurs par niveau est affichée.

Flux alternatifs :

• Aucun club en attente : Le message « Aucun club en attente » est affiché.
• Clic sur un club en attente : Navigation vers la page de gestion des clubs.
• Clic sur « Voir la file » : Navigation vers la page de gestion des clubs.

UC-ADMIN-010 · Gérer les niveaux de jeu¶

Acteur : Administrateur

Précondition : L'utilisateur est authentifié avec le rôle admin.

UC-ADMIN-010a · Lister les niveaux¶

Flux principal :

1. L'administrateur navigue vers « Niveaux » dans la sidebar.
2. Le système affiche la liste de tous les niveaux triés par sort_order.
3. Pour chaque niveau : nom, plage de valeurs [min – max].
4. Le pied de page affiche le nombre total de niveaux actifs et la plage de compétence couverte.

UC-ADMIN-010b · Créer un niveau¶

Flux principal :

1. L'administrateur clique sur « Ajouter un niveau ».
2. Le formulaire de création s'ouvre avec les champs : nom, valeur min, valeur max.
3. L'administrateur remplit les champs et valide.
4. Le système crée le niveau et rafraîchit la liste.

Flux alternatifs :

• Chevauchement de plage : Le serveur rejette la création (erreur 422).

UC-ADMIN-010c · Modifier un niveau¶

Flux principal :

1. L'administrateur clique sur l'icône d'édition d'un niveau.
2. Le formulaire de modification s'ouvre pré-rempli.
3. L'administrateur modifie les champs et valide.
4. Le système met à jour le niveau.

UC-ADMIN-010d · Supprimer un niveau¶

Flux principal :

1. L'administrateur clique sur l'icône de suppression d'un niveau.
2. Le système supprime le niveau définitivement.
3. La liste est rafraîchie.

UC-ADMIN-010e · Restaurer les défauts¶

Flux principal :

1. L'administrateur clique sur « Restaurer les défauts ».
2. Le système supprime tous les niveaux existants.
3. Les niveaux par défaut sont recréés depuis le seeder.
4. La liste est rafraîchie.

UC-ADMIN-020 · Gérer les utilisateurs¶

Acteur : Administrateur

Précondition : L'utilisateur est authentifié avec le rôle admin.

UC-ADMIN-020a · Rechercher des utilisateurs¶

Flux principal :

1. L'administrateur navigue vers « Utilisateurs ».
2. La liste paginée de tous les utilisateurs est affichée.
3. L'administrateur saisit un terme de recherche (nom, email).
4. La liste se filtre en temps réel.

Flux alternatifs :

• Filtrage par rôle : L'administrateur clique sur un bouton de filtre (Tous, Joueur, Gestionnaire, Admin).

UC-ADMIN-020b · Consulter le détail d'un utilisateur¶

Flux principal :

1. L'administrateur clique sur l'icône de visualisation d'un utilisateur.
2. Un panneau latéral s'ouvre avec les informations détaillées :
   • Nom complet, email, rôle, ville
   • Niveau de jeu, score de fiabilité
   • Statistiques (parties jouées, victoires, défaites)
   • Date d'inscription
3. L'administrateur ferme le panneau en cliquant sur l'icône de fermeture.

UC-ADMIN-030 · Gérer les clubs¶

Acteur : Administrateur

Précondition : L'utilisateur est authentifié avec le rôle admin.

UC-ADMIN-030a · Lister et filtrer les clubs¶

Flux principal :

1. L'administrateur navigue vers « Clubs ».
2. La liste paginée des clubs est affichée avec leur statut (badge couleur).
3. L'administrateur filtre par onglets : « Tous les clubs », « En attente », « Suspendus ».

UC-ADMIN-030b · Approuver un club¶

sequenceDiagram
    actor A as Admin
    participant F as Frontend
    participant B as Backend

    A->>F: Clic "Valider" sur un club en attente
    F->>B: POST /api/v1/admin/clubs/{id}/approve
    B-->>F: 200 { message: "Club approuvé" }
    F->>F: Rafraîchit la liste des clubs
    F-->>A: Club affiché avec statut "Validé"

Flux principal :

1. L'administrateur clique sur « Valider » pour un club en attente.
2. Le système envoie la requête d'approbation.
3. Le statut du club passe à validated.
4. La liste se rafraîchit automatiquement.

UC-ADMIN-030c · Rejeter un club¶

Flux principal :

1. L'administrateur clique sur « Rejeter » pour un club en attente.
2. Le système envoie la requête de rejet.
3. Le statut du club passe à suspended.

UC-ADMIN-030d · Suspendre un club¶

Flux principal :

1. L'administrateur clique sur l'icône de suspension pour un club validé.
2. Le statut du club passe à suspended.

UC-ADMIN-040 · Gérer les paramètres¶

Acteur : Administrateur

Précondition : L'utilisateur est authentifié avec le rôle admin.

UC-ADMIN-040a · Modifier un document légal¶

Flux principal :

1. L'administrateur navigue vers « Paramètres ».
2. L'onglet « Documents légaux » est affiché par défaut.
3. L'administrateur sélectionne un sous-onglet : CGU, Politique de confidentialité, ou Mentions légales.
4. Le contenu actuel est affiché dans un éditeur de texte.
5. L'administrateur modifie le contenu et clique sur « Enregistrer ».
6. Le système sauvegarde les modifications.

UC-ADMIN-040b · Gérer la FAQ¶

Flux principal :

1. L'administrateur clique sur l'onglet « Gestion FAQ ».
2. La liste des questions-réponses est affichée.
3. L'administrateur peut :
   • Ajouter une Q&R via le formulaire « Ajouter une Q&R ».
   • Modifier une Q&R existante via l'icône d'édition.
   • Supprimer une Q&R via l'icône de suppression.
4. Les modifications sont sauvegardées automatiquement côté serveur.

UC-ADMIN-040c · Configurer le délai de rappel¶

Flux principal :

1. L'administrateur clique sur l'onglet « Configuration ».
2. Le sélecteur de délai de rappel est affiché avec les options : 1h, 2h, 24h.
3. L'administrateur sélectionne une valeur et enregistre.

UC-ADMIN-050 · Contrôle d'accès¶

Acteur : Utilisateur non-admin

Précondition : L'utilisateur est authentifié avec un rôle différent de admin.

Flux principal :

1. L'utilisateur tente d'accéder à une URL admin (ex : /admin/dashboard).
2. Le ProtectedRoute vérifie le rôle.
3. Le rôle ne correspond pas → redirection vers la page d'accueil.

UC-ADMIN-060 · Consulter les logs système¶

Acteur : Administrateur

Précondition : L'utilisateur est authentifié avec le rôle admin.

Flux principal :

1. L'administrateur navigue vers « Logs » dans la sidebar admin.
2. Le système affiche la liste des fichiers de log journaliers (date, taille, nombre d'entrées).
3. L'administrateur sélectionne une date.
4. Les entrées de log sont affichées avec horodatage, niveau, message et contexte.
5. L'administrateur peut rechercher, filtrer par niveau (ERROR, WARNING, INFO…), et trier.

Flux alternatifs :

• Aucun fichier de log : Le message « Aucun fichier de log disponible » est affiché.
• Aucune entrée correspondant aux filtres : Le message « Aucune entrée de log trouvée » est affiché.
• Clic sur une entrée : Le contexte JSON associé est affiché en détail.

UC-ADMIN-070 · Consulter les analytics de visites¶

Acteur : Administrateur

Précondition : L'utilisateur est authentifié avec le rôle admin.

Flux principal :

1. L'administrateur navigue vers « Analytics » dans la sidebar admin.
2. Le système affiche le tableau de bord analytics avec les KPIs pour la période sélectionnée.
3. Les indicateurs affichés : visiteurs uniques, pages vues, durée moyenne de session, taux de rebond.
4. Un graphique de tendance (AreaChart) montre l'évolution des visites et visiteurs uniques.
5. Le tableau des pages populaires liste les pages les plus visitées avec nombre de vues et visiteurs uniques.
6. La répartition par appareil (desktop, mobile, tablet) est affichée en camembert.
7. Les sources de trafic sont listées avec barres de progression.

Flux alternatifs :

• Changement de période : L'administrateur clique sur un bouton de période (Aujourd'hui, 7j, 30j, 90j) pour recalculer les statistiques.
• Aucune donnée : Le message « Aucune donnée pour cette période » est affiché.