# Saisir des tests physiques (/docs/joueurs/tests-physiques)



## Vue d'ensemble [#vue-densemble]

FormaPulse te permet d'enregistrer les résultats des **tests physiques** de tes joueurs (vitesse, VMA, détente, force…). Tu as **deux façons** de saisir les résultats :

* **Un par un** — pour saisir le résultat d'un sportif sur un test donné (cas typique : un test ponctuel).
* **Import CSV** — pour saisir en masse les résultats de plusieurs joueurs sur plusieurs tests à la fois (cas typique : journée de tests d'équipe).

Pour le **test lui-même** (ce que tu mesures), trois possibilités :

1. utiliser un **test existant** dans ta bibliothèque d'exercices,
2. **créer un nouveau test** à la volée pendant la saisie,
3. à l'import CSV : créer plusieurs nouveaux tests d'un coup à partir des colonnes du fichier.

<VideoYoutube id="U4D9966Ny_A" titre="AMS Formapulse — Création des tests et gestion des normes" />

## Méthode 1 — Saisie unitaire [#méthode-1--saisie-unitaire]

Tu enregistres **un résultat** pour **un sportif** à **une date donnée**.

### Champs disponibles [#champs-disponibles]

| Champ                        | Obligatoire | Détails                                                         |
| ---------------------------- | ----------- | --------------------------------------------------------------- |
| Sportif                      | Oui         | Le joueur testé                                                 |
| Résultat                     | Oui         | La valeur du test                                               |
| Type de mesure               | Oui         | Type de la grandeur mesurée (temps, distance, % de RM…)         |
| Exercice / test              | Non         | Lier à un exercice de ta bibliothèque                           |
| Nom du test                  | Non         | Si tu ne lies pas à un exercice existant                        |
| Date                         | Non         | Par défaut : aujourd'hui                                        |
| Type de test                 | Non         | Classique par défaut. D'autres types existent (par exemple VBT) |
| Unité                        | Non         | s, m, %, kg…                                                    |
| Informations supplémentaires | Non         | Champ libre pour le contexte (météo, surface, charge…)          |

### Étapes [#étapes]

1. Va sur **Équipes > Tests**.
2. Lance la création d'un nouveau test.
3. Saisis le sportif, l'exercice (ou le nom du test si nouveau), la date, le résultat et l'unité.
4. Valide.

## Méthode 2 — Import CSV [#méthode-2--import-csv]

Tu importes un fichier `.csv` qui contient **une ligne par sportif** et **plusieurs colonnes** (chaque colonne = un test). FormaPulse créé automatiquement un résultat par cellule.

### Ce que tu fournis à l'import [#ce-que-tu-fournis-à-limport]

1. Le **fichier CSV**.
2. La **colonne qui identifie le joueur** — par exemple « Nom » ou « Email ».
3. La **colonne qui contient la date** du test.
4. Pour chaque autre colonne (chaque test), tu choisis :
   * **Test existant** — tu lies la colonne à un exercice déjà présent dans ta bibliothèque.
   * **Nouveau test** — tu donnes un nom, un type de mesure et une unité. FormaPulse crée le test à la volée.
5. Le **mapping des joueurs** — FormaPulse te montre les noms qui apparaissent dans la colonne joueur et te demande à quel sportif FormaPulse les rattacher.

### Sauvegarder la configuration d'import [#sauvegarder-la-configuration-dimport]

À la fin du paramétrage, tu peux **sauvegarder la configuration** (option activée par défaut). FormaPulse mémorise :

* les colonnes joueur et date,
* le mapping de chaque colonne vers un test (existant ou nouveau),
* le mapping des joueurs.

À l'import suivant **du même format de fichier**, FormaPulse te propose la configuration sauvegardée — tu n'as pas à tout reparamétrer.

<Callout type="info">
  Le nom de la configuration est généré automatiquement à partir du nom
  du fichier importé. Tu peux le renommer à la sauvegarde.
</Callout>

### Résumé d'import [#résumé-dimport]

À la fin du traitement, tu obtiens un récapitulatif :

* **Lignes traitées** — nombre de lignes du fichier
* **Tests prévus** — total des cellules de tests à traiter (lignes × colonnes de tests)
* **Tests créés** — résultats effectivement créés
* **Tests mis à jour** — résultats existants mis à jour
* **Sportifs créés** — joueurs nouvellement créés si l'import en a généré
* **Erreurs** — liste des lignes en erreur

## Normes de test [#normes-de-test]

Une **norme** est une valeur de référence à laquelle on compare les résultats. FormaPulse propose **deux types** de normes :

### Normes fixes [#normes-fixes]

Tu **saisis manuellement** la valeur de référence (par exemple VMA cible = 16 km/h).

### Normes dynamiques [#normes-dynamiques]

Calculées automatiquement à partir de l'**historique de tes résultats**, sur une période en jours (par défaut 365). Tu choisis la méthode de calcul parmi :

| Méthode        | Description                                                    |
| -------------- | -------------------------------------------------------------- |
| Moyenne        | Moyenne des résultats sur la période                           |
| Médiane        | Résultat du milieu (la moitié au-dessus, la moitié en dessous) |
| 75ᵉ percentile | Valeur en dessous de laquelle se situent 75 % des résultats    |
| 90ᵉ percentile | Valeur en dessous de laquelle se situent 90 % des résultats    |
| Maximum        | Meilleur résultat de la période                                |
| Minimum        | Pire résultat de la période                                    |

### Spécificité d'une norme [#spécificité-dune-norme]

Une norme peut être :

* **Globale** — s'applique à tous les sportifs.
* **Par équipe** — limite la norme aux sportifs d'une équipe.
* **Par poste** — limite la norme aux sportifs occupant un poste.
* **Par équipe ET poste** — la norme la plus spécifique.

Quand un résultat est comparé, FormaPulse choisit **la norme la plus spécifique applicable** (poste + équipe > équipe > poste > globale).

<Callout type="info">
  Les normes ne génèrent **pas de classement** des joueurs. Elles servent
  uniquement de référentiel pour situer un résultat individuel par rapport
  à une cible ou à une distribution.
</Callout>

### Recalcul des normes dynamiques [#recalcul-des-normes-dynamiques]

Quand tes données évoluent (nouveaux tests passés), tu peux **recalculer** les normes dynamiques pour qu'elles intègrent les résultats récents. Le recalcul met à jour :

* la **valeur** de la norme,
* le **nombre d'échantillons** (combien de résultats ont servi au calcul),
* la **date du calcul**.

## Erreurs à éviter [#erreurs-à-éviter]

* **Mélanger les unités** : une même définition de test doit toujours être saisie dans la même unité (secondes, centièmes, mètres, %). Ne mélange pas un test saisi en secondes avec d'autres en minutes.
* **Conditions de test différentes** : un sprint sur surface synthétique vs herbe naturelle ne se compare pas. Utilise les **informations supplémentaires** pour noter les conditions.
* **Importer un CSV avec des noms de joueurs différents de FormaPulse** : si « Dupont J. » dans le CSV n'est pas mappé à « Dupont Jean » dans FormaPulse, ses résultats ne seront pas attribués. Le mapping initial est crucial.
* **Norme dynamique calculée sur trop peu d'échantillons** : si une norme est basée sur 3 résultats, elle n'est pas fiable. FormaPulse t'indique sur combien de résultats elle a été calculée.
* **Comparer des normes calculées avec des méthodes différentes** : moyenne et 75ᵉ percentile ne représentent pas la même chose. Choisis une méthode et garde-la.

## Aller plus loin [#aller-plus-loin]

<Cards>
  <Card title="Saisir l'anthropométrie" href="/docs/joueurs/prises-anthropometriques" />

  <Card title="Suivi longitudinal" href="/docs/statistiques/suivi-longitudinal" />
</Cards>
