Guide d'utilisation de la nouvelle interface JAP (Sprint 12)

# Vue d'ensemble

L'interface JAP a été repensée pour centraliser toutes les fonctions de gestion de tournoi dans un seul endroit, avec une navigation claire et des actions contextualisées selon le statut du tournoi.

# Dashboard JAP

# Accès

/dashboards/jap

Le dashboard JAP affiche tous vos tournois organisés par statut avec des notifications visuelles pour les actions à effectuer.

# Sections

# 🟢 En cours

Tournois actuellement en cours de jeu.
- Badges: Scores contestés (rouge), scores en attente (bleu), matchs en cours (violet)
- Actions: "Gérer le tournoi", "Voir le tableau"

# 🟡 Inscriptions ouvertes

Tournois où les inscriptions sont ouvertes.
- Badge: "X inscriptions à valider" (orange)
- Action contextuelle: "Valider les inscriptions" (si inscriptions en attente)

# 🟠 Prêts à démarrer

Tournois dont les inscriptions sont clôturées.
- Badge: "Dans X jours"
- Actions contextuelles:
- "Générer le tableau" (si tableau non généré)
- "Démarrer le tournoi" (si tableau généré)

# ⚪ Brouillons

Tournois en configuration.
- Action: "Configurer"

# 🔵 Terminés récemment

Derniers tournois terminés (30 derniers jours).
- Action: "Résultats"

# Interface de Gestion de Tournoi

# Navigation Latérale

Présente sur toutes les pages JAP, la navigation latérale offre un accès rapide à toutes les fonctions:

┌─ Interface JAP ────────────┐
│                            │
│ 📊 Vue d'ensemble          │
│ 👥 Inscriptions (3)        │  ← Badge orange si inscriptions en attente
│ 🎾 Matchs & Scores (2)     │  ← Badges rouge/jaune pour scores
│ 📋 Tableau ↗               │
│                            │
│ ⚙️  Paramètres tournoi     │
│ 🔙 Retour dashboard        │
└────────────────────────────┘

# Badges de notification

• Orange: Inscriptions en attente de validation
• Rouge: Scores contestés (urgent)
• Jaune: Scores en attente de validation

# Page Vue d'ensemble

/jap/tournaments/:id/overview

Hub central affichant l'état du tournoi avec des informations et actions adaptées au statut actuel.

# Statut: Brouillon

• ✅ Checklist de configuration
• 📝 Action: "Modifier le tournoi"
• 🚀 Action: "Ouvrir les inscriptions"

# Statut: Inscriptions ouvertes

• 📊 Stats inscriptions (validées, en attente, refusées)
• 📈 Barre de progression
• 📋 Liste des équipes en attente
• 👥 Action: "Gérer les inscriptions"
• 🔒 Action: "Clôturer les inscriptions"

# Statut: Inscriptions clôturées

• ✅ Récap inscriptions
• ⚠️ Statut génération tableau
• 📋 Liste équipes inscrites
• 🎲 Action: "Générer le tableau" (si non généré)
• ▶️ Action: "Démarrer le tournoi" (si généré)

# Statut: En cours

• 🎾 Stats matchs (en cours, terminés, à venir)
• 📊 Scores à valider (priorisés)
• 🏃 Matchs en direct
• 🎯 Action: "Gérer les matchs"
• 📋 Action: "Voir le tableau"
• 🏆 Action: "Générer la consolante" (si disponible)

# Statut: Terminé

• 🥇 Podium avec vainqueurs
• 📊 Stats finales
• 🎾 Derniers matchs
• 📥 Action: "Exporter pour la FFT"

# Page Inscriptions

/jap/tournaments/:id/teams

Gestion complète des inscriptions d'équipes.

# Fonctionnalités

• 3 cartes de stats: En attente, Validées, Refusées
• Filtres par tabs: Navigation facile entre les différents statuts
• Cards équipes détaillées:
  • Noms des joueurs
  • Classements FFT
  • Poids de paire
  • Actions (Valider/Refuser)

# Actions

• ✅ Valider: Accepter l'inscription d'une équipe
• ❌ Refuser: Rejeter l'inscription d'une équipe

# Page Matchs & Scores

/jap/tournaments/:id/matches

Suivi et validation des matchs du tournoi.

# Fonctionnalités

• Stats globales: Total matchs, en cours, terminés
• Groupement par rounds: Organisation claire par tour
• Saisie de scores:
  • Validation rapide (sélection du vainqueur)
  • Forfait
  • Saisie détaillée (score par set)

Voir le guide détaillé:
04-valider-scores.md

# Codes Couleur

# Statuts tournoi

• 🟢 Vert: En cours
• 🟡 Jaune: Inscriptions ouvertes
• 🟠 Orange: Inscriptions clôturées
• ⚪ Gris: Brouillon
• 🔵 Bleu: Terminé
• 🔴 Rouge: Annulé

# Notifications

• 🔴 Rouge: Urgent (scores contestés)
• 🟠 Orange: Attention (inscriptions en attente)
• 🟡 Jaune: Information (scores en attente)
• 🟢 Vert: Validé
• 🔵 Bleu: Information

# Navigation Mobile

L'interface JAP est entièrement responsive:
- Cartes empilées sur mobile
- Sidebar cachée avec bouton menu (à venir)
- Tabs horizontaux pour filtres
- Actions prioritaires toujours visibles

# Bonnes Pratiques

# Workflow recommandé

1. Créer le tournoi (brouillon)
2. Ouvrir les inscriptions depuis la vue d'ensemble
3. Valider les équipes via la page Inscriptions
4. Clôturer les inscriptions depuis la vue d'ensemble
5. Générer le tableau depuis la vue d'ensemble
6. Démarrer le tournoi depuis la vue d'ensemble
7. Gérer les matchs via la page Matchs & Scores
8. Générer la consolante (optionnel) depuis la vue d'ensemble
9. Exporter les résultats une fois le tournoi terminé

# Utilisation des badges

Les badges de notification sont votre meilleur allié:
- Consultez-les régulièrement dans la navigation latérale
- Priorisez les badges rouges (contestations)
- Traitez les badges orange avant de clôturer

# Raccourcis

• Retour dashboard: Toujours accessible depuis la navigation latérale
• Vue d'ensemble: Point central pour toutes les actions critiques
• Paramètres: Lien vers l'édition du tournoi

# Support

Pour toute question sur l'interface JAP:
- Consultez les guides spécifiques par fonctionnalité
- Référez-vous au
MVP Roadmap


- Consultez l'
Architecture

pour les détails techniques