Créer un rôle personnalisé

Les trois rôles par défaut couvrent la plupart des cas, mais chaque église finit par avoir besoin de quelque chose qui n'y rentre pas — un trésorier qui peut enregistrer des dons mais ne peut pas voir les adresses des membres, un responsable de louange qui gère un seul ministère, un coordinateur de bénévoles qui gère la présence en semaine mais ne touche jamais aux dons. Les rôles personnalisés vous permettent de construire exactement le paquet de permissions souhaité et de lui donner un nom que votre équipe reconnaît.

Ouvrez la boîte de dialogue de création de rôle

Depuis Utilisateurs et Rôles → Rôles et Permissions, cliquez sur le bouton Ajouter un rôle en haut à droite de la carte Gérer les rôles. L'onglet Rôles et Permissions n'est visible que par les utilisateurs disposant de users.manage — si vous ne le voyez pas, vous êtes probablement connecté en tant que Leader ou Viewer ; basculez sur un compte Administrator.

Remplissez les trois champs

Nom du rôle

Comment le rôle est appelé partout où il apparaît — le chip sur le profil d'un utilisateur, l'en-tête de colonne dans la matrice de permissions, l'option dans le sélecteur de rôle quand vous invitez un utilisateur. Utilisez le titre que votre église emploie réellement à l'oral : Trésorier, Responsable de louange, Accueillant des visiteurs, Coordinateur d'école du dimanche. Deux ou trois mots, c'est le sweet spot.

Clé du rôle

Un identifiant court, adapté à la machine, que la base de données et le journal d'audit utilisent pour référencer le rôle. Si vous la laissez vide, GCM la dérive du nom — minuscules, espaces remplacés par des underscores, ponctuation supprimée. Worship Leader devient worship_leader ; Sunday School Coordinator devient sunday_school_coordinator.

Vous pouvez l'écraser si vous voulez quelque chose de plus court (treasurer au lieu de church_treasurer), mais choisissez bien — la clé est ce qui apparaît dans les journaux d'erreurs, dans la piste d'audit et dans toute intégration personnalisée qui interroge la table des rôles. Une fois qu'un utilisateur s'est vu attribuer le rôle, changer la clé orpheliniserait l'attribution, donc l'interface ne vous laisse pas la modifier après la création. Supprimez et recréez si vous avez besoin d'une clé différente.

TIP

Tenez-vous-en aux lettres minuscules, aux chiffres et aux underscores. Le dériveur automatique applique cela, et la base de données a un index unique sur (organization_id, key) pour que deux rôles dans votre espace de travail ne puissent pas partager une clé.

Description

Une note d'une ligne que le prochain admin pourra lire. « Enregistre les dons et gère les fonds, mais ne peut pas voir les adresses des membres ni l'historique des dons des autres membres. » Optionnel, mais apprécié — c'est affiché sous le nom du rôle dans la liste des rôles et dans l'info-bulle de colonne sur la matrice de permissions.

Enregistrer et choisir les permissions

Cliquez sur Créer. Le rôle est inséré dans roles_v2 avec is_system = false (ce qui le rend supprimable plus tard) et apparaît immédiatement comme une nouvelle colonne dans la matrice de permissions en dessous. Il démarre avec zéro permission cochée — la matrice est votre toile vierge.

Faites défiler la matrice et activez ce dont le rôle a besoin. Chaque interrupteur écrit dans role_permissions_v2 à l'instant où vous le basculez ; il n'y a pas de bouton d'enregistrement. Voir Accorder des permissions pour le catalogue complet et les combinaisons courantes.

WARNING

Un rôle personnalisé avec zéro permission est fonctionnellement inutile — attribuez-le à un utilisateur et il pourra se connecter mais chaque page renverra une bannière de permission refusée. L'interface vous laisse créer des rôles vides délibérément (vous pourriez vouloir accorder des permissions plus tard) mais ne les laissez pas vides en production.

L'indicateur is_system

Les trois rôles initialisés ont is_system = true. Les vôtres auront is_system = false. Cela compte à deux endroits :

1. La liste des rôles masque le bouton de suppression sur les rôles système. Vous pouvez toujours basculer leurs permissions — c'est sûr — mais vous ne pouvez pas les retirer entièrement.
2. Un trigger de base de données applique également cela côté backend. Même si vous contournez l'interface et appelez l'endpoint de suppression directement, le SQL rejette la requête avec une erreur cannot delete system role.

L'indicateur is_system est défini au moment de l'insertion et ne peut pas être inversé ensuite. Il n'existe pas de moyen pris en charge de convertir un rôle personnalisé en rôle système, ou vice-versa. Si vous en avez besoin, contactez le support et nous le ferons via une session d'impersonation platform admin.

Supprimer un rôle personnalisé

Cliquez sur l'icône poubelle rouge sur la ligne dans la liste des rôles. Deux vérifications s'exécutent :

1. Si des utilisateurs sont encore attribués au rôle, la suppression est rejetée avec le décompte du nombre. Réattribuez ou retirez d'abord ces utilisateurs — voir Inviter un utilisateur pour la boîte de dialogue d'attribution.
2. Si la suppression réussit, chaque ligne dans role_permissions_v2 pour ce rôle est aussi retirée dans la même transaction. Rien n'est soft-deleted ; c'est un nettoyage en dur.

Si vous supprimez par accident, vous devrez recréer le rôle et réaccorder les permissions. Les rôles personnalisés ne sont pas dans la corbeille.

Schémas de nommage qui fonctionnent

Quelques schémas que nous avons vus payer :

• Trésorier — giving.view, giving.record, giving.manage, reports.view. Rien d'autre. Idéal pour le compteur de liquide et le comité d'audit.
• Responsable de louange — members.view, events.view, events.create, events.edit, messaging.send. Limité au ministère Équipe de louange, il gère les répétitions sans voir l'annuaire général.
• Accueillant des visiteurs — members.view, members.create, forms.submit. Permet au bénévole d'accueil d'ajouter de nouveaux visiteurs pendant le culte.
• Auditeur — chaque permission view et rien d'autre. Même forme que Viewer mais nommé pour le contexte, ainsi le journal d'audit affiche Auditeur connecté plutôt que Viewer connecté.

Pour aller plus loin

• Accorder des permissions — la matrice en détail.
• Permissions limitées — restreindre le rôle à une seule branche.
• Journal d'audit des changements de rôle — voir qui crée et modifie les rôles.