# Constructeur de dashboard (/docs/dashboards/construire-dashboard) ## Vue d'ensemble [#vue-densemble] Un **dashboard FormaPulse** est un tableau de bord sur mesure que tu construis toi-même : tu poses des **composants graphiques** (courbes, jauges, KPI, tableaux, alertes…) sur une grille, tu choisis les **indicateurs** à tracer, tu appliques des **filtres** (équipe, période, joueur, tags) et tu obtiens une vue qui se rejoue à volonté. Un même dashboard peut être : * consulté en interne par toi-même, * **partagé** au reste du staff (en lecture seule ou avec droits d'édition), * exporté en **PDF** pour une réunion ou un rapport, * rejoué sur n'importe quel joueur ou équipe **sans le reconstruire** grâce aux filtres dynamiques. ## Anatomie du constructeur [#anatomie-du-constructeur] Le constructeur est divisé en **trois zones** complémentaires. ### 1. Le header dynamique (en haut) [#1-le-header-dynamique-en-haut] Une barre persistante qui contient : * le **titre** du dashboard (éditable au clic), * les **filtres globaux** : période, sportif, équipe, type d'événement, tags, * le bouton **Recharger** (force le re-fetch des données), * le bouton **Exporter en PDF**, * le bouton **Partager / Sauvegarder** (ouvre la modale de partage). Tous les composants posés sur le canvas réagissent automatiquement aux filtres du header. C'est le mécanisme qui te permet de construire un dashboard une seule fois et de le rejouer pour n'importe quel joueur ou n'importe quelle période. Pour tout détail sur les filtres, voir [Filtres dynamiques](/docs/dashboards/filtres-dynamiques). ### 2. La sidebar des composants (à droite) [#2-la-sidebar-des-composants-à-droite] C'est ta **palette d'outils**. Elle contient : * les **12 types de composants graphiques** disponibles (courbe, histogramme, aire, composé, scatter, radar, box plot, jauge, KPI, tableau, système d'alerte, texte), * les **6 sources de données** (Questionnaires, Charge U.A., Tests physiques, Blessures, GPS, Formules) avec la liste des indicateurs disponibles dans chacune. Pour ajouter un composant, tu le **glisses-déposes** depuis la sidebar vers le canvas : il apparaît à l'endroit du drop, prêt à être configuré. Pour la liste détaillée et les options de chaque composant, voir [Composants graphiques](/docs/dashboards/composants-graphiques). ### 3. Le canvas (au centre) [#3-le-canvas-au-centre] Une **grille de 12 colonnes** sur laquelle tu poses tes composants. Tu peux : * **glisser** un composant pour le repositionner, * **redimensionner** un composant (largeur 1 à 12 colonnes, hauteur libre), * **dupliquer** ou **supprimer** un composant via son menu contextuel, * **cliquer** sur un composant pour ouvrir son **configurateur** dans une modale. ## Construire pas à pas [#construire-pas-à-pas] ### 1. Créer le dashboard [#1-créer-le-dashboard] Depuis le menu principal, ouvre **Dashboards > Constructeur de dashboard**. Tu arrives directement sur un constructeur vide. ### 2. Ajouter un premier composant [#2-ajouter-un-premier-composant] Dans la sidebar de droite, attrape un type — par exemple **Courbe** pour suivre l'évolution d'un indicateur dans le temps — et **glisse-le sur le canvas**. Le composant apparaît à l'endroit du drop. ### 3. Choisir les indicateurs [#3-choisir-les-indicateurs] Clique sur le composant pour ouvrir le **configurateur** puis va dans l'onglet **Indicateurs**. Sélectionne un ou plusieurs indicateurs depuis la liste organisée par source. La barre de recherche permet de filtrer par nom. **Croiser plusieurs sources** est l'une des forces de FormaPulse. Tu peux par exemple superposer sur une même courbe : la **charge UA** des séances, le **RPE** des joueurs et la **distance GPS** parcourue — pour visualiser instantanément la corrélation entre charge subjective et charge objective. ### 4. Configurer le composant [#4-configurer-le-composant] Le configurateur expose plusieurs onglets selon le type de composant : * **Général** — titre, taille (largeur en colonnes, hauteur en pixels), granularité temporelle (jour / semaine / mois), modes spécifiques (par sportif, par date, collectif…). * **Indicateurs** — sélection des données. * **Traitement** — méthode d'agrégation (moyenne, médiane, somme), gestion des valeurs manquantes (ignorer, remplacer par zéro, valeur précédente). * **Metrics** — colonnes affichées dans les composants tabulaires. * **Analyses** — moyennes mobiles SMA / EMA, Z-Score, ACWR, zones de sollicitation à la tendance, norme de référence. * **Règles d'alertes** — pour les composants de type Système d'alerte uniquement. * **Visuel** — palette de couleurs personnalisable par indicateur. Le détail de chaque option est documenté dans [Composants graphiques](/docs/dashboards/composants-graphiques). ### 5. Disposer sur la grille [#5-disposer-sur-la-grille] Glisse-dépose le composant à l'endroit voulu. Saisis un coin pour le redimensionner. Répète l'opération pour ajouter d'autres composants. ### 6. Sauvegarder et partager [#6-sauvegarder-et-partager] Clique sur **Sauvegarder le dashboard** dans le header. Une modale s'ouvre : * **Nom du dashboard** — apparaît dans le menu, sous **Dashboards > Mes dashboards**. * **Utilisateurs autorisés (Staff)** — multi-sélection des membres du staff qui pourront consulter le dashboard. * **Toggle « Dashboard modifiable »** — autorise les utilisateurs partagés à modifier le dashboard (par défaut : lecture seule). ## Permissions et partage [#permissions-et-partage] FormaPulse distingue **trois niveaux d'accès** : | Rôle | Lecture | Édition | Partage / Suppression | | --------------------------------------- | ------- | ------- | --------------------- | | **Créateur** (propriétaire) | Oui | Oui | Oui | | **Viewer en lecture seule** | Oui | Non | Non | | **Viewer avec édition** (toggle activé) | Oui | Oui | Non | Le **créateur** garde toujours la main sur le partage et la suppression. Les viewers à qui l'édition est ouverte peuvent modifier la config (ajouter / retirer des composants, changer les indicateurs) mais ne peuvent ni re-partager, ni supprimer le dashboard. **Cas concret** — un préparateur physique construit un dashboard de suivi de charge : * il le partage à son **adjoint** en **lecture seule** : l'adjoint consulte mais ne peut pas casser la config, * il le partage au **coach principal** avec **droits d'édition** : le coach peut affiner les composants au fil de la saison, * il garde lui-même la maîtrise du partage et de la suppression. ## Croiser les données — le cœur de la puissance [#croiser-les-données--le-cœur-de-la-puissance] Là où FormaPulse se distingue, c'est sa capacité à **mélanger toutes les sources** dans un même graphique. Quelques exemples d'analyses croisées qui ne demandent qu'un seul composant : * **Courbe** charge UA + RPE + distance GPS sur une même série temporelle, pour valider que la charge perçue suit bien la charge mesurée. * **Composé** double axe : barres de **durée de séance** à gauche, courbe de **score de fatigue** (questionnaire) à droite, pour repérer si la fatigue subjective dérive sur les semaines chargées. * **Radar** à 6 indicateurs (vitesse max, distance haute intensité, sprints, charge UA, RPE moyen, score de bien-être) pour visualiser un profil de joueur sur la dernière période. * **Tableau** par sportif avec 8 colonnes croisées (charge, GPS, présences, blessures actives, dernier test) — un compte-rendu hebdomadaire en un clic. * **Système d'alerte** combinant règles sur la charge, la fatigue subjective et l'historique de blessures pour détecter les joueurs à risque. Pour la liste exhaustive des indicateurs croisables, voir [Indicateurs disponibles](/docs/dashboards/indicateurs-disponibles). ## Exporter en PDF [#exporter-en-pdf] Le bouton **Exporter en PDF** du header capture le dashboard tel qu'il est affiché à l'écran (avec les filtres en cours) et génère un PDF prêt à imprimer ou à transmettre. Astuce : pose tes filtres avant l'export. Si tu changes de joueur dans le filtre **Sportif** puis que tu exports, tu obtiens un rapport individuel personnalisé en deux clics. ## Erreurs à éviter [#erreurs-à-éviter] * **Trop de composants** — un dashboard de 15 widgets devient illisible. Reste sur 4 à 8 composants clés et crée plusieurs dashboards thématiques plutôt qu'un seul fourre-tout. * **Filtres incohérents** — si un composant filtre implicitement sur une équipe via ses indicateurs et qu'un autre n'a pas le même contexte, le rapport mélange les niveaux. Explicite-le dans le titre du dashboard ou des composants. * **Périodes absolues figées** — un dashboard avec une période « du 1er août au 31 décembre » ne se met pas à jour à la rentrée. Privilégie les **périodes glissantes** (« 60 derniers jours ») pour les dashboards récurrents. * **Oublier le partage** — un dashboard non partagé est invisible au reste du staff. Pense à ouvrir l'accès dès la sauvegarde. ## Aller plus loin [#aller-plus-loin]