> ## Documentation Index
> Fetch the complete documentation index at: https://support.lumicoda.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence : Groupes

> Spécifications techniques de la ressource Groupes de contacts : segmentation, hiérarchie d'encadrement et outils d'exportation.

La ressource **Groupes** permet de segmenter l'annuaire en unités logiques (équipes, sections, staff). Elle définit les périmètres de visibilité des événements et les droits d'accès pour les encadrants de terrain.

## 1. Structure du formulaire d'édition

Le formulaire permet de définir l'identité du collectif et de désigner sa hiérarchie.

### Champs de configuration

* **Nom** : Texte. Titre unique du groupe (ex: "U12 Garçons").
* **Type de groupe** :
  * **Groupe d'entraînement** : Active les fonctionnalités liées au sport (présences prioritaires).
  * **Groupe de bénévoles** : Identifie le groupe comme ressource de staff pour les manifestations.
* **Responsables** : Sélection multiple de contacts. Ils obtiennent le droit de saisie des présences et l'accès aux coordonnées des membres du groupe sur leur portail.
* **Observateurs** : Sélection multiple de contacts. Ils obtiennent un droit de lecture seule sur les inscriptions et les statistiques du groupe.

***

## 2. Table de données et Statistiques

La vue en liste intègre des calculs automatiques pour le pilotage administratif.

### Colonnes techniques

* **Nombre de contacts** : Calcul en temps réel de l'effectif total rattaché au groupe.
* **Moyenne d'âge** : Calcul basé sur l'année de naissance des membres. Aide à vérifier la cohérence des catégories sportives.
* **Encadrement** : Affiche sous forme de badges les noms des responsables et observateurs désignés.

***

## 3. Actions et Outils de terrain

### Actions individuelles

* **Liste (PDF)** : Génère un document formaté pour le terrain.
  * *Paramètres* : Option pour afficher/masquer les responsables légaux (téléphones d'urgence) ou les numéros de licence.
  * *Validité* : Possibilité de définir une durée de vie pour le lien sécurisé (1 jour à Toujours).
* **Édition / Suppression** : Actions standard de gestion Filament.

### Actions de masse

* **Exportation Excel** : Télécharge les métadonnées des groupes sélectionnés (effectifs, moyennes d'âge).

***

## 4. Logique métier et Relations

* **Relation Many-to-Many** : Un contact peut appartenir à une infinité de groupes simultanément. Le retrait d'un contact d'un groupe n'entraîne pas sa suppression de la base de données (action de "Détachement").
* **Ciblage d'Événements** : Les groupes sont les entités pivots pour la visibilité des activités. Un événement est rendu disponible "pour un groupe", filtrant ainsi l'affichage sur le portail membre.
* **Héritage de visibilité** : Un responsable de groupe hérite automatiquement de la visibilité des données privées (e-mail, téléphone) des membres rattachés, mais uniquement dans le cadre de ses fonctions au sein du groupe.