Gain de temps considérable pour les grands tournois avec de nombreux participants (>50 joueurs).

# Pourquoi utiliser l'import Excel ?

# ✅ Avantages

• Rapidité : créer 100+ joueurs en quelques secondes
• Fiabilité : validation automatique des données
• Mise à jour : modifier des joueurs existants en masse
• Réutilisable : sauvegarder et réutiliser vos listes

# 📊 Cas d'usage

• Grand tournoi avec préinscriptions
• Import depuis un autre système
• Mise à jour des classements FFT
• Création de base de joueurs récurrents

# Étape 1 : Télécharger le Template

1. Connectez-vous en tant que JAP
2. Menu "Joueurs" → "Import Excel"
3. Cliquez sur "Télécharger le Template Excel"
4. Ouvrez le fichier .xlsx téléchargé

Le template contient :
- Les colonnes obligatoires et optionnelles
- Des exemples de lignes correctement remplies
- Des instructions dans un onglet séparé

# Étape 2 : Remplir le Template

# Colonnes obligatoires ⚠️

Ces colonnes doivent être renseignées pour chaque joueur :

💡 Le nom sera automatiquement normalisé en MAJUSCULES.

# Colonnes optionnelles

# Classements FFT acceptés

Le système reconnaît tous les classements officiels FFT Padel :

💡 Si vous renseignez à la fois le classement et les points, le système privilégie la conversion du label.

# Exemples de lignes valides

DUPONT | Jean | jean.dupont@test.com | 15/03/1990 | H | 1234567 | 15 | 650 | 0612345678
MARTIN | Sophie | sophie.martin@test.com | 22/07/1985 | F | 2345678 | 30/1 | 350 | 0698765432
BERNARD | Luc | luc.bernard@test.com | | | | NC | 0 |

⚠️ Les colonnes vides sont acceptées pour les champs optionnels.

# Étape 3 : Importer le Fichier

# Lancer l'import

1. Retournez sur "Joueurs" → "Import Excel"
2. Cliquez sur "Parcourir"
3. Sélectionnez votre fichier .xlsx complété
4. Cliquez sur "Lancer l'import"

# Validation en cours

Le système traite chaque ligne et vérifie :
- ✅ Format des données
- ✅ Validité des emails
- ✅ Cohérence des classements
- ✅ Unicité des emails (pas de doublons)

Durée : ~1 seconde pour 100 joueurs.

# Étape 4 : Vérifier les Résultats

# Résumé de l'import

À la fin, un résumé s'affiche :

✅ Import réussi !
- 85 joueurs créés
- 10 joueurs mis à jour
- 5 lignes ignorées

Détails des erreurs :
Ligne 23 : Email invalide (format incorrect)
Ligne 45 : Classement FFT inconnu ("25/2" n'existe pas)
Ligne 67 : Email dupliqué (déjà utilisé par un autre joueur)
Ligne 89 : Nom manquant
Ligne 102 : Prénom manquant

# Actions possibles

• ✅ Créés : nouveaux joueurs ajoutés à la base
• 🔄 Mis à jour : joueurs existants (même email) avec données actualisées
• ❌ Ignorés : lignes avec erreurs (non importées)

💡 Les joueurs créés et mis à jour sont immédiatement disponibles pour les inscriptions.

# Mise à jour de joueurs existants

# Comment ça fonctionne ?

Le système détecte un joueur existant par son email :
- Si l'email existe déjà → mise à jour des données
- Si l'email est nouveau → création d'un nouveau joueur

# Exemple

Vous avez un joueur :

Jean DUPONT | jean.dupont@test.com | Classement: 15


Vous importez :

Jean DUPONT | jean.dupont@test.com | Classement: 15/1


Résultat : Le classement de Jean DUPONT passe à 15/1.

⚠️ Les autres données (nom, prénom, sexe...) sont également mises à jour si présentes dans l'import.

# Erreurs courantes

# ❌ Email invalide

Erreur : Email invalide (format incorrect)

Cause : Email sans @
, sans domaine, ou avec caractères interdits

Solution :

✅ jean.dupont@example.com
❌ jean.dupont
❌ jean@
❌ jean @example.com (espace)


# ❌ Classement FFT inconnu

Erreur : Classement FFT inconnu

Cause : Label non reconnu par le système

Solution : Utilisez uniquement les labels officiels FFT

✅ 15, 15/1, 30/1, NC
❌ 20, 25, P100, 15-1


# ❌ Champs obligatoires manquants

Erreur : Nom manquant
ou Prénom manquant
ou Email manquant

Cause : Cellule vide pour un champ obligatoire

Solution : Remplir toutes les colonnes obligatoires (Nom, Prénom, Email)

# ❌ Format de date invalide

Erreur : Date de naissance invalide

Formats acceptés :

✅ 15/03/1990
✅ 1990-03-15
✅ 15-03-1990
❌ 15/03/90 (année sur 2 chiffres)
❌ 03/15/1990 (format US)


# ❌ Téléphone invalide

Le système accepte :

✅ 0612345678 (10 chiffres)
✅ 06 12 34 56 78 (avec espaces)
✅ +33612345678 (format international)


⚠️ Excel peut supprimer le 0 initial. Vérifiez que le format de la colonne est "Texte" et non "Nombre".

# Corriger et réimporter

Si vous avez des erreurs :

1. Notez les numéros de ligne avec erreurs
2. Corrigez dans votre fichier Excel
3. Réimportez le fichier

💡 Les joueurs déjà importés correctement ne seront pas dupliqués (mise à jour si même email).

# Export et Réutilisation

# Exporter la base actuelle

Pour créer un fichier à partir de vos joueurs existants :

1. Menu "Joueurs"
2. Bouton "Exporter Excel"
3. Fichier téléchargé avec tous vos joueurs

Utilisez cet export comme base pour :
- Mettre à jour des classements
- Ajouter de nouveaux champs
- Sauvegarder votre base

# Garder un Template à jour

Bonne pratique : Conservez un fichier Excel avec vos joueurs récurrents et mettez-le à jour régulièrement.

À chaque nouveau tournoi :
1. Ouvrez votre template sauvegardé
2. Ajoutez les nouveaux joueurs
3. Importez

# Limites et Performances

# Nombre de joueurs

• Recommandé : jusqu'à 500 joueurs par import
• Maximum : 1000 joueurs
• Durée : ~5 secondes pour 500 joueurs

Si vous avez plus de 1000 joueurs, découpez en plusieurs fichiers.

# Taille du fichier

• Format : .xlsx uniquement (pas .xls ou .csv )
• Taille max : 10 MB

# Sécurité et Confidentialité

# Données sensibles

⚠️ Le fichier Excel contient des données personnelles (emails, téléphones).

Bonnes pratiques :
- Ne partagez pas le fichier
- Supprimez-le après import
- Stockez-le de manière sécurisée si nécessaire

# Mot de passe des joueurs

Les joueurs importés reçoivent un mot de passe temporaire généré automatiquement.

Ils doivent :
1. Se connecter avec leur email
2. Utiliser "Mot de passe oublié"
3. Créer leur propre mot de passe

💡 Vous pouvez envoyer un email groupé aux nouveaux joueurs pour les informer.

# Support et Aide

Des questions ou problèmes lors de l'import ?

• 📧 Email : support@tournoi.club
• 📞 Téléphone : (à définir)
• 📚 FAQ : Voir section "Import Excel" de la FAQ

Astuce : Testez d'abord avec un petit fichier de 5-10 joueurs pour vous familiariser avec le processus !