# Indicateurs et agrégation des réponses (/docs/questionnaires/indicateurs)
## Vue d'ensemble [#vue-densemble]
Chaque question d'un questionnaire est rattachée à un **indicateur** identifié par un **nom court** (par exemple « qualité du sommeil »). Ce nom est la **clé d'agrégation** des réponses dans les dashboards.
Comprendre cet aspect est essentiel pour exploiter correctement tes réponses dans les analyses.
## Où se configure l'indicateur [#où-se-configure-lindicateur]
Tout se passe dans le **modal « Ajouter une question »**, depuis l'éditeur d'un questionnaire. En **haut du modal**, un sélecteur **« Réutiliser un indicateur existant »** te propose deux choix :
* **Choisir un indicateur déjà créé** (partagé entre tes questionnaires) → ses paramètres sont chargés automatiquement et **verrouillés** dans le modal. Pour les ajuster, il faut passer par l'édition de l'indicateur (voir [Modifier un indicateur existant](#modifier-un-indicateur-existant)).
* **« + Créer un nouvel indicateur »** → tu remplis tous les champs (nom de l'item, question, type, bornes, indications, etc.). C'est le **seul moment** où tu définis le nom court et le type.
Le **type de question** et le **nom court** sont posés à ce moment précis.
Le type est figé ensuite ; le nom court reste modifiable tant qu'aucune
réponse n'a été enregistrée.
## Comment fonctionne l'agrégation [#comment-fonctionne-lagrégation]
Quand tu ajoutes une question dans un questionnaire, FormaPulse cherche s'il existe déjà un indicateur qui combine **les trois éléments suivants** :
* le **même nom court** (insensible à la casse, espaces ignorés)
* ET le **même type de question** (numérique, chiffre, texte ou zone de douleur)
* ET dans le **même périmètre** (même club, ou personnel pour le même utilisateur)
**Si oui** → l'indicateur existant est **réutilisé**. Toutes les réponses, anciennes et nouvelles, sont agrégées sur le même bucket dans le dashboard.
**Si non** → un nouvel indicateur est créé.
## Exemple concret [#exemple-concret]
Tu crées deux questionnaires :
* **Questionnaire « Wellness matin »**
* Question 1 : « Comment as-tu dormi ? » — nom court « qualité du sommeil », type numérique 1-10
* Question 2 : « Stress ressenti » — nom court « stress », type numérique 1-10
* **Questionnaire « Bilan match »**
* Question 1 : « Qualité du sommeil » — **même nom court** « qualité du sommeil », même type numérique 1-10
Comme le nom court et le type sont identiques, FormaPulse réutilise l'indicateur existant. Résultat : dans tes dashboards, tu as **un seul indicateur « qualité du sommeil »** alimenté par les réponses des deux questionnaires.
Cette réutilisation est **automatique et silencieuse**. Pour la voir,
regarde ta liste d'indicateurs : « qualité du sommeil » apparaît une
seule fois.
## Noms réservés [#noms-réservés]
Certains noms d'indicateurs sont **réservés** par FormaPulse pour des indicateurs natifs du dashboard. Tu ne peux pas créer un indicateur de questionnaire avec ces noms (ça mélangerait les données dans le même bucket).
Les noms réservés actuels :
| Nom réservé | Source native |
| ------------------ | ------------------------------------------------- |
| Charge U.A. | Indicateur de charge calculé à partir des séances |
| Durée (min) | Indicateur de durée de séance |
| RPE | RPE post-séance |
| Blessures en cours | Compteur de blessures actives |
| Zone de douleur | Indicateur système des zones de douleur |
Si tu essaies de créer un indicateur avec un de ces noms, tu obtiens une erreur à la création ou à la modification du questionnaire.
## Indicateurs système [#indicateurs-système]
Certains indicateurs sont **fournis et gérés par FormaPulse**. Ils sont partagés avec tous les utilisateurs et **non modifiables par les coachs**.
L'exemple le plus important est la **zone de douleur** : c'est un indicateur système unique, utilisé pour la carte interactive du corps. Tu ne peux pas l'éditer ni le dupliquer.
## Modifier un indicateur existant [#modifier-un-indicateur-existant]
L'édition d'un indicateur se fait **depuis le modal « Ajouter une question »** : sélectionne l'indicateur dans le sélecteur en haut, puis ouvre la fenêtre d'édition dédiée. Les modifications sont **propagées à tous les questionnaires** qui utilisent cet indicateur.
Voici ce qui est modifiable :
| Élément | Modifiable ? |
| ------------------------------ | ------------------------------------------------------------- |
| Libellé visible de la question | Oui |
| Nom court (clé d'agrégation) | **Non — verrouillé pour préserver l'historique des réponses** |
| Description / précision | Oui |
| Bornes basse et haute | Oui |
| Indications aux extrémités | Oui |
| Type de question | **Non — figé à la création** |
Le **nom court** et le **type** ne sont définis qu'à la création de l'indicateur.
Si tu veux changer le nom court, il faut **créer un nouvel indicateur** (et accepter
que les anciennes réponses restent attachées à l'ancien).
## Bonnes pratiques [#bonnes-pratiques]
* **Choisir des noms cohérents** : utilise un format unique et lisible (par exemple en français, sans accents).
* **Anticiper la réutilisation** : avant de créer un nouvel indicateur, vérifie qu'il n'existe pas déjà sous un nom légèrement différent.
* **Documenter les indicateurs métier** : si plusieurs coachs créent des questionnaires, fais une liste interne des noms à utiliser pour éviter les doublons (« fatigue » vs « fatigue post séance » vs « niveau de fatigue » donnent trois indicateurs distincts).
* **Pas de nom qui change selon l'humeur** : un indicateur stable dans le temps vaut mieux que trois indicateurs sémantiquement proches.
## Erreurs à éviter [#erreurs-à-éviter]
* **Créer un indicateur dont le nom est réservé** : erreur à la création, renomme.
* **Vouloir renommer un indicateur après coup** : impossible, le nom court est verrouillé dès la création pour préserver l'historique. Bien le choisir au départ depuis le modal « Ajouter une question ».
* **Mélanger types pour le même nom** : « fatigue » en numérique et « fatigue » en texte sont **deux indicateurs différents**, même nom. Cela complique l'analyse, évite-le.
* **Créer des indicateurs « jetables »** pour un usage unique : ils restent dans ta liste pour toujours et polluent les dashboards. Préfère réutiliser un indicateur existant ou bien nommer dès le départ.
## Aller plus loin [#aller-plus-loin]