> ## Documentation Index
> Fetch the complete documentation index at: https://help.openfishingcup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Championnat de Club

> Guide complet pour créer et gérer votre Championnat de Club

# Championnat de Club

Le Championnat de Club est un format de compétition privé conçu pour les clubs de pêche, les groupes d'amis ou toute communauté de pêcheurs organisée. En tant qu'administrateur de tournoi, vous avez le contrôle total sur les règles d'espèces, la gestion des participants et la modération — le tout au sein de la plateforme Open Fishing Cup.

## Qui peut créer un Championnat de Club ?

Tout utilisateur enregistré peut créer un Championnat de Club. Une fois créé, vous recevez automatiquement le rôle d'**Administrateur de tournoi** pour cette compétition, vous donnant accès aux outils de gestion et de modération.

<Note>
  Il existe une limite configurable sur le nombre de compétitions qu'un seul utilisateur peut créer.
</Note>

## Tarification

Les Championnats de Club sont facturés **par participant, par an** en paiement unique — il n'y a pas de renouvellement automatique.

* Le tarif par défaut est de **2,00 € par participant**
* Un pourcentage de réduction global peut être disponible (jusqu'à 100% de réduction)
* Le prix final est calculé et affiché avant la confirmation

<Frame>
  <img src="https://mintcdn.com/openfishingcup/Y1Zmee2IcdMndgdM/images/admin/pricing-summary.png?fit=max&auto=format&n=Y1Zmee2IcdMndgdM&q=85&s=6162ff1afc97ea1f46355a2fe534c052" alt="Résumé tarifaire montrant le coût par participant et la réduction" width="471" height="962" data-path="images/admin/pricing-summary.png" />
</Frame>

***

## Créer un Championnat

Naviguez vers **Compétitions → Créer un Championnat de Club** ou visitez la page `/club-championship`.

### Étape 1 : Informations de base

| Champ                 | Description                                                      |
| --------------------- | ---------------------------------------------------------------- |
| **Titre**             | Le nom de votre championnat (ex : « Maîtres du Brochet 2026 »)   |
| **Description**       | Une courte description visible par les participants              |
| **Pays**              | Sélectionnez un ou plusieurs pays où les prises seront acceptées |
| **Date de début**     | Le premier jour de la compétition                                |
| **Date de fin**       | Le dernier jour de la compétition                                |
| **Participants max.** | Nombre maximum de pêcheurs pouvant s'inscrire                    |

<Warning>
  Les dates de début et de fin doivent être dans la **même année civile**.
</Warning>

<Frame>
  <img src="https://mintcdn.com/openfishingcup/7TiLCcqyoHeU9zqC/images/admin/create-championship-form.png?fit=max&auto=format&n=7TiLCcqyoHeU9zqC&q=85&s=ddd661ef669c6c560b963148c0f344b5" alt="Formulaire de création de Championnat de Club" width="461" height="997" data-path="images/admin/create-championship-form.png" />
</Frame>

### Étape 2 : Configuration des espèces

Sélectionnez les espèces éligibles pour votre championnat. Pour chaque espèce, vous pouvez configurer :

* **Longueur minimale (cm)** — Les prises en dessous de cette longueur ne marqueront pas de points
* **Entrées max.** — Combien de prises de cette espèce comptent dans le classement par pêcheur
* **Multiplicateur** — Un multiplicateur de score appliqué à la longueur (ex : 1,5× pour le brochet)

<Tip>
  Au moins une espèce doit être sélectionnée. Les valeurs par défaut sont pré-remplies à partir de la base de données des espèces de la plateforme, mais vous pouvez les personnaliser librement.
</Tip>

### Étape 3 : Poisson bonus

Définissez la valeur du **Poisson bonus** — les X meilleurs poissons supplémentaires de toute espèce autorisée dans le tournoi ayant obtenu le plus de points. Ces prises supplémentaires sont ajoutées au total du pêcheur, récompensant la régularité sur toutes les espèces éligibles.

### Étape 4 : Confirmer et payer

Vérifiez le résumé tarifaire :

* Nombre de places participants × prix par participant
* Toute réduction applicable
* Montant total

Après confirmation, votre championnat est créé et vous êtes redirigé vers le tableau de bord de gestion.

***

## Gérer votre Championnat

Naviguez vers **Menu → Gérer les compétitions** pour voir tous les championnats que vous administrez.

### Cartes de compétition

Chaque compétition est affichée sous forme de carte montrant :

* **Badge de statut** : À venir (gris), En cours (vert) ou Terminé (rouge)
* **Nombre de participants** : Pour les compétitions publiques : *Inscrits / Max*. Pour les privées : *Inscrits / Invités*
* **Badge de paiement** (€) : Indique qu'il s'agit d'un Championnat de Club payant

<Frame>
  <img src="https://mintcdn.com/openfishingcup/Z0OteU9Ds7ce8dD4/images/admin/manage-competitions-dashboard.png?fit=max&auto=format&n=Z0OteU9Ds7ce8dD4&q=85&s=9f10ead4aa11e0dea3e5f0b88b99810e" alt="Tableau de bord Gérer les compétitions avec cartes" width="1249" height="407" data-path="images/admin/manage-competitions-dashboard.png" />
</Frame>

### Modifier les paramètres

Cliquez sur le bouton **Modifier** d'une carte de compétition pour changer les paramètres :

* Titre, description, pays
* Configuration des espèces (longueur min., entrées max., multiplicateur)
* Valeur du poisson bonus
* Participants max.
* Dates de début et de fin (dans la même année civile)

***

## Inviter des participants (Liste autorisée)

Les Championnats de Club sont **privés par défaut**. Seuls les utilisateurs sur la liste autorisée peuvent s'inscrire.

Cliquez sur le bouton **Gérer la liste** de votre carte de compétition.

### Ajouter des utilisateurs

* **Adresse email** : Saisissez n'importe quelle adresse email pour ajouter quelqu'un à la liste autorisée — la personne n'a pas besoin d'avoir un compte existant. Si l'email appartient à un utilisateur enregistré, il est lié automatiquement ; sinon, une invitation est envoyée pour créer un compte.
* **Import CSV** : Téléchargez un fichier CSV avec des adresses email pour inviter en masse

### Comment fonctionnent les invitations (Magic Links)

Lorsque vous ajoutez un email à la liste autorisée, le système envoie un email d'invitation **Magic Link** à cette personne. L'invitation fonctionne différemment selon que le destinataire a déjà un compte ou non :

| Statut du destinataire   | Ce qui se passe                                                                                        |
| ------------------------ | ------------------------------------------------------------------------------------------------------ |
| **Utilisateur existant** | Il reçoit un email avec un lien qui le dirige directement vers la page de classement de la compétition |
| **Nouvel utilisateur**   | Il reçoit un email avec un lien vers une page d'inscription avec son email pré-rempli                  |

<Info>
  Lorsqu'un nouvel utilisateur arrive via un lien d'invitation, le **bouton de connexion Google est masqué** sur la page d'inscription. Cela garantit qu'il s'inscrit avec l'adresse email exacte associée à son invitation.
</Info>

Une fois qu'un nouvel utilisateur complète son inscription, son profil est **automatiquement lié** à l'invitation en attente — aucune action manuelle nécessaire de la part de l'administrateur.

### Badges de statut de la liste

L'interface de la liste suit la progression de chaque invitation avec des badges de statut :

| Badge              | Signification                                                               |
| ------------------ | --------------------------------------------------------------------------- |
| ✅ **Inscrit**      | L'utilisateur a un compte et s'est inscrit à la compétition                 |
| 🕐 **Non inscrit** | L'utilisateur a un compte mais ne s'est pas encore inscrit                  |
| ✉️ **En attente**  | L'invitation a été envoyée mais l'utilisateur n'a pas encore créé de compte |

### Renvoyer des invitations

Vous pouvez **renvoyer** un email d'invitation à tout utilisateur de la liste qui ne s'est pas encore inscrit. C'est utile si l'email original a été manqué ou a expiré.

### Retirer des utilisateurs

Lorsque vous retirez un utilisateur de la liste :

* Son **inscription** est automatiquement supprimée
* Ses **données de classement** sont automatiquement supprimées
* Il n'apparaîtra plus dans la compétition

### Visibilité des compétitions privées

Les compétitions privées restent **visibles par tous les utilisateurs** dans les listes publiques avec un badge **« Sur invitation uniquement »**. Cependant, le bouton d'inscription n'est affiché qu'aux utilisateurs éligibles (ceux sur la liste, le propriétaire de la compétition ou les administrateurs assignés).

<Frame>
  <img src="https://mintcdn.com/openfishingcup/r3sa6dUM_rUZ6gG3/images/admin/allowlist-management.png?fit=max&auto=format&n=r3sa6dUM_rUZ6gG3&q=85&s=774b2f3693e191fa833c408c3462472a" alt="Dialogue de gestion de la liste avec recherche, import CSV et badges de statut" width="472" height="556" data-path="images/admin/allowlist-management.png" />
</Frame>

***

## Envoyer des messages aux participants

Vous pouvez envoyer des messages à tous les participants inscrits de votre championnat.

Cliquez sur le bouton **Message** de votre carte de compétition.

### Options de message

| Champ          | Description                                         |
| -------------- | --------------------------------------------------- |
| **Canal**      | Choisissez Email, Notification push ou Les deux     |
| **Répondre à** | Votre adresse email pour les réponses (pré-remplie) |
| **Objet**      | Objet du message (max. 200 caractères)              |
| **Message**    | Corps du message (max. 2 000 caractères)            |

Le dialogue affiche le **nombre de destinataires** — le nombre de participants inscrits qui recevront votre message.

<Frame>
  <img src="https://mintcdn.com/openfishingcup/r3sa6dUM_rUZ6gG3/images/admin/message-sender.png?fit=max&auto=format&n=r3sa6dUM_rUZ6gG3&q=85&s=796f3077d1d3060dce5b13861cb97743" alt="Dialogue d'envoi de message avec sélection du canal" width="412" height="560" data-path="images/admin/message-sender.png" />
</Frame>

***

## Voir le classement

Cliquez sur le bouton **Classement** de votre carte de compétition ou naviguez directement vers la page de classement. Le classement affiche :

* Rang global et points totaux par pêcheur
* Détail des points par espèce
* Points bonus de la diversité des espèces
* Détails individuels des prises avec points gagnés

Les classements sont automatiquement recalculés lorsque des prises sont approuvées, rejetées ou exclues.

***

## Renouveler / Dupliquer

Lorsqu'un championnat se termine (statut : **Terminé**), vous pouvez le **dupliquer** pour la saison suivante :

1. Cliquez sur le bouton **Dupliquer** de la carte de compétition terminée
2. Le formulaire est pré-rempli avec les mêmes paramètres (titre, espèces, règles)
3. Les dates sont automatiquement définies pour l'**année civile suivante**
4. Ajustez les paramètres si nécessaire et confirmez

Cela crée un tout nouveau championnat — les participants devront s'inscrire à nouveau.

***

## Supprimer un Championnat

Vous pouvez supprimer un championnat depuis le tableau de bord de gestion. **Cette action est irréversible.**

Lors de la suppression d'un championnat, les données suivantes sont définitivement supprimées :

* Toutes les inscriptions
* Tous les classements et points de prises
* Toutes les entrées de la liste autorisée
* Tous les enregistrements d'exclusion de prises
* Logos, trophées et images de sponsors du stockage
* Logs de calcul de classement

<Warning>
  Si vous êtes la seule compétition assignée à votre rôle d'Administrateur de tournoi, la suppression du championnat **révoquera automatiquement votre rôle d'Administrateur de tournoi**.
</Warning>
