# Modèle d'organisation

> Propriétaire, application, réseau, client, entité juridique - ce que représente chaque niveau et ce que Wakastart crée dans Keycloak.

Wakastart organise vos locataires en arbre. Chaque niveau a un rôle précis : le propriétaire possède, l'application se distribue par des réseaux, le réseau isole un annuaire d'utilisateurs, le client regroupe les utilisateurs d'une organisation.

## Définition

L'organisation Wakastart compte quatre niveaux emboîtés et un référentiel transverse :

| Niveau | Ce qu'il représente | Dans Keycloak |
|---|---|---|
| Propriétaire | L'éditeur qui possède une ou plusieurs applications. La console l'appelle aussi « partenaire ». | Rien |
| Application | Votre [wakapp](/v1.0/glossaire#wakapp). Elle appartient à un seul propriétaire. | Un client OIDC dans le realm de chacun de ses réseaux |
| Réseau | Un canal de distribution de l'application, avec son propre annuaire d'utilisateurs. | Un [realm](/v1.0/glossaire#realm), créé sur les trois instances (prod, staging, dev) |
| Client | Une organisation cliente : une entreprise, un cabinet, une école. | Un groupe et une organisation, nommés par le WID du client, dans le realm du réseau |
| Entité juridique | La personne morale qui porte la raison sociale, les immatriculations et l'adresse. Elle a des contacts. | Rien |

Un réseau n'est pas une organisation Keycloak : c'est un realm entier. L'organisation Keycloak correspond au **client**.

```mermaid
flowchart LR
  subgraph KC["Keycloak — une instance par environnement"]
    R["realm du réseau"] --> OC["client OIDC<br/>clientId = WID de l'application"]
    R --> G["groupe + organisation<br/>alias = WID du client"]
  end
  N["Réseau"] -- "crée sur prod, staging, dev" --> R
  A["Application"] -- "enregistrée dans chaque realm" --> OC
  C["Client"] -- "créé dans le realm du réseau" --> G
```

## Pourquoi ce découpage

- **Le réseau isole les annuaires.** Deux réseaux d'une même application ne partagent ni leurs utilisateurs, ni leurs fournisseurs d'identité, ni leur thème de connexion. Une application vendue en marque blanche à deux distributeurs reçoit un réseau par distributeur.
- **Le client cloisonne les données.** Les utilisateurs et les équipes d'une organisation sont rattachés à son client ; chaque utilisateur a une fiche par environnement où il existe. Un administrateur client ne voit que son client.
- **L'entité juridique est séparée.** La même société peut être à la fois votre client et un distributeur : son entité est saisie une fois et rattachée aux deux.

## Comment ça marche

### Identifiants courts

Chaque objet reçoit un [WID](/v1.0/glossaire#wid) : 6 caractères alphanumériques (`0-9`, `a-z`, `A-Z`) tirés au hasard, par exemple `aB3dE9`. Le WID apparaît dans la console, dans les URL de l'API publique et dans les jetons. Il ne change jamais.

### Création d'un réseau

Wakastart enregistre le réseau, puis crée son realm sur les trois instances Keycloak. Dans chaque realm, il déclare l'application comme client OIDC public, avec PKCE, et l'identifiant client est le WID de l'application. Le realm s'appelle `realm-<WID du réseau>` par défaut.

La création du realm se fait après l'enregistrement du réseau. Si une instance Keycloak ne répond pas, le réseau existe quand même : contactez Wakastart pour relancer la création du realm sur l'instance manquante.

### Création d'un client

Wakastart crée le groupe et l'organisation Keycloak du client sur chaque instance où le realm du réseau est prêt. Il donne aussi au client l'accès à l'application du réseau : vous n'avez rien à attribuer à la main.

### Héritage des réglages

La langue et le thème par défaut se règlent sur le réseau et sont hérités par ses clients. Un client peut les remplacer par les siens. Les visuels suivent la même cascade, du client vers le réseau puis l'application : voir [Apparence](/v1.0/apparence).

### Qui gère quoi

| Niveau d'administration | Périmètre habituel |
|---|---|
| Propriétaire (`OwnerAdmin`) | Sa fiche de propriétaire, ses entités, les réseaux et clients de ses applications |
| Administrateur réseau (`NetworkAdmin`) | Les réseaux qui lui sont confiés et leurs clients |
| Administrateur client (`CustomerAdmin`) | Son propre client |

Le détail des niveaux est dans [Niveaux d'administration](/v1.0/droits-et-profils/niveaux-d-administration).

## Exemples

- **Un éditeur, une marque.** Une application de prise de rendez-vous, un réseau unique, un client par cabinet médical.
- **Un éditeur, plusieurs distributeurs.** La même application distribuée par deux réseaux, chacun avec son domaine, sa page de connexion et son annuaire.
- **Un groupe et ses filiales.** Une entité juridique pour la holding, rattachée au réseau ; une entité par filiale, rattachée à chaque client.

## Pour aller plus loin

- [Gérer les réseaux](/v1.0/organisations/gerer-les-reseaux)
- [Gérer les clients](/v1.0/organisations/gerer-les-clients)
- [Gérer les entités et les contacts](/v1.0/organisations/gerer-les-entites-et-contacts)
- [Environnements et instances Keycloak](/v1.0/concepts)
