Aller au contenu

Équipes et droits d'équipe

Le niveau d'un membre dans une équipe et les droits d'équipe encodés en lettres, et ce que votre application peut en faire.

ConceptDéveloppeurAdministrateur
Voir en Markdown

Une équipe regroupe des utilisateurs d'un même client. Chaque membre y a un niveau d'équipe et, si votre application le souhaite, des droits d'équipe. Ces informations complètent le profil : le profil dit ce qu'un utilisateur peut faire, l'équipe dit sur quel périmètre partagé.

Définition

Niveau d'équipe

NiveauRôle prévu
ADMINGère tout dans l'équipe, y compris sa suppression
MANAGERGère les membres et renomme l'équipe
MEMBERAccède à toutes les données de l'équipe (niveau par défaut)
CONTRIBUTORAjoute des éléments sans modifier ceux des autres
VIEWERConsulte seulement
NONEAucun accès particulier

Wakastart applique lui-même ADMIN et MANAGER à la gestion de l'équipe : renommer exige MANAGER ou ADMIN, supprimer exige ADMIN. Les autres niveaux sont à interpréter par votre application.

Droits d'équipe

Les droits d'équipe sont une chaîne de 0 à 52 lettres (A à Z, a à z), par exemple "RW". Wakastart les stocke pour chaque membre sans les interpréter : c'est votre application qui donne un sens à chaque lettre, par exemple R pour lire et W pour écrire les dossiers de l'équipe.

Comment ça marche

  • Un utilisateur peut appartenir à plusieurs équipes de son client, avec un niveau différent dans chacune.
  • Une invitation peut inscrire d'avance la personne dans des équipes ; une personne qui invite doit être membre de chacune avec un niveau au moins égal à celui qu'elle attribue.
  • Votre application lit les équipes de l'utilisateur dans teams de la réponse de GET /api/me (WID, nom, niveau). Les droits d'équipe de chaque membre se lisent avec GET /api/config/teams/{wid}/members.
  • Un changement de niveau est pris en compte à la prochaine émission de jeton enrichi de l'utilisateur.

Exemples

  • Plusieurs sites. Un client a une équipe par site. Les secrétaires sont MEMBER de leur site et VIEWER des autres ; votre application filtre les agendas en conséquence.
  • Validation à deux niveaux. Les dossiers d'une équipe sont créés par les CONTRIBUTOR et validés par les MANAGER.
  • Droits fins par équipe. Votre application définit E = « exporter » ; seuls les membres dont les droits d'équipe contiennent E voient le bouton d'export dans cette équipe.

Pour aller plus loin