# Concepts

> Le modèle de Wakastart en un schéma : qui possède quoi, qui accède à quoi, et comment une application devient des ressources qui tournent.

Toute la plateforme tient dans deux arbres qui partent du même objet : l'[application](/v1.0/glossaire#application). Le premier dit **qui utilise** l'application : le partenaire qui la possède, les réseaux qui la distribuent, les clients et leurs utilisateurs. Le second dit **où elle tourne** : ses environnements et les ressources de chacun.

## Le schéma central

```mermaid
flowchart TB
  P["Propriétaire<br/>le partenaire, éditeur de l'application"]
  A["Application<br/>la wakapp · identifiant court = client Keycloak"]
  P --> A

  subgraph ORG["Qui l'utilise : l'organisation"]
    direction TB
    N["Réseau<br/>un realm Keycloak, sur chaque instance"]
    C["Client<br/>une organisation Keycloak dans le realm"]
    U["Utilisateur<br/>un compte par environnement"]
    N --> C --> U
  end

  subgraph HEB["Où elle tourne : l'hébergement"]
    direction TB
    E["Environnement<br/>dev · staging · prod"]
    S["Service déployé"]
    D[("Base de données")]
    B[("Bucket S3")]
    R["URL et route"]
    E --> S
    E --> D
    E --> B
    E --> R
  end

  A --> N
  A --> E
  A -.->|"architecture : définitions déclarées une fois"| HEB
```

Lecture du schéma :

- **Un propriétaire, plusieurs applications.** Le [propriétaire](/v1.0/glossaire#propriétaire) est l'éditeur ou le partenaire. Chaque application lui appartient.
- **Une application, plusieurs réseaux.** Un [réseau](/v1.0/glossaire#réseau) est un canal de distribution, avec son propre espace d'identité. Il regroupe des [clients](/v1.0/glossaire#client), et chaque client ses utilisateurs.
- **Une application, plusieurs environnements.** L'application décrit une seule fois son architecture : services, bases, buckets, URLs. Chaque [environnement](/v1.0/glossaire#environnement) en reçoit ses propres instances.
- **Les deux arbres se croisent dans Keycloak.** Le realm d'un réseau existe sur l'instance Keycloak de chaque type d'environnement ; un utilisateur a donc un compte par environnement.

## Les concepts, un par page

### Le modèle de la plateforme

::::cards{cols=3}
:::card{title="Organisation multi-tenant" href="/v1.0/concepts/organisation-multi-tenant" icon="Building2"}
Propriétaire, application, réseau, client, utilisateur : qui contient qui, et ce que chaque niveau isole.
:::
:::card{title="Applications" href="/v1.0/concepts/applications" icon="AppWindow"}
La wakapp, ses deux faces : identité et hébergement.
:::
:::card{title="Environnements" href="/v1.0/concepts/environnements" icon="Cloud"}
Dev, staging, prod, et les trois instances Keycloak qui leur correspondent.
:::
:::card{title="Définitions et instances" href="/v1.0/concepts/definitions-et-instances" icon="Layers"}
Déclarer une fois, provisionner partout : héritage des valeurs et surcharges.
:::
:::card{title="Cycle de vie des ressources" href="/v1.0/concepts/cycle-de-vie-des-ressources" icon="RefreshCw"}
Statuts, réconciliation, délais : ce qui est asynchrone et combien de temps ça prend.
:::
::::

### Identité et accès

::::cards{cols=3}
:::card{title="Niveaux d'administration" href="/v1.0/concepts/niveaux-d-administration" icon="Shield"}
Partenaire, applications, réseau, client : le périmètre de chaque administrateur.
:::
:::card{title="Droits, profils et équipes" href="/v1.0/concepts/droits-profils-et-equipes" icon="ShieldCheck"}
Ce qu'un utilisateur a le droit de faire, environnement par environnement.
:::
:::card{title="Discovery" href="/v1.0/concepts/discovery" icon="Search"}
Comment votre application trouve son realm sans le connaître.
:::
:::card{title="Jeton enrichi et /me" href="/v1.0/concepts/jeton-enrichi-et-me" icon="BadgeCheck"}
Jeton Keycloak, jeton enrichi, `/api/me` : qui porte quoi.
:::
::::

### Les portes d'entrée

::::cards{cols=3}
:::card{title="Console et API" href="/v1.0/concepts/console-et-api" icon="DoorOpen"}
La console, l'API publique et Discovery : quelle porte pour quelle tâche.
:::
::::

## Parcours de lecture conseillés

| Vous êtes | Lisez dans cet ordre |
|---|---|
| **Administrateur d'une organisation cliente** | [Organisation multi-tenant](/v1.0/concepts/organisation-multi-tenant) → [Niveaux d'administration](/v1.0/concepts/niveaux-d-administration) → [Droits, profils et équipes](/v1.0/concepts/droits-profils-et-equipes) → [Console et API](/v1.0/concepts/console-et-api) |
| **Développeur qui intègre la connexion** | [Environnements](/v1.0/concepts/environnements) → [Discovery](/v1.0/concepts/discovery) → [Jeton enrichi et /me](/v1.0/concepts/jeton-enrichi-et-me) → [Droits, profils et équipes](/v1.0/concepts/droits-profils-et-equipes) |
| **Développeur qui héberge son application** | [Applications](/v1.0/concepts/applications) → [Environnements](/v1.0/concepts/environnements) → [Définitions et instances](/v1.0/concepts/definitions-et-instances) → [Cycle de vie des ressources](/v1.0/concepts/cycle-de-vie-des-ressources) |
| **Partenaire qui distribue une application** | [Organisation multi-tenant](/v1.0/concepts/organisation-multi-tenant) → [Applications](/v1.0/concepts/applications) → [Niveaux d'administration](/v1.0/concepts/niveaux-d-administration) → [Environnements](/v1.0/concepts/environnements) |

## Le vocabulaire en une ligne

| Terme | En une phrase |
|---|---|
| Propriétaire | l'éditeur ou le partenaire qui possède des applications ; « OwnerAdmin » dans la console |
| Application | la wakapp, identifiée par un identifiant court qui sert aussi de client Keycloak |
| Réseau | un canal de distribution de l'application, avec son realm Keycloak |
| Client | une organisation cliente dans un réseau, avec ses utilisateurs et ses équipes |
| Environnement | un lieu d'exécution de l'application : développement, staging ou production |
| Définition | ce que l'architecture déclare une fois pour toute l'application |
| Instance | la ressource réelle d'une définition dans un environnement |
| [WID](/v1.0/glossaire#wid) | l'identifiant court de six caractères de chaque objet, par exemple `EXAPP1` |

Toutes les définitions détaillées sont dans le [glossaire](/v1.0/glossaire).
