# É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.

Une [équipe](/v1.0/glossaire#é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

| Niveau | Rôle prévu |
|---|---|
| `ADMIN` | Gère tout dans l'équipe, y compris sa suppression |
| `MANAGER` | Gère les membres et renomme l'équipe |
| `MEMBER` | Accède à toutes les données de l'équipe (niveau par défaut) |
| `CONTRIBUTOR` | Ajoute des éléments sans modifier ceux des autres |
| `VIEWER` | Consulte seulement |
| `NONE` | Aucun 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

- [Gérer les équipes](/v1.0/utilisateurs/gerer-les-equipes)
- [Droits applicatifs et profils](/v1.0/droits-et-profils/droits-et-profils)
- [Vérifier un droit dans votre application](/v1.0/droits-et-profils/verifier-un-droit-dans-votre-application)
