# Rapport Statistiques par Nation & Prix — Guide Utilisateur

Cette extension produit un **rapport PDF** pour une semaine de concours :

1. **participation par nation** — nation hôte par rapport aux autres nations ;
2. **prix** — par compétition CSI, avec des sous-totaux par catégorie et un grand total.

Il est destiné aux rapports de la FEI, aux résumés pour les organisateurs et à la comptabilité post-concours.

---

## 1. Créer le rapport

Ouvrez l'extension depuis le concours dans Equipe, puis :

| Champ | Ce qu'il faut choisir |
|---|---|
| **Week / Show** | La semaine du rapport (un rapport = une semaine) |
| **Competitions** | Les masterlists à utiliser pour les statistiques par nation. Maintenez **Ctrl** (**Cmd** sur Mac) pour en sélectionner plusieurs |
| **Host Nation** | Le pays organisateur — requis |

Cliquez sur **Generate PDF Report**. Le PDF se télécharge directement, ex : `12345-prize-distribution-2026_CI_0799.pdf`.

> La sélection des **Competitions** n'affecte que la page 1. La page 2 couvre toujours **toutes les compétitions CSI de la semaine**.

---

## 2. Contenu du rapport

Les deux pages affichent le numéro du concours, la semaine et les coordonnées de contact en pied de page.

### Page 1 — Statistiques par Nation

Un tableau par masterlist sélectionnée :

| Ligne | Contenu |
|---|---|
| **Host Nation (XXX)** | Cavaliers et chevaux du pays hôte |
| **Other Nations** | Cavaliers et chevaux de tous les autres pays |
| **Total** | Somme des deux lignes |

- Les cavaliers et les chevaux sont comptés **une seule fois chacun**, même s'ils sont saisis plusieurs fois.
- Les chiffres sont basés sur les **engagements**, que les cavaliers aient réellement concouru ou non.
- La sélection de nombreuses masterlists peut faire s'étendre la page 1 sur plusieurs pages.

### Page 2 — Répartition des Prix

Une ligne par compétition CSI de la semaine : numéro, nom et sous-titre, nombre de cavaliers classés et prix en euros.
En dessous : un **sous-total par catégorie** (CSI1 à CSI5, CSIO, CSIYH, CSIAm-A, CSIAm-B, CSIP, CSIV, CSIU25) et le **grand total**.

> Les prix ne sont définitifs qu'une fois qu'ils ont été **finalisés dans Equipe**. Un rapport généré pendant le concours affiche des chiffres provisoires.

---

## 3. Reconnaissance des compétitions

- Seules les compétitions dont le nom contient **CSI** sont incluses en page 2 ; les compétitions marquées **DNC** sont exclues.
- La catégorie est lue à partir du nom de la compétition. Les orthographes courantes sont acceptées : `CSI3*`, `CSI 3*`, `CSI-3`, `CSI***`, `CSIO5*`, `CSI YH`, `CSI Am-A`…
- Une compétition dont le nom ne correspond à **aucune catégorie** est affichée mais **n'est pas comptabilisée** dans les sous-totaux ou le grand total.

---

## FAQ

**La liste des semaines est vide.**
Aucun nom de compétition ne contient "CSI", ou aucun prix n'a encore été saisi. Vérifiez les noms des compétitions et les prix dans Equipe.

**Le total des prix est inférieur aux prévisions.**
Le nom d'une compétition n'a pas été reconnu comme une catégorie. Comparez-le avec les orthographes ci-dessus — un caractère supplémentaire ou une abréviation inhabituelle est la cause habituelle. Corrigez le nom dans Equipe et générez à nouveau le rapport.

**La page 1 est vide.**
Aucune masterlist n'a été sélectionnée, ou les listes sélectionnées ne contiennent aucune entrée avec un cavalier, un cheval et une nation renseignés.

**La ligne de la nation hôte affiche zéro.**
Le pays sélectionné ne correspond pas aux codes de nation utilisés dans Equipe (codes IOC à trois lettres, ex : BEL, FRA).

**Le PDF est blanc ou ne s'ouvre pas.**
Générez-le à nouveau. Si le problème persiste, contactez l'administrateur en indiquant le numéro du concours.