Affecter des membres aux unités

Un membre est dans une unité quand une ligne existe dans member_unit_assignments reliant les deux. Cette ligne est ce qui fait monter la présence, ce qui restreint la visibilité du berger, ce qui dit à la carte où mettre l'épingle. Sans elle, un membre est un nom dans une liste sans contexte organisationnel.

Cette page couvre chaque chemin que GCM offre pour créer ces lignes.

La règle une-par-niveau

Un membre peut être affecté à une unité à chaque niveau. Si vos niveaux sont Branche → Centre → Cellule, un membre peut être dans une branche et un centre et une cellule — trois lignes dans member_unit_assignments, une par niveau. Il ne peut pas être dans deux branches à la fois.

La base de données applique cela avec un index unique sur (member_id, level_index) restreint à organization_id. Essayer d'ajouter une deuxième ligne au même niveau remplace soit la ligne existante (dans le flux de détails d'unité) soit fait surgir une erreur de doublon (insert brut).

Si un membre participe légitimement à deux branches — disons un responsable de louange qui joue aux deux campus — choisissez l'une comme branche principale et utilisez un champ personnalisé pour noter la secondaire.

Depuis la page de détails d'une unité

C'est le flux de travail le plus courant. Ouvrez l'unité (entrez depuis l'arbre ou une page de niveau), faites défiler jusqu'au panneau Membres, et cliquez sur Ajouter un membre.

La boîte de dialogue affiche une liste déroulante recherchable. Tapez deux caractères et GCM frappe le RPC search_members pour des résultats en direct à travers toute l'organisation. Choisissez un membre, cliquez sur Ajouter, et vous le verrez apparaître dans le panneau immédiatement.

Ce qui se passe sous le capot :

1. GCM vérifie la liste des membres actuels du panneau pour s'arrêter tôt si le même id de membre est déjà affecté à cette unité (toast : "Membre déjà affecté").
2. Il insère une ligne dans member_unit_assignments avec le membre, l'unité et l'id de l'organisation actuelle (RLS applique cela de toute façon).
3. Le badge de comptage de membres de l'unité augmente à travers le reste de l'application.

Le panneau Membres lui-même a :

• Une boîte de recherche qui filtre par prénom ou nom (insensible à la casse, les deux champs en OR).
• Pagination à 25 / 50 / 100 lignes. Les grandes unités se chargent paresseusement.
• Lignes de membre avec avatar, badge de type (visiteur / membre / régulier), téléphone et une puce de complétude.
• Bouton Retirer au survol pour désaffecter sans quitter la page.

Depuis le profil d'un membre

Parfois vous travaillez de l'autre côté — vous venez d'ajouter un membre et voulez le ranger. Ouvrez son profil, faites défiler jusqu'à Affectation d'unité organisationnelle, et choisissez les unités niveau par niveau.

Le sélecteur est en cascade : choisissez une branche de niveau 1 d'abord, puis les options de niveau 2 se restreignent aux centres de cette branche, puis le niveau 3 aux cellules de ce centre. On ne vous demande jamais de choisir une cellule dont vous n'avez pas sélectionné la branche.

Si vous n'avez qu'une seule branche, le sélecteur se verrouille dessus automatiquement — il n'y a rien à choisir. Pareil pour tout niveau où la portée membre-ou-personnel laisse exactement une option.

En masse

Pour les migrations, les grandes admissions ou une restructuration à l'échelle paroissiale, les insertions ligne par ligne deviennent fastidieuses. Deux chemins en masse :

Import CSV en masse

Les membres importés via import en masse peuvent inclure le nom de l'unité dans leur colonne. L'import correspond par nom (insensible à la casse) contre org_units au niveau pertinent et crée les affectations dans la même transaction. Les noms non correspondants apparaissent dans l'aperçu d'essai à blanc afin que vous puissiez corriger les fautes de frappe avant de valider.

Actions en masse dans l'application

Depuis Membres, filtrez la liste au sous-ensemble que vous voulez, frappez Actions en masse → Affecter à une unité, et choisissez la cible. GCM upserts les affectations — les lignes existantes au même niveau sont remplacées, pas dupliquées.

Supprimer une affectation

Trois chemins :

• Depuis le panneau Membres sur une page d'unité — survolez, cliquez sur l'icône poubelle, confirmez.
• Depuis le profil du membre — effacez le sélecteur pour ce niveau.
• Depuis actions en masse — Désaffecter de l'unité actuelle au niveau N.

Supprimer une affectation ne supprime pas le membre. Cela enlève juste la ligne de member_unit_assignments. Le membre devient "non affecté à ce niveau" et cesse d'apparaître dans les rapports agrégés de cette unité.

Ce qui est compté où

Une fois qu'un membre a des affectations, chaque comptage dans l'application les respecte :

Comptage	Règle de cascade
Carte d'unité "N membres"	Affectations directes uniquement (pas de descendants)
Total du sous-arbre sur une page de détails de branche	Comptage de membres + somme de chaque comptage direct de descendant
Filtre tableau de bord présence	Tous les membres visibles dans le sous-arbre de l'unité sélectionnée
Filtre tableau de bord dons	Pareil — les dons du membre montent dans l'arbre
Épingles de carte par unité	Les affectations directes de chaque unité sont regroupées autour des coordonnées de l'unité

Le comptage "carte" et le "total du sous-arbre" étant différents est intentionnel. Une branche avec trois centres et 200 membres chacun affiche "0 membres" sur sa propre carte si personne n'est directement affecté à la branche (ce qui est normal — les gens sont généralement affectés aux cellules, pas aux branches). La page de détails de la branche affiche "600 membres" dans la stat de sous-arbre.

Workflows d'auto-affectation

Les workflows peuvent créer des affectations par programmation. Le modèle le plus courant : un workflow de suivi de visiteur affecte le visiteur à la cellule dont le responsable a pris le premier appel. Voir Actions de workflow pour la spécification du nœud Affecter à une unité.

Les affectations de workflow utilisent la même règle une-par-niveau

Si le workflow affecte un membre à une cellule et qu'il est déjà dans une autre cellule, la ligne existante est remplacée. Le journal d'audit enregistre à la fois la désaffectation et la réaffectation.

Questions courantes

Que se passe-t-il si un membre n'a pas d'unité du tout ? Alors il est "non affecté" et ne monte vers aucune branche. Il apparaît dans la liste tous-membres et le tableau de bord global mais pas dans aucun rapport filtré. C'est le défaut pour les nouveaux membres jusqu'à ce que vous (ou un workflow) le placiez.

Puis-je déplacer en masse des membres d'une cellule à une autre ? Oui — filtrez la liste à la cellule source, sélectionnez tout, lancez Actions en masse → Affecter à une unité avec la cellule cible. Les affectations existantes sont remplacées.

Pourquoi le profil d'un membre affiche-t-il deux affectations au niveau 3 ? Cela ne devrait pas — l'index unique l'empêche. Si vous le voyez, quelque chose d'hérité est dans les données. Contactez le support et référencez l'id du membre.

Étapes suivantes

• Affecter des responsables et des bergers afin que les utilisateurs — pas les membres — obtiennent des vues restreintes.
• Archiver des unités quand l'adhésion se réorganise.
• Lisez le guide d'import en masse si vous semez une organisation fraîche.