# Droits, profils et équipes

> Ce qu'un utilisateur peut faire dans une application : des droits définis par l'application, regroupés en profils par environnement, complétés par les équipes.

Un [droit](/v1.0/glossaire#droit) autorise une action précise dans une application. Un [profil](/v1.0/glossaire#profil) regroupe des droits sous un nom métier, et c'est lui que l'on attribue aux utilisateurs. Une [équipe](/v1.0/glossaire#équipe) regroupe des collègues d'une même organisation, chacun avec un rôle dans l'équipe.

## Définition

```mermaid
flowchart LR
  subgraph CAT["Catalogue de l'application"]
    D1["dossiers.read"]
    D2["dossiers.update"]
    D3["factures.read"]
  end
  subgraph PRO["Profils"]
    P1["Soignant<br/>matrice prod"]
    P2["Comptable<br/>matrice prod"]
  end
  D1 --> P1
  D2 --> P1
  D3 --> P2
  P1 --> U["Claire<br/>Soignant en prod"]
  U --> ME["GET /api/me<br/>profile.rights"]
```

| Objet | Défini par | Contenu |
|---|---|---|
| **Droit** | l'application | un code de la forme `ressource.action` (`dossiers.read`), un nom, une catégorie ; il existe dans les trois environnements ; 200 droits au plus par application |
| **Profil** | l'application | un nom unique dans l'application, une description et un WID communs aux trois environnements, et ses droits, cochés dans la matrice de chaque environnement |
| **Équipe** | un client | un nom, des membres, et pour chaque membre un rôle dans l'équipe |

## Pourquoi ça existe

Votre code ne devrait jamais tester « est-ce un administrateur ? », mais « a-t-il le droit `factures.read` ? ». Les droits nomment ces autorisations ; les profils évitent de les attribuer une à une. Comme la matrice profils × droits se règle par environnement, un droit en cours de développement peut être accordé en dev sans l'être en production.

## Comment ça marche

### Des profils d'application

Les profils sont créés au niveau de l'application et proposés à tous ses clients, sauf dans les réseaux qui les masquent. Un réseau ou un client ne crée plus de profils propres ; les anciens, s'il en reste, sont historiques et en lecture seule.

### Une matrice par environnement

Dans **Paramétrage**, l'onglet **Matrice** croise les droits et les profils pour l'environnement choisi : une case cochée donne le droit au profil dans cet environnement. La matrice s'exporte et s'importe en JSON, un environnement à la fois. Elle ne se copie ni ne se promeut d'un environnement à l'autre : chaque environnement se règle séparément.

### Attribution aux utilisateurs

Un profil s'attribue à une fiche utilisateur, et une fiche appartient à un seul environnement. Une personne présente en dev et en prod a donc deux fiches, avec le même profil ou un autre. À la connexion, `GET /api/me` renvoie le profil de la fiche de l'environnement de connexion et ses droits, lus dans la matrice de cet environnement, dans `profile.rights`. L'API publique, elle, vérifie les droits avant d'exécuter : sans le droit requis, elle répond `403` avec le message « Droit applicatif requis : » suivi du code du droit, par exemple `Droit applicatif requis : factures.read`. Un changement de profil prend effet dans la minute.

### Les équipes

Chaque membre d'une équipe a un rôle :

| Rôle | Portée prévue |
|---|---|
| `ADMIN` | tout sur l'équipe |
| `MANAGER` | gère les membres |
| `MEMBER` | accès complet aux données de l'équipe |
| `CONTRIBUTOR` | ajout seulement |
| `VIEWER` | lecture seule |

Votre application lit les équipes de l'utilisateur dans `GET /api/me` (`teams`, avec `teamLevel`) et décide de ce qu'elles autorisent : par exemple, ne montrer un dossier qu'aux membres de l'équipe qui le suit.

### L'exemple de la console

La console Wakastart est elle-même une application, avec son catalogue de droits et six profils pour les administrateurs clients :

| Profil | Droits principaux |
|---|---|
| Chef de projet | projets, temps passé, tickets |
| Testeur | lecture et création de tickets |
| Développeur | tickets, lecture de l'hébergement et des logs |
| Infra | paramétrage des applications, hébergement complet, sauvegardes, accès à la production |
| Auditeur | journal d'audit, écran Stellar Proofs, conformité, fournisseurs d'identité et invitations en lecture |
| Financier | facturation, crédits, temps passé en lecture |

## Exemples

**Un éditeur santé.** L'application déclare `dossiers.read`, `dossiers.update` et `ordonnances.sign`. Le profil modèle « Médecin » a les trois ; « Secrétaire » n'a que la lecture. Un réseau de centres de radiologie masque « Médecin » et crée « Radiologue ».

**Une nouvelle fonctionnalité.** Le droit `exports.create` est créé pour le seul environnement dev, coché pour le profil « Gestionnaire », testé, puis promu en staging et en production avec la matrice.

## Profil, équipe ou fonctionnalité ?

| Besoin | Outil |
|---|---|
| Autoriser une action pour une catégorie de personnes | un droit dans un profil |
| Restreindre des données à un groupe de collègues | une équipe |
| Activer une option pour toute une organisation | une fonctionnalité activable, réglée par application, réseau et client |

## Pour aller plus loin

- [Droits et profils](/v1.0/droits-et-profils) : créer droits et profils, promouvoir la matrice.
- [Utilisateurs et équipes](/v1.0/utilisateurs) : attribuer les profils et gérer les équipes.
- [Jeton enrichi et /me](/v1.0/concepts/jeton-enrichi-et-me) : où votre code lit les droits.
- [Référence API : droits et profils](/v1.0/reference-api/droits-et-profils), [équipes](/v1.0/reference-api/equipes).
