Aller au contenu principal

Module Responsables (utilisateurs admin)

Le module Responsables te permet de gérer les comptes admin des personnes qui agissent dans ton périmètre : chefs et cheftaines d'unité, adjoints, secrétaires, trésoriers, commissaires…

Vocabulaire​

TermeDéfinition
ResponsableUne personne qui a un compte SYGADES (≠ une scout / un jeune)
IdentitéDonnées personnelles (nom, prénom, email, téléphone)
CompteLien auth.users (capacité de se connecter)
Affectation (assignment)Un rôle (management_role_code) sur une org_unit (Région/District/Groupe/Unité) avec date de début et date de fin
StatutINVITED (a reçu un lien d'invitation mais pas activé) / ACTIVE / SUSPENDED
Lien compte ↔ fiche scouteRattachement entre un compte responsable et sa fiche scoute (le responsable est aussi un scout dans le mouvement). Donne au responsable l'accès mobile à sa propre fiche.

Accéder au module​

Sidebar → Administration → Responsables.

Liste responsables — placeholder

Filtres​

La page propose des filtres en cascade hiérarchique (commit d23a978) :

  • Recherche par nom / email
  • Statut (Tous / Active / Invited / Suspended)
  • Rôle de gestion (ADMIN_UNITE, ADMIN_GROUPE, ADMIN_DISTRICT…)
  • Région (visible ADMIN_NATION+)
  • District (visible ADMIN_REGION+, restreint à la région choisie)
  • Groupe (visible ADMIN_DISTRICT+, restreint au district choisi)
  • Unité (visible ADMIN_GROUPE+, restreint au groupe choisi)
  • Branche (Louveteaux / Éclaireurs / Routiers, sur les unités)

La cascade respecte la doctrine : changer un niveau parent reset les niveaux inférieurs.

Cascade filtres — placeholder

Inviter un responsable​

Bouton Nouveau responsable :

  1. Saisir email + prénom + nom + téléphone
  2. Choisir l'affectation primaire :
    • L'org_unit (Région / District / Groupe / Unité)
    • Le rôle de gestion (ADMIN_UNITE, ADMIN_GROUPE, etc.)
    • La fonction (Chef d'unité, Adjoint, Secrétaire…)
  3. Créer → un email d'invitation est envoyé

Le responsable reçoit un lien /invite/[token] (WhatsApp-safe). Il l'ouvre, définit son mot de passe, et son statut passe de INVITED à ACTIVE.

Dialog nouveau responsable — placeholder

Renvoyer l'invitation​

Si le responsable n'a pas activé son compte dans les 24h, tu peux renvoyer un lien depuis l'icône d'action sur sa ligne (statut = INVITED uniquement).

Suspendre / Réactiver​

Bouton Suspendre : bloque la connexion sans supprimer (R4 — pas de DELETE). Bouton Réactiver : restaure l'accès.

Voir le détail​

Clique sur la ligne pour accéder au détail :

  • Identité + contact
  • Toutes les affectations (active + historique)
  • Permissions effectives (calculées depuis le rôle actif)
  • Actions (modifier, suspendre, ajouter une affectation secondaire…)

Lier / détacher un compte d'une fiche scoute​

Un responsable est souvent aussi un scout du mouvement. Son compte peut donc être lié à sa fiche scoute : ce lien lui donne l'accès mobile à sa propre fiche (progression, contacts, etc.).

Comment le lien se crée (rattachement)​

  • À l'invitation : lors de la création du responsable, un matching propose les fiches scoutes correspondantes ; tu confirmes la bonne fiche.
  • Réconciliation : les comptes sans fiche liée (« orphelins ») remontent dans un outil dédié (/admin/users → bandeau « responsables sans fiche scoute liée ») où tu peux les rattacher à la bonne fiche. Voir Réconciliation des responsables.

Détacher un compte d'une fiche scoute​

Le détachement rompt le lien compte ↔ fiche scoute. C'est un outil correctif : à utiliser quand un compte a été lié à la mauvaise fiche (erreur de matching, doublon), pas pour gérer un départ.

Où : deux points d'entrée, même action —

  • Sur la fiche scoute → carte « Compte lié » → bouton Détacher le compte.
  • Sur le détail du responsable (/admin/users) → carte « Fiche scoute liée ».

Ce que ça fait (un dialog te le rappelle avant confirmation, motif obligatoire) :

  1. Le compte perd l'accès mobile à cette fiche.
  2. Les fonctions synchronisées depuis les affectations sont fermées.
  3. Le compte redevient orphelin → il réapparaît dans l'outil de réconciliation et peut être re-rattaché à la bonne fiche.
  4. Aucune suppression : l'identité scoute et le compte sont conservés. L'opération est réversible (re-réconciliation).
Pour un départ, pas un détachement

Si le responsable quitte ses fonctions, ne détache pas son compte (le lien reste vrai et porte l'historique) : utilise plutôt la fin d'affectation (end_date) et, côté scout, la Fin d'engagement.

Qui peut détacher : Chef de Groupe, Commissaire de District / Région / Nation, Super Admin (permission users.detach_from_scout, dans les limites de ton périmètre).

Doctrine​

  • R1 : un responsable n'est pas un scout (séparation users ↔ scouts.identities)
  • R3 / R4 : pas de DELETE — suspension et détachement conservent les données (l'affectation est fermée par end_date, le détachement remet user_id à vide)
  • R5 : permissions sur le rôle ACTIF uniquement (mig 0199)

Voir aussi​