# Tags d'événements (/docs/planification/tags-evenements)



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

Un **tag d'événement** est une étiquette **colorée**, **libre** et **multi-affectable** que tu colles sur n'importe quel événement (séance, match, réunion, RDV, cycle). Les tags servent à :

* **catégoriser** un événement transversalement à son type (ex: tagger une séance comme « J-2 » + « Tactique » + « Niveau 2 »),
* **filtrer** le calendrier et les dashboards par tag,
* **pré-tagger** les événements créés depuis un template.

<VideoYoutube id="wDKhxNGOFjo" titre="AMS FormaPulse — Les tags d'événements" />

## Tag vs type d'événement [#tag-vs-type-dévénement]

C'est une distinction importante :

|                           | **Type** d'événement                                   | **Tag**                                       |
| ------------------------- | ------------------------------------------------------ | --------------------------------------------- |
| Valeurs possibles         | 5 fixes : Séance / Match / Réunion / RDV Extra / Cycle | Libres, créés par toi                         |
| Modifiable après création | Non                                                    | Oui à tout moment                             |
| Multi                     | Non — un événement = un type                           | Oui — un événement = autant de tags que voulu |
| Impact UI                 | Détermine le formulaire et la couleur de l'événement   | Affichage en chips, sert au filtrage          |

Autrement dit : le **type** définit ce qu'est l'événement, le **tag** ajoute des étiquettes pour t'y retrouver.

## Anatomie d'un tag [#anatomie-dun-tag]

Un tag est composé de :

* **Nom du tag** — texte libre, unique pour ton compte (ou pour ton club si partagé).
* **Couleur** — choisie dans la palette FormaPulse.

## Tags fournis par défaut [#tags-fournis-par-défaut]

À l'inscription, FormaPulse pré-installe une **bibliothèque de tags** prêts à l'emploi.

### Tags temporels (8 tags) [#tags-temporels-8-tags]

`J-3`, `J-2`, `J-1`, `J`, `J+1`, `J+2`, `J+3`, `J+4`

Pour situer la séance par rapport à un match. Très utile pour piloter la charge sur la semaine type.

### Tags d'activité (4 tags) [#tags-dactivité-4-tags]

| Tag            | Usage                                              |
| -------------- | -------------------------------------------------- |
| `Match`        | Marquer un événement comme match (en plus du type) |
| `Entraînement` | Catégorisation générique des séances               |
| `Test`         | Identifier les séances de tests physiques          |
| `Protocole`    | Séances suivant un protocole défini                |

### Tags Retour à la performance (2 tags) [#tags-retour-à-la-performance-2-tags]

| Tag   | Usage                                                          |
| ----- | -------------------------------------------------------------- |
| `RTP` | Return To Performance — phases de réathlétisation              |
| `RTF` | Return To Function — phases plus précoces du retour à l'effort |

### Tags d'intensité (3 tags) [#tags-dintensité-3-tags]

`Niveau 1`, `Niveau 2`, `Niveau 3` — estimation a priori de l'intensité de la séance.

### Tags de format de séance (3 tags) [#tags-de-format-de-séance-3-tags]

`Musculation`, `Individuelle`, `Collective`

## Créer un tag [#créer-un-tag]

Deux façons :

### Création rapide depuis la sidebar [#création-rapide-depuis-la-sidebar]

Dans le calendrier de **Planification**, sidebar gauche, déplie la section **Tags*&#x2A; puis clique sur &#x2A;*+** à côté de « Mes tags ». Une modale « Créer un tag personnalisé » s'ouvre avec :

* **Nom du tag** (placeholder « Ex: Échauffement, Récupération… »)
* **Couleur du tag** (palette de couleurs)
* **Aperçu** en temps réel

Bouton **Créer le tag**.

### Édition depuis le panneau du tag [#édition-depuis-le-panneau-du-tag]

Cliquer sur un tag existant dans la sidebar ouvre un **panneau latéral** avec :

* **Aperçu** du tag
* **Nom du tag** (modifiable)
* **Couleur** (palette plus large que la modale rapide)
* **Identifiant** (lecture seule)
* **Date de création** (lecture seule)
* Boutons **Enregistrer** / **Supprimer ce tag**

## Appliquer un tag à un événement [#appliquer-un-tag-à-un-événement]

Trois façons :

### 1. Depuis la fiche événement [#1-depuis-la-fiche-événement]

Dans la modale de création / édition d'événement, popover **+ Ajouter des tags** : recherche + liste de checkbox. Tu coches les tags voulus, ils s'affichent ensuite comme **chips colorées** au-dessus du popover (avec un X pour les retirer).

### 2. Drag & drop sur un événement existant [#2-drag--drop-sur-un-événement-existant]

Depuis la sidebar, **glisse un tag** directement sur un événement du calendrier. Le tag s'ajoute sans avoir à rouvrir la fiche événement.

### 3. Préréglé via un template [#3-préréglé-via-un-template]

Si un template d'événement contient des tags par défaut, ils sont **automatiquement appliqués** à chaque événement créé à partir de ce template (cf. [Templates d'événement](/docs/planification/templates-personnalises)).

## Filtrer par tag [#filtrer-par-tag]

* **Calendrier de planification** — filtres au-dessus du calendrier pour n'afficher que les événements portant certains tags.
* **Dashboards** — filtre **Tags ressources** dans le header du dashboard. Toutes les données sont restreintes aux événements portant les tags sélectionnés. Voir [Filtres dynamiques des dashboards](/docs/dashboards/filtres-dynamiques).

## Tags personnels vs tags club [#tags-personnels-vs-tags-club]

* **Personnels** — créés par un coach pour son usage propre, invisibles aux autres.
* **Club** — créés par un compte club ou rattaché à un club, visibles par tous les membres du staff.

Les tags par défaut fournis par FormaPulse sont accessibles à tous. Seul le **propriétaire** peut modifier ou supprimer un tag personnalisé.

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

* **Trop de tags** — passé 15-20 tags, plus personne ne s'y retrouve. Préfère des **familles** claires (temporel, intensité, type, retour-perf) à un tag spécifique pour chaque cas.
* **Doublons orthographiques** — `tactique`, `Tactique` et `Tactique ` créent **trois tags différents**. Standardise (tout minuscule, sans accent, sans espace final) ou utilise les seeds existants.
* **Confondre tag et type** — un événement « vidéo analyse » récurrent mérite plutôt un **template Réunion** dédié qu'un tag posé à chaque fois sur un événement vide. Le tag catégorise, le template structure.

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

<Cards>
  <Card title="Templates d'événement" href="/docs/planification/templates-personnalises" description="Préréglages d'événement qui peuvent inclure des tags par défaut." />

  <Card title="Mappers data d'événements" href="/docs/planification/mappers-data-evenements" description="Aller plus loin que les tags avec des champs personnalisés." />

  <Card title="Filtres dynamiques des dashboards" href="/docs/dashboards/filtres-dynamiques" description="Filtrer les analyses par tag." />
</Cards>
