# Applications

> La wakapp au centre de la plateforme, avec sa face identité, réglée dans Paramétrage, et sa face hébergement, décrite dans Architecture.

Une application, ou [wakapp](/v1.0/glossaire#wakapp), est le logiciel que vous publiez sur Wakastart. C'est l'objet central de la plateforme : les organisations qui l'utilisent sont rangées sous elle, et les ressources qui la font tourner lui appartiennent.

## Définition

Une application appartient à un seul [propriétaire](/v1.0/glossaire#propriétaire). Elle a deux faces, réglées à deux endroits de la console :

```mermaid
flowchart LR
  A["Application<br/>WID EXAPP1 · nom court monapp"]
  subgraph ID["Face identité : Paramétrage"]
    F["Fonctionnalités"]
    DR["Droits et profils"]
    I["Invitations"]
    LT["Langues et thèmes"]
  end
  subgraph HB["Face hébergement : Architecture"]
    RE["Dépôts Git"]
    SV["Services"]
    DP["Bases et buckets"]
    UR["URLs"]
  end
  A --> ID
  A --> HB
  A --> KC["Client Keycloak EXAPP1<br/>dans le realm de chaque réseau"]
```

| Attribut | Rôle |
|---|---|
| **WID** | identifiant court de six caractères ; c'est aussi l'identifiant du client Keycloak de l'application, que l'on retrouve dans la `keycloakUrl` et dans le jeton (`azp`) |
| **Nom court** | identifiant lisible, en minuscules, fixé à la création ; il apparaît dans les noms des ressources et dans les URLs sur domaine plateforme |
| **Type** | `APP`, `MOD` ou `SRV`, affiché en badge dans l'en-tête de l'application |
| **URL du front** | l'adresse du front de l'application ; Discovery s'en sert pour la connexion par e-mail |

Votre application est créée par Wakastart ; contactez-nous pour en ouvrir une. Wakastart la rattache à votre organisation : elle apparaît alors dans votre menu, sous son nom.

## Pourquoi ça existe

Une application concentre ce qui est commun à tous ses utilisateurs, quel que soit leur client : le catalogue des droits, les profils modèles, les fonctionnalités, le code et sa façon de tourner. Les réseaux et les clients n'ajoutent que ce qui leur est propre. Vous décrivez donc une seule fois votre logiciel, et vous le servez à autant d'organisations que nécessaire.

## Comment ça marche

### La face identité

Elle se règle dans **Paramétrage**, en onglets :

- **Features** : les fonctionnalités activables. Une fonctionnalité est active pour un client seulement si elle l'est pour l'application, pour son réseau et pour lui. Elle peut être marquée payante (« Premium »).
- **Droits**, **Profils**, **Matrice** : le catalogue des droits de l'application et les profils modèles qui les regroupent, environnement par environnement (voir [Droits, profils et équipes](/v1.0/concepts/droits-profils-et-equipes)).
- **Invitations** : l'activation des invitations, l'adresse de la page d'acceptation et le compte d'envoi des e-mails.
- **Langues**, **Thèmes**, **Crédits**, et **Légal** pour une application commerciale.

À la connexion, Keycloak délivre un jeton dont l'émetteur autorisé (`azp`) est le WID de l'application. L'API publique vérifie ce point : un jeton émis pour une autre application est refusé.

### La face hébergement

Elle se décrit dans **Architecture** : les dépôts Git, les services, les bases et buckets déclarés, les URLs. À la création de l'application, Wakastart lui prépare un registre d'images (un projet Harbor) et un coffre de secrets. Chaque environnement reçoit ensuite les instances de ce que l'architecture déclare (voir [Définitions et instances](/v1.0/concepts/definitions-et-instances)).

Une application peut n'utiliser qu'une face : une wakapp hébergée ailleurs peut confier seulement l'identité à Wakastart.

## Exemples

**Une application métier complète.** Un éditeur publie « Dossier Patient » : il définit vingt droits et quatre profils modèles, active les invitations, et décrit dans l'architecture un front, une API et une base PostgreSQL. Trois environnements la font tourner : développement, recette, production.

**Une application hébergée ailleurs.** Une startup garde son hébergement mais délègue la connexion et les droits à Wakastart. Elle n'utilise que **Paramétrage** et l'API publique ; le menu **Architecture** reste vide.

## Ce qui se règle où

| Vous voulez | Niveau |
|---|---|
| Ajouter un droit à votre catalogue | application |
| Proposer un profil à tous les clients | application (profil modèle) |
| Masquer un profil modèle pour un canal | réseau |
| Donner ses couleurs à une organisation | client |
| Ajouter un service ou une base | application (architecture), puis chaque environnement |

## Pour aller plus loin

- [Applications et environnements](/v1.0/applications) : régler et exploiter l'application.
- [Environnements](/v1.0/concepts/environnements) : où l'application tourne et s'authentifie.
- [Organisation multi-tenant](/v1.0/concepts/organisation-multi-tenant) : ce que l'application contient.
- [Référence API : contenus de l'application](/v1.0/reference-api/contenus-application) : thèmes, langues et configuration lus par votre front.
