# Fonctionnalités activables

> Comment une fonctionnalité de votre application devient active pour un client - un interrupteur par niveau, application, réseau et client.

Une [fonctionnalité](/v1.0/glossaire#fonctionnalité) activable est un interrupteur que votre application consulte pour afficher ou masquer une partie de son interface : un module de statistiques, un export, une option payante. Wakastart stocke ces interrupteurs et répond à la question « cette fonctionnalité est-elle active pour ce client ? ».

## Définition

Une fonctionnalité est déclarée **sur l'application**, avec un code stable (par exemple `analytics`), un nom, une description et une mention « premium » si elle est payante. Elle n'a de sens que pour votre application : Wakastart ne l'interprète pas.

Une fonctionnalité activable n'est pas un [droit applicatif](/v1.0/glossaire#droit-applicatif). Le droit dit **qui** peut faire une action ; la fonctionnalité dit **si** l'action existe pour l'organisation de l'utilisateur.

| | Fonctionnalité activable | Droit applicatif |
|---|---|---|
| Porte sur | Un client (une organisation) | Un utilisateur, via son profil |
| Exemple | « Le module Statistiques est inclus dans l'offre de ce client » | « Cet utilisateur peut exporter les statistiques » |
| Se consulte par | L'API de vérification des fonctionnalités | `GET /api/me` |

## Comment ça marche

Chaque fonctionnalité a un interrupteur à trois niveaux. Elle est active pour un client seulement si les trois sont allumés :

```mermaid
flowchart LR
  A{"Application<br/>interrupteur global"} -- activée --> N{"Réseau du client"}
  N -- activée --> C{"Client"}
  C -- activée --> OK(["Active pour ce client"])
  A -- désactivée --> KO(["Inactive"])
  N -- désactivée --> KO
  C -- désactivée --> KO
```

1. **Application** : l'interrupteur global de la fonctionnalité. Il est allumé par défaut à la création. L'éteindre coupe la fonctionnalité partout.
2. **Réseau** : la fonctionnalité est proposée aux clients de ce réseau. Elle est éteinte par défaut.
3. **Client** : la fonctionnalité est incluse pour ce client. Elle est éteinte par défaut, et ne peut être allumée que si elle l'est déjà pour le réseau.

Wakastart calcule le résultat à chaque appel de l'API de vérification. Un client inconnu ne provoque pas d'erreur : la réponse indique que la fonctionnalité est inactive.

## Exemples

- **Offre à paliers.** Votre application déclare `export-pdf` en premium. Un réseau de distribution la propose ; seuls les clients qui ont souscrit l'option l'ont allumée.
- **Lancement progressif.** Vous déclarez `nouveau-planning`, puis vous l'allumez sur un réseau pilote avant de la proposer aux autres.
- **Coupure d'urgence.** Une fonctionnalité pose problème : vous éteignez son interrupteur d'application et elle disparaît chez tous les clients au prochain appel de vérification.

## Pour aller plus loin

- [Définir les fonctionnalités de votre application](/v1.0/organisations/definir-les-fonctionnalites)
- [Vérifier qu'une fonctionnalité est active](/v1.0/organisations/verifier-une-fonctionnalite)
- [Droits applicatifs et profils](/v1.0/droits-et-profils/droits-et-profils)
